Concepts

Background reading for TMHP. These pages cover why the library is built the way it is — what physics-based cycle solving buys you, how the model pieces fit together across system families, and how to interpret the diagnostic fields each call returns.

Why physics-based?

Trade-offs versus empirical curve-fit models — what you give up, what you gain, and where the compute goes.

Why physics-based?
Cycle architecture

How source side, refrigerant cycle, and sink side connect, and how the same core cycle is reused across released cycle-resolved families.

Thermodynamic cycle architecture
failure_reason semantics

The four diagnostic values returned by analyze_steady and how to branch on them.

failure_reason semantics
Refrigerants and CoolProp

Subcritical vs supercritical operation, why CoolProp is the backing dependency, and how to swap refrigerants safely.

Refrigerants and CoolProp