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

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 floorpharma-cleanroom: the make-up air units
What it tracks
| Member | Description |
|---|---|
running | Unit operating state. |
occupied | Occupancy schedule. Drives the setpoint and minimum fresh air. |
internal_heat_gain | Zone heat load driving cooling demand. |
outdoor_air_temp | Outdoor air temperature, an input to the mixed-air blend. |
zone_temperature | Conditioned-space temperature, the control target. |
return_air_temp | Air returning from the zone. |
mixed_air_temp | Blend of return and outdoor air. |
supply_air_temp | Conditioned air delivered to the zone. |
supply_fan_speed | Fan modulation. |
supply_airflow_cfm | Delivered air volume. |
power_draw / energy_total | Compressor 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
| Parameter | Default | Unit |
|---|---|---|
cooling_capacity_kw | 35 | kW |
rated_airflow_cfm | 5000 | cfm |
zone_setpoint_cool_c | 24 | °C |
outdoor_air_fraction | 0.2 | pu |
return_air_fraction | 0.8 | pu |
stage2_setpoint_cool_c | 28.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-rtumiravo models inspect hvac-rtuWas this page useful?
Last updated on
Miravo