Calculation basis
Anyone who designs with results needs to know how they come about. This page sets out the properties, equations, assumptions and limits the Toolmeyer tools calculate with – no black box.
- Principle and solution method
- Water and steam (IAPWS-IF97)
- Refrigerants (CoolProp)
- Flue gas, air, combustion
- Component equations
- Large heat pump and heat pump evaluation
- Heat exchanger evaluation
- Piping, PS/TS, PN, PED
- What is not covered
- How we check
- Software used
1. Principle and solution method
The tools calculate steady state: one settled operating point per load case. Mass balance, energy balance (enthalpy) and pressure balance apply to every component.
- Topology: the tool follows the pipes from component to component and forms strands (open, from a feed to an outlet) and loops (closed). Each strand has one mass flow; pressure and enthalpy are calculated component by component. Nodes (tee, header, feedwater tank, steam generator with circulation, preheater, condenser, store) couple strands via mass and energy balance.
- Specifications: mass flows are fixed by pumps, feeds, firings, steam generators with flow specification, heat exchangers with flow specification and outlets with flow specification. Pressures are fixed by pumps, feeds, vessels, pressure reducing/retaining valves, turbines and flash vessels; all other components subtract their pressure loss.
- Iteration: first the energy balance is settled without pipe friction (until no quantity changes by more than 10−6, at most 40 passes), then the hydraulics are added. The calculation has converged when no enthalpy (kJ/kg), no pressure (bar) and no mass flow (kg/s) changes by more than 10−7 in one pass; at most 500 passes. A residual oscillation below 10−5 (e.g. with coupled heat exchanger circuits) counts as technically converged. Couplings that tend to oscillate (minimum flows, return admixture) are damped.
- Balance check: after the calculation, the tool checks mass and energy of the whole plant and shows the remainder (“balanced” / “open”).
- Design (ƒx): instead of specifying an input, a target value can be set on any component (temperature, pressure, mass flow, power, pressure margin); the input is then adjusted iteratively until the target is reached.
- Load cases: a load factor scales the load-determining quantities; every input can be overridden per load case. The circuit applies to all load cases.
Units: water/steam in bar(a), flue gas and air in mbar(g), temperatures in °C, powers in kW, enthalpies in kJ/kg.
2. Water and steam (IAPWS-IF97)
Properties of water and steam to the industrial formulation IAPWS-IF97 of the International Association for the Properties of Water and Steam – the standard for power plant and process calculations. Own implementation in JavaScript that calculates directly in the browser.
| Region | Validity | Use |
|---|---|---|
| 1 (water), 2 (steam), 4 (saturation) | triple point to 165.3 bar(a), up to 800 °C | balance in the heat balance diagram: h(p,T), s(p,T), v, saturation pressure and temperature, state from (p,h) and (p,s) |
| additionally 3 (near the critical point) | 0–800 °C, up to 1000 bar | heat balance diagram above 165.3 bar(a), also supercritical (without saturation; the critical point serves as a substitute); steam tables and design (complete properties: h, s, u, v, ρ, cp, cv, speed of sound, steam quality) |
Wet steam is calculated as homogeneous (mixture with steam quality x). Region 5 (above 800 °C) and the transport properties (viscosity, thermal conductivity) are not included.
3. Refrigerants (CoolProp)
For the large heat pump, the tool calculates a real refrigeration cycle. Refrigerant properties come from CoolProp 6.6.0 (open source, MIT licence; Bell et al. 2014, Ind. Eng. Chem. Res. 53(6), 2498–2508), integrated as WebAssembly in the browser.
- Equations of state: backend HEOS – the Helmholtz reference equations of the respective substances, as also used in reference databases.
- State calculations used: saturation at temperature or pressure, state from (p,T), (p,h) and (p,s); read out are T, p, h, s, density, vapour quality and critical temperature and pressure.
- Refrigerants: R717 (ammonia), R290 (propane), R1234ze(E), R1233zd(E), R744 (CO₂, also transcritical), R134a, R718 (water).
- Deliberately excluded: mixtures such as R513A, because CoolProp does not reliably calculate mixture states (p-h, p-s) in the browser; transport properties.
4. Flue gas, air and combustion
- Combustion: complete, from the ultimate analysis of the fuel (C, H, O, N, S, water, ash) and the excess air ratio λ or the O₂ content in the dry flue gas; lower heating value Hi, reference temperature 25 °C.
- Flue gas: ideal gas mixture of N₂, O₂, CO₂, H₂O, SO₂ and Ar with temperature-dependent heat capacity per component. Above 1,530 °C the heat capacities are extrapolated (note in the tool); dissociation and condensation are not calculated, falling below the dew point is reported.
- Boiler efficiency: entered or from the combustion calculation ηB = 1 − qA − qS with flue gas loss qA (flue gas enthalpy relative to combustion air) and other losses qS. Fuel heat QF = Q / ηB.
- Gas turbine: macro model from shaft power P and shaft efficiency η: QF = P/η; the excess air ratio is determined so that exhaust temperature or exhaust mass flow match.
- Compressor for air/flue gas: isentropic compression of the ideal gas via ∫cp/T dT = R·ln(p₂/p₁), then isentropic efficiency.
- Humid air (cooling tower): air balance with saturated outlet air; the cooling limit is the wet-bulb temperature at air temperature and relative humidity.
5. Component equations (selection)
Symbols: ṁ mass flow, h specific enthalpy, p pressure, v specific volume, η efficiency, index s = isentropic.
| Component | Equation | Assumptions |
|---|---|---|
| Pipe | Δp = λ · L/d · ρw²/2 Q̇L = k′ · L · (T − Ta) | Darcy-Weisbach. Friction factor λ laminar 64/Re, turbulent by Colebrook in the explicit form of Swamee and Jain with pipe roughness k (project, default 0.05 mm); viscosity of water and steam to IAPWS 2008, of air and flue gas by Sutherland. Fittings per strand as Σζ and as a percentage surcharge on pipe friction (project); height difference per strand with Δp = ρ·g·Δz. L = strand length (default 10 m per strand). Heat loss with fixed k′ in W/(m·K) or – with insulation thickness s – from k′ = π / (ln(D/do)/(2λI) + 1/(α·D)), D = do + 2s, α = 10 W/(m²·K). |
| Pump | h₂ = h₁ + v·Δp / η Pel = ṁ·(h₂ − h₁) / ηM | incompressible with the specific volume at the inlet; cavitation and boiling warning on the suction side. NPSH available = (pin − ps(T)) / (ρ·g), compared with NPSH required + 0.5 m. |
| Fan, compressor | h₂ = h₁ + v·Δp / η or isentropic with ∫cp/T dT = R·ln(p₂/p₁) | fan incompressible (note above 100 mbar); compressor as an ideal gas mixture with temperature-dependent cp. |
| Turbine | h₂ = h₁ − ηs·(h₁ − h2s) | isentropic efficiency per section (guide value industrial turbine 0.80, typical 0.70–0.86; high-performance turbine 0.90, typical 0.86–0.92); part load optionally by the steam cone law (Stodola) with design load case, efficiency at part load. Optionally Baumann wetness correction, η = ηdry·(1 − ȳ) with the mean wetness ȳ of the section, and leaving loss Δh = c²/2 with c = V̇/A behind the last stage (limited to 450 m/s). Warning from 12 % exhaust wetness. Mechanical efficiency acts on the power at the coupling. |
| Generator | Pel = Pcoupling · ηgearbox · ηG | gearbox optional (default 0.98). With rated power: 40 % of rated losses independent of load, 60 % with the square of the load. |
| Gas turbine | Q̇F = P / η | macro model. Optionally conversion from 15 °C (ISO) to the intake air (power −0.7 %/K, efficiency −0.2 %/K) and part load η = ηN·(1 − 0.7·(1 − load)²). Guide values. |
| Condenser with fixed k·A | Ts = TCW,in + ΔTCW / (1 − e−NTU) | k·A from the first load case, k·A ~ ṁCW0.6; the saturation pressure at Ts becomes the exhaust pressure of the turbine upstream. |
| Control valve | Kv = V̇·√(ρ/1000/Δp) | EN 60534-2-1 simplified (without pipe geometry); steam and gas with expansion factor Y and xT = 0.72, choked flow is indicated. |
| Stack, flue gas | Δp = g·H·(ρair − ρFG) | stack draught from stack height and density at the stack inlet. Sulphuric acid dew point by Verhoff and Banchero with 2 % SO₃ share of SO₂. |
| Heat exchanger | Q̇ = ε · Q̇max | Q̇max = maximum possible heat flow in counterflow; with phase change via a pinch search along the temperature profile. Log mean temperature difference and UA are also output as characteristic values; with phase change section by section from the temperature profile (40 sections). With “hold k·A”, the k·A of the first load case applies in the other load cases, adjusted with k ~ ṁ0.7 per side. |
| Steam generator / boiler | Q̇ = ṁShS + ṁBhB − ṁ·hFW | with blowdown ṁB; circulation with pump power; fuel, electric, flue gas or waste heat as heating. Radiation loss optionally constant in absolute terms (share rises at part load). Combustion air with water content from the project settings. |
| Hot water boiler | Pfuel/el = Q̇ / ηB | ηB relative to the lower heating value (default natural gas 0.95, heating oil 0.92, electric 0.99); consumption with Hi natural gas 10.0 kWh/m³ (standard conditions), heating oil 11.9 kWh/kg; CO₂ 0.201 or 0.266 kg/kWh. |
| Orifice plate | ISO 5167-2 | C = 0.61, expansion factor for steam/gas, permanent pressure loss; bore diameter from the design load case (estimate). |
| Heating heat pump | COP = g · TC / (TC − TE) Q̇max = n · Q̇N · (1 + kT·(ta − 2 °C)) | quality grade g calibrated to the data sheet COP at the rating point; defrosting, operating limit, backup heater. Output limit from rated heat output Q̇N per unit and number n; for air the output changes by kT per K of outdoor air relative to A2 (factor 0.3 … 1.5). Above the limit the backup heater covers the rest, otherwise the flow temperature drops. Units switch on one after another; below the smallest modulation the unit cycles (COP without part-load influence). Auxiliary power Paux = a · Pcompressor counts towards auxiliary consumption. Refrigerant for information only: GWP under F-gas Regulation (EU) 2024/573 Annex I (IPCC Fourth Assessment Report), mixtures weighted by mass fraction. |
| Auxiliary consumption, overall plant COP | COPtotal = (Σ Q̇HP + Σ Q̇selected) / Pel,total COPHP = Σ Q̇HP / Σ Pel,HP SPF = Σ Q̇·h / Σ P·h | Pel,total = pumps (including circulation pumps) + heat pumps (compressor, auxiliary power, backup heater) + other (fans, cooling towers, air-cooled condensers, compressors, electric boilers), without consumers marked “exclude from total electrical consumption”. Useful heat = heat output of all heat pumps including backup heater plus heat of the components marked “include in overall COP” (heat exchanger, heating condenser, heat source, boiler, CHP/gas turbine waste heat, solar collector). Annual values with the hours per load case; load cases without hours do not count. |
| Solar collector | η = η₀ − a₁·ΔT/G − a₂·ΔT²/G | ΔT = mean collector temperature − ambient, G = irradiance. |
| Goal seek | g(x) = 0, c(x) ≥ 0, max f(x) | variables x normalised to [0, 1]; Jacobian by perturbing by 0.1 % and recalculating. Constraints with Levenberg-Marquardt, objective via the gradient projected onto the active constraints; a bound with a negative Lagrange multiplier is released. Tolerances: 0.01 K, 0.5 mbar, 1 kg/h, 0.1 kW. |
| Value table | Q̇ = ṁA·hA − ṁB·hB | heat output between two measuring points, h to IAPWS-IF97 (reference: water at 0.01 °C). With equal mass flow equal to ṁ·(hA − hB) and independent of the reference point. |
| Static head | Δp = ρ · g · h | with the actual density at the location. |
| Overall balance | η = benefit / effort, ηC = 1 − Ta/Th | benefit: net electrical output, heat sinks, net enthalpy delivered; effort: firing heat, electric boilers, heat sources, waste heat. Carnot as the theoretical upper limit. |
The complete list of components with all inputs is in the help.
6. Large heat pump and heat pump evaluation
- Cycle: single-stage (subcooler, internal heat exchanger), two-stage with economiser (open intermediate-pressure vessel), compressors in parallel, two heat pumps in series, cascade. Compression via the isentropic efficiency per stage (default: centrifugal 0.80, screw 0.74, reciprocating 0.70), optionally a separate value for the high-pressure stage. Pressure losses of suction and discharge line as a fraction of the pressure (isenthalpic throttling before and after the compressor). Cycling below minimum load with start-up losses to EN 14825 (Cc = 0.9). Besides the Carnot quality grade, the quality grade against the Lorenz cycle is output (thermodynamic mean temperatures of sink and source).
- Part load: the isentropic efficiency at rated load is multiplied by a factor that depends on the load ratio per compressor (linear between the support points, 1.00 at rated load). Below the minimum load the machine cycles. Guide values, not manufacturer data; can be changed in the component, the usual range is shown next to the field:
Basis: measurements on screw compressors (with slide valve at 60 % output around 80 % of full-load drive power, with speed control around 60 %), centrifugal compressors with speed and guide vanes down to the surge line, reciprocating compressors with cylinder unloading (unloaded cylinders run along with friction). An isentropic efficiency lower by 0.01 means around 1.3 % more compressor work and just over 1 % lower COP.
Type / control ηs rated load Minimum load Factor at minimum load at 50 % at 75 % Centrifugal, speed + inlet guide vanes 0.80 (0.75–0.85) 40 % 0.84 (0.75–0.88) 0.88 (0.82–0.92) 0.97 (0.95–0.99) Screw, speed 0.74 (0.65–0.80) 25 % 0.86 (0.75–0.90) 0.93 (0.88–0.96) 0.98 (0.96–1.00) Screw, slide valve 0.74 (0.65–0.80) 20 % 0.55 (0.45–0.65) 0.72 (0.65–0.80) 0.88 (0.85–0.92) Reciprocating, speed 0.70 (0.65–0.75) 20 % 0.90 (0.85–0.95) 0.96 (0.92–0.98) 0.99 (0.98–1.00) Reciprocating, cylinder unloading 0.70 (0.65–0.75) 25 % 0.82 (0.75–0.88) 0.90 (0.85–0.93) 0.96 (0.93–0.98) - Best efficiency point: if the design point of the compressor is at a part load b (e.g. 70 % for the load with the most hours), the part-load curve relative to this point applies below it: f(L) = fcurve(L / b). Above it, efficiency falls quadratically up to rated load: f(L) = 1 − (1 − frated) · ((L − b) / (1 − b))², with frated as guide value centrifugal 0.94 (0.90–0.97, choke limit), screw 0.97 (0.95–0.99), reciprocating 0.98 (0.97–1.00). The minimum load stays relative to the rated output.
- Output limit (bivalent operation): with an output limit, the heat pump delivers at most this heat output; the sink then leaves colder, hout = hin + Q̇max / ṁ, and a peak boiler (component “hot water boiler”) placed in series downstream of the heat pump heats the rest. The output limit is also the rated heat output for load ratio and full-load hours. Without a limit and without own input, the largest load case counts as rated heat output.
- Limits: discharge temperature (R717 140 °C, R718 250 °C, otherwise 130 °C), pressure ratio per type, suction volume, minimum load, rated output – with a note and remedy.
Key figures of the heat pump evaluation
I = specific investment (€/kW), f = subsidy rate, w = maintenance (% of investment per year), FLH = full-load hours. The intersection of both curves gives the minimum full-load hours above which the heat pump is cheaper than the gas boiler. The load case assistant distributes the annual hours over outdoor temperature classes; the suggested distribution is a typical approximation for Germany and should be replaced by site-specific data. For each class: load factor = base load + (1 − base load) · (heating limit − ta) / (heating limit − design temperature); flow temperature linear from design to the break point; source temperature optionally constant, equal to the outdoor temperature (air) or linear between winter and summer value over the outdoor temperature (annual cycle of river, lake, wastewater).
Heat exchanger evaluation
With phase change or gas, ΔTm, k·A and NTU are approximations. The k(Re) curve uses assumed geometry and design velocity (plate: hydraulic diameter 4 mm, 0.5 m/s; tube 20 or 25 mm, 1.0 m/s) and properties of water (viscosity by Vogel, thermal conductivity as a fit) and is referred to the selected k value at the design point. Notes: plate heat exchangers above NTU > 10 check series connection, above 25 bar or 180 °C or with gas use shell and tube; double pipe above 20 m², shell and tube below 2 m², temperature cross in shell and tube; pressure loss per water side outside 0.1–1.0 bar.
7. Piping, PS/TS, PN and Pressure Equipment Directive
- PS, PSmin, TS: derived per line using an openly available rule table based on EN 13480-3 and EN 12952-3 (e.g. highest operating pressure plus margin, set pressure of safety valves, steam outlet + 15 K). Every derivation is shown with its source in the line list.
- Nominal pressure PN: rating to EN 1092-1 (material group, temperature derating).
- Wall thickness: to EN 13480-3 with strength values from EN 10216-2/-5 (including creep values), with allowances.
- Standard tables: the numerical values of these standards are protected by copyright. They are kept only on our server; the tools output the result of the individual query and name the standard and table it comes from.
- Pressure Equipment Directive 2014/68/EU: classification under Articles 4 and 13 and Annex II (tables 1–9), modules under Annex III – in the PED calculator and in the piping class assignment.
- Quantities and prices in the line list: total mass = quantity × mass per unit; total price supply, installation or insulation = quantity × unit price; unit price total = sum of the three unit prices; total price total = quantity × unit price total (rounded to two decimal places, as a formula in Excel).
8. What is not covered
- Dynamics (start-up, control behaviour, storage effect of pipes and equipment) – except the charge/discharge balance of thermal stores per load case.
- Windage losses of turbine stages at very small volume flow as a separate model – they are included as a lump sum in the part-load efficiency curve.
- Air pressure: from the installation altitude (project) by the standard atmosphere; it applies to gauge pressures, humid air, cooling tower and gas density.
- Heat transfer coefficients and areas: heat exchangers are calculated via ε or approach temperatures, not via geometry.
- Dissociation and condensation in flue gas, transport properties of water and refrigerants, refrigerant mixtures.
- Manufacturer-specific characteristic curves – efficiencies and part-load curves are guide values that you can replace with manufacturer data.
9. How we check
- Automated tests run before every release: properties against the check values of the IAPWS release, cycles of the large heat pump, balance of example circuits, rules for PS/TS and PN, Pressure Equipment Directive.
- Balance check with every calculation: mass and energy of the whole plant must balance, otherwise a message appears.
- Plausibility messages per component: velocities, cavitation, pinch violation, heat pump limits, dew point, validity ranges of the properties.
- Feedback from practice is collected on the feedback page; bugs found are answered there publicly.
10. Software used
| Task | Software | Licence |
|---|---|---|
| Water and steam | IAPWS-IF97, own implementation | Toolmeyer |
| Refrigerants | CoolProp 6.6.0 (WebAssembly) | MIT |
| PDF export | jsPDF 4.2.1, svg2pdf.js 2.8.1, jspdf-autotable 5.0.8 | MIT |
| Excel export | own implementation | Toolmeyer |
| Fonts | Barlow, Barlow Condensed, IBM Plex Mono | SIL Open Font License |
Calculations run in the browser on your device; your diagrams do not leave it (exception: standard queries with individual values and the AI connector, see privacy).
As of: November 2026