# SPROCLIB - Standard Process Control Library
A comprehensive Python library for chemical process control, providing essential classes and functions for PID control, process modeling, simulation, optimization, and advanced control techniques.
**SPROCLIB provides a semantic API for chemical plant design that uses familiar patterns from machine learning frameworks like TensorFlow and Keras.**
## Installation
```bash
pip install sproclib
```
## Features
- **Semantic Plant Design**: Intuitive API similar to ML frameworks for building complex chemical processes
- **Process Units**: CSTR, pumps, heat exchangers, distillation columns, reactors, and tanks
- **Economic Optimization**: Built-in optimization algorithms for cost minimization and profit maximization
- **PID Controllers**: Classical and advanced PID control implementations with auto-tuning
- **Analysis Tools**: Transfer functions, simulation, and system identification
- **Advanced Control**: Model predictive control, state-space controllers, and IMC
- **Transport Models**: Continuous and batch transport for liquids and solids
## Quick Start
Create and optimize a chemical plant in just a few lines:
```python
from sproclib.unit.plant import ChemicalPlant
from sproclib.unit.pump import CentrifugalPump
from sproclib.unit.reactor import CSTR
# Define plant
plant = ChemicalPlant(name="Process Plant")
# Add units
plant.add(CentrifugalPump(H0=50.0, eta=0.75), name="feed_pump")
plant.add(CSTR(V=150.0, k0=7.2e10), name="reactor")
# Connect units
plant.connect("feed_pump", "reactor", "feed_stream")
# Configure optimization
plant.compile(
optimizer="economic",
loss="total_cost",
metrics=["profit", "conversion"]
)
# Optimize operations
plant.optimize(target_production=1000.0)
```
## Advanced Example
```python
# Traditional PID control example
import sproclib as spc
# Create a PID controller
controller = spc.PIDController(kp=1.0, ki=0.1, kd=0.05)
# Create a tank model
tank = spc.Tank(volume=100, area=10)
# Simulate step response
response = spc.step_response(tank, time_span=100)
```
## Requirements
- Python 3.8+
- NumPy >= 1.20.0
- SciPy >= 1.7.0
- Matplotlib >= 3.3.0
## License
MIT License
## Author
Thorsten Gressling <gressling@paramus.ai>
Raw data
{
"_id": null,
"home_page": "https://github.com/gressling/sproclib",
"name": "sproclib",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "process control, chemical engineering, PID, simulation, optimization, semantic API, machine learning",
"author": "Thorsten Gressling",
"author_email": "Thorsten Gressling <gressling@paramus.ai>",
"download_url": "https://files.pythonhosted.org/packages/16/3d/4c9fb4948278aab8462e6e3d0aafd3be69c2e82c8393ed9aac38d6936ea4/sproclib-3.0.1.tar.gz",
"platform": null,
"description": "# SPROCLIB - Standard Process Control Library\n\nA comprehensive Python library for chemical process control, providing essential classes and functions for PID control, process modeling, simulation, optimization, and advanced control techniques.\n\n**SPROCLIB provides a semantic API for chemical plant design that uses familiar patterns from machine learning frameworks like TensorFlow and Keras.**\n\n## Installation\n\n```bash\npip install sproclib\n```\n\n## Features\n\n- **Semantic Plant Design**: Intuitive API similar to ML frameworks for building complex chemical processes\n- **Process Units**: CSTR, pumps, heat exchangers, distillation columns, reactors, and tanks\n- **Economic Optimization**: Built-in optimization algorithms for cost minimization and profit maximization\n- **PID Controllers**: Classical and advanced PID control implementations with auto-tuning\n- **Analysis Tools**: Transfer functions, simulation, and system identification\n- **Advanced Control**: Model predictive control, state-space controllers, and IMC\n- **Transport Models**: Continuous and batch transport for liquids and solids\n\n## Quick Start\n\nCreate and optimize a chemical plant in just a few lines:\n\n```python\nfrom sproclib.unit.plant import ChemicalPlant\nfrom sproclib.unit.pump import CentrifugalPump\nfrom sproclib.unit.reactor import CSTR\n\n# Define plant\nplant = ChemicalPlant(name=\"Process Plant\")\n\n# Add units\nplant.add(CentrifugalPump(H0=50.0, eta=0.75), name=\"feed_pump\")\nplant.add(CSTR(V=150.0, k0=7.2e10), name=\"reactor\")\n\n# Connect units\nplant.connect(\"feed_pump\", \"reactor\", \"feed_stream\")\n\n# Configure optimization\nplant.compile(\n optimizer=\"economic\",\n loss=\"total_cost\",\n metrics=[\"profit\", \"conversion\"]\n)\n\n# Optimize operations\nplant.optimize(target_production=1000.0)\n```\n\n## Advanced Example\n\n```python\n# Traditional PID control example\nimport sproclib as spc\n\n# Create a PID controller\ncontroller = spc.PIDController(kp=1.0, ki=0.1, kd=0.05)\n\n# Create a tank model\ntank = spc.Tank(volume=100, area=10)\n\n# Simulate step response\nresponse = spc.step_response(tank, time_span=100)\n```\n\n## Requirements\n\n- Python 3.8+\n- NumPy >= 1.20.0\n- SciPy >= 1.7.0\n- Matplotlib >= 3.3.0\n\n## License\n\nMIT License\n\n## Author\n\nThorsten Gressling <gressling@paramus.ai>\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Standard Process Control Library for chemical process control - Semantic API for chemical plant design using familiar ML patterns",
"version": "3.0.1",
"project_urls": {
"Documentation": "https://sproclib.readthedocs.io/en/latest/",
"Homepage": "https://github.com/gressling/sproclib",
"Issues": "https://github.com/gressling/sproclib/issues",
"Repository": "https://github.com/gressling/sproclib"
},
"split_keywords": [
"process control",
" chemical engineering",
" pid",
" simulation",
" optimization",
" semantic api",
" machine learning"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a62fcb85610af419cdee14ff308889992e7feb6ad86d3fd073d28311366f0fd9",
"md5": "8859e4f0bcbe56ef2ed6c664b8c5de8b",
"sha256": "7176776159bf00705a6bd94028bdbf0744d851ab7db735bc72c844e7806535f9"
},
"downloads": -1,
"filename": "sproclib-3.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8859e4f0bcbe56ef2ed6c664b8c5de8b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 776271,
"upload_time": "2025-07-26T09:20:03",
"upload_time_iso_8601": "2025-07-26T09:20:03.793120Z",
"url": "https://files.pythonhosted.org/packages/a6/2f/cb85610af419cdee14ff308889992e7feb6ad86d3fd073d28311366f0fd9/sproclib-3.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "163d4c9fb4948278aab8462e6e3d0aafd3be69c2e82c8393ed9aac38d6936ea4",
"md5": "bbbd62ea042468dbb4c3e42f4a47f222",
"sha256": "9dd87e894a50313d18cf229013ceb58404d5a1bc7f9588f43b5a1e95265cf33d"
},
"downloads": -1,
"filename": "sproclib-3.0.1.tar.gz",
"has_sig": false,
"md5_digest": "bbbd62ea042468dbb4c3e42f4a47f222",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 24716124,
"upload_time": "2025-07-26T09:20:57",
"upload_time_iso_8601": "2025-07-26T09:20:57.754628Z",
"url": "https://files.pythonhosted.org/packages/16/3d/4c9fb4948278aab8462e6e3d0aafd3be69c2e82c8393ed9aac38d6936ea4/sproclib-3.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-26 09:20:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gressling",
"github_project": "sproclib",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "numpy",
"specs": [
[
">=",
"1.20.0"
]
]
},
{
"name": "scipy",
"specs": [
[
">=",
"1.7.0"
]
]
},
{
"name": "matplotlib",
"specs": [
[
">=",
"3.4.0"
]
]
},
{
"name": "cvxpy",
"specs": [
[
">=",
"1.2.0"
]
]
},
{
"name": "pyomo",
"specs": [
[
">=",
"6.0.0"
]
]
},
{
"name": "pandas",
"specs": [
[
">=",
"1.3.0"
]
]
},
{
"name": "jupyter",
"specs": [
[
">=",
"1.0.0"
]
]
},
{
"name": "python-control",
"specs": [
[
">=",
"0.9.0"
]
]
},
{
"name": "pytest",
"specs": [
[
">=",
"6.0.0"
]
]
},
{
"name": "pytest-cov",
"specs": [
[
">=",
"2.12.0"
]
]
},
{
"name": "sphinx",
"specs": [
[
">=",
"8.0.0"
]
]
},
{
"name": "sphinx-rtd-theme",
"specs": [
[
">=",
"3.0.0"
]
]
},
{
"name": "sphinx-autodoc-typehints",
"specs": [
[
">=",
"3.0.0"
]
]
},
{
"name": "myst-parser",
"specs": [
[
">=",
"4.0.0"
]
]
},
{
"name": "docutils",
"specs": [
[
">=",
"0.21.0"
]
]
},
{
"name": "pillow",
"specs": [
[
">=",
"9.0.0"
]
]
}
],
"lcname": "sproclib"
}
JSON
