Metadata-Version: 2.1
Name: aiida-common-workflows
Version: 1.0.1
Summary: Package that defines common interfaces for workflows that are implemented in AiiDA for various quantum engines.
Keywords: aiida,workflows
Author-email: The AiiDA team <developers@aiida.net>
Requires-Python: >=3.8,<3.10
Description-Content-Type: text/markdown
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: AiiDA
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: abipy==0.9.6
Requires-Dist: aiida-abinit~=0.4.0
Requires-Dist: aiida-bigdft>=0.2.6
Requires-Dist: aiida-castep>=1.2.0a5
Requires-Dist: aiida-core[atomic_tools]~=1.6
Requires-Dist: aiida-cp2k~=1.6
Requires-Dist: aiida-fleur>=1.3.0
Requires-Dist: aiida-gaussian
Requires-Dist: aiida-nwchem>=2.1.0
Requires-Dist: aiida-orca
Requires-Dist: aiida-pseudo==0.6.5
Requires-Dist: aiida-quantumespresso~=3.4,>=3.4.1
Requires-Dist: aiida-siesta>=1.2.0
Requires-Dist: aiida-vasp~=2.2
Requires-Dist: aiida-wien2k~=0.1.1
Requires-Dist: aiida-ase
Requires-Dist: pymatgen>=2022.1.20
Requires-Dist: numpy<1.24.0
Requires-Dist: sqlalchemy<1.4
Requires-Dist: ase!=3.20.*
Requires-Dist: pint~=0.16
Requires-Dist: masci-tools~=0.9
Requires-Dist: docutils~=0.15.2 ; extra == "docs"
Requires-Dist: pygments~=2.5 ; extra == "docs"
Requires-Dist: pydata-sphinx-theme~=0.4.0 ; extra == "docs"
Requires-Dist: sphinx~=3.2 ; extra == "docs"
Requires-Dist: sphinx-panels~=0.5.0 ; extra == "docs"
Requires-Dist: sphinxcontrib-details-directive~=0.1.0 ; extra == "docs"
Requires-Dist: sphinx-copybutton~=0.3.0 ; extra == "docs"
Requires-Dist: pre-commit~=2.2 ; extra == "pre-commit"
Requires-Dist: pylint~=2.5.2 ; extra == "pre-commit"
Requires-Dist: pytest~=7.2 ; extra == "tests"
Requires-Dist: pgtest~=1.3,>=1.3.1 ; extra == "tests"
Requires-Dist: pytest-regressions~=1.0 ; extra == "tests"
Project-URL: Documentation, https://aiida-common-workflows.readthedocs.io
Project-URL: Home, https://github.com/aiidateam/aiida-common-workflows
Project-URL: Source, https://github.com/aiidateam/aiida-common-workflows
Provides-Extra: docs
Provides-Extra: pre-commit
Provides-Extra: tests

# AiiDA common workflows (ACWF) package: `aiida-common-workflows`
![AiiDA common workflows](docs/source/images/calculator.jpg)
<sup><sub>(Image © Giovanni Pizzi, 2021)</sub></sup>

The AiiDA common workflows (ACWF) project provides computational workflows, implemented in [AiiDA](https://www.aiida.net), to compute various material properties using any of the quantum engines that implement it.
The distinguishing feature is that the interfaces of the AiiDA common workflows are uniform, independent of the quantum engine that is used underneath to perform the material property simulations.
These common interfaces make it trivial to switch from quantum engine.
In addition to the common interface, the workflows provide input generators that automatically define the required inputs for a given task and desired computational precision.
For more information, please refer to the [online documentation](https://aiida-common-workflows.readthedocs.io/en/latest/).


## How to cite
If you use the workflow of this package, please cite the paper in which the work is presented:

> [S. P. Huber et al., npj Comput. Mater. 7, 136 (2021); doi:10.1038/s41524-021-00594-6](https://doi.org/10.1038/s41524-021-00594-6)

In addition, if you run the common workflows, please also cite:

1. The AiiDA engine that manages the simulations and stores the provenance:

   * Main AiiDA paper: [S.P. Huber et al., Scientific Data 7, 300 (2020)](https://doi.org/10.1038/s41597-020-00638-4)

   * AiiDA engine: [M. Uhrin et al., Comp. Mat. Sci. 187 (2021)](https://doi.org/10.1016/j.commatsci.2020.110086)

2. the quantum engine(s) that you will use. We provide below a table of references for your convenience.

Engine           | DOIs or URLs to be cited
---------------- | ----------------------------
ABINIT           | [10.1016/j.cpc.2016.04.003](https://doi.org/10.1016/j.cpc.2016.04.003) [10.1016/j.cpc.2019.107042](https://doi.org/10.1016/j.cpc.2019.107042) [10.1063/1.5144261](https://doi.org/10.1063/1.5144261)
BigDFT           | [10.1063/5.0004792](https://doi.org/10.1063/5.0004792)
CASTEP           | [10.1524/zkri.220.5.567.65075](https://doi.org/10.1524/zkri.220.5.567.65075)
CP2K             | [10.1002/wcms.1159](https://doi.org/10.1002/wcms.1159) [10.1063/5.0007045](https://doi.org/10.1063/5.0007045)
FLEUR            | [https://www.flapw.de](https://www.flapw.de)
Gaussian         | [see instructions here](https://gaussian.com/g09citation/)
GPAW             | [10.1103/PhysRevB.71.035109](https://doi.org/10.1103/PhysRevB.71.035109) [10.1088/0953-8984/22/25/253202](https://doi.org/10.1088/0953-8984/22/25/253202)
NWChem           | [10.1063/5.0004997](https://doi.org/10.1063/5.0004997)
ORCA             | [10.1002/wcms.81](https://doi.org/10.1002/wcms.81) [10.1002/wcms.1327](https://doi.org/10.1002/wcms.1327)
Quantum ESPRESSO | [10.1088/0953-8984/21/39/395502](https://doi.org/10.1088/0953-8984/21/39/395502) [10.1088/1361-648x/aa8f79](https://doi.org/10.1088/1361-648x/aa8f79)
SIESTA           | [10.1063/5.0005077](https://doi.org/10.1063/5.0005077) [10.1088/0953-8984/14/11/302](https://doi.org/10.1088/0953-8984/14/11/302)
VASP             | [10.1103/physrevb.54.11169](https://doi.org/10.1103/physrevb.54.11169)  [10.1103/physrevb.59.1758](https://doi.org/10.1103/physrevb.59.1758)
WIEN2k           | [10.1063/1.5143061](https://doi.org/10.1063/1.5143061)

