MiravoMiravo

Hot Water boiler

Model an industrial hot water boiler with firing state, thermal lag, pressure response, runtime health, and fault behavior.

Hot water boiler model illustration

What it is

An industrial hot-water boiler with a modulating firing rate, thermal lag between firing and supply temperature, system pressure and combustion indicators. Pair it with a circulation pump and a heating loop to model a heating plant.

Used in

  • commercial-building: the central heating plant, with a loop circulation pump
  • district-heating: three gas boilers in the heat plant
  • pharma-cleanroom: a stand-in for a clean steam generator

What it tracks

MemberDescription
runningBoiler operating state.
firing_rateModulating output as a percentage of rated capacity.
supply_temperatureDelivered water temperature. It regulates to supply_temp_setpoint_c while firing and cools toward ambient when stopped.
return_temperatureLoop return water temperature, tied to the circulation pump.
system_pressureSystem pressure, which changes with temperature.
flue_gas_temperatureFlue gas temperature, an indicator of combustion efficiency.
fuel_flowLive burn rate.
fuel_consumed_totalCumulative fuel used.
co_emissionCO in the flue gas, in ppm.
circulation_pump_runningDerived from circulation_pump_tag > 0.5. It does not interlock firing.
runtime_hoursLifetime counter.

Startup

A running plant boots at its setpoint: supply_temperature starts at supply_temp_setpoint_c and return_temperature 4 K below it, for any setpoint. After Stop the water cools toward 22 °C, and Start then ramps back up from ambient (tau 90 s) like a cold boiler.

Fault modes

  • scale_buildup: needs the degraded stage and flue gas above 240 °C. Supply temperature falls ×0.93 and fuel flow rises ×1.08 for 900 s.
  • flame_instability: needs firing rate above 5 % and CO above 30 ppm. Flue gas temperature spikes ×1.2 and CO rises 15 ppm for 200 s.
  • circulation_pump_failure: needs the degraded stage and pressure above 3.8 bar. The pump tag drops to 0 and pressure falls 0.35 bar for 180 s. It does not stop firing or run the supply temperature away.

Key parameters

ParameterDefaultUnit
rated_output_kw500kW
rated_pressure_bar3bar
supply_temp_setpoint_c80°C
return_temp_design_c60°C
min_firing_pct0%
efficiency0.92pu

supply_temperature holds supply_temp_setpoint_c (within about 1 K, 90 s thermal lag) whenever the boiler is firing, whatever the firing rate. Firing rate follows the daily demand schedule and sets fuel burn, not temperature. When firing stops, supply cools toward ambient (about 22 °C).

min_firing_pct is a floor on the scheduled firing while the boiler is running. At 0 the schedule drops to zero from 22:00 (the commercial-building night setback), so supply falls overnight. Set it to a base load such as 40 for a plant that holds its supply temperature around the clock, like the district-heating plant.

Use cases

  • A central heating plant with thermal inertia.
  • Cascade fault scenarios with a circulation pump.
  • Combustion efficiency trending and scale-buildup detection.
  • Building heating-system analytics.

Customize

miravo models add hot-water-boiler --from hot-water-boiler
miravo models inspect hot-water-boiler

Was this page useful?

Last updated on