Metadata-Version: 2.4
Name: stages-thermo
Version: 0.0.1
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Rust
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Chemistry
Requires-Dist: numpy>=1.24
Requires-Dist: vle-thermo>=0.8
Requires-Dist: pytest>=7.0 ; extra == 'dev'
Requires-Dist: maturin>=1.0 ; extra == 'dev'
Requires-Dist: matplotlib>=3.7 ; extra == 'plot'
Provides-Extra: dev
Provides-Extra: plot
Summary: Staged-separation (distillation) column solver: McCabe–Thiele, Ponchon–Savarit, FUG shortcut, and rigorous MESH methods, built on vle-thermo
Keywords: distillation,separation,chemical-engineering,mccabe-thiele,mesh,column
Home-Page: https://github.com/miguelju/stages-thermo
Author-email: Miguel Jackson <admin@migueljackson.dev>
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Changelog, https://github.com/miguelju/stages-thermo/blob/main/ROADMAP.md
Project-URL: Homepage, https://github.com/miguelju/stages-thermo
Project-URL: Issues, https://github.com/miguelju/stages-thermo/issues
Project-URL: Repository, https://github.com/miguelju/stages-thermo

# stages-thermo

**A staged-separation (distillation) learning library and fast steady-state
column solver, built on [`vle-thermo`](https://pypi.org/project/vle-thermo/).**

`import stages` — walk the full pedagogical ladder of column methods
(McCabe–Thiele → Ponchon–Savarit → Fenske–Underwood–Gilliland shortcut →
rigorous MESH), each implemented from scratch and anchored to its textbook
equations, with a granular, batch-capable API ("numpy for distillation
columns"). All thermodynamics come from `vle-thermo`; this package adds none of
its own.

```sh
pip install stages-thermo      # import name is `stages`
```

> **Status:** `0.0.x` is a name-holding stub (Milestone 0, repo bootstrap). The
> only surface today is the vle-thermo smoke path. Column methods land
> milestone by milestone — see the repo's `ROADMAP.md`. Not usable for real
> work until `1.0`.

```python
import stages

stages.__version__
# '0.0.1'

# M0 smoke path: equimolar methanol/water bubble T [K] at 101.325 kPa, computed
# through vle-thermo. Approximate — proves the dependency links end-to-end,
# not a validated value.
stages.smoke_bubble_temperature()
```

The native core is a Rust crate (`stages-thermo` on crates.io) with PyO3
bindings; wheels are abi3 (`cp310-abi3-*`), so one wheel per (OS, arch) covers
CPython 3.10+.

## License

MIT © Miguel Roberto Jackson Ugueto

