Metadata-Version: 2.4
Name: genice3
Version: 3.0b2
Summary: A Swiss army knife to generate hydrogen-disordered ice structures.
Author-email: Masakazu Matsumoto <vitroid@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/genice-dev/GenIce3
Project-URL: Bug Tracker, https://github.com/genice-dev/GenIce3/issues
Project-URL: manual, https://genice-dev.github.io/GenIce3
Requires-Python: <3.14,>=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: networkx>=2.0.dev20160901144005
Requires-Dist: numpy>=2.0
Requires-Dist: pairlist>=0.6.4
Requires-Dist: cycless>=0.7
Requires-Dist: graphstat>=0.3.3
Requires-Dist: yaplotlib>=0.1.2
Requires-Dist: openpyscad>=0.5.0
Requires-Dist: genice-core>=1.3.1
Requires-Dist: pyyaml>=6.0
Requires-Dist: jinja2>=3.1.4
Requires-Dist: cif2ice<0.5.0,>=0.4.1
Provides-Extra: dev
Requires-Dist: mkdocs>=1.5.0; extra == "dev"
Requires-Dist: mkdocs-material>=9.0.0; extra == "dev"
Requires-Dist: pymdown-extensions>=10.0; extra == "dev"
Requires-Dist: toml>=0.10.2; extra == "dev"
Requires-Dist: ipykernel>=6.27.1; extra == "dev"
Requires-Dist: py3dmol>=2.0.4; extra == "dev"
Requires-Dist: matplotlib>=3.8.2; extra == "dev"
Requires-Dist: genice2-svg>=2.2; extra == "dev"
Requires-Dist: plotly>=5.18.0; extra == "dev"
Requires-Dist: nbformat>=5.9.2; extra == "dev"
Requires-Dist: genice2-mdanalysis>=0.6.5; extra == "dev"
Requires-Dist: requests>=2.31.0; extra == "dev"
Requires-Dist: pytest>=8.1.1; extra == "dev"
Requires-Dist: genice2-cif>=2.2.1; extra == "dev"
Requires-Dist: watchdog>=4.0; extra == "dev"
Dynamic: license-file

![Logo](https://raw.githubusercontent.com/vitroid/GenIce/develop/logo/genice-v0.png)

# GenIce3

A Swiss army knife to generate hydrogen-disordered ice structures.

**Quick start:** Use the unit cell name as the first argument (e.g. `1h` for Ice Ih, `4` for Ice IV): `genice3 1h > ice.gro`

Version 3.0b2

For **usage**, **ice structures**, **output formats**, **water models**, **guest molecules**, and the full manual, see the [documentation](https://genice-dev.github.io/GenIce3).

## New in GenIce3

-   **Command line**: Option syntax unified; options can be read from config files.
-   **API**: Improved API; embed protonic (H<sub>3</sub>O<sup>+</sup>, OH<sup>−</sup>) and Bjerrum topological defects via Python.
-   **Algorithm**: Reactive pipeline with `DependencyEngine`; data generation runs automatically from your specifications.

## Demo

[Try GenIce3 on Google Colaboratory](https://colab.research.google.com/github/genice-dev/GenIce3/blob/main/API.ipynb).

## Requirements

- networkx >=2.0.dev20160901144005
- numpy >=2.0
- pairlist >=0.6.4
- cycless >=0.7
- graphstat >=0.3.3
- yaplotlib >=0.1.2
- openpyscad >=0.5.0
- genice-core >=1.3.1
- pyyaml >=6.0
- jinja2 >=3.1.4
- cif2ice (>=0.4.1,<0.5.0)


## Installation

GenIce3 is on [PyPI](https://pypi.org/project/genice3/). Install with pip:

```shell
pip install genice3
```

## Uninstallation

```shell
pip uninstall genice3
```

## References

See the [manual → References](https://genice-dev.github.io/GenIce3/references/) for the full reference list (generated from `citations.yaml`).

## Citation

If you use GenIce in your work, please cite as in [CITATION.cff](CITATION.cff) or:

> M. Matsumoto, T. Yagasaki, and H. Tanaka, "GenIce: Hydrogen-Disordered Ice Generator", _J. Comput. Chem._ **39**, 61-64 (2017). [DOI: 10.1002/jcc.25077](http://doi.org/10.1002/jcc.25077)

> M. Matsumoto, T. Yagasaki, and H. Tanaka, "GenIce-core: Efficient algorithm for generation of hydrogen-disordered ice structures.", _J. Chem. Phys._ **160**, 094101 (2024). [DOI:10.1063/5.0198056](https://doi.org/10.1063/5.0198056)

## How to contribute

GenIce is developed on GitHub (https://github.com/genice-dev/GenIce3). Feedback, bug fixes, and contributions are welcome.

## License

MIT License. See [LICENSE](LICENSE) for details.
