Skip to content
QMC=Chem : Quantum Monte Carlo for Chemistry
Branch: master
Clone or download
Latest commit cc0620e Sep 12, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
install Downgraded dependencies Jul 9, 2018
ocaml Merge branch 'master' of Jul 13, 2018
scripts Modernized for zmq 4.2.5 and python2 Jul 9, 2018
.gitignore Works with gfortran. Fixed compiling problem. Dec 28, 2015
LICENSE Initial commit Dec 18, 2015 Conflicts: Jul 1, 2016 Modernized for zmq 4.2.5 and python2 Jul 9, 2018 Fixed and configure Dec 29, 2015
make.config.gfortran Works with gfortran. Fixed compiling problem. Dec 28, 2015

QMC=Chem : Quantum Monte Carlo for Chemistry

QMC=Chem is the quantum Monte Carlo program of the Toulouse (France) group. It is meant to be used in the post-Full-CI context : a quasi-Full-CI calculation is done with the quantum package, and this wave function is used as a trial wave function for the fixed-node diffusion Monte Carlo algorithm.

  • Parallel efficiency of 98.3% on 16_000 cores
  • The load balancing is optimal: the workers always work 100% of the time, independently of their respective CPU speeds
  • Efficient: 0.96 Pflops/s on 76_800 cores of Curie in 2011
  • All network communications are non-blocking, with the ZeroMQ library
  • All the implemented algorithms are CPU-bound : the only limit is the available CPU time
  • The number of simultaneous worker nodes can be variable during a calculation
  • Fully fault-tolerant (crashing nodes don't stop the running calculation)
  • QMC=Chem has been used in grid environments (EGI european grid) and in Cloud environments (France Grilles) coupled to supercomputers


  • QMC=Chem is under the GPLv2 license. Any modifications to or software including (via compiler) GPL-licensed code must also be made available under the GPL along with build & install instructions.
  • Pseudopotentials are about to change in the EZFIO database. Current calculations will not be compatible with future versions


Most of the dependencies are open-source will be downloaded automatically. The Fortran and C++ compilers, Python and Bash interpreters and the Lapack library need to be installed manually by the user.


The make.config file contains compiler specific parameters. You should change them to match your hardware.

The script will first download the Ninja build tool, and will then run Ninja using the install/ file. The configuration script will work in the install directory. It will first download into the install/Downloads directory everything that needs to be installed. The building of the dependencies takes place in the install/_build directory, and the packages that are being installed can be followed by looking at the log files in this directory. When a package was successfully installed, a *.ok file is created and the log file is deleted.

If you don't have an internet connection available, you can execute the downloading step on another computer and transfer all the downloaded files into the Downloads directory.

Before using or compiling QMC=Chem, environment variables need to be loaded. The environment variables are located in the qmcchemrc file:

$ source qmcchemrc

To compile the program, run

$ ninja

Example of a QMC=Chem calculation

1.Calculation with the quantum package

Create the xyz file containing the nuclear coordinates of the system

$ cat > << EOF
Water molecule
O 0. 0. 0.
H 0.9572 0. 0.
H -0.239987 0.926627 0.

Choose a suitable basis set and create the EZFIO database

$ qp_create_ezfio_from_xyz -b cc-pvdz -o h2o

Run the SCF calculation

$ qp_run SCF h2o

Run the CIPSI calculation

$ qp_run full_ci h2o

Transform the input for use in QMC=Chem

$ qp_run save_for_qmcchem h2o

2.FN-DMC calculation with QMC=Chem

Before using QMC=Chem, you need to load the environment variables:

$ source qmcchem.rc

In QMC=Chem, everything goes through the use of the qmcchem command. When a command is run with no arguments, it prints a help message. This is mainly the manual of QMC=Chem. For example:

$ qmcchem 
QMC=Chem command

  qmcchem SUBCOMMAND

=== subcommands ===

  debug    Debug ZeroMQ communications
  edit     Edit input data
  md5      Manipulate input MD5 keys
  result   Displays the results computed in an EZFIO directory.
  run      Run a calculation
  stop     Stop a running calculation
  version  print version information
  help     explain a given subcommand (perhaps recursively)

missing subcommand for command qmcchem

$ qmcchem edit
Run a calculation

  qmcchem run EZFIO_FILE

Run QMC=Chem

=== flags ===

  [-a]                    Add more resources to a running calculation.
  [-d]                    Start a dataserver process on the local host.
  [-q <dataserver_addr>]  Start a qmc process on the local host.
  [-s <host>]             Start a qmc process on <host>.
  [-help]                 print this help text and exit
                          (alias: -?)

missing anonymous argument: EZFIO_FILE
  1. Set the parameters for a VMC calculation to create initial walker positions
$ qmcchem edit -h
Edit input data

  qmcchem edit EZFIO_FILE [INPUT]

Edit input data

=== flags ===

  [-c]                Clear blocks
  [-e energy]         Fixed reference energy to normalize DMC weights
  [-f 0|1]            Correct wave function to verify electron-nucleus cusp
  [-j jastrow_type]   Type of Jastrow factor [ None | Core | Simple ]
  [-l seconds]        Length (seconds) of a block
  [-m method]         QMC Method : [ VMC | DMC ]
  [-n norm]           Truncation t of the wave function : Remove determinants
                      with a
                      contribution to the norm less than t
  [-s sampling]       Sampling algorithm : [ Langevin | Brownian ]
  [-t seconds]        Requested simulation time (seconds)
  [-ts time_step]     Simulation time step
  [-w walk_num]       Number of walkers per CPU core
  [-wt walk_num_tot]  Total number of stored walkers for restart
  [-help]             print this help text and exit
                      (alias: -?)

$ qmcchem edit h2o -f 1 -m VMC -n 1.e-5 -s Langevin -t 300 -l 10
  1. Get info on the wave function
$ qmcchem info h2o
  1. Run the VMC calculation
$ qmcchem run h2o
  1. Set the correct parameters for FN-DMC
$ qmcchem edit h2o -e -76.438 -m DMC -s Brownian -ts 3.e-4 -t 3600 -l 30
  1. Run the FN-DMC calculation
$ qmcchem run h2o
  1. Print the result
$ qmcchem result h2o


Quantum Monte Carlo for large chemical systems: Implementing efficient strategies for petascale platforms and beyond

Anthony Scemama , Michel Caffarel , Emmanuel Oseret and William Jalby (2013), in: Journal of Computational Chemistry, 34:11(938--951)

Quantum Monte Carlo with very large multideterminant wavefunctions

Anthony Scemama , Thomas Applencourt , Emmanuel Giner and Michel Caffarel (2015), in: ArXiv ePrints:arXiv:1510.00730v2 [physics.chem-ph]

You can’t perform that action at this time.