Metadata-Version: 2.1
Name: turbodash-core
Version: 0.2.5
Summary: Interactive Dash app for turbomachinery stage performance analysis
Home-page: https://github.com/turbo-sim/turbodash
License: MIT
Author: Roberto Agromayor
Requires-Python: >=3.11,<3.14
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: dash (>=3.2.0,<4.0.0)
Requires-Dist: gunicorn (>=22.0.0,<23.0.0)
Requires-Dist: matplotlib (>=3.10.6,<4.0.0)
Requires-Dist: numpy (>=2.3.0,<3.0.0)
Requires-Dist: plotly (>=5.23.0,<6.0.0)
Requires-Dist: scipy (>=1.16.1,<2.0.0)
Project-URL: Documentation, https://github.com/turbo-sim/turbodash
Project-URL: Repository, https://github.com/turbo-sim/turbodash
Description-Content-Type: text/markdown

# Turbodash

`turbodash` is an interactive Dash application for analyzing the efficiency of turbine stages.

- 🔗 **App**: [turbodash.onrender](https://turbodash.onrender.com/)
- 📦**PyPI**: [pypi.org/project/turbodash-core](https://pypi.org/project/turbodash-core/)


## Key features
- Visualization of total-to-static and total-to-total efficiencies.  
- Supports both axial flow, radial inflow, and radial outflow turbine stages.
- Adjustable stator/rotor geometry, reaction degree, loss coefficients, and blade velocity ratio. 
- Lightweight, dependency-minimal design based on Plotly Dash.
- Automatic synchronization between sliders and numeric inputs for precise parameter control.  
- Documentation describing the derivation of governing equations and special analytical cases.  

## 🚀 Installation and local run

You can install **turbodash** directly from PyPI or GitHub:

```bash
pip install turbodash
```

Once installed, you can run the interactive Dash application locally using the script ``demos/run_app_local.py``. This will start a local server and open the interactive calculator dashboard.

## Documentation
The theoretical derivation of the governing equations, efficiency definitions, and validation against analytical special cases are available directly in the app under the Documentation tab.

## License
This project is released under the MIT License.

