Skip to content

Setpoint Managers

31 object types from idfpy.models.setpoint_managers · EnergyPlus 26.2

Object Summary
SetpointManager:Coldest This SetpointManager is used in dual duct systems to reset the setpoint temperature of the air in the heating …
SetpointManager:CondenserEnteringReset This setpoint manager uses one curve to determine the optimum condenser entering water temperature for a …
SetpointManager:CondenserEnteringReset:Ideal This setpoint manager determine the ideal optimum condenser entering water temperature setpoint for a given …
SetpointManager:FollowGroundTemperature This setpoint manager is used to place a temperature setpoint on a system node that is derived from a current …
SetpointManager:FollowOutdoorAirTemperature This setpoint manager is used to place a temperature setpoint on a system node that is derived from the …
SetpointManager:FollowSystemNodeTemperature This setpoint manager is used to place a temperature setpoint on a system node that is derived from the …
SetpointManager:MixedAir The Mixed Air Setpoint Manager is meant to be used in conjunction with a Controller:OutdoorAir object.
SetpointManager:MultiZone:Cooling:Average This setpoint manager sets the average supply air temperature based on the cooling load requirements of all …
SetpointManager:MultiZone:Heating:Average This setpoint manager sets the average supply air temperature based on the heating load requirements of all …
SetpointManager:MultiZone:Humidity:Maximum This setpoint manager sets the maximum supply air humidity ratio based on dehumidification requirements of a …
SetpointManager:MultiZone:Humidity:Minimum This setpoint manager sets the minimum supply air humidity ratio based on humidification requirements of a …
SetpointManager:MultiZone:MaximumHumidity:Average This setpoint manager sets the average supply air maximum humidity ratio based on moisture load requirements …
SetpointManager:MultiZone:MinimumHumidity:Average This setpoint manager sets the average supply air minimum humidity ratio based on moisture load requirements …
SetpointManager:OutdoorAirPretreat This setpoint manager determines the required conditions at the outdoor air stream node which will produce …
SetpointManager:OutdoorAirReset This Setpoint Manager is used to place a setpoint temperature on system node according to the outdoor air …
SetpointManager:ReturnAirBypassFlow This setpoint manager determines the required mass flow rate through a return air bypass duct to meet the …
SetpointManager:ReturnTemperature:ChilledWater This setpoint manager is used to place a temperature setpoint on a plant supply outlet node based on a target …
SetpointManager:ReturnTemperature:HotWater This setpoint manager is used to place a temperature setpoint on a plant supply outlet node based on a target …
SetpointManager:Scheduled The simplest Setpoint Manager simply uses a schedule to determine one or more setpoints.
SetpointManager:Scheduled:DualSetpoint This setpoint manager places a high and low schedule value on one or more nodes.
SetpointManager:SingleZone:Cooling This setpoint manager detects the control zone load to meet the current cooling setpoint, zone inlet node …
SetpointManager:SingleZone:Heating This setpoint manager detects the control zone load to meet the current heating setpoint, zone inlet node …
SetpointManager:SingleZone:Humidity:Maximum The Single Zone Maximum Humidity Setpoint Manager allows the control of a single zone maximum humidity level.
SetpointManager:SingleZone:Humidity:Minimum The Single Zone Minimum Humidity Setpoint Manager allows the control of a single zone minimum humidity level.
SetpointManager:SingleZone:OneStageCooling This object can be used with CoilSystem:Cooling:DX to model on/off cycling control of single stage air …
SetpointManager:SingleZone:OneStageHeating This object can be used with CoilSystem:Heating:DX, Coil:Heating:Fuel, Coil:Heating:Electric to model on/off …
SetpointManager:SingleZone:Reheat This setpoint manager detects the control zone load, zone inlet node flow rate, and zone node temperature and …
SetpointManager:SystemNodeReset:Humidity This Setpoint Manager is used to place a humidity ratio setpoint on a system node according to the reference …
SetpointManager:SystemNodeReset:Temperature This Setpoint Manager is used to place a temperature setpoint on a system node according to the reference …
SetpointManager:Warmest This SetpointManager resets the cooling supply air temperature of a central forced air HVAC system according …
SetpointManager:WarmestTemperatureFlow This setpoint manager sets both the supply air temperature and the supply air flow rate.

