HVAC Design Objects¶

10 object types from idfpy.models.hvac_design · EnergyPlus 26.2

Object	Summary
DesignSpecification:AirTerminal:Sizing	This object is used to scale the sizing of air terminal units.
DesignSpecification:OutdoorAir	This object is used to describe general outdoor air requirements which are referenced by other objects.
DesignSpecification:OutdoorAir:SpaceList	Defines a list of DesignSpecification:OutdoorAir names which can be referenced as a group.
DesignSpecification:ZoneAirDistribution	This object is used to describe zone air distribution in terms of air distribution effectiveness and …
DesignSpecification:ZoneHVAC:Sizing	This object is used to describe general scalable zone HVAC equipment sizing which are referenced by other …
OutputControl:Sizing:Style	Default style for the Sizing output files is comma -- this works well for importing into spreadsheet programs …
Sizing:Parameters	Specifies global heating and cooling sizing factors/ratios.
Sizing:Plant	Specifies the input needed to autosize plant loop flow rates and equipment capacities.
Sizing:System	Specifies the input needed to perform sizing calculations for a central forced air system.
Sizing:Zone	Specifies the data needed to perform a zone design air flow calculation.

DesignSpecification:AirTerminal:Sizing¶

from idfpy.models import DesignSpecificationAirTerminalSizing

This object is used to scale the sizing of air terminal units.

Field	Type	Default	Details
`name` Name required	string		This name may be referenced by a ZoneHVAC:AirDistributionUnit object.
`fraction_of_design_cooling_load` Fraction of Design Cooling Load	number dimensionless	`1.0`	The fraction of the design sensible cooling load to be met by this terminal unit. This fraction is applied after the Zone Cooling Sizing Factor (see Sizing:Zone). Range: ≥ 0
`cooling_design_supply_air_temperature_difference_ratio` Cooling Design Supply Air Temperature Difference Ratio	number dimensionless	`1.0`	This ratio adjusts the supply air temperature difference used to calculate the cooling design supply air flow rate for this terminal unit. Range: > 0
`fraction_of_design_heating_load` Fraction of Design Heating Load	number dimensionless	`1.0`	The fraction of the design sensible heating load to be met by this terminal unit. This fraction is applied after the Zone Heating Sizing Factor (see Sizing:Zone). Range: ≥ 0
`heating_design_supply_air_temperature_difference_ratio` Heating Design Supply Air Temperature Difference Ratio	number dimensionless	`1.0`	This ratio adjusts the supply air temperature difference used to calculate the heating design supply air flow rate for this terminal unit. Range: > 0
`fraction_of_minimum_outdoor_air_flow` Fraction of Minimum Outdoor Air Flow	number dimensionless	`1.0`	The fraction of the zone minimum outdoor air requirement to be met by this terminal unit. Range: ≥ 0

Referenced by 1 object types

ZoneHVAC:AirDistributionUnit

DesignSpecification:OutdoorAir¶

from idfpy.models import DesignSpecificationOutdoorAir

This object is used to describe general outdoor air requirements which are referenced by other objects.

Field	Type	Default	Details
`name` Name required	string
`outdoor_air_method` Outdoor Air Method	choice	`Flow/Person`	Flow/Person => Outdoor Air Flow per Person * Occupancy = Design Flow Rate, Flow/Area => Outdoor Air Flow per Zone Floor Area * Zone Floor Area = Design Flow Rate, Flow/Zone => Outdoor Air Flow per Zone = Design Flow Rate, AirChanges/Hour => Outdoor Air Flow Air Changes per Hour * Zone Volume adjusted for m3/s = Design Flow Rate One of `AirChanges/Hour`, `Flow/Area`, `Flow/Person`, `Flow/Zone`, `IndoorAirQualityProcedure`, `Maximum`, `ProportionalControlBasedOnDesignOccupancy`, `ProportionalControlBasedOnOccupancySchedule`, `Sum`
`outdoor_air_flow_per_person` Outdoor Air Flow per Person	number m3/s-person	`0.00944`	0.00944 m3/s is equivalent to 20 cfm per person This input is only used if the field Outdoor Air Method is Flow/Person, Sum, or Maximum For sizing, the design number of occupants is used. For outdoor air flow control, the use of design occupants or current occupants depends on the component and DCV options. AirTerminal:SingleDuct:VAV:NoReheat, AirTerminal:SingleDuct:VAV:Reheat use the DCV flag specified in Controller:MechanicalVentilation AirTerminal:DualDuct:VAV:OutdoorAir and ZoneHVAC:IdealLoadsAirSystem have their own DCV control input. ZoneHVAC:FourPipeFanCoil always uses current occupants. Range: ≥ 0
`outdoor_air_flow_per_zone_floor_area` Outdoor Air Flow per Zone Floor Area	number m3/s-m2	`0.0`	This input is only used if the field Outdoor Air Method is Flow/Area, Sum, or Maximum Range: ≥ 0
`outdoor_air_flow_per_zone` Outdoor Air Flow per Zone	number m3/s	`0.0`	This input is only used if the field Outdoor Air Method is Flow/Zone, Sum, or Maximum Range: ≥ 0
`outdoor_air_flow_air_changes_per_hour` Outdoor Air Flow Air Changes per Hour	number 1/hr	`0.0`	This input is only used if the field Outdoor Air Method is AirChanges/Hour, Sum, or Maximum Range: ≥ 0
`outdoor_air_schedule_name` Outdoor Air Schedule Name	reference		Schedule values are multiplied by the Outdoor Air Flow rate calculated using the previous four inputs. Schedule values are limited to 0 to 1. If left blank, the schedule defaults to 1.0. This schedule is ignored during sizing. All other components which reference this design specification use the current schedule value to calculate the current outdoor air requirement. This includes AirTerminal:SingleDuct:VAV:NoReheat, AirTerminal:SingleDuct:VAV:Reheat, AirTerminal:DualDuct:VAV:OutdoorAir, ZoneHVAC:FourPipeFanCoil, and ZoneHVAC:IdealLoadsAirSystem. This schedule will also be applied by Controller:MechanicalVentilation for all System Outdoor Air Methods. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
`proportional_control_minimum_outdoor_air_flow_rate_schedule_name` Proportional Control Minimum Outdoor Air Flow Rate Schedule Name	reference		This input is only used to calculate the minimum outdoor air flow rate when the field System Outdoor Air Method = 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

