Metadata-Version: 2.4
Name: zeose
Version: 0.0.1
Summary: A package with functions that automate zeolite structure building processes
Author-email: Jerry Crum <jcrum@nd.edu>, Alex Hoffman <ahoffman2011@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/jtcrum/zse
Project-URL: Issues, https://github.com/jtcrum/zse/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Intended Audience :: Science/Research
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: ase
Requires-Dist: networkx
Requires-Dist: jupyter>=1.1.1
Requires-Dist: ipython>=8.37.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Dynamic: license-file

![ZSE Logo](./examples/figures/zse_logo.jpeg)

# Zeolite Simulation Environment
Authors: Jerry T. Crum, Justin R. Crum

## Description
This is a package to automate zeolite structure generation and characterization for computational chemistry.

## Requirements
This package is built around the ASE atoms object, and thus requires installation of ASE, available at: [https://wiki.fysik.dtu.dk/ase/install.html](https://wiki.fysik.dtu.dk/ase/install.html).

Ring finding uses graph theory implemented by NetworkX, available at: [https://networkx.github.io](https://networkx.github.io).

Numpy is also required.

## Installation
Clone this git repository,

```bash
git clone https://github.com/jtcrum/zse
```

and then install it with pip:

```bash
pip install ./zse
```

## Current Modules
To see how to use each of the modules, please visit [examples](/examples).
- `zse.cation`
- `zse.cif_tools`
- `zse.collections`
- `zse.protonate`
- `zse.rings`
- `zse.substitute`
- `zse.tpairs`
- `zse.utilities`

## Contributions
If there is something you would like to see added to this package, or if you would like to contribute, please email me at jcrum@nd.edu.

## Acknowledgments
### Contributors
Sichi Li, Craig Waitt, Yujia Wang, William Schneider, Alex Hoffman

### Testers
Jian Ren Lim, Elsa Koninckx

### Funding Sources
- [Center for Innovative and Strategic Transformation of Alkane Resources](https://cistar.us)
- [Designing Materials to Revolutionize and Engineer our Future](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1922173&HistoricalAwards=false)
- [Arthur J. Schmitt Leadership Fellowship](https://graduateschool.nd.edu/graduate-training/leadership/society-of-schmitt-fellows/)

### Computational Resources
This research was supported in part by the Notre Dame [Center for Research Computing](https://docs.crc.nd.edu/index.html) through access to the HPC clusters.

### Research Group
Many thanks to all the members of the [Schneider Group](https://wfschneidergroup.github.io) who listened to me present this material over and over again, and provided input into how to make ZSE more useful.

-------

<table>
    <tr>
        <td><img src="./examples/figures/cistar_logo.png" alt="CISTAR Logo"></td>
        <td><img src="examples/figures/comsel_logo.png" alt="COMSEL Logo"></td>
    </tr>
</table>

