CASINO manual - Theory of Condensed Matter
CASINO manual - Theory of Condensed Matter
CASINO manual - Theory of Condensed Matter
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
must be specified (note that both members <strong>of</strong> a ±k pair must be given), and complex wf must be<br />
T in the input file. The <strong>of</strong>fsets to the grid <strong>of</strong> k vectors are chosen randomly.<br />
By default the script uses runqmc to run the casino calculations. If the script is to be used on a<br />
machine with a queueing system then the ‘-batch’ flag should be set and the command for running<br />
casino should be specified with, e.g., ‘-casino "runqmc --nproc=4 --walltime=1h5m"’. The script<br />
doesn’t currently let you submit the castep jobs to a queue, but the castep runs are relatively quick.<br />
The number <strong>of</strong> twists to use is specified using the ‘-ntwist’ flag (default 12 at the time <strong>of</strong> writing).<br />
For more information on available options, type twistav castep -help.<br />
The clearup twistav script can be used to clear up the output from a castep twist-averaging run.<br />
28.3.4 Monte Carlo twist averaging for real systems using <strong>CASINO</strong> and PWSCF<br />
This is automated with the twistav pwscf utility. The support provided by this script is currently<br />
more advanced than its castep equivalent since it uses the standard casino architecture system<br />
(meaning it should run automatically on any system, batch or otherwise) and the full range <strong>of</strong> run time<br />
options are available. pwscf itself by default works with binary bwfn.data.b1 files which obviates<br />
the need for using huge bwfn.data files as in castep, and no multi-step conversions (involving e.g.,<br />
castep2casino and blip utilities) are required.<br />
Usage:<br />
twistav_pwscf [--help --nproc_dft=I --splitqmc[=N] --startqmc=M<br />
--dft_only/--qmc_only --ntwist=L []<br />
This script is used to automate the collection <strong>of</strong> twist-averaged data using casino and the pwscf<br />
DFT code (part <strong>of</strong> the Quantum espresso package, available at www.quantum-espresso.org). pwscf<br />
must be version 4.3 or later.<br />
This script works by repeatedly calling the runpwscf and runqmc scripts which know how to run<br />
pwscf/casino on any individual machine. With the exception <strong>of</strong> those listed above, almost all<br />
optional arguments to this script are the same as for runpwscf/runqmc and are passed on automatically<br />
to these subsidiary run scripts (the --background/-B option is also used by twistav pwscf, and for<br />
the same purpose). Type ‘runpwscf --help’ or ‘runqmc --help’ to find out what these options are.<br />
The short list <strong>of</strong> optional flags specific to twistav pwscf are described below.<br />
It is assumed that pwscf lives in $HOME/espresso and casino lives in $HOME/<strong>CASINO</strong>. There are<br />
override options available if this is not the case.<br />
If you are running on a multi-user machine with an account to be charged for the calculations,<br />
you might consider aliasing twistav pwscf as alias twistav pwcf="twistav pwscf<br />
--user.account=CPH005mdt " or whatever.<br />
In general you should do something like the following:<br />
Setup the pwscf input (‘in.pwscf’) and the casino input (‘input’, etc., but no wave function file)<br />
in the same directory. For the moment we assume you have an optimized Jastrow from somewhere.<br />
Have the pwscf setup as calculation = scf with both nosym and noinv (system section) set to T<br />
and verbosity (control section) to high. The required k point info is not printed in output without<br />
the latter. In your casino input file, complex wf must be T.<br />
The twistav pwscf script will then run pwscf once to generate ‘ntwist’ xwfn.data files (ntwist<br />
default = 12, or change with optional argument --ntwist=xx), then it will run casino on each <strong>of</strong> the<br />
xwfn.data. The casino out files, xwfn.data files, config.out and vmc.hist/dmc.hist files will be<br />
renamed with an appropriate integer suffix.<br />
The calculation can be run through pwfn.data, bwfn.data or bwfn.data.b1 formats as specified<br />
in the pw2casino.dat file (see casino and pwscf documentation). When pwscf is upgraded to<br />
produce new-format bwfn.data.bin files, then this script will need to be changed - ask MDT to do<br />
so.<br />
If you wish to do the (fast) DFT wave function generation calculations and the (slow) QMC calculations<br />
on different machines, for example to avoid batch queue waiting time, then use the --dft only<br />
option to generate the full set <strong>of</strong> xwfn.data files, transfer these to the more powerful machine, then<br />
run on that using the --qmc only option—see below.<br />
172