QCMaquis is an efficient C++11 implementation of the density matrix renormalization group (DMRG) algorithm for quantum chemical Hamiltonians in its matrix product state-matrix product operator (MPS-MPO) formulation. Quantum-chemical operators represented as matrix product operators (MPOs) provide the necessary flexibility to accommodate Abelian and non-Abelian symmetries as well as the implementation of non-relativistic and relativistic quantum chemical Hamiltonians, respectively, in a unified framework. We have implemented the special unitary group of degree 2 (SU(2)) in the MPO representation of the non-relativistic Hamiltonian to ensure spin conservation.
git clone https://github.com/qcscine/qcmaquis.git qcmaquis
cd qcmaquis/dmrg
mkdir build
cd build
cmake -D<CMAKE_COMPILE_OPTIONS> ../
make
where <CMAKE_COMPILE_OPTIONS>
can be (optionally) one of the following:
BUILD_MANUAL
: Compile and install the QCMaquis manual in PDF.BUILD_OPENMOLCAS_INTERFACE
: Build and install the OpenMOLCAS Fortran interface.QCMAQUIS_TESTS
: Compile tests.LAPACK_64_BIT
: Enable if you use a linear algebra library configured with 64-bit integers (ILP64).BLAS_LAPACK_SELECTOR
: Set the vendor of the linear algebra library: openblas
,mkl_sequential
, mkl_parallel
, veclib
for Accelerate on Mac OS X, auto
for autodetection and manual
for setting the linking directories manually are supported. Default is autodetection, which usually does a good job.BUILD_PREBO
: Build the pre-BO related model. It is mandatory to activate the NU1
symmetry.BUILD_VIBRATIONAL
: Build the vibrational DMRG module. It is mandatory to activate the symmetry NONE
for canonical quantization.BUILD_VIBRONIC
: Buld the vibronic and excitonic DMRG modules. It is mandatory to activate the U1
symmetry.DMRG_ORDERNONE
Maximum order of integral terms for NONE symmetry for vibrational calculations. Integral files need to have #DMRG_ORDERNONE mode indices. Default is 6. If this flag is set to another number, certain tests will fail by construction.BUILD_*
: Build (legacy) utility binaries to perform various operations with matrix product state (MPS) checkpoint files.A more detailed installation guide can be found in Section 3.1 of our manual.
To install QCMaquis with the OpenMOLCAS interface, download OpenMOLCAS from the official OpenMOLCAS GitLab repository and follow its installation guide. To activate QCMaquis (and NEVPT2) support within OpenMolcas, add the following flags to cmake when configuring OpenMOLCAS (see step 3 of the OpenMOLCAS installation guide):
$ cmake -DDMRG=ON -DNEVPT2=ON <other CMAKE flags> ../
A detailed installation guide and manual for QCMaquis (and its components) can be found in the doc
subdirectory. Compile QCMaquis with the BUILD_MANUAL
CMake option to obtain the documentation in the PDF format.
Note that two manuals are generated: qcmaquis_manual.pdf
, which presents the OpenMolcas/QCMaquis interface, and qcmaquis_manual_standalone.pdf
, which describes the functionalities of QCMaquis as a standalone software.
For issues and bug reports with QCMaquis in OpenMOLCAS, please open an issue in the OpenMOLCAS bug tracker with a QCMaquis tag. For issues and bug reports with the QCMaquis standalone version, please use the GitHub QCMaquis issue tracker or send an e-mail to dmrg@phys.chem.ethz.ch.
For reproducibility reasons, please cite, depending on the actual calculations you carried out, one or more of the following papers in publications that present data produced with QCMaquis:
QCMaquis builds upon the ALPS MPS project. The ALPS MPS codes implement the DMRG algorithm for variational ground and low-lying excited state search as well as time evolution of arbitrary one- and two-dimensional models in a matrix-product-state representation. They have been developed at ETH Zurich by Michele Dolfi and Bela Bauer in the group of Matthias Troyer with contributions from Sebastian Keller and Alexandr Kosenkov and at the University of Geneva by Timothée Ewart and Adrian Kantian in the group of Thierry Giamarchi. For further information on the ALPS project, please visit https://alps.comp-phys.org and note the original ALPS MPS paper:
The current QCMaquis release ships with a modified ALPS library based on ALPS 2.3.0 to reduce compile and runtime dependencies. For more information, please read the README.txt in the dmrg/alps
subdirectory. The ALPS library is subject to the ALPS Library license, which is found in dmrg/alps/LICENSE.txt
.