Zone HVAC Equipment Connections¶

6 object types from idfpy.models.zone_equipment · EnergyPlus 26.2

Object	Summary
SpaceHVAC:EquipmentConnections	Specifies the HVAC equipment connections for a space.
SpaceHVAC:ZoneEquipmentMixer	Mixes the airflow from one or more Spaces into a piece of zone equipment.
SpaceHVAC:ZoneEquipmentSplitter	Distributes the output from a piece of zone equipment to one or more Spaces in the Zone.
SpaceHVAC:ZoneReturnMixer	Mixes the return airflow from one or more Spaces into a zone return node.
ZoneHVAC:EquipmentConnections	Specifies the HVAC equipment connections for a zone.
ZoneHVAC:EquipmentList	List equipment in simulation order.

SpaceHVAC:EquipmentConnections¶

from idfpy.models import SpaceHVACEquipmentConnections

Specifies the HVAC equipment connections for a space. Node names are specified for the space air node, air inlet nodes, air exhaust nodes, and the air return node. If any space in a zone has a SpaceHVAC:EquipmentConnections object, then all spaces in the zone must have one. Used only when ZoneAirHeatBalanceAlgorithm "Do Space Heat Balance for Simulation" is Yes.

Field	Type	Details
`space_name` Space Name required	reference	Names a Space
`space_air_inlet_node_or_nodelist_name` Space Air Inlet Node or NodeList Name	string
`space_air_exhaust_node_or_nodelist_name` Space Air Exhaust Node or NodeList Name	string
`space_air_node_name` Space Air Node Name required	string
`space_return_air_node_or_nodelist_name` Space Return Air Node or NodeList Name	string
`space_return_air_node_1_flow_rate_fraction_schedule_name` Space Return Air Node 1 Flow Rate Fraction Schedule Name	reference	This schedule is multiplied times the base return air flow rate. If this field is left blank, the schedule defaults to 1.0 at all times. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
`space_return_air_node_1_flow_rate_basis_node_or_nodelist_name` Space Return Air Node 1 Flow Rate Basis Node or NodeList Name	string	The optional basis node(s) used to calculate the base return air flow rate for the first return air node in this space. The return air flow rate is the sum of the flow rates at the basis node(s) multiplied by the Space Return Air Flow Rate Fraction Schedule. If this field is blank, then the base return air flow rate is the total supply inlet flow rate to the zone less the total exhaust node flow rate from the space.

SpaceHVAC:ZoneEquipmentMixer¶

from idfpy.models import SpaceHVACZoneEquipmentMixer extensible

Mixes the airflow from one or more Spaces into a piece of zone equipment. All spaces in the zone must also have a SpaceHVAC:EquipmentConnections object. Used only when ZoneAirHeatBalanceAlgorithm "Do Space Heat Balance for Simulation" is Yes.

Field	Type	Default	Details
`name` Name required	string
`zone_name` Zone Name required	reference		Must be a controlled zone which has a ZoneHVAC:EquipmentConnections object. Names a Zone
`zone_equipment_inlet_node_name` Zone Equipment Inlet Node Name required	string		The inlet node from the zone equipment that will be mixed from the spaces. Must match a Zone Exhaust Node for this zone.
`space_fraction_method` Space Fraction Method	choice	`DesignCoolingLoad`	The basis used to autosize the space output fractions. One of `DesignCoolingLoad`, `DesignHeatingLoad`, `FloorArea`, `PerimeterLength`, `Volume`
`spaces`	list		Each item: `space_name`, `space_fraction` (dimensionless), `space_node_name`

SpaceHVAC:ZoneEquipmentSplitter¶

from idfpy.models import SpaceHVACZoneEquipmentSplitter extensible

Distributes the output from a piece of zone equipment to one or more Spaces in the Zone. If any equipment in a zone has a SpaceHVAC:ZoneEquipmentSplitter, then all equipment in the zone must have one. except Fan:ZoneExhaust. All spaces in the zone must also have a SpaceHVAC:EquipmentConnections object. Used only when ZoneAirHeatBalanceAlgorithm "Do Space Heat Balance for Simulation" is Yes.