SetpointManager:Coldest

from idfpy.models import SetpointManagerColdest

This SetpointManager is used in dual duct systems to reset the setpoint temperature of the air in the heating supply duct. Usually it is used in conjunction with a SetpointManager:Warmest resetting the temperature of the air in the cooling supply duct.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Temperature One of Temperature
hvac_air_loop_name
HVAC Air Loop Name required
reference Enter the name of an AirLoopHVAC object.
Names a AirLoopHVAC
minimum_setpoint_temperature
Minimum Setpoint Temperature
number
C
20.0 Range: > 0
maximum_setpoint_temperature
Maximum Setpoint Temperature
number
C
50.0 Range: > 0
strategy
Strategy
choice MinimumTemperature One of MinimumTemperature
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the temperature will be set

SetpointManager:CondenserEnteringReset

from idfpy.models import SetpointManagerCondenserEnteringReset

This setpoint manager uses one curve to determine the optimum condenser entering water temperature for a given timestep and two other curves to place boundary conditions on the setpoint value.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Temperature One of Temperature
default_condenser_entering_water_temperature_schedule_name
Default Condenser Entering Water Temperature Schedule Name required
reference This scheduled setpoint value is only used in a given timestep if the "Optimized" Condenser Entering Temperature does not fall within the prescribed boundary conditions.
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
minimum_design_wetbulb_temperature_curve_name
Minimum Design Wetbulb Temperature Curve Name required
reference Names a Curve:QuadLinear, Table:Lookup
minimum_outside_air_wetbulb_temperature_curve_name
Minimum Outside Air Wetbulb Temperature Curve Name required
reference Names a Curve:QuadLinear, Table:Lookup
optimized_cond_entering_water_temperature_curve_name
Optimized Cond Entering Water Temperature Curve Name required
reference Names a Curve:QuadLinear, Table:Lookup
minimum_lift
Minimum Lift
number
deltaC
11.1
maximum_condenser_entering_water_temperature
Maximum Condenser Entering Water Temperature
number
C
32.0
cooling_tower_design_inlet_air_wet_bulb_temperature
Cooling Tower Design Inlet Air Wet-Bulb Temperature
number
C
25.56
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which control variable will be set

SetpointManager:CondenserEnteringReset:Ideal

from idfpy.models import SetpointManagerCondenserEnteringResetIdeal

This setpoint manager determine the ideal optimum condenser entering water temperature setpoint for a given timestep.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Temperature One of Temperature
minimum_lift
Minimum Lift
number
deltaC
11.1
maximum_condenser_entering_water_temperature
Maximum Condenser Entering Water Temperature
number
C
32.0
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which control variable will be set

SetpointManager:FollowGroundTemperature

from idfpy.models import SetpointManagerFollowGroundTemperature

This setpoint manager is used to place a temperature setpoint on a system node that is derived from a current ground temperature. The ground temperatures are specified in different Site:GroundTemperature:* objects and used during the simulation. This setpoint manager is primarily intended for condenser or plant loops using some type of ground heat exchanger.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Temperature One of MaximumTemperature, MinimumTemperature, Temperature
reference_ground_temperature_object_type
Reference Ground Temperature Object Type
choice One of Site:GroundTemperature:BuildingSurface, Site:GroundTemperature:Deep, Site:GroundTemperature:FCfactorMethod, Site:GroundTemperature:Shallow
offset_temperature_difference
Offset Temperature Difference
number
deltaC
maximum_setpoint_temperature
Maximum Setpoint Temperature
number
C
minimum_setpoint_temperature
Minimum Setpoint Temperature
number
C
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which control variable will be set

SetpointManager:FollowOutdoorAirTemperature

from idfpy.models import SetpointManagerFollowOutdoorAirTemperature

This setpoint manager is used to place a temperature setpoint on a system node that is derived from the current outdoor air environmental conditions. The outdoor air conditions are obtained from the weather information during the simulation.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Temperature One of MaximumTemperature, MinimumTemperature, Temperature
reference_temperature_type
Reference Temperature Type
choice OutdoorAirWetBulb One of OutdoorAirDryBulb, OutdoorAirWetBulb
offset_temperature_difference
Offset Temperature Difference
number
deltaC
maximum_setpoint_temperature
Maximum Setpoint Temperature
number
C
minimum_setpoint_temperature
Minimum Setpoint Temperature
number
C
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which control variable will be set

