pomerol is an exact diagonalization (full ED) code written in C++ aimed at solving condensed matter second-quantized models of interacting fermions and bosons on finite size lattices at finite temperatures. It is designed to compute thermal expectation values of observables, single- and two-particle Green's functions as well as susceptibilities.
- High performance exact calculation of Green's functions, two-particle Green's functions and susceptibilities in Matsubara domain.
- Many-body Hamiltonians can be specified in a natural mathematical form using libcommute's Domain-Specific Language. Hamiltonian presets for commonly used lattice models are also available.
- Automatic symmetry analysis of the many-body Hamiltonians drastically reduces computational costs.
- Eigen 3 template library is used for numerical linear algebra.
- MPI + OpenMP support.
-
Check the dependencies:
- A C++11 conformant compiler
- CMake >= 3.11.0
- Boost >= 1.54.0 (only headers are required)
- Eigen >= 3.1.0
- libcommute >= 0.7.2 (will be downloaded by CMake if not found installed locally)
- An MPI 3.0 implementation
- Git to fetch the sources
-
Download the latest sources:
git clone https://github.com/pomerol-ed/pomerol.git
-
Create a (temporary) build directory and change to it:
mkdir build && cd build
-
In this build directory, run
cmake <path_to_pomerol_sources> -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=<installation_path>
- CMake tries to find an installation of libcommute, whose location can be
specified by adding
-Dlibcommute_DIR=<libcommute_installation_path>/lib/cmake/libcommute
to the command line. If this attempt fails, it will download an appropriate version of libcommute and co-install it alongside pomerol. - Add
-DTesting=OFF
to disable compilation of unit tests (not recommended). - Add
-DProgs=ON
to compile provided executables (fromprogs
directory). Some of the executables depend on the gftools library, which will be automatically downloaded in case it cannot be found by CMake (use-Dgftools_DIR
to specify its installation path). gftools supports saving to HDF5 through ALPSCore. - Add
-DDocumentation=OFF
to disable generation of reference documentation. - Add
-DUSE_OPENMP=OFF
to disable OpenMP optimization for two-particle GF calculation. - Add
-DBUILD_SHARED_LIBS=OFF
to compile static instead of shared libraries.
- CMake tries to find an installation of libcommute, whose location can be
specified by adding
-
make
-
make test
(if unit tests are compiled) -
make install
-
make doc
generates the Doxygen reference documentation in thedoc/html
subdirectory.
The library, libpomerol is built. It can be used for linking with executables.
Some working executables are given in prog
subdirectory.
โ ๏ธ It has been reported that some MPICH-based MPI implementations, such as HPE Cray MPI may not properly supportMPI_CXX_*
datatypes, which pomerol's code depends on. In case you see failing MPI unit tests when linking to said MPI libraries, try using CMake option-DUse_MPI_C_datatypes=ON
.
Check the tutorial
directory for an example of a pomerol-based code that is
linked to external libraries.
The interface to TRIQS library is readily available: https://github.com/pomerol-ed/pomerol2triqs.
Check https://pomerol-ed.github.io/pomerol/html/ or type make doc
during
compilation stage to build the reference documentation.
CHANGELOG.md lists main changes introduced in each release.
This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
Please, attribute this work by a citation to http://dx.doi.org/10.5281/zenodo.17900.
- Andrey Antipov <Andrey.E.Antipov\at\gmail.com>
- Igor Krivenko <igor.s.krivenko\at\gmail.com>
- Mikhail Alejnikov
- Alexey Rubtsov
- Christoph Jung
- Aljoscha Wilhelm
- Junya Otsuki
- Sergei Iskakov
- Hiroshi Shinaoka
- Nils Wentzell
- Hugo U.R. Strand
- Dominik Kiese
Please, feel free to contact us and to contribute!