14.09.2014 Views

CASINO manual - Theory of Condensed Matter

CASINO manual - Theory of Condensed Matter

CASINO manual - Theory of Condensed Matter

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

many cores, time limits etc, which is then <strong>manual</strong>ly qsubbed to the batch queue. Do not insert a<br />

call to runqmc in such a script ( c○the casino Wiki on the UK national facility ‘Hector’, written<br />

by the sysadmins). The purpose <strong>of</strong> runqmc is to create this batch script, and runqmc will then<br />

submit it all by itself. OK? We appreciate this is unusual, but it works.<br />

If you can’t remember the basic parameters <strong>of</strong> the machines that you’re running on (e.g., the number<br />

<strong>of</strong> cores per node, queue-dependent walltime limits, the maximum number <strong>of</strong> cores etc.) then typing<br />

runqmc --info or runqmc -i will print to the screen all relevant parameters available from the<br />

machine’s arch file. This may help you decide on what values to use for the run time parameters when<br />

invoking runqmc.<br />

6.6.1 Other facilities<br />

(1) runqmc can run calculations in multiple directories, by simply giving the directory names at the<br />

end <strong>of</strong> the command line, e.g.,<br />

runqmc -p 256 -T 10h diamond beta_tin<br />

will run the two calculations in directories ‘diamond’ and ‘beta tin’, where each <strong>of</strong> them uses 256<br />

cores.<br />

Running, e.g., 2 calculations on a 4-core workstation will result in 2 cores being used for each <strong>of</strong><br />

them (unless otherwise specified via ‘-p’). Running multiple calculations on clusters is only possible<br />

for specific machines; multiple calculations on clusters will use a single batch queue slot and a single<br />

script. This is useful for large clusters where runs on large numbers <strong>of</strong> cores are cheaper per core-hour<br />

by policy, but is otherwise a bad idea since different calculations will take different times to complete<br />

but the longest will be charged for.<br />

If no directories are specified, the calculation in the current directory will be run.<br />

(2) In order to run on a cluster log-in node, use the ‘--no-cluster’ option, which will make runqmc<br />

behave as if the machine was a workstation. You should check with your system administrator<br />

to see if this is OK.<br />

(3) If you would like to produce a submission script on a cluster without running casino (for verification<br />

purposes), use the ‘--check-only’ flag.<br />

(4) In order to use the OpenMP capabilities <strong>of</strong> casino, use the flag ‘--tpp=〈threads-per-process〉’.<br />

runqmc will automatically adjust the number <strong>of</strong> processes per node to leave one OpenMP thread per<br />

core. If you would like to modify this behaviour, use the ‘--ppn=〈processes-per-node〉’ flag and set<br />

your own value.<br />

You need to have compiled the OpenMP version with ‘make Openmp’ in order to access this feature.<br />

(5) In order to use the shared-memory capabilities <strong>of</strong> casino, use the flag ‘--shm’. runqmc will tell<br />

casino to share orbital coefficients (blip or Gaussian only) and some other data among all cores in<br />

each node; to modify this behaviour use instead ‘--shm=〈number-<strong>of</strong>-cores-in-SHM-group〉’.<br />

You need to have compiled the SHM version with ‘make shm’ in order to access this feature (‘make<br />

OpenmpShm’ is also available).<br />

(6) Individual machines can have user-defined options --user.option in order to cope with particular<br />

idiosyncrasies. See the end <strong>of</strong> the Usage section below.<br />

(7) A similar script ‘runpwscf’ is available for running the pwscf plane-wave DFT-code, which also<br />

uses the same <strong>CASINO</strong> ARCH system for determining what computer we’re running on. It has the<br />

same set <strong>of</strong> optional arguments as runqmc, apart from the obviously QMC-specific ones (plus some<br />

extra ones for controlling pwscf behaviour). Note that if your casino arch file defines a command<br />

for running casino, then it must include a tag &BINARY ARGS& following the &BINARY& tag; this is<br />

because the pwscf executable takes command line arguments such as -pw2casino, -npool etc., which<br />

are not required by casino.<br />

(8) A script ‘runqmcmd’ is available which runs coupled DFT-DMC molecular dynamics calculations<br />

(see section6.7). This exploits both ‘runpwscf’ and ‘runqmc’ to alternately run pwscf DFT calculations<br />

and casino QMC calculations.<br />

(9) A script ‘twistav pwscf’ is available for running ‘twist-averaged’ calculations where new<br />

xwfn.data files are repeatedly generated by pwscf for different twist angles (<strong>of</strong>fsets <strong>of</strong> the k-point<br />

25

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!