Thermodynamic Models for Heat Pumps¶
A physics-based Python library for heat pump simulation.
First-principles dynamic models for air-source, ground-source, and water-source heat pumps — covering DHW, space heating, and space cooling.
tmhp solves the closed refrigerant cycle at every time step using
CoolProp as the equation-of-state
backend. The same model code applies across refrigerants and
operating envelopes, with no manufacturer-specific curve fits and no
per-unit recalibration.
Install with uv, run your first steady-state, then
drive a 24-hour dynamic simulation.
Why first-principles, how the cycle is assembled, and how to read the diagnostic flags every call returns.
ASHPB / GSHPB / WSHPB plus the space-conditioning ASHP / GSHP — each one a 1-stop page with source-side mechanics, composed subsystem variants, and API reference.
Focused walkthroughs — swap refrigerants, drive realistic schedules, compose PV / STC / ESS subsystems.
Every model, support module, and helper exposed by the
tmhp package, with full type signatures.
ASHPB benchmarked against 15 Samsung EHS catalogue points — parity plot, per-point table, reproducibility.
Plot a solved refrigerant cycle on a P–h chart using only CoolProp and Matplotlib.