VAV Terminal Unoccupied Setback EnergyPlus

Measure Details

NameVav_terminal_unoccupied_setback_energyplus
Display NameVav Terminal Unoccupied Setback Energyplus
uuide7f3a2b1-c948-4d6e-b05a-f2c1d3e4a567
TypeMeasure
Language Ruby
Tags HVAC.HVAC Controls
DescriptionFor a selected thermal zone, applies unoccupied setbacks: (1) derives the occupancy schedule via Space → Space Type → People, creates a modified airflow turndown schedule, and assigns it to the zone's VAV terminal; (2) finds the zone thermostat DualSetpoint, copies the heating and cooling setpoint temperature schedules with setback temperatures substituted during unoccupied periods; (3) finds the zone ZoneControl:Humidistat, copies the humidifying and dehumidifying setpoint schedules with setback humidity values substituted during unoccupied periods. Setting a setback value to 0 skips that setback entirely. The measure can be used to model ASHRAE 170 healthcare setbacks.
Modeler's DescriptionEnergyPlus Measure: Occupancy is resolved from Space (Zone Name) → SpaceType → People → Number of People Schedule Name. The turndown schedule (Schedule:Year or Schedule:Compact) is copied with occupied values → 1.0 and unoccupied values → turndown_fraction. Temperature and humidity setback copies are built by merging the occupancy day-interval breakpoints into each setpoint Schedule:Day:Interval; unoccupied periods (occ ≤ 0.1) receive the user-specified setback value. Different day types in the week schedule receive distinct copies so each day type's occupancy pattern is correctly reflected. New schedules are named '_Minimum Air Flow Turndown Schedule', '__Setback'. Setting any setback argument to 0 skips creation of that schedule. Humidity setback requires ZoneControl:Humidistat. Warning: The measure will overwrite design day schedules. If equipment is autosized, this may resize equipment capacities. If this measure is being run on existing equipment it is recommended to hardsize the equipment first. Implementing setbacks on existing equipment not originally sized for setback may encounter shortages in capacity.
Measure FunctionMeasure
Requires EnergyPlus Resultsfalse
Uses SketchUp APIfalse
Measure TypeEnergyPlusMeasure
OpenStudio Version3.10.0
Minimum Compatible OpenStudio Version3.0.0
GitHub Repo LinkView on GitHub

Versions

Version ID GitHub Release Tag OpenStudio Version Min Compatible Version Max Compatible Version Download Link
c14cc9eb-a0c1-4cf1-b45c-581323b7cc0a v0.0.21 3.10.0 3.0.0 Download v0.0.21