SetpointManager:FollowSystemNodeTemperature

from idfpy.models import SetpointManagerFollowSystemNodeTemperature

This setpoint manager is used to place a temperature setpoint on a system node that is derived from the current temperatures at a separate system node. The current value of the temperature at a reference node is obtained and used to generate setpoint on a second system node. If the reference node is also designated to be an outdoor air (intake) node, then this setpoint manager can be used to follow outdoor air conditions that are adjusted for altitude.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Temperature One of MaximumTemperature, MinimumTemperature, Temperature
reference_node_name
Reference Node Name
string
reference_temperature_type
Reference Temperature Type
choice NodeDryBulb One of NodeDryBulb, NodeWetBulb
offset_temperature_difference
Offset Temperature Difference
number
deltaC
maximum_limit_setpoint_temperature
Maximum Limit Setpoint Temperature
number
C
minimum_limit_setpoint_temperature
Minimum Limit Setpoint Temperature
number
C
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which control variable will be set

SetpointManager:MixedAir

from idfpy.models import SetpointManagerMixedAir

The Mixed Air Setpoint Manager is meant to be used in conjunction with a Controller:OutdoorAir object. This setpoint manager is used to establish a temperature setpoint at the mixed air node.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Temperature One of Temperature
reference_setpoint_node_name
Reference Setpoint Node Name required
string
fan_inlet_node_name
Fan Inlet Node Name required
string
fan_outlet_node_name
Fan Outlet Node Name required
string
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the temperature will be set
cooling_coil_inlet_node_name
Cooling Coil Inlet Node Name
string Optional field used to limit economizer operation to prevent freezing of DX cooling coil.
cooling_coil_outlet_node_name
Cooling coil Outlet Node Name
string Optional field used to limit economizer operation to prevent freezing of DX cooling coil.
minimum_temperature_at_cooling_coil_outlet_node
Minimum Temperature at Cooling Coil Outlet Node
number
C
7.2 Optional field used to limit economizer operation to prevent freezing of DX cooling coil.
Range: > 0

SetpointManager:MultiZone:Cooling:Average

from idfpy.models import SetpointManagerMultiZoneCoolingAverage

This setpoint manager sets the average supply air temperature based on the cooling load requirements of all controlled zones in an air loop served by a central air-conditioner.

Field Type Default Details
name
Name required
string
hvac_air_loop_name
HVAC Air Loop Name required
reference Enter the name of an AirLoopHVAC object
Names a AirLoopHVAC
minimum_setpoint_temperature
Minimum Setpoint Temperature
number
C
12.0 Range: > 0
maximum_setpoint_temperature
Maximum Setpoint Temperature
number
C
18.0 Range: > 0
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the temperature will be set

SetpointManager:MultiZone:Heating:Average

from idfpy.models import SetpointManagerMultiZoneHeatingAverage

This setpoint manager sets the average supply air temperature based on the heating load requirements of all controlled zones in an air loop served by a central air-conditioner.

Field Type Default Details
name
Name required
string
hvac_air_loop_name
HVAC Air Loop Name required
reference Enter the name of an AirLoopHVAC object
Names a AirLoopHVAC
minimum_setpoint_temperature
Minimum Setpoint Temperature
number
C
20.0 Range: > 0
maximum_setpoint_temperature
Maximum Setpoint Temperature
number
C
50.0 Range: > 0
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the temperature will be set

SetpointManager:MultiZone:Humidity:Maximum

from idfpy.models import SetpointManagerMultiZoneHumidityMaximum

This setpoint manager sets the maximum supply air humidity ratio based on dehumidification requirements of a controlled zone with critical humidity ratio setpoint (i.e., a zone with the lowest humidity ratio setpoint) in an air loop served by a central air-conditioner.