Referenced by 24 object types

DesignSpecification:OutdoorAir:SpaceList¶

from idfpy.models import DesignSpecificationOutdoorAirSpaceList extensible

Defines a list of DesignSpecification:OutdoorAir names which can be referenced as a group. The DesignSpecification:OutdoorAir:SpaceList name may be used in Sizing:Zone and Controller:MechanicalVentilation to specify space-by-space OA requirements and anywhere else that accepts a DesignSpecification:OutdoorAir object name.

Field	Type	Default	Details
`name` Name required	string		Name of the List
`space_specs`	list		Each item: `space_name`, `space_design_specification_outdoor_air_object_name`

Referenced by 23 object types

DesignSpecification:ZoneAirDistribution¶

from idfpy.models import DesignSpecificationZoneAirDistribution

This object is used to describe zone air distribution in terms of air distribution effectiveness and secondary recirculation fraction. It is referenced by Sizing:Zone and Controller:MechanicalVentilation objects

Field	Type	Default	Details
`name` Name required	string
`zone_air_distribution_effectiveness_in_cooling_mode` Zone Air Distribution Effectiveness in Cooling Mode	number dimensionless	`1.0`	Range: > 0
`zone_air_distribution_effectiveness_in_heating_mode` Zone Air Distribution Effectiveness in Heating Mode	number dimensionless	`1.0`	Range: > 0
`zone_air_distribution_effectiveness_schedule_name` Zone Air Distribution Effectiveness Schedule Name	reference		optionally used to replace Zone Air Distribution Effectiveness in Cooling and Heating Mode Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
`zone_secondary_recirculation_fraction` Zone Secondary Recirculation Fraction	number dimensionless	`0.0`	Range: ≥ 0
`minimum_zone_ventilation_efficiency` Minimum Zone Ventilation Efficiency	number dimensionless	`0.0`	Range: ≥ 0, ≤ 1

Referenced by 14 object types

Controller:MechanicalVentilation, HVACTemplate:Zone:BaseboardHeat, HVACTemplate:Zone:ConstantVolume, HVACTemplate:Zone:DualDuct, HVACTemplate:Zone:FanCoil, HVACTemplate:Zone:PTAC, HVACTemplate:Zone:PTHP, HVACTemplate:Zone:Unitary, HVACTemplate:Zone:VAV, HVACTemplate:Zone:VAV:FanPowered, HVACTemplate:Zone:VAV:HeatAndCool, HVACTemplate:Zone:VRF, HVACTemplate:Zone:WaterToAirHeatPump, Sizing:Zone

DesignSpecification:ZoneHVAC:Sizing¶

from idfpy.models import DesignSpecificationZoneHVACSizing

This object is used to describe general scalable zone HVAC equipment sizing which are referenced by other objects.

