Metadata-Version: 2.4
Name: pyzentropy
Version: 0.1.0
Summary: Implementing recursive entropy in first-principles thermodynamics
Author-email: "Nigel L. E. Hew" <njh5724@psu.edu>
License: MIT
Keywords: entropy,thermodynamics,statistical mechanics,materials,science
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: numpy>=1.26
Requires-Dist: plotly>=5.18.0
Requires-Dist: nbformat>=4.2.0
Requires-Dist: scipy>=1.11.4
Dynamic: license-file

# pyzentropy
[![Testing](https://github.com/nhew1994/pyzentropy/actions/workflows/test.yml/badge.svg)](https://github.com/nhew1994/pyzentropy/actions/workflows/test.yml)

# Installation
## Recommended: Create a Virtual Environment

Using Conda:

    conda create -n pyzentropy python=3.12
    conda activate pyzentropy

## Install pyzentropy
### From PyPI (coming soon)

    python -m pip install pyzentropy

<sub>PyPI installation will be available in a future release. For now, please install from source as described below.</sub>

### From Source 

Clone the repository:

    git clone https://github.com/nhew1994/pyzentropy.git
    cd pyzentropy
    python -m pip install -e .

Or clone a specific branch:

    git clone -b <branch_name> https://github.com/nhew1994/pyzentropy.git
    cd pyzentropy
    python -m pip install -e .

# Example notebooks
Click the badge below to open the project in GitHub Codespaces.  
Then, browse the `examples/codespace` folder to explore and run the example notebooks:

[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/PhasesResearchLab/pyzentropy?quickstart=1)

| Notebooks    | Description |
|--------------|-------------|
| Fe<sub>3</sub>Pt | Example of applying zentropy to the 3 lowest energy configurations in Fe<sub>3</sub>Pt 12-atom supercell. The Helmholtz energies were calculated using the energy–volume curves and the Debye–Grüneisen model. |

