Skip to content

Zone HVAC Controls and Thermostats

15 object types from idfpy.models.zone_controls · EnergyPlus 26.2

Object Summary
ThermostatSetpoint:DualSetpoint Used for a heating and cooling thermostat with dual setpoints.
ThermostatSetpoint:SingleCooling Used for a cooling only thermostat.
ThermostatSetpoint:SingleHeating Used for a heating only thermostat.
ThermostatSetpoint:SingleHeatingOrCooling Used for a heating and cooling thermostat with a single setpoint.
ThermostatSetpoint:ThermalComfort:Fanger:DualSetpoint Used for heating and cooling thermal comfort control with dual setpoints.
ThermostatSetpoint:ThermalComfort:Fanger:SingleCooling Used for cooling only thermal comfort control.
ThermostatSetpoint:ThermalComfort:Fanger:SingleHeating Used for heating only thermal comfort control.
ThermostatSetpoint:ThermalComfort:Fanger:SingleHeatingOrCooling Used for heating and cooling thermal comfort control with a single setpoint.
ZoneControl:ContaminantController Used to control a zone to a specified indoor level of CO2 or generic contaminants, or to specify minimum CO2 …
ZoneControl:Humidistat Specifies zone relative humidity setpoint schedules for humidifying and dehumidifying.
ZoneControl:Thermostat Define the Thermostat settings for a zone or list of zones.
ZoneControl:Thermostat:OperativeTemperature This object can be used with the ZoneList option on a thermostat or with one of the zones on that list (but …
ZoneControl:Thermostat:StagedDualSetpoint Define the Thermostat StagedDualSetpoint settings for a zone or list of zones.
ZoneControl:Thermostat:TemperatureAndHumidity This object modifies a ZoneControl:Thermostat object to effect temperature control based on zone air humidity …
ZoneControl:Thermostat:ThermalComfort If you use a ZoneList in the Zone or ZoneList name field then this definition applies to all the zones in the …

ThermostatSetpoint:DualSetpoint

from idfpy.models import ThermostatSetpointDualSetpoint

Used for a heating and cooling thermostat with dual setpoints. The setpoints can be scheduled and varied throughout the simulation for both heating and cooling.

Field Type Default Details
name
Name required
string
heating_setpoint_temperature_schedule_name
Heating Setpoint Temperature Schedule Name
reference Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
cooling_setpoint_temperature_schedule_name
Cooling Setpoint Temperature Schedule Name
reference Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
Referenced by 1 object types

ZoneControl:Thermostat

ThermostatSetpoint:SingleCooling

from idfpy.models import ThermostatSetpointSingleCooling

Used for a cooling only thermostat. The setpoint can be scheduled and varied throughout the simulation but only cooling is allowed.

Field Type Default Details
name
Name required
string
setpoint_temperature_schedule_name
Setpoint Temperature Schedule Name
reference Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
Referenced by 1 object types

ZoneControl:Thermostat

ThermostatSetpoint:SingleHeating

from idfpy.models import ThermostatSetpointSingleHeating

Used for a heating only thermostat. The setpoint can be scheduled and varied throughout the simulation but only heating is allowed with this control type.

Field Type Default Details
name
Name required
string
setpoint_temperature_schedule_name
Setpoint Temperature Schedule Name
reference Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
Referenced by 1 object types

ZoneControl:Thermostat

ThermostatSetpoint:SingleHeatingOrCooling

from idfpy.models import ThermostatSetpointSingleHeatingOrCooling

Used for a heating and cooling thermostat with a single setpoint. The setpoint can be scheduled and varied throughout the simulation for both heating and cooling.

Field Type Default Details
name
Name required
string
setpoint_temperature_schedule_name
Setpoint Temperature Schedule Name
reference Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
Referenced by 1 object types

ZoneControl:Thermostat

ThermostatSetpoint:ThermalComfort:Fanger:DualSetpoint

from idfpy.models import ThermostatSetpointThermalComfortFangerDualSetpoint

Used for heating and cooling thermal comfort control with dual setpoints. The PMV setpoints can be scheduled and varied throughout the simulation for both heating and cooling.

Field Type Default Details
name
Name required
string
fanger_thermal_comfort_heating_schedule_name
Fanger Thermal Comfort Heating Schedule Name required
reference Schedule values should be Predicted Mean Vote (PMV)
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
fanger_thermal_comfort_cooling_schedule_name
Fanger Thermal Comfort Cooling Schedule Name required
reference Schedule values should be Predicted Mean Vote (PMV)
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
Referenced by 1 object types

ZoneControl:Thermostat:ThermalComfort

ThermostatSetpoint:ThermalComfort:Fanger:SingleCooling

from idfpy.models import ThermostatSetpointThermalComfortFangerSingleCooling

Used for cooling only thermal comfort control. The PMV setpoint can be scheduled and varied throughout the simulation but only cooling is allowed with this control type.

Field Type Default Details
name
Name required
string
fanger_thermal_comfort_schedule_name
Fanger Thermal Comfort Schedule Name required
reference Schedule values should be Predicted Mean Vote (PMV)
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
Referenced by 1 object types

ZoneControl:Thermostat:ThermalComfort

ThermostatSetpoint:ThermalComfort:Fanger:SingleHeating

from idfpy.models import ThermostatSetpointThermalComfortFangerSingleHeating

Used for heating only thermal comfort control. The PMV setpoint can be scheduled and varied throughout the simulation but only heating is allowed with this control type.

Field Type Default Details
name
Name required
string
fanger_thermal_comfort_schedule_name
Fanger Thermal Comfort Schedule Name required
reference Schedule values should be Predicted Mean Vote (PMV)
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
Referenced by 1 object types

ZoneControl:Thermostat:ThermalComfort

ThermostatSetpoint:ThermalComfort:Fanger:SingleHeatingOrCooling

from idfpy.models import ThermostatSetpointThermalComfortFangerSingleHeatingOrCooling

Used for heating and cooling thermal comfort control with a single setpoint. The PMV setpoint can be scheduled and varied throughout the simulation for both heating and cooling.

Field Type Default Details
name
Name required
string
fanger_thermal_comfort_schedule_name
Fanger Thermal Comfort Schedule Name required
reference Schedule values should be Predicted Mean Vote (PMV)
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
Referenced by 1 object types

ZoneControl:Thermostat:ThermalComfort

ZoneControl:ContaminantController

from idfpy.models import ZoneControlContaminantController

Used to control a zone to a specified indoor level of CO2 or generic contaminants, or to specify minimum CO2 concentration schedule name for a zone.

Field Type Default Details
name
Name required
string
zone_name
Zone Name required
reference Names a Zone
carbon_dioxide_control_availability_schedule_name
Carbon Dioxide Control Availability Schedule Name
reference Availability schedule name for CO2 controller. Schedule value > 0 means the CO2 controller is enabled. If this field is blank, then CO2 controller is always enabled.
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
carbon_dioxide_setpoint_schedule_name
Carbon Dioxide Setpoint Schedule Name required
reference Schedule values should be carbon dioxide concentration in parts per million (ppm) This field is required whenever this object is specified. The setpoint is used when Carbon Dioxide Concentration = Yes in ZoneAirContaminantBalance. The setpoint or resulting outdoor air requirement is used by Controller:MechanicalVentilation with System Outdoor Air Method = IndoorAirQualityProcedure or IndoorAirQualityProcedureCombined, DesignSpecification:OutdoorAir with Outdoor Air Method = IndoorAirQualityProcedure, and AvailabilityManager:HybridVentilation with carbon dioxide control.
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
minimum_carbon_dioxide_concentration_schedule_name
Minimum Carbon Dioxide Concentration Schedule Name
reference Schedule values should be carbon dioxide concentration in parts per million (ppm) This field is used when the field System Outdoor Air Method = ProportionalControlBasedOnOccupancySchedule or ProportionalControlBasedOnDesignOccupancy, or ProportionalControlBasedOnDesignOARate in Controller:MechanicalVentilation
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
maximum_carbon_dioxide_concentration_schedule_name
Maximum Carbon Dioxide Concentration Schedule Name
reference Schedule values should be carbon dioxide concentration in parts per million (ppm) This field is used when the field System Outdoor Air Method = ProportionalControlBasedOnOccupancySchedule or ProportionalControlBasedOnDesignOccupancy or ProportionalControlBasedOnDesignOARate in Controller:MechanicalVentilation
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
generic_contaminant_control_availability_schedule_name
Generic Contaminant Control Availability Schedule Name
reference Availability schedule name for generic contaminant controller. Schedule value > 0 means the generic contaminant controller is enabled. If this field is blank, then generic contaminant controller is always enabled.
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
generic_contaminant_setpoint_schedule_name
Generic Contaminant Setpoint Schedule Name
reference Schedule values should be generic contaminant concentration in parts per million (ppm) This field is used when the field System Outdoor Air Method = IndoorAirQualityProcedureGenericContaminant in Controller:MechanicalVentilation This field is required when Generic Contaminant Concentration = Yes in ZoneAirContaminantBalance; there is no default setpoint. The resulting outdoor air requirement is used by Controller:MechanicalVentilation with System Outdoor Air Method = IndoorAirQualityProcedureGenericContaminant or IndoorAirQualityProcedureCombined.
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules

ZoneControl:Humidistat

from idfpy.models import ZoneControlHumidistat

Specifies zone relative humidity setpoint schedules for humidifying and dehumidifying.

Field Type Default Details
name
Name required
string
zone_name
Zone Name required
reference Names a Zone
humidifying_setpoint_schedule_name
Humidifying Setpoint Schedule Name required
reference Hourly schedule values should be in relative humidity (percent) or dew-point temperatures (deg. C).
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
dehumidifying_setpoint_schedule_name
Dehumidifying Setpoint Schedule Name
reference Hourly schedule values should be in relative humidity (percent) or dew-point temperatures (deg. C).
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
control_variable
Control Variable
choice RelativeHumidity When using RelativeHumidity, the schedule values should be in percentages.
One of Dewpoint, RelativeHumidity
Referenced by 1 object types

FaultModel:HumidistatOffset

ZoneControl:Thermostat

from idfpy.models import ZoneControlThermostat

Define the Thermostat settings for a zone or list of zones. If you use a ZoneList in the Zone or ZoneList name field then this definition applies to all the zones in the ZoneList.

Field Type Default Details
name
Name required
string
zone_or_zonelist_name
Zone or ZoneList Name required
reference Names a Zone, ZoneList
control_type_schedule_name
Control Type Schedule Name required
reference This schedule contains appropriate control types for thermostat. Control types are integers: 0 - Uncontrolled (floating, no thermostat), 1 = ThermostatSetpoint:SingleHeating, 2 = ThermostatSetpoint:SingleCooling, 3 = ThermostatSetpoint:SingleHeatingOrCooling, 4 = ThermostatSetpoint:DualSetpoint
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
control_1_object_type
Control 1 Object Type required
choice One of ThermostatSetpoint:DualSetpoint, ThermostatSetpoint:SingleCooling, ThermostatSetpoint:SingleHeating, ThermostatSetpoint:SingleHeatingOrCooling
control_1_name
Control 1 Name required
reference Control names are names of individual control objects (e.g. ThermostatSetpoint:SingleHeating) Schedule values in these objects list actual setpoint temperatures for the control types
Names a ThermostatSetpoint:DualSetpoint, ThermostatSetpoint:SingleCooling, ThermostatSetpoint:SingleHeating, ThermostatSetpoint:SingleHeatingOrCooling
control_2_object_type
Control 2 Object Type
choice One of ThermostatSetpoint:DualSetpoint, ThermostatSetpoint:SingleCooling, ThermostatSetpoint:SingleHeating, ThermostatSetpoint:SingleHeatingOrCooling
control_2_name
Control 2 Name
reference Control names are names of individual control objects (e.g. ThermostatSetpoint:SingleHeating) Schedule values in these objects list actual setpoint temperatures for the control types
Names a ThermostatSetpoint:DualSetpoint, ThermostatSetpoint:SingleCooling, ThermostatSetpoint:SingleHeating, ThermostatSetpoint:SingleHeatingOrCooling
control_3_object_type
Control 3 Object Type
choice One of ThermostatSetpoint:DualSetpoint, ThermostatSetpoint:SingleCooling, ThermostatSetpoint:SingleHeating, ThermostatSetpoint:SingleHeatingOrCooling
control_3_name
Control 3 Name
reference Control names are names of individual control objects (e.g. ThermostatSetpoint:SingleHeating) Schedule values in these objects list actual setpoint temperatures for the control types
Names a ThermostatSetpoint:DualSetpoint, ThermostatSetpoint:SingleCooling, ThermostatSetpoint:SingleHeating, ThermostatSetpoint:SingleHeatingOrCooling
control_4_object_type
Control 4 Object Type
choice One of ThermostatSetpoint:DualSetpoint, ThermostatSetpoint:SingleCooling, ThermostatSetpoint:SingleHeating, ThermostatSetpoint:SingleHeatingOrCooling
control_4_name
Control 4 Name
reference Control names are names of individual control objects (e.g. ThermostatSetpoint:SingleHeating) Schedule values in these objects list actual setpoint temperatures for the control types
Names a ThermostatSetpoint:DualSetpoint, ThermostatSetpoint:SingleCooling, ThermostatSetpoint:SingleHeating, ThermostatSetpoint:SingleHeatingOrCooling
temperature_difference_between_cutout_and_setpoint
Temperature Difference Between Cutout And Setpoint
number
deltaC
0.0 This optional choice field provides a temperature difference between cut-out temperature and setpoint. The difference is used to adjust to heating or cooling setpoint based on control types.
Range: ≥ 0
Referenced by 4 object types

DemandManager:Thermostats, FaultModel:ThermostatOffset, ZoneControl:Thermostat:OperativeTemperature, ZoneControl:Thermostat:TemperatureAndHumidity

ZoneControl:Thermostat:OperativeTemperature

from idfpy.models import ZoneControlThermostatOperativeTemperature

This object can be used with the ZoneList option on a thermostat or with one of the zones on that list (but you won't be able to use the object list to pick only one of those zones. Thermostat names are <Zone Name> <global Thermostat name> internally.

Field Type Default Details
thermostat_name
Thermostat Name required
reference Enter the name of a ZoneControl:Thermostat object. This object modifies a ZoneControl:Thermostat object to add a radiative fraction.
Names a ZoneControl:Thermostat, ZoneControl:Thermostat:StagedDualSetpoint
radiative_fraction_input_mode
Radiative Fraction Input Mode required
choice One of Constant, Scheduled
fixed_radiative_fraction
Fixed Radiative Fraction
number Range: ≥ 0, < 0.9
radiative_fraction_schedule_name
Radiative Fraction Schedule Name
reference Schedule values of 0.0 indicate no operative temperature control
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
adaptive_comfort_model_type
Adaptive Comfort Model Type
choice None the cooling setpoint temperature schedule of the referenced thermostat will be adjusted based on the selected adaptive comfort model type
One of AdaptiveASH5580PercentUpperLine, AdaptiveASH5590PercentUpperLine, AdaptiveASH55CentralLine, AdaptiveCEN15251CategoryIIIUpperLine, AdaptiveCEN15251CategoryIIUpperLine, AdaptiveCEN15251CategoryIUpperLine, AdaptiveCEN15251CentralLine, None

ZoneControl:Thermostat:StagedDualSetpoint

from idfpy.models import ZoneControlThermostatStagedDualSetpoint

Define the Thermostat StagedDualSetpoint settings for a zone or list of zones. If you use a ZoneList in the Zone or ZoneList name field then this definition applies to all the zones in the ZoneList.

Field Type Default Details
name
Name required
string
zone_or_zonelist_name
Zone or ZoneList Name required
reference Names a Zone, ZoneList
number_of_heating_stages
Number of Heating Stages required
integer Enter the number of the following sets of data for heating temperature offset
Range: ≥ 1, ≤ 4
heating_temperature_setpoint_schedule_name
Heating Temperature Setpoint Schedule Name
reference Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
heating_throttling_temperature_range
Heating Throttling Temperature Range
number
deltaC
1.1 Range: ≥ 0
stage_1_heating_temperature_offset
Stage 1 Heating Temperature Offset required
number
deltaC
The heating temperature offset is used to determine heating stage number for multi stage equipment. When the temperature difference of the heating setpoint and the controlled zone temperature at previous time step is less than Stage 1 value and greater than Stage 2 value, the stage number is 1.
Range: ≤ 0
stage_2_heating_temperature_offset
Stage 2 Heating Temperature Offset
number
deltaC
The heating temperature offset is used to determine heating stage number for multi stage equipment. When the temperature difference of the heating setpoint and the controlled zone temperature at previous time step is less than Stage 2 value and greater than Stage 3 value, the stage number is 2. The value of this field has to be less the value at the previous field.
Range: ≤ 0
stage_3_heating_temperature_offset
Stage 3 Heating Temperature Offset
number
deltaC
The heating temperature offset is used to determine heating stage number for multi stage equipment. When the temperature difference of the heating setpoint and the controlled zone temperature at previous time step is less than Stage 3 value and greater than Stage 4 value, the stage number is 3. The value of this field has to be less the value at the previous field.
Range: ≤ 0
stage_4_heating_temperature_offset
Stage 4 Heating Temperature Offset
number
deltaC
The heating temperature offset is used to determine heating stage number for multi stage equipment. When the temperature difference of the heating setpoint and the controlled zone temperature at previous time step is less than Stage 4 value, the stage number is 4. The value of this field has to be less the value at the previous field.
Range: ≤ 0
number_of_cooling_stages
Number of Cooling Stages required
integer Enter the number of the following sets of data for cooling temperature offset
Range: ≥ 1, ≤ 4
cooling_temperature_setpoint_base_schedule_name
Cooling Temperature Setpoint Base Schedule Name
reference Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
cooling_throttling_temperature_range
Cooling Throttling Temperature Range
number
deltaC
1.1 Range: ≥ 0
stage_1_cooling_temperature_offset
Stage 1 Cooling Temperature Offset required
number
deltaC
The cooling temperature offset is used to determine cooling stage number for multi stage equipment. When the temperature difference of the cooling setpoint and the controlled zone temperature at previous time step is greater than Stage 1 value and less than Stage 2 value, the stage number is 1.
Range: ≥ 0
stage_2_cooling_temperature_offset
Stage 2 Cooling Temperature Offset
number
deltaC
The cooling temperature offset is used to determine cooling stage number for multi stage equipment. When the temperature difference of the cooling setpoint and the controlled zone temperature at previous time step is greater than Stage 2 value and less than Stage 3 value, the stage number is 2. The value of this field has to be greater than the value at the previous field.
Range: ≥ 0
stage_3_cooling_temperature_offset
Stage 3 Cooling Temperature Offset
number
deltaC
The cooling temperature offset is used to determine cooling stage number for multi stage equipment. When the temperature difference of the cooling setpoint and the controlled zone temperature at previous time step is greater than Stage 3 value and less than Stage 4 value, the stage number is 3. The value of this field has to be greater than the value at the previous field.
Range: ≥ 0
stage_4_cooling_temperature_offset
Stage 4 Cooling Temperature Offset
number
deltaC
The cooling temperature offset is used to determine cooling stage number for multi stage equipment. When the temperature difference of the cooling setpoint and the controlled zone temperature at previous time step is greater than Stage 4 value, the stage number is 4. The value of this field has to be greater than the value at the previous field.
Range: ≥ 0
Referenced by 4 object types

DemandManager:Thermostats, FaultModel:ThermostatOffset, ZoneControl:Thermostat:OperativeTemperature, ZoneControl:Thermostat:TemperatureAndHumidity

ZoneControl:Thermostat:TemperatureAndHumidity

from idfpy.models import ZoneControlThermostatTemperatureAndHumidity

This object modifies a ZoneControl:Thermostat object to effect temperature control based on zone air humidity conditions.

Field Type Default Details
thermostat_name
Thermostat Name required
reference Enter the name of a ZoneControl:Thermostat object whose operation is to be modified to effect temperature control based on zone air humidity conditions. If the ZoneControl: Thermostat object references a ZoneList, simply enter the name of the ZoneControl:Thermostat object and this temperature and humidity thermostat control will be applied to all zones in the ZoneList. If the ZoneControl:Thermostat object references a ZoneList but it is desired that only a single zone within the ZoneList be controlled based on temperature and humidity control, then the name to be put here is <Zone Name> <Thermostat Name> where the Thermostat Name is the the name of the ZoneControl:Thermostat object.
Names a ZoneControl:Thermostat, ZoneControl:Thermostat:StagedDualSetpoint
dehumidifying_relative_humidity_setpoint_schedule_name
Dehumidifying Relative Humidity Setpoint Schedule Name required
reference Schedule values should be in Relative Humidity (percent)
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
dehumidification_control_type
Dehumidification Control Type
choice Overcool One of None, Overcool
overcool_range_input_method
Overcool Range Input Method
choice Constant One of Constant, Scheduled
overcool_constant_range
Overcool Constant Range
number
deltaC
1.7 Maximum Overcool temperature range for cooling setpoint reduction. Used with Dehumidification Control Type = Overcool. A value of 0.0 indicates no zone temperature overcooling will be provided to gain additional dehumidification.
Range: ≥ 0, ≤ 3
overcool_range_schedule_name
Overcool Range Schedule Name
reference Schedule values of 0.0 indicates no zone temperature overcooling will be provided to gain additional dehumidification. Schedule values should be >= 0 and <= 3 (deltaC).
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
overcool_control_ratio
Overcool Control Ratio
number
percent/K
3.6 The value of this input field is used to adjust the cooling setpoint temperature (established by the associated ZoneControl:Thermostat object) downward based on the difference between the zone air relative humidity level and the dehumidifying relative humidity setpoint.
Range: ≥ 0

ZoneControl:Thermostat:ThermalComfort

from idfpy.models import ZoneControlThermostatThermalComfort

If you use a ZoneList in the Zone or ZoneList name field then this definition applies to all the zones in the ZoneList.

Field Type Default Details
name
Name required
string
zone_or_zonelist_name
Zone or ZoneList Name required
reference Names a Zone, ZoneList
averaging_method
Averaging Method
choice PeopleAverage The method used to calculate thermal comfort dry-bulb temperature setpoint for multiple people objects in a zone
One of ObjectAverage, PeopleAverage, SpecificObject
specific_people_name
Specific People Name
reference Used only when Averaging Method = SpecificObject in the previous field.
Names a People, People:Instance
minimum_dry_bulb_temperature_setpoint
Minimum Dry-Bulb Temperature Setpoint
number
C
0.0 Range: ≥ 0, ≤ 50
maximum_dry_bulb_temperature_setpoint
Maximum Dry-Bulb Temperature Setpoint
number
C
50.0 Range: ≥ 0, ≤ 50
thermal_comfort_control_type_schedule_name
Thermal Comfort Control Type Schedule Name required
reference The Thermal Comfort Control Type Schedule contains values that are appropriate control types. Thermal Comfort Control types are integers: 0 - Uncontrolled (floating), 1 = ThermostatSetpoint:ThermalComfort:Fanger:SingleHeating 2 = ThermostatSetpoint:ThermalComfort:Fanger:SingleCooling 3 = ThermostatSetpoint:ThermalComfort:Fanger:SingleHeatingOrCooling 4 = ThermostatSetpoint:ThermalComfort:Fanger:DualSetpoint
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
thermal_comfort_control_1_object_type
Thermal Comfort Control 1 Object Type required
choice One of ThermostatSetpoint:ThermalComfort:Fanger:DualSetpoint, ThermostatSetpoint:ThermalComfort:Fanger:SingleCooling, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeating, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeatingOrCooling
thermal_comfort_control_1_name
Thermal Comfort Control 1 Name required
reference Control type names are names for individual control type objects. Schedule values in these objects list actual setpoint temperatures for the control types
Names a ThermostatSetpoint:ThermalComfort:Fanger:DualSetpoint, ThermostatSetpoint:ThermalComfort:Fanger:SingleCooling, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeating, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeatingOrCooling
thermal_comfort_control_2_object_type
Thermal Comfort Control 2 Object Type
choice One of ThermostatSetpoint:ThermalComfort:Fanger:DualSetpoint, ThermostatSetpoint:ThermalComfort:Fanger:SingleCooling, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeating, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeatingOrCooling
thermal_comfort_control_2_name
Thermal Comfort Control 2 Name
reference Control Type names are names for individual control type objects. Schedule values in these objects list actual setpoint temperatures for the control types
Names a ThermostatSetpoint:ThermalComfort:Fanger:DualSetpoint, ThermostatSetpoint:ThermalComfort:Fanger:SingleCooling, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeating, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeatingOrCooling
thermal_comfort_control_3_object_type
Thermal Comfort Control 3 Object Type
choice One of ThermostatSetpoint:ThermalComfort:Fanger:DualSetpoint, ThermostatSetpoint:ThermalComfort:Fanger:SingleCooling, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeating, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeatingOrCooling
thermal_comfort_control_3_name
Thermal Comfort Control 3 Name
reference Control type names are names for individual control type objects. Schedule values in these objects list actual setpoint temperatures for the control types
Names a ThermostatSetpoint:ThermalComfort:Fanger:DualSetpoint, ThermostatSetpoint:ThermalComfort:Fanger:SingleCooling, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeating, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeatingOrCooling
thermal_comfort_control_4_object_type
Thermal Comfort Control 4 Object Type
choice One of ThermostatSetpoint:ThermalComfort:Fanger:DualSetpoint, ThermostatSetpoint:ThermalComfort:Fanger:SingleCooling, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeating, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeatingOrCooling
thermal_comfort_control_4_name
Thermal Comfort Control 4 Name
reference Control type names are names for individual control type objects. Schedule values in these objects list actual setpoint temperatures for the control types
Names a ThermostatSetpoint:ThermalComfort:Fanger:DualSetpoint, ThermostatSetpoint:ThermalComfort:Fanger:SingleCooling, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeating, ThermostatSetpoint:ThermalComfort:Fanger:SingleHeatingOrCooling