Field Type Default Details
name
Name required
string
hvac_air_loop_name
HVAC Air Loop Name required
reference Enter the name of an AirLoopHVAC object
Names a AirLoopHVAC
minimum_setpoint_humidity_ratio
Minimum Setpoint Humidity Ratio
number
kgWater/kgDryAir
0.008 Range: > 0
maximum_setpoint_humidity_ratio
Maximum Setpoint Humidity Ratio
number
kgWater/kgDryAir
0.015 Range: > 0
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the humidity ratio will be set

SetpointManager:MultiZone:Humidity:Minimum

from idfpy.models import SetpointManagerMultiZoneHumidityMinimum

This setpoint manager sets the minimum supply air humidity ratio based on humidification requirements of a controlled zone with critical humidity ratio setpoint (i.e., a zone with the highest humidity ratio setpoint) in an air loop served by a central air-conditioner.

Field Type Default Details
name
Name required
string
hvac_air_loop_name
HVAC Air Loop Name required
reference Enter the name of an AirLoopHVAC object
Names a AirLoopHVAC
minimum_setpoint_humidity_ratio
Minimum Setpoint Humidity Ratio
number
kgWater/kgDryAir
0.005 Range: > 0
maximum_setpoint_humidity_ratio
Maximum Setpoint Humidity Ratio
number
kgWater/kgDryAir
0.012 Range: > 0
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the humidity ratio will be set

SetpointManager:MultiZone:MaximumHumidity:Average

from idfpy.models import SetpointManagerMultiZoneMaximumHumidityAverage

This setpoint manager sets the average supply air maximum humidity ratio based on moisture load requirements of all controlled zones in an air loop served by a central air-conditioner.

Field Type Default Details
name
Name required
string
hvac_air_loop_name
HVAC Air Loop Name required
reference Enter the name of an AirLoopHVAC object
Names a AirLoopHVAC
minimum_setpoint_humidity_ratio
Minimum Setpoint Humidity Ratio
number
kgWater/kgDryAir
0.008 Range: > 0
maximum_setpoint_humidity_ratio
Maximum Setpoint Humidity Ratio
number
kgWater/kgDryAir
0.015 Range: > 0
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the humidity ratio will be set

SetpointManager:MultiZone:MinimumHumidity:Average

from idfpy.models import SetpointManagerMultiZoneMinimumHumidityAverage

This setpoint manager sets the average supply air minimum humidity ratio based on moisture load requirements of all controlled zones in an air loop served by a central air-conditioner.

Field Type Default Details
name
Name required
string
hvac_air_loop_name
HVAC Air Loop Name required
reference Enter the name of an AirLoopHVAC object
Names a AirLoopHVAC
minimum_setpoint_humidity_ratio
Minimum Setpoint Humidity Ratio
number
kgWater/kgDryAir
0.005 Range: > 0
maximum_setpoint_humidity_ratio
Maximum Setpoint Humidity Ratio
number
kgWater/kgDryAir
0.012 Range: > 0
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the humidity ratio will be set

SetpointManager:OutdoorAirPretreat

from idfpy.models import SetpointManagerOutdoorAirPretreat

This setpoint manager determines the required conditions at the outdoor air stream node which will produce the reference setpoint condition at the mixed air node when mixed with the return air stream

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice One of HumidityRatio, MaximumHumidityRatio, MinimumHumidityRatio, Temperature
minimum_setpoint_temperature
Minimum Setpoint Temperature
number
C
-99.0 Applicable only if Control variable is Temperature
maximum_setpoint_temperature
Maximum Setpoint Temperature
number
C
99.0 Applicable only if Control variable is Temperature
minimum_setpoint_humidity_ratio
Minimum Setpoint Humidity Ratio
number
kgWater/kgDryAir
1e-05 Applicable only if Control variable is MaximumHumidityRatio, MinimumHumidityRatio, or HumidityRatio - then minimum is 0.00001
Range: ≤ 1
maximum_setpoint_humidity_ratio
Maximum Setpoint Humidity Ratio
number
kgWater/kgDryAir
1.0 Applicable only if Control variable is MaximumHumidityRatio, MinimumHumidityRatio, or HumidityRatio - then minimum is 0.00001
Range: ≤ 1
reference_setpoint_node_name
Reference Setpoint Node Name
string The current setpoint at this node is the desired condition for the Mixed Air Node This node must have a valid setpoint which has been set by another setpoint manager
mixed_air_stream_node_name
Mixed Air Stream Node Name required
string Name of Mixed Air Node
outdoor_air_stream_node_name
Outdoor Air Stream Node Name required
string Name of Outdoor Air Stream Node
return_air_stream_node_name
Return Air Stream Node Name required
string Name of Return Air Stream Node
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the temperature or humidity ratio will be set

