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.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0328747820d1a9f88c755befbb23ac7bd73fca56457074d8d9a434fe2b6649c4 |
|
MD5 | fdfae59ac4c7c71b708204c378670f97 |
|
BLAKE2b-256 | 2199c12559196957269094b4d9a8500e1b0cebf899620aa6bf4ea9e478a15e77 |
Hashes for aiida_quantumespresso-3.2.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8d05f30edec3d23bc8109ae233ede09fffc38bd32570631da0ba81580ff83156 |
|
MD5 | 9fb765412269fb109635848e7c858ef7 |
|
BLAKE2b-256 | 6ba3fbb32d4575aa2a49313e1184983884f145e11afc473daa9e5b274620fce3 |