README.md

dsqss

DSQSS (Discrete Space Quantum Systems Solver) is a software package for calculating expectation values of several observables of quantum lattice systems in finite temperature. DSQSS implements the path-integral Monte Carlo method with the directed loop algorithm.

Build and Install

prerequisite

• C++ Compiler
• CMake 2.8=<
• Python 2.7 or 3.4=<

Simple build

rm -rf build
mkdir build
cd build
cmake ../
make

Notes

DSQSS requires some python packages, and if not found DSQSS installs them automatically into local while CMake process. If pip is too old and does not know --prefix option of install, please update pip .

To change compiler, add -DCMAKE_CXX_COMPILER like

cmake ../ -DCMAKE_CXX_COMPILER=`which icpc`

For Intel compiler, DSQSS offers another option -DCONFIG=intel for setting compiler and adding compiler options

cmake ../ -DCONFIG=intel

You can find executable files in build/src/dla, build/tool and build/src/pmwa/.

build manual

Sphinx and sphinxcontrib-spelling are required. LaTeX is required for PDF format.

# in the build directory,
cmake -DDocument=ON ../
make doc

Testing

# in the build directory,
ctest

When some tests failed, you can check output of these tests by following:

# in the build directory,
ctest -V -R "test name"

Test names can be specified by the regular expression.

Install

The path to install is specified by -DCMAKE_INSTALL_PREFIX as the following,

# in the build directory,
cmake -DCMAKE_INSTALL_PREFIX=${INSTALL_DIR} ../
make install

After this process, executable files such as dla are installed to ${INSTALL_DIR}/bin, a configuration file dsqssvars-${DSQSS_VERSION}.sh to ${INSTALL_DIR}/share/dsqss/, sample files to ${INSTALL_DIR}/share/dsqss/dsqss-${DSQSS_VERSION}/sample, and documents (if built) to ${INSTALL_DIR}/share/dsqss/dsqss-${DSQSS_VERSION}/doc.

Example

source ${INSTALL_DIR}/share/dsqss/dsqssvars-${DSQSS_VERSION}.sh
cd sample/dla/01_spindimer
dla_pre std.toml
dla param.in
cat sample.log | grep ene

For details, see manual page.

License

License of DSQSS

DSQSS is distributed under the GNU GPL v3.

License of the bundled libs

• Boost C++ library is redistributed under the Boost software license.
• Plog is redistributed under the Mozilla Public License 2.0
• FindPythonModule.cmake is redistributed under the OSI approved BSD license.

Acknowledgement

DSQSS v1.2 and v2.0 are developed under the support of "Project for advancement of software usability in materials science" in fiscal year 2018 by The Institute for Solid State Physics, The University of Tokyo.