Field	Type	Default	Details
`name` Name required	string
`cooling_supply_air_flow_rate_method` Cooling Supply Air Flow Rate Method	choice	`SupplyAirFlowRate`	Enter the method used to determine the cooling supply air volume flow rate. None is used when a cooling coil is not included in the Zone HVAC Equip or this field may be blank. SupplyAirFlowRate => selected when the magnitude of the supply air volume flow rate is specified. FlowPerFloorArea => selected when the supply air volume flow rate is determined from total floor area served by the Zone HVAC unit and Flow Per Floor Area value specified. FractionOfAutosizedCoolingAirflow => is selected when the supply air volume is determined from a user specified fraction and the autosized cooling supply air flow rate value determined by the simulation. FlowPerCoolingCapacity => is selected when the supply air volume is determined from user specified flow per Cooling Capacity and Cooling Capacity determined by the simulation. One of `FlowPerCoolingCapacity`, `FlowPerFloorArea`, `FractionOfAutosizedCoolingAirflow`, `None`, `SupplyAirFlowRate`
`cooling_supply_air_flow_rate` Cooling Supply Air Flow Rate	number or `Autosize` m3/s		Enter the magnitude of supply air volume flow rate during cooling operation. Required field when Cooling Supply Air Flow Rate Method is SupplyAirFlowRate. This field may be blank if a cooling coil is not included in the Zone HVAC equipment.
`cooling_supply_air_flow_rate_per_floor_area` Cooling Supply Air Flow Rate Per Floor Area	number m3/s-m2		Enter the cooling supply air volume flow rate per total conditioned floor area. Required field when Cooling Supply Air Flow Rate Method is FlowPerFloorArea. This field may be blank if a cooling coil is not included in the Zone HVAC equipment. Range: ≥ 0
`cooling_fraction_of_autosized_cooling_supply_air_flow_rate` Cooling Fraction of Autosized Cooling Supply Air Flow Rate	number		Enter the supply air volume flow rate as a fraction of the cooling supply air flow rate. Required field when Cooling Supply Air Flow Rate Method is FractionOfAutosizedCoolingAirflow. This field may be blank if a cooling coil is not included in the Zone HVAC equipment. Range: ≥ 0
`cooling_supply_air_flow_rate_per_unit_cooling_capacity` Cooling Supply Air Flow Rate Per Unit Cooling Capacity	number m3/s-W		Enter the cooling supply air volume flow rate unit cooling capacity. Required field when Cooling Supply Air Flow Rate Method is FlowPerCoolingCapacity. This field may be blank if a cooling coil is not included in the Zone HVAC equipment. Range: ≥ 0
`no_load_supply_air_flow_rate_method` No Load Supply Air Flow Rate Method	choice	`SupplyAirFlowRate`	Enter the method used to determine the supply air volume flow rate When No Cooling or Heating is Required. None is used when a cooling or heating coil is not included in the Zone HVAC Equipment or this field may be blank. SupplyAirFlowRate => selected when the magnitude of the supply air volume flow rate is specified. FlowPerFloorArea => selected when the supply air volume flow rate is determined from total floor area served by the Zone HVAC unit and Flow Per Floor Area is specified. FractionOfAutosizedCoolingAirflow => is selected when the supply air volume is determined from a user specified fraction and the Autosized cooling supply air flow rate value determined by the simulation. FractionOfAutosizedHeatingAirflow => is selected when the supply air volume is determined from a user specified fraction and the Autosized heating supply air flow rate value determined by the simulation. One of `FlowPerFloorArea`, `FractionOfAutosizedCoolingAirflow`, `FractionOfAutosizedHeatingAirflow`, `None`, `SupplyAirFlowRate`
`no_load_supply_air_flow_rate` No Load Supply Air Flow Rate	number or `Autosize` m3/s		Enter the magnitude of the supply air volume flow rate during when no cooling or heating is required. Required field when No Load Supply Air Flow Rate Method is SupplyAirFlowRate.
`no_load_supply_air_flow_rate_per_floor_area` No Load Supply Air Flow Rate Per Floor Area	number m3/s-m2		Enter the supply air volume flow rate per total floor area. Required field when No Load Supply Air Flow Rate Method is FlowPerFloorArea. Range: ≥ 0
`no_load_fraction_of_cooling_supply_air_flow_rate` No Load Fraction of Cooling Supply Air Flow Rate	number		Enter the supply air volume flow rate as a fraction of the cooling supply air flow rate. Required field when No Load Supply Air Flow Rate Method is FractionOfAutosizedCoolingAirflow. Range: ≥ 0
`no_load_fraction_of_heating_supply_air_flow_rate` No Load Fraction of Heating Supply Air Flow Rate	number		Enter the supply air volume flow rate as a fraction of the heating supply air flow rate. Required field when No Load Supply Air Flow Rate Method is FractionOfAutosizedHeatingAirflow. Range: ≥ 0
`heating_supply_air_flow_rate_method` Heating Supply Air Flow Rate Method	choice	`SupplyAirFlowRate`	Enter the method used to determine the heating supply air volume flow rate. None is used when a heating coil is not included in the Zone HVAC Equipment or this field may be blank. SupplyAirFlowRate => selected when the magnitude of the heating supply air volume flow rate is specified. FlowPerFloorArea => selected when the supply air volume flow rate is determined from total floor area served by a Zone HVAC unit and user specified value of Flow Per Floor Area. FractionOfAutosizedHeatingAirflow => is selected when the supply air volume is determined from a user specified fraction and the Autosized heating supply air flow rate value determined by the simulation. FlowPerHeatingCapacity => is selected when the supply air volume is determined from user specified flow per Heating Capacity and Heating Capacity determined by the simulation. One of `FlowPerFloorArea`, `FlowPerHeatingCapacity`, `FractionOfAutosizedHeatingAirflow`, `None`, `SupplyAirFlowRate`
`heating_supply_air_flow_rate` Heating Supply Air Flow Rate	number or `Autosize` m3/s		Enter the magnitude of the supply air volume flow rate during heating operation. Required field when Heating Supply Air Flow Rate Method is SupplyAirFlowRate. This field may be blank if a heating coil is not included in the Zone HVAC equipment.
`heating_supply_air_flow_rate_per_floor_area` Heating Supply Air Flow Rate Per Floor Area	number m3/s-m2		Enter the heating supply air volume flow rate per total conditioned floor area. Required field when Heating Supply Air Flow Rate Method is FlowPerFloorArea. This field may be blank if a heating coil is not included in the Zone HVAC equipment. Range: ≥ 0
`heating_fraction_of_heating_supply_air_flow_rate` Heating Fraction of Heating Supply Air Flow Rate	number		Enter the supply air volume flow rate as a fraction of the heating supply air flow rate. Required field when Heating Supply Air Flow Rate Method is FractionOfAutosizedHeatingAirflow. This field may be blank if a heating coil is not included in the Zone HVAC equipment. Range: ≥ 0
`heating_supply_air_flow_rate_per_unit_heating_capacity` Heating Supply Air Flow Rate Per Unit Heating Capacity	number m3/s-W		Enter the supply air volume flow rate per unit heating capacity. Required field when Heating Supply Air Flow Rate Method is FlowPerHeatingCapacity. This field may be blank if a heating coil is not included in the Zone HVAC equipment. Range: ≥ 0
`cooling_design_capacity_method` Cooling Design Capacity Method	choice	`None`	Enter the method used to determine the cooling design capacity for scalable sizing. None is used when a cooling coils is not included in the Zone HVAC Equipment or this field may be blank. If this input field is left blank, then the design cooling capacity is set to zero. CoolingDesignCapacity => selected when the design cooling capacity value is specified or auto-sized. CapacityPerFloorArea => selected when the design cooling capacity is determine from user specified cooling capacity per floor area and zone floor area. FractionOfAutosizedCoolingCapacity => is selected when the design cooling capacity is determined from a user specified fraction and the auto-sized design cooling capacity. One of `CapacityPerFloorArea`, `CoolingDesignCapacity`, `FractionOfAutosizedCoolingCapacity`, `None`
`cooling_design_capacity` Cooling Design Capacity	number or `Autosize` W		Enter the design cooling capacity. Required field when the cooling design capacity method CoolingDesignCapacity.
`cooling_design_capacity_per_floor_area` Cooling Design Capacity Per Floor Area	number W/m2		Enter the cooling design capacity per zone floor area. Required field when the cooling design capacity method field is CapacityPerFloorArea. Range: ≥ 0
`fraction_of_autosized_cooling_design_capacity` Fraction of Autosized Cooling Design Capacity	number		Enter the fraction of auto-sized cooling design capacity. Required field when the cooling design capacity method field is FractionOfAutosizedCoolingCapacity. Range: ≥ 0
`heating_design_capacity_method` Heating Design Capacity Method	choice	`None`	Enter the method used to determine the heating design capacity for scalable sizing. None is used when a heating coil is not included in the Zone HVAC Equipment or this field may be blank. If this input field is left blank, then the design heating capacity is set to zero. HeatingDesignCapacity => selected when the design heating capacity value is specified or auto-sized. CapacityPerFloorArea => selected when the design cooling capacity is determine from user specified heating capacity per flow area and zone floor area. FractionOfAutosizedHeatingCapacity => is selected when the design heating capacity is determined from a user specified fraction and the auto-sized design heating capacity One of `CapacityPerFloorArea`, `FractionOfAutosizedHeatingCapacity`, `HeatingDesignCapacity`, `None`
`heating_design_capacity` Heating Design Capacity	number or `Autosize` W		Enter the design heating capacity. Required field when the heating design capacity method HeatingDesignCapacity.
`heating_design_capacity_per_floor_area` Heating Design Capacity Per Floor Area	number W/m2		Enter the heating design capacity per zone floor area. Required field when the heating design capacity method field is CapacityPerFloorArea. Range: ≥ 0
`fraction_of_autosized_heating_design_capacity` Fraction of Autosized Heating Design Capacity	number		Enter the fraction of auto-sized heating design capacity. Required field when capacity the heating design capacity method field is FractionOfAutosizedHeatingCapacity. Range: ≥ 0

