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 economizer blending, compressor staging, and supply-air conditioning. Models the per-floor or per-zone HVAC unit common in commercial buildings.

Used in

commercial-building — one unit per floor

What it tracks

Member	Why it matters
`running`	Unit operating state.
`occupied`	Occupancy schedule — drives setpoint and minimum fresh air.
`internal_heat_gain`	Zone heat load driving cooling demand.
`outdoor_air_temp`	Ambient input to economizer logic.
`zone_temperature`	Conditioned-space temperature, the control objective.
`return_air_temp`	Air returning from the zone.
`mixed_air_temp`	Blend of return + 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`	Energy consumption — compressor + fan.

Fault modes

refrigerant_leak — cooling capacity decay, compressor duty climb, zone temperature drift.
dirty_filter — airflow drop, fan effort rise, supply-air temperature issues.
compressor_failure — loss of cooling, zone setpoint violation.

Key parameters

Parameter	Default	Unit
`cooling_capacity_kw`	30	kW
`rated_airflow_cfm`	2000	CFM
`zone_setpoint_cool_c`	23	°C
`outdoor_air_fraction`	0.15	—
`return_air_fraction`	0.85	—

Use cases

Occupancy-driven HVAC demand modelling.
Building energy analytics across multiple floors with mixed asset ages.
Refrigerant leak and filter-loading scenarios for fault detection.
Economizer behaviour under varying outdoor conditions.

Fork and customize

miravo fork model hvac-rtu

miravo models inspect hvac-rtu

Was this page useful?