MRChem is a numerical real-space code for molecular electronic structure calculations within the self-consistent field (SCF) approximations of quantum chemistry (Hartree-Fock and Density Functional Theory).
The code is being developed at the Hylleraas Centre for Quantum Molecular Sciences at UiT - The Arctic University of Norway.
For optimal performance it is recommended to build from source, as the packaged builds are quite generic without architecture specific optimizations.
To build MRChem from source with MPI+OpenMP parallelization:
$ git clone https://github.com/MRChemSoft/mrchem.git
$ cd mrchem
$ ./setup --prefix=<install-dir> --omp --mpi --cxx=<mpi-compiler> <build-dir>
$ cd <build-dir>
$ make
$ make test
$ make install
All dependencies will be fetched at configure time, if not already available. For more information on different kinds of builds, see installation instructions.
To install MRChem in a Conda environment myenv
:
$ conda create -n myenv
$ conda activate myenv
$ conda install -c conda-forge mrchem # latest version (OpenMP only)
$ conda install -c conda-forge mrchem=1.0.0 # tagged version (OpenMP only)
$ conda install -c conda-forge mrchem=*=*openmpi* # latest version (MPI+OpenMP)
$ conda install -c conda-forge mrchem=*=*mpich* # latest version (MPI+OpenMP)
To list all available versions
$ conda search -c conda-forge mrchem
To install MRChem in a Spack environment myenv
:
$ spack env create myenv
$ spack env activate myenv
$ spack install mrchem # latest version (MPI+OpenMP)
$ spack install mrchem @1.0.0 # tagged version (MPI+OpenMP)
$ spack install mrchem -mpi # latest version (OpenMP only)
For information on available Spack builds:
$ spack info mrchem
To install MRChem in an EasyBuild/Lmod environment (only MPI+OpenMP version available):
$ eb MRChem-<version>-<toolchain> --fetch
$ eb MRChem-<version>-<toolchain> --robot
$ module load MRChem/<version>-<toolchain>
See
EasyBuild
for available <versions>
and <toolchains>
.
Singularity recipe files are provided under recipes/
for building local container images using
the current state of the source. Requires Singularity >= v3.2 as well as sudo
rights on the
machine you are building on:
$ sudo singularity build <image_name>.sif recipes/Singularity.<variant>
Recipes are provided for a pure OpenMP build (recipes/Singularity.nompi
) and one MPI+OpenMP version,
using OpenMPI-4.0
(recipes/Singularity.openmpi4.0
).
Official MRChem images can also be downloaded from the GitHub Container Registry.
Latest master
version (here OpenMP variant):
$ singularity pull oras://ghcr.io/MRChemSoft/mrchem/mrchem_nompi:latest
Tagged version (here MRChem-v1.0.2 using OpenMPI-v4.0):
$ singularity pull oras://ghcr.io/MRChemSoft/mrchem/mrchem_openmpi4.0:v1.0.2
Note that the MPI image requires that a compatible MPI library is installed and available on the host. For information on how to launch the container:
$ singularity run-help mrchem-mpi.sif