Output Overview
QMCPACK writes several output files that report information about the simulation (e.g., the physical properties such as the energy), as well as information about the computational aspects of the simulation, checkpoints, and restarts. The types of output files generated depend on the details of a calculation. The following list is not meant to be exhaustive but rather to highlight some salient features of the more common file types. Further details can be found in the description of the estimator of interest.
The .scalar.dat file
The most important output file is the scalar.dat
file. This file contains the
output of block-averaged properties of the system such as the local
energy and other estimators. Each line corresponds to an average over
\(N_{walkers}*N_{steps}\) samples. By default, the quantities
reported in the scalar.dat
file include the following:
- LocalEnergy
The local energy.
- LocalEnergy_sq
The local energy squared.
- LocalPotential
The local potential energy.
- Kinetic
The kinetic energy.
- ElecElec
The electron-electron potential energy.
- IonIon
The ion-ion potential energy.
- LocalECP
The energy due to the pseudopotential/effective core potential.
- NonLocalECP
The nonlocal energy due to the pseudopotential/effective core potential.
- MPC
The modified periodic Coulomb potential energy.
- BlockWeight
The number of MC samples in the block.
- BlockCPU
The number of seconds to compute the block.
- AcceptRatio
The acceptance ratio.
QMCPACK includes a python utility, qmca
, that can be used to process these files. Details and examples are given in Analyzing QMCPACK data.
The .opt.xml file
This file is generated after a VMC wavefunction optimization and contains the part of the input file that lists the optimized Jastrow factors. Conveniently, this file is already formatted such that it can easily be incorporated into a DMC input file.
The .qmc.xml file
This file contains information about the computational aspects of the simulation, for example, which parts of the code are being executed when. This file is generated only during an ensemble run in which QMCPACK runs multiple input files.
The .dmc.dat file
This file contains information similar to the .scalar.dat
file but also includes extra information about the details of a DMC calculation, for example, information about the walker population.
- Index
The block number.
- LocalEnergy
The local energy.
- Variance
The variance.
- Weight
The number of samples in the block.
- NumOfWalkers
The number of walkers times the number of steps.
- AvgSentWalkers
The average number of walkers sent. During a DMC simulation, walkers might be created or destroyed. At every step, QMCPACK will do some load balancing to ensure that the walkers are evenly distributed across nodes.
- TrialEnergy
The trial energy. See Diffusion Monte Carlo for an explanation of trial energy.
- DiffEff
The diffusion efficiency.
- LivingFraction
The fraction of the walker population from the previous step that survived to the current step.
The .bandinfo.dat file
This file contains information from the trial wavefunction about the band structure of the system, including the available \(k\)-points. This can be helpful in constructing trial wavefunctions.
Checkpoint and restart files
The .cont.xml file
This file enables continuation of the run. It is mostly a copy of the input XML file with the series number incremented and the mcwalkerset
element added to read the walkers from a config file. The .cont.xml
file is always created, but other files it depends on are present only if checkpointing is enabled.
The .config.h5 file
This file contains stored walker configurations.
* GROUP "root"
* GROUP "state_0"
* DATASET "block"
* int
* SCALAR
* DATASET "number_of_walkers"
* size_t
* SCALAR
* DATASET "walker_partition"
* int
* ARRAY ( offsets )
* DATASET "walker_weights"
* double
* ARRAY ( weights )
* DATASET "walkers"
* double
* ARRAY ( configurations )
* DATASET "version"
* int
* ARRAY ( major version number, minor version number )
The .random.h5 file
This file contains the state of the random number generator to allow restarts.
(Older versions used an XML file with a suffix of .random.xml
).