SetpointManager:OutdoorAirReset

from idfpy.models import SetpointManagerOutdoorAirReset

This Setpoint Manager is used to place a setpoint temperature on system node according to the outdoor air temperature using a reset rule. The outdoor air temperature is obtained from the weather information during the simulation.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Temperature One of MaximumTemperature, MinimumTemperature, Temperature
setpoint_at_outdoor_low_temperature
Setpoint at Outdoor Low Temperature required
number
C
outdoor_low_temperature
Outdoor Low Temperature required
number
C
setpoint_at_outdoor_high_temperature
Setpoint at Outdoor High Temperature required
number
C
outdoor_high_temperature
Outdoor High Temperature required
number
C
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which temperature will be set
schedule_name
Schedule Name
reference Optional input. Schedule allows scheduling of the outdoor air reset rule - a schedule value of 1 means use the first rule; a value of 2 means use the second rule.
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
setpoint_at_outdoor_low_temperature_2
Setpoint at Outdoor Low Temperature 2
number
C
2nd outdoor air temperature reset rule
outdoor_low_temperature_2
Outdoor Low Temperature 2
number
C
2nd outdoor air temperature reset rule
setpoint_at_outdoor_high_temperature_2
Setpoint at Outdoor High Temperature 2
number
C
2nd outdoor air temperature reset rule
outdoor_high_temperature_2
Outdoor High Temperature 2
number
C
2nd outdoor air temperature reset rule

SetpointManager:ReturnAirBypassFlow

from idfpy.models import SetpointManagerReturnAirBypassFlow

This setpoint manager determines the required mass flow rate through a return air bypass duct to meet the specified temperature setpoint

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Flow One of Flow
hvac_air_loop_name
HVAC Air Loop Name required
reference Enter the name of an AirLoopHVAC object.
Names a AirLoopHVAC
temperature_setpoint_schedule_name
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

SetpointManager:ReturnTemperature:ChilledWater

from idfpy.models import SetpointManagerReturnTemperatureChilledWater

This setpoint manager is used to place a temperature setpoint on a plant supply outlet node based on a target return water setpoint. The setpoint manager attempts to achieve the desired return water temperature by adjusting the supply temperature setpoint based on the plant conditions at each system time step.

Field Type Default Details
name
Name required
string
plant_loop_supply_outlet_node
Plant Loop Supply Outlet Node required
string This is the name of the supply outlet node for the plant being controlled by this setpoint manager. Typically this is where the setpoint will be actuated for supply equipment to control to, but not necessarily. This setpoint manager will mine that information from the internal plant data structures.
plant_loop_supply_inlet_node
Plant Loop Supply Inlet Node required
string This is the name of the supply inlet node for the plant being controlled with this setpoint manager. The temperature on this node is controlled by actuating the supply setpoint.
minimum_supply_temperature_setpoint
Minimum Supply Temperature Setpoint
number
C
5.0 This is the minimum chilled water supply temperature setpoint. This is also used as the default setpoint during no-load or negative-load conditions and during initialization.
maximum_supply_temperature_setpoint
Maximum Supply Temperature Setpoint
number
C
10.0 This is the maximum reset temperature for the chilled water supply.
return_temperature_setpoint_input_type
Return Temperature Setpoint Input Type required
choice This defines whether the chilled water return temperature target is constant, scheduled, or specified on the supply inlet node by a separate setpoint manager.
One of Constant, ReturnTemperatureSetpoint, Scheduled
return_temperature_setpoint_constant_value
Return Temperature Setpoint Constant Value
number
C
13.0 This is the desired return temperature target, which is met by adjusting the supply temperature setpoint. This constant value is only used if the Design Chilled Water Return Temperature Input Type is Constant
return_temperature_setpoint_schedule_name
Return Temperature Setpoint Schedule Name
reference This is the desired return temperature target, which is met by adjusting the supply temperature setpoint. This is a schedule name to allow the return temperature target value to be scheduled. This field is only used if the Design Chilled Water Return Temperature Input Type is Scheduled
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules

