thermodynamics-workflow
Skill81 starsChanged 12 months agoMITView on GitHub
Analyze thermodynamic cycles and heat transfer in pump systems
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 38
Transient Flow: Start-up, shutdown, surge conditions
- Distinctive: line 618
Not all stages contribute equally:
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Thermodynamics Analysis Workflow
Overview
This skill provides a systematic approach to thermodynamic analysis of pump systems, including energy balance, entropy analysis, heat transfer, and cycle calculations. The methodology follows classical thermodynamics principles applied specifically to pumping systems and fluid machinery.
Thermodynamic Analysis Workflow
1. System Definition and Boundaries
Define the Control Volume:
The first step in any thermodynamic analysis is to clearly define the system boundaries.
For Pump Systems:
- Control Volume: The pump casing from suction flange to discharge flange
- Boundaries: Physical surfaces where fluid/energy crosses
- Interfaces:
- Inlet: Suction flange (station 1)
- Outlet: Discharge flange (station 2)
- Shaft: Mechanical energy input
- Walls: Heat transfer surface (if applicable)
System Classification:
- Open System (Control Volume): Most pump analyses
- Steady Flow: Constant properties with time
- Transient Flow: Start-up, shutdown, surge conditions
Assumptions to Document:
- Steady-state operation
- Uniform properties at inlet/outlet
- Negligible kinetic energy changes (if applicable)
- Adiabatic walls (or specify heat transfer)
- No chemical reactions
- Incompressible flow (for liquids) or compressible (for gases)
Coordinate System:
- Define datum for potential energy (z = 0)
- Specify flow direction (positive flow)
- Identify measurement planes
2. State Point Identification
Thermodynamic State Definition:
For a pure substance, two independent intensive properties define the state.
State Point 1 (Inlet/Suction):
Identify and measure:
Properties at inlet:
- Pressure: P₁ (Pa, bar, psi)
- Temperature: T₁ (K, °C)
- Velocity: c₁ (m/s)
- Elevation: z₁ (m)
- Phase: Liquid, vapor, two-phaseState Point 2 (Outlet/Discharge):
Identify and measure:
Properties at outlet:
- Pressure: P₂ (Pa, bar, psi)
- Temperature: T₂ (K, °C)
- Velocity: c₂ (m/s)
- Elevation: z₂ (m)
- Phase: Liquid, vapor, two-phaseAdditional State Points:
For complex systems:
- Interstage conditions (multistage pumps)
- Impeller exit (before volute losses)
- Intermediate heat exchangers
- Recirculation loops
Property Diagrams:
Plot state points on:
- P-h diagram: Pressure vs. specific enthalpy
- T-s diagram: Temperature vs. specific entropy
- P-v diagram: Pressure vs. specific volume
- Mollier diagram: h-s chart
3. Property Evaluation
Fluid Property Sources:
For Pure Substances:
- Water/Steam: IAPWS-IF97 formulation (via CoolProp)
- Refrigerants: NIST REFPROP database
- Hydrocarbons: Peng-Robinson or Soave-Redlich-Kwong EOS
- Cryogenic fluids: NIST correlations
For Incompressible Liquids:
Specific volume: v ≈ constant
Specific heat: cp ≈ constant
Internal energy: du = cp·dT
Enthalpy: dh = cp·dT + v·dPFor Ideal Gases:
Equation of state: P·v = R·T
Specific heats: cp, cv = f(T)
Internal energy: du = cv·dT
Enthalpy: dh = cp·dT
Entropy: ds = cp·dT/T - R·dP/PProperty Evaluation Methods:
Method 1: Using CoolProp (Recommended)
from CoolProp.CoolProp import PropsSI
# Water at 25°C, 2 bar
h = PropsSI('H', 'T', 298.15, 'P', 200000, 'Water') # J/kg
s = PropsSI('S', 'T', 298.15, 'P', 200000, 'Water') # J/kg-K
rho = PropsSI('D', 'T', 298.15, 'P', 200000, 'Water') # kg/m³Method 2: Property Tables
- Steam tables (superheated, saturated, compressed liquid)
- Interpolation between table values
- Linear or quadratic interpolation
Method 3: Empirical Correlations
- Density: ρ(T, P) correlations
- Viscosity: Andrade or Vogel equation
- Specific heat: polynomial fits
Critical Properties to Evaluate:
At each state point:
- Specific enthalpy: h (J/kg or kJ/kg)
- Specific entropy: s (J/kg-K or kJ/kg-K)
- Specific volume: v (m³/kg) or density ρ (kg/m³)
- Specific internal energy: u (J/kg or kJ/kg)
- Quality: x (for two-phase mixtures)
- Viscosity: μ (Pa·s) - for loss calculations
- Thermal conductivity: k (W/m-K) - for heat transfer
4. First Law Analysis (Energy Balance)
General Energy Equation for Open Systems:
For a control volume in steady flow:
Q̇ - Ẇ = ṁ[(h₂ - h₁) + (c₂² - c₁²)/2 + g(z₂ - z₁)]Where:
- Q̇ = heat transfer rate (W)
- Ẇ = work transfer rate (W)
- ṁ = mass flow rate (kg/s)
- h = specific enthalpy (J/kg)
- c = velocity (m/s)
- g = 9.81 m/s²
- z = elevation (m)
For Pump Systems:
Work is done ON the fluid (Ẇ < 0 by convention), so:
Ẇshaft = ṁ[(h₂ - h₁) + (c₂² - c₁²)/2 + g(z₂ - z₁)] + Q̇lossSimplified Forms:
Incompressible Liquid (Constant Density):
Ẇshaft/ṁ = (P₂ - P₁)/ρ + (c₂² - c₁²)/2 + g(z₂ - z₁) + q_lossThis can be written in terms of head:
H = (P₂ - P₁)/(ρg) + (c₂² - c₁²)/(2g) + (z₂ - z₁) + h_lossAdiabatic Pump (No Heat Loss):
Ẇshaft = ṁ[(h₂ - h₁) + (c₂² - c₁²)/2 + g(z₂ - z₁)]Negligible Kinetic and Potential Energy Changes:
Ẇshaft = ṁ(h₂ - h₁) + Q̇lossEnergy Balance Components:
- Enthalpy Change:
- Pressure rise: Δh_pressure = ∫v·dP
- Temperature rise: Δh_thermal = cp·ΔT
- Kinetic Energy Change:
- Usually small for pumps (< 5% of total)
- Important for high-velocity applications
- Potential Energy Change:
- Significant for vertical pumps
- Negligible for horizontal installations
- Heat Transfer:
- Heat loss to environment: Q̇loss
- Can be from temperature measurements
- Typically 1-5% of shaft power
Temperature Rise in Pumped Fluid:
The temperature rise due to inefficiency:
ΔT = (1 - η)·Ẇshaft / (ṁ·cp)Where η is the pump efficiency.
For incompressible liquids:
ΔT = (1 - η)·g·H / cpExample: Water pump, H = 100 m, η = 0.80, cp = 4186 J/kg-K
ΔT = (1 - 0.80)·9.81·100 / 4186 = 0.47°C5. Second Law Analysis (Entropy and Efficiency)
Entropy Balance:
For a control volume in steady flow:
ṁ(s₂ - s₁) = Q̇/T_boundary + ṠgenWhere:
- s = specific entropy (J/kg-K)
- Ṡgen = entropy generation rate (W/K)
- T_boundary = boundary temperature (K)
Entropy Generation:
Measures irreversibility in the process:
Ṡgen = ṁ(s₂ - s₁) - Q̇/T_boundaryFor adiabatic pump:
Ṡgen = ṁ(s₂ - s₁)Isentropic Efficiency:
Compares actual process to ideal isentropic process:
η_isentropic = (h₂s - h₁) / (h₂ - h₁)Where:
- h₂s = specific enthalpy at P₂ with s₂s = s₁ (isentropic)
- h₂ = actual specific enthalpy at outlet
For Incompressible Liquids:
The isentropic work is:
w_isentropic = ∫v·dP = v·(P₂ - P₁) = (P₂ - P₁)/ρExergy Analysis:
Exergy (availability) represents maximum useful work:
ψ = (h - h₀) - T₀(s - s₀) + c²/2 + gzWhere subscript 0 denotes dead state (ambient conditions).
Exergy destruction:
Ẋdestroyed = T₀·ṠgenSecond Law Efficiency:
η_II = Ẋuseful / Ẋinput = 1 - Ẋdestroyed / ẊinputThis represents how effectively the pump uses available energy.
Loss Breakdown by Entropy Generation:
Different loss mechanisms contribute to entropy generation:
- Friction losses: Fluid friction in impeller and volute
- Shock losses: Flow separation and incidence
- Leakage losses: Recirculation through clearances
- Disk friction: Viscous shear on impeller surfaces
- Heat transfer: Irreversible heat transfer to/from fluid
6. Cycle Calculations
Thermodynamic Cycles Relevant to Pumps:
While pumps are typically single components, they operate within larger thermodynamic cycles.
Rankine Cycle (Steam Power Plants)
Components:
- Boiler (heat addition)
- Turbine (power output)
- Condenser (heat rejection)
- Feedwater pump (pressure increase)
Pump Analysis in Rankine Cycle:
State points:
- State 3: Condenser outlet (saturated or subcooled liquid)
- State 4: Boiler inlet (high-pressure compressed liquid)
Pump work (isentropic):
w_pump,s = v₃·(P₄ - P₃) = h₄s - h₃Actual pump work:
w_pump = w_pump,s / η_pumpImpact on Cycle Efficiency:
η_cycle = (w_turbine - w_pump) / q_inPump work is typically 1-3% of turbine work in Rankine cycles.
Brayton Cycle (Gas Turbines)
Not directly applicable to liquid pumps, but relevant for:
- Fuel pumps in gas turbines
- Liquid rocket propellant pumps
- High-pressure fluid systems
Key Differences from Rankine:
- Working fluid remains gas throughout
- Compression instead of pumping
- Higher temperature ratios
Refrigeration Cycle
Relevant for:
- Refrigerant pumps in heat pumps
- Chiller systems
- Cryogenic pumping
Components:
- Evaporator
- Compressor (or pump for liquid systems)
- Condenser
- Expansion valve
Coefficient of Performance (COP):
COP = Q_useful / W_inputWhere pump work contributes to W_input.
Applications to Pumps
Temperature Rise in Pumped Fluid
Physical Mechanism:
Inefficiencies in pumps convert mechanical energy to thermal energy, causing temperature rise.
Calculation Method:
From Energy Balance:
ΔT = (h₂ - h₁) / cp - v·(P₂ - P₁) / cpSimplified for Liquids:
ΔT = (1 - η)·v·(P₂ - P₁) / cpOr in terms of head:
ΔT = (1 - η)·g·H / cpFactors Affecting Temperature Rise:
- Pump efficiency: Lower η → higher ΔT
- Pressure rise: Higher ΔP → higher ΔT
- Specific heat: Lower cp → higher ΔT
- Operating point: Off-design → lower η → higher ΔT
Practical Implications:
- Cold fluids: May cause condensation in surroundings
- Hot fluids: May approach boiling point, causing cavitation
- Viscous fluids: Significant heating (η low, friction high)
- Volatile fluids: Risk of vaporization
- Polymers: May degrade at elevated temperatures
Example Calculations:
Water pump:
- H = 200 m, η = 0.75, cp = 4186 J/kg-K
- ΔT = 0.25·9.81·200/4186 = 1.17°C
Hydraulic oil:
- ΔP = 200 bar, η = 0.70, ρ = 850 kg/m³, cp = 2000 J/kg-K
- ΔT = 0.30·200e5/(850·2000) = 3.53°C
High viscosity fluid:
- H = 50 m, η = 0.50 (low due to viscosity), cp = 2500 J/kg-K
- ΔT = 0.50·9.81·50/2500 = 0.98°C
Efficiency and Losses
Overall Efficiency:
η = η_h · η_vol · η_mechComponent Efficiencies:
- Hydraulic Efficiency (η_h):
- Accounts for fluid friction and shock losses
- Typical: 0.85-0.95
- Volumetric Efficiency (η_vol):
- Accounts for internal leakage
- Typical: 0.96-0.99
- Mechanical Efficiency (η_mech):
- Accounts for bearing and seal friction
- Typical: 0.95-0.98
Thermodynamic Loss Analysis:
Each loss mechanism increases entropy:
Friction Loss:
Ṡ_friction = ṁ·g·h_friction / T_avgLeakage Loss:
Ṡ_leakage = ṁ_leak·(s_discharge - s_suction)Heat Transfer Loss:
Ṡ_heat = Q̇_loss / T_boundary - Q̇_loss / T_fluidTotal Entropy Generation:
Ṡ_total = Ṡ_friction + Ṡ_leakage + Ṡ_heat + Ṡ_mechanicalExergy Efficiency:
η_exergy = 1 - T₀·Ṡ_total / ẆshaftThis gives a more complete picture of thermodynamic performance.
Heat Transfer Considerations
Heat Transfer Modes in Pumps:
- Conduction:
- Through pump casing walls
- Through shaft to bearings
- Through impeller material
- Convection:
- Forced convection with pumped fluid
- Natural convection to ambient air
- Internal recirculation loops
- Radiation:
- Usually negligible unless high temperatures
- Can be significant for hot oil pumps (>150°C)
Heat Loss Estimation:
From Casing Walls:
Q̇_loss = h·A·(T_fluid - T_ambient)Where:
- h = overall heat transfer coefficient (W/m²-K)
- A = surface area (m²)
- Typical h = 5-20 W/m²-K (natural convection, insulated)
From Energy Balance:
Q̇_loss = Ẇshaft - ṁ·(h₂ - h₁) - ṁ·(c₂² - c₁²)/2 - ṁ·g·(z₂ - z₁)Impact on Performance:
- Reduces outlet temperature
- Affects fluid properties (viscosity, density)
- Can cause thermal gradients and distortion
- Important for cryogenic and high-temperature pumps
Thermal Management:
Cooling Requirements:
- External cooling jackets
- Flush plans for mechanical seals
- Heat exchangers in recirculation loops
Insulation:
- Prevents heat loss (hot fluids)
- Prevents condensation (cold fluids)
- Improves safety (hot surfaces)
Multistage Pump Thermodynamics
Staging Rationale:
High head requirements divided among multiple impellers:
H_total = H_stage1 + H_stage2 + ... + H_stage_nThermodynamic Analysis:
Between Stages:
State 1 → Impeller 1 → State 2 → Diffuser 1 → State 3 →
Impeller 2 → State 4 → ... → Final dischargeTemperature Rise per Stage:
ΔT_stage = (1 - η_stage)·g·H_stage / cpTotal Temperature Rise:
ΔT_total = Σ ΔT_stage = (1 - η_overall)·g·H_total / cpInterstage Cooling:
For high-head or high-temperature applications:
Q̇_cooling = ṁ·cp·(T_beforecooling - T_aftercooling)Benefits:
- Reduces final discharge temperature
- Improves fluid properties (lower viscosity)
- Prevents vaporization
- Increases pump life
Pressure Compounding Effects:
As pressure increases through stages:
- Density may change (compressible fluids)
- Leakage flow increases (higher ΔP)
- Seal loads increase
- Structural requirements change
Energy Distribution:
Not all stages contribute equally:
- First stage: Highest NPSH requirement
- Middle stages: Maximum efficiency
- Last stage: Highest pressure loading
Common Cycles Relevant to Pumps
Rankine Cycle (Detailed)
Steam Power Plant Configuration:
Boiler → Turbine → Condenser → Feedwater Pump → Boiler
↓ ↓ ↓ ↓
High P Power Low P High P
High T Output Low T Moderate TState Point Analysis:
State 1: Turbine exhaust entering condenser
- P₁ = 0.05-0.1 bar (vacuum conditions)
- T₁ = saturation temperature at P₁
- x₁ = 0.85-0.95 (wet steam)
State 2: Condenser outlet / Pump inlet
- P₂ = P₁ (pressure drop minimal)
- T₂ = T_sat(P₂) - subcooling (typically 2-5°C)
- x₂ = 0 (saturated or subcooled liquid)
State 3: Pump outlet / Boiler inlet
- P₃ = 100-300 bar (high pressure)
- T₃ ≈ T₂ + ΔT_pump (small temperature rise)
- Compressed liquid
State 4: Boiler outlet / Turbine inlet
- P₄ = P₃ - ΔP_boiler
- T₄ = 500-600°C (superheated steam)
- Superheated vapor
Pump Work Calculation:
Isentropic work:
w_pump,s = h₃s - h₂ = v₂·(P₃ - P₂)For water at 40°C (v ≈ 0.001008 m³/kg):
w_pump,s = 0.001008·(250e5 - 0.08e5) ≈ 2.52 kJ/kgActual work:
w_pump = w_pump,s / η_pump = 2.52 / 0.85 ≈ 2.96 kJ/kgTemperature rise:
ΔT = (h₃ - h₂) / cp ≈ 0.44 / 4.18 ≈ 0.11°C (negligible)Cycle Efficiency:
η_Rankine = (w_turbine - w_pump) / q_inTypical values:
- Simple cycle: 30-40%
- Reheat cycle: 38-45%
- Regenerative cycle: 40-50%
Pump work is small (~1-2% of turbine work) but critical for operation.
Refrigeration Cycle
Vapor Compression Cycle with Liquid Pump:
Some industrial refrigeration systems use liquid pumps instead of or in addition to compressors.
State Points:
- Evaporator outlet: Low P, low T, saturated vapor
- Compressor outlet: High P, high T, superheated vapor
- Condenser outlet: High P, moderate T, saturated liquid
- Pump outlet: Very high P, moderate T, compressed liquid
- Expansion valve outlet: Low P, low T, two-phase mixture
Pump Application:
- Liquid overfeed systems: Circulate liquid refrigerant
- CO₂ transcritical systems: Liquid CO₂ pumping
- Cascade systems: Pumping between pressure levels
COP Calculation:
COP = Q_evaporator / (W_compressor + W_pump)Pump work usually small compared to compressor work.
Closed-Loop Heat Transfer Cycles
Applications:
- Solar thermal systems
- Geothermal heat pumps
- Industrial heat recovery
- District heating/cooling
Thermodynamic Analysis:
Heating Mode:
Q̇_delivered = ṁ·cp·(T_supply - T_return)
W_pump = ṁ·g·H / η_pump
COP_heating = Q̇_delivered / W_pumpCooling Mode:
Q̇_removed = ṁ·cp·(T_return - T_supply)
COP_cooling = Q̇_removed / W_pumpOptimization:
- Minimize flow rate (reduces pump power)
- Maximize ΔT (reduces flow for given load)
- Balance pipe friction vs. pump size
Summary
Thermodynamic analysis of pump systems requires systematic application of:
- Control volume definition: Clear boundaries and assumptions
- State point identification: Complete property evaluation
- Property evaluation: Accurate fluid properties from reliable sources
- First law: Energy balance accounting for all forms of energy
- Second law: Entropy generation and efficiency analysis
- Cycle analysis: Understanding pump role in larger systems
Key outputs:
- Power requirements
- Temperature rise
- Efficiency breakdown
- Loss mechanisms
- Optimization opportunities
References
See equations-reference.md for detailed equations and examples.md for worked examples.
In this repository29 other files it gives its agents.
- cavitation-risk-dbSkill
- coolprop-dbSkill
- hydraulic-components-dbSkill
- material-properties-dbSkill
- nasa-earthdataSkill
- nist-refpropSkill
- pump-performance-dbSkill
- turbulence-models-dbSkill
- engineering-context-initSkill
- error-handler-fluidsSkill
- fluid-property-calculatorSkill
- get-available-resourcesSkill
- pump-selection-helperSkill
- unit-converterSkill
- ansys-simulationSkill
- comsol-multiphysicsSkill
- openfoam-cfdSkill
- solidworks-cadSkill
- fluids-packageSkill
- matplotlib-visualizationSkill
- networkx-flow-networksSkill
- numpy-numericsSkill
- pint-unitsSkill
- pyvista-visualizationSkill
- scipy-optimizationSkill
- sympy-symbolicSkill
- thermo-packageSkill
- fluid-dynamics-workflowSkill
- structural-analysis-workflowSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

