Internal Gains¶
36 object types from idfpy.models.internal_gains · EnergyPlus 26.2
| Object | Summary |
|---|---|
| ComfortViewFactorAngles | Used to specify radiant view factors for thermal comfort calculations. |
| ElectricEquipment | Sets internal gains for electric equipment in the zone. |
| ElectricEquipment:Definition | Defines the physical characteristics (design level and heat gain fractions) for electric equipment. |
| ElectricEquipment:ITE:AirCooled | This object describes air-cooled electric information technology equipment (ITE) which has variable power … |
| ElectricEquipment:ITE:AirCooled:Definition | Performance characteristics for ElectricEquipment:ITE:AirCooled:Instance. |
| ElectricEquipment:ITE:AirCooled:Instance | This object describes air-cooled electric information technology equipment (ITE) which has variable power … |
| ElectricEquipment:Instance | Sets internal gains for electric equipment in the zone. |
| GasEquipment | Sets internal gains and contaminant rates for gas equipment in the zone. |
| GasEquipment:Definition | Defines the physical characteristics (design level and heat gain fractions) for gas equipment. |
| GasEquipment:Instance | Sets internal gains and contaminant rates for gas equipment in the zone. |
| HotWaterEquipment | Sets internal gains for hot water equipment in the zone. |
| HotWaterEquipment:Definition | Defines the physical characteristics (design level and heat gain fractions) for hot water equipment. |
| HotWaterEquipment:Instance | Sets internal gains for hot water equipment in the zone. |
| IndoorLivingWall | Indoor greenery systems such as indoor living walls are panels of plants, which grow hydroponically or from … |
| Lights | Sets internal gains for lights in the zone. |
| Lights:Definition | Defines the physical characteristics (design level and heat gain fractions) for lights. |
| Lights:Instance | Sets internal gains for lights in the zone. |
| OtherEquipment | Sets internal gains or losses for "other" equipment in the zone. |
| OtherEquipment:Definition | Defines the physical characteristics (design level and heat gain fractions) for "other" equipment. |
| OtherEquipment:Instance | Sets internal gains or losses for "other" equipment in the zone. |
| People | Sets internal gains and contaminant rates for occupants in the zone. |
| People:Definition | Defines the physical characteristics (number of people, heat gain fractions, CO2 generation rate and thermal … |
| People:Instance | Sets internal gains and contaminant rates for occupants in the zone. |
| SteamEquipment | Sets internal gains for steam equipment in the zone. |
| SteamEquipment:Definition | Defines the physical characteristics (design level and heat gain fractions) for steam equipment. |
| SteamEquipment:Instance | Sets internal gains for steam equipment in the zone. |
| SurfaceContaminantSourceAndSink:Generic:BoundaryLayerDiffusion | Simulate generic contaminant source driven by the boundary layer diffusion controlled model. |
| SurfaceContaminantSourceAndSink:Generic:DepositionVelocitySink | Simulate generic contaminant source driven by the boundary layer diffusion controlled model. |
| SurfaceContaminantSourceAndSink:Generic:PressureDriven | Simulate generic contaminant source driven by the pressure difference across a surface. |
| SwimmingPool:Indoor | Specifies an indoor swimming pools linked to a floor surface. |
| ZoneBaseboard:OutdoorTemperatureControlled | Specifies outside temperature-controlled electric baseboard heating. |
| ZoneContaminantSourceAndSink:CarbonDioxide | Represents internal CO2 gains and sinks in the zone. |
| ZoneContaminantSourceAndSink:Generic:Constant | Sets internal generic contaminant gains and sinks in a zone with constant values. |
| ZoneContaminantSourceAndSink:Generic:CutoffModel | Simulate generic contaminant source driven by the cutoff concentration model. |
| ZoneContaminantSourceAndSink:Generic:DecaySource | Simulate generic contaminant source driven by the cutoff concentration model. |
| ZoneContaminantSourceAndSink:Generic:DepositionRateSink | Simulate generic contaminant source driven by the boundary layer diffusion controlled model. |
ComfortViewFactorAngles¶
from idfpy.models import ComfortViewFactorAngles extensible
Used to specify radiant view factors for thermal comfort calculations. Note that the following angle factor fractions must sum up to 1.0 All surfaces must be in the same enclosure.
| Field | Type | Default | Details |
|---|---|---|---|
nameName |
string | ||
angles |
list | Each item: surface_name, angle_factor |
Referenced by 2 object types
ElectricEquipment¶
from idfpy.models import ElectricEquipment
Sets internal gains for electric equipment in the zone. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
schedule_Schedule Name required |
reference | units in schedule should be fraction applied to design level of electric equipment, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
design_Design Level Calculation Method |
choice | EquipmentLevel |
The entered calculation method is used to create the maximum amount of electric equipment for this set of attributes Choices: EquipmentLevel => Equipment Level -- simply enter watts of equipment Watts/Area => Watts per Floor Area -- enter the number to apply. Value * Floor Area = Equipment Level Watts/Person => Watts per Person -- enter the number to apply. Value * Occupants = Equipment Level One of EquipmentLevel, Watts/Area, Watts/Person |
design_Design Level |
number W |
Range: ≥ 0 | |
watts_Watts per Floor Area |
number W/m2 |
Range: ≥ 0 | |
watts_Watts per Person |
number W/person |
Range: ≥ 0 | |
fraction_Fraction Latent |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Radiant |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Lost |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
end_End-Use Subcategory |
string | General |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
Referenced by 1 object types
ElectricEquipment:Definition¶
from idfpy.models import ElectricEquipmentDefinition
Defines the physical characteristics (design level and heat gain fractions) for electric equipment. Referenced by one or more ElectricEquipment:Instance objects.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
design_Design Level Calculation Method |
choice | EquipmentLevel |
The entered calculation method is used to create the maximum amount of electric equipment for this set of attributes Choices: EquipmentLevel => Equipment Level -- simply enter watts of equipment Watts/Area => Watts per Floor Area -- enter the number to apply. Value * Floor Area = Equipment Level Watts/Person => Watts per Person -- enter the number to apply. Value * Occupants = Equipment Level One of EquipmentLevel, Watts/Area, Watts/Person |
design_Design Level |
number W |
Range: ≥ 0 | |
watts_Watts per Floor Area |
number W/m2 |
Range: ≥ 0 | |
watts_Watts per Person |
number W/person |
Range: ≥ 0 | |
fraction_Fraction Latent |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Radiant |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Lost |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
Referenced by 1 object types
ElectricEquipment:ITE:AirCooled¶
from idfpy.models import ElectricEquipmentITEAirCooled
This object describes air-cooled electric information technology equipment (ITE) which has variable power consumption as a function of loading and temperature. If a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone or Space Name required |
reference | ZoneList and SpaceList names are not allowed. Names a Space, Zone |
|
air_Air Flow Calculation Method |
choice | FlowFromSystem |
The specified method is used to calculate the IT inlet temperature and zone return air temperature. If FlowFromSystem is chosen, the zone is assumed to be well-mixed. If FlowControlWithApproachTemperatures is chosen, Supply and Return approach temperature should be defined to indicate the temperature difference due to the air distribution. When FlowControlWithApproachTemperatures is chosen, the inputs of Air Inlet Connection Type, Design Recirculation Fraction and Recirculation Function of Loading and Supply Temperature Curve Name are ignored. For multiple ITE objects defined for one zone, the same calculation method should apply. The FlowControlWithApproachTemperatures only applies to ITE zones with single duct VAV terminal unit. Other return air heat gains from window or lights are not allowed when FlowControlWithApproachTemperatures is chosen. When FlowControlWithApproachTemperatures is chosen, the controlled variable is the supply air temperature, not the well-mixed zone air temperature. The zone cooling setpoint from ZoneControl:Thermostat is ignored for this zone and cooling unmet hours do not apply. One of FlowControlWithApproachTemperatures, FlowFromSystem |
design_Design Power Input Calculation Method |
choice | Watts/Unit |
The entered calculation method is used to specify the design power input Watts/Unit => Watts per Unit -- Design Power = Watts per Unit * Number of Units Watts/Area => Watts per Floor Area -- Design Power = Watts per Floor Area * Floor Area One of Watts/Area, Watts/Unit |
watts_Watts per Unit |
number W |
Range: ≥ 0 | |
number_Number of Units |
number | 1.0 |
Range: ≥ 0 |
watts_Watts per Floor Area |
number W/m2 |
Range: ≥ 0 | |
design_Design Power Input Schedule Name |
reference | Operating schedule for this equipment, fraction applied to the design power input, generally (0.0 - 1.0) If this field is blank, the schedule is assumed to always be 1.0. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
cpu_CPU Loading Schedule Name |
reference | CPU loading schedule for this equipment as a fraction from 0.0 (idle) to 1.0 (full load). If this field is blank, the schedule is assumed to always be 1.0. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
cpu_CPU Power Input Function of Loading and Air Temperature Curve Name required |
reference | The name of a two-variable curve or table lookup object which modifies the CPU power input as a function of CPU loading (x) and air inlet node temperature (y). This curve (table) should equal 1.0 at design conditions (CPU loading = 1.0 and Design Entering Air Temperature). Names a Curve:Bicubic, Curve:Biquadratic, Curve:CubicLinear, Curve:FanPressureRise, Curve:QuadraticLinear, Table:Lookup |
|
design_Design Fan Power Input Fraction |
number | 0.0 |
The fraction of the total power input at design conditions which is for the cooling fan(s) Range: ≥ 0, ≤ 1 |
design_Design Fan Air Flow Rate per Power Input required |
number m3/s-W |
The cooling fan air flow rate per total electric power input at design conditions Range: ≥ 0 |
|
air_Air Flow Function of Loading and Air Temperature Curve Name required |
reference | The name of a two-variable curve or table lookup object which modifies the cooling air flow rate as a function of CPU loading (x) and air inlet node temperature (y). This curve (table) should equal 1.0 at design conditions (CPU loading = 1.0 and Design Entering Air Temperature). Names a Curve:Bicubic, Curve:Biquadratic, Curve:CubicLinear, Curve:FanPressureRise, Curve:QuadraticLinear, Table:Lookup |
|
fan_Fan Power Input Function of Flow Curve Name required |
reference | The name of a single-variable curve or table lookup object which modifies the cooling fan power as a function of flow fraction (x). This curve (table) should equal 1.0 at a flow fraction of 1.0. Names a Curve:Cubic, Curve:DoubleExponentialDecay, Curve:Exponent, Curve:ExponentialDecay, Curve:ExponentialSkewNormal, Curve:Functional:PressureDrop, Curve:Linear, Curve:Quadratic, Curve:Quartic, Curve:RectangularHyperbola1, Curve:RectangularHyperbola2, Curve:Sigmoid and 1 more |
|
design_Design Entering Air Temperature |
number C |
15.0 |
The entering air temperature at design conditions. |
environmental_Environmental Class |
choice | None |
Specifies the allowable operating conditions for the air inlet conditions. Used for reporting time outside allowable conditions. One of A1, A2, A3, A4, B, C, H1, None |
air_Air Inlet Connection Type |
choice | AdjustedSupply |
Specifies the type of connection between the zone and the ITE air inlet node. AdjustedSupply = ITE inlet temperature will be the current Supply Air Node temperature adjusted by the current recirculation fraction. All heat output is added to the zone air heat balance as a convective gain. ZoneAirNode = ITE air inlet condition is the average zone condition. All heat output is added to the zone air heat balance as a convective gain. RoomAirModel = ITE air inlet and outlet are connected to room air model nodes. This field is only used when Air Flow Calculation Method is FlowFromSystem. One of AdjustedSupply, RoomAirModel, ZoneAirNode |
air_Air Inlet Room Air Model Node Name |
reference | Name of a RoomAir:Node object which is connected to the ITE air inlet. Names a RoomAir:Node |
|
air_Air Outlet Room Air Model Node Name |
reference | Name of a RoomAir:Node object which is connected to the ITE air outlet. Names a RoomAir:Node |
|
supply_Supply Air Node Name |
string | Name of the supply air inlet node serving this ITE. Required if the Air Node Connection Type = AdjustedSupply. Also required if Calculation Method = FlowControlWithApproachTemperatures. Also required if reporting of Supply Heat Index is desired. | |
design_Design Recirculation Fraction |
number | 0.0 |
The recirculation fraction for this equipment at design conditions. This field is used only if the Air Node Connection Type = AdjustedSupply. The default is 0.0 (no recirculation). This field is only used when Air Flow Calculation Method is FlowFromSystem. Range: ≥ 0, ≤ 0.5 |
recirculation_Recirculation Function of Loading and Supply Temperature Curve Name |
reference | The name of a two-variable curve or table lookup object which modifies the recirculation fraction as a function of CPU loading (x) and supply air node temperature (y). This curve (table) should equal 1.0 at design conditions (CPU loading = 1.0 and Design Entering Air Temperature).This field is used only if the Air Node Connection Type = AdjustedSupply. If this curve is left blank, then the curve is assumed to always equal 1.0. This field is only used when Air Flow Calculation Method is FlowFromSystem. Names a Curve:Bicubic, Curve:Biquadratic, Curve:CubicLinear, Curve:FanPressureRise, Curve:QuadraticLinear, Table:Lookup |
|
design_Design Electric Power Supply Efficiency |
number | 1.0 |
The efficiency of the power supply system serving this ITE Range: > 0, ≤ 1 |
electric_Electric Power Supply Efficiency Function of Part Load Ratio Curve Name |
reference | The name of a single-variable curve or table lookup object which modifies the electric power supply efficiency as a function of part-load ratio (x). This curve (table) should equal 1.0 at full load (PLR = 1.0). If this curve is left blank, then the curve is assumed to always equal 1.0. Names a Curve:Cubic, Curve:DoubleExponentialDecay, Curve:Exponent, Curve:ExponentialDecay, Curve:ExponentialSkewNormal, Curve:Functional:PressureDrop, Curve:Linear, Curve:Quadratic, Curve:Quartic, Curve:RectangularHyperbola1, Curve:RectangularHyperbola2, Curve:Sigmoid and 1 more |
|
fraction_Fraction of Electric Power Supply Losses to Zone |
number | 1.0 |
Fraction of the electric power supply losses which are a heat gain to the zone If this field is <1.0, the remainder of the losses are assumed to be lost to the outdoors. Range: ≥ 0, ≤ 1 |
cpu_CPU End-Use Subcategory |
string | ITE-CPU |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
fan_Fan End-Use Subcategory |
string | ITE-Fans |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
electric_Electric Power Supply End-Use Subcategory |
string | ITE-UPS |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
supply_Supply Temperature Difference |
number deltaC |
The difference of the IT inlet temperature from the AHU supply air temperature. Either Supply Temperature Difference or Supply Temperature Difference Schedule is required if Air Flow Calculation Method is set to FlowControlWithApproachTemperatures. This field is ignored when Air Flow Calculation Method is FlowFromSystem. | |
supply_Supply Temperature Difference Schedule |
reference | The difference schedule of the IT inlet temperature from the AHU supply air temperature. Either Supply Temperature Difference or Supply Temperature Difference Schedule is required if Air Flow Calculation Method is set to FlowControlWithApproachTemperatures. This field is ignored when Air Flow Calculation Method is FlowFromSystem. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
return_Return Temperature Difference |
number deltaC |
The difference of the the actual AHU return air temperature to the IT equipment outlet temperature. Either Return Temperature Difference or Return Temperature Difference Schedule is required if Air Flow Calculation Method is set to FlowControlWithApproachTemperatures. This field is ignored when Air Flow Calculation Method is FlowFromSystem. | |
return_Return Temperature Difference Schedule |
reference | The difference schedule of the actual AHU return air temperature to the IT equipment outlet temperature. Either Return Temperature Difference or Return Temperature Difference Schedule is required if Air Flow Calculation Method is set to FlowControlWithApproachTemperatures. This field is ignored when Air Flow Calculation Method is FlowFromSystem. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
ElectricEquipment:ITE:AirCooled:Definition¶
from idfpy.models import ElectricEquipmentITEAirCooledDefinition
Performance characteristics for ElectricEquipment:ITE:AirCooled:Instance. Defines power, airflow, and efficiency as functions of loading and temperature.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
air_Air Flow Calculation Method |
choice | FlowFromSystem |
The specified method is used to calculate the IT inlet temperature and zone return air temperature. If FlowFromSystem is chosen, the zone is assumed to be well-mixed. If FlowControlWithApproachTemperatures is chosen, Supply and Return approach temperature should be defined to indicate the temperature difference due to the air distribution. When FlowControlWithApproachTemperatures is chosen, the inputs of Air Inlet Connection Type, Design Recirculation Fraction and Recirculation Function of Loading and Supply Temperature Curve Name are ignored. For multiple ITE objects defined for one zone, the same calculation method should apply. The FlowControlWithApproachTemperatures only applies to ITE zones with single duct VAV terminal unit. Other return air heat gains from window or lights are not allowed when FlowControlWithApproachTemperatures is chosen. One of FlowControlWithApproachTemperatures, FlowFromSystem |
design_Design Power Input Calculation Method |
choice | EquipmentLevel |
The entered calculation method is used to specify the design power input Choices: EquipmentLevel => Equipment Level -- simply enter watts of equipment Watts/Area => Watts per Floor Area -- Design Power = Watts per Floor Area * Floor Area One of EquipmentLevel, Watts/Area |
watts_Watts per Unit |
number W |
Range: ≥ 0 | |
watts_Watts per Floor Area |
number W/m2 |
Range: ≥ 0 | |
cpu_CPU Power Input Function of Loading and Air Temperature Curve Name required |
reference | The name of a two-variable curve or table lookup object which modifies the CPU power input as a function of CPU loading (x) and air inlet node temperature (y). This curve (table) should equal 1.0 at design conditions (CPU loading = 1.0 and Design Entering Air Temperature). Names a Curve:Bicubic, Curve:Biquadratic, Curve:CubicLinear, Curve:FanPressureRise, Curve:QuadraticLinear, Table:Lookup |
|
design_Design Fan Power Input Fraction |
number | 0.0 |
The fraction of the total power input at design conditions which is for the cooling fan(s) Range: ≥ 0, ≤ 1 |
design_Design Fan Air Flow Rate per Power Input required |
number m3/s-W |
The cooling fan air flow rate per total electric power input at design conditions Range: ≥ 0 |
|
air_Air Flow Function of Loading and Air Temperature Curve Name required |
reference | The name of a two-variable curve or table lookup object which modifies the cooling air flow rate as a function of CPU loading (x) and air inlet node temperature (y). This curve (table) should equal 1.0 at design conditions (CPU loading = 1.0 and Design Entering Air Temperature). Names a Curve:Bicubic, Curve:Biquadratic, Curve:CubicLinear, Curve:FanPressureRise, Curve:QuadraticLinear, Table:Lookup |
|
fan_Fan Power Input Function of Flow Curve Name required |
reference | The name of a single-variable curve or table lookup object which modifies the cooling fan power as a function of flow fraction (x). This curve (table) should equal 1.0 at a flow fraction of 1.0. Names a Curve:Cubic, Curve:DoubleExponentialDecay, Curve:Exponent, Curve:ExponentialDecay, Curve:ExponentialSkewNormal, Curve:Functional:PressureDrop, Curve:Linear, Curve:Quadratic, Curve:Quartic, Curve:RectangularHyperbola1, Curve:RectangularHyperbola2, Curve:Sigmoid and 1 more |
|
design_Design Entering Air Temperature |
number C |
15.0 |
The entering air temperature at design conditions. |
environmental_Environmental Class |
choice | None |
Specifies the allowable operating conditions for the air inlet conditions. Used for reporting time outside allowable conditions. One of A1, A2, A3, A4, B, C, H1, None |
air_Air Inlet Connection Type |
choice | AdjustedSupply |
Specifies the type of connection between the zone and the ITE air inlet node. AdjustedSupply = ITE inlet temperature will be the current Supply Air Node temperature adjusted by the current recirculation fraction. All heat output is added to the zone air heat balance as a convective gain. ZoneAirNode = ITE air inlet condition is the average zone condition. All heat output is added to the zone air heat balance as a convective gain. RoomAirModel = ITE air inlet and outlet are connected to room air model nodes. This field is only used when Air Flow Calculation Method is FlowFromSystem. One of AdjustedSupply, RoomAirModel, ZoneAirNode |
design_Design Recirculation Fraction |
number | 0.0 |
The recirculation fraction for this equipment at design conditions. This field is used only if the Air Node Connection Type = AdjustedSupply. The default is 0.0 (no recirculation). This field is only used when Air Flow Calculation Method is FlowFromSystem. Range: ≥ 0, ≤ 0.5 |
recirculation_Recirculation Function of Loading and Supply Temperature Curve Name |
reference | The name of a two-variable curve or table lookup object which modifies the recirculation fraction as a function of CPU loading (x) and supply air node temperature (y). This curve (table) should equal 1.0 at design conditions (CPU loading = 1.0 and Design Entering Air Temperature). This field is used only if the Air Node Connection Type = AdjustedSupply. If this curve is left blank, then the curve is assumed to always equal 1.0. This field is only used when Air Flow Calculation Method is FlowFromSystem. Names a Curve:Bicubic, Curve:Biquadratic, Curve:CubicLinear, Curve:FanPressureRise, Curve:QuadraticLinear, Table:Lookup |
|
design_Design Electric Power Supply Efficiency |
number | 1.0 |
The efficiency of the power supply system serving this ITE Range: > 0, ≤ 1 |
electric_Electric Power Supply Efficiency Function of Part Load Ratio Curve Name |
reference | The name of a single-variable curve or table lookup object which modifies the electric power supply efficiency as a function of part-load ratio (x). This curve (table) should equal 1.0 at full load (PLR = 1.0). If this curve is left blank, then the curve is assumed to always equal 1.0. Names a Curve:Cubic, Curve:DoubleExponentialDecay, Curve:Exponent, Curve:ExponentialDecay, Curve:ExponentialSkewNormal, Curve:Functional:PressureDrop, Curve:Linear, Curve:Quadratic, Curve:Quartic, Curve:RectangularHyperbola1, Curve:RectangularHyperbola2, Curve:Sigmoid and 1 more |
|
fraction_Fraction of Electric Power Supply Losses to Zone |
number | 1.0 |
Fraction of the electric power supply losses which are a heat gain to the zone If this field is <1.0, the remainder of the losses are assumed to be lost to the outdoors. Range: ≥ 0, ≤ 1 |
supply_Supply Temperature Difference |
number deltaC |
The difference of the IT inlet temperature from the AHU supply air temperature. Either Supply Temperature Difference or Supply Temperature Difference Schedule is required if Air Flow Calculation Method is set to FlowControlWithApproachTemperatures. This field is ignored when Air Flow Calculation Method is FlowFromSystem. | |
supply_Supply Temperature Difference Schedule |
reference | The difference schedule of the IT inlet temperature from the AHU supply air temperature. Either Supply Temperature Difference or Supply Temperature Difference Schedule is required if Air Flow Calculation Method is set to FlowControlWithApproachTemperatures. This field is ignored when Air Flow Calculation Method is FlowFromSystem. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
return_Return Temperature Difference |
number deltaC |
The difference of the actual AHU return air temperature to the IT equipment outlet temperature. Either Return Temperature Difference or Return Temperature Difference Schedule is required if Air Flow Calculation Method is set to FlowControlWithApproachTemperatures. This field is ignored when Air Flow Calculation Method is FlowFromSystem. | |
return_Return Temperature Difference Schedule |
reference | The difference schedule of the actual AHU return air temperature to the IT equipment outlet temperature. Either Return Temperature Difference or Return Temperature Difference Schedule is required if Air Flow Calculation Method is set to FlowControlWithApproachTemperatures. This field is ignored when Air Flow Calculation Method is FlowFromSystem. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
Referenced by 1 object types
ElectricEquipment:ITE:AirCooled:Instance¶
from idfpy.models import ElectricEquipmentITEAirCooledInstance
This object describes air-cooled electric information technology equipment (ITE) which has variable power consumption as a function of loading and temperature. The performance characteristics are given by the referenced ElectricEquipment:ITE:AirCooled:Definition object. If a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
electricequipment_ElectricEquipment ITE AirCooled Definition Name required |
reference | Names a ElectricEquipment:ITE:AirCooled:Definition | |
zone_Zone or Space Name required |
reference | ZoneList and SpaceList names are not allowed. Names a Space, Zone |
|
multiplierMultiplier |
number | 1.0 |
Multiplies the design power input from the referenced definition. Range: ≥ 0 |
design_Design Power Input Schedule Name |
reference | Operating schedule for this equipment, fraction applied to the design power input, generally (0.0 - 1.0) If this field is blank, the schedule is assumed to always be 1.0. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
cpu_CPU Loading Schedule Name |
reference | CPU loading schedule for this equipment as a fraction from 0.0 (idle) to 1.0 (full load). If this field is blank, the schedule is assumed to always be 1.0. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
air_Air Inlet Room Air Model Node Name |
reference | Name of a RoomAir:Node object which is connected to the ITE air inlet. Names a RoomAir:Node |
|
air_Air Outlet Room Air Model Node Name |
reference | Name of a RoomAir:Node object which is connected to the ITE air outlet. Names a RoomAir:Node |
|
supply_Supply Air Node Name |
string | Name of the supply air inlet node serving this ITE. Required if the Air Node Connection Type = AdjustedSupply (set in the Definition). Also required if Air Flow Calculation Method = FlowControlWithApproachTemperatures (set in the Definition). Also required if reporting of Supply Heat Index is desired. | |
cpu_CPU End-Use Subcategory |
string | ITE-CPU |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
fan_Fan End-Use Subcategory |
string | ITE-Fans |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
electric_Electric Power Supply End-Use Subcategory |
string | ITE-UPS |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
ElectricEquipment:Instance¶
from idfpy.models import ElectricEquipmentInstance
Sets internal gains for electric equipment in the zone. The physical characteristics are given by the referenced ElectricEquipment:Definition object. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
electric_Electric Equipment Definition Name required |
reference | Names a ElectricEquipment:Definition | |
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
schedule_Schedule Name required |
reference | units in schedule should be fraction applied to design level of electric equipment, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
multiplierMultiplier |
number | 1.0 |
Multiplies the design level from the referenced definition. Range: ≥ 0 |
end_End-Use Subcategory |
string | General |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
Referenced by 1 object types
GasEquipment¶
from idfpy.models import GasEquipment
Sets internal gains and contaminant rates for gas equipment in the zone. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
schedule_Schedule Name required |
reference | units in Schedule should be fraction applied to design level of gas equipment, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
design_Design Level Calculation Method |
choice | EquipmentLevel |
The entered calculation method is used to create the maximum amount of gas equipment for this set of attributes Choices: EquipmentLevel => Design Level -- simply enter power input of equipment Watts/Area or Power/Area => Power per Floor Area -- enter the number to apply. Value * Floor Area = Equipment Level Watts/Person or Power/Person => Power per Person -- enter the number to apply. Value * Occupants = Equipment Level One of EquipmentLevel, Power/Area, Power/Person, Watts/Area, Watts/Person |
design_Design Level |
number W |
Range: ≥ 0 | |
power_Power per Floor Area |
number W/m2 |
Range: ≥ 0 | |
power_Power per Person |
number W/person |
Range: ≥ 0 | |
fraction_Fraction Latent |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Radiant |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Lost |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
carbon_Carbon Dioxide Generation Rate |
number m3/s-W |
0.0 |
CO2 generation rate per unit of power input The default value assumes the equipment is fully vented. For unvented equipment, a suggested value is 3.45E-8 m3/s-W. This value is converted from a natural gas CO2 emission rate of 117 lbs CO2 per million Btu. The maximum value assumes to be 10 times of the recommended value. Range: ≥ 0, ≤ 4e-07 |
end_End-Use Subcategory |
string | General |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
GasEquipment:Definition¶
from idfpy.models import GasEquipmentDefinition
Defines the physical characteristics (design level and heat gain fractions) for gas equipment. Referenced by one or more GasEquipment:Instance objects.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
design_Design Level Calculation Method |
choice | EquipmentLevel |
The entered calculation method is used to create the maximum amount of gas equipment for this set of attributes Choices: EquipmentLevel => Design Level -- simply enter power input of equipment Watts/Area or Power/Area => Power per Floor Area -- enter the number to apply. Value * Floor Area = Equipment Level Watts/Person or Power/Person => Power per Person -- enter the number to apply. Value * Occupants = Equipment Level One of EquipmentLevel, Power/Area, Power/Person, Watts/Area, Watts/Person |
design_Design Level |
number W |
Range: ≥ 0 | |
power_Power per Floor Area |
number W/m2 |
Range: ≥ 0 | |
power_Power per Person |
number W/person |
Range: ≥ 0 | |
fraction_Fraction Latent |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Radiant |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Lost |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
carbon_Carbon Dioxide Generation Rate |
number m3/s-W |
0.0 |
CO2 generation rate per unit of power input The default value assumes the equipment is fully vented. For unvented equipment, a suggested value is 3.45E-8 m3/s-W. This value is converted from a natural gas CO2 emission rate of 117 lbs CO2 per million Btu. The maximum value assumes to be 10 times of the recommended value. Range: ≥ 0, ≤ 4e-07 |
Referenced by 1 object types
GasEquipment:Instance¶
from idfpy.models import GasEquipmentInstance
Sets internal gains and contaminant rates for gas equipment in the zone. The physical characteristics are given by the referenced GasEquipment:Definition object. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
gas_Gas Equipment Definition Name required |
reference | Names a GasEquipment:Definition | |
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
schedule_Schedule Name required |
reference | units in Schedule should be fraction applied to design level of gas equipment, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
multiplierMultiplier |
number | 1.0 |
Multiplies the design level from the referenced definition. Range: ≥ 0 |
end_End-Use Subcategory |
string | General |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
HotWaterEquipment¶
from idfpy.models import HotWaterEquipment
Sets internal gains for hot water equipment in the zone. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
schedule_Schedule Name required |
reference | units in Schedule should be fraction applied to design level of hot water equipment, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
design_Design Level Calculation Method |
choice | EquipmentLevel |
The entered calculation method is used to create the maximum amount of hot water equipment for this set of attributes Choices: EquipmentLevel => Design Level -- simply enter power input of equipment Watts/Area or Power/Area => Power per Floor Area -- enter the number to apply. Value * Floor Area = Equipment Level Watts/Person or Power/Person => Power per Person -- enter the number to apply. Value * Occupants = Equipment Level One of EquipmentLevel, Power/Area, Power/Person, Watts/Area, Watts/Person |
design_Design Level |
number W |
Range: ≥ 0 | |
power_Power per Floor Area |
number W/m2 |
Range: ≥ 0 | |
power_Power per Person |
number W/person |
Range: ≥ 0 | |
fraction_Fraction Latent |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Radiant |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Lost |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
end_End-Use Subcategory |
string | General |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
HotWaterEquipment:Definition¶
from idfpy.models import HotWaterEquipmentDefinition
Defines the physical characteristics (design level and heat gain fractions) for hot water equipment. Referenced by one or more HotWaterEquipment:Instance objects.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
design_Design Level Calculation Method |
choice | EquipmentLevel |
The entered calculation method is used to create the maximum amount of hot water equipment for this set of attributes Choices: EquipmentLevel => Design Level -- simply enter power input of equipment Watts/Area or Power/Area => Power per Floor Area -- enter the number to apply. Value * Floor Area = Equipment Level Watts/Person or Power/Person => Power per Person -- enter the number to apply. Value * Occupants = Equipment Level One of EquipmentLevel, Power/Area, Power/Person, Watts/Area, Watts/Person |
design_Design Level |
number W |
Range: ≥ 0 | |
power_Power per Floor Area |
number W/m2 |
Range: ≥ 0 | |
power_Power per Person |
number W/person |
Range: ≥ 0 | |
fraction_Fraction Latent |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Radiant |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Lost |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
Referenced by 1 object types
HotWaterEquipment:Instance¶
from idfpy.models import HotWaterEquipmentInstance
Sets internal gains for hot water equipment in the zone. The physical characteristics are given by the referenced HotWaterEquipment:Definition object. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
hot_Hot Water Equipment Definition Name required |
reference | Names a HotWaterEquipment:Definition | |
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
schedule_Schedule Name required |
reference | units in Schedule should be fraction applied to design level of hot water equipment, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
multiplierMultiplier |
number | 1.0 |
Multiplies the design level from the referenced definition. Range: ≥ 0 |
end_End-Use Subcategory |
string | General |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
IndoorLivingWall¶
from idfpy.models import IndoorLivingWall
Indoor greenery systems such as indoor living walls are panels of plants, which grow hydroponically or from substrates. The living wall structures can be either free-standing or attached to walls. The IndoorLivingWall module directly connects with inside surface heat balance, zone air heat balance, and zone air moisture balance.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
surface_Surface Name required |
reference | Name of the wall partition where indoor green is located. Names a BuildingSurface:Detailed, Ceiling:Adiabatic, Ceiling:Interzone, Floor:Adiabatic, Floor:Detailed, Floor:GroundContact, Floor:Interzone, Roof, RoofCeiling:Detailed, Wall:Adiabatic, Wall:Detailed, Wall:Exterior and 2 more |
|
schedule_Schedule Name required |
reference | units in Schedule should be fraction applied to design level of other equipment, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
evapotranspiration_Evapotranspiration Calculation Method |
choice | Penman-Monteith |
Model selection for calculating evapotranspiration of indoor greenery system. This rate can also be actuated with user-defined calculations, see EMS application guide for actuator details. One of Penman-Monteith, Stanghellini |
lighting_Lighting Method |
choice | Three different methods are provided here (LED; Daylight; LED-Daylight) One of Daylight, LED, LED-Daylight |
|
led_LED Intensity 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 | |
daylighting_Daylighting Control Name |
string | If daylighting is used in the selected lighting methods (Daylight or LED-Daylight), users should define an object of Daylighting:Control to obtain the daylighting illuminance level and an object for Daylighting:ReferencePoint for the daylighting sensor location in the thermal zone. The name of the object of Daylighting:Controls should be specified in this field. | |
led_LED-Daylight Targeted Lighting Intensity Schedule Name |
reference | This field defines targeted LED intensity level for indoor living wall systems. The schedule values can be any positive number representing targeted photosynthetic photon flux density (PPFD). Based on the available daylighting, the required LED lighting level and power will be automatically adjusted to meet the targeted LED intensity level. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
total_Total Leaf Area |
number m2 |
The value is the one-sided leaf area of an indoor living wall. Based on the users’ input, LAI is calculated as the ratio of the total leaf area and the partition wall area. Typical LAIs are 1.0 for grass and 3.0 for bushes and shrubs. The maximum LAI is 2.0 for the IndoorLivingWall module in EnergyPlus. If the calculated LAI is greater than 2.0, the maximum value of 2.0 is used for LAI in the simulation. | |
led_LED Nominal Intensity |
number umol/m2-s |
The value represents photosynthetic photon flux density (PPFD) of LED grow light. PPFD is measured in micro-mole per m2 per second (umol/m2-s) which establishes exactly how many photosynthetically active radiation (PAR) photons are landing on a specific area. | |
led_LED Nominal Power |
number W |
This field defines nominal total LED power for an indoor living wall system. | |
radiant_Radiant Fraction of LED Lights |
number | 0.6 |
This field defines the fraction of radiation from LED lights Range: ≥ 0, ≤ 1 |
Lights¶
from idfpy.models import Lights
Sets internal gains for lights in the zone. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
schedule_Schedule Name required |
reference | units in schedule should be fraction applied to design level of lights, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
design_Design Level Calculation Method |
choice | LightingLevel |
The entered calculation method is used to create the maximum amount of lights for this set of attributes Choices: LightingLevel => Lighting Level -- simply enter watts of lights Watts/Area => Watts per Floor Area -- enter the number to apply. Value * Floor Area = Lights Watts/Person => Watts per Person -- enter the number to apply. Value * Occupants = Lights One of LightingLevel, Watts/Area, Watts/Person |
lighting_Lighting Level |
number W |
Range: ≥ 0 | |
watts_Watts per Floor Area |
number W/m2 |
Range: ≥ 0 | |
watts_Watts per Person |
number W/person |
Range: ≥ 0 | |
return_Return Air Fraction |
number | 0.0 |
Used only for sizing calculation if return-air-fraction coefficients are specified. Range: ≥ 0, ≤ 1 |
fraction_Fraction Radiant |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Visible |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Replaceable |
number | 1.0 |
For Daylighting:Controls must be 0 or 1: 0 = no dimming control, 1 = full dimming control Range: ≥ 0, ≤ 1 |
end_End-Use Subcategory |
string | General |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
return_Return Air Fraction Calculated from Plenum Temperature |
choice | No |
One of No, Yes |
return_Return Air Fraction Function of Plenum Temperature Coefficient 1 |
number | 0.0 |
Used only if Return Air Fraction Is Calculated from Plenum Temperature = Yes Equation is Return Air Fraction = Coefficient#1 - Coefficient#2 X PlenumTemp(degC) Range: ≥ 0 |
return_Return Air Fraction Function of Plenum Temperature Coefficient 2 |
number 1/K |
0.0 |
Used only if Return Air Fraction Is Calculated from Plenum Temperature = Yes Equation is Return Air Fraction = Coefficient#1 - Coefficient#2 X PlenumTemp(degC) Range: ≥ 0 |
return_Return Air Heat Gain Node Name |
string | Name of the return air node for this heat gain. If left blank, defaults to the first return air node for the zone. Leave this field blank when using a ZoneList name. | |
exhaust_Exhaust Air Heat Gain Node Name |
string | Name of the exhaust air node for this heat gain. If the node name is entered, return heat gain will be shared by both return and exhaust air nodes. The air properties of both nodes are weighted by both node mass flow rates. |
Referenced by 1 object types
Lights:Definition¶
from idfpy.models import LightsDefinition
Defines the physical characteristics (design level and heat gain fractions) for lights. Referenced by one or more Lights:Instance objects.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
design_Design Level Calculation Method |
choice | LightingLevel |
The entered calculation method is used to create the maximum amount of lights for this set of attributes Choices: LightingLevel => Lighting Level -- simply enter watts of lights Watts/Area => Watts per Floor Area -- enter the number to apply. Value * Floor Area = Lights Watts/Person => Watts per Person -- enter the number to apply. Value * Occupants = Lights One of LightingLevel, Watts/Area, Watts/Person |
lighting_Lighting Level |
number W |
Range: ≥ 0 | |
watts_Watts per Floor Area |
number W/m2 |
Range: ≥ 0 | |
watts_Watts per Person |
number W/person |
Range: ≥ 0 | |
return_Return Air Fraction |
number | 0.0 |
Used only for sizing calculation if return-air-fraction coefficients are specified. Range: ≥ 0, ≤ 1 |
fraction_Fraction Radiant |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Visible |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
return_Return Air Fraction Calculated from Plenum Temperature |
choice | No |
One of No, Yes |
return_Return Air Fraction Function of Plenum Temperature Coefficient 1 |
number | 0.0 |
Used only if Return Air Fraction Is Calculated from Plenum Temperature = Yes Equation is Return Air Fraction = Coefficient#1 - Coefficient#2 X PlenumTemp(degC) Range: ≥ 0 |
return_Return Air Fraction Function of Plenum Temperature Coefficient 2 |
number 1/K |
0.0 |
Used only if Return Air Fraction Is Calculated from Plenum Temperature = Yes Equation is Return Air Fraction = Coefficient#1 - Coefficient#2 X PlenumTemp(degC) Range: ≥ 0 |
Referenced by 1 object types
Lights:Instance¶
from idfpy.models import LightsInstance
Sets internal gains for lights in the zone. The physical characteristics are given by the referenced Lights:Definition object. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
lights_Lights Definition Name required |
reference | Names a Lights:Definition | |
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
schedule_Schedule Name required |
reference | units in schedule should be fraction applied to design level of lights, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
fraction_Fraction Replaceable |
number | 1.0 |
For Daylighting:Controls must be 0 or 1: 0 = no dimming control, 1 = full dimming control Range: ≥ 0, ≤ 1 |
multiplierMultiplier |
number | 1.0 |
Multiplies the design level from the referenced definition. Range: ≥ 0 |
end_End-Use Subcategory |
string | General |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
return_Return Air Heat Gain Node Name |
string | Name of the return air node for this heat gain. If left blank, defaults to the first return air node for the zone. Leave this field blank when using a ZoneList name. | |
exhaust_Exhaust Air Heat Gain Node Name |
string | Name of the exhaust air node for this heat gain. If the node name is entered, return heat gain will be shared by both return and exhaust air nodes. The air properties of both nodes are weighted by both node mass flow rates. |
Referenced by 1 object types
OtherEquipment¶
from idfpy.models import OtherEquipment
Sets internal gains or losses for "other" equipment in the zone. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
fuel_Fuel Type |
choice | None |
One of Coal, Diesel, DistrictCooling, DistrictHeatingSteam, DistrictHeatingWater, Electricity, FuelOilNo1, FuelOilNo2, Gasoline, NaturalGas, None, OtherFuel1, OtherFuel2, Propane |
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
schedule_Schedule Name required |
reference | units in Schedule should be fraction applied to design level of other equipment, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
design_Design Level Calculation Method |
choice | EquipmentLevel |
The entered calculation method is used to create the maximum amount of other equipment. to set a loss, use a negative value in the following fields. for this set of attributes Choices: EquipmentLevel => Design Level -- simply enter power input of equipment Watts/Area or Power/Area => Power per Floor Area -- enter the number to apply. Value * Floor Area = Equipment Level Watts/Person or Power/Person => Power per Person -- enter the number to apply. Value * Occupants = Equipment Level One of EquipmentLevel, Power/Area, Power/Person, Watts/Area, Watts/Person |
design_Design Level |
number W |
||
power_Power per Floor Area |
number W/m2 |
||
power_Power per Person |
number W/person |
||
fraction_Fraction Latent |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Radiant |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Lost |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
carbon_Carbon Dioxide Generation Rate |
number m3/s-W |
0.0 |
CO2 generation rate per unit of power input The default value assumes the equipment is fully vented. Range: ≥ 0, ≤ 4e-07 |
end_End-Use Subcategory |
string | General |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
OtherEquipment:Definition¶
from idfpy.models import OtherEquipmentDefinition
Defines the physical characteristics (design level and heat gain fractions) for "other" equipment. Referenced by one or more OtherEquipment:Instance objects.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
design_Design Level Calculation Method |
choice | EquipmentLevel |
The entered calculation method is used to create the maximum amount of other equipment. to set a loss, use a negative value in the following fields. for this set of attributes Choices: EquipmentLevel => Design Level -- simply enter power input of equipment Watts/Area or Power/Area => Power per Floor Area -- enter the number to apply. Value * Floor Area = Equipment Level Watts/Person or Power/Person => Power per Person -- enter the number to apply. Value * Occupants = Equipment Level One of EquipmentLevel, Power/Area, Power/Person, Watts/Area, Watts/Person |
design_Design Level |
number W |
||
power_Power per Floor Area |
number W/m2 |
||
power_Power per Person |
number W/person |
||
fraction_Fraction Latent |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Radiant |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Lost |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
carbon_Carbon Dioxide Generation Rate |
number m3/s-W |
0.0 |
CO2 generation rate per unit of power input The default value assumes the equipment is fully vented. Range: ≥ 0, ≤ 4e-07 |
Referenced by 1 object types
OtherEquipment:Instance¶
from idfpy.models import OtherEquipmentInstance
Sets internal gains or losses for "other" equipment in the zone. The physical characteristics are given by the referenced OtherEquipment:Definition object. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
other_Other Equipment Definition Name required |
reference | Names a OtherEquipment:Definition | |
fuel_Fuel Type |
choice | None |
One of Coal, Diesel, DistrictCooling, DistrictHeatingSteam, DistrictHeatingWater, Electricity, FuelOilNo1, FuelOilNo2, Gasoline, NaturalGas, None, OtherFuel1, OtherFuel2, Propane |
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
schedule_Schedule Name required |
reference | units in Schedule should be fraction applied to design level of other equipment, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
multiplierMultiplier |
number | 1.0 |
Multiplies the design level from the referenced definition. Range: ≥ 0 |
end_End-Use Subcategory |
string | General |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
People¶
from idfpy.models import People
Sets internal gains and contaminant rates for occupants in the zone. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
number_Number of People Schedule Name required |
reference | units in schedule should be fraction applied to number of people (0.0 - 1.0) 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 People Calculation Method |
choice | People |
The entered calculation method is used to create the maximum number of people for this set of attributes (i.e. sensible fraction, schedule, etc) Choices: People -- simply enter number of occupants. People per Floor Area -- enter the number to apply. Value * Floor Area = Number of people Floor Area per Person -- enter the number to apply. Floor Area / Value = Number of people One of Area/Person, People, People/Area |
number_Number of People |
number | Range: ≥ 0 | |
people_People per Floor Area |
number person/m2 |
Range: ≥ 0 | |
floor_Floor Area per Person |
number m2/person |
Range: ≥ 0 | |
fraction_Fraction Radiant |
number | 0.3 |
This is radiant fraction of the sensible heat released by people in a zone. This value will be multiplied by the total sensible heat released by people yields the amount of long wavelength radiation gain from people in a zone. Default value is 0.30. Range: ≥ 0, ≤ 1 |
sensible_Sensible Heat Fraction |
number or Autocalculate |
Autocalculate |
if input, overrides program calculated sensible/latent split |
activity_Activity Level Schedule Name required |
reference | Note that W has to be converted to mets in TC routine units in schedule are W/person Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
carbon_Carbon Dioxide Generation Rate |
number m3/s-W |
3.82e-08 |
CO2 generation rate per unit of activity level. The default value is obtained from ASHRAE Std 62.1 at 0.0084 cfm/met/person over the general adult population. Range: ≥ 0, ≤ 3.82e-07 |
enable_Enable ASHRAE 55 Comfort Warnings |
choice | No |
One of No, Yes |
mean_Mean Radiant Temperature Calculation Type |
choice | EnclosureAveraged |
optional (only required for thermal comfort runs) One of AngleFactor, EnclosureAveraged, SurfaceWeighted |
surface_Surface Name/Angle Factor List Name |
reference | optional (only required for runs of thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 and AnkleDraftASH55) Names a BuildingSurface:Detailed, Ceiling:Adiabatic, Ceiling:Interzone, ComfortViewFactorAngles, Door, Door:Interzone, FenestrationSurface:Detailed, Floor:Adiabatic, Floor:Detailed, Floor:GroundContact, Floor:Interzone, GlazedDoor and 11 more |
|
work_Work Efficiency Schedule Name |
reference | units in schedule are 0.0 to 1.0 optional (only required for runs of thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 and AnkleDraftASH55) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
clothing_Clothing Insulation Calculation Method |
choice | ClothingInsulationSchedule |
One of CalculationMethodSchedule, ClothingInsulationSchedule, DynamicClothingModelASHRAE55 |
clothing_Clothing Insulation Calculation Method Schedule Name |
reference | a schedule value of 1 for the Scheduled method, and 2 for the DynamicClothingModelASHRAE55 method Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
clothing_Clothing Insulation Schedule Name |
reference | use "Clo" from ASHRAE or Thermal Comfort guides optional (only required for runs of thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 and AnkleDraftASH55) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
air_Air Velocity Schedule Name |
reference | units in the schedule are m/s optional (only required for runs of thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 and AnkleDraftASH55) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
thermal_Thermal Comfort Model 1 Type |
choice | optional (only needed for people thermal comfort results reporting) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
|
thermal_Thermal Comfort Model 2 Type |
choice | optional (second type of thermal comfort model and results reporting) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
|
thermal_Thermal Comfort Model 3 Type |
choice | optional (third thermal comfort model and report type) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
|
thermal_Thermal Comfort Model 4 Type |
choice | optional (fourth thermal comfort model and report type) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
|
thermal_Thermal Comfort Model 5 Type |
choice | optional (fifth thermal comfort model and report type) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
|
thermal_Thermal Comfort Model 6 Type |
choice | optional (sixth thermal comfort model and report type) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
|
thermal_Thermal Comfort Model 7 Type |
choice | optional (seventh thermal comfort model and report type) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
|
ankle_Ankle Level Air Velocity Schedule Name |
reference | units in the schedule are m/s this is the schedule of the air speed at the 0.1 m above the floor optional (only required for runs of thermal comfort models AnkleDraftASH55) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
cold_Cold Stress Temperature Threshold |
number C |
15.56 |
this is the indoor safe temperature threshold for cold stress |
heat_Heat Stress Temperature Threshold |
number C |
30.0 |
this is the indoor safe temperature threshold for heat stress |
Referenced by 2 object types
People:Definition¶
from idfpy.models import PeopleDefinition
Defines the physical characteristics (number of people, heat gain fractions, CO2 generation rate and thermal comfort model selections) for occupants. Referenced by one or more People:Instance objects.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
number_Number of People Calculation Method |
choice | People |
The entered calculation method is used to create the maximum number of people for this set of attributes (i.e. sensible fraction, schedule, etc) Choices: People -- simply enter number of occupants. People per Floor Area -- enter the number to apply. Value * Floor Area = Number of people Floor Area per Person -- enter the number to apply. Floor Area / Value = Number of people One of Area/Person, People, People/Area |
number_Number of People |
number | Range: ≥ 0 | |
people_People per Floor Area |
number person/m2 |
Range: ≥ 0 | |
floor_Floor Area per Person |
number m2/person |
Range: ≥ 0 | |
fraction_Fraction Radiant |
number | 0.3 |
This is radiant fraction of the sensible heat released by people in a zone. This value will be multiplied by the total sensible heat released by people yields the amount of long wavelength radiation gain from people in a zone. Default value is 0.30. Range: ≥ 0, ≤ 1 |
sensible_Sensible Heat Fraction |
number or Autocalculate |
Autocalculate |
if input, overrides program calculated sensible/latent split |
carbon_Carbon Dioxide Generation Rate |
number m3/s-W |
3.82e-08 |
CO2 generation rate per unit of activity level. The default value is obtained from ASHRAE Std 62.1 at 0.0084 cfm/met/person over the general adult population. Range: ≥ 0, ≤ 3.82e-07 |
enable_Enable ASHRAE 55 Comfort Warnings |
choice | No |
One of No, Yes |
mean_Mean Radiant Temperature Calculation Type |
choice | EnclosureAveraged |
optional (only required for thermal comfort runs) One of AngleFactor, EnclosureAveraged, SurfaceWeighted |
thermal_Thermal Comfort Model 1 Type |
choice | optional (only needed for people thermal comfort results reporting) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
|
thermal_Thermal Comfort Model 2 Type |
choice | optional (second type of thermal comfort model and results reporting) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
|
thermal_Thermal Comfort Model 3 Type |
choice | optional (third thermal comfort model and report type) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
|
thermal_Thermal Comfort Model 4 Type |
choice | optional (fourth thermal comfort model and report type) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
|
thermal_Thermal Comfort Model 5 Type |
choice | optional (fifth thermal comfort model and report type) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
|
thermal_Thermal Comfort Model 6 Type |
choice | optional (sixth thermal comfort model and report type) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
|
thermal_Thermal Comfort Model 7 Type |
choice | optional (seventh thermal comfort model and report type) One of AdaptiveASH55, AdaptiveCEN15251, AnkleDraftASH55, CoolingEffectASH55, Fanger, KSU, Pierce |
Referenced by 1 object types
People:Instance¶
from idfpy.models import PeopleInstance
Sets internal gains and contaminant rates for occupants in the zone. The physical characteristics are given by the referenced People:Definition object. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
people_People Definition Name required |
reference | Names a People:Definition | |
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
number_Number of People Schedule Name required |
reference | units in schedule should be fraction applied to number of people (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
activity_Activity Level Schedule Name required |
reference | Note that W has to be converted to mets in TC routine units in schedule are W/person Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
surface_Surface Name/Angle Factor List Name |
reference | optional (only required for runs of thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 and AnkleDraftASH55) Names a BuildingSurface:Detailed, Ceiling:Adiabatic, Ceiling:Interzone, ComfortViewFactorAngles, Door, Door:Interzone, FenestrationSurface:Detailed, Floor:Adiabatic, Floor:Detailed, Floor:GroundContact, Floor:Interzone, GlazedDoor and 11 more |
|
work_Work Efficiency Schedule Name |
reference | units in schedule are 0.0 to 1.0 optional (only required for runs of thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 and AnkleDraftASH55) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
clothing_Clothing Insulation Calculation Method |
choice | ClothingInsulationSchedule |
One of CalculationMethodSchedule, ClothingInsulationSchedule, DynamicClothingModelASHRAE55 |
clothing_Clothing Insulation Calculation Method Schedule Name |
reference | a schedule value of 1 for the Scheduled method, and 2 for the DynamicClothingModelASHRAE55 method Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
clothing_Clothing Insulation Schedule Name |
reference | use "Clo" from ASHRAE or Thermal Comfort guides optional (only required for runs of thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 and AnkleDraftASH55) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
air_Air Velocity Schedule Name |
reference | units in the schedule are m/s optional (only required for runs of thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 and AnkleDraftASH55) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
multiplierMultiplier |
number | 1.0 |
Multiplies the number of people from the referenced definition. Range: ≥ 0 |
ankle_Ankle Level Air Velocity Schedule Name |
reference | units in the schedule are m/s this is the schedule of the air speed at the 0.1 m above the floor optional (only required for runs of thermal comfort models AnkleDraftASH55) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
cold_Cold Stress Temperature Threshold |
number C |
15.56 |
this is the indoor safe temperature threshold for cold stress |
heat_Heat Stress Temperature Threshold |
number C |
30.0 |
this is the indoor safe temperature threshold for heat stress |
Referenced by 2 object types
SteamEquipment¶
from idfpy.models import SteamEquipment
Sets internal gains for steam equipment in the zone. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
schedule_Schedule Name required |
reference | units in Schedule should be fraction applied to design level of steam equipment, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
design_Design Level Calculation Method |
choice | EquipmentLevel |
The entered calculation method is used to create the maximum amount of steam equipment for this set of attributes Choices: EquipmentLevel => Design Level -- simply enter power input of equipment Watts/Area or Power/Area => Power per Floor Area -- enter the number to apply. Value * Floor Area = Equipment Level Watts/Person or Power/Person => Power per Person -- enter the number to apply. Value * Occupants = Equipment Level One of EquipmentLevel, Power/Area, Power/Person, Watts/Area, Watts/Person |
design_Design Level |
number W |
Range: ≥ 0 | |
power_Power per Floor Area |
number W/m2 |
Range: ≥ 0 | |
power_Power per Person |
number W/person |
Range: ≥ 0 | |
fraction_Fraction Latent |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Radiant |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Lost |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
end_End-Use Subcategory |
string | General |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
SteamEquipment:Definition¶
from idfpy.models import SteamEquipmentDefinition
Defines the physical characteristics (design level and heat gain fractions) for steam equipment. Referenced by one or more SteamEquipment:Instance objects.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
design_Design Level Calculation Method |
choice | EquipmentLevel |
The entered calculation method is used to create the maximum amount of steam equipment for this set of attributes Choices: EquipmentLevel => Design Level -- simply enter power input of equipment Watts/Area or Power/Area => Power per Floor Area -- enter the number to apply. Value * Floor Area = Equipment Level Watts/Person or Power/Person => Power per Person -- enter the number to apply. Value * Occupants = Equipment Level One of EquipmentLevel, Power/Area, Power/Person, Watts/Area, Watts/Person |
design_Design Level |
number W |
Range: ≥ 0 | |
power_Power per Floor Area |
number W/m2 |
Range: ≥ 0 | |
power_Power per Person |
number W/person |
Range: ≥ 0 | |
fraction_Fraction Latent |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Radiant |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
fraction_Fraction Lost |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
Referenced by 1 object types
SteamEquipment:Instance¶
from idfpy.models import SteamEquipmentInstance
Sets internal gains for steam equipment in the zone. The physical characteristics are given by the referenced SteamEquipment:Definition object. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
steam_Steam Equipment Definition Name required |
reference | Names a SteamEquipment:Definition | |
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
schedule_Schedule Name required |
reference | units in Schedule should be fraction applied to design level of steam equipment, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
multiplierMultiplier |
number | 1.0 |
Multiplies the design level from the referenced definition. Range: ≥ 0 |
end_End-Use Subcategory |
string | General |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
SurfaceContaminantSourceAndSink:Generic:BoundaryLayerDiffusion¶
from idfpy.models import SurfaceContaminantSourceAndSinkGenericBoundaryLayerDiffusion
Simulate generic contaminant source driven by the boundary layer diffusion controlled model.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
surface_Surface Name required |
reference | Names a BuildingSurface:Detailed, Ceiling:Adiabatic, Ceiling:Interzone, Floor:Adiabatic, Floor:Detailed, Floor:GroundContact, Floor:Interzone, Roof, RoofCeiling:Detailed, Wall:Adiabatic, Wall:Detailed, Wall:Exterior and 2 more | |
mass_Mass Transfer Coefficient |
number m/s |
Range: ≥ 0 | |
schedule_Schedule Name required |
reference | Value in this schedule should be a fraction (generally 0.0 - 1.0) applied to the Initial Emission Rate. When the value is equal to 1.0, the time will be reset to zero. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
henry_Henry Adsorption Constant or Partition Coefficient |
number dimensionless |
Range: > 0 |
SurfaceContaminantSourceAndSink:Generic:DepositionVelocitySink¶
from idfpy.models import SurfaceContaminantSourceAndSinkGenericDepositionVelocitySink
Simulate generic contaminant source driven by the boundary layer diffusion controlled model.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
surface_Surface Name required |
reference | Names a BuildingSurface:Detailed, Ceiling:Adiabatic, Ceiling:Interzone, Floor:Adiabatic, Floor:Detailed, Floor:GroundContact, Floor:Interzone, Roof, RoofCeiling:Detailed, Wall:Adiabatic, Wall:Detailed, Wall:Exterior and 2 more | |
deposition_Deposition Velocity |
number m/s |
Range: ≥ 0 | |
schedule_Schedule Name required |
reference | Value in this schedule should be a fraction (generally 0.0 - 1.0) applied to the Initial Emission Rate. When the value is equal to 1.0, the time will be reset to zero. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
SurfaceContaminantSourceAndSink:Generic:PressureDriven¶
from idfpy.models import SurfaceContaminantSourceAndSinkGenericPressureDriven
Simulate generic contaminant source driven by the pressure difference across a surface.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
surface_Surface Name required |
reference | Names a BuildingSurface:Detailed, Ceiling:Adiabatic, Ceiling:Interzone, Door, Door:Interzone, FenestrationSurface:Detailed, Floor:Adiabatic, Floor:Detailed, Floor:GroundContact, Floor:Interzone, GlazedDoor, GlazedDoor:Interzone and 9 more | |
design_Design Generation Rate Coefficient |
number m3/s |
Range: ≥ 0 | |
generation_Generation Schedule Name required |
reference | Value in this schedule should be a fraction (generally 0.0 - 1.0) applied to the Design Generation Rate Coefficient Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
generation_Generation Exponent |
number dimensionless |
Range: > 0, ≤ 1 |
SwimmingPool:Indoor¶
from idfpy.models import SwimmingPoolIndoor
Specifies an indoor swimming pools linked to a floor surface. The pool is assumed to cover the entire floor to which it is linked.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
surface_Surface Name required |
reference | Name of the floor surface where the pool is located. Names a BuildingSurface:Detailed, Floor:Adiabatic, Floor:Detailed, Floor:GroundContact, Floor:Interzone |
|
average_Average Depth required |
number m |
||
activity_Activity Factor 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 | |
make_Make-up Water Supply 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 | |
cover_Cover 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 | |
cover_Cover Evaporation Factor |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
cover_Cover Convection Factor |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
cover_Cover Short-Wavelength Radiation Factor |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
cover_Cover Long-Wavelength Radiation Factor |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
pool_Pool Water Inlet Node required |
string | ||
pool_Pool Water Outlet Node required |
string | ||
pool_Pool Heating System Maximum Water Flow Rate |
number m3/s |
Range: ≥ 0 | |
pool_Pool Miscellaneous Equipment Power |
number W/(m3/s) |
Power input per pool water flow rate Range: ≥ 0 |
|
setpoint_Setpoint Temperature Schedule 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 | |
maximum_Maximum Number of People required |
number | Range: ≥ 0 | |
people_People Schedule |
reference | Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules | |
people_People Heat Gain Schedule |
reference | Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
Referenced by 2 object types
ZoneBaseboard:OutdoorTemperatureControlled¶
from idfpy.models import ZoneBaseboardOutdoorTemperatureControlled
Specifies outside temperature-controlled electric baseboard heating. If a ZoneList, SpaceList, or a Zone comprised of more than one Space is specified then this definition applies to all applicable spaces, and each instance will be named with the Space Name plus this Object Name.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone or ZoneList or Space or SpaceList Name required |
reference | Names a Space, SpaceList, Zone, ZoneList | |
schedule_Schedule Name required |
reference | units in Schedule should be fraction applied to capacity of the baseboard heat equipment, generally (0.0 - 1.0) Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
capacity_Capacity at Low Temperature |
number or AutosizeW |
Autosize |
|
low_Low Temperature |
number or AutosizeC |
Autosize |
|
capacity_Capacity at High Temperature |
number or AutosizeW |
Autosize |
|
high_High Temperature |
number or AutosizeC |
Autosize |
|
fraction_Fraction Radiant |
number | 0.0 |
Range: ≥ 0, ≤ 1 |
end_End-Use Subcategory |
string | General |
Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table. |
design_Design Zone Heating Setpoint |
number C |
20.0 |
ZoneContaminantSourceAndSink:CarbonDioxide¶
from idfpy.models import ZoneContaminantSourceAndSinkCarbonDioxide
Represents internal CO2 gains and sinks in the zone.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone Name required |
reference | Names a Zone | |
design_Design Generation Rate |
number m3/s |
Positive values represent sources and negative values represent sinks. | |
schedule_Schedule Name required |
reference | Value in this schedule should be a fraction (generally 0.0 - 1.0) applied to the Design Generation Rate Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
ZoneContaminantSourceAndSink:Generic:Constant¶
from idfpy.models import ZoneContaminantSourceAndSinkGenericConstant
Sets internal generic contaminant gains and sinks in a zone with constant values.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone Name required |
reference | Names a Zone | |
design_Design Generation Rate |
number m3/s |
The values represent source. Range: ≥ 0 |
|
generation_Generation Schedule Name required |
reference | Value in this schedule should be a fraction (generally 0.0 - 1.0) applied to the Design Generation Rate Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
design_Design Removal Coefficient |
number m3/s |
The value represent sink. Range: ≥ 0 |
|
removal_Removal Schedule Name required |
reference | Value in this schedule should be a fraction (generally 0.0 - 1.0) applied to the Design removal Coefficient Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
ZoneContaminantSourceAndSink:Generic:CutoffModel¶
from idfpy.models import ZoneContaminantSourceAndSinkGenericCutoffModel
Simulate generic contaminant source driven by the cutoff concentration model.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone Name required |
reference | Names a Zone | |
design_Design Generation Rate Coefficient |
number m3/s |
Range: ≥ 0 | |
schedule_Schedule Name required |
reference | Value in this schedule should be a fraction (generally 0.0 - 1.0) applied to the Design Generation Rate Coefficient Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
cutoff_Cutoff Generic Contaminant at which Emission Ceases |
number ppm |
When the zone concentration level is greater than the cutoff level, emission stops, and the source level is zero. Range: > 0 |
ZoneContaminantSourceAndSink:Generic:DecaySource¶
from idfpy.models import ZoneContaminantSourceAndSinkGenericDecaySource
Simulate generic contaminant source driven by the cutoff concentration model.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone Name required |
reference | Names a Zone | |
initial_Initial Emission Rate |
number m3/s |
Range: ≥ 0 | |
schedule_Schedule Name required |
reference | Value in this schedule should be a fraction (generally 0.0 - 1.0) applied to the Initial Emission Rate. When the value is equal to 1.0, the time will be reset to zero. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |
|
delay_Delay Time Constant |
number s |
Range: > 0 |
ZoneContaminantSourceAndSink:Generic:DepositionRateSink¶
from idfpy.models import ZoneContaminantSourceAndSinkGenericDepositionRateSink
Simulate generic contaminant source driven by the boundary layer diffusion controlled model.
| Field | Type | Default | Details |
|---|---|---|---|
nameName required |
string | ||
zone_Zone Name required |
reference | Names a Zone | |
deposition_Deposition Rate |
number m/s |
Range: ≥ 0 | |
schedule_Schedule Name required |
reference | Value in this schedule should be a fraction (generally 0.0 - 1.0) applied to the Initial Emission Rate. When the value is equal to 1.0, the time will be reset to zero. Names a ExternalInterface:FunctionalMockupUnitExport:To:Schedule, ExternalInterface:FunctionalMockupUnitImport:To:Schedule, ExternalInterface:Schedule, Schedule:Compact, Schedule:Constant, Schedule:File, Schedule:Year, Schedule:Year:Rules |