SetpointManager:ReturnTemperature:HotWater

from idfpy.models import SetpointManagerReturnTemperatureHotWater

This setpoint manager is used to place a temperature setpoint on a plant supply outlet node based on a target return water setpoint. The setpoint manager attempts to achieve the desired return water temperature by adjusting the supply temperature setpoint based on the plant conditions at each system time step.

Field Type Default Details
name
Name required
string
plant_loop_supply_outlet_node
Plant Loop Supply Outlet Node required
string This is the name of the supply outlet node for the plant being controlled by this setpoint manager. Typically this is where the setpoint will be actuated for supply equipment to control to, but not necessarily. This setpoint manager will mine that information from the internal plant data structures.
plant_loop_supply_inlet_node
Plant Loop Supply Inlet Node required
string This is the name of the supply inlet node for the plant being controlled with this setpoint manager. The temperature on this node is controlled by actuating the supply setpoint.
minimum_supply_temperature_setpoint
Minimum Supply Temperature Setpoint
number
C
77.0 This is the minimum reset temperature for the hot water supply.
maximum_supply_temperature_setpoint
Maximum Supply Temperature Setpoint
number
C
82.0 This is the maximum hot water supply temperature setpoint. This is also used as the default setpoint during no-load or negative-load conditions and during initialization.
return_temperature_setpoint_input_type
Return Temperature Setpoint Input Type required
choice This defines whether the hot water return temperature target is constant, scheduled, or specified on the supply inlet node by a separate setpoint manager.
One of Constant, ReturnTemperatureSetpoint, Scheduled
return_temperature_setpoint_constant_value
Return Temperature Setpoint Constant Value
number
C
71.0 This is the desired return temperature target, which is met by adjusting the supply temperature setpoint. This constant value is only used if the Design Hot Water Return Temperature Input Type is Constant
return_temperature_setpoint_schedule_name
Return Temperature Setpoint Schedule Name
reference This is the desired return temperature target, which is met by adjusting the supply temperature setpoint. This is a schedule name to allow the return temperature target value to be scheduled. This field is only used if the Design Hot Water Return Temperature Input Type is Scheduled
Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules

SetpointManager:Scheduled

from idfpy.models import SetpointManagerScheduled

The simplest Setpoint Manager simply uses a schedule to determine one or more setpoints. Values of the nodes are not used as input.

Field Type Default Details
name
Name required
string
control_variable
Control Variable required
choice One of HumidityRatio, MassFlowRate, MaximumHumidityRatio, MaximumMassFlowRate, MaximumTemperature, MinimumHumidityRatio, MinimumMassFlowRate, MinimumTemperature, Temperature
schedule_name
Schedule Name required
reference Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which control variable will be set

SetpointManager:Scheduled:DualSetpoint

from idfpy.models import SetpointManagerScheduledDualSetpoint

This setpoint manager places a high and low schedule value on one or more nodes.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Temperature One of Temperature
high_setpoint_schedule_name
High Setpoint Schedule Name required
reference Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
low_setpoint_schedule_name
Low Setpoint Schedule Name required
reference Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which temperature will be set

SetpointManager:SingleZone:Cooling

from idfpy.models import SetpointManagerSingleZoneCooling

This setpoint manager detects the control zone load to meet the current cooling setpoint, zone inlet node flow rate, and zone node temperature, and calculates a setpoint temperature for the supply air that will satisfy the zone cooling load for the control zone.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Temperature One of Temperature
minimum_supply_air_temperature
Minimum Supply Air Temperature
number
C
-99.0
maximum_supply_air_temperature
Maximum Supply Air Temperature
number
C
99.0
control_zone_name
Control Zone Name required
reference Names a Zone
zone_node_name
Zone Node Name required
string
zone_inlet_node_name
Zone Inlet Node Name required
string
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the temperature will be set

SetpointManager:SingleZone:Heating

from idfpy.models import SetpointManagerSingleZoneHeating

