Home - Nouman090/ThermoSim GitHub Wiki
Welcome to the ThermoSim.
ThermoSim Documentation
Welcome to the ThermoSim documentation — a Python package for modelling, analysing, and optimising thermodynamic power and refrigeration cycles.
What is ThermoSim?
ThermoSim lets you build thermodynamic cycle models by defining state points (temperature, pressure, enthalpy, etc.) and connecting them through components (turbines, pumps, heat exchangers, etc.). The package automatically:
- Calculates all thermodynamic properties using CoolProp
- Performs energy and exergy analysis
- Generates cycle diagrams (T-s, P-h, h-s)
- Runs parametric sensitivity studies
Supported Cycle Types
| Cycle Type | Components Used |
|---|---|
| Simple Rankine | Turbine, Pump, Boiler (HEX), Condenser (HEX) |
| Regenerative Rankine | + Splitter, Mixer, Open/Closed FWH |
| Reheat Rankine | + Multiple Turbines |
| Organic Rankine (ORC) | Same as Rankine with organic fluids (R245fa, R134a, etc.) |
| Simple Brayton | Compressor, Turbine, Heater (HEX), Cooler (HEX) |
| Regenerative Brayton | + Recuperator (HEX) |
| Vapour Compression Refrigeration | Compressor, Condenser, Expansion Valve, Evaporator |
| Combined Cycles | Any combination of above |
| Thermal Energy Storage | + TES component |
Supported Fluids
Any fluid available in CoolProp:
| Category | Examples |
|---|---|
| Water/Steam | 'water' |
| Refrigerants | 'R134a', 'R245fa', 'R410A', 'R744' (CO2) |
| Gases | 'Air', 'Nitrogen', 'Oxygen', 'Helium' |
| Hydrocarbons | 'n-Pentane', 'Isobutane', 'Propane' |
| Custom | 'Therminol66' (built-in polynomial model) |
Quick Links
| Page | Description |
|---|---|
| Installation | How to install the package |
| Quick-Start | Your first cycle in 5 minutes |
| State-Points | How thermodynamic states work |
| Turbine | Turbine component guide |
| Pump | Pump component guide |
| Compressor | Compressor component guide |
| Heat-Exchanger | All heat exchanger types |
| Expansion-Valve | Expansion valve guide |
| Mixer | Mixer component guide |
| Splitter | Splitter component guide |
| Separator | Flash separator guide |
| Pipe | Pipe with pressure/temperature drop |
| Source-and-Sink | Boundary conditions |
| Thermal-Energy-Storage | TES component |
| Model-Operations | Solve, Summary, Save/Load |
| Plotting | T-s, P-h, exergy charts |
| Sensitivity-Analysis | Parametric studies |
| Example-Simple-Rankine | Complete Rankine cycle example |
| Example-Regenerative-Rankine | Regenerative Rankine with extraction |
| Example-Brayton-Cycle | Gas turbine cycle |
| Example-ORC | Organic Rankine Cycle |
| Example-Refrigeration | Vapour compression refrigeration |
| Example-Combined-Cycle | Combined power cycle |
| API-Reference | Complete API reference |
| Troubleshooting | Common errors and solutions |