Room Air Models¶
17 object types from idfpy.models.room_air · EnergyPlus 26.2
| Object | Summary |
|---|---|
| RoomAir:Node | Define an air node for some types of nodal room air models |
| RoomAir:Node:AirflowNetwork | define an air node for some types of nodal air models |
| RoomAir:Node:AirflowNetwork:AdjacentSurfaceList | |
| RoomAir:Node:AirflowNetwork:HVACEquipment | define the zone equipment associated with one particular RoomAir:Node |
| RoomAir:Node:AirflowNetwork:InternalGains | define the internal gains that are associated with one particular RoomAir:Node |
| RoomAir:TemperaturePattern:ConstantGradient | Used to model room air with a fixed temperature gradient in the vertical direction. |
| RoomAir:TemperaturePattern:NondimensionalHeight | Defines a distribution pattern for air temperatures relative to the current mean air temperature as a … |
| RoomAir:TemperaturePattern:SurfaceMapping | Defines a distribution pattern for the air temperatures adjacent to individual surfaces. |
| RoomAir:TemperaturePattern:TwoGradient | Used to model room air with two temperature gradients in the vertical direction. |
| RoomAir:TemperaturePattern:UserDefined | Used to explicitly define temperature patterns that are to be applied to the mean air temperature within a … |
| RoomAirModelType | Selects the type of room air model to be used in a given zone. |
| RoomAirSettings:AirflowNetwork | RoomAir modeling using Airflow pressure network solver |
| RoomAirSettings:CrossVentilation | This UCSD Cross Ventilation Room Air Model provides a simple model for heat transfer and vertical temperature … |
| RoomAirSettings:OneNodeDisplacementVentilation | The Mundt model for displacement ventilation |
| RoomAirSettings:ThreeNodeDisplacementVentilation | The UCSD model for Displacement Ventilation |
| RoomAirSettings:UnderFloorAirDistributionExterior | Applicable to exterior spaces that are served by an underfloor air distribution system. |
| RoomAirSettings:UnderFloorAirDistributionInterior | This Room Air Model is applicable to interior spaces that are served by an underfloor air distribution system. |
RoomAir:Node¶
from idfpy.models import RoomAirNode
Define an air node for some types of nodal room air models
Referenced by 2 object types
ElectricEquipment:ITE:AirCooled, ElectricEquipment:ITE:AirCooled:Instance
RoomAir:Node:AirflowNetwork¶
from idfpy.models import RoomAirNodeAirflowNetwork
define an air node for some types of nodal air models
| Field | Type | Default | Details |
|---|---|---|---|
nameName |
string | ||
zone_Zone Name required |
reference | Names a Zone | |
fraction_Fraction of Zone Air Volume |
number | Range: ≥ 0, ≤ 1 | |
roomair_RoomAir:Node:AirflowNetwork:AdjacentSurfaceList Name |
reference | Names a RoomAir:Node:AirflowNetwork:AdjacentSurfaceList | |
roomair_RoomAir:Node:AirflowNetwork:InternalGains Name |
reference | Names a RoomAir:Node:AirflowNetwork:InternalGains | |
roomair_RoomAir:Node:AirflowNetwork:HVACEquipment Name |
reference | Names a RoomAir:Node:AirflowNetwork:HVACEquipment |
Referenced by 2 object types
AirflowNetwork:IntraZone:Node, RoomAirSettings:AirflowNetwork
RoomAir:Node:AirflowNetwork:AdjacentSurfaceList¶
from idfpy.models import RoomAirNodeAirflowNetworkAdjacentSurfaceList extensible
| Field | Type | Default | Details |
|---|---|---|---|
nameName |
string | ||
surfaces |
list | Each item: surface_name |
Referenced by 1 object types
RoomAir:Node:AirflowNetwork:HVACEquipment¶
from idfpy.models import RoomAirNodeAirflowNetworkHVACEquipment extensible
define the zone equipment associated with one particular RoomAir:Node
| Field | Type | Default | Details |
|---|---|---|---|
nameName |
string | ||
equipment_ |
list | Each item: zonehvac_or_air_terminal_equipment_object_type, zonehvac_or_air_terminal_equipment_object_name, fraction_of_output_or_supply_air_from_hvac_equipment, fraction_of_input_or_return_air_to_hvac_equipment |
Referenced by 1 object types
RoomAir:Node:AirflowNetwork:InternalGains¶
from idfpy.models import RoomAirNodeAirflowNetworkInternalGains extensible
define the internal gains that are associated with one particular RoomAir:Node
| Field | Type | Default | Details |
|---|---|---|---|
nameName |
string | ||
gains |
list | Each item: internal_gain_object_type, internal_gain_object_name, fraction_of_gains_to_node |
Referenced by 1 object types
RoomAir:TemperaturePattern:ConstantGradient¶
from idfpy.models import RoomAirTemperaturePatternConstantGradient
Used to model room air with a fixed temperature gradient in the vertical direction. Used in combination with RoomAir:TemperaturePattern:UserDefined.
| Field | Type | Default | Details |
|---|---|---|---|
room_Room Air Temperature Pattern Constant Gradient Name required |
string | ||
control_Control Integer for Pattern Control Schedule Name required |
integer | reference this entry in Schedule Name | |
thermostat_Thermostat Offset |
number deltaC |
= (Temp at thermostat- Mean Air Temp) | |
return_Return Air Offset |
number deltaC |
= (Tleaving - Mean Air Temp ) | |
exhaust_Exhaust Air Offset |
number deltaC |
= (Texhaust - Mean Air Temp) deg C | |
temperature_Temperature Gradient |
number K/m |
Slope of temperature change in vertical direction |
RoomAir:TemperaturePattern:NondimensionalHeight¶
from idfpy.models import RoomAirTemperaturePatternNondimensionalHeight extensible
Defines a distribution pattern for air temperatures relative to the current mean air temperature as a function of height. The height, referred to as Zeta, is nondimensional by normalizing with the zone ceiling height. Used in combination with RoomAir:TemperaturePattern:UserDefined.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
control_Control Integer for Pattern Control Schedule Name required |
integer | this value should appear in as a schedule value | |
thermostat_Thermostat Offset |
number deltaC |
= (Temp at thermostat- Mean Air Temp) | |
return_Return Air Offset |
number deltaC |
= (Temp leaving - Mean Air Temp ) deg C | |
exhaust_Exhaust Air Offset |
number deltaC |
= (Temp exhaust - Mean Air Temp) deg C the remaining fields have pairs that describe the relative temperature pattern in the vertical direction of a zone Zeta is the nondimensional height (in z-direction). on [0..1] DeltaTai = (Tai - MAT) in units of deg. C relative deg C on [-10.0 .. 20.0 ] | |
pairs |
list | Each item: pair_zeta_nondimensional_height, pair_delta_adjacent_air_temperature (deltaC) |
RoomAir:TemperaturePattern:SurfaceMapping¶
from idfpy.models import RoomAirTemperaturePatternSurfaceMapping extensible
Defines a distribution pattern for the air temperatures adjacent to individual surfaces. This allows controlling the adjacent air temperature on a surface-by-surface basis rather than by height. This allows modeling different adjacent air temperatures on the opposite sides of the zone. Used in combination with RoomAir:TemperaturePattern:UserDefined.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
control_Control Integer for Pattern Control Schedule Name required |
integer | reference this entry in schedule | |
thermostat_Thermostat Offset |
number deltaC |
= (Temp at thermostat- Mean Air Temp) | |
return_Return Air Offset |
number deltaC |
= (Tleaving - Mean Air Temp ) deg C | |
exhaust_Exhaust Air Offset |
number deltaC |
= (Texhaust - Mean Air Temp) deg C | |
surface_ |
list | Each item: surface_name_pair, delta_adjacent_air_temperature_pair (deltaC) |
RoomAir:TemperaturePattern:TwoGradient¶
from idfpy.models import RoomAirTemperaturePatternTwoGradient
Used to model room air with two temperature gradients in the vertical direction. Used in combination with RoomAir:TemperaturePattern:UserDefined.
| Field | Type | Default | Details |
|---|---|---|---|
room_Room Air Temperature Pattern Two Gradient Name required |
string | ||
control_Control Integer for Pattern Control Schedule Name required |
integer | reference this entry in Schedule Name | |
thermostat_Thermostat Height |
number m |
= Distance from floor of zone | |
return_Return Air Height |
number m |
= Distance from floor of zone | |
exhaust_Exhaust Air Height |
number m |
= Distance from floor of zone | |
temperature_Temperature Gradient Lower Bound |
number K/m |
Slope of temperature change in vertical direction | |
temperature_Temperature Gradient Upper Bound |
number K/m |
Slope of temperature change in vertical direction | |
gradient_Gradient Interpolation Mode |
choice | One of OutdoorDryBulbTemperature, SensibleCoolingLoad, SensibleHeatingLoad, ZoneAndOutdoorTemperatureDifference, ZoneDryBulbTemperature |
|
upper_Upper Temperature Bound |
number C |
||
lower_Lower Temperature Bound |
number C |
||
upper_Upper Heat Rate Bound |
number W |
||
lower_Lower Heat Rate Bound |
number W |
RoomAir:TemperaturePattern:UserDefined¶
from idfpy.models import RoomAirTemperaturePatternUserDefined
Used to explicitly define temperature patterns that are to be applied to the mean air temperature within a thermal zone. Used with RoomAirModelType = UserDefined.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone Name required |
reference | Names a Zone | |
availability_Availability Schedule Name |
reference | Availability schedule name for this model. Schedule value > 0 means the model is active. Schedule value = 0 means the model is inactive and the zone will be modeled as fully mixed (Mixing). If this field is blank, the model is always active. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
pattern_Pattern Control Schedule Name required |
reference | The schedule should contain integer values that correspond to unique Control Integer fields in one of the RoomAir:TemperaturePattern:* objects. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
RoomAirModelType¶
from idfpy.models import RoomAirModelType
Selects the type of room air model to be used in a given zone. If no RoomAirModelType object is specified then the default Mixing model (all zone air at the same temperature) will be used.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone Name required |
reference | Names a Zone | |
room_Room-Air Modeling Type |
choice | Mixing |
Mixing = Complete mixing air model UserDefined = UserDefined Room Air Temperature Patterns needs RoomAir:TemperaturePattern:UserDefined object referencing this Zone OneNodeDisplacementVentilation = Mundt roomair model for displacement ventilation with single floor air node needs RoomAirSettings:OneNodeDisplacementVentilation object referencing this Zone ThreeNodeDisplacementVentilation = RoomAir modeling using UCSD three-node displacement ventilation model needs RoomAirSettings:ThreeNodeDisplacementVentilation object referencing this Zone CrossVentilation = RoomAir modeling using UCSD two-zone cross ventilation model needs RoomAirSettings:CrossVentilation object referencing this Zone UnderFloorAirDistributionInterior = 2-Node UFAD model for interior zones needs RoomAirSettings:UnderFloorAirDistributionInterior object referencing this Zone UnderFloorAirDistributionExterior = RoomAir modeling using 2-Node UFAD model for exterior zones needs RoomAirSettings:UnderFloorAirDistributionExterior object referencing this Zone AirflowNetwork = RoomAir modeling using AirflowNetwork needs RoomAirSettings:AirflowNetwork object referencing this Zone One of AirflowNetwork, CrossVentilation, Mixing, OneNodeDisplacementVentilation, ThreeNodeDisplacementVentilation, UnderFloorAirDistributionExterior, UnderFloorAirDistributionInterior, UserDefined |
air_Air Temperature Coupling Strategy |
choice | Direct |
One of Direct, Indirect |
RoomAirSettings:AirflowNetwork¶
from idfpy.models import RoomAirSettingsAirflowNetwork extensible
RoomAir modeling using Airflow pressure network solver
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone Name required |
reference | Name of Zone being described. Any existing zone name Names a Zone |
|
control_Control Point RoomAirflowNetwork:Node Name |
reference | Names a RoomAir:Node:AirflowNetwork | |
nodes |
list | Each item: roomairflownetwork_node_name |
RoomAirSettings:CrossVentilation¶
from idfpy.models import RoomAirSettingsCrossVentilation
This UCSD Cross Ventilation Room Air Model provides a simple model for heat transfer and vertical temperature profile prediction in cross ventilated rooms. The model distinguishes two regions in the room, the main jet region and the recirculations, and predicts characteristic airflow velocities and average air temperatures. Used with RoomAirModelType = CrossVentilation.
| Field | Type | Default | Details |
|---|---|---|---|
zone_Zone Name required |
reference | Name of Zone being described. Any existing zone name Names a Zone |
|
gain_Gain Distribution Schedule Name required |
reference | Distribution of the convective heat gains between the jet and recirculation zones. 0<= Accepted Value <= 1. In the CV model 1 means all convective gains in the jet region. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
airflow_Airflow Region Used for Thermal Comfort Evaluation |
choice | Required field whenever thermal comfort is predicted defines Air temperature and Airflow velocity that will be used in the Fanger model conditions must refer to one of the two regions: jet or recirculation One of Jet, Recirculation |
RoomAirSettings:OneNodeDisplacementVentilation¶
from idfpy.models import RoomAirSettingsOneNodeDisplacementVentilation
The Mundt model for displacement ventilation
| Field | Type | Default | Details |
|---|---|---|---|
zone_Zone Name required |
reference | Names a Zone | |
fraction_Fraction of Convective Internal Loads Added to Floor Air |
number | Range: ≥ 0, ≤ 1 | |
fraction_Fraction of Infiltration Internal Loads Added to Floor Air |
number | Range: ≥ 0, ≤ 1 |
RoomAirSettings:ThreeNodeDisplacementVentilation¶
from idfpy.models import RoomAirSettingsThreeNodeDisplacementVentilation
The UCSD model for Displacement Ventilation
| Field | Type | Default | Details |
|---|---|---|---|
zone_Zone Name required |
reference | Name of Zone being described. Any existing zone name Names a Zone |
|
gain_Gain Distribution Schedule Name required |
reference | Distribution of the convective heat gains between the occupied and mixed zones. 0<= Accepted Value <= 1. In the DV model 1 means all convective gains in the lower layer. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
number_Number of Plumes per Occupant |
number | 1.0 |
Used only in the UCSD displacement ventilation model. Effective number of separate plumes per occupant in the occupied zone. Plumes that merge together in the occupied zone count as one. Range: > 0 |
thermostat_Thermostat Height |
number m |
1.1 |
Height of thermostat/temperature control sensor above floor Range: > 0 |
comfort_Comfort Height |
number m |
1.1 |
Height at which air temperature is calculated for comfort purposes Range: > 0 |
temperature_Temperature Difference Threshold for Reporting |
number deltaC |
0.4 |
Minimum temperature difference between predicted upper and lower layer temperatures above which DV auxiliary outputs are calculated. These outputs are 'DV Transition Height', 'DV Fraction Min Recommended Flow Rate' 'DV Average Temp Gradient' and 'DV Maximum Temp Gradient'. They are set to negative values when the temperature difference is less than the threshold and the output 'DV Zone Is Mixed' is set to 1 Range: ≥ 0 |
RoomAirSettings:UnderFloorAirDistributionExterior¶
from idfpy.models import RoomAirSettingsUnderFloorAirDistributionExterior
Applicable to exterior spaces that are served by an underfloor air distribution system. The dominant sources of heat gain should be from people, equipment, and other localized sources located in the occupied part of the room, as well as convective gain coming from a warm window. Used with RoomAirModelType = CrossVentilation.
| Field | Type | Default | Details |
|---|---|---|---|
zone_Zone Name required |
reference | Name of Zone being described. Any existing zone name Names a Zone |
|
number_Number of Diffusers per Zone |
number or Autocalculate |
Autocalculate |
|
power_Power per Plume |
number or AutocalculateW |
Autocalculate |
|
design_Design Effective Area of Diffuser |
number or Autocalculatem2 |
Autocalculate |
|
diffuser_Diffuser Slot Angle from Vertical |
number or Autocalculatedeg |
Autocalculate |
|
thermostat_Thermostat Height |
number m |
1.2 |
Height of thermostat/temperature control sensor above floor Range: > 0 |
comfort_Comfort Height |
number m |
1.1 |
Height at which Air temperature is calculated for comfort purposes Range: > 0 |
temperature_Temperature Difference Threshold for Reporting |
number deltaC |
0.4 |
Minimum temperature difference between upper and lower layer temperatures above which UFAD auxiliary outputs are calculated. These outputs are 'UF Transition Height' and 'UF Average Temp Gradient'. They are set to zero values when the temperature difference is less than the threshold and the output 'UF Zone Is Mixed' is set to 1 Range: ≥ 0 |
floor_Floor Diffuser Type |
choice | Swirl |
One of Custom, HorizontalSwirl, LinearBarGrille, Swirl, VariableArea |
transition_Transition Height |
number or Autocalculatem |
1.7 |
User-specified height above floor of boundary between occupied and upper subzones |
coefficient_Coefficient A in formula Kc = A*Gamma**B + C + D*Gamma + E*Gamma**2 |
number or Autocalculate |
Autocalculate |
Kc is the fraction of the total zone load attributable to the lower subzone |
coefficient_Coefficient B in formula Kc = A*Gamma**B + C + D*Gamma + E*Gamma**2 |
number or Autocalculate |
Autocalculate |
Kc is the fraction of the total zone load attributable to the lower subzone |
coefficient_Coefficient C in formula Kc = A*Gamma**B + C + D*Gamma + E*Gamma**2 |
number or Autocalculate |
Autocalculate |
Kc is the fraction of the total zone load attributable to the lower subzone |
coefficient_Coefficient D in formula Kc = A*Gamma**B + C + D*Gamma + E*Gamma**2 |
number or Autocalculate |
Autocalculate |
Kc is the fraction of the total zone load attributable to the lower subzone |
coefficient_Coefficient E in formula Kc = A*Gamma**B + C + D*Gamma + E*Gamma**2 |
number or Autocalculate |
Autocalculate |
Kc is the fraction of the total zone load attributable to the lower subzone |
RoomAirSettings:UnderFloorAirDistributionInterior¶
from idfpy.models import RoomAirSettingsUnderFloorAirDistributionInterior
This Room Air Model is applicable to interior spaces that are served by an underfloor air distribution system. The dominant sources of heat gain should be from people, equipment, and other localized sources located in the occupied part of the room. The model should be used with caution in zones which have large heat gains or losses through exterior walls or windows or which have considerable direct solar gain. Used with RoomAirModelType = UnderFloorAirDistributionInterior.
| Field | Type | Default | Details |
|---|---|---|---|
zone_Zone Name required |
reference | Name of Zone with underfloor air distribution Names a Zone |
|
number_Number of Diffusers |
number or Autocalculate |
Autocalculate |
Total number of diffusers in this zone |
power_Power per Plume |
number or AutocalculateW |
Autocalculate |
|
design_Design Effective Area of Diffuser |
number or Autocalculatem2 |
Autocalculate |
|
diffuser_Diffuser Slot Angle from Vertical |
number or Autocalculatedeg |
Autocalculate |
|
thermostat_Thermostat Height |
number m |
1.2 |
Height of thermostat/temperature control sensor above floor Range: > 0 |
comfort_Comfort Height |
number m |
1.1 |
Height at which air temperature is calculated for comfort purposes Range: > 0 |
temperature_Temperature Difference Threshold for Reporting |
number deltaC |
0.4 |
Minimum temperature difference between predicted upper and lower layer temperatures above which UFAD auxiliary outputs are calculated. These outputs are 'UF Transition Height' and 'UF Average Temp Gradient'. They are set to zero values when the temperature difference is less than the threshold and the output 'UF Zone Is Mixed' is set to 1 Range: ≥ 0 |
floor_Floor Diffuser Type |
choice | Swirl |
One of Custom, HorizontalSwirl, LinearBarGrille, Swirl, VariableArea |
transition_Transition Height |
number or Autocalculatem |
1.7 |
user-specified height above floor of boundary between occupied and upper subzones |
coefficient_Coefficient A |
number or Autocalculate |
Autocalculate |
Coefficient A in Formula Kc = A*Gamma**B + C + D*Gamma + E*Gamma**2 Kc is the fraction of the total zone load attributable to the lower subzone |
coefficient_Coefficient B |
number or Autocalculate |
Autocalculate |
Coefficient B in Formula Kc = A*Gamma**B + C + D*Gamma + E*Gamma**2 Kc is the fraction of the total zone load attributable to the lower subzone |
coefficient_Coefficient C |
number or Autocalculate |
Autocalculate |
Coefficient C in Formula Kc = A*Gamma**B + C + D*Gamma + E*Gamma**2 Kc is the fraction of the total zone load attributable to the lower subzone |
coefficient_Coefficient D |
number or Autocalculate |
Autocalculate |
Coefficient D in Formula Kc = A*Gamma**B + C + D*Gamma + E*Gamma**2 Kc is the fraction of the total zone load attributable to the lower subzone |
coefficient_Coefficient E |
number or Autocalculate |
Autocalculate |
Coefficient E in Formula Kc = A*Gamma**B + C + D*Gamma + E*Gamma**2 Kc is the fraction of the total zone load attributable to the lower subzone |