MiravoMiravo

HVAC Rooftop unit

Cooling-focused commercial rooftop unit with occupancy and compressor state, mixed-air blending, and fault health.

HVAC rooftop unit model illustration

What it is

A cooling-focused commercial packaged rooftop unit (RTU) with occupancy-driven operation, mixed-air blending, compressor staging and supply-air conditioning. It models the per-floor or per-zone unit common in commercial buildings.

Used in

  • commercial-building: one unit per floor
  • pharma-cleanroom: the make-up air units

What it tracks

MemberDescription
runningUnit operating state.
occupiedOccupancy schedule. Drives the setpoint and minimum fresh air.
internal_heat_gainZone heat load driving cooling demand.
outdoor_air_tempOutdoor air temperature, an input to the mixed-air blend.
zone_temperatureConditioned-space temperature, the control target.
return_air_tempAir returning from the zone.
mixed_air_tempBlend of return and outdoor air.
supply_air_tempConditioned air delivered to the zone.
supply_fan_speedFan modulation.
supply_airflow_cfmDelivered air volume.
power_draw / energy_totalCompressor and fan power and energy.

Fault modes

  • refrigerant_leak: needs the degraded stage, fan speed above 5 % and supply air above 18 °C. Supply-air temperature rises ×1.08 and power rises 2.5 kW for 500 s. The stage-1 tag is unchanged.
  • dirty_filter: needs the early_wear stage and fan speed above 5 %. Fan speed rises 10 percentage points and power rises 1.2 kW for 400 s.
  • compressor_failure: needs the degraded stage, the stage-1 tag above 0.5 and power above 15 kW. Both compressor-stage tags drop to 0 for 300 s, which reduces cooling through the thermal model.

Key parameters

ParameterDefaultUnit
cooling_capacity_kw35kW
rated_airflow_cfm5000cfm
zone_setpoint_cool_c24°C
outdoor_air_fraction0.2pu
return_air_fraction0.8pu
stage2_setpoint_cool_c28.5°C

zone_setpoint_cool_c accepts 18 to 30 °C (stage 2 setpoint 18 to 35 °C), so a cleanroom can run a low setpoint. Both stages release 1 K below the stage 1 setpoint. A low setpoint only holds if the unit has the capacity: with the default 35 kW coil, summer outdoor air keeps the zone above about 23 °C.

Use cases

  • Occupancy-driven HVAC demand.
  • Building energy analytics across floors with mixed asset ages.
  • Refrigerant leak and dirty filter scenarios for fault detection.
  • Mixed-air behavior under changing outdoor conditions.

Customize

miravo models add hvac-rtu --from hvac-rtu
miravo models inspect hvac-rtu

Was this page useful?

Last updated on