Referenced by 11 object types

ZoneHVAC:EvaporativeCoolerUnit, ZoneHVAC:FourPipeFanCoil, ZoneHVAC:IdealLoadsAirSystem, ZoneHVAC:PackagedTerminalAirConditioner, ZoneHVAC:PackagedTerminalHeatPump, ZoneHVAC:TerminalUnit:VariableRefrigerantFlow, ZoneHVAC:UnitHeater, ZoneHVAC:UnitVentilator, ZoneHVAC:VentilatedSlab, ZoneHVAC:WaterToAirHeatPump, ZoneHVAC:WindowAirConditioner

OutputControl:Sizing:Style¶

from idfpy.models import OutputControlSizingStyle unique

Default style for the Sizing output files is comma -- this works well for importing into spreadsheet programs such as Excel™ but not so well for word processing programs -- there tab may be a better choice. Fixed puts spaces between the "columns"

Field	Type	Default	Details
`column_separator` Column Separator required	choice		One of `Comma`, `Fixed`, `Tab`

Sizing:Parameters¶

from idfpy.models import SizingParameters unique

Specifies global heating and cooling sizing factors/ratios. These ratios are applied at the zone level to all of the zone heating and cooling loads and air flow rates. Then these new loads and air flow rates are used to calculate the system level flow rates and capacities and are used in all component sizing calculations. Specifies the width (in load timesteps) of a moving average window which is used to smooth the peak load across more than one timestep.

Field	Type	Default	Details
`heating_sizing_factor` Heating Sizing Factor	number	`1.0`	Range: > 0
`cooling_sizing_factor` Cooling Sizing Factor	number	`1.0`	Range: > 0
`timesteps_in_averaging_window` Timesteps in Averaging Window	integer		blank => set the timesteps in averaging window to Number of Timesteps per Hour resulting in a 1 hour averaging window default is number of timesteps for 1 hour averaging window If the PerformancePrecisionTradeoffs Override Mode is set to non-Normal, this field will be overwritten to 1 Range: ≥ 1

Sizing:Plant¶

from idfpy.models import SizingPlant

Specifies the input needed to autosize plant loop flow rates and equipment capacities. This information is initially used by components that use water for heating or cooling such as hot or chilled water coils to calculate their maximum water flow rates. These flow rates are then summed for use in calculating the Plant Loop flow rates.

Field	Type	Default	Details
`plant_or_condenser_loop_name` Plant or Condenser Loop Name required	reference		Enter the name of a PlantLoop or a CondenserLoop object Names a CondenserLoop, PlantLoop
`loop_type` Loop Type required	choice		One of `Condenser`, `Cooling`, `Heating`, `Steam`
`design_loop_exit_temperature` Design Loop Exit Temperature required	number C
`loop_design_temperature_difference` Loop Design Temperature Difference required	number deltaC		Range: > 0
`sizing_option` Sizing Option	choice	`NonCoincident`	if Coincident is chosen, then sizing is based on HVAC Sizing Simulations and the input field called Do HVAC Sizing Simulation for Sizing Periods in SimulationControl must be set to Yes One of `Coincident`, `NonCoincident`
`zone_timesteps_in_averaging_window` Zone Timesteps in Averaging Window	integer	`1`	this is used in the coincident sizing algorithm to apply a running average to peak flow rates that occur during HVAC Sizing Simulations Range: ≥ 1
`coincident_sizing_factor_mode` Coincident Sizing Factor Mode	choice		this is used to adjust the result for coincident sizing by applying a sizing factor One of `GlobalCoolingSizingFactor`, `GlobalHeatingSizingFactor`, `LoopComponentSizingFactor`, `None`

