processpi 0.2.0

Python toolkit for chemical engineering simulations, equipment design, and unit conversions

Process PI

Python toolkit for chemical engineering simulations, equipment design, and unit conversions

Built with ❤️ for chemical engineers.

---

📖 Overview

Process PI is a modular Python toolkit for chemical engineering that enables:

• Pipeline network simulations
• Unit conversions across SI, CGS, and Imperial systems
• Component-based property calculations
• And more, with advanced features under active development.

---

📑 Table of Contents

• Features
• Installation
• Getting Started
  • Unit Conversions
  • Components
  • Pipeline Network Engine
• Roadmap
• License

---

⚡ Features

• ⚙️ Unit Conversion System – Instant conversions between engineering unit systems.
• 🧪 Components Library – Access educational thermodynamic properties for 25+ fluids and growing.
• 🌐 Pipeline Network Engine – Build and simulate simple pipelines or complex interconnected networks, analyzing:
  • Pressure drops
  • Flow rates
  • Reynolds number
  • Pump requirements
• 🧮 Calculation Modules (WIP) – Heat transfer, mass transfer, and reaction engineering models in progress.
• 📊 Simulation Tools (Planned) – Transient dynamics, optimization, and interactive visualizations.

---

📦 Installation

Install from PyPI:

pip install processpi

For development:

git clone https://github.com/varma666/ProcessPi.git
cd ProcessPi
pip install -e .

---

🚀 Getting Started

1. Unit Conversions

from processpi.units import Length, Pressure, Temperature

# Length conversion
length = Length(1.5, "m")
print(length.to("ft"))  # Feet output

# Pressure conversion
p = Pressure(2, "bar")
print(p.to("psi"))      # PSI output

# Temperature conversion
t = Temperature(100, "C")
print(t.to("K"))        # Kelvin output

2. Components

from processpi.components import Water, Ethanol

water = Water()
ethanol = Ethanol()

print(f"Water density: {water.density()} kg/m3")
print(f"Ethanol viscosity: {ethanol.viscosity()} Pa·s")

⚠ Note: Component data is for educational/demo purposes only. Extended property support is in progress.

3. Pipeline Network Engine

Perform single-pipe or multi-pipe network simulations.

from processpi.pipelines.engine import PipelineEngine
from processpi.pipelines.pipes import Pipe
from processpi.components import Water
from processpi.units import VolumetricFlowRate, Diameter, Length

# Define pipe and fluid
pipe = Pipe(
    internal_diameter=Diameter(50, "mm"),
    length=Length(10, "m")
)
water = Water()

# Set up engine
engine = PipelineEngine()
engine.fit(
    flowrate=VolumetricFlowRate(0.001, "m3/s"),
    pipe=pipe,
    fluid=water
)

# Run calculations
results = engine.run()
engine.summary()

Planned upgrades:

• Dynamic simulations
• Branching/parallel pipeline analysis
• Integrated cost and energy optimization

---

🛣 Roadmap

• ✅ Pipeline Network Engine – Functional for single and multi-segment networks
• 🚧 Heat Transfer Modules – In progress for exchangers, conduction, and convection models
• 🚧 Mass Transfer & Reaction Modules – Basic structure in place, calculations coming soon
• 🔮 Advanced Features – Transient analysis, energy optimization, and GUI/web interfaces

---

📜 License

This project is licensed under the MIT License – see the LICENSE file for details.

ProcessPI – Built with ❤️ for chemical engineers.