Difference between revisions of "JUSTUS2/Software/Dalton"
K Siegmund (talk | contribs) (→Program Binaries: remove paste of output) |
K Siegmund (talk | contribs) |
||
| (14 intermediate revisions by the same user not shown) | |||
| Line 7: | Line 7: | ||
| module load |
| module load |
||
| chem/dalton |
| chem/dalton |
||
| − | |- |
||
| − | | Availability |
||
| − | | [[BwForCluster_JUSTUS_2]] |
||
|- |
|- |
||
| License |
| License |
||
| − | | |
+ | | GNU Lesser General Public License (LGPL). |
|- |
|- |
||
| Citing |
| Citing |
||
| Line 27: | Line 24: | ||
'''Dalton''' (named after [https://en.wikipedia.org/wiki/John_Dalton John Dalton]) is an ab initio quantum chemistry computer program designed to to allow convenient, automated determination of a large number of molecular properties based on an HF, HF-srDFT, DFT, MP2, CC, CI, MCSCF, or MC-srDFT reference wave function. For additional information on features please visit the [https://daltonprogram.org/features/ Description of the Dalton suite features] web page. |
'''Dalton''' (named after [https://en.wikipedia.org/wiki/John_Dalton John Dalton]) is an ab initio quantum chemistry computer program designed to to allow convenient, automated determination of a large number of molecular properties based on an HF, HF-srDFT, DFT, MP2, CC, CI, MCSCF, or MC-srDFT reference wave function. For additional information on features please visit the [https://daltonprogram.org/features/ Description of the Dalton suite features] web page. |
||
| − | = Availability = |
||
| − | |||
| − | Dalton is available on selected bwHPC-Clusters. A complete list of versions currently installed on the bwHPC-Clusters can be obtained from the [https://www.bwhpc.de/software.html Cluster Information System (CIS)]. |
||
| − | |||
| − | In order to check which versions of Dalton are installed on the compute cluster, run the following command: |
||
| − | <pre> |
||
| − | $ module avail chem/dalton |
||
| − | </pre> |
||
| − | |||
| − | = License = |
||
| − | |||
| − | Dalton is free, open-source software released under the GNU Lesser General Public License (LGPL). Anyone interested in using the Dalton program suite must read the conditions described in its [https://gitlab.com/dalton/dalton/-/blob/master/LICENSE license agreement]. |
||
= Usage = |
= Usage = |
||
== Loading the module == |
== Loading the module == |
||
| + | See [[Software Modules]] documentation |
||
| + | == Input Files == |
||
| − | You can load the default version of Dalton with the following command: |
||
| − | <pre> |
||
| − | $ module load chem/dalton |
||
| − | </pre> |
||
| − | |||
| − | The module will try to load all modules it needs to function (e.g., compiler, mpi, ...). If loading the module fails, check if you have already loaded one of those modules, but not in the version required by Dalton. |
||
| − | |||
| − | If you wish to load another (older) version of Dalton, you can do so using |
||
| − | <pre> |
||
| − | $ module load chem/dalton/<version> |
||
| − | </pre> |
||
| − | with <version> specifying the desired version. |
||
| − | |||
| − | Please cite Dalton in your publications according to the [https://daltonprogram.org/citation/ references]. |
||
| − | |||
| − | == Hints for using Dalton == |
||
| − | |||
| − | === Input Files === |
||
| − | For information about how to construct input files (dalinp{.dal} [molinp{.mol} [potinp{.pot}]]) for Dalton, please consult the [https://daltonprogram.org/manuals/dalton2020manual.pdf documentation]. |
+ | For information about how to construct input files (dalinp{.dal} [molinp{.mol} [potinp{.pot}]]) for Dalton, please consult the [https://daltonprogram.org/manuals/dalton2020manual.pdf vendor documentation]. |
| − | + | == Environment Variables == |
|
Environment variables understood by Dalton: |
Environment variables understood by Dalton: |
||
| Line 75: | Line 44: | ||
</pre> |
</pre> |
||
| − | + | == Disk Usage == |
|
Scratch files are written to <span style="background:#edeae2;margin:2px;padding:1px;border:1px dotted #808080">$SCRATCH</span> by default. This configuration option can be changed by setting the environment variable <span style="background:#edeae2;margin:2px;padding:1px;border:1px dotted #808080">$DALTON_TMPDIR</span> (e.g., to a dedicated [[workspace]]) before starting your calculations with Dalton. |
Scratch files are written to <span style="background:#edeae2;margin:2px;padding:1px;border:1px dotted #808080">$SCRATCH</span> by default. This configuration option can be changed by setting the environment variable <span style="background:#edeae2;margin:2px;padding:1px;border:1px dotted #808080">$DALTON_TMPDIR</span> (e.g., to a dedicated [[workspace]]) before starting your calculations with Dalton. |
||
| Line 85: | Line 54: | ||
Example scripts are available in the directory <span style="background:#edeae2;margin:2px;padding:1px;border:1px dotted #808080">$DALTON_EXA_DIR</span>: |
Example scripts are available in the directory <span style="background:#edeae2;margin:2px;padding:1px;border:1px dotted #808080">$DALTON_EXA_DIR</span>: |
||
<pre> |
<pre> |
||
| − | $ module show chem/dalton # show environment variables, which will be available after 'module load' |
||
$ module load chem/dalton # load module |
$ module load chem/dalton # load module |
||
$ ls $DALTON_EXA_DIR # show content of directory $DALTON_EXA_DIR |
$ ls $DALTON_EXA_DIR # show content of directory $DALTON_EXA_DIR |
||
| Line 91: | Line 59: | ||
</pre> |
</pre> |
||
| − | Run a first simple example job on |
+ | Run a first simple example job on JUSTUS2: |
<pre> |
<pre> |
||
$ module load chem/dalton # load module |
$ module load chem/dalton # load module |
||
| Line 116: | Line 84: | ||
* [https://en.wikipedia.org/wiki/Dalton_(program) Wikipedia article (english)] |
* [https://en.wikipedia.org/wiki/Dalton_(program) Wikipedia article (english)] |
||
* [https://daltonprogram.org/tools/ Plugins for Dalton (english)] |
* [https://daltonprogram.org/tools/ Plugins for Dalton (english)] |
||
| − | ---- |
||
| − | [[Category:Chemistry software]][[Category:BwForCluster_Chemistry]][[Category:BwForCluster_JUSTUS_2]] |
||
Latest revision as of 11:30, 23 April 2024
|
The main documentation is available via |
| Description | Content |
|---|---|
| module load | chem/dalton |
| License | GNU Lesser General Public License (LGPL). |
| Citing | Publications |
| Links | Homepage | Documentation |
| Graphical Interface | No |
Contents
1 Description
Dalton (named after John Dalton) is an ab initio quantum chemistry computer program designed to to allow convenient, automated determination of a large number of molecular properties based on an HF, HF-srDFT, DFT, MP2, CC, CI, MCSCF, or MC-srDFT reference wave function. For additional information on features please visit the Description of the Dalton suite features web page.
2 Usage
2.1 Loading the module
See Software Modules documentation
2.2 Input Files
For information about how to construct input files (dalinp{.dal} [molinp{.mol} [potinp{.pot}]]) for Dalton, please consult the vendor documentation.
2.3 Environment Variables
Environment variables understood by Dalton:
DALTON_TMPDIR : scratch directory
DALTON_USE_GLOBAL_SCRATCH : use global scratch directory, do not copy any files to worker nodes
DALTON_NODELIST : list of nodes, dalton.x will be copied to DALTON_TMPDIR on each node unless
DALTON_USE_GLOBAL_SCRATCH is defined
DALTON_LAUNCHER : launcher for the dalton.x binary (if defined, -N flag not allowed)
2.4 Disk Usage
Scratch files are written to $SCRATCH by default. This configuration option can be changed by setting the environment variable $DALTON_TMPDIR (e.g., to a dedicated workspace) before starting your calculations with Dalton.
3 Examples
As with all processes that require more than a few minutes to run, non-trivial compute jobs must be submitted to the cluster queuing system.
Example scripts are available in the directory $DALTON_EXA_DIR:
$ module load chem/dalton # load module $ ls $DALTON_EXA_DIR # show content of directory $DALTON_EXA_DIR $ cat $DALTON_EXA_DIR/README # show examples README
Run a first simple example job on JUSTUS2:
$ module load chem/dalton # load module $ WORKSPACE=`ws_allocate dalton 3` # allocate workspace $ cd $WORKSPACE # change to workspace $ cp -a $DALTON_HOME/bwhpc-examples . # copy example files to workspace $ cd bwhpc-examples # change to test directory $ sbatch dalton-2020.0.slurm # submit job $ squeue # obtain JOBID $ scontrol show job <JOBID> # check state of job $ ls # when job finishes the results will be visible in this directory
4 FAQ
Q: What to do if my simulations abort with MEMGET ERROR, insufficient work space in memory ?
A: Increase Dalton's usable work memory with either -mb or -gb on the command line.
