Metadata-Version: 2.1
Name: abics
Version: 2.2.1
Summary: ab-Initio Configuration Sampling tool kit
Home-page: https://github.com/issp-center-dev/abICS
License: GPL-3.0-or-later
Author: abICS developers
Author-email: abics-dev@issp.u-tokyo.ac.jp
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Provides-Extra: nequip
Requires-Dist: mpi4py (>=3,<4)
Requires-Dist: nequip (>=0.5.6) ; extra == "nequip"
Requires-Dist: numpy (>=1.20,<2.0)
Requires-Dist: pymatgen (>=2022.1.20)
Requires-Dist: qe_tools (>=1.1,<2.0)
Requires-Dist: scipy (>=1,<2)
Requires-Dist: toml (>=0.10)
Project-URL: Repository, https://github.com/issp-center-dev/abICS
Description-Content-Type: text/markdown

# abICS
abICS is a software framework for training a machine learning model to
reproduce first-principles energies and then using the model to perform
configurational sampling in disordered systems.
Specific emphasis is placed on multi-component solid state systems such as metal and oxide alloys.
The current version of abics can use neural network models implemented in aenet to be used as 
the machine learning model. As of this moment, abICS can also generate Quantum Espresso, VASP, 
and OpenMX input files for obtaining the reference training data for the machine learning model.

## Requirement

- python3 (>=3.9)
- numpy
- scipy
- toml (for parsing input files)
- mpi4py (for parallel tempering)
  - This requires one of the MPI implementation
- pymatgen (>=2022.1.20) (for using Structure as a configuration)
  - This requires Cython
- qe-tools (for parsing QE I/O)

## Install abICS

Pymatgen requires Cython but Cython will not be installed automatically,
please make sure that this is installed,

``` bash
$ python3 -m pip install Cython
```

mpi4py requires one of the MPI implementations such as OpenMPI,
please make sure that this is also installed.
In the case of using homebrew on macOS, for example,

``` bash
$ brew install open-mpi
```

After installing Cython and MPI,

``` bash
$ python3 -m pip install abics
```

will install abICS and dependencies.

If you want to change the directory where abICS is installed,
add `--user` option or `--prefix=DIRECTORY` option to the above command as

``` bash
$ python3 -m pip install --user abics
```

For details of `pip` , see the manual of `pip` by `python3 -m pip help install`

If you want to install abICS from source, see [wiki page](https://github.com/issp-center-dev/abICS/wiki/Install)

## License

The distribution of the program package and the source codes follow GNU General Public License version 3 ([GPL v3](http://www.gnu.org/licenses/gpl-3.0.en.html)). 

We hope that you cite the following article when you publish the results using abICS.

Shusuke Kasamatsu, Yuichi Motoyama, Kazuyoshi Yoshimi, Tatsumi Aoyama, “Configuration sampling in multi-component multi-sublattice systems enabled by ab Initio Configuration Sampling Toolkit (abICS)”, [accepted in STAM: Methods](https://doi.org/10.1080/27660400.2023.2284128) ([arXiv:2309.04769](https://arxiv.org/abs/2309.04769).)

Bibtex:

```
@article{kasamatsu2023configuration,
author = {Shusuke Kasamatsu, Yuichi Motoyama, Kazuyoshi Yoshimi and Tatsumi Aoyama},
title = {Configuration sampling in multi-component multi-sublattice systems enabled by ab initio Configuration sampling toolkit ({abICS})},
journal = {Science and Technology of Advanced Materials: Methods},
volume = {0},
number = {ja},
pages = {2284128},
year = {2023},
publisher = {Taylor & Francis},
doi = {10.1080/27660400.2023.2284128},
URL = {https://doi.org/10.1080/27660400.2023.2284128},
eprint = {https://doi.org/10.1080/27660400.2023.2284128}
}
```

## Official page

https://www.pasums.issp.u-tokyo.ac.jp/abics

## Author

Shusuke Kasamatsu, Yuichi Motoyama, Tatsumi Aoyama, Kazuyoshi Yoshimi

## Manual

[English online manual](https://issp-center-dev.github.io/abICS/docs/master/en/html/index.html)

[Japanese online manual](https://issp-center-dev.github.io/abICS/docs/master/ja/html/index.html)

[API reference](https://issp-center-dev.github.io/abICS/docs/api/master/html/index.html)

