Metadata-Version: 2.4
Name: aiida-phonopy
Version: 1.7.0
Summary: The official AiiDA plugin for Phonopy
Keywords: aiida,phonopy,workflows
Author-email: Lorenzo Bastonero <bastonero.lorenzo@gmail.com>
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Classifier: Development Status :: 5 - Production/Stable
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.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Chemistry
License-File: LICENSE.txt
Requires-Dist: aiida-core~=2.8
Requires-Dist: phonopy~=3.0
Requires-Dist: aiida-pythonjob~=0.5
Requires-Dist: seekpath
Requires-Dist: myst-nb~=1.0 ; extra == "docs"
Requires-Dist: jupytext>=1.11.2,<1.15.0 ; extra == "docs"
Requires-Dist: sphinx~=6.2.1 ; extra == "docs"
Requires-Dist: sphinx-copybutton~=0.5.2 ; extra == "docs"
Requires-Dist: sphinx-book-theme~=1.0.1 ; extra == "docs"
Requires-Dist: sphinx-click~=4.4.0 ; extra == "docs"
Requires-Dist: sphinx-design~=0.4.1 ; extra == "docs"
Requires-Dist: sphinxcontrib-details-directive~=0.1.0 ; extra == "docs"
Requires-Dist: sphinx-autoapi~=3.0.0 ; extra == "docs"
Requires-Dist: myst-parser~=3.0.0 ; extra == "docs"
Requires-Dist: sphinx-togglebutton ; extra == "docs"
Requires-Dist: pre-commit~=2.17 ; extra == "pre-commit"
Requires-Dist: pylint==2.17.2 ; extra == "pre-commit"
Requires-Dist: pylint-aiida~=0.1.1 ; extra == "pre-commit"
Requires-Dist: toml ; extra == "pre-commit"
Requires-Dist: ase ; extra == "tests"
Requires-Dist: pgtest~=1.3 ; extra == "tests"
Requires-Dist: pytest~=8.4 ; extra == "tests"
Requires-Dist: coverage[toml] ; extra == "tests"
Requires-Dist: pytest-cov ; extra == "tests"
Requires-Dist: pytest-regressions~=2.8 ; extra == "tests"
Requires-Dist: pytest-timeout ; extra == "tests"
Project-URL: Source, https://github.com/aiida-phonopy/aiida-phonopy
Provides-Extra: docs
Provides-Extra: pre-commit
Provides-Extra: tests

# `aiida-phonopy`

This is the official AiiDA plugin for [Phonopy](https://phonopy.github.io/phonopy/index.html).

|    | |
|-----|----------------------------------------------------------------------------|
| Reference | [![DOI](https://img.shields.io/badge/DOI-10.1038/s41524024012363-purple.svg)](https://doi.org/10.1038/s41524-024-01236-3) |
|Latest release| [![PyPI version](https://badge.fury.io/py/aiida-phonopy.svg)](https://badge.fury.io/py/aiida-phonopy)[![PyPI pyversions](https://img.shields.io/pypi/pyversions/aiida-phonopy.svg)](https://pypi.python.org/pypi/aiida-phonopy) |
|Getting help| [![Docs status](https://readthedocs.org/projects/aiida-phonopy/badge)](http://aiida-phonopy.readthedocs.io/) [![Discourse status](https://img.shields.io/discourse/status?server=https%3A%2F%2Faiida.discourse.group%2F)](https://aiida.discourse.group/)
|Build status| [![Build Status](https://github.com/aiida-phonopy/aiida-phonopy/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/aiida-phonopy/aiida-phonopy/actions) [![Coverage Status](https://codecov.io/gh/aiida-phonopy/aiida-phonopy/branch/main/graph/badge.svg)](https://codecov.io/gh/aiida-phonopy/aiida-phonopy) |
|Activity| [![PyPI-downloads](https://img.shields.io/pypi/dm/aiida-phonopy.svg?style=flat)](https://pypistats.org/packages/aiida-phonopy) [![Commit Activity](https://img.shields.io/github/commit-activity/m/aiida-phonopy/aiida-phonopy.svg)](https://github.com/aiida-phonopy/aiida-phonopy/pulse)
|Community|  [![Discourse](https://img.shields.io/discourse/topics?server=https%3A%2F%2Faiida.discourse.group%2F&logo=discourse)](https://aiida.discourse.group/)

## Compatibility

From `v0.7.0` this plugin is not backward compatible with previous versions,
due to a restructuring of the package.

| Plugin | AiiDA | Phonopy |
|-|-|-|
| >=`v1.5.0` < v`2.0.0` | >=`v2.8.0` <`v3.0.0` |  >=`v3.0.0` <`v4.0.0` |
| >=`v1.0.0` < v`1.5.0` | >=`v2.0.0` <`v3.0.0` |  >=`v2.14.0` <`v3.0.0` |
| >=`v0.7.0` < v`1.0.0` | >=`v1.6.0` <`v2.0.0` |  >=`v2.14.0` <`v3.0.0` |

## Installation

To install from PyPI, simply execute:

    pip install aiida-phonopy

or when installing from source:

    git clone https://github.com/aiida-phonopy/aiida-phonopy
    pip install .

## How to cite

If you use this plugin for your research, please cite the following work:

* L. Bastonero and N. Marzari, [*Automated all-functionals infrared and Raman spectra*](https://doi.org/10.1038/s41524-024-01236-3), npj Computational Materials **10**, 55 (2024)

Please, also cite the respective Phonopy and AiiDA references:

* A. Togo, L. Chaput, T. Tadano, and Isao Tanaka, [*Implementation strategies in phonopy and phono3py*](https://dx.doi.org/10.1088/1361-648X/acd831), J. Phys. Condens. Matter **35**, 353001-1-22 (2023)

* A. Togo, [*First-principles Phonon Calculations with Phonopy and Phono3py*](https://doi.org/10.7566/JPSJ.92.012001), J. Phys. Soc. Jpn. **92**, 012001-1-21 (2023)

* S. P. Huber _et al._, [*AiiDA 1.0, a scalable computational infrastructure for automated reproducible workflows and data provenance*](https://doi.org/10.1038/s41597-020-00638-4), Scientific Data **7**, 300 (2020)

* M. Uhrin _et al._, [*Workflows in AiiDA: Engineering a high-throughput, event-based engine for robust and modular computational workflows*](https://www.sciencedirect.com/science/article/pii/S0927025620305772), Computational Materials Science **187**, 110086 (2021)

## License

The `aiida-phonopy` plugin package is released under the MIT license.
See the `LICENSE.txt` file for more details.

## Acknowlegements

We acknowledge support from:
* the [U Bremen Excellence Chairs](https://www.uni-bremen.de/u-bremen-excellence-chairs) program funded within the scope of the [Excellence Strategy of Germany’s federal and state governments](https://www.dfg.de/en/research_funding/excellence_strategy/index.html);
* the [MAPEX](https://www.uni-bremen.de/en/mapex) Center for Materials and Processes.

<img src="https://raw.githubusercontent.com/aiida-phonopy/aiida-phonopy/main/docs/source/images/UBREMEN.png" width="300px" height="108px"/>
<img src="https://raw.githubusercontent.com/aiida-phonopy/aiida-phonopy/main/docs/source/images/MAPEX.jpg" width="300px" height="99px"/>