Sizing:System¶

from idfpy.models import SizingSystem

Specifies the input needed to perform sizing calculations for a central forced air system. System design air flow, heating capacity, and cooling capacity will be calculated using this input data.

Field	Type	Default	Details
`airloop_name` AirLoop Name required	reference		Names a AirLoopHVAC
`type_of_load_to_size_on` Type of Load to Size On	choice	`Sensible`	Specifies the basis for sizing the system supply air flow rate Sensible and Total use the zone design air flow rates to size the system supply air flow rate The cooling coil will then be sized at either the peak Sensible or Total flow rate and conditions The heating coil is always sized at the peak sensible heating load. Latent uses the larger of the zone sensible and latent design air flow rates for system sizing. VentilationRequirement uses the system ventilation requirement One of `Latent`, `Sensible`, `Total`, `VentilationRequirement`
`design_outdoor_air_flow_rate` Design Outdoor Air Flow Rate	number or `Autosize` m3/s	`Autosize`
`central_heating_maximum_system_air_flow_ratio` Central Heating Maximum System Air Flow Ratio	number or `Autosize`	`Autosize`
`preheat_design_temperature` Preheat Design Temperature required	number C
`preheat_design_humidity_ratio` Preheat Design Humidity Ratio required	number kgWater/kgDryAir
`precool_design_temperature` Precool Design Temperature required	number C
`precool_design_humidity_ratio` Precool Design Humidity Ratio required	number kgWater/kgDryAir
`central_cooling_design_supply_air_temperature` Central Cooling Design Supply Air Temperature required	number C
`central_heating_design_supply_air_temperature` Central Heating Design Supply Air Temperature required	number C
`type_of_zone_sum_to_use` Type of Zone Sum to Use	choice	`NonCoincident`	One of `Coincident`, `NonCoincident`
`n100_outdoor_air_in_cooling` 100% Outdoor Air in Cooling	choice	`No`	One of `No`, `Yes`
`n100_outdoor_air_in_heating` 100% Outdoor Air in Heating	choice	`No`	One of `No`, `Yes`
`central_cooling_design_supply_air_humidity_ratio` Central Cooling Design Supply Air Humidity Ratio	number kgWater/kgDryAir	`0.008`
`central_heating_design_supply_air_humidity_ratio` Central Heating Design Supply Air Humidity Ratio	number kgWater/kgDryAir	`0.008`
`cooling_supply_air_flow_rate_method` Cooling Supply Air Flow Rate Method	choice	`DesignDay`	One of `DesignDay`, `Flow/System`, `FlowPerCoolingCapacity`, `FlowPerFloorArea`, `FractionOfAutosizedCoolingAirflow`
`cooling_supply_air_flow_rate` Cooling Supply Air Flow Rate	number m3/s	`0.0`	This input is used if Cooling Supply Air Flow Rate Method is Flow/System This value will not be multiplied by any sizing factor or by zone multipliers. If using zone multipliers, this value must be large enough to serve the multiplied zones. Range: ≥ 0
`cooling_supply_air_flow_rate_per_floor_area` Cooling Supply Air Flow Rate Per Floor Area	number m3/s-m2		Enter the cooling supply air volume flow rate per total conditioned floor area. Required field when Cooling Supply Air Flow Rate Method is FlowPerFloorArea. Range: ≥ 0
`cooling_fraction_of_autosized_cooling_supply_air_flow_rate` Cooling Fraction of Autosized Cooling Supply Air Flow Rate	number		Enter the supply air volume flow rate as a fraction of the cooling supply air flow rate. Required field when Cooling Supply Air Flow Rate Method is FractionOfAutosizedCoolingAirflow. Range: ≥ 0
`cooling_supply_air_flow_rate_per_unit_cooling_capacity` Cooling Supply Air Flow Rate Per Unit Cooling Capacity	number m3/s-W		Enter the supply air volume flow rate per unit cooling capacity. Required field when Cooling Supply Air Flow Rate Method is FlowPerCoolingCapacity. Range: ≥ 0
`heating_supply_air_flow_rate_method` Heating Supply Air Flow Rate Method	choice	`DesignDay`	One of `DesignDay`, `Flow/System`, `FlowPerFloorArea`, `FlowPerHeatingCapacity`, `FractionOfAutosizedCoolingAirflow`, `FractionOfAutosizedHeatingAirflow`
`heating_supply_air_flow_rate` Heating Supply Air Flow Rate	number m3/s	`0.0`	Required field when Heating Supply Air Flow Rate Method is Flow/System This value will not be multiplied by any sizing factor or by zone multipliers. If using zone multipliers, this value must be large enough to serve the multiplied zones. Range: ≥ 0
`heating_supply_air_flow_rate_per_floor_area` Heating Supply Air Flow Rate Per Floor Area	number m3/s-m2		Enter the heating supply air volume flow rate per total conditioned floor area. Required field when Heating Supply Air Flow Rate Method is FlowPerFloorArea. Range: ≥ 0
`heating_fraction_of_autosized_heating_supply_air_flow_rate` Heating Fraction of Autosized Heating Supply Air Flow Rate	number		Enter the supply air volume flow rate as a fraction of the heating supply air flow rate. Required field when Heating Supply Air Flow Rate Method is FractionOfAutosizedHeatingAirflow. Range: ≥ 0
`heating_fraction_of_autosized_cooling_supply_air_flow_rate` Heating Fraction of Autosized Cooling Supply Air Flow Rate	number		Enter the supply air volume flow rate as a fraction of the cooling supply air flow rate. Required field when Heating Supply Air Flow Rate Method is FractionOfAutosizedCoolingAirflow. Range: ≥ 0
`heating_supply_air_flow_rate_per_unit_heating_capacity` Heating Supply Air Flow Rate Per Unit Heating Capacity	number m3/s-W		Enter the heating supply air volume flow rate per unit heating capacity. Required field when Heating Supply Air Flow Rate Method is FlowPerHeatingCapacity. Range: ≥ 0
`system_outdoor_air_method` System Outdoor Air Method	choice	`ZoneSum`	One of `Standard62.1SimplifiedProcedure`, `Standard62.1VentilationRateProcedure`, `ZoneSum`
`zone_maximum_outdoor_air_fraction` Zone Maximum Outdoor Air Fraction	number dimensionless	`1.0`	Range: > 0
`cooling_design_capacity_method` Cooling Design Capacity Method	choice	`CoolingDesignCapacity`	Enter the method used to determine the system cooling design capacity for scalable sizing. None is used when a cooling coils is not included in an airloop or this field may be blank. If this input field is left blank, then the design cooling capacity is set to zero. CoolingDesignCapacity => selected when the design cooling capacity value is specified or auto-sized. CapacityPerFloorArea => selected when the design cooling capacity is determined from user specified cooling capacity per floor area and total floor area of cooled zones served by an airloop. FractionOfAutosizedCoolingCapacity => is selected when the design cooling capacity is determined from a user specified fraction and the auto-sized design cooling capacity of the system. One of `CapacityPerFloorArea`, `CoolingDesignCapacity`, `FractionOfAutosizedCoolingCapacity`, `None`
`cooling_design_capacity` Cooling Design Capacity	number or `Autosize` W	`Autosize`	Enter the design cooling capacity.
`cooling_design_capacity_per_floor_area` Cooling Design Capacity Per Floor Area	number W/m2		Enter the cooling design capacity per total floor area of cooled zones served by an airloop. Required field when the cooling design capacity method field is CapacityPerFloorArea. Range: ≥ 0
`fraction_of_autosized_cooling_design_capacity` Fraction of Autosized Cooling Design Capacity	number		Enter the fraction of auto-sized cooling design capacity. Required field when the cooling design capacity method field is FractionOfAutosizedCoolingCapacity. Range: ≥ 0
`heating_design_capacity_method` Heating Design Capacity Method	choice	`HeatingDesignCapacity`	Enter the method used to determine the heating design capacity for scalable sizing. None is used when a heating coil not included in an airloop or this field may be blank. If this input field is left blank, then the design heating capacity is set to zero. HeatingDesignCapacity => selected when the design heating capacity value is specified or auto-sized. CapacityPerFloorArea => selected when the design heating capacity is determined from user specified heating capacity per flow area and total floor area of heated zones served by an airloop. FractionOfAutosizedHeatingCapacity => is selected when the design heating capacity is determined from a user specified fraction and the auto-sized design heating capacity of the system. One of `CapacityPerFloorArea`, `FractionOfAutosizedHeatingCapacity`, `HeatingDesignCapacity`, `None`
`heating_design_capacity` Heating Design Capacity	number or `Autosize` W	`Autosize`	Enter the design heating capacity.
`heating_design_capacity_per_floor_area` Heating Design Capacity Per Floor Area	number W/m2		Enter the heating design capacity per zone floor area. Required field when the heating design capacity method field is CapacityPerFloorArea. Range: ≥ 0
`fraction_of_autosized_heating_design_capacity` Fraction of Autosized Heating Design Capacity	number		Enter the fraction of auto-sized heating design capacity. Required field when capacity the heating design capacity method field is FractionOfAutosizedHeatingCapacity. Range: ≥ 0
`central_cooling_capacity_control_method` Central Cooling Capacity Control Method	choice	`OnOff`	Method used to control the coil's output One of `Bypass`, `OnOff`, `VAV`, `VT`
`occupant_diversity` Occupant Diversity	number or `Autosize`	`Autosize`	The Occupant Diversity is used to determine a multi-zone system's outdoor air intake when the System Outdoor Air Method is Standard62.1VentilationRateProcedure or the Standard62.1SimplifiedProcedure. If set to be autosized, it will be calculated using the information in the People objects assigned to each zone attached to this system/airloop.
`heating_coil_sizing_method` Heating Coil Sizing Method	choice	`None`	Size a heat pump heating coil using the Cooling, Heating or GreaterOfHeatingOrCooling capacities One of `CoolingCapacity`, `GreaterOfHeatingOrCooling`, `HeatingCapacity`, `None`
`maximum_heating_capacity_to_cooling_capacity_sizing_ratio` Maximum Heating Capacity To Cooling Capacity Sizing Ratio	number W/W	`1.0`	The limit of heating coil capacity to cooling coil capacity Range: ≥ 1