This setpoint manager detects the control zone load to meet the current heating setpoint, zone inlet node flow rate, and zone node temperature, and calculates a setpoint temperature for the supply air that will satisfy the zone heating load for the control zone.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Temperature One of Temperature
minimum_supply_air_temperature
Minimum Supply Air Temperature
number
C
-99.0
maximum_supply_air_temperature
Maximum Supply Air Temperature
number
C
99.0
control_zone_name
Control Zone Name required
reference Names a Zone
zone_node_name
Zone Node Name required
string
zone_inlet_node_name
Zone Inlet Node Name required
string
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the temperature will be set

SetpointManager:SingleZone:Humidity:Maximum

from idfpy.models import SetpointManagerSingleZoneHumidityMaximum

The Single Zone Maximum Humidity Setpoint Manager allows the control of a single zone maximum humidity level. This setpoint manager can be used in conjunction with object ZoneControl:Humidistat to detect humidity levels.

Field Type Default Details
name
Name required
string
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which humidity ratio setpoint will be set
control_zone_air_node_name
Control Zone Air Node Name required
string Name of the zone air node for the humidity control zone

SetpointManager:SingleZone:Humidity:Minimum

from idfpy.models import SetpointManagerSingleZoneHumidityMinimum

The Single Zone Minimum Humidity Setpoint Manager allows the control of a single zone minimum humidity level. This setpoint manager can be used in conjunction with object ZoneControl:Humidistat to detect humidity levels.

Field Type Default Details
name
Name required
string
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which humidity ratio setpoint will be set
control_zone_air_node_name
Control Zone Air Node Name required
string Name of the zone air node for the humidity control zone

SetpointManager:SingleZone:OneStageCooling

from idfpy.models import SetpointManagerSingleZoneOneStageCooling

This object can be used with CoilSystem:Cooling:DX to model on/off cycling control of single stage air systems. Setpoints are modulated to run coil full on or full off depending on zone conditions. Intended for use with ZoneControl:Thermostat:StagedDualSetpoint

Field Type Default Details
name
Name required
string
cooling_stage_on_supply_air_setpoint_temperature
Cooling Stage On Supply Air Setpoint Temperature
number
C
-99.0 This is the setpoint value applied when cooling device is to cycle ON
cooling_stage_off_supply_air_setpoint_temperature
Cooling Stage Off Supply Air Setpoint Temperature
number
C
99.0 This is the setpoint value applied when cooling device is to cycle OFF
control_zone_name
Control Zone Name required
reference Names a Zone
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the temperature will be set

SetpointManager:SingleZone:OneStageHeating

from idfpy.models import SetpointManagerSingleZoneOneStageHeating

This object can be used with CoilSystem:Heating:DX, Coil:Heating:Fuel, Coil:Heating:Electric to model on/off cycling control of single stage air systems. Setpoints are modulated to run coil full on or full off depending on zone conditions. Intended for use with ZoneControl:Thermostat:StagedDualSetpoint.

Field Type Default Details
name
Name required
string
heating_stage_on_supply_air_setpoint_temperature
Heating Stage On Supply Air Setpoint Temperature
number
C
99.0 This is the setpoint value applied when heating device is to cycle ON
heating_stage_off_supply_air_setpoint_temperature
Heating Stage Off Supply Air Setpoint Temperature
number
C
-99.0 This is the setpoint value applied when heating device is to cycle OFF
control_zone_name
Control Zone Name required
reference Names a Zone
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the temperature will be set

SetpointManager:SingleZone:Reheat

from idfpy.models import SetpointManagerSingleZoneReheat

This setpoint manager detects the control zone load, zone inlet node flow rate, and zone node temperature and calculates a setpoint temperature for the supply air that will satisfy the zone load (heating or cooling) for the control zone. This setpoint manager is not limited to reheat applications.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Temperature One of Temperature
minimum_supply_air_temperature
Minimum Supply Air Temperature
number
C
-99.0
maximum_supply_air_temperature
Maximum Supply Air Temperature
number
C
99.0
control_zone_name
Control Zone Name required
reference Names a Zone
zone_node_name
Zone Node Name required
string
zone_inlet_node_name
Zone Inlet Node Name required
string
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the temperature will be set

SetpointManager:SystemNodeReset:Humidity

from idfpy.models import SetpointManagerSystemNodeResetHumidity

This Setpoint Manager is used to place a humidity ratio setpoint on a system node according to the reference (e.g., return) humidity ratio using a reset rule. The humidity ratio setpoint is obtained by retrieving the humidity ratio of the user specified reference system node.

Field Type Default Details
name
Name required
string
control_variable
Control Variable required
choice One of HumidityRatio, MaximumHumidityRatio, MinimumHumidityRatio
setpoint_at_low_reference_humidity_ratio
Setpoint at Low Reference Humidity Ratio required
number
kgWater/kgDryAir
setpoint_at_high_reference_humidity_ratio
Setpoint at High Reference Humidity Ratio required
number
kgWater/kgDryAir
low_reference_humidity_ratio
Low Reference Humidity Ratio required
number
kgWater/kgDryAir
high_reference_humidity_ratio
High Reference Humidity Ratio required
number
kgWater/kgDryAir
reference_node_name
Reference Node Name required
string The name of an HVAC system node that gets referenced.
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which humidity ratio will be set

SetpointManager:SystemNodeReset:Temperature

from idfpy.models import SetpointManagerSystemNodeResetTemperature

This Setpoint Manager is used to place a temperature setpoint on a system node according to the reference (e.g., return) temperature using a reset rule. The temperature setpoint is obtained by retrieving the temperature of the user specified reference system node.

Field Type Default Details
name
Name required
string
control_variable
Control Variable required
choice One of MaximumTemperature, MinimumTemperature, Temperature
setpoint_at_low_reference_temperature
Setpoint at Low Reference Temperature required
number
C
setpoint_at_high_reference_temperature
Setpoint at High Reference Temperature required
number
C
low_reference_temperature
Low Reference Temperature required
number
C
high_reference_temperature
High Reference Temperature required
number
C
reference_node_name
Reference Node Name required
string The name of an HVAC system node that gets referenced.
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which temperature will be set

SetpointManager:Warmest

from idfpy.models import SetpointManagerWarmest

This SetpointManager resets the cooling supply air temperature of a central forced air HVAC system according to the cooling demand of the warmest zone.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice Temperature One of Temperature
hvac_air_loop_name
HVAC Air Loop Name required
reference Enter the name of an AirLoopHVAC object
Names a AirLoopHVAC
minimum_setpoint_temperature
Minimum Setpoint Temperature
number
C
12.0 Range: > 0
maximum_setpoint_temperature
Maximum Setpoint Temperature
number
C
18.0 Range: > 0
strategy
Strategy
choice MaximumTemperature One of MaximumTemperature
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the temperature will be set

SetpointManager:WarmestTemperatureFlow

from idfpy.models import SetpointManagerWarmestTemperatureFlow

This setpoint manager sets both the supply air temperature and the supply air flow rate.

Field Type Default Details
name
Name required
string
control_variable
Control Variable
choice One of Temperature
hvac_air_loop_name
HVAC Air Loop Name required
reference Enter the name of an AirLoopHVAC object.
Names a AirLoopHVAC
minimum_setpoint_temperature
Minimum Setpoint Temperature
number
C
12.0 Range: > 0
maximum_setpoint_temperature
Maximum Setpoint Temperature
number
C
18.0 Range: > 0
strategy
Strategy
choice TemperatureFirst For TemperatureFirst the manager tries to find the highest setpoint temperature that will satisfy all the zone cooling loads at minimum supply air flow rate. If this setpoint temperature is less than the minimum, the setpoint temperature is set to the minimum, and the supply air flow rate is increased to meet the loads. For FlowFirst the manager tries to find the lowest supply air flow rate that will satisfy all the zone cooling loads at the maximum setpoint temperature. If this flow is greater than the maximum, the flow is set to the maximum and the setpoint temperature is reduced to satisfy the cooling loads.
One of FlowFirst, TemperatureFirst
setpoint_node_or_nodelist_name
Setpoint Node or NodeList Name required
string Node(s) at which the temperature will be set
minimum_turndown_ratio
Minimum Turndown Ratio
number
dimensionless
0.2 Fraction of the maximum supply air flow rate. Used to define the minimum supply flow for the TemperatureFirst strategy.
Range: > 0