Field	Type	Default	Details
`name` Name required	string
`zone_name` Zone Name required	reference		Must be a controlled zone which has a ZoneHVAC:EquipmentConnections object. Names a Zone
`zone_equipment_object_type` Zone Equipment Object Type required	choice		One of `AirLoopHVAC:UnitarySystem`, `HeatExchanger:AirToAir:FlatPlate`, `WaterHeater:HeatPump:PumpedCondenser`, `WaterHeater:HeatPump:WrappedCondenser`, `ZoneHVAC:AirDistributionUnit`, `ZoneHVAC:Baseboard:Convective:Electric`, `ZoneHVAC:Baseboard:Convective:Water`, `ZoneHVAC:Baseboard:RadiantConvective:Electric`, `ZoneHVAC:Baseboard:RadiantConvective:Steam`, `ZoneHVAC:Baseboard:RadiantConvective:Water`, `ZoneHVAC:CoolingPanel:RadiantConvective:Water`, `ZoneHVAC:Dehumidifier:DX`, `ZoneHVAC:EnergyRecoveryVentilator`, `ZoneHVAC:EvaporativeCoolerUnit`, `ZoneHVAC:ForcedAir:UserDefined`, `ZoneHVAC:FourPipeFanCoil`, `ZoneHVAC:HighTemperatureRadiant`, `ZoneHVAC:HybridUnitaryHVAC`, `ZoneHVAC:IdealLoadsAirSystem`, `ZoneHVAC:LowTemperatureRadiant:ConstantFlow`, `ZoneHVAC:LowTemperatureRadiant:Electric`, `ZoneHVAC:LowTemperatureRadiant:VariableFlow`, `ZoneHVAC:OutdoorAirUnit`, `ZoneHVAC:PackagedTerminalAirConditioner`, `ZoneHVAC:PackagedTerminalHeatPump`, `ZoneHVAC:RefrigerationChillerSet`, `ZoneHVAC:TerminalUnit:VariableRefrigerantFlow`, `ZoneHVAC:UnitHeater`, `ZoneHVAC:UnitVentilator`, `ZoneHVAC:VentilatedSlab`, `ZoneHVAC:WaterToAirHeatPump`, `ZoneHVAC:WindowAirConditioner`
`zone_equipment_name` Zone Equipment Name required	reference		Names a AirLoopHVAC:UnitarySystem, Fan:ZoneExhaust, HeatExchanger:AirToAir:FlatPlate, WaterHeater:HeatPump:PumpedCondenser, WaterHeater:HeatPump:WrappedCondenser, ZoneHVAC:AirDistributionUnit, ZoneHVAC:Baseboard:Convective:Electric, ZoneHVAC:Baseboard:Convective:Water, ZoneHVAC:Baseboard:RadiantConvective:Electric, ZoneHVAC:Baseboard:RadiantConvective:Steam, ZoneHVAC:Baseboard:RadiantConvective:Steam:Design, ZoneHVAC:Baseboard:RadiantConvective:Water and 22 more
`zone_equipment_outlet_node_name` Zone Equipment Outlet Node Name	string		Only used for airflow equipment. The outlet node from the zone equipment that will be split to the spaces.
`thermostat_control_method` Thermostat Control Method	choice	`SingleSpace`	SingleSpace satisfies the thermostat in the Control Space Name Maximum satisfies the thermostat in the connected spaces with the highest deviation from setpoint Ideal ignores the Space Output Fractions and distributes the output to match the current space sensible loads. One of `Ideal`, `Maximum`, `SingleSpace`
`control_space_name` Control Space Name	reference		This field is only used when Thermostat Control Method = SingleSpace. Names a Space
`space_fraction_method` Space Fraction Method	choice	`DesignCoolingLoad`	The basis used to autosize the space output fractions. One of `DesignCoolingLoad`, `DesignHeatingLoad`, `FloorArea`, `PerimeterLength`, `Volume`
`spaces`	list		Each item: `space_name`, `space_fraction` (dimensionless), `space_supply_node_name`

SpaceHVAC:ZoneReturnMixer¶

from idfpy.models import SpaceHVACZoneReturnMixer extensible

Mixes the return airflow from one or more Spaces into a zone return node. All spaces in the zone must also have a SpaceHVAC:EquipmentConnections object. Used only when ZoneAirHeatBalanceAlgorithm "Do Space Heat Balance for Simulation" is Yes.

Field	Type	Details
`name` Name required	string
`zone_name` Zone Name required	reference	Must be a controlled zone which has a ZoneHVAC:EquipmentConnections object. Names a Zone
`zone_return_air_node_name` Zone Return Air Node Name required	string	The zone return air node will be mixed from the spaces. Must match a Zone Return Air Node for this zone.
`spaces`	list	Each item: `space_name`, `space_return_air_node_name`

ZoneHVAC:EquipmentConnections¶

from idfpy.models import ZoneHVACEquipmentConnections

Specifies the HVAC equipment connections for a zone. Node names are specified for the zone air node, air inlet nodes, air exhaust nodes, and the air return node. A zone equipment list is referenced which lists all HVAC equipment connected to the zone.

Field	Type	Details
`zone_name` Zone Name required	reference	Names a Zone
`zone_conditioning_equipment_list_name` Zone Conditioning Equipment List Name required	reference	Enter the name of a ZoneHVAC:EquipmentList object. Names a ZoneHVAC:EquipmentList
`zone_air_inlet_node_or_nodelist_name` Zone Air Inlet Node or NodeList Name	string
`zone_air_exhaust_node_or_nodelist_name` Zone Air Exhaust Node or NodeList Name	string
`zone_air_node_name` Zone Air Node Name required	string
`zone_return_air_node_or_nodelist_name` Zone Return Air Node or NodeList Name	string
`zone_return_air_node_1_flow_rate_fraction_schedule_name` Zone Return Air Node 1 Flow Rate Fraction Schedule Name	reference	This schedule is multiplied times the base return air flow rate. If this field is left blank, the schedule defaults to 1.0 at all times. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
`zone_return_air_node_1_flow_rate_basis_node_or_nodelist_name` Zone Return Air Node 1 Flow Rate Basis Node or NodeList Name	string	The optional basis node(s) used to calculate the base return air flow rate for the first return air node in this zone. The return air flow rate is the sum of the flow rates at the basis node(s) multiplied by the Zone Return Air Flow Rate Fraction Schedule. If this field is blank, then the base return air flow rate is the total supply inlet flow rate to the zone less the total exhaust node flow rate from the zone.

ZoneHVAC:EquipmentList¶

from idfpy.models import ZoneHVACEquipmentList extensible

List equipment in simulation order. Note that an ZoneHVAC:AirDistributionUnit object must be listed in this statement if there is a forced air system serving the zone from the air loop. Equipment is simulated in the order specified by Zone Equipment Cooling Sequence and Zone Equipment Heating or No-Load Sequence, depending on the thermostat request. For equipment of similar type, assign sequence 1 to the first system intended to serve that type of load. For situations where one or more equipment types has limited capacity or limited control, order the sequence so that the most controllable piece of equipment runs last. For example, with a dedicated outdoor air system (DOAS), the air terminal for the DOAS should be assigned Heating Sequence = 1 and Cooling Sequence = 1. Any other equipment should be assigned sequence 2 or higher so that it will see the net load after the DOAS air is added to the zone.

Field	Type	Default	Details
`name` Name required	string
`load_distribution_scheme` Load Distribution Scheme	choice	`SequentialLoad`	One of `SequentialLoad`, `SequentialUniformPLR`, `UniformLoad`, `UniformPLR`
`equipment`	list		Each item: `zone_equipment_object_type`, `zone_equipment_name`, `zone_equipment_cooling_sequence`, `zone_equipment_heating_or_no_load_sequence`, `zone_equipment_sequential_cooling_fraction_schedule_name`, `zone_equipment_sequential_heating_fraction_schedule_name`

Referenced by 1 object types

ZoneHVAC:EquipmentConnections