Sizing:Zone¶

from idfpy.models import SizingZone

Specifies the data needed to perform a zone design air flow calculation. The calculation is done for every sizing period included in the input. The maximum cooling and heating load and cooling, heating, and ventilation air flows are then saved for system level and zone component design calculations.

Field	Type	Default	Details
`zone_or_zonelist_name` Zone or ZoneList Name required	reference		Names a Zone, ZoneList
`zone_cooling_design_supply_air_temperature_input_method` Zone Cooling Design Supply Air Temperature Input Method	choice	`SupplyAirTemperature`	One of `SupplyAirTemperature`, `TemperatureDifference`
`zone_cooling_design_supply_air_temperature` Zone Cooling Design Supply Air Temperature	number C		Zone Cooling Design Supply Air Temperature is only used when Zone Cooling Design Supply Air Temperature Input Method = SupplyAirTemperature
`zone_cooling_design_supply_air_temperature_difference` Zone Cooling Design Supply Air Temperature Difference	number deltaC		Zone Cooling Design Supply Air Temperature is only used when Zone Cooling Design Supply Air Temperature Input Method = TemperatureDifference The absolute value of this field will be subtracted from the zone temperature at peak load to calculate the Zone Cooling Design Supply Air Temperature.
`zone_heating_design_supply_air_temperature_input_method` Zone Heating Design Supply Air Temperature Input Method	choice	`SupplyAirTemperature`	One of `SupplyAirTemperature`, `TemperatureDifference`
`zone_heating_design_supply_air_temperature` Zone Heating Design Supply Air Temperature	number C		Zone Heating Design Supply Air Temperature is only used when Zone Heating Design Supply Air Temperature Input Method = SupplyAirTemperature
`zone_heating_design_supply_air_temperature_difference` Zone Heating Design Supply Air Temperature Difference	number deltaC		Zone Heating Design Supply Air Temperature is only used when Zone Heating Design Supply Air Temperature Input Method = TemperatureDifference The absolute value of this field will be added to the zone temperature at peak load to calculate the Zone Heating Design Supply Air Temperature.
`zone_cooling_design_supply_air_humidity_ratio` Zone Cooling Design Supply Air Humidity Ratio required	number kgWater/kgDryAir		Range: ≥ 0
`zone_heating_design_supply_air_humidity_ratio` Zone Heating Design Supply Air Humidity Ratio required	number kgWater/kgDryAir		Range: ≥ 0
`design_specification_outdoor_air_object_name` Design Specification Outdoor Air Object Name	reference		Specify the name of a DesignSpecification:OutdoorAir object to specify one set of requirements for the Zone. Use a DesignSpecification:OutdoorAir:SpaceList object name to specify different requirements for Spaces within the Zone. Names a DesignSpecification:OutdoorAir, DesignSpecification:OutdoorAir:SpaceList
`zone_heating_sizing_factor` Zone Heating Sizing Factor	number		if blank or zero, global heating sizing factor from Sizing:Parameters is used. Range: ≥ 0
`zone_cooling_sizing_factor` Zone Cooling Sizing Factor	number		if blank or zero, global cooling sizing factor from Sizing:Parameters is used. Range: ≥ 0
`cooling_design_air_flow_method` Cooling Design Air Flow Method	choice	`DesignDay`	One of `DesignDay`, `DesignDayWithLimit`, `Flow/Zone`
`cooling_design_air_flow_rate` Cooling Design Air Flow Rate	number m3/s	`0.0`	This input is used if Cooling Design Air Flow Method is Flow/Zone This value will be multiplied by the global or zone sizing factor and by zone multipliers. Range: ≥ 0
`cooling_minimum_air_flow_per_zone_floor_area` Cooling Minimum Air Flow per Zone Floor Area	number m3/s-m2	`0.000762`	default is .15 cfm/ft2 This input is used if Cooling Design Air Flow Method is DesignDayWithLimit Range: ≥ 0
`cooling_minimum_air_flow` Cooling Minimum Air Flow	number m3/s	`0.0`	This input is used if Cooling Design Air Flow Method is DesignDayWithLimit Range: ≥ 0
`cooling_minimum_air_flow_fraction` Cooling Minimum Air Flow Fraction	number	`0.2`	fraction of the Cooling design Air Flow Rate This input is currently used in sizing the VAV air terminal unit and fan minimum flow rate It does not currently affect other component autosizing. Range: ≥ 0
`heating_design_air_flow_method` Heating Design Air Flow Method	choice	`DesignDay`	One of `DesignDay`, `DesignDayWithLimit`, `Flow/Zone`
`heating_design_air_flow_rate` Heating Design Air Flow Rate	number m3/s	`0.0`	This input is used if Heating Design Air Flow Method is Flow/Zone. This value will be multiplied by the global or zone sizing factor and by zone multipliers. Range: ≥ 0
`heating_maximum_air_flow_per_zone_floor_area` Heating Maximum Air Flow per Zone Floor Area	number m3/s-m2	`0.002032`	default is .40 cfm/ft2 This field is used to size the heating design flow rate when Heating Design Air Flow Method = Flow/Zone. This input is used for autosizing components when Heating Design Air Flow Method = DesignDayWithLimit. Range: ≥ 0
`heating_maximum_air_flow` Heating Maximum Air Flow	number m3/s	`0.1415762`	default is 300 cfm This input is used for autosizing components when Heating Design Air Flow Method = DesignDayWithLimit. Range: ≥ 0
`heating_maximum_air_flow_fraction` Heating Maximum Air Flow Fraction	number	`0.3`	fraction of the Heating Design Air Flow Rate This input is used for autosizing components when Heating Design Air Flow Method = DesignDayWithLimit. Range: ≥ 0
`design_specification_zone_air_distribution_object_name` Design Specification Zone Air Distribution Object Name	reference		Names a DesignSpecification:ZoneAirDistribution
`account_for_dedicated_outdoor_air_system` Account for Dedicated Outdoor Air System	choice	`No`	account for effect of dedicated outdoor air system supplying air directly to the zone One of `No`, `Yes`
`dedicated_outdoor_air_system_control_strategy` Dedicated Outdoor Air System Control Strategy	choice	`NeutralSupplyAir`	1)supply neutral ventilation air; 2)supply neutral dehumidified and reheated ventilation air; 3)supply cold ventilation air One of `ColdSupplyAir`, `NeutralDehumidifiedSupplyAir`, `NeutralSupplyAir`
`dedicated_outdoor_air_low_setpoint_temperature_for_design` Dedicated Outdoor Air Low Setpoint Temperature for Design	number or `Autosize` C	`Autosize`
`dedicated_outdoor_air_high_setpoint_temperature_for_design` Dedicated Outdoor Air High Setpoint Temperature for Design	number or `Autosize` C	`Autosize`
`zone_load_sizing_method` Zone Load Sizing Method	choice	`Sensible Load Only No Latent Load`	Specifies the basis for sizing the zone supply air flow rate. Zone latent loads will not be used during sizing only when Zone Load Sizing Method = Sensible Load Only No Latent Load. For this case the zone humidity level will float according to the fields Cooling and Heating Design Supply Air Humidity Ratio. For all other choices the zone humidity level will be controlled. Sensible Load will use zone sensible air flow rate for zone component sizing. Latent loads will also be reported during sizing. Latent Load will use zone latent air flow rate for zone component sizing. Sensible loads will also be reported during sizing. Sensible and Latent Load will use the larger of sensible and latent load to choose air flow rate for zone component sizing. Sensible Load Only No Latent Load or leaving this field blank will disable zone latent sizing and reporting. Latent loads will not be reported during sizing (reported as 0's). One of `Latent Load`, `Sensible And Latent Load`, `Sensible Load`, `Sensible Load Only No Latent Load`
`zone_latent_cooling_design_supply_air_humidity_ratio_input_method` Zone Latent Cooling Design Supply Air Humidity Ratio Input Method	choice	`HumidityRatioDifference`	Use SupplyAirHumidityRatio to enter the humidity ratio when zone dehumidification is required. The supply air humidity ratio should be less than the zone humidity ratio at the zone thermostat and humidistat set point condition. Use HumidityRatioDifference to enter the difference in humidity ratio from the zone thermostat and humidistat set point condition. One of `HumidityRatioDifference`, `SupplyAirHumidityRatio`
`zone_dehumidification_design_supply_air_humidity_ratio` Zone Dehumidification Design Supply Air Humidity Ratio	number kgWater/kgDryAir		Zone Dehumidification Design Supply Air Humidity Ratio is only used when Zone Latent Cooling Design Supply Air Humidity Ratio Input Method = SupplyAirHumidityRatio. This input must be less than the zone humidity ratio at the humidistat set point so that dehumidification can occur. Range: > 0
`zone_cooling_design_supply_air_humidity_ratio_difference` Zone Cooling Design Supply Air Humidity Ratio Difference	number kgWater/kgDryAir	`0.005`	Zone Dehumidification Design Supply Air Humidity Ratio Difference is only used when Zone Latent Cooling Design Supply Air Humidity Ratio Input Method = HumidityRatioDifference. This input is a positive value and defines the difference between the zone humidity ratio at the thermostat and humidistat set point condition and the supply air humidity ratio entering the zone. Range: > 0
`zone_latent_heating_design_supply_air_humidity_ratio_input_method` Zone Latent Heating Design Supply Air Humidity Ratio Input Method	choice	`HumidityRatioDifference`	Use SupplyAirHumidityRatio to enter the humidity ratio when zone humidification is required. The supply air humidity ratio should be greater than the zone humidity ratio at the zone thermostat and humidistat set point condition. Use HumidityRatioDifference to enter the difference in humidity ratio from the zone thermostat and humidistat set point condition. One of `HumidityRatioDifference`, `SupplyAirHumidityRatio`
`zone_humidification_design_supply_air_humidity_ratio` Zone Humidification Design Supply Air Humidity Ratio	number kgWater/kgDryAir		Zone Humidification Design Supply Air Humidity Ratio is only used when Zone Latent Heating Design Supply Air Humidity Ratio Input Method = SupplyAirHumidityRatio. This input must be greater than the zone humidity ratio at the humidistat set point so that humidification can occur. Range: > 0
`zone_humidification_design_supply_air_humidity_ratio_difference` Zone Humidification Design Supply Air Humidity Ratio Difference	number kgWater/kgDryAir	`0.005`	Zone Humidification Design Supply Air Humidity Ratio is only used when Zone Latent Heating Design Supply Air Humidity Ratio Input Method = HumidityRatioDifference. This input is a positive value and defines the difference between the zone humidity ratio at the thermostat and humidistat set point condition and the supply air humidity ratio entering the zone. Range: ≥ 0
`zone_humidistat_dehumidification_set_point_schedule_name` Zone Humidistat Dehumidification Set Point Schedule Name	reference		Enter the zone relative humidity schedule used for zone latent cooling calculations. A zone humidistat will take priority over this input. This field is not used if Zone Load Sizing Method = Sensible Load Only No Latent Load or a zone humidistat is present. A default of 50.0 will be used if no schedule is provided and no humidistat is associated with this zone. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
`zone_humidistat_humidification_set_point_schedule_name` Zone Humidistat Humidification Set Point Schedule Name	reference		Enter the zone relative humidity schedule used for zone latent heating calculations. A zone humidistat will take priority over this input. This field is not used if Zone Load Sizing Method = Sensible Load Only No Latent Load or a zone humidistat is present. A default of 50.0 will be used if no schedule is provided and no humidistat is associated with this zone. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules
`type_of_space_sum_to_use` Type of Space Sum to Use	choice	`Coincident`	NonCoincident is available only if Do Space Heat Balance for Sizing=Yes in ZoneAirHeatBalanceAlgorithm. One of `Coincident`, `NonCoincident`
`heating_coil_sizing_method` Heating Coil Sizing Method	choice	`None`	One of `CoolingCapacity`, `GreaterOfHeatingOrCooling`, `HeatingCapacity`, `None`
`maximum_heating_capacity_to_cooling_load_sizing_ratio` Maximum Heating Capacity To Cooling Load Sizing Ratio	number W/W	`1.0`	Range: ≥ 1