https://github.com/ornl/equilipy
Open-source python package for multicomponent multiphase equilibrium CALPHAD calculations
https://github.com/ornl/equilipy
calphad python
Last synced: 5 months ago
JSON representation
Open-source python package for multicomponent multiphase equilibrium CALPHAD calculations
- Host: GitHub
- URL: https://github.com/ornl/equilipy
- Owner: ORNL
- License: bsd-3-clause
- Created: 2023-10-18T16:58:10.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-04T18:12:28.000Z (almost 2 years ago)
- Last Synced: 2025-06-01T12:09:13.039Z (about 1 year ago)
- Topics: calphad, python
- Language: Fortran
- Homepage: https://ornl.github.io/Equilipy/
- Size: 4.24 MB
- Stars: 17
- Watchers: 5
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://pypi.org/project/equilipy/)
[](https://pypistats.org/packages/equilipy)
[](https://doi.org/10.21105/joss.06875)
[](https://doi.org/10.5281/zenodo.17408401)
# Equilipy
Equilipy is an open-source python package that offers multicomponent multiphase equilibrium calculations based on the CALPHAD (CALculation of PHAse Diagram) approach. With a set of Gibbs energy description (Thermochemical database) and input conditions (Composition, temperature, pressure), equilibrium phase configureation, amount, composition, and thermochemical properties can be obtained. Equilipy uses the Gibbs energy descriptions furnished by THERMOCHIMICA with the modified Gibbs energy minimization algorithm initially proposed by de Capitani, C. and Brown, T.H. (1987).
Check out [documentation](https://ornl.github.io/Equilipy/) for further description.
## Dependencies
|Dependency | Version | Required | Libraries |
|---------- | ------- |-------- |------- |
|Fortran | - | Yes | -
|Python | 3.9+ | Yes | numpy, wheel, meson, ninja
## Installation
Installation using `pip` is available for Equilipy.
```
pip install equilipy
```
## Features and example
The following features are currently available.
- Single condition equilibrium calculations
- Batch equilibrium calculations
- Scheil-Gulliver solidification
- Phase selection
Hehehe
For details, check out the example directory and [Features and Examples](https://ornl.github.io/Equilipy/features.html)
## Citing Equilipy
If you use Equilipy in your work, please cite the following [paper](CITATION.bib).
In addition, cite the current release or version used from
[Zenodo](https://doi.org/10.5281/zenodo.13157235).
## Contributing
We encourage you to contribute to Equilipy. Please see [contributing guidelines](CONTRIBUTING.md).
## Additional note
Examples in Equilipy uses `polars` dataframe for fast data processing. In particular, example 3 requires `fastexcel` as the optional dependancy in `polars`.
Install `fastexcel` via
```
pip install fastexcel
```
Additionally, if you are using large dataset (> 4billion), install
```
pip install polars-u64-idx
```
If you are using old CPUs, install
```
pip install polars-lts-cpu
```
For details, check out [polars dependencies](https://docs.pola.rs/api/python/stable/reference/api/polars.show_versions.html).