The official AiiDA plugin for Quantum ESPRESSO
Project description
aiida-quantumespresso
This is the official AiiDA plugin for Quantum ESPRESSO.
Compatibility matrix
Plugin | AiiDA | Python |
---|---|---|
v3.1.0 < v4.0.0 |
||
v3.0.0 < v3.1.0 |
||
v2.0.0 < v3.0.0 |
Installation
To install from PyPI, simply execute:
pip install aiida-quantumespresso
or when installing from source:
git clone https://github.com/aiidateam/aiida-quantumespresso
pip install aiida-quantumespresso
Command line interface tool
The plugin comes with a builtin CLI tool: aiida-quantumespresso
.
This tool is built using the click
library and supports tab-completion.
To enable it, add the following to your shell loading script, e.g. the .bashrc
or virtual environment activate script:
eval "$(_AIIDA_QUANTUMESPRESSO_COMPLETE=source aiida-quantumespresso)"
The tool comes with various sub commands, for example to quickly launch some calculations and workchains
For example, to launch a test PwCalculation
you can run the following command:
aiida-quantumespresso calculation launch pw -X pw-v6.1 -p SSSP_v1.1_eff_PBE
Note that this requires the code pw-v6.1
and pseudo potential family SSSP_v1.1_eff_PBE
to be configured.
Each command has a fully documented command line interface, which can be printed to screen with the help flag:
aiida-quantumespresso calculation launch ph --help
which should print something like the following:
Usage: aiida-quantumespresso calculation launch ph [OPTIONS]
Run a PhCalculation.
Options:
-X, --code CODE A single code identified by its ID, UUID or
label. [required]
-C, --calculation CALCULATION A single calculation identified by its ID or
UUID. [required]
-k, --kpoints-mesh INTEGER... The number of points in the kpoint mesh
along each basis vector. [default: 1, 1, 1]
-m, --max-num-machines INTEGER The maximum number of machines (nodes) to
use for the calculations. [default: 1]
-w, --max-wallclock-seconds INTEGER
the maximum wallclock time in seconds to set
for the calculations. [default: 1800]
-i, --with-mpi Run the calculations with MPI enabled.
[default: False]
-d, --daemon Submit the process to the daemon instead of
running it locally. [default: False]
-h, --help Show this message and exit.
License
The aiida-quantumespresso
plugin package is released under the MIT license.
See the LICENSE.txt
file for more details.
Acknowlegements
We acknowledge support from:
- the NCCR MARVEL funded by the Swiss National Science Foundation;
- the EU Centre of Excellence "MaX – Materials Design at the Exascale" (Horizon 2020 EINFRA-5, Grant No. 676598);
- the swissuniversities P-5 project "Materials Cloud".
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for aiida_quantumespresso-3.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6dc7cb6390def0fe8290f8f13d63fc01322f18b69dfd6cd5b003f21565ef7051 |
|
MD5 | 2694130b58a6730bec970f6e2827fa2f |
|
BLAKE2b-256 | 7cd86acf774e93baca5d0c7840b838c9d2b87cfe54393b3d5b28f10c013f1946 |
Hashes for aiida_quantumespresso-3.2.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4253782e9ed0f8a80f0e18ea5b2dcb71780a5b5976075169a4a8b9a23ce10dd0 |
|
MD5 | 8225723addcedda87f3650fc98ce89c4 |
|
BLAKE2b-256 | eb75002d135559f41034b6666f81b10fefd86142a1ed9cb1cd950e7810a36b94 |