Metadata-Version: 2.4
Name: csp-cryspy
Version: 1.5.0
Summary: CrySPY is a crystal structure prediction tool written in Python.
Author-email: Tomoki Yamashita <yamashita06@vos.nagaokaut.ac.jp>
Maintainer-email: Tomoki Yamashita <yamashita06@vos.nagaokaut.ac.jp>
License-Expression: MIT
Project-URL: documentation, https://tomoki-yamashita.github.io/CrySPY_doc
Project-URL: repository, https://github.com/Tomoki-YAMASHITA/CrySPY.git
Project-URL: changelog, https://github.com/Tomoki-YAMASHITA/CrySPY/blob/master/CHANGELOG.md
Keywords: CSP
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyxtal>=1.0.7
Dynamic: license-file

![cryspy_logo](https://github.com/Tomoki-YAMASHITA/CrySPY/blob/master/logo/cryspy_fix-03.png)

[![PyPI version](https://badge.fury.io/py/csp-cryspy.svg)](https://badge.fury.io/py/csp-cryspy)
[![Downloads](https://static.pepy.tech/badge/csp-cryspy)](https://pepy.tech/project/csp-cryspy)

# CrySPY
CrySPY (pronounced as crispy) is a crystal structure prediction tool written in Python.  
Document: https://tomoki-yamashita.github.io/CrySPY_doc  
Questions and comments: https://github.com/Tomoki-YAMASHITA/CrySPY/discussions


## System requirements
### Python
- Python >= 3.10
- [PyXtal >= 1.0.7](https://pyxtal.readthedocs.io/en/latest "PyXtal")

(optional)
- [PHYSBO](https://www.pasums.issp.u-tokyo.ac.jp/physbo/en/about "PHYSBO") (required if algo is BO)
- [DScribe](https://singroup.github.io/dscribe/latest/ "DScribe") (required if algo is BO)
- [mpi4py](https://mpi4py.readthedocs.io/en/stable "mpi4py")
- [nglview](https://github.com/nglviewer/nglview "nglview")


See [CrySPY document](https://tomoki-yamashita.github.io/CrySPY_doc/installation/requirements/ "CrySPY document") in detail.

### Structure optimizer
At least one optimizer is required.

- [VASP](https://www.vasp.at "VASP") (tested with version 5.4.4)
- [QUANTUM ESPRESSO](http://www.quantum-espresso.org "Quantum ESPRESSO") (tested with version 6.x, version 5.x does not work)
- [OpenMX](http://www.openmx-square.org "OpenMX")
- [soiap](https://github.com/nbsato/soiap "soiap") (tested with version 0.2.2)
- [LAMMPS](http://lammps.sandia.gov "LAMMPS")
- [ASE](https://wiki.fysik.dtu.dk/ase "ASE")


## Document (English/Japanese)
[CrySPY document](https://tomoki-yamashita.github.io/CrySPY_doc "CrySPY documment")

## CrySPY Utility
[CrySPY Utility](https://github.com/Tomoki-YAMASHITA/CrySPY_utility "CrySPY Utility")

## Reference
### CrySPY (software)
* T. Yamashita, S. Kanehira, N. Sato, H. Kino, H. Sawahata, T. Sato, F. Utsuno, K. Tsuda, T. Miyake, and T. Oguchi, Sci. Technol. Adv. Mater. Meth. **1**, 87 (2021).
    - https://www.tandfonline.com/doi/full/10.1080/27660400.2021.1943171


### Bayesian optimization
* T. Yamashita, N. Sato, H. Kino, T. Miyake, K. Tsuda, and T. Oguchi, Phys. Rev. Mater. **2**, 013803 (2018).
    - https://journals.aps.org/prmaterials/abstract/10.1103/PhysRevMaterials.2.013803

* N. Sato, T. Yamashita, T. Oguchi, K. Hukushima, and T. Miyake, Phys. Rev. Mater. **4**, 033801 (2020).
    - https://journals.aps.org/prmaterials/abstract/10.1103/PhysRevMaterials.4.033801

### Baysian optimization and evolutionary algorithm
* T. Yamashita, H. Kino, K. Tsuda, T. Miyake, and T. Oguchi, Sci. Technol. Adv. Mater. Meth. **2**, 67 (2022).
    - https://www.tandfonline.com/doi/full/10.1080/27660400.2022.2055987

### LAQA
* K.Terayama, T. Yamashita, T. Oguchi, and K. Tsuda, npj Comput. Mater. **4**, 32 (2018).
    - https://www.nature.com/articles/s41524-018-0090-y

* T. Yamashita and H. Sekine, Sci. Technol. Adv. Mater. Meth. **2**, 84 (2022).
    - https://www.tandfonline.com/doi/full/10.1080/27660400.2022.2059335


## License
CrySPY is distributed under the MIT License.  
Copyright (c) 2018 CrySPY Development Team
