Quick Start

Licensing

The full software license for DMRG++ version 3 can be found in file LICENSE in the root directory of the code. DMRG++ is a free and open source implementation of the DMRG algorithm. You are welcomed to use it and publish data obtained with DMRG++. If you do, <b>please cite this work</b> (see next subsection).

DISCLAIMER

<pre> THE SOFTWARE IS SUPPLIED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER, CONTRIBUTORS, UNITED STATES GOVERNMENT, OR THE UNITED STATES DEPARTMENT OF ENERGY BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. NEITHER THE UNITED STATES GOVERNMENT, NOR THE UNITED STATES DEPARTMENT OF ENERGY, NOR THE COPYRIGHT OWNER, NOR ANY OF THEIR EMPLOYEES, REPRESENTS THAT THE USE OF ANY INFORMATION, DATA, APPARATUS, PRODUCT, OR PROCESS DISCLOSED WOULD NOT INFRINGE PRIVATELY OWNED RIGHTS. </pre>

How To Cite This Work

<pre> \@article{re:alvarez0209, author="G. Alvarez", title="The Density Matrix Renormalization Group for Strongly Correlated Electron Systems: A Generic Implementation", journal="Computer Physics Communications", volume="180", pages="1572-1578", year="2009"} \@article{re:alvarez0310, author="G. Alvarez", title="Implementation of the SU(2) Hamiltonian Symmetry for the DMRG Algorithm", journal="Computer Physics Communications", volume="183", pages="2226-2232", year="2012"} \@article{re:alvarez0311, author="G. Alvarez and L. G. G. V. Dias da Silva and E. Ponce and E. Dagotto", title="Time Evolution with the DMRG Algorithm: A Generic Implementation for Strongly Correlated Electronic Systems", journal="Phys. Rev. E", volume="84", pages="056706", year="2011"} \@article{re:alvarez0713, author="G. Alvarez", title="Production of minimally entangled typical thermal states with the Krylov-space approach", journal="Phys. Rev. B", volume="87", pages="245130", year="2013"} And also: \@article{re:alvarez08, re:webDmrgPlusPlus, Author = {G. Alvarez}, Title = {DMRG++ Website}, Publisher = {\\url{https://g1257.github.com/dmrgPlusPlus}} } </pre>

Code Integrity

Hash of the latest commit is also posted at

https://g1257.github.com/hashes.html

Latest commit should always be signed. Keys at https://g1257.github.com/keys.html

Building and Running DMRG++

Required Software

GNU C++ or LLVM CLANG++ (C++17 is used)
The BLAS and LAPACK library or equivalent
[required] HDF5
[required] boost-devel (boost-spirit) for Ainur Only headers files are used; boost runtime is not used.
[required] cmake and dependencies
[required] perl
[required] GSL (GNU Scientific Library)

Downloading DMRG++

Create a directory somewhere and cd to it.

<pre> cd ../ git clone https://github.com/g1257/dmrgpp.git cd dmrgpp/ </pre>

Pull requests should be opened against the master branch.

Configure

Use the following command to configure DMRG++

cmake -B builddir [<options...>]

-B builddir creates a build directory named builddir (you can choose a different name if you prefer).

The [<options...>] part is where you specify other configuration options.

Common CMake Options

These options are generally useful for any CMake project:

-DCMAKE_CXX_COMPILER=<compiler>: Specifies the full path to the C++ compiler.

Example: -DCMAKE_CXX_COMPILER=clang++
-DCMAKE_CXX_STANDARD=<standard>: Sets the C++ standard. The default is 17.

Example: -DCMAKE_CXX_STANDARD=20
-DCMAKE_BUILD_TYPE=<type>: Controls optimization level and debugging information. Common options are Debug, Release, RelWithDebInfo (default), and MinSizeRel.
-G<generator>: Specifies the generator to create a native build system (e.g., "Unix Makefiles" for standard UNIX makefiles, "Ninja" for build.ninja or "Visual Studio 17 2022" for Visual Studio.

Example: -GNinja

External dependencies (Third-Party Libraries)

To control where the project should find external dependencies installed on your system, you may pass -D<PackageName>_ROOT=/path/to/package/install to find a specific <PackageName> installed at /path/to/package/install.

External dependencies are: Boost, MPI, HDF5, GSL, BLAS, and LAPACK.

Example: -DBoost_ROOT=/path/to/boost

Note on Catch2: We use the Catch2 library as our unit test framework. By default, our CMake is setup to use FetchContent to download the library if it is not found on your system.

To force the use of a locally installed Catch2 and disable the automatic download fallback, use the following options:
-DCMAKE_REQUIRE_FIND_PACKAGE_Catch2=ON -DCatch2_ROOT=/path/to/catch2

Build and Test

After the configuration step succeeded, build using

cmake --build builddir

and test with

ctest --test-dir builddir --output-on-failure

Install

After building, install with

cmake --install builddir --prefix installdir

Running DMRG++

Assuming you are in dmrgpp/src, copy input2.ain to dmrgpp/src with

<code>cp ../TestSuite/inputs/input2.ain .</code>

and then you may run with

<code>./dmrg -f ../TestSuite/inputs/input2.ain</code>

You will now have two files a data2.hdf5 and an ASCII file runForinput2.cout. The name data2 is obtained from the corresponding label in the input file, in this case input2.ain. Normally the code writes stdout to runForinput2.cout for an input called input2.inp, and stderr to the terminal. If you would like to override the default inferred name runForinput2.cout you may use <code>./dmrg -f ../TestSuite/inputs/input2.ain -l myoutputfile</code> If you would like stdout be written to the terminal say -l -

Dmrgpp

Install / Use

README