Input Output Reference — EnergyPlus 24.2

<< Prev | Table of Contents | Object Index | Next >>

Input Output Reference

Group – Internal Gains (People, Lights, Other internal zone equipment)[LINK]

Not all the influence for energy consumption in the building is due to envelope and ambient conditions. This group of objects describes other internal gains that may come into play (People, Lights, Various Equipment Types).

Specifying Applicable Zone(s) or Space(s)[LINK]

Each internal gains object has a field for “Zone or ZoneList or Space or SpaceList Name“. All internal gains are modeled at the Space level, so each internal gain input object may be expanded to multiple instances of that gain according to the following rules with names constructed using the <Object Name>, <Zone Name>, or <Space Name>. If the resulting concatenated name is greater than 100 characters a warning will be shown and it will be truncated. If the resulting name duplicates another such concatenated name, there will be a severe error and terminate the run. The concatenated name is used when referring to specific instances of internal gains for Output:Variables, Energy Management System (EMS) controls, and Demand Limiting Controls.

Space Name

will result in one instance of the internal gain, named <Object Name>. The full magnitude of the gain will be applied to the Space using the design level, space floor area, or space occupancy as appropriate.

SpaceList Name

will result in one instance of the internal gain for each Space in the SpaceList, named <Space Name> <Object Name>. The full magnitude of the gain will be applied to each Space in the SpaceList using the design level, space floor area, or space occupancy as appropriate.

Zone Name

will result in one instance of the internal gain for each Space in the Zone. If there is only one Space in the Zone, then the single instance will be named <Object Name>. If there is more than one Space in the Zone, then each instance will be named <Space Name> <Object Name>. The full magnitude of the gain will be split between the Spaces in the Zone apportioned by the Space floor area or occupancy depending on the input method.

ZoneList Name

will result in one instance of the internal gain for each Space in each Zone in the ZoneList. Each instance will be named <Space Name> <Object Name>. The full magnitude of the gain will be applied to each Zone in the ZoneList then split between the Spaces in each Zone apportioned by the Space floor area or occupancy depending on the input method.

One exception to this is ElectricEquipment:ITE:AirCooled which only allows Zone or Space Name. If a Zone Name is specified which contains more than one Space, the same rules apply.

As an example, assume that Zone 1 contains Space 1A and Space 1B, and Zone 2 contains only Space 2 (objects are abbreviated for clarity):

Space,
Space 1A, !- Name
Zone 1,   !- Zone Name
75.0,     !- Floor Area

Space,
Space 1B, !- Name
Zone 1;   !- Zone Name
25.0,     !- Floor Area

Space,
Space 2,  !- Name
Zone 2,   !- Zone Name

SpaceList,
All Spaces, !- Name
Space 1A,   !- Space 1 Name
Space 1B,   !- Space 2 Name
Space 2,    !- Space 3 Name

People,
Office People, !- Name
Zone 1,     !- Zone or ZoneList or Space or SpaceList Name
100.0,      !- Number of People

People,
Lunchroom People, !- Name
Zone 2,     !- Zone or ZoneList or Space or SpaceList Name
50.0,       !- Number of People

People,
Cleaning Crew, !- Name
All Spaces, !- Zone or ZoneList or Space or SpaceList Name
2.0,        !- Number of People

Resulting instances of People:

Space 1A Office People, 75 people. (concatenated name, apportioned by space floor area)
Space 1B Office People, 25 people. (concatenated name, apportioned by space floor area)
Lunchroom People, 50 people.       (simple object name for a single space)
Space 1A Cleaning Crew, 2 people.  (full load applied to each space in SpaceList)
Space 1B Cleaning Crew, 2 people.
Space 2 Cleaning Crew, 2 people.

People[LINK]

The people statement is used to model the occupant’s effect on the space conditions. The following definition addresses the basic affects as well as providing information that can be used to report the thermal comfort of a group of occupants. The Fanger, Pierce Two-Node, Kansas State University Two-Node, ASHRAE Standard 55 Elevated Air Cooling Effect model, and ASHRAE Standard 55 Ankle Draft Risk thermal comfort models are available in EnergyPlus. A user may select any of these models for each People statement by simply adding the appropriate choice keyword after the air velocity schedule name. Thermal comfort calculations will only be made for people statements that include specific requests for these thermal comfort models. This object also requires input of carbon dioxide generation rate based on people activity level for zone carbon dioxide simulations.

Inputs[LINK]

Field: Name[LINK]

The name of the People object. Must be unique across all People objects.

Field: Zone or ZoneList or Space or SpaceList Name[LINK]

This field applies this People object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the people/area and area/person options of the Number of People Calculation Method to place a varying number of people at the same density in each zone or space. The names of the actual people objects may be concatenated as <Space Name> <People Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.

When multiple people objects are defined for the same zone, and they have different SET, PMV, Heat/Cold Stress Temperature Threshold, a warning message will be produced to caution users that zone-level resilience metrics results will only be meaningful if each zone has at most one People object defined. This is especially true for SET Degree-Hours and Discomfort-Weighted Exceedance Hours tables. In the SET Degree-Hour case, this is because in the calculation of zone level Heating/Cooling SET Degree-Hours, if multiple People objects are defined for one zone, EnergyPlus will only use the SET of one People object to compute the zone level SET Degree-Hours, and neglecting the SET of other people object defined in the same zone. As a result, when multiple people objects with different SET, PMV, or Heat/Cold Stress Temperature are linked to one zone, the corresponding zone-level resilience metrics results might be invalid.

Field: Number of People Schedule Name[LINK]

This field is the name of the schedule (ref: Schedules) that modifies the number of people parameter (see Number of People Calculation Method and related fields). The schedule values can be any positive number. The actual number of people in a zone as defined by this statement is the product of the number of people field and the value of the schedule specified by name in this field.

Field: Number of People Calculation Method[LINK]

This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal number of occupants (people) in the Zone. The key/choices are:

People

With this choice, the method used will be a straight insertion of the number of occupants (people). (The Number of People field should be filled.)

People/Area

With this choice, the method used will be a factor per floor area of the zone or space. (The People per Zone Floor Area field should be filled).

Area/Person

With this choice, the method used will be a factor of floor area per person. (The Zone Floor Area per Person field should be filled).

Field: Number of People[LINK]

This field is used to represent the maximum number of people in a zone that is then multiplied by a schedule fraction (see schedule field). In EnergyPlus, this is slightly more flexible in that the number of people could be a “diversity factor” applied to a schedule of real numbers. Note that while the schedule value can vary from hour to hour, the number of people field is constant for all simulation environments.

Field: People per Floor Area[LINK]

This factor (person/m2) is used, along with the Zone or Space Floor Area to determine the maximum number of people as described in the Number of People field. The choice from the method field should be “people/area”.

Field: Floor Area per Person[LINK]

This factor (m2/person) is used, along with the Zone or Space Floor Area to determine the maximum number of people as described in the Number of People field. The choice from the method field should be “area/person”.

Field: Fraction Radiant[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the type of heat being given off by people in a zone. The number specified in this field will be multiplied by the total sensible energy emitted by people to give the amount of long wavelength radiation gain from human beings in a zone. The remainder of the sensible load is assumed to be convective heat gain. Note that latent gains from people are not included in either the radiant or convective heat gains. See the Engineering Reference document for more details. Default value is 0.30.

Field: Sensible Heat Fraction[LINK]

The user can use this field to specify a fixed sensible fraction for the heat gain due to this PEOPLE object. Normally the program calculates the sensible/latent split; this field gives the user control over this split. This field is autocalculated: if the field is blank or autocalculate, the program will calculate the sensible/latent split; if a value is entered, it will be used as the sensible fraction of the current total heat gain.

Field: Activity Level Schedule Name[LINK]

This field is the name of the schedule that determines the amount of heat gain per person in the zone under design conditions. This heat gain impacts the basic zone heat balance as well as the modeling of thermal comfort. This value is modified somewhat based on a correlation to account for variations in space temperature. The schedule values may be any positive number and the units for this parameter is Watts per person. This schedule represents the total heat gain per person including convective, radiant, and latent. An internal algorithm is used to determine what fraction of the total is sensible and what fraction is latent. Then, the sensible portion is divided into radiant and convective portions using the value specified for Fraction Radiant (above). See the Engineering Reference document for more details.

Values for activity level can range anywhere from approximately 100-150 Watts per person for most office activities up to over 900 Watts per person for strenuous physical activities such as competitive wrestling. The following table (Table 1) is based on Table [table:wind-speed-profile-coefficients-ashrae] from the 2005 ASHRAE Handbook of Fundamentals, page 8.6. In addition to the information from the ASHRAE HOF, there is an added column of values in W/Person such as necessary for the activity level schedule values. This column uses the standard adult body surface area of 1.8 m2 to multiply the activity levels in W/m2 that are used in the table. Warnings are produced when the activity level schedule values fall outside normal ranges. Having too low or too high values can also skew thermal comfort reporting values.

Field: Carbon Dioxide Generation Rate[LINK]

This numeric input field specifies carbon dioxide generation rate per person with units of m3/s-W. The total carbon dioxide generation rate from this object is:

Number of People * People Schedule * People Activity * Carbon Dioxide Generation Rate. The default value is 3.82E-8 m3/s-W (obtained from ASHRAE Standard 62.1-2007 value at 0.0084 cfm/met/person over the general adult population). The maximum value can be 10 times the default value.

Field: Cold Stress Temperature Threshold[LINK]

This field is used in the calculation of hours of safety for cold events, which is defined as the longest duration (number of hours), starting from the beginning time of the risk period (e.g., the start time of a power outage), to not below a certain temperature threshold (specified in this field). If not specified, 60F (or 15.56C) will be used as the default temperature threshold.

Field: Heat Stress Temperature Threshold[LINK]

This field is used in the calculation of hours of safety for hot events, which is defined as the longest duration (number of hours), starting from the beginning time of the risk period (e.g., the start time of a power outage), to not above a certain temperature threshold (specified in this field). If not specified, 86F (or 30C) will be used as the default temperature threshold.

Field: Enable ASHRAE 55 comfort warnings[LINK]

This field accepts either “Yes” or “No” as values. When “Yes” is specified, warnings are generated when the space conditions are outside of the ASHRAE 55 comfort range as discussed in the sections that follow titled “Simplified ASHRAE 55-2004 Graph Related Outputs” and “Simplified ASHRAE 55 Warnings.” The default is not to provide these warnings so if you want to know if your space is outside this comfort range you must set this field to Yes.

Metabolic Rates for Various Activities
Activity Activity Level Schedule Value (W/Person) Activity Level (W/m2) met*
Resting
Sleeping 72 40 0.7
Reclining 81 45 0.8
Seated, quiet 108 60 1
Standing, relaxed 126 70 1.2
Walking (on level surface)
3.2 km/h (0.9 m/s) 207 115 2
4.3 km/h (1.2 m/s) 270 150 2.6
6.4 km/h (1.8 m/s) 396 220 3.8
Office Activities
Reading, seated 99 55 1
Writing 108 60 1
Typing 117 65 1.1
Filing, seated 126 70 1.2
Filing, standing 144 80 1.4
Walking about 180 100 1.7
Lifting/packing 216 120 2.1
Miscellaneous Occupational Activities
Cooking 171 to 207 95 to 115 1.6 to 2.0
Housecleaning 207 to 360 115 to 200 2.0 to 3.4
Seated, heavy limb movement 234 130 2.2
Machine work 189 105 1.8
sawing (table saw) 207 to 252 115 to 140 2.0 to 2.4
light (electrical industry) 423 235 4
Handling 50 kg bags 423 235 4
Pick and shovel work 423 to 504 235 to 280 4.0 to 4.8
Miscellaneous Leisure Activities
Dancing, social 252 to 459 140 to 255 2.4 to 4.4
Calisthenics/exercise 315 to 423 175 to 235 3.0 to 4.0
Tennis, singles 378 to 486 210 to 270 3.6 to 4.0
Basketball, competitive 522 to 792 290 to 440 5.0 to 7.6
Wrestling, competitive 738 to 909 410 to 505 7.0 to 8.7
*Note that one met = 58.1 W/m2

Field: Mean Radiant Temperature Calculation Type[LINK]

This field specifies the type of Mean Radiant Temperature (MRT) calculation the user wishes to use for the thermal comfort model. At the present time, there are three options for MRT calculation type: enclosure averaged, surface weighted, and a list of angle factors. The default calculation is “EnclosureAveraged” and is used if field is left blank. In the enclosure averaged MRT calculation, the MRT used for the thermal comfort calculations is for an “average” point in the zone. MRT is calculated based on an area-emissivity weighted average of all of the surfaces in the same radiant enclosure (one or more Spaces). In cases where the emissivity of all of the surfaces are sufficiently small (near zero), the mean radiant temperature will be set to the mean air temperature of the space to avoid divide by zero errors. The other MRT calculation type is “SurfaceWeighted”. The goal of this calculation type is to estimate a person in the space close to a particular surface without having to define exact view factors for all of the surfaces and the location of the person in the space. The MRT used in the thermal comfort calculations when the “surface weighted” calculation type is selected is actually the average of the temperature of the surface to which the person is closest (defined by the next field “Surface Name”) and the enclosure averaged MRT (defined above). The surface temperature alone is not used because in theory the maximum view factor from a person to any flat surface is roughly 0.5. In the “surfaceweighted” calculation, the surface in question actually gets slightly more weighting than 50% since the surface selected is still a part of the zone average MRT calculation. Again, this simplification was made to avoid the specification of view factors and the exact location of the person.

A third option is to use “AngleFactor”. This option allows for more explicit positioning of the person within the space by defining the angle factors from the person to the various surfaces in the enclosure. This option requires the user to list the surfaces that the person can see from a radiation standpoint and also define the angle (or view) factor for each surface. The ComfortViewFactorAngles object (see next object description) is intended to give the user this opportunity.

Field: Surface Name/Angle Factor List Name[LINK]

This field is only valid when the user selects “SurfaceWeighted” or “AngleFactor” for the MRT calculation type (see the previous input field description). In the case of “SurfaceWeighted”, the field is the name of a surface within the enclosure the people are residing. This surface will be used in the MRT calculation as defined above to come up with a more representative MRT for a person near a particular surface. The MRT used for thermal comfort calculations using the “SurfaceWeighted” MRT calculation method is the average of the temperature of the surface specified in this field and the “zone averaged” MRT (see the Mean Radiant Temperature calculation type field above). In the case of “AngleFactor”, the field is the name of a ComfortViewFactorAngles input object defined elsewhere. This field is required when the previous field is set to “SurfaceWeighted” or “AngleFactor” and is set to run one of the following thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 or AnkleDraftASH55.

Field: Work Efficiency Schedule Name[LINK]

This field is the name of the schedule that determines the efficiency of energy usage within the human body that will be used for thermal comfort calculations. Note that all energy produced by the body is assumed to be converted to heat for the zone heat balance calculation. A value of zero corresponds to all of the energy produced in the body being converted to heat. A value of unity corresponds to all of the energy produced in the body being converted to mechanical energy. The values for this parameter defined in the schedule must be between 0.0 and 1.0. Any value greater than zero will result in a reduction of heat that impacts the thermal comfort energy balance of a person within the space, resulting in PMV results appearing lower than expected. Ensure that if this value is non-zero, the base activity level is chosen to ensure that the net activity converted to heat and zone conditions are sufficient to maintain thermal comfort. This field is required to run one of the following thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 or AnkleDraftASH55. If a schedule is listed here but no thermal comfort model is selected, then a warning message will be produced and this schedule will be listed as unused in the error file.

Field: Clothing Insulation Calculation Method[LINK]

This field is a key/choice field that tells which of the next two fields are filled and is descriptive of the method for calculating the clothing insulation value of occupants (people) in the Zone. The key/choices are:

  • ClothingInsulationSchedule

With this choice, the method used will be a straight insertion of the scheduled clothing insulation values of occupants (people). (The Clothing Insulation Schedule Name field should be filled.)

  • DynamicClothingModelASHRAE55

With this choice, the method used will be the dynamic predictive clothing insulation model developed by Schiavon and Lee (2013) based on 6,333 selected observations taken from ASHRAE RP-884 and RP-921 databases. It varies the clothing insulation as a function of outdoor air temperature measured at 6am as illustrated below.

  • CalculationMethodSchedule

With this choice, the method used can be either the ClothingInsulationSchedule or the DynamicClothingModelASHRAE55, depending on a schedule (to be entered as the next field) that determines which method to use in different time of a day. When this option is chosen, the next field “Clothing Insulation Calculation Method Schedule Name” is a required input.

Graphical representation of the dynamic predictive clothing insulation model [fig:graphical-representation-of-the-dynamic]

Graphical representation of the dynamic predictive clothing insulation model [fig:graphical-representation-of-the-dynamic]

Field: Clothing Insulation Calculation Method Schedule Name[LINK]

This field specifies which clothing insulation method (ClothingInsulationSchedule or DynamicClothingModelASHRAE55) to use at a particular time of the day. A schedule value of 1 means the ClothingInsulationSchedule method, and 2 means the DynamicClothingModelASHRAE55 method. This field is only required when the “Clothing Insulation Calculation Method” field is set to CalculationMethodSchedule. If this field is left blank, the specified clothing insulation calculation method will be used and not changed during the simulation.

Field: Clothing Insulation Schedule Name[LINK]

This field is the name of the schedule that defines the amount of clothing being worn by a typical zone occupant during various times in the simulation period. The choice from the Clothing Insulation Calculation Method field should be “ClothingInsulationSchedule”. This parameter must be a positive real number and has units of Clo. Typical values for Clo can be seen in the ASHRAE 2009 HOF Table 7, page 9.8 (for clothing ensembles) and Table [table:window-modeling-options], page 9.9 (for garment values) ) or https://comfort.cbe.berkeley.edu/. This field is required to run one of the following thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 or AnkleDraftASH55. If a schedule is listed here but no thermal comfort model is selected, then a warning message will be produced and this schedule will be listed as unused in the error file.

Field: Air Velocity Schedule Name[LINK]

This field is the name of the schedule that approximates the amount of air movement in the space as a function of time throughout the simulation period. The user has control over this parameter through the schedule that requires the individual numbers in the schedule to be positive real numbers having units of meters per second. This field is required to run one of the following thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 or AnkleDraftASH55. If a schedule is listed here but no thermal comfort model is selected, then a warning message will be produced and this schedule will be listed as unused in the error file.

Field: Thermal Comfort Model Type (up to 7 allowed)[LINK]

The final one to five fields are optional and are intended to trigger various thermal comfort models within EnergyPlus. By entering the keywords Fanger, Pierce, KSU, AdaptiveASH55, AdaptiveCEN15251, CoolingEffectASH55, and AnkleDraftASH55, the user can request the Fanger, Pierce Two-Node, Kansas State UniversityTwo-Node, the adaptive comfort models of the ASHRAE Standard 55 and CEN Standard 15251, ASHRAE Standard 55 Elevated Air Cooling Effect model, and ASHRAE Standard 55 Ankle Draft Risk model results for this particular people statement. Detailed descriptions and requirements of the seven models as listed below.

Fanger

Fanger’s Comfort model is applied to calculate related thermal comfort metrics. Fanger Model PMV, PPD, and Clothing Surface Temperature are calculated and reported as each time step. Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, and Air Velocity Schedule Name.

Pierce

The Pierce Two-Node model is applied to calculate related thermal comfort metrics. Pierce Model Effective Temperature PMV, Standard Effective Temperature PMV, Discomfort Index, Thermal Sensation Index, and Standard Effective Temperature are calculated and reported as each time step.Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, and Air Velocity Schedule Name.

KSU

The KSU Two-Node Model is applied to calculate related thermal comfort metrics. KSU Model Thermal Sensation Vote is calculated and reported as each time step. Note that the KSU model is computationally intensive and may noticeably increase the execution time of the simulation. Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, and Air Velocity Schedule Name.

AdaptiveASH55

Adaptive Comfort Model Based on ASHRAE Standard 55-2010 is applied to calculate related thermal comfort metrics. ASHRAE 55 Adaptive Model 90% Acceptability Status, 80% Acceptability Status, Running Average Outdoor Air Temperature, and the Adaptive Model Temperature are calculated and reported as each time step. AdaptiveASH55 is only applicable when the running average outdoor air temperature for the past 7 days is between 10.0 and 33.5C.

AdaptiveCEN15251

Adaptive Comfort Model Based on European Standard EN15251-2007 is applied to calculate related thermal comfort metrics. CEN 15251 Adaptive Model Category I/II/II Status, Running Average Outdoor Air Temperature, and the Adaptive Model Temperature are calculated and reported as each time step. AdaptiveCEN15251 is only applicable when the running average outdoor air temperature for the past 30 days is between 10.0 and 30.0C.

CoolingEffectASH55

ASHRAE 55-2017 Elevated Air Speed Cooling Effect Model is applied to calculate related thermal comfort metrics. Elevated Air Speed Cooling Effect, Cooling Effect Adjusted PMV, and Cooling Effect Adjusted PPD are calculated and reported as each time step. Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, and Air Velocity Schedule Name.

AnkleDraftASH55

ASHRAE 55-2017 Ankle Draft Risk Model is applied to calculate related thermal comfort metrics. Zone Thermal Comfort ASHRAE 55 Ankle Draft PPD is calculated and reported as each time step. Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, Air Velocity Schedule Name, and Ankle Level Air Velocity Schedule Name. Ankle draft PPD calculations are only applicable for relative air velocity is below 0.2 m/s, and the subject’s metabolic rate and clothing level should be kept below 1.3 met and 0.7 clo. PPD at ankle draft will be set to -1.0 if if these conditions are not met.

For descriptions of the thermal comfort calculations, see the Engineering Reference document.

Note that since up to seven models may be specified, the user may opt to have EnergyPlus calculate the thermal comfort for people identified with this people statement using all seven models if desired.

Field: Ankle Level Air Velocity Schedule Name[LINK]

This field is the name of the schedule that approximates the amount of air movement at the occupants’ ankle level (0.1 m above floor level) as a function of time throughout the simulation period. The user has control over this parameter through the schedule that requires the individual numbers in the schedule to be positive real numbers having units of meters per second. This field is required to run the AnkleDraftASH55 thermal comfort model. If a schedule is listed here but no thermal comfort model is selected, then a warning message will be produced and this schedule will be listed as unused in the error file.

The following IDF example allows for a maximum of 31 people with scheduled occupancy of “Office Occupancy”, 60% radiant using an Activity Schedule of “Activity Sch”. The example allows for thermal comfort reporting.

People,
  Kitchen_ZN_1_FLR_1,   !- Name
  Kitchen_ZN_1_FLR_1,   !- Zone or ZoneList or Space or SpaceList Name
  BLDG_OCC_SCH,         !- Number of People Schedule Name
  People,               !- Number of People Calculation Method
  25.2000,,,            !- Number of People, People per Zone Floor Area, Zone Floor Area per Person
  0.3000,               !- Fraction Radiant
  AUTOCALCULATE,        !- Sensible Heat Fraction
  ACTIVITY_SCH,         !- Activity Level Schedule Name
  3.82E-8,              !- Carbon Dioxide Generation Rate {m3/s-W}
  No,                   !- Enable ASHRAE 55 Comfort Warnings
  EnclosureAveraged,    !- Mean Radiant Temperature Calculation Type
  ,                     !- Surface Name/Angle Factor List Name
  WORK_EFF_SCH,         !- Work Efficiency Schedule Name
  ClothingInsulationSchedule, !- Clothing Insulation Calculation Method
  ,                     !- Clothing Insulation Calculation Method Schedule Name
  CLOTHING_SCH,         !- Clothing Insulation Schedule Name
  AIR_VELO_SCH,         !- Air Velocity Schedule Name
  Fanger;               !- Thermal Comfort Model 1 Type

A simpler example, without using the thermal comfort reporting option:

People,
  RIGHT FORK,     !- Name
  RIGHT FORK,     !- Zone or ZoneListName
  Dorm Occupancy, !- Number of People Schedule Name
  people,         !- Number of People Calculation Method
  8.00000,        !- Number of People,
  ,               !- People per Zone Floor Area
  ,               !- Zone Floor Area per Person
  0.6000000,      !- Fraction Radiant
  Autocalculate,  !- Sensible Heat Fraction
  Activity Sch,   !- Activity level Schedule Name

And with the sensible fraction specified:

People,
  SPACE1-1 People 1,    !- Name
  SPACE1-1,             !- Zone or ZoneListName
  OCCUPY-1,             !- Number of People Schedule Name
  people,               !- Number of People Calculation Method
  11,                   !- Number of People
  ,                     !- People per Zone Floor Area
  ,                     !- Zone Floor Area per Person
  0.3,                  !- Fraction Radiant
  0.55,                 !- Sensible Heat Fraction
  ActSchd;              !- Activity level Schedule Name

Global People Object:

ZoneList,AllOccupiedZones,SPACE1-1,SPACE2-1,SPACE3-1,SPACE4-1,SPACE5-1;

People,
  AllZones with People, !- Name
  AllOccupiedZones,     !- Zone or ZoneList or Space or SpaceList Name
  OCCUPY-1,             !- Number of People Schedule Name
  People/Area,          !- Number of People Calculation Method
  ,                     !- Number of People
  .11,                  !- People per Floor Area {person/m2}
  ,                     !- Floor Area per Person {m2/person}
  0.3,                  !- Fraction Radiant
  ,                     !- Sensible Heat Fraction
  ActSchd,              !- Activity Level Schedule Name
  3.82E-8,              !- Carbon Dioxide Generation Rate {m3/s-W}
  No,                   !- Enable ASHRAE 55 Comfort Warnings
  surfaceweighted,      !- Mean Radiant Temperature Calculation Type
  Zn001:Wall001,        !- Surface Name/Angle Factor List Name
  Work Eff Sch,         !- Work Efficiency Schedule Name
  ClothingInsulationSchedule,  !- Clothing Insulation Calculation Method
  ,                     !- Clothing Insulation Calculation Method Schedule Name
  Clothing Sch,         !- Clothing Insulation Schedule Name
  Air Velo Sch,         !- Air Velocity Schedule Name
  FANGER,               !- Thermal Comfort Model 1 Type
  PIERCE,               !- Thermal Comfort Model 2 Type
  KSU;                  !- Thermal Comfort Model 3 Type

Outputs[LINK]

People objects have output variables for individual objects and for space and zone totals.

People specific outputs include:

  • Zone,Average,People Occupant Count []

  • Zone,Sum,People Radiant Heating Energy [J]

  • Zone,Average,People Radiant Heating Rate [W]

  • Zone,Sum,People Convective Heating Energy [J]

  • Zone,Average,People Convective Heating Rate [W]

  • Zone,Sum,People Sensible Heating Energy [J]

  • Zone,Average,People Sensible Heating Rate [W]

  • Zone,Sum,People Latent Gain Energy [J]

  • Zone,Average,People Latent Gain Rate [W]

  • Zone,Sum,People Total Heating Energy [J]

  • Zone,Average,People Total Heating Rate [W]

  • Zone,Average,Space People Occupant Count []

  • Zone,Sum,Space People Radiant Heating Energy [J]

  • Zone,Average,Space People Radiant Heating Rate [W]

  • Zone,Sum,Space People Convective Heating Energy [J]

  • Zone,Average,Space People Convective Heating Rate [W]

  • Zone,Sum,Space People Sensible Heating Energy [J]

  • Zone,Average,Space People Sensible Heating Rate [W]

  • Zone,Sum,Space People Latent Gain Energy [J]

  • Zone,Average,Space People Latent Gain Rate [W]

  • Zone,Sum,Space People Total Heating Energy [J]

  • Zone,Average,Space People Total Heating Rate [W]

  • Zone,Average,Zone People Occupant Count []

  • Zone,Sum,Zone People Radiant Heating Energy [J]

  • Zone,Average,Zone People Radiant Heating Rate [W]

  • Zone,Sum,Zone People Convective Heating Energy [J]

  • Zone,Average,Zone People Convective Heating Rate [W]

  • Zone,Sum,Zone People Sensible Heating Energy [J]

  • Zone,Average,Zone People Sensible Heating Rate [W]

  • Zone,Sum,Zone People Latent Gain Energy [J]

  • Zone,Average,Zone People Latent Gain Rate [W]

  • Zone,Sum,Zone People Total Heating Energy [J]

  • Zone,Average,Zone People Total Heating Rate [W]

  • Zone,Average,People Air Temperature [C]

  • Zone,Average,People Air Relative Humidity [%]

  • Zone,Average,Zone Thermal Comfort Mean Radiant Temperature [C]

  • Zone,Average,Zone Thermal Comfort Operative Temperature [C]

  • Zone,Average,Zone Thermal Comfort Fanger Model PMV []

  • Zone,Average,Zone Thermal Comfort Fanger Model PPD [%]

  • Zone,Average,Zone Thermal Comfort Clothing Surface Temperature [C]

  • Zone,Average,Zone Thermal Comfort Pierce Model Effective Temperature PMV []

  • Zone,Average,Zone Thermal Comfort Pierce Model Standard Effective Temperature PMV []

  • Zone,Average,Zone Thermal Comfort Pierce Model Discomfort Index []

  • Zone,Average,Zone Thermal Comfort Pierce Model Thermal Sensation Index []

  • Zone,Average,Zone Thermal Comfort Pierce Model Standard Effective Temperature [C]

  • Zone,Average,Zone Thermal Comfort KSU Model Thermal Sensation Index []

  • Zone,Average,Zone Thermal Comfort ASHRAE 55 Adaptive Model 80% Acceptability Status []

  • Zone,Average,Zone Thermal Comfort ASHRAE 55 Adaptive Model 90% Acceptability Status []

  • Zone,Average,Zone Thermal Comfort ASHRAE 55 Adaptive Model Running Average Outdoor Air Temperature [C]

  • Zone,Average,Zone Thermal Comfort ASHRAE 55 Adaptive Model Temperature [C]

  • Zone,Average,Zone Thermal Comfort CEN 15251 Adaptive Model Category I Status []

  • Zone,Average,Zone Thermal Comfort CEN 15251 Adaptive Model Category II Status []

  • Zone,Average,Zone Thermal Comfort CEN 15251 Adaptive Model Category III Status

  • Zone,Average,Zone Thermal Comfort CEN 15251 Adaptive Model Running Average Outdoor Air Temperature [C]

  • Zone,Average,Zone Thermal Comfort CEN 15251 Adaptive Model Temperature [C]

  • Zone,Average,Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect [C]

  • Zone,Average,Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect Adjusted PMV []

  • Zone,Average,Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect Adjusted PPD []

  • Zone,Average,Zone Thermal Comfort ASHRAE 55 Ankle Draft PPD []

It should be noted that if a user is trying to output the Standard Effective Temperature (SET) that the Pierce two-node model must be selected. This variable is calculated as part of the Pierce model and can be seen in the output by requesting Zone Thermal Comfort Pierce Model Standard Effective Temperature.

People Occupant Count [][LINK]

This field is the number of people for this PEOPLE object during the timestep in question.

People Radiant Heating Rate [W][LINK]

People Radiant Heating Energy [J][LINK]

These output variables are the amount of radiant heat gain for this People object in Watts (for rate) or Joules. This is determined by the current sensible heat gain from people to the zone and the “Fraction Radiant” specified in the input. The radiant gains from people are distributed to the surfaces using an area weighting scheme.

People Convective Heating Rate [W][LINK]

People Convective Heating Energy [J][LINK]

These output variables are the amount of convective heat gain for this People object in Watts (for rate) or Joules. This is determined by the current sensible heat gain from people to the zone and the “Fraction Radiant” specified in input. Note that the radiant and convective gains should add up to the sensible heat gain from people. The convective heat gain from people is added to the zone air heat balance directly.

People Latent Gain Rate [W][LINK]

People Latent Gain Energy [J][LINK]

These output variables are the amount of latent heat gain for this People object in Watts (for rate) or Joules. This amount is based on the number of people in the space as well as the total amount of energy produced by a typical person defined by the activity schedule in the input. An internal algorithm is used to determine what fraction of the total is sensible and what fraction is latent. Details about this split are included in the Engineering Reference document.

People Sensible Heating Rate [W][LINK]

People Sensible Heating Energy [J][LINK]

These output variables are the amount of sensible heat gain for this People object in Watts (for rate) or Joules. This amount is based on the number of people in the space as well as the total amount of energy produced by a typical person defined by the activity schedule in the input. An internal algorithm (described in the Engineering Reference document) is used to determine what fraction of the total is sensible and what fraction is latent. The sensible plus the latent heat gain from people equals the total gain specified in the input.

People Total Heating Rate [W][LINK]

People Total Heating Energy [J][LINK]

These output variables are the total amount of heat gain for this People object in Watts (for rate) or Joules. This is derived from the activity level times the number of occupants.

People Air Temperature [C][LINK]

This output variable represents the zone air temperature based on the Fanger thermal comfort model. If there is a ZoneControl:Thermostat:ThermalComfort object specified and the thermal zone is occupied, then the value of “People Air Temperature" is determined based on the thermal comfort that satisfies the thermal comfort setpoint PMV value specified; otherwise, it is set to average zone air temperature.

People Air Relative Humidity [%][LINK]

This output variable represents the zone air relative humidity based on the Fanger thermal comfort model. If there is a ZoneControl:Thermostat:ThermalComfort object specified and the thermal zone is occupied, then the value of “People Air Relative Humidity" is determined from the mean zone air temperature and zone air humidity ratio that satisfies the thermal comfort setpoint PMV value specified; otherwise, it is calculated from the zone air temperature and humidity ratio averaged over the time step.

Space or Zone People Occupant Count [][LINK]

This field is the total number of people within the space or zone during the timestep in question.

Space or Zone People Radiant Heating Rate [W][LINK]

Space or Zone People Radiant Heating Energy [J][LINK]

These output variables are the amount of radiant heat gain from people within the space or zone in Watts (for rate) or Joules. This is determined by the current sensible heat gain from people to the space or zone and the “Fraction Radiant” specified in the input. The radiant gains from people are distributed to the surfaces using an area weighting scheme.

Space or Zone People Convective Heating Rate [W][LINK]

Space or Zone People Convective Heating Energy [J][LINK]

These output variables are the amount of convective heat gain from people within the space or zone in Watts (for rate) or Joules. This is determined by the current sensible heat gain from people to the space or zone and the “Fraction Radiant” specified in input. Note that the radiant and convective gains should add up to the sensible heat gain from people. The convective heat gain from people is added to the space or zone air heat balance directly.

Space or Zone People Latent Gain Rate [W][LINK]

Space or Zone People Latent Gain Energy [J][LINK]

These output variables are the amount of latent heat gain from people within the space or zone in Watts (for rate) or Joules. This amount is based on the number of people in the space as well as the total amount of energy produced by a typical person defined by the activity schedule in the input. An internal algorithm is used to determine what fraction of the total is sensible and what fraction is latent. Details about this split are included in the Engineering Reference document.

Space or Zone People Sensible Heating Rate [W][LINK]

Space or Zone People Sensible Heating Energy [J][LINK]

These output variables are the amount of sensible heat gain from people within the space or zone in Watts (for rate) or Joules. This amount is based on the number of people in the space as well as the total amount of energy produced by a typical person defined by the activity schedule in the input. An internal algorithm (described in the Engineering Reference document) is used to determine what fraction of the total is sensible and what fraction is latent. The sensible plus the latent heat gain from people equals the total gain specified in the input.

Space or Zone People Total Heating Rate [W][LINK]

Space or Zone People Total Heating Energy [J][LINK]

These output variables are the total amount of heat gain from people within the space or zone in Watts (for rate) or Joules. Derived from the activity level times the number of occupants, this is summed for each people object within a zone.

Zone Thermal Comfort Mean Radiant Temperature [C][LINK]

This output variable is the mean radiant temperature used in the thermal comfort calculations. This value is computed according to the “MRT Calculation Type” specified in the PEOPLE object. If a high temperature radiant system is present in the zone, this value will be adjusted according to the current heater operation and the “Fraction of radiant energy incident on people” specified in the HIGH TEMP RADIANT SYSTEM object.

Zone Thermal Comfort Operative Temperature [C][LINK]

This output variable is the operative temperature as defined by the thermal comfort operations. Specifically, it is the average of the thermal comfort mean radiant temperature and the zone air temperature.

Note for all Thermal Comfort reporting: Though the published values for thermal comfort “vote” have a discrete scale (e.g. –3 to +3 or –4 to +4), the calculations in EnergyPlus are carried out on a continuous scale and, thus, reporting may be “off the scale” with specific conditions encountered in the space. This is not necessarily an error in EnergyPlus – rather a different approach that does not take the “limits” of the discrete scale values into account.

Zone Thermal Comfort Fanger Model PMV [][LINK]

This field is the “predicted mean vote” (PMV) calculated using the Fanger thermal comfort model. Details on the equations used to calculate the Fanger PMV are shown in the EnergyPlus Engineering Reference. If the zone in question is currently being controlled using a thermostat object, then the value of the PMV is determined by using the air temperature and humidity that is calculated at the system time step; otherwise, if the zone is uncontrolled, the PMV is determined using the zone air temperature and humidity that is averaged over the zone time step.

Zone Thermal Comfort Fanger Model PPD [%][LINK]

This field is the “predicted percentage of dissatisfied” (PPD) calculated using the Fanger thermal comfort model. Details on the equations used to calculate the Fanger PPD are shown in the EnergyPlus Engineering Reference. If the zone in question is currently being controlled using a thermostat object, then the value of the PPD is determined by using the air temperature and humidity that is calculated at the system time step; otherwise, if the zone is uncontrolled, the PPD is determined using the zone air temperature and humidity that is averaged over the zone time step.

Zone Thermal Comfort Clothing Surface Temperature [C][LINK]

This output variable is the calculation of the clothing surface temperature using the Fanger thermal comfort model.

Zone Thermal Comfort Pierce Model Effective Temperature PMV [][LINK]

This field is the “predicted mean vote” (PMV) calculated using the effective temperature and the Pierce two-node thermal comfort model.

Zone Thermal Comfort Pierce Model Standard Effective Temperature PMV [][LINK]

This field is the “predicted mean vote” (PMV) calculated using the “standard” effective temperature and the Pierce two-node thermal comfort model.

Zone Thermal Comfort Pierce Model Discomfort Index [][LINK]

This field is the “discomfort index” calculated using the the Pierce two-node thermal comfort model.

Zone Thermal Comfort Pierce Model Thermal Sensation Index [][LINK]

This field is the “thermal sensation index” (PMV) calculated using the Pierce two-node thermal comfort model.

Zone Thermal Comfort Pierce Model Standard Effective Temperature [C][LINK]

This field is the “standard effective temperature” (SET) calculated using the Pierce two-node thermal comfort model. Note that if a user wishes to report the Pierce Model SET that it must be done using the Pierce two-node model and the user must select “Pierce” as one of the Thermal Comfort model types as shown above in the input syntax for the People statement.

Zone Thermal Comfort KSU Model Thermal Sensation Vote [][LINK]

This field is the “thermal sensation vote” (TSV) calculated using the KSU two-node thermal comfort model.

Zone Thermal Comfort ASHRAE 55 Adaptive Model 90% Acceptability Status [][LINK]

This field is to report whether the operative temperature falls into the 90% acceptability limits of the adaptive comfort in ASHRAE 55-2010. A value of 1 means within (inclusive) the limits, a value of 0 means outside the limits, and a value of -1 means not applicable (when unoccupied or running average outdoor temp is outside the range of 10.0 to 33.5C).

Zone Thermal Comfort ASHRAE 55 Adaptive Model 80% Acceptability Status [][LINK]

This field is to report whether the operative temperature falls into the 80% acceptability limits of the adaptive comfort in ASHRAE 55-2010. A value of 1 means within (inclusive) the limits, a value of 0 means outside the limits, and a value of -1 means not applicable (when unoccupied or running average outdoor temp is outside the range of 10.0 to 33.5C).

Zone Thermal Comfort ASHRAE 55 Adaptive Model Running Average Outdoor Air Temperature [C][LINK]

This field reports the mean monthly outdoor air temperature, an input parameter for the ASHRAE-55 adaptive comfort model. This can be computed in two ways. If the .stat file is provided for the simulation, this field will reflect the monthly daily average temperature.

If the .epw file is used, the field reports the simple running average of the daily average outdoor dry-bulb temperatures of the previous 30 days.

Zone Thermal Comfort ASHRAE 55 Adaptive Model Temperature [C][LINK]

This field reports the ideal indoor operative temperature, or comfort temperature, as determined by the ASHRAE-55 adaptive comfort model. The 80% acceptability limits for indoor operative temperature are defined as no greater than 3.5C from the adaptive comfort temperature. The 90% acceptability limits are defined as no greater than 2.5C from the adaptive comfort temperature. A value of -1 means not applicable (when running average outdoor temp is outside the range of 10.0 to 33.5C).

Zone Thermal Comfort CEN 15251 Adaptive Model Category I Status[LINK]

This field is to report whether the operative temperature falls into the Category I (90% acceptability) limits of the adaptive comfort in the European Standard EN15251-2007. A value of 1 means within (inclusive) the limits, a value of 0 means outside the limits, and a value of -1 means not applicable (when unoccupied or running average outdoor temp is outside the range of 10.0 to 30.0C).

Zone Thermal Comfort CEN 15251 Adaptive Model Category II Status[LINK]

This field is to report whether the operative temperature falls into the Category II (80% acceptability) limits of the adaptive comfort in the European Standard EN15251-2007. A value of 1 means within (inclusive) the limits, a value of 0 means outside the limits, and a value of -1 means not applicable (when unoccupied or running average outdoor temp is outside the range of 10.0 to 30.0C).

Zone Thermal Comfort CEN 15251 Adaptive Model Category III Status[LINK]

This field is to report whether the operative temperature falls into the Category III (65% acceptability) limits of the adaptive comfort in the European Standard EN15251-2007. A value of 1 means within (inclusive) the limits, a value of 0 means outside the limits, and a value of -1 means not applicable (when unoccupied or running average outdoor temp is outside the range of 10.0 to 30.0C).

Zone Thermal Comfort CEN 15251 Adaptive Model Running Average Outdoor Air Temperature[LINK]

This field reports the weighted average of the outdoor air temperature of the previous seven days, an input parameter for the CEN-15251 adaptive comfort model.

Zone Thermal Comfort CEN 15251 Adaptive Model Temperature[LINK]

This field reports the ideal indoor operative temperature, or comfort temperature, as determined by the CEN-15251 adaptive comfort model. Category I, II, and II limits for indoor operative temperature are defined as no greater than 2, 3, and 4 degrees C from this value respectively. A value of -1 means not applicable (when running average outdoor temp is outside the range of 10.0 to 30.0C).

Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect[LINK]

This field is the calculated Cooling Effect of the elevated air speed in degree celsius. It is the value that, when subtracted equally from both the average air temperature and the mean radiant temperature, yields the same SET under still air as in the first SET calculation under elevated air speed.

Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect Adjusted PMV[LINK]

This field is the “predicted mean vote” (PMV) calculated using the Fanger PMV model, adjusted by the ASHRAE 55 Elevated Air Speed Cooling Effect. The Cooling Effect adjusted PMV for an environment with elevated average air speed is calculated using the adjusted average air temperature, the adjusted radiant temperature, and still air (0.1 m/s).

Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect Adjusted PPD[LINK]

This field is the “predicted percentage of dissatisfied” (PPD) calculated using the Fanger PMV-PPD model, adjusted by the ASHRAE 55 Elevated Air Speed Cooling Effect. The Cooling Effect adjusted PPD for an environment with elevated average air speed is calculated using the adjusted average air temperature, the adjusted radiant temperature, and still air (0.1 m/s).

Zone Thermal Comfort ASHRAE 55 Ankle Draft PPD[LINK]

This field is the “predicted percentage of dissatisfied” (PPD) on draft at ankle level. It is used as the metric to evaluate the ankle draft risk as a function of PMV and air speed at the ankle level (0.1 m).

Outputs[LINK]

The following output variables are all based on whether the humidity ratio and the operative temperature is within the region shown in ASHRAE Standard 55-2004 in Figure 5.2.1.1. For these outputs the operative temperature is simplified to be the average of the air temperature and the mean radiant temperature. For summer, the 0.5 Clo level is used and, for winter, the 1.0 Clo level is used. The graphs below are based on the following tables which extend the ASHRAE values to zero humidity ratio.

Winter Clothes (1.0 Clo)
Operative Temperature (C) Humidity Ratio (kgWater/kgDryAir)
19.6 0.012
23.9 0.012
26.3 0.000
21.7 0.000
Winter Comfort Range [fig:winter-comfort-range]

Winter Comfort Range [fig:winter-comfort-range]

Summer Clothes (0.5 Clo)
Operative Temperature (C) Humidity Ratio (kgWater/kgDryAir)
23.6 0.012
26.8 0.012
28.3 0.000
25.1 0.000
Summer Comfort Range [fig:summer-comfort-range]

Summer Comfort Range [fig:summer-comfort-range]

Zone Thermal Comfort ASHRAE 55 Simple Model Summer Clothes Not Comfortable Time[hr][LINK]

The time when the zone is occupied that the combination of humidity ratio and operative temperature is not in the ASHRAE 55-2004 summer clothes region (see above)

Zone Thermal Comfort ASHRAE 55 Simple Model Winter Clothes Not Comfortable Time[hr][LINK]

The time when the zone is occupied that the combination of humidity ratio and operative temperature is not in the ASHRAE 55-2004 winter clothes region (see above)

Zone Thermal Comfort ASHRAE 55 Simple Model Summer or Winter Clothes Not Comfortable Time[hr][LINK]

The time when the zone is occupied that the combination of humidity ratio and operative temperature is not in the ASHRAE 55-2004 summer or winter clothes region (see above)

Facility Thermal Comfort ASHRAE 55 Simple Model Summer Clothes Not Comfortable Time[hr][LINK]

The time when any zone is occupied that the combination of humidity ratio and operative temperature is not in the ASHRAE 55-2004 summer clothes region (see above)

Facility Thermal Comfort ASHRAE 55 Simple Model Winter Clothes Not Comfortable Time [hr][LINK]

The time when any zone is occupied that the combination of humidity ratio and operative temperature is not in the ASHRAE 55-2004 winter clothes region (see above)

Facility Thermal Comfort ASHRAE 55 Simple Model Summer or Winter Clothes Not Comfortable Time [hr][LINK]

The time when any zone is occupied that the combination of humidity ratio and operative temperature is not in the ASHRAE 55-2004 summer or winter clothes region (see above)

Simplified ASHRAE 55 Warnings[LINK]

The simplified ASHRAE 55 calculations may be computed for occupied zones and, possibly, warnings are shown on the .err file at the end of each simulated environment. To enable this option set the “Enable ASHRAE 55 comfort warnings” field of the People object to Yes. These warnings will not be generated by default.

If you enable the warnings, the simplified ASHRAE 55 calculations are done for occupied zones and, possibly, warnings are shown on the .err file at the end of each simulated environment.

** Warning ** More than 4% of time (350.4 hours) uncomfortable in zone ZSF1
** ~~~ ** 553.0 hours were uncomfortable based on ASHRAE 55-2004 graph (Section 5.2.1.1)
** ~~~ ** During Environment [10/01 - 09/30]: CHICAGO IL USA TMY2-94846 WMO\# = 725300
** Warning ** More than 4% of time (350.4 hours) uncomfortable in zone ZNF1
** ~~~ ** 827.8 hours were uncomfortable based on ASHRAE 55-2004 graph (Section 5.2.1.1)
** ~~~ ** During Environment [10/01 - 09/30]: CHICAGO IL USA TMY2-94846 WMO\# = 725300
** Warning ** More than 4% of time (350.4 hours) uncomfortable in zone ZSF2
** ~~~ ** 593.5 hours were uncomfortable based on ASHRAE 55-2004 graph (Section 5.2.1.1)
** ~~~ ** During Environment [10/01 - 09/30]: CHICAGO IL USA TMY2-94846 WMO\# = 725300
** Warning ** More than 4% of time (350.4 hours) uncomfortable in zone ZNF2
** ~~~ ** 875.8 hours were uncomfortable based on ASHRAE 55-2004 graph (Section 5.2.1.1)
** ~~~ ** During Environment [10/01 - 09/30]: CHICAGO IL USA TMY2-94846 WMO\# = 725300

You may decide if you need to change parameters to reduce these “uncomfortable” hours. The individual output variables shown previously may help you get more details on when these are occurring.

Following are some suggestions that might be applicable:

  • Eliminate occupancy when conditioning equipment is off.

  • Note that the ASHRAE graph lower limit is (19.6C to 21.7C)—heating setpoints may need to be nearer 22.2C (72F) than 21.1C (70F).

  • Unoccupied heating setpoint should be nearer 16.7C (62F) rather than 12.8C (55F) to reduce the start up recovery.

  • Start the occupied setpoint schedule, fan availability schedule, cooling pump availability schedule, reheat coil availability, one hour before occupancy. Seasonal turn on and off of equipment may cause more warnings (but potentially more energy consumption).

  • Unoccupied cooling setpoint should be nearer 29.4C (85F) rather than 40.0C (104F) to reduce the start up recovery.

ComfortViewFactorAngles[LINK]

When requesting EnergyPlus to do a thermal comfort calculation, the program user has three options for defining how the mean radiant temperature will be calculated. The user may select “EnclosureAveraged” which results in a mean radiant temperature that is characteristic of an “average” location near the center of the enclosure (one or more Spaces). The user may also elect to place the person near a particular surface by selecting “SurfaceWeighted” in the People statement. This takes the average of the enclosure mean radiant temperature and the temperature of the surface that the person is near and uses this value as the mean radiant temperature when calculating thermal comfort.

The third option is for the user to more explicitly position the person within the space by defining the angle factors from the person to the various surfaces in the same radiant enclosure. This option requires the user to list the surfaces that the person can see from a radiation standpoint and also define the angle (or view) factor for each surface.

Inputs[LINK]

Field: Name[LINK]

This field is an unique user assigned name for the list of surfaces that can be seen radiantly by the person for whom thermal comfort is to be evaluated. Any reference to this list by a People statement will use this name.

Field: Surface <#> Name[LINK]

This field is the name of a surface in the radiant enclosure seen by the person. All surfaces listed should be in the same radiant enclosure (one or more Spaces). This should also be the same radiant enclosure as the People instance which references this ComfortViewFactorAngles object. If not, a warning will be issued, but the simulation will proceed with the specified surfaces.

Field: Angle Factor <#>[LINK]

This field is the fraction that this surface contributes to the total mean radiant temperature. This can be thought of as a weighting factor for this surface and the actual mean radiant temperature used in the thermal comfort model is simply the sum of all angle factors multiplied by the corresponding inside surface temperature, weighted by the surface emissivity. The sum of all angle factors within any angle factor list must equal unity, otherwise the program will not accept the input as valid.

Note that the Surface Name/Angle Factor pair is extensible to accommodate as many surfaces as required.

An example IDF with an electric low temperature radiant system is shown below.

ComfortViewFactorAngles,
  South Zone Angle Factors, !- name of angle factor list
  Zn001:Flr001,         !- Surface name 1
  0.75,                 !- Angle factor for surface 1
  Zn001:Wall001,        !- Surface name 2
  0.15,                 !- Angle factor for surface 2
  Zn001:Roof001,        !- Surface name 3
  0.10;                 !- Angle factor for surface 3

Lights[LINK]

The Lights statement allows you to specify information about a zone’s electric lighting system, including design power level and operation schedule, and how the heat from lights is distributed thermally.

A zone may have multiple Lights statements. For example, one statement may describe the general lighting in the zone and another the task lighting. Or you can use multiple Lights statements for a zone that has two or more general lighting systems that differ in design level, schedule, etc.

Inputs[LINK]

Field: Name[LINK]

The name of the Lights object.

Field: Zone or ZoneList or Space or SpaceList Name[LINK]

This field applies this Lights object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method to place a varying lighting load at the same density in each zone or space. The names of the actual lights objects may be concatenated as <Space Name> <Lights Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.

Field: Schedule Name[LINK]

The name of the schedule that modifies the lighting power design level (see Design Level Calculation Method field and related subsequent fields). The schedule values can be any positive number. The electrical input for lighting in a particular timestep is the product of the design level and the value of this schedule in that timestep. If the design level is the maximum lighting power input the schedule should contain values between 0.0 and 1.0.

Field: Design Level Calculation Method[LINK]

This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal lighting level in the Zone. The key/choice options are:

LightingLevel

With this choice, the method used will be a straight insertion of the lighting level (Watts) for the Zone. (The Lighting Level field should be filled.)

Watts/Area

With this choice, the method used will be a factor per floor area of the zone or space. (The Watts per Floor Area field should be filled).

Watts/Person

With this choice, the method used will be a factor of lighting level (watts) per person. (The Watts per person field should be filled).

Field: Lighting Level[LINK]

This is typically the maximum electrical power input (in Watts) to lighting in a zone, including ballasts, if present. This value is multiplied by a schedule fraction (see previous field) to get the lighting power in a particular timestep. In EnergyPlus, this is slightly more flexible in that the lighting design level could be a “diversity factor” applied to a schedule of real numbers.

Field: Watts per Floor Area[LINK]

This factor (watts/m2) is used, along with the Zone or Space Floor Area to determine the maximum lighting level as described in the Lighting Level field. The choice from the method field should be “watts/area”.

Field: Watts per Person[LINK]

This factor (watts/person) is used, along with the number of occupants (people) to determine the maximum lighting level as described in the Lighting Level field. The choice from the method field should be “watts/person”.

Heat Gains from Lights:[LINK]

The electrical input to lighting ultimately appears as heat that contributes to zone loads or to return air heat gains. In EnergyPlus this heat is divided into four different fractions. Three of these are given by the input fields Return Air Fraction, Fraction Radiant and Fraction Visible. A fourth, defined as the fraction of the heat from lights convected to the zone air, is calculated by the program as:

You will get an error message if Return Air Fraction + Fraction Radiant + Fraction Visible exceeds 1.0.

These fractions depend on the type of lamp and luminaire, whether the luminaire is vented to the return air, etc.

Field: Return Air Fraction[LINK]

The fraction of the heat from lights that goes into the zone return air (i.e., into the zone outlet node). If the return air flow is zero or the zone has no return air system, the program will put this fraction into the zone air. Return Air Fraction should be non-zero only for luminaires that are return-air ducted (see Table 4 and Figure 4). (However, see the field “Return Air Fraction Is Calculated from Plenum Temperature,” below, for an approach to modeling the case where Return Air Fraction is caused by conduction between a luminaire that is in contact with a return-air plenum.)

Field: Fraction Radiant[LINK]

The fraction of heat from lights that goes into the zone as long-wave (thermal) radiation. The program calculates how much of this radiation is absorbed by the inside surfaces of the zone according the area times thermal absorptance product of these surfaces.

Field: Fraction Visible[LINK]

The fraction of heat from lights that goes into the zone as visible (short-wave) radiation. The program calculates how much of this radiation is absorbed by the inside surfaces of the zone according the area times solar absorptance product of these surfaces.

Approximate values of Return Air Fraction, Fraction Radiant and Fraction Visible are given in Table 4 for overhead fluorescent lighting for a variety of luminaire configurations. The data is based on ASHRAE 1282-RP “Lighting Heat Gain Distribution in Buildings” by Daniel E. Fisher and Chanvit Chantrasrisalai.

Fixture No. Luminaire Feature Return Air Fraction Fraction Radiant Fraction Visible fconvected
1 Recessed, Parabolic Louver, Non-Vented, T8 0.31 0.22 0.20 0.27
2 Recessed, Acrylic Lens, Non-Vented, T8 0.56 0.12 0.20 0.12
3 Recessed, Parabolic Louver, Vented, T8 0.28 0.19 0.20 0.33
4 Recessed, Acrylic Lens, Vented, T8 0.54 0.10 0.18 0.18
5 Recessed, Direct/Indirect, T8 0.34 0.17 0.16 0.33
6 Recessed, Volumetric, T5 0.54 0.13 0.20 0.13
7 Downlights, Compact Fluorescent, DTT 0.86 0.04 0.10 0.00
8 Downlights, Compact Fluorescent, TRT 0.78 0.09 0.13 0.00
9a Downlights, Incandescent, A21 0.29 0.10 0.6 0.01
9b Downlights, Incandescent, BR40 0.21 0.08 0.71 0.00
10 Surface Mounted, T5HO 0.00 0.27 0.23 0.50
11 Pendant, Direct/Indirect, T8 0.00 0.32 0.23 0.45
12 Pendant, Indirect, T5HO 0.00 0.32 0.25 0.43

1 Recessed, Parabolic Louver, Non-Vented, T8 - Ducted 0.27 0.27 0.21 0.25 5 Recessed, Direct/Indirect, T8 - Ducted 0.27 0.22 0.17 0.34

1 Recessed, Parabolic Louver, Non-Vented, T8 - Half Typical Supply Airflow Rate 0.45 0.30 0.22 0.03 3 Recessed, Parabolic Louver, Vented, T8 - Half Typical Supply Airflow Rate 0.43 0.25 0.21 0.11 5 Recessed, Direct/Indirect, T8 - Half Typical Supply Airflow Rate 0.43 0.27 0.18 0.12

1 Recessed, Parabolic Louver, Non-Vented, T8 - Half Typical Supply Airflow Rate 0.10 0.16 0.20 0.54 3 Recessed, Parabolic Louver, Vented, T8 - Half Typical Supply Airflow Rate 0.11 0.15 0.19 0.55 5 Recessed, Direct/Indirect, T8 - Half Typical Supply Airflow Rate 0.04 0.13 0.16 0.67

Approximate values of Return Air Fraction, Fraction Radiant and Fraction Visible for overhead fluorescent lighting for different luminaire configurations.

Field: Fraction Replaceable[LINK]

This field defines the daylighting control for the LIGHTS object.

If Daylighting:Controls is specified for the space or zone, this field is used as an on/off flag for dimming controls. If set to 0.0, the lights are not dimmed by the daylighting controls. If set to 1.0, the lights are allowed to be dimmed by the applicable daylighting control. If daylighting controls are operating in the space or zone, all of the applicable Lights objects with a Fraction Replaceable greater than zero will be reduced by a multiplicative factor that accounts for how much the electric lighting is lowered due to daylighting (ref. Daylighting Lighting Power Multiplier).

Field: End-Use Subcategory[LINK]

Allows you to specify a user-defined end-use subcategory, e.g., “Task Lights“,”Hall Lights“, etc. A new meter for reporting is created for each unique subcategory (ref: Output:Meter objects). Subcategories are also reported in the ABUPS table. If this field is omitted or blank, the lights will be assigned to the “General” end-use subcategory. Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and the LEED EAp2-4/5. Performance Rating Method Compliance table.

Field: Return Air Fraction Calculated from Plenum Temperature[LINK]

Accepts values Yes or No (the default). Yes is for advanced used only. In this case the program will calculate the return air fraction by assuming that it is due to conduction of some of the light heat into the zone’s return air plenum and that the amount of the conduction depends on the plenum air temperature. A Yes value should only be used for luminaires that are recessed and non-vented, as shown in Figure 4.

The value you enter for the Return Air Fraction field will be ignored and you can enter, for fluorescent lighting, Fraction Radiant = 0.37 and Fraction Visible = 0.18, as indicated in Table 4.

This feature requires that the coefficients described below be determined from measurements or detailed calculations since they are very sensitive to the luminaire type, lamp type, thermal resistance between fixture and plenum, etc.

If “Return Air Fraction Is Calculated from Plenum Temperature” = Yes, the return air fraction is calculated each timestep from the following empirical correlation:

(ReturnAirFraction)calculated=C1C2×Tplenum

where Tplenum is the previous-time-step value of the return plenum air temperature (C),

and C1 and C2 are the values of the coefficients entered in the next two fields.

To compensate for the change in the return air fraction relative to its input value, the program modifies Fraction Radiant and fconvected by a scale factor such that

(ReturnAirFraction)calculated+(FractionRadiant)modified+(fconvected)modified+(FractionVisible)input=1.0

It is assumed that Fraction Visible is a constant equal to its input value.

Field: Return Air Fraction Function of Plenum Temperature Coefficient 1[LINK]

The coefficient C1 in the equation for (Return Air Fraction)calculated.

Field: Return Air Fraction Function of Plenum Temperature Coefficient 2[LINK]

The coefficient C2 in the equation for (Return Air Fraction)calculated. Its units are 1/C.

Field: Return Air Heat Gain Node Name[LINK]

Name of the return air node for this heat gain. If left blank, it defaults to the first return air node for the zone containing this Lights object. Leave blank when using a ZoneList name.

Field:Exhaust Air Heat Gain Node Name[LINK]

Name of the exhaust air node for this heat gain. If left blank, no heat gain from return air fraction will be added to the zone exhaust node. When the exhaust node name is entered, the return air heat gain will be shared by both return and exhaust nodes. The equipment can draw air from the exhaust node, but the inlet air properties is combined properties with mixing mass flow rates of both nodes and added lights heat gain.

Vertical section through a zone and its return air plenum showing recessed lighting (not to scale). The heat from lights is divided into four fractions, three of which—ReturnAirFraction, FractionRadiant and FractionConvected—depend on plenum air temperature. [fig:vertical-section-through-a-zone-and-its]

Vertical section through a zone and its return air plenum showing recessed lighting (not to scale). The heat from lights is divided into four fractions, three of which—ReturnAirFraction, FractionRadiant and FractionConvected—depend on plenum air temperature. [fig:vertical-section-through-a-zone-and-its]

An IDF example:

Lights,
  RIGHT FORK Lights 1,  !- Name
  RIGHT FORK,           !- Zone Name
  Office Lighting,      !- SCHEDULE Name
  LightingLevel,        !- Design Level calculation method
  1039.706,             !- Lighting Level {W}
  ,                     !- Watts per Floor Area {W/m2}
  ,                     !- Watts per Person {W/person}
  0.0000000E+00,        !- Return Air Fraction
  0.4000000,            !- Fraction Radiant
  0.2000000,            !- Fraction Visible
  1.0,                  !- Fraction Replaceable
  GeneralLights;        !- End-Use Subcategory

Global Lights Object:

ZoneList,AllOccupiedZones,SPACE1-1,SPACE2-1,SPACE3-1,SPACE4-1,SPACE5-1;

Lights,
  AllZones with Lights, !- Name
  AllOccupiedZones,     !- Zone or ZoneList or Space or SpaceList Name
  LIGHTS-1,             !- Schedule Name
  Watts/Area,           !- Design Level Calculation Method
  ,                     !- Lighting Level {W}
  16,                   !- Watts per Zone Floor Area {W/m2}
  ,                     !- Watts per Person {W/person}
  0.2,                  !- Return Air Fraction
  0.59,                 !- Fraction Radiant
  0.2,                  !- Fraction Visible
  0,                    !- Fraction Replaceable
  GeneralLights;        !- End-Use Subcategory

Outputs[LINK]

Lights objects have output variables for individual objects and for space and zone totals.

A related output is Daylighting Lighting Power Multiplier.

  • Zone,Average,Lights Electricity Rate [W]

  • Zone,Sum,Lights Radiant Heat Gain [J]

  • Zone,Average,Lights Radiant Heating Rate [W]

  • Zone,Sum,Lights Visible Radiation Heating Energy [J]

  • Zone,Average,Lights Visible Radiation Heating Rate [W]

  • Zone,Sum,Lights Convective Heating Energy [J]

  • Zone,Average,Lights Convective Heating Rate [W]

  • Zone,Sum,Lights Return Air Heating Energy [J]

  • Zone,Average,Lights Return Air Heating Rate [W]

  • Zone,Sum,Lights Total Heating Energy [J]

  • Zone,Average,Lights Total Heating Rate [W]

  • Zone,Sum,Lights Electricity Energy [J]

  • Zone,Average,Space Lights Electricity Rate [W]

  • Zone,Average,Space Lights Electricity Energy [J]

  • Zone,Sum,Space Lights Radiant Heating Energy [J]

  • Zone,Average,Space Lights Radiant Heating Rate [W]

  • Zone,Sum,Space Lights Visible Radiation Heating Energy [J]

  • Zone,Average,Space Lights Visible Radiation Heating Rate [W]

  • Zone,Sum,Space Lights Convective Heating Energy [J]

  • Zone,Average,Space Lights Convective Heating Rate [W]

  • Zone,Sum,Space Lights Return Air Heating Energy [J]

  • Zone,Average,Space Lights Return Air Heating Rate [W]

  • Zone,Sum,Space Lights Total Heating Energy [J]

  • Zone,Average,Space Lights Total Heating Rate [W]

  • Zone,Sum,Space Lights Electricity Energy [J]

  • Zone,Average,Zone Lights Electricity Rate [W]

  • Zone,Average,Zone Lights Electricity Energy [J]

  • Zone,Sum,Zone Lights Radiant Heating Energy [J]

  • Zone,Average,Zone Lights Radiant Heating Rate [W]

  • Zone,Sum,Zone Lights Visible Radiation Heating Energy [J]

  • Zone,Average,Zone Lights Visible Radiation Heating Rate [W]

  • Zone,Sum,Zone Lights Convective Heating Energy [J]

  • Zone,Average,Zone Lights Convective Heating Rate [W]

  • Zone,Sum,Zone Lights Return Air Heating Energy [J]

  • Zone,Average,Zone Lights Return Air Heating Rate [W]

  • Zone,Sum,Zone Lights Total Heating Energy [J]

  • Zone,Average,Zone Lights Total Heating Rate [W]

  • Zone,Sum,Zone Lights Electricity Energy [J]

Lights Radiant Heating Rate [W][LINK]

Lights Radiant Heating Energy [J][LINK]

The amount of heat gain from lights that is in the form of long-wave (thermal) radiation entering the zone. This heat is absorbed by the inside surfaces of the zone according to an area times long-wave absorptance weighting scheme.

Lights Visible Radiation Heating Rate [W][LINK]

Lights Visible Radiation Heating Energy [J][LINK]

The amount of heat gain from lights that is in the form of visible (short-wave) radiation entering the zone. This heat is absorbed by the inside surfaces of the zone according to an area times short-wave absorptance weighting scheme.

Lights Convective Heating Rate [W][LINK]

Lights Convective Heating Energy [J][LINK]

The amount of heat gain from lights that is convected to the zone air.

Lights Return Air Heating Rate [W][LINK]

Lights Return Air Heating Energy [J][LINK]

The amount of heat gain from lights that goes into the zone’s return air (and, therefore, does not directly contribute to the zone load). If the zone has no return air system or the zone’s air system is off, this heat will be added to the zone air.

Lights Total Heating Rate [W][LINK]

Lights Total Heating Energy [J][LINK]

The total heat gain from lights. It is the sum of the following four outputs, i.e., Total Heat Gain Return Air Heat Gain Radiant Heat Gain Visible Heat Gain Convective Heat Gain. It is also equal to the electrical input to the lights.

Lights Electricity Rate [W][LINK]

The electric power input for the lights.

Lights Electricity Energy [J][LINK]

The lighting electrical consumption including ballasts, if present. This will have the same value as Lights Total Heating Energy (above).

The energy amount is also included in the following Electricity meters:

Electricity:Facility
Electricity:Building
Electricity:Zone:<Zone Name>
Electricity:SpaceType:<Space Type Name>
InteriorLights:Electricity
InteriorLights:Electricity:Zone:<Zone Name>
InteriorLights:Electricity:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorLights:Electricity
<End-Use Subcategory>:InteriorLights:Electricity:Zone:<Zone Name>
<End-Use Subcategory>:InteriorLights:Electricity:SpaceType:<Space Type Name>

Space or Zone Lights Radiant Heating Rate [W][LINK]

Space or Zone Lights Radiant Heating Energy [J][LINK]

The amount of heat gain from all lights in the space or zone that is in the form of long-wave (thermal) radiation entering the space or zone. This heat is absorbed by the inside surfaces of the space or zone according to an area times long-wave absorptance weighting scheme.

Space or Zone Lights Visible Radiation Heating Rate [W][LINK]

Space or Zone Lights Visible Radiation Heating Energy [J][LINK]

The amount of heat gain from all lights in the space or zone that is in the form of visible (short-wave) radiation entering the space or zone. This heat is absorbed by the inside surfaces of the space or zone according to an area times short-wave absorptance weighting scheme.

Space or Zone Lights Convective Heating Rate [W][LINK]

Space or Zone Lights Convective Heating Energy [J][LINK]

The amount of heat gain from all lights in the space or zone that is convected to the space or zone air.

Space or Zone Lights Return Air Heating Rate [W][LINK]

Space or Zone Lights Return Air Heating Energy [J][LINK]

The amount of heat gain from all lights in the space or zone that goes into the space or zone’s return air (and, therefore, does not directly contribute to the space or zone load). If the space or zone has no return air system or the space or zone’s air system is off, this heat will be added to the space or zone air.

Space or Zone Lights Total Heating Rate [W][LINK]

Space or Zone Lights Total Heating Energy [J][LINK]

The total heat gain from all lights in the space or zone. It is the sum of the following four outputs, i.e., Total Heat Gain = Return Air Heat Gain + Radiant Heat Gain + Visible Heat Gain + Convective Heat Gain. It is also equal to the electrical input to the lights.

Space or Zone Lights Electricity Rate [W][LINK]

Space or Zone Lights Electricity Energy [J][LINK]

The electric power input for all lights in the space or zone. This will have the same value as Zone Lights Total Heating Rate or Energy (above).

ElectricEquipment[LINK]

The object models equipment in the zone which consumes electricity, such as computers, televisions, and cooking equipment, also known as “plug loads.” All of the energy consumed by the equipment becomes a heat gain in the zone or is lost (exhausted) as specified below.

Inputs[LINK]

Field: Name[LINK]

The name of the ElectricEquipment object.

Field: Zone or ZoneList or Space or SpaceList Name[LINK]

This field applies this ElectricEquipment object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method to place a varying equipment load at the same density in each zone or space. The names of the actual electric equipment objects may be concatenated as <Space Name> <ElectricEquipment Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.

Field: Schedule Name[LINK]

This field is the name of the schedule that modifies the design level parameter for electric equipment (see Design Level Calculation Method field and related subsequent fields). The schedule values can be any positive number. The actual electrical input for equipment in a zone as defined by this statement is the product of the design level field and the value of the schedule specified by name in this field.

Field: Design Level Calculation Method[LINK]

This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal electric equipment level in the Zone or Space. The key/choices are:

  • EquipmentLevel

With this choice, the method used will be a straight insertion of the electric equipment level (Watts) for the Zone. (The Design Level field should be filled.)

  • Watts/Area

With this choice, the method used will be a factor per floor area of the zone or space. (The Watts per Floor Area field should be filled).

  • Watts/Person

With this choice, the method used will be a factor of equipment level (watts) per person. (The Watts per Person field should be filled).

Field: Design Level[LINK]

This field (in Watts) is typically used to represent the maximum electrical input to equipment in a zone that is then multiplied by a schedule fraction (see previous field). In EnergyPlus, this is slightly more flexible in that the electric equipment design level could be a “diversity factor” applied to a schedule of real numbers. Note that while the schedule value can vary from hour to hour, the design level field is constant for all simulation environments.

Field: Watts per Floor Area[LINK]

This factor (watts/m2) is used, along with the Zone or Space Floor Area to determine the maximum equipment level as described in the Design Level field. The choice from the method field should be “Watts/Area”.

Field: Watts per Person[LINK]

This factor (watts/person) is used, along with the number of occupants (people) to determine the maximum equipment level as described in the Design Level field. The choice from the method field should be “Watts/Person”.

Heat Gains from Electric Equipment:[LINK]

The electrical input to the equipment ultimately appears as heat that contributes to zone loads. In EnergyPlus this heat is divided into four different fractions. Three of these are given by the input fields Fraction Latent, Fraction Radiant and Fraction Lost. A fourth, defined as the fraction of the heat from electric equipment convected to the zone air, is calculated by the program as:

fconvected=1.0(FractionLatent+FractionRadiant+FractionLost)

You will get an error message if Fraction Latent + Fraction Radiant + Fraction Lost exceeds 1.0.

Field: Fraction Latent[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of latent heat given off by electric equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by electric equipment to give the amount of latent energy produced by the electric equipment. This energy affects the moisture balance within the zone.

Field: Fraction Radiant[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of long-wave radiant heat being given off by electric equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by electric equipment to give the amount of long wavelength radiation gain from electric equipment in a zone.

Field: Fraction Lost[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of “lost” heat being given off by electric equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by electric equipment to give the amount of heat which is “lost” and does not impact the zone energy balances. This might correspond to electrical energy converted to mechanical work or heat that is vented to the atmosphere.

Field: End-Use Subcategory[LINK]

Allows you to specify a user-defined end-use subcategory, e.g., “Computers”, “Copy Machines”, etc. A new meter for reporting is created for each unique subcategory (ref: Output:Meter objects). Subcategories are also reported in the ABUPS table. If this field is omitted or blank, the equipment will be assigned to the “General” end-use subcategory. Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and the LEED Summary table EAp2-4/5. Performance Rating Method Compliance.

An IDF example:

ElectricEquipment,
  DORM ROOMS AND COMMON AREAS ElecEq 1, !- Name
  DORM ROOMS AND COMMON AREAS,          !- Zone Name
  Residence Equipment,                  !- SCHEDULE Name
  EquipmentLevel,                       !- Design Level calculation method
  9210.921,                             !- Design Level {W}
  ,                                     !- Watts per Zone Floor Area {watts/m2}
  ,                                     !- Watts per Person {watts/person}
  0.0000000E+00,                        !- Fraction Latent
  0.3000000,                            !- Fraction Radiant
  0.0000000E+00,                        !- Fraction Lost
  Computers;                            !- End-use Subcategory

Global ElectricEquipment example:

ZoneList,AllOccupiedZones,SPACE1-1,SPACE2-1,SPACE3-1,SPACE4-1,SPACE5-1;

ElectricEquipment,
  AllZones with Electric Equipment,     !- Name
  AllOccupiedZones,                     !- Zone or ZoneList or Space or SpaceList Name
  EQUIP-1,                              !- Schedule Name
  Watts/Person,                         !- Design Level Calculation Method
  ,                                     !- Design Level {W}
  ,                                     !- Watts per Zone Floor Area {W/m2}
  96,                                   !- Watts per Person {W/person}
  0,                                    !- Fraction Latent
  0.3,                                  !- Fraction Radiant
  0;                                    !- Fraction Lost

GasEquipment[LINK]

The object models equipment in the zone which consumes natural gas, such as cooking equipment or a gas fireplace. All of the energy consumed by the equipment becomes a heat gain in the zone or is lost (exhausted) as specified below.

Inputs[LINK]

Field: Name[LINK]

The name of the GasEquipment object.

Field: Zone or ZoneList or Space or SpaceList Name[LINK]

This field applies this GasEquipment object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method to place a varying equipment load at the same density in each zone or space. The names of the actual gas equipment objects may be concatenated as <Space Name> <GasEquipment Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.

Field: Schedule Name[LINK]

This field is the name of the schedule that modifies the design level parameter for gas equipment (see Design Level Calculation Method field and related subsequent fields). The schedule values can be any positive number. The actual energy input for gas equipment in a zone as defined by this statement is the product of the design level field and the value of the schedule specified by name in this field.

Field: Design Level Calculation Method[LINK]

This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal gas equipment level in the Zone. The key/choices are:

  • EquipmentLevel

With this choice, the method used will be a straight insertion of the gas equipment level (Watts) for the Zone. (The Design Level field should be filled.)

  • Watts/Area or Power/Area

With this choice, the method used will be a factor per floor area of the zone or space. (The Power per Floor Area field should be filled).

  • Watts/Person or Power/Person

With this choice, the method used will be a factor of equipment level (watts) per person. (The Power per Person field should be filled).

Field: Design Level[LINK]

This field (in Watts) is typically used to represent the maximum energy input to gas equipment in a zone that is then multiplied by a schedule fraction (see previous field). In EnergyPlus, this is slightly more flexible in that the gas equipment design level could be a “diversity factor” applied to a schedule of real numbers. Note that while the schedule value can vary from hour to hour, the design level field is constant for all simulation environments.

Field: Power per Floor Area[LINK]

This factor (watts/m2) is used, along with the Zone or Space Area to determine the maximum equipment level as described in the Design Level field. The choice from the method field should be “Watts/Area” or “Power/Area”.

Field: Power per Person[LINK]

This factor (watts/person) is used, along with the number of occupants (people) to determine the maximum equipment level as described in the Design Level field. The choice from the method field should be “Watts/Person” or “Power/Person”.

Heat Gains from Gas Equipment:[LINK]

The fuel input to the equipment ultimately appears as heat that contributes to zone loads. In EnergyPlus this heat is divided into four different fractions. Three of these are given by the input fields Fraction Latent, Fraction Radiant and Fraction Lost. A fourth, defined as the fraction of the heat from gas equipment convected to the zone air, is calculated by the program as:

fconvected=1.0(FractionLatent+FractionRadiant+FractionLost)

You will get an error message if Fraction Latent + Fraction Radiant + Fraction Lost exceeds 1.0.

Field: Fraction Latent[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of latent heat given off by gas equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by gas equipment to give the amount of latent energy produced by the gas equipment. This energy affects the moisture balance within the zone.

Field: Fraction Radiant[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of long-wave radiant heat being given off by gas equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by gas equipment to give the amount of long wavelength radiation gain from gas equipment in a zone.

Field: Fraction Lost[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of “lost” heat being given off by gas equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by gas equipment to give the amount of heat which is “lost” and does not impact the zone energy balances. This might correspond to input energy converted to mechanical work or heat that is vented to the atmosphere.

Field: Carbon Dioxide Generation Rate[LINK]

This numeric input field specifies carbon dioxide generation rate with units of m3/s-W. The default value of 0.0 assumes the equipment is fully vented to outdoors. In the absence of better information, the user might consider using a value of 3.45E-8 m3/s-W which assumes the equipment is not vented to outdoors. This value is converted from natural gas CO2 emission rate at 11.7 lbs CO2 per therm. The CO2 emission rate is provided by U.S. Energy Information Administration, “Frequently Asked Questions - Environment, Questions About Environmental Emissions”, http://tonto.eia.doe.gov/ask/environment_faqs.asp#CO2_quantity, January 2010. The maximum value for this input field is 3.45×<!-- -->{=html}107 m3/s-W.

Field: End-Use Subcategory[LINK]

Allows you to specify a user-defined end-use subcategory, e.g., “Cooking”, “Clothes Drying”, etc. A new meter for reporting is created for each unique subcategory (ref: Output:Meter objects). Subcategories are also reported in the ABUPS table. If this field is omitted or blank, the equipment will be assigned to the “General” end-use subcategory. Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and the LEED Summary table EAp2-4/5 Performance Rating Method Compliance.

An IDF example:

GasEquipment,
  DORM ROOMS AND COMMON AREAS GasEq 1,  !- Name
  DORM ROOMS AND COMMON AREAS,          !- Zone or ZoneList or Space or SpaceList Name
  Gas Eq Sch,                           !-Schedule Name
  EquipmentLevel,                       !- Design Level Calculation Method
  29287.51,                             !- Design Level {W}
  ,                                     !- Power per Floor Area {W/m2}
  ,                                     !- Power per Person {W/Person}
  0,                                    !- Fraction Latent
  0.3,                                  !- Fraction Radiant
  0,                                    !- Fraction Lost
  0,                                    !- Carbon Dioxide Generation Rate {m3/s-W}
  Cooking;                              !- End-Use Subcategory

Global Gas Equipment example:

ZoneList,OfficeZones,Left Fork, Middle Fork, Right Fork;

GasEquipment,
  Office Zones with Gas,                !- Name
  OfficeZones,                          !- Zone or ZoneList or Space or SpaceList Name
  Gas Eq Sch,                           !- Schedule Name
  Watts/Area,                           !- Design Level Calculation Method
  ,                                     !- Design Level {W}
  197,                                  !- Power per Floor Area {W/m2}
  ,                                     !- Power per Person {W/Person}
  0.0000000E+00,                        !- Fraction Latent
  0.3000000,                            !- Fraction Radiant
  0.0000000E+00;                        !- Fraction Lost

HotWaterEquipment[LINK]

The object models hot water equipment in the zone which consumes district heating, such as cooking equipment or process loads. All of the energy consumed by the equipment becomes a heat gain in the zone or is lost (exhausted) as specified below. This object consumes district heating energy directly and does not cause a load on a hot water plant loop or water heater. For domestic hot water uses, such as sinks and showers, see WaterUse:Equipment.

Inputs[LINK]

Field: Name[LINK]

The name of the HotWaterEquipment object.

Field: Zone or ZoneList or Space or SpaceList Name[LINK]

This field applies this HotWaterEquipment object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method to place a varying equipment load at the same density in each zone or space. The names of the actual hot water equipment objects may be concatenated as <Space Name> <HotWaterEquipment Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.

Field: Schedule Name[LINK]

This field is the name of the schedule that modifies the design level parameter for hot water equipment (see Design Level Calculation Method field and related subsequent fields). The schedule values can be any positive number. The actual energy input for hot water equipment in a zone as defined by this statement is the product of the design level field and the value of the schedule specified by name in this field.

Field: Design Level Calculation Method[LINK]

This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal hot water equipment level in the Zone. The key/choices are:

  • EquipmentLevel

With this choice, the method used will be a straight insertion of the hot water equipment level (Watts) for the Zone. (The Design Level field should be filled.)

  • Watts/Area or Power/Area

With this choice, the method used will be a factor per floor area of the zone or space. (The Power per Floor Area field should be filled).

  • Watts/Person or Power/Person

With this choice, the method used will be a factor of equipment level (watts) per person. (The Power per Person field should be filled).

Field: Design Level[LINK]

This field (in Watts) is typically used to represent the maximum energy input to hot water equipment in a zone that is then multiplied by a schedule fraction (see previous field). In EnergyPlus, this is slightly more flexible in that the hot water equipment design level could be a “diversity factor” applied to a schedule of real numbers. Note that while the schedule value can vary from hour to hour, the design level field is constant for all simulation environments.

Field: Power per Floor Area[LINK]

This factor (watts/m2) is used, along with the Zone or Space Area to determine the maximum equipment level as described in the Design Level field. The choice from the method field should be “Watts/Area” or “Power/Area”.

Field: Power per Person[LINK]

This factor (watts/person) is used, along with the number of occupants (people) to determine the maximum equipment level as described in the Design Level field. The choice from the method field should be “Watts/Person” or “Power/Person”.

Heat Gains from Hot Water Equipment:[LINK]

The fuel input to the equipment ultimately appears as heat that contributes to zone loads. In EnergyPlus this heat is divided into four different fractions. Three of these are given by the input fields Fraction Latent, Fraction Radiant and Fraction Lost. A fourth, defined as the fraction of the heat from hot water equipment convected to the zone air, is calculated by the program as:

fconvected=1.0(FractionLatent+FractionRadiant+FractionLost)

You will get an error message if Fraction Latent + Fraction Radiant + Fraction Lost exceeds 1.0.

Field: Fraction Latent[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of latent heat given off by hot water equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by hot water equipment to give the amount of latent energy produced by the hot water equipment. This energy affects the moisture balance within the zone.

Field: Fraction Radiant[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of long-wave radiant heat being given off by hot water equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by hot water equipment to give the amount of long wavelength radiation gain from hot water equipment in a zone.

Field: Fraction Lost[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of “lost” heat being given off by hot water equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by hot water equipment to give the amount of heat which is “lost” and does not impact the zone energy balances. This might correspond to input energy converted to mechanical work or heat that is vented to the atmosphere.

Field: End-Use Subcategory[LINK]

Allows you to specify a user-defined end-use subcategory, e.g., “Cooking”, “Clothes Drying”, etc. A new meter for reporting is created for each unique subcategory (ref: Output:Meter object). Subcategories are also reported in the ABUPS table. If this field is omitted or blank, the equipment will be assigned to the “General” end-use subcategory. Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and the LEED Summary table EAp2-4/5 Performance Rating Method Compliance.

IDF Examples:

HotWaterEquipment,
  SPACE2-1 HWEq 1,    !- Name
  SPACE2-1,           !- Zone or ZoneList or Space or SpaceList Name
  EQUIP-1,            !- SCHEDULE Name
  EquipmentLevel,     !- Design Level calculation method
  300,                !- Design Level {W}
  ,                   !- Power per Floor Area {watts/m2}
  ,                   !- Power per Person {watts/person}
  0.2,                !- Fraction Latent
  0.1,                !- Fraction Radiant
  0.5,                !- Fraction Lost
  Dishwashing;        !- End-Use Subcategory

Global Hot Water Equipment example:

ZoneList,OfficeZones,Left Fork, Middle Fork, Right Fork;

HotWaterEquipment,
  Office Zones with HoWater Equipment,!- Name
  OfficeZones,                        !- Zone or ZoneList or Space or SpaceList Name
  HotWater Eq Sch,                    !- Schedule Name
  Watts/Area,                         !- Design Level Calculation Method
  ,                                   !- Design Level {W}
  50,                                 !- Power per Floor Area {W/m2}
  ,                                   !- Power per Person {W/Person}
  0.0000000E+00,                      !- Fraction Latent
  0.3000000,                          !- Fraction Radiant
  0.0000000E+00;                      !- Fraction Lost

SteamEquipment[LINK]

The object models steam equipment in the zone which consumes district heating, such as cooking equipment or process loads. All of the energy consumed by the equipment becomes a heat gain in the zone or is lost (exhausted) as specified below. This object consumes district heating energy directly and does not cause a load on a steam plant loop.

Inputs[LINK]

Field: Name[LINK]

The name of the SteamEquipment object.

Field: Zone or ZoneList or Space or SpaceList Name[LINK]

This field applies this SteamEquipment object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method to place a varying equipment load at the same density in each zone or space. The names of the actual steam equipment objects may be concatenated as <Space Name> <SteamEquipment Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.

Field: Schedule Name[LINK]

This field is the name of the schedule that modifies the design level parameter for steam equipment (see Design Level Calculation Method field and related subsequent fields). The schedule values can be any positive number. The actual energy input for steam equipment in a zone as defined by this statement is the product of the design level field and the value of the schedule specified by name in this field.

Field: Design Level Calculation Method[LINK]

This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal steam equipment level in the Zone. The key/choices are:

  • EquipmentLevel

With this choice, the method used will be a straight insertion of the steam equipment level (Watts) for the Zone. (The Design Level field should be filled.)

  • Watts/Area or Power/Area

With this choice, the method used will be a factor per floor area of the zone. (The Power per Floor Area field should be filled).

  • Watts/Person or Power/Person

With this choice, the method used will be a factor of equipment level (watts) per person. (The Power per Person field should be filled).

Field: Design Level[LINK]

This field (in Watts) is typically used to represent the maximum energy input to steam equipment in a zone that is then multiplied by a schedule fraction (see previous field). In EnergyPlus, this is slightly more flexible in that the steam equipment design level could be a “diversity factor” applied to a schedule of real numbers. Note that while the schedule value can vary from hour to hour, the design level field is constant for all simulation environments.

Field: Power per Floor Area[LINK]

This factor (watts/m2) is used, along with the Zone or Space Area to determine the maximum equipment level as described in the Design Level field. The choice from the method field should be “Watts/Area” or “Power/Area”.

Field: Power per Person[LINK]

This factor (watts/person) is used, along with the number of occupants (people) to determine the maximum equipment level as described in the Design Level field. The choice from the method field should be “Watts/Person” or “Power/Person”.

Heat Gains from Steam Equipment:[LINK]

The fuel input to the equipment ultimately appears as heat that contributes to zone loads. In EnergyPlus this heat is divided into four different fractions. Three of these are given by the input fields Fraction Latent, Fraction Radiant and Fraction Lost. A fourth, defined as the fraction of the heat from steam equipment convected to the zone air, is calculated by the program as:

fconvected=1.0(FractionLatent+FractionRadiant+FractionLost)

You will get an error message if Fraction Latent + Fraction Radiant + Fraction Lost exceeds 1.0.

Field: Fraction Latent[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of latent heat given off by steam equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by steam equipment to give the amount of latent energy produced by the steam equipment. This energy affects the moisture balance within the zone.

Field: Fraction Radiant[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of long-wave radiant heat being given off by steam equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by steam equipment to give the amount of long wavelength radiation gain from steam equipment in a zone.

Field: Fraction Lost[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of “lost” heat being given off by steam equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by steam equipment to give the amount of heat which is “lost” and does not impact the zone energy balances. This might correspond to input energy converted to mechanical work or heat that is vented to the atmosphere.

Field: End-Use Subcategory[LINK]

Allows you to specify a user-defined end-use subcategory, e.g., “Cooking”, “Clothes Drying”, etc. A new meter for reporting is created for each unique subcategory (ref: Output:Meter objects). Subcategories are also reported in the ABUPS table. If this field is omitted or blank, the equipment will be assigned to the “General” end-use subcategory. Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and the LEED Summary table EAp2-4/5 Performance Rating Method Compliance.

IDF Examples:

SteamEquipment,
  SPACE4-1 ElecEq 1, !- Name
  SPACE4-1,          !- Zone or ZoneList or Space or SpaceList Name
  EQUIP-1,           !- SCHEDULE Name
  EquipmentLevel,    !- Design Level calculation method
  1050,              !- Design Level {W}
  ,                  !- Power per Floor Area {watts/m2}
  ,                  !- Power per Person {watts/person}
  0.5,               !- Fraction Latent
  0.3,               !- Fraction Radiant
  0,                 !- Fraction Lost
  Laundry;           !- End-Use Subcategory

OtherEquipment[LINK]

Other Equipment object is provided as an additional source for heat gains or losses directly to the zone with a fuel type that is configurable. If a fuel type is specified, the energy is attributed to the appropriate end use. Otherwise, a loss can be entered by putting a negative value into the Design Level field and this object will not have an end-use component – gains or losses do not show up in the bottom energy lines (except as influencing overall zone gains or losses).

Inputs[LINK]

Field: Name[LINK]

The name of the OtherEquipment object.

Field: Fuel Type[LINK]

This field designates the appropriate meter for the equipment. Valid fuel types are: None, Electricity, NaturalGas, Propane, FuelOilNo1, FuelOilNo2, Diesel, Gasoline, Coal, DistrictHeatingSteam, DistrictHeatingWater, DistrictCooling, OtherFuel1 and OtherFuel2. The fuel type triggers the application of consumption amounts to the appropriate energy meters. If the None fuel type is selected (the default if left blank), no end uses will be associated with the object, only the zone gains.

Field: Zone or ZoneList or Space or SpaceList Name[LINK]

This field applies this OtherEquipment object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method to place a varying equipment load at the same density in each zone or space. The names of the actual other equipment objects may be concatenated as <Space Name> <OtherEquipment Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.

Field: Schedule Name[LINK]

This field is the name of the schedule that modifies the design level parameter for other equipment (see Design Level Calculation Method field and related subsequent fields). The schedule values can be any positive number. The actual energy input for other equipment in a zone as defined by this statement is the product of the design level field and the value of the schedule specified by name in this field.

Field: Design Level Calculation Method[LINK]

This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal other equipment level in the Zone. The key/choices are:

  • EquipmentLevel

With this choice, the method used will be a straight insertion of the other equipment level (Watts) for the Zone. (The Design Level field should be filled.)

  • Watts/Area or Power/Area

With this choice, the method used will be a factor per floor area of the zone. (The Power per Floor Area field should be filled).

  • Watts/Person or Power/Person

With this choice, the method used will be a factor of equipment level (watts) per person. (The Power per Person field should be filled).

Field: Design Level[LINK]

This field (in Watts) is typically used to represent the maximum energy input to other equipment in a zone that is then multiplied by a schedule fraction (see previous field). In EnergyPlus, this is slightly more flexible in that the other equipment design level could be a “diversity factor” applied to a schedule of real numbers. This value can be negative to denote a loss if the None fuel type is selected, otherwise this must be positive. Note that while the schedule value can vary from hour to hour, the design level field is constant for all simulation environments.

Field: Power per Floor Area[LINK]

This factor (watts/m2) is used, along with the Zone or Space Area to determine the maximum equipment level as described in the Design Level field. This value can be negative to denote a loss if the None fuel type is selected, otherwise this must be positive. The choice from the method field should be “Watts/Area” or “Power/Area”.

Field: Power per Person[LINK]

This factor (watts/person) is used, along with the number of occupants (people) to determine the maximum equipment level as described in the Design Level field. This value can be negative to denote a loss if the None fuel type is selected, otherwise this must be positive. The choice from the method field should be “Watts/Person” or “Power/Person”.

Heat Gains/Losses from Other Equipment:[LINK]

The fuel input to the equipment ultimately appears as heat that contributes to zone loads. In EnergyPlus this heat is divided into four different fractions. Three of these are given by the input fields Fraction Latent, Fraction Radiant and Fraction Lost. A fourth, defined as the fraction of the heat from other equipment convected to the zone air, is calculated by the program as:

fconvected=1.0(FractionLatent+FractionRadiant+FractionLost)

You will get an error message if FractionLatent+FractionRadiant+FractionLost exceeds 1.0.

Field: Fraction Latent[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of latent heat given off by other equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by other equipment to give the amount of latent energy produced by the other equipment. This energy affects the moisture balance within the zone.

Field: Fraction Radiant[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of long-wave radiant heat being given off by other equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by other equipment to give the amount of long wavelength radiation gain from other equipment in a zone.

Field: Fraction Lost[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of “lost” heat being given off by other equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by other equipment to give the amount of heat which is “lost” and does not impact the zone energy balances. This might correspond to input energy converted to mechanical work or heat that is vented to the atmosphere.

Field: Carbon Dioxide Generation Rate[LINK]

This numeric input field specifies carbon dioxide generation rate with units of m3/s-W. The default value of 0.0 assumes the equipment is fully vented to outdoors. The maximum value for this input field is 3.45E-7 m3/s-W.

Field: End-Use Subcategory[LINK]

Allows you to specify a user-defined end-use subcategory, e.g., “Cooking”, “Clothes Drying”, etc. A new meter for reporting is created for each unique subcategory (ref: Output:Meter objects). Subcategories are also reported in the ABUPS table. If this field is omitted or blank, the equipment will be assigned to the “General” end-use subcategory. Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and in the LEED Summary table EAp2-4/5 Performance Rating Method Compliance.

IDF Examples

OtherEquipment,
    BASE-1 OthEq 1, !- Name
    Propane,  !- Fuel Use Type
    BASE-1, !- Zone or ZoneList or Space or SpaceList Name
    ALWAYSON, !- SCHEDULE Name
    EquipmentLevel, !- Design Level calculation method
    6766., !- Design Level {W}
    , !- Power per Floor Area {watts/m2}
    , !- Power per Person {watts/person}
    0, !- Fraction Latent
    0.3, !- Fraction Radiant
    0, !- Fraction Lost
    1.2E-7, !- Carbon Dioxide Generation Rate
    SubCategory1; !- End-Use Subcategory

Internal Gain Equipment Outputs[LINK]

Each type of equipment object has output variables for individual objects and for space and zone totals.

Electric Equipment

  • Zone,Average,Electric Equipment Electricity Rate [W]

  • Zone,Sum,Electric Equipment Electricity Energy [J]

  • Zone,Sum,Electric Equipment Radiant Heating Energy [J]

  • Zone,Average,Electric Equipment Radiant Heating Rate [W]

  • Zone,Sum,Electric Equipment Convective Heating Energy [J]

  • Zone,Average,Electric Equipment Convective Heating Rate [W]

  • Zone,Sum,Electric Equipment Latent Gain Energy [J]

  • Zone,Average,Electric Equipment Latent Gain Rate [W]

  • Zone,Sum,Electric Equipment Lost Heat Energy [J]

  • Zone,Average,Electric Equipment Lost Heat Rate [W]

  • Zone,Sum,Electric Equipment Total Heating Energy [J]

  • Zone,Average,Electric Equipment Total Heating Rate [W]

  • Zone,Average,Space Electric Equipment Electricity Rate [W]

  • Zone,Sum,Space Electric Equipment Electricity Energy [J]

  • Zone,Sum,Space Electric Equipment Radiant Heating Energy [J]

  • Zone,Average,Space Electric Equipment Radiant Heating Rate [W]

  • Zone,Sum,Space Electric Equipment Convective Heating Energy [J]

  • Zone,Average,Space Electric Equipment Convective Heating Rate [W]

  • Zone,Sum,Space Electric Equipment Latent Gain Energy [J]

  • Zone,Average,Space Electric Equipment Latent Gain Rate [W]

  • Zone,Sum,Space Electric Equipment Lost Heat Energy [J]

  • Zone,Average,Space Electric Equipment Lost Heat Rate [W]

  • Zone,Sum,Space Electric Equipment Total Heating Energy [J]

  • Zone,Average,Space Electric Equipment Total Heating Rate [W]

  • Zone,Average,Zone Electric Equipment Electricity Rate [W]

  • Zone,Sum,Zone Electric Equipment Electricity Energy [J]

  • Zone,Sum,Zone Electric Equipment Radiant Heating Energy [J]

  • Zone,Average,Zone Electric Equipment Radiant Heating Rate [W]

  • Zone,Sum,Zone Electric Equipment Convective Heating Energy [J]

  • Zone,Average,Zone Electric Equipment Convective Heating Rate [W]

  • Zone,Sum,Zone Electric Equipment Latent Gain Energy [J]

  • Zone,Average,Zone Electric Equipment Latent Gain Rate [W]

  • Zone,Sum,Zone Electric Equipment Lost Heat Energy [J]

  • Zone,Average,Zone Electric Equipment Lost Heat Rate [W]

  • Zone,Sum,Zone Electric Equipment Total Heating Energy [J]

  • Zone,Average,Zone Electric Equipment Total Heating Rate [W]

Gas Equipment

  • Zone,Average,Gas Equipment NaturalGas Rate [W]

  • Zone,Sum,Gas Equipment NaturalGas Energy [J]

  • Zone,Sum,Gas Equipment Radiant Heating Energy [J]

  • Zone,Sum,Gas Equipment Convective Heating Energy [J]

  • Zone,Sum,Gas Equipment Latent Gain Energy [J]

  • Zone,Sum,Gas Equipment Lost Heat Energy [J]

  • Zone,Sum,Gas Equipment Total Heating Energy [J]

  • Zone,Average,Gas Equipment Radiant Heating Rate [W]

  • Zone,Average,Gas Equipment Convective Heating Rate [W]

  • Zone,Average,Gas Equipment Latent Gain Rate [W]

  • Zone,Average,Gas Equipment Lost Heat Rate [W]

  • Zone,Average,Gas Equipment Total Heating Rate [W]

  • Zone,Average,Space Gas Equipment NaturalGas Rate [W]

  • Zone,Sum,Space Gas Equipment NaturalGas Energy [J]

  • Zone,Sum,Space Gas Equipment Radiant Heating Energy [J]

  • Zone,Average,Space Gas Equipment Radiant Heating Rate [W]

  • Zone,Sum,Space Gas Equipment Convective Heating Energy [J]

  • Zone,Average,Space Gas Equipment Convective Heating Rate [W]

  • Zone,Sum,Space Gas Equipment Latent Gain Energy [J]

  • Zone,Average,Space Gas Equipment Latent Gain Rate [W]

  • Zone,Sum,Space Gas Equipment Lost Heat Energy [J]

  • Zone,Average,Space Gas Equipment Lost Heat Rate [W]

  • Zone,Sum,Space Gas Equipment Total Heating Energy [J]

  • Zone,Average,Space Gas Equipment Total Heating Rate [W]

  • Zone,Average,Zone Gas Equipment NaturalGas Rate [W]

  • Zone,Sum,Zone Gas Equipment NaturalGas Energy [J]

  • Zone,Sum,Zone Gas Equipment Radiant Heating Energy [J]

  • Zone,Average,Zone Gas Equipment Radiant Heating Rate [W]

  • Zone,Sum,Zone Gas Equipment Convective Heating Energy [J]

  • Zone,Average,Zone Gas Equipment Convective Heating Rate [W]

  • Zone,Sum,Zone Gas Equipment Latent Gain Energy [J]

  • Zone,Average,Zone Gas Equipment Latent Gain Rate [W]

  • Zone,Sum,Zone Gas Equipment Lost Heat Energy [J]

  • Zone,Average,Zone Gas Equipment Lost Heat Rate [W]

  • Zone,Sum,Zone Gas Equipment Total Heating Energy [J]

  • Zone,Average,Zone Gas Equipment Total Heating Rate [W]

HotWater Equipment

  • Zone,Average,Hot Water Equipment District Heating Rate [W]

  • Zone,Sum,Hot Water Equipment District Heating Energy [J]

  • Zone,Sum,Hot Water Equipment Radiant Heating Energy [J]

  • Zone,Average,Hot Water Equipment Radiant Heating Rate [W]

  • Zone,Sum,Hot Water Equipment Convective Heating Energy [J]

  • Zone,Average,Hot Water Equipment Convective Heating Rate [W]

  • Zone,Sum,Hot Water Equipment Latent Gain Energy [J]

  • Zone,Average,Hot Water Equipment Latent Gain Rate [W]

  • Zone,Sum,Hot Water Equipment Lost Heat Energy [J]

  • Zone,Average,Hot Water Equipment Lost Heat Rate [W]

  • Zone,Sum,Hot Water Equipment Total Heating Energy [J]

  • Zone,Average,Hot Water Equipment Total Heating Rate [W]

  • Zone,Average,Space Hot Water Equipment District Heating Rate [W]

  • Zone,Sum,Space Hot Water Equipment District Heating Energy [J]

  • Zone,Sum,Space Hot Water Equipment Radiant Heating Energy [J]

  • Zone,Average,Space Hot Water Equipment Radiant Heating Rate [W]

  • Zone,Sum,Space Hot Water Equipment Convective Heating Energy [J]

  • Zone,Average,Space Hot Water Equipment Convective Heating Rate [W]

  • Zone,Sum,Space Hot Water Equipment Latent Gain Energy [J]

  • Zone,Average,Space Hot Water Equipment Latent Gain Rate [W]

  • Zone,Sum,Space Hot Water Equipment Lost Heat Energy [J]

  • Zone,Average,Space Hot Water Equipment Lost Heat Rate [W]

  • Zone,Sum,Space Hot Water Equipment Total Heating Energy [J]

  • Zone,Average,Space Hot Water Equipment Total Heating Rate [W]

  • Zone,Average,Zone Hot Water Equipment District Heating Rate [W]

  • Zone,Sum,Zone Hot Water Equipment District Heating Energy [J]

  • Zone,Sum,Zone Hot Water Equipment Radiant Heating Energy [J]

  • Zone,Average,Zone Hot Water Equipment Radiant Heating Rate [W]

  • Zone,Sum,Zone Hot Water Equipment Convective Heating Energy [J]

  • Zone,Average,Zone Hot Water Equipment Convective Heating Rate [W]

  • Zone,Sum,Zone Hot Water Equipment Latent Gain Energy [J]

  • Zone,Average,Zone Hot Water Equipment Latent Gain Rate [W]

  • Zone,Sum,Zone Hot Water Equipment Lost Heat Energy [J]

  • Zone,Average,Zone Hot Water Equipment Lost Heat Rate [W]

  • Zone,Sum,Zone Hot Water Equipment Total Heating Energy [J]

  • Zone,Average,Zone Hot Water Equipment Total Heating Rate [W]

Steam Equipment

  • Zone,Average,Steam Equipment District Heating Rate [W]

  • Zone,Sum,Steam Equipment District Heating Energy [J]

  • Zone,Sum,Steam Equipment Radiant Heating Energy [J]

  • Zone,Average,Steam Equipment Radiant Heating Rate [W]

  • Zone,Sum,Steam Equipment Convective Heating Energy [J]

  • Zone,Average,Steam Equipment Convective Heating Rate [W]

  • Zone,Sum,Steam Equipment Latent Gain Energy [J]

  • Zone,Average,Steam Equipment Latent Gain Rate [W]

  • Zone,Sum,Steam Equipment Lost Heat Energy [J]

  • Zone,Average,Steam Equipment Lost Heat Rate [W]

  • Zone,Sum,Steam Equipment Total Heating Energy [J]

  • Zone,Average,Steam Equipment Total Heating Rate [W]

  • Zone,Average,Space Steam Equipment District Heating Rate [W]

  • Zone,Sum,Space Steam Equipment District Heating Energy [J]

  • Zone,Sum,Space Steam Equipment Radiant Heating Energy [J]

  • Zone,Average,Space Steam Equipment Radiant Heating Rate [W]

  • Zone,Sum,Space Steam Equipment Convective Heating Energy [J]

  • Zone,Average,Space Steam Equipment Convective Heating Rate [W]

  • Zone,Sum,Space Steam Equipment Latent Gain Energy [J]

  • Zone,Average,Space Steam Equipment Latent Gain Rate [W]

  • Zone,Sum,Space Steam Equipment Lost Heat Energy [J]

  • Zone,Average,Space Steam Equipment Lost Heat Rate [W]

  • Zone,Sum,Space Steam Equipment Total Heating Energy [J]

  • Zone,Average,Space Steam Equipment Total Heating Rate [W]

  • Zone,Average,Zone Steam Equipment District Heating Rate [W]

  • Zone,Sum,Zone Steam Equipment District Heating Energy [J]

  • Zone,Sum,Zone Steam Equipment Radiant Heating Energy [J]

  • Zone,Average,Zone Steam Equipment Radiant Heating Rate [W]

  • Zone,Sum,Zone Steam Equipment Convective Heating Energy [J]

  • Zone,Average,Zone Steam Equipment Convective Heating Rate [W]

  • Zone,Sum,Zone Steam Equipment Latent Gain Energy [J]

  • Zone,Average,Zone Steam Equipment Latent Gain Rate [W]

  • Zone,Sum,Zone Steam Equipment Lost Heat Energy [J]

  • Zone,Average,Zone Steam Equipment Lost Heat Rate [W]

  • Zone,Sum,Zone Steam Equipment Total Heating Energy [J]

  • Zone,Average,Zone Steam Equipment Total Heating Rate [W]

Other Equipment

  • Zone,Average,Other Equipment Fuel Rate [W]

  • Zone,Sum,Other Equipment Fuel Energy [J]

  • Zone,Sum,Other Equipment Radiant Heating Energy [J]

  • Zone,Average,Other Equipment Radiant Heating Rate [W]

  • Zone,Sum,Other Equipment Convective Heating Energy [J]

  • Zone,Average,Other Equipment Convective Heating Rate [W]

  • Zone,Sum,Other Equipment Latent Gain Energy [J]

  • Zone,Average,Other Equipment Latent Gain Rate [W]

  • Zone,Sum,Other Equipment Lost Heat Energy [J]

  • Zone,Average,Other Equipment Lost Heat Rate [W]

  • Zone,Sum,Other Equipment Total Heating Energy [J]

  • Zone,Average,Other Equipment Total Heating Rate [W]

  • Zone,Sum,Space Other Equipment Radiant Heating Energy [J]

  • Zone,Average,Space Other Equipment Radiant Heating Rate [W]

  • Zone,Sum,Space Other Equipment Convective Heating Energy [J]

  • Zone,Average,Space Other Equipment Convective Heating Rate [W]

  • Zone,Sum,Space Other Equipment Latent Gain Energy [J]

  • Zone,Average,Space Other Equipment Latent Gain Rate [W]

  • Zone,Sum,Space Other Equipment Lost Heat Energy [J]

  • Zone,Average,Space Other Equipment Lost Heat Rate [W]

  • Zone,Sum,Space Other Equipment Total Heating Energy [J]

  • Zone,Average,Space Other Equipment Total Heating Rate [W]

  • Zone,Sum,Zone Other Equipment Radiant Heating Energy [J]

  • Zone,Average,Zone Other Equipment Radiant Heating Rate [W]

  • Zone,Sum,Zone Other Equipment Convective Heating Energy [J]

  • Zone,Average,Zone Other Equipment Convective Heating Rate [W]

  • Zone,Sum,Zone Other Equipment Latent Gain Energy [J]

  • Zone,Average,Zone Other Equipment Latent Gain Rate [W]

  • Zone,Sum,Zone Other Equipment Lost Heat Energy [J]

  • Zone,Average,Zone Other Equipment Lost Heat Rate [W]

  • Zone,Sum,Zone Other Equipment Total Heating Energy [J]

  • Zone,Average,Zone Other Equipment Total Heating Rate [W]

Electric Equipment Electricity Rate [W][LINK]

Electric Equipment Electricity Energy [J][LINK]

Space or Zone Electric Equipment Electricity Rate [W][LINK]

Space or Zone Electric Equipment Electricity Energy [J][LINK]

The electric equipment electric power consumption in Watts (for power) or Joules (for energy). It is the sum of the radiant, convective, latent and lost components. Electric Equipment Electricity Energy is added to the following electricity meters:

Electricity:Facility
Electricity:Building
Electricity:Zone:<Zone Name>
Electricity:SpaceType:<Space Type Name>
InteriorEquipment:Electricity
InteriorEquipment:Electricity:Zone:<Zone Name>
InteriorEquipment:Electricity:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorEquipment:Electricity
<End-Use Subcategory>:InteriorEquipment:Electricity:Zone:<Zone Name>
<End-Use Subcategory>:InteriorEquipment:Electricity:SpaceType:<Space Type Name>

Gas Equipment NaturalGas Rate [W][LINK]

Gas Equipment NaturalGas Energy [J][LINK]

Space or Zone Gas Equipment NaturalGas Rate [W][LINK]

Space or Zone Gas Equipment NaturalGas Energy [J][LINK]

The gas equipment natural gas consumption in Watts (for power) or Joules (for energy). It is the sum of the radiant, convective, latent and lost components. Gas Equipment NaturalGas Energy is added to the following NaturalGas meters:

NaturalGas:Facility
NaturalGas:Building
NaturalGas:Zone:<Zone Name>
NaturalGas:SpaceType:<Space Type Name>
InteriorEquipment:NaturalGas
InteriorEquipment:NaturalGas:Zone:<Zone Name>
InteriorEquipment:NaturalGas:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorEquipment:NaturalGas
<End-Use Subcategory>:InteriorEquipment:NaturalGas:Zone:<Zone Name>
<End-Use Subcategory>:InteriorEquipment:NaturalGas:SpaceType:<Space Type Name>

Hot Water Equipment District Heating Rate [W][LINK]

Hot Water Equipment District Heating Energy [J][LINK]

Space or Zone Hot Water Equipment District Heating Rate [W][LINK]

Space or Zone Hot Water Equipment District Heating Energy [J][LINK]

The hot water equipment district heating consumption in Watts (for power) or Joules (for energy). It is the sum of the radiant, convective, latent and lost components. Hot Water Equipment District Heating Energy is added to the following district heating meters:

DistrictHeatingWater:Facility
DistrictHeatingWater:Building
DistrictHeatingWater:Zone:<Zone Name>
DistrictHeatingWater:SpaceType:<Space Type Name>
InteriorEquipment:DistrictHeatingWater
InteriorEquipment:DistrictHeatingWater:Zone:<Zone Name>
InteriorEquipment:DistrictHeatingWater:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorEquipment:DistrictHeatingWater
<End-Use Subcategory>:InteriorEquipment:DistrictHeatingWater:Zone:<Zone Name>
<End-Use Subcategory>:InteriorEquipment:DistrictHeatingWater:SpaceType:<Space Type Name>

Steam Equipment District Heating Rate [W][LINK]

Steam Equipment District Heating Energy [J][LINK]

Space or Zone Steam Equipment District Heating Rate [W][LINK]

Space or Zone Steam Equipment District Heating Energy [J][LINK]

The steam equipment district heating consumption in Watts (for power) or Joules (for energy). It is the sum of the radiant, convective, latent and lost components. Steam Equipment District Heating Energy is added to the following:

DistrictHeatingWater:Facility
DistrictHeatingWater:Building
DistrictHeatingWater:Zone:<Zone Name>
DistrictHeatingWater:SpaceType:<Space Type Name>
InteriorEquipment:DistrictHeatingWater
InteriorEquipment:DistrictHeatingWater:Zone:<Zone Name>
InteriorEquipment:DistrictHeatingWater:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorEquipment:DistrictHeatingWater
<End-Use Subcategory>:InteriorEquipment:DistrictHeatingWater:Zone:<Zone Name>
<End-Use Subcategory>:InteriorEquipment:DistrictHeatingWater:SpaceType:<Space Type Name>

Other Equipment Fuel Rate [W][LINK]

Other Equipment Fuel Energy [J][LINK]

Space or Zone Other Equipment Fuel Rate [W][LINK]

Space or Zone Other Equipment Fuel Energy [J][LINK]

The other equipment fuel consumption in Watts (for power) or Joules (for energy). It is the sum of the radiant, convective, latent and lost components. Other Equipment Fuel Energy is added to the following fuel meters corresponding to the Fuel Type input. If Fuel Type = None, this energy is not metered.

<Fuel Type>:Facility
<Fuel Type>:Building
<Fuel Type>:Zone:<Zone Name>
<Fuel Type>:SpaceType:<Space Type Name>
InteriorEquipment:<Fuel Type>
InteriorEquipment:<Fuel Type>:Zone:<Zone Name>
InteriorEquipment:<Fuel Type>:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorEquipment:<Fuel Type>
<End-Use Subcategory>:InteriorEquipment:<Fuel Type>:Zone:<Zone Name>
<End-Use Subcategory>:InteriorEquipment:<Fuel Type>:SpaceType:<Space Type Name>

<Type> Equipment Radiant Heating Rate [W][LINK]

<Type> Equipment Radiant Heating Energy [J][LINK]

Space or Zone <Type> Equipment Radiant Heating Rate [W][LINK]

Space or Zone <Type> Equipment Radiant Heating Energy [J][LINK]

The amount of heat gain from equipment that is in the form of long-wave (thermal) radiation entering the zone. This heat is absorbed by the inside surfaces of the space or zone according to an area times long-wave absorptance weighting scheme.

<Type> Equipment Convective Heating Rate [W][LINK]

<Type> Equipment Convective Heating Energy [J][LINK]

Space or Zone <Type> Equipment Convective Heating Rate [W][LINK]

Space or Zone <Type> Equipment Convective Heating Energy [J][LINK]

The amount of heat gain from equipment that is convected to the space or zone air.

<Type> Latent Gain Rate [W][LINK]

<Type> Equipment Latent Gain Energy [J][LINK]

Space or Zone <Type> Latent Gain Rate [W][LINK]

Space or Zone <Type> Equipment Latent Gain Energy [J][LINK]

The amount of heat gain from equipment that goes added to the space or zone air as a latent (moisture) gain.

<Type> Lost Heat Rate [W][LINK]

<Type> Equipment Lost Heat Energy [J][LINK]

Space or Zone <Type> Lost Heat Rate [W][LINK]

Space or Zone <Type> Equipment Lost Heat Energy [J][LINK]

The amount of energy input to the equipment that is removed (exhausted) and does not add any heat gain to the space or zone.

<Type> Equipment Total Heating Rate [W][LINK]

<Type> Equipment Total Heating Energy [J][LINK]

Space or Zone <Type> Equipment Total Heating Rate [W][LINK]

Space or Zone <Type> Equipment Total Heating Energy [J][LINK]

The total heat gain from equipment. It is the sum of the following components: Total Heat Gain = Radiant Heat Gain + Convective Heat Gain + Latent Heat Gain. It is also equal to the power input to the equipment minus any Lost Heat.

IndoorLivingWall[LINK]

Indoor greenery systems such as indoor living walls are panels of plants, which grow hydroponically or soil-based. The living wall structures can be either free-standing or attached to walls. This IndoorLivingWall object simulates the thermal performance of indoor living wall in the built environment. The IndoorLivingWall directly connects with the inside surface heat balance, zone air heat balance, and zone air moisture balance in EnergyPlus.

Inputs[LINK]

Field: Name[LINK]

The name of the IndoorLivingWall object, which must be unique across all IndoorLivingWall objects.

Field: Schedule Name[LINK]

This field is the name of the schedule (ref: Schedules) that modifies the presence of indoor living walls. The schedule values can be zero or one. Zero represents the scenario that the indoor living wall was removed from the thermal zone while one represents the scenario that the indoor living wall is in the presence of the thermal zone.

Field: ET Calculation Method[LINK]

This field lists two choices of calculation methods for evapotranspiration (ET) including Penman-Monteith model and Stanghellini model. Users can also develop a customize ET function to override ET rates of indoor living walls through Energy Management System (EMS) objects, Python PlugIns objects, and Python API.

Field: Lighting Method[LINK]

This field lists three different methods to obtain net radiation for indoor living walls. They are artificial grow lights only (LED), daylighting only (Daylight), and artificial lights and daylight (LED-Daylight). If the LED lighting method is selected, the field LED Intensity Schedule Name should be used to define the LED lighting intensity level. If the Daylight or LED-Daylight method is selected, the field Daylighting Reference Point Name should be used to determine the daylighting sensor location. If the LED-Daylight method is selected, a targeted lighting intensity schedule should be defined. Based on the available daylighting, the required LED lighting level and power will be automatically adjusted to meet the targeted LED intensity level.

Field: LED Schedule Name[LINK]

This field is the name of the schedule (ref: Schedules) that defines the fraction of LED nominal intensity level for indoor living walls. The scheduled value can be any fractional value between 0 and 1.

Field: Daylighting Control Name[LINK]

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 Daylighing:ReferencePoint for the daylighting sensor location in the thermal zone. The name of the object of Daylighting:Controls should be specified in this field.

Field: LED-Daylight Targeted Lighting Intensity Schedule Name[LINK]

This field is the name of the schedule for the targeted LED intensity levels. The schedule values can be any positive number representing the targeted photosynthetic photon flux density (PPFD) in the unit of .

Field: Total Leaf Area[LINK]

This field is the estimated one-sided leaf area [] of an indoor living wall. Based on the users’ input, leaf area index (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.

Field: LED Nominal Intensity[LINK]

This field defines the nominal LED intensity level for indoor living wall systems. The value represents the photosynthetic photon flux density (PPFD) of LED grow light. PPFD is measured in which establishes exactly how many photosynthetically active radiation (PAR) photons are landing on a specific area.

Field: LED Nominal Power[LINK]

This field defines the nominal total LED power [W] for the indoor living wall system.

Field: Radiant Fraction of LED Lights[LINK]

This field defines the radiant fraction of the LED lighting power input. The remaining power input is dissipated by convection and contributes to the zone air heat balance.

An IDF example:

IndoorLivingWall,
  Space1-1IndoorLivingWall,   !-Name
  SPACE1-1SouthPartition,     !-Surface Name
  AlwaysOn,                   !-Schedule Name
  Penman-Monteith,            !-ET Calculation Method
  LED,                        !-Lighting Method
  AlwaysOff,                  !-LED Intensity Schedule Name
  ,                           !-Daylighting Control Name
  ,                           !-LED - Daylight Targeted Lighting Intensity Schedule Name
  30,                         !- Total Leaf Area {m2}
  32.5,                       !- LED Nominal Intensity {umol/m2-s}
  640,                        !- LED Nominal Power {W}
  0.6;                        !- Radiant Fraction of LED Lights

Outputs[LINK]

IndoorLivingWall objects have output variables for individual objects. The following outputs are available:

  • Zone,Average,Indoor Living Wall Plant Surface Temperature [C]

  • Zone,Average,Indoor Living Wall Sensible Heat Gain Rate [W]

  • Zone,Average,Indoor Living Wall Latent Heat Gain Rate [W]

  • Zone,Average,Indoor Living Wall Evapotranspiration Rate []

  • Zone,Average,Indoor Living Wall Energy Rate Required For Evapotranspiration Per Unit Area [W/]

  • Zone,Average,Indoor Living Wall LED Operational PPFD []

  • Zone,Average,Indoor Living Wall PPFD []

  • Zone,Average,Indoor Living Wall Vapor Pressure Deficit [Pa]

  • Zone,Average,Indoor Living Wall LED Sensible Heat Gain Rate [W]

  • Zone,Average,Indoor Living Wall LED Operational Power [W]

  • Zone,Sum,Indoor Living Wall LED Electricity Energy [J]

Indoor Living Wall Plant Surface Temperature [C][LINK]

This output is the plant surface temperature in C. Plant surface temperature is determined using surface heat balance of indoor living walls.

Indoor Living Wall Sensible Heat Gain Rate [W][LINK]

This output is the sensible heat gain rate from indoor living walls in W and determined by surface heat balance. Positive sign represents heat gain of spaces; negative sign represents heat loss of spaces.

Indoor Living Wall Latent Heat Gain Rate [W][LINK]

This output is the latent heat gain rate from indoor living walls in W. Latent heat gain is determined based on the increase of enthalpy due to the increase of absolute humidity (or humidity ratio) from plant evapotranspiration.

Indoor Living Wall Evapotranspiration Rate [][LINK]

This output is evapotranspiration (ET) rate of indoor living walls in . The ET rate is directly calculated by ET models(Penman-Monteith model, Stanghellini model or ET model from users).

Indoor Living Wall Energy Rate Required For Evapotranspiration Per Unit Area [W/][LINK]

This output is energy rate per unit area required for plant evapotranspiration (ET) of indoor living walls in W/. The energy rate per unit area for ET is determined by latent heat of vaporization for total ET over time period and surface area.

Indoor Living Wall LED Operational PPFD [][LINK]

This output is operational photosynthetic photon flux density (PPFD) of LED light in . The operational PPFD of LED light is determined based on lighting method. If lighting method is Daylight, the operational LED PPFD is zero. If lighting method is LED, the operational LED PPFD is nominal LED PPFD. If lighting method is LED-Daylight, the operational LED PPFD is calculated based on targeted PPFD and daylighting level with the consideration of nominal LED PPFD.

Indoor Living Wall PPFD [][LINK]

This output is the actual PPFD including LED and/or daylight for indoor living walls in .

Indoor Living Wall Vapor Pressure Deficit [Pa][LINK]

This output is the vapor pressure deficit in Pa. The output represents the difference between saturated vapor pressure and vapor pressure of the moist air of current condition.

Indoor Living Wall LED Sensible Heat Gain Rate [W][LINK]

This output is the LED sensible heat gain rate for indoor living walls in W. The output determines convective heat gain from LED lights when LED lights are on.

Indoor Living Wall LED Operational Power [W][LINK]

This output is LED operational power for indoor living walls in W. The LED operational power is determined by LED nominal power in proportion to the ratio of LED operational PPFD to LED nominal PPFD.

Indoor Living Wall LED Electricity Energy [J][LINK]

This output is LED electricity energy for indoor living walls in J. The LED electricity energy is calculated by LED operational power multiplied by time period.

ElectricEquipment:ITE:AirCooled[LINK]

This object describes air-cooled electric information technology equipment (ITE) which has variable power consumption as a function of loading and temperature.

Inputs[LINK]

Field: Name[LINK]

The name of this object.

Field: Zone or Space Name[LINK]

This field applies this ElectricEquipment:ITE:AirCooled object to a thermal zone or space in the building. If a Zone Name is specified and the zone contains more than one Space, the names of the actual IT equipment objects will be concatenated as <Space Name> <ITEquipment Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.

Field: Air Flow Calculation Method[LINK]

This field specifies the method 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. 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.

The default method is FlowFromSystem.

Field: Design Power Input Calculation Method[LINK]

This field is a key/choice field that tells which of the next two fields are filled and is descriptive of the method for calculating the nominal electric power input to the ITE. The key/choices are:

Watts/Unit:

With this choice, the design power input will be the product of Design Level per Unit and Number of Units. (Both of these fields should be filled.) This is the default.

Watts/Area:

With this choice, the design power input will be a factor per floor area of the zone. (The Watts per Floor Area field should be filled).

Field: Watts per Unit[LINK]

This field (in Watts) is typically used to represent the design electrical power input to the ITE when fully loaded and the entering air temperatures is at the specified design value. This field is used if the choice from the method field is “EquipmentLevel”.

Field: Number of Units[LINK]

This field is multiplied times the Design Level per Unit to determine the design electrical power input to this ITE object when fully loaded and the entering air temperature is at the specified design value. This field is used if the choice from the method field is “EquipmentLevel”. The default is 1.

Field: Watts per Floor Area[LINK]

This factor (Watts/m2) is used, along with the Zone Area to determine the design electrical power input as described in the Design Level field above. This field is used if the choice from the method field is “Watts/Area”.

Field: Design Power Input Schedule Name[LINK]

This field is the name of the operating schedule that modifies the design level power input for this equipment This schedule specifies the fraction (typically 0.0 to 1.0) of this equipment which is available (powered up), regardless of CPU utilization. If this field is blank, the schedule is assumed to always be 1.0.

Field: CPU Loading Schedule Name[LINK]

This field is the name of the schedule that specifies the CPU loading 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.

Field: CPU Power Input Function of Loading and Air Temperature Curve Name[LINK]

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).

Field: Design Fan Power Input Fraction[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to specify the fraction of the total power input at design conditions which is for the cooling fan(s). If fan power data is not available, set this fraction to 0.0. The default is 0.0.

Field: Design Fan Air Flow Rate per Power Input[LINK]

Specifies the cooling fan air flow rate in m3/s per Watt of total electric power input at design conditions (CPU loading = 1.0 and Design Entering Air Temperature).

This is normalized by power input to allow the design power input to be changed without needing to change this value.

Field: Air Flow Function of Loading and Air Temperature Curve Name[LINK]

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).

Field: Fan Power Input Function of Flow Curve Name[LINK]

The name of a single-variable curve or table lookup object which modifies the fan power input as a function of airflow fraction (x). This curve (table) should equal 1.0 at the design air flow rate (flow fraction = 1.0).

Field: Design Entering Air Temperature[LINK]

Specifies the entering air temperature in C at design conditions. The default is 15C.

Field: Environmental Class[LINK]

Specifies the allowable operating conditions for the air inlet conditions. The available inputs are A1, A2, A3, A4, B, C, H1, or None. This is used to report the “ITE Air Inlet Operating Range Exceeded Time.” If None is specified (the default), then no reporting of time outside allowable conditions will be done.

The related reporting variables (such as “ITE Air Inlet Operating Range Exceeded Time”) are based on the following limits1 on the air inlet temperature and humidity conditions shown in Table 5:

ElectricEquipment:ITE:AirCooled Air Inlet Limiting Temperature and Humidity Levels
Environmental Class A1 A2 A3 A4 B C H1
Dry-Bulbmin [C] 15 10 5 5 5 5 5
Dry-Bulbmax [C] 32 35 40 45 35 40 25
Dew-Pointmin [C] -12 -12 -12 -12 -12
Dew-Pointmax [C] 17 21 24 24 28 28 17
Relative Humiditymin [%] 8 8 8 8 8 8 8
Relative Humiditymax [%] 80 80 85 90 80 80 80

Field: Air Inlet Connection Type[LINK]

Specifies the type of connection between the zone and the ITE air inlet node. The choices are:

AdjustedSupply:

This option is used to apply a recirculation adjustment to the ITE inlet conditions. If this option is specified, then the Supply Air Node Name is required and the air inlet temperature to the ITE 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. AdjustedSupply is the default.

ZoneAirNode:

This option is used if there is no containment and the ITE air inlet node is at the average zone condition. All heat output is added to the zone air heat balance as a convective gain.

RoomAirModel:

This option connects the ITE air inlet and outlet nodes to a room air model (Ref. RoomAirModelType and RoomAir:Node). Currently in EnergyPlus, this option has not been fully implemented. If the user chooses this option, the program will issue a warning message and this field will be adjusted to ZoneAirNode.

This field is only used when Air Flow Calculation Method is FlowFromSystem.

Field: Air Inlet Room Air Model Node Name[LINK]

Specifies the name of a room air model node (ref. RoomAir:Node) which is the air inlet to this equipment. This field is required if the Air Node Connection Type = RoomAirModel.

Field: Air Outlet Room Air Model Node Name[LINK]

Specifies the node name of a room air model node (ref. RoomAir:Node) which is the air outlet from this equipment. This field is required if the Air Node Connection Type = RoomAirModel.

Field: Supply Air Node Name[LINK]

Specifies the node name of the supply air inlet node service this ITE. If the Air Node Connection Type = AdjustedSupply ,then this field is required, and the conditions at this node will be used to determine the ITE air inlet conditions. This field is also required if reporting of the Supply Heat Index is desired. Also required if Calculation Method = FlowControlWithApproachTemperatures.

Field: Design Recirculation Fraction[LINK]

Specifies the recirculation fraction for this equipment at design conditions. This field is used only if the Air Node Connection Type = AdjustedSupply. The recirculation fraction is defined as the ratio of recirculated air flow to total air flow entering the ITE. Recirculation is dependent upon many factors including rack and containment configuration. The default is 0.0 (no recirculation). This field is only used when Air Flow Calculation Method = FlowFromSystem.

Field: Recirculation Function of Loading and Supply Temperature Curve Name[LINK]

The name of a two-variable curve or table lookup object which modifies the Design 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 = FlowFromSystem.

Field: Design Electric Power Supply Efficiency[LINK]

This field is a decimal number used to specify the efficiency of the power supply system serving this ITE. The default is 1.0.

Field: Electric Power Supply Efficiency Function of Part Load Ratio Curve Name[LINK]

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 the design power consumption (part load ratio = 1.0). If this curve is left blank, then the curve is assumed to always equal 1.0.

Field: Fraction of Electric Power Supply Losses to Zone[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to specify the fraction of the electric power supply losses which are a heat gain to the zone containing the ITE. If this value is less than 1.0, the remainder of the losses are assumed to be lost to the outdoors. The default is 1.0.

Field: CPU End-Use Subcategory[LINK]

This equipment is metered on the Interior Equipment end-use category for Electricity. This field allows you to specify a user-defined end-use subcategory for the CPU power consumption. A new meter for reporting is created for each unique subcategory (ref: Output:Meter object). Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and in the LEED Summary table EAp2-4/5 Performance Rating Method Compliance. The default is ITE-CPU.

Field: Fan End-Use Subcategory[LINK]

This equipment is metered on the Interior Equipment end-use category for Electricity. This field allows you to specify a user-defined end-use subcategory for the fan power consumption. A new meter for reporting is created for each unique subcategory (ref: Output:Meter object). Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and in the LEED Summary table EAp2-4/5 Performance Rating Method Compliance. The default is ITE-Fans.

Field: Electric Power Supply End-Use Subcategory[LINK]

This equipment is metered on the Interior Equipment end-use category for Electricity. This field allows you to specify a user-defined end-use subcategory for the electric power supply power consumption. A new meter for reporting is created for each unique subcategory (ref: Output:Meter object). Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and in the LEED Summary table EAp2-4/5 Performance Rating Method Compliance. The default is ITE-UPS

Field: Supply Temperature Difference[LINK]

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.

Field: Supply Temperature Difference Schedule[LINK]

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.

Field: Return Temperature Difference[LINK]

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.

Field: Return Temperature Difference Schedule[LINK]

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.

An IDF example:

ElectricEquipment:ITE:AirCooled,
  Data Center Servers,     !- Name
  Main Zone,               !- Zone or Space Name
  FlowFromSystem,          !- Air Flow Calculation Method
  Watts/Unit,              !- Design Power Input Calculation Method
  500,                     !- Watts per Unit {W}
  200,                     !- Number of Units
  ,                        !- Watts per Floor Area {W/m2}
  Data Center Operation Schedule,  !- Design Power Input Schedule Name
  Data Center CPU Loading Schedule,  !- CPU Loading  Schedule Name
  Model 5250 Power fLoadTemp,  !- CPU Power Input Function of Loading and Air Temperature Curve Name
  0.4,                     !- Design Fan Power Input Fraction
  0.0001,                  !- Design Fan Air Flow Rate per Power Input {m3/s-W}
  Model 5250 AifFlow fLoadTemp,  !- Air Flow Function of Loading and Air Temperature Curve Name
  ECM FanPower fFlow,      !- Fan Power Input Function of Flow Curve Name
  15,                      !- Design Entering Air Temperature {C}
  A3,                      !- Environmental Class
  AdjustedSupply,          !- Air Inlet Connection Type
  ,                        !- Air Inlet Room Air Model Node Name
  ,                        !- Air Outlet Room Air Model Node Name
  Main Zone Inlet Node,    !- Supply Air Node Name
  0.1,                     !- Design Recirculation Fraction
  Data Center Recirculation fLoadTemp,  !- Recirculation Function of Loading and Supply Temperature Curve Name
  0.9,                     !- Design Electric Power Supply Efficiency
  UPS Efficiency fPLR,     !- Electric Power Supply Efficiency Function of Part Load Ratio Curve Name
  1,                       !- Fraction of Electric Power Supply Losses to Zone
  ITE-CPU,                 !- CPU End-Use Subcategory
  ITE-Fans,                !- Fan End-Use Subcategory
  ITE-UPS;                 !- Electric Power Supply End-Use Subcategory

Another IDF example when Air Flow Calculation Method = FlowControlWithApproachTemperatures:

ElectricEquipment:ITE:AirCooled,
  SmallDataCenter ComputerRoom Elec Equip,     !- Name
  ComputerRoom ZN,                             !- Zone or Space Name
  FlowControlWithApproachTemperatures,         !- Air Flow Calculation Method
  Watts/Area,                      !- Design Power Input Calculation Method
  ,                                !- Watts per Unit {W}
  ,                                !- Number of Units
  430.556416668389,                !- Watts per Floor Area {W/m2}
  Data Center Operation Schedule,  !- Design Power Input Schedule Name
  DataCenter Equipment_SCH,  !- CPU Loading  Schedule Name
  Data Center Servers Power fLoadTemp,  !- CPU Power Input Function of Loading and Air Temperature Curve Name
  0.4,                     !- Design Fan Power Input Fraction
  0.0001,                  !- Design Fan Air Flow Rate per Power Input {m3/s-W}
  Data Center Servers Airflow fLoadTemp,  !- Air Flow Function of Loading and Air Temperature Curve Name
  ECM FanPower fFlow,      !- Fan Power Input Function of Flow Curve Name
  15,                      !- Design Entering Air Temperature {C}
  A3,                      !- Environmental Class
  AdjustedSupply,          !- Air Inlet Connection Type
  ,                        !- Air Inlet Room Air Model Node Name
  ,                        !- Air Outlet Room Air Model Node Name
  Node 6,                  !- Supply Air Node Name
  0,                     !- Design Recirculation Fraction
  Data Center Recirculation fLoadTemp,  !- Recirculation Function of Loading and Supply Temperature Curve Name
  0.9,                     !- Design Electric Power Supply Efficiency
  UPS Efficiency fPLR,     !- Electric Power Supply Efficiency Function of Part Load Ratio Curve Name
  1,                       !- Fraction of Electric Power Supply Losses to Zone
  ITE-CPU,                 !- CPU End-Use Subcategory
  ITE-Fans,                !- Fan End-Use Subcategory
  ITE-UPS,                 !- Electric Power Supply End-Use Subcategory
  3,                       !- field Supply Approach Temperature
  ,                        !- field Supply Approach Temperature Schedule
  -3,                      !- field Return Approach Temperature
  ;                        !- field Return Approach Temperature Schedule

Outputs[LINK]

ElectricEquipment:ITE:AirCooled Outputs:

  • Zone,Average,ITE CPU Electricity Rate [W]

  • Zone,Average,ITE Fan Electricity Rate [W]

  • Zone,Average,ITE UPS Electricity Rate [W]

  • Zone,Average,ITE CPU Electricity Rate at Design Inlet Conditions [W]

  • Zone,Average,ITE Fan Electricity Rate at Design Inlet Conditions [W]

  • Zone,Average,ITE UPS Heat Gain to Zone Rate [W]

  • Zone,Average,ITE Total Heat Gain to Zone Rate [W]

  • Zone,Sum,ITE CPU Electricity Energy [J]

  • Zone,Sum,ITE Fan Electricity Energy [J]

  • Zone,Sum,ITE UPS Electricity Energy [J]

  • Zone,Sum,ITE CPU Electricity Energy at Design Inlet Conditions [J]

  • Zone,Sum,ITE Fan Electricity Energy at Design Inlet Conditions [J]

  • Zone,Sum,ITE UPS Heat Gain to Zone Energy [J]

  • Zone,Sum,ITE Total Heat Gain to Zone Energy [J]

  • Zone,Average,ITE Standard Density Air Volume Flow Rate [m3/s]

  • Zone,Average,ITE Current Density Air Volume Flow Rate [m3/s]

  • Zone,Average,ITE Air Mass Flow Rate [kg/s]

  • Zone,Average,ITE Air Inlet Dry-Bulb Temperature [C]

  • Zone,Average,ITE Air Inlet Dewpoint Temperature [C]

  • Zone,Average,ITE Air Inlet Relative Humidity [%]

  • Zone,Average,ITE Air Outlet Dry-Bulb Temperature [C]

  • Zone,Average,ITE Supply Heat Index []

  • Zone,Sum,ITE Air Inlet Operating Range Exceeded Time [hr]

  • Zone,Sum,ITE Air Inlet Dry-Bulb Temperature Above Operating Range Time [hr]

  • Zone,Sum,ITE Air Inlet Dry-Bulb Temperature Below Operating Range Time [hr]

  • Zone,Sum,ITE Air Inlet Dewpoint Temperature Above Operating Range Time [hr]

  • Zone,Sum,ITE Air Inlet Dewpoint Temperature Below Operating Range Time [hr]

  • Zone,Sum,ITE Air Inlet Relative Humidity Above Operating Range Time [hr]

  • Zone,Sum,ITE Air Inlet Relative Humidity Below Operating Range Time [hr]

  • Zone,Average,ITE Air Inlet Dry-Bulb Temperature Difference Above Operating Range [deltaC]

  • Zone,Average,ITE Air Inlet Dry-Bulb Temperature Difference Below Operating Range [deltaC]

  • Zone,Average,ITE Air Inlet Dewpoint Temperature Difference Above Operating Range [deltaC]

  • Zone,Average,ITE Air Inlet Dewpoint Temperature Difference Below Operating Range [deltaC]

  • Zone,Average,ITE Air Inlet Relative Humidity Difference Above Operating Range [%]

  • Zone,Average,ITE Air Inlet Relative Humidity Difference Below Operating Range [%]

  • Zone,Average,Space ITE CPU Electricity Rate [W]

  • Zone,Average,Space ITE Fan Electricity Rate [W]

  • Zone,Average,Space ITE UPS Electricity Rate [W]

  • Zone,Average,Space ITE CPU Electricity Rate at Design Inlet Conditions [W]

  • Zone,Average,Space ITE Fan Electricity Rate at Design Inlet Conditions [W]

  • Zone,Average,Space ITE UPS Heat Gain to Zone Rate [W]

  • Zone,Average,Space ITE Total Heat Gain to Zone Rate [W]

  • Zone,Sum,Space ITE CPU Electricity Energy [J]

  • Zone,Sum,Space ITE Fan Electricity Energy [J]

  • Zone,Sum,Space ITE UPS Electricity Energy [J]

  • Zone,Sum,Space ITE CPU Electricity Energy at Design Inlet Conditions [J]

  • Zone,Sum,Space ITE Fan Electricity Energy at Design Inlet Conditions [J]

  • Zone,Sum,Space ITE UPS Heat Gain to Zone Energy [J]

  • Zone,Sum,Space ITE Total Heat Gain to Zone Energy [J]

  • Zone,Average,Space ITE Standard Density Air Volume Flow Rate [m3/s]

  • Zone,Average,Space ITE Air Mass Flow Rate [kg/s]

  • Zone,Average,Space ITE Average Supply Heat Index []

  • Zone,Sum,Space ITE Any Air Inlet Operating Range Exceeded Time [hr]

  • Zone,Sum,Space ITE Any Air Inlet Dry-Bulb Temperature Above Operating Range Time [hr]

  • Zone,Sum,Space ITE Any Air Inlet Dry-Bulb Temperature Below Operating Range Time [hr]

  • Zone,Sum,Space ITE Any Air Inlet Dewpoint Temperature Above Operating Range Time [hr]

  • Zone,Sum,Space ITE Any Air Inlet Dewpoint Temperature Below Operating Range Time [hr]

  • Zone,Sum,Space ITE Any Air Inlet Relative Humidity Above Operating Range Time [hr]

  • Zone,Sum,Space ITE Any Air Inlet Relative Humidity Below Operating Range Time [hr]

  • Zone,Average,Zone ITE Adjusted Return Air Temperature [C]

  • Zone,Average,Zone ITE CPU Electricity Rate [W]

  • Zone,Average,Zone ITE Fan Electricity Rate [W]

  • Zone,Average,Zone ITE UPS Electricity Rate [W]

  • Zone,Average,Zone ITE CPU Electricity Rate at Design Inlet Conditions [W]

  • Zone,Average,Zone ITE Fan Electricity Rate at Design Inlet Conditions [W]

  • Zone,Average,Zone ITE UPS Heat Gain to Zone Rate [W]

  • Zone,Average,Zone ITE Total Heat Gain to Zone Rate [W]

  • Zone,Sum,Zone ITE CPU Electricity Energy [J]

  • Zone,Sum,Zone ITE Fan Electricity Energy [J]

  • Zone,Sum,Zone ITE UPS Electricity Energy [J]

  • Zone,Sum,Zone ITE CPU Electricity Energy at Design Inlet Conditions [J]

  • Zone,Sum,Zone ITE Fan Electricity Energy at Design Inlet Conditions [J]

  • Zone,Sum,Zone ITE UPS Heat Gain to Zone Energy [J]

  • Zone,Sum,Zone ITE Total Heat Gain to Zone Energy [J]

  • Zone,Average,Zone ITE Standard Density Air Volume Flow Rate [m3/s]

  • Zone,Average,Zone ITE Air Mass Flow Rate [kg/s]

  • Zone,Average,Zone ITE Average Supply Heat Index []

  • Zone,Sum,Zone ITE Any Air Inlet Operating Range Exceeded Time [hr]

  • Zone,Sum,Zone ITE Any Air Inlet Dry-Bulb Temperature Above Operating Range Time [hr]

  • Zone,Sum,Zone ITE Any Air Inlet Dry-Bulb Temperature Below Operating Range Time [hr]

  • Zone,Sum,Zone ITE Any Air Inlet Dewpoint Temperature Above Operating Range Time [hr]

  • Zone,Sum,Zone ITE Any Air Inlet Dewpoint Temperature Below Operating Range Time [hr]

  • Zone,Sum,Zone ITE Any Air Inlet Relative Humidity Above Operating Range Time [hr]

  • Zone,Sum,Zone ITE Any Air Inlet Relative Humidity Below Operating Range Time [hr]

Space or Zone ITE CPU Electricity Rate [W][LINK]

ITE CPU Electricity Rate [J][LINK]

Space or Zone ITE CPU Electricity Energy [J][LINK]

ITE CPU Electricity Energy [J][LINK]

The electric power (or energy) input to the ITE equipment CPU (total power input less cooling fan power). The ITE CPU Electricity Energy output is also added to a meter object with Resource Type = Electricity, End Use Key = InteriorEquipment, Group Key = Building (Ref. Output:Meter object).

Space or Zone ITE CPU Electricity Rate at Design Inlet Conditions [W][LINK]

ITE CPU Electricity Rate at Design Inlet Conditions [W][LINK]

Space or Zone ITE CPU Electricity Energy at Design Inlet Conditions [J][LINK]

ITE CPU Electricity Energy at Design Inlet Conditions [J][LINK]

The electric power (or energy) input to the ITE equipment CPU (total power input less cooling fan power) if the air inlet temperature were held at the design condition. May be used to calculate “IT efficiency”, the ratio of (IT energy consumed in the facility) / (IT energy that would have been consumed in the facility if the ITE were held at the reference temperature).

Space or Zone ITE Fan Electricity Rate [W][LINK]

ITE Fan Electricity Rate [W][LINK]

Space or Zone ITE Fan Electricity Energy [J][LINK]

ITE Fan Electricity Energy [J][LINK]

The electric power (or energy) input to the ITE cooling fan. The ITE Fan Electricity Energy output is also added to a meter object with Resource Type = Electricity, End Use Key = InteriorEquipment, Group Key = Building (Ref. Output:Meter object).

Space or Zone ITE Fan Electricity Rate at Design Inlet Conditions [W][LINK]

ITE Fan Electricity Rate at Design Inlet Conditions [W][LINK]

Space or Zone ITE Fan Electricity Energy at Design Inlet Conditions [J][LINK]

ITE Fan Electricity Energy at Design Inlet Conditions [J][LINK]

The electric power (or energy) input to the ITE cooling fan if the air inlet temperature were held at the design condition. May be used to calculate “IT efficiency”, the ratio of (IT energy consumed in the facility) / (IT energy that would have been consumed in the facility if the ITE were held at the reference temperature).

Space or Zone ITE UPS Electricity Rate [W][LINK]

ITE UPS Electricity Rate [W][LINK]

Space or Zone ITE UPS Electricity Energy [J][LINK]

ITE UPS Electricity Energy [J][LINK]

The net electric power (or energy) input to the ITE equipment UPS (total power input less power delivered to ITE). The ITE UPS Electricity Energy output is also added to a meter object with Resource Type = Electricity, End Use Key = InteriorEquipment, Group Key = Building (Ref. Output:Meter object).

ITE Electricity Meters[LINK]

The ITE CPU Electricity Energy, ITE Fan Electricity Energy, and ITE UPS Electricity Energy are each included separately in the following Electricity meters, with their respective end-use subcategory:

Electricity:Facility
Electricity:Building
Electricity:Zone:<Zone Name>
Electricity:SpaceType:<Space Type Name>
InteriorEquipment:Electricity
InteriorEquipment:Electricity:Zone:<Zone Name>
InteriorEquipment:Electricity:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorEquipment:Electricity
<End-Use Subcategory>:InteriorEquipment:Electricity:Zone:<Zone Name>
<End-Use Subcategory>:InteriorEquipment:Electricity:SpaceType:<Space Type Name>

Space or Zone ITE UPS Heat Gain to Zone Rate [W][LINK]

ITE UPS Heat Gain to Zone Rate [W][LINK]

Space or Zone ITE UPS Heat Gain to Zone Energy [J][LINK]

ITE UPS Heat Gain to Zone Energy [J][LINK]

The heat gain rate (or energy) to the zone from the UPS.

Space or Zone ITE Total Heat Gain to Zone Rate [W][LINK]

ITE Total Heat Gain to Zone Rate [W][LINK]

Space or Zone ITE Total Heat Gain to Zone Energy [J][LINK]

ITE Total Heat Gain to Zone Energy [J][LINK]

The heat gain rate (or energy) to the zone from the UPS and from the CPU and fans if the ITE. Air Inlet Connection Type is AdjustedSupply or ZoneAirNode. If RoomAirModel is selected, then only the heat gain from the UPS is added directly to the zone air heat balance, the heat gain from the CPU and fans will be added to the ITE air Outlet Room Air Model Node

Space or Zone ITE Standard Density Air Volume Flow Rate [m3/s][LINK]

ITE Standard Density Air Volume Flow Rate [m3/s][LINK]

Reports the average air volume flow rate through the ITE over the reporting interval. Standard density in EnergyPlus corresponds to 20C dry bulb, dry air, and nominally adjusted for elevation.

Space or Zone ITE Current Density Air Volume Flow Rate [m3/s][LINK]

ITE Current Density Air Volume Flow Rate [m3/s][LINK]

Reports the average air volume flow rate through the ITE over the reporting interval, calculated using the current density at the air inlet node.

Space or Zone ITE Air Mass Flow Rate [kg/s][LINK]

ITE Air Mass Flow Rate [kg/s][LINK]

Reports the average air mass flow rate through the ITE over the reporting interval, calculated using the current density at the air inlet node.

ITE Air Inlet Dry-Bulb Temperature [C][LINK]

The dry-bulb temperature of the air entering the ITE.

ITE Air Inlet Dewpoint Temperature [C][LINK]

The dewpoint temperature of the air entering the ITE.

ITE Air Inlet Relative Humidity [%][LINK]

The dewpoint temperature of the air entering the ITE.

ITE Air Outlet Dry-Bulb Temperature [C][LINK]

The dry-bulb temperature of the air leaving the ITE.

Space or Zone ITE Average Supply Heat Index [][LINK]

ITE Supply Heat Index [][LINK]

The supply heat index (SHI) for this equipment. SHI is a dimensionless measure of recirculation of hot air into the cold air intake of the ITE. where is the dry-bulb temperature of the air entering the ITE, Tout is the dry-bulb temperature of the air leaving the ITE, and is the dry-bulb temperature at the Supply Air Node. If a Supply Air Node Name is not specified for this object, then this output will not be reported.

Space or Zone ITE Any Air Inlet Operating Range Exceeded Time [hr][LINK]

ITE Air Inlet Operating Range Exceeded Time [hr][LINK]

Hours when the dry-bulb and/or dewpoint temperature of the air entering the ITE is outside the range specified by the ITE Environmental Class.

Space or Zone ITE Any Air Inlet Dry-Bulb Temperature Above Operating Range Time [hr][LINK]

ITE Air Inlet Dry-Bulb Temperature Above Operating Range Time [hr][LINK]

Hours when the dry-bulb temperature of the air entering the ITE is above the range specified by the ITE Environmental Class.

ITE Air Inlet Dry-Bulb Temperature Difference Above Operating Range [deltaC][LINK]

The temperature difference (in C) between the air inlet dry-bulb temperature and the maximum allowable dry-bulb temperature specified by the ITE Environmental Class. Only positive values are reported. When the dry-bulb temperature of the air entering the ITE is below the maximum specified by the ITE Environmental Class, this output will be zero.

Space or Zone ITE Any Air Inlet Dry-Bulb Temperature Below Operating Range Time [hr][LINK]

ITE Air Inlet Dry-Bulb Temperature Below Operating Range Time [hr][LINK]

Hours when the dry-bulb temperature of the air entering the ITE is above the range specified by the ITE Environmental Class.

ITE Air Inlet Dry-Bulb Temperature Difference Below Operating Range [deltaC][LINK]

The temperature difference (in ΔC) between the air inlet dry-bulb temperature and the minimum allowable dry-bulb temperature specified by the ITE Environmental Class. Only negative values are reported. When the dry-bulb temperature of the air entering the ITE is above the minimum specified by the ITE Environmental Class, this output will be zero.

Space or Zone ITE Any Air Inlet Dewpoint Temperature Above Operating Range Time [hr][LINK]

ITE Air Inlet Dewpoint Temperature Above Operating Range Time [hr][LINK]

Hours when the dewpoint temperature of the air entering the ITE is above the range specified by the ITE Environmental Class.

ITE Air Inlet Dewpoint Temperature Difference Above Operating Range [deltaC][LINK]

The temperature difference (in ΔC) between the air inlet dewpoint temperature and the maximum allowable dewpoint temperature specified by the ITE Environmental Class. Only positive values are reported. When the dewpoint temperature of the air entering the ITE is below the maximum specified by the ITE Environmental Class, this output will be zero.

Space or Zone ITE Any Air Inlet Dewpoint Temperature Below Operating Range Time [hr][LINK]

ITE Air Inlet Dewpoint Temperature Below Operating Range Time [hr][LINK]

Hours when the dewpoint temperature of the air entering the ITE is above the range specified by the ITE Environmental Class.

ITE Air Inlet Dewpoint Temperature Difference Below Operating Range [deltaC][LINK]

The temperature difference (in ΔC) between the air inlet dewpoint temperature and the minimum allowable dewpoint temperature specified by the ITE Environmental Class. Only negative values are reported. When the dewpoint temperature of the air entering the ITE is above the minimum specified by the ITE Environmental Class, this output will be zero.

Space or Zone ITE Any Air Inlet Relative Humidity Above Operating Range Time [hr][LINK]

ITE Air Inlet Relative Humidity Above Operating Range Time [hr][LINK]

Hours when the relative humidity of the air entering the ITE is above the range specified by the ITE Environmental Class.

ITE Air Inlet Relative Humidity Difference Above Operating Range [%][LINK]

The temperature difference (in ΔC) between the air inlet relative humidity and the maximum allowable relative humidity specified by the ITE Environmental Class. Only positive values are reported. When the relative humidity of the air entering the ITE is below the maximum specified by the ITE Environmental Class, this output will be zero.

Space or Zone ITE Any Air Inlet Relative Humidity Below Operating Range Time [hr][LINK]

ITE Air Inlet Relative Humidity Below Operating Range Time [hr][LINK]

Hours when the relative humidity of the air entering the ITE is above the range specified by the ITE Environmental Class.

ITE Air Inlet Relative Humidity Difference Below Operating Range [%][LINK]

The difference (in ) between the air inlet relative humidity and the minimum allowable relative humidity (RH) specified by the ITE Environmental Class. Only negative values are reported. When the relative humidity of the air entering the ITE is above the minimum specified by the ITE Environmental Class, this output will be zero.

Zone ITE Adjusted Return Air Temperature [C][LINK]

Return air temperature after adjustment by ITE objects.

ZoneBaseboard:OutdoorTemperatureControlled[LINK]

This object specifies outside temperature-controlled (OTC) baseboard heating. The capacities (high and low) are specified in W at the temperatures specified. The schedule allows both capacities to change hourly on a proportional basis. This baseboard heater does not operate if the outdoor dry-bulb is above the high temperature limit. Between the high temperature and the low temperature, the capacity is interpolated (linear) between the high and the low capacity values. Below the low temperature, the capacity is set at the low capacity value. This allows the user to add baseboard heat to a perimeter zone starting at a prescribed temperature and then slowly increases this capacity to a max value.

Example:

Temperature High = 10 C Capacity High = 100,000 W
Temperature Low = 0 C Capacity Low = 500,000 W
Outdoor Temperature Controlled Baseboard Heat Temperature vs. Capacity
Outdoor Dry-bulb(C) Baseboard Output(W)
> 10 0
10 100,000
8 180,000
6 260,000
4 340,000
2 420,000
0 500,000
< 0 500,000

Inputs[LINK]

Field: Name[LINK]

The name of the ZoneBaseboard:OutdoorTemperatureControlled object.

Field: Zone or ZoneList or Space or SpaceList Name[LINK]

This field applies this ZoneBaseboard:OutdoorTemperatureControlled object to one or more thermal zones or spaces in the building. The names of the actual baseboard heat objects may be concatenated as <Space Name> <ZoneBaseboard Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.

Field: Schedule Name[LINK]

This field is the name of the schedule that modifies the capacities (high and low) for baseboard heat equipment (see next four fields). The schedule values can be any positive number. The actual energy input for the baseboard equipment in a zone as defined by this statement depends on the actual outdoor temperature and where that temperature is in the range of Low Temperature to High Temperature.

Field: Capacity at Low Temperature[LINK]

This is the baseboard equipment capacity (Watts) at the low temperature limit. This is the maximum capacity of the baseboard equipment in full load operation. This field is autosizable.

Field: Low Temperature[LINK]

If the outdoor dry-bulb temperature (degrees Celsius) is at or below the low temperature the baseboard heater operates at the low temperature capacity. This field is autosizable. The lowest design outdoor dry bulb temperature is chosen, if autosized.

Field: Capacity at High Temperature[LINK]

This is the baseboard equipment capacity (Watts) at the high temperature limit. This field is autosizable. The capacity at low temperature is prorated against the reference low and high temperature fields, if autosized.

Field: High Temperature[LINK]

If the outdoor dry-bulb temperature (degrees Celsius) is greater than the high temperature the baseboard heater will not operate. This field is autosizable. If autosized, this is equal to the design zone heating setpoint temperature described below, so that the capacity at high temperature is zero.

Field: Fraction Radiant[LINK]

This field is a decimal number between 0.0 and 1.0 and is used to characterize the type of heat being given off by baseboard heat equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by the baseboard heat equipment to give the amount of long wavelength radiation gain to the zone.

Field: End-Use Subcategory[LINK]

Allows you to specify a user-defined end-use subcategory, e.g., “Perimeter Baseboards”, etc. A new meter for reporting is created for each unique subcategory (ref: Output:Meter objects). Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and in the LEED Summary table EAp2-4/5 Performance Rating Method Compliance. If this field is omitted or blank, the baseboard equipment will be assigned to the “General” end-use subcategory.

Field: Design Zone Heating Setpoint[LINK]

This is heating setpoint temperature in the zone where the unit serves. This is used to autosize high temperature and capacity at high temperature fields. The default value is 20C.

An IDF example:

ZoneBaseboard:OutdoorTemperatureControlled,
  SPACE4-1 BBHeat 1,  !- Name
  SPACE4-1,           !- Zone Name
  EQUIP-1,            !- SCHEDULE Name
  1500,               !- Capacity at low temperature {W}
  0,                  !- Low Temperature {C}
  500,                !- Capacity at high temperature {W}
  10,                 !- High Temperature {C}
  0.5,                !- Fraction Radiant
  Baseboard Heat,     !- End-Use Subcategory
  20;                 !- Design Zone Heating Setpoint {C}

Outputs[LINK]

ZoneBaseboard:OutdoorTemperatureControlled objects have output variables for individual objects and for zone totals. The following outputs are available:

  • Zone,Average,Baseboard Electricity Rate [W]

  • Zone,Sum,Baseboard Electricity Energy [J]

  • Zone,Sum,Baseboard Radiant Heating Energy [J]

  • Zone,Average,Baseboard Radiant Heating Rate [W]

  • Zone,Sum,Baseboard Convective Heating Energy [J]

  • Zone,Average,Baseboard Convective Heating Rate [W]

  • Zone,Sum,Baseboard Total Heating Energy [J]

  • Zone,Average,Baseboard Total Heating Rate [W]

  • Zone,Average,Space Baseboard Electricity Rate [W]

  • Zone,Sum,Space Baseboard Electricity Energy [J]

  • Zone,Sum,Space Baseboard Radiant Heating Energy [J]

  • Zone,Average,Space Baseboard Radiant Heating Rate [W]

  • Zone,Sum,Space Baseboard Convective Heating Energy [J]

  • Zone,Average,Space Baseboard Convective Heating Rate [W]

  • Zone,Sum,Space Baseboard Total Heating Energy [J]

  • Zone,Average,Space Baseboard Total Heating Rate [W]

  • Zone,Average,Zone Baseboard Electricity Rate [W]

  • Zone,Sum,Zone Baseboard Electricity Energy [J]

  • Zone,Sum,Zone Baseboard Radiant Heating Energy [J]

  • Zone,Average,Zone Baseboard Radiant Heating Rate [W]

  • Zone,Sum,Zone Baseboard Convective Heating Energy [J]

  • Zone,Average,Zone Baseboard Convective Heating Rate [W]

  • Zone,Sum,Zone Baseboard Total Heating Energy [J]

  • Zone,Average,Zone Baseboard Total Heating Rate [W]

Baseboard Electricity Rate [W][LINK]

This field is the electric power for the ZoneBaseboard:OutdoorTemperatureControlled object in Watts.

Baseboard Electricity Energy [J][LINK]

The outdoor temperature controlled baseboard heat option is assumed to be fueled by electricity. This field is the same as the Baseboard Total Heating Energy (above) in joules. This energy is included in the following meters:

Electricity:Facility
Electricity:Building
Electricity:Zone:<Zone Name>
Electricity:SpaceType:<Space Type Name>
InteriorEquipment:Electricity
InteriorEquipment:Electricity:Zone:<Zone Name>
InteriorEquipment:Electricity:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorEquipment:Electricity
<End-Use Subcategory>:InteriorEquipment:Electricity:Zone:<Zone Name>
<End-Use Subcategory>:InteriorEquipment:Electricity:SpaceType:<Space Type Name>

Baseboard Radiant Heating Rate [W][LINK]

Baseboard Radiant Heating Energy [J][LINK]

These output variables are the amount of radiant heat gain for the ZoneBaseboard:OutdoorTemperatureControlled object in Watts (for rate) or Joules. This is determined by the current heat gain from the heater to the zone and the “Fraction Radiant” specified in the input. The radiant gains (long wavelength) are distributed to the surfaces using an area weighting scheme.

Baseboard Convective Heating Rate [W][LINK]

Baseboard Convective Heating Energy [J][LINK]

These output variables are the amount of convective heat gain for the ZoneBaseboard:OutdoorTemperatureControlled object in Watts (for rate) or Joules. This is determined by the current heat gain from the heater to the zone and the “Fraction Radiant” specified in input (1-FractionRadiant = FractionConvected). The convective heat gain is added to the zone air heat balance directly.

Baseboard Total Heating Rate [W][LINK]

Baseboard Total Heating Energy [J][LINK]

These output variables are the amount of heat gain for the ZoneBaseboard:OutdoorTemperatureControlled object in Watts (for rate) or Joules. This is determined by the sum of the radiant and convective heat gains from the baseboard heat.

Space or Zone Baseboard Electricity Rate [W][LINK]

This field is the electric power for all ZoneBaseboard:OutdoorTemperatureControlled objects within the space or zone in Watts.

Space or Zone Baseboard Electricity Energy [J][LINK]

The outdoor temperature controlled baseboard heat option is assumed to be fueled by electricity. This field is the same as the Baseboard Total Heating Energy (above) in joules.

Space or Zone Baseboard Radiant Heating Rate [W][LINK]

Space or Zone Baseboard Radiant Heating Energy [J][LINK]

These output variables are the amount of radiant heat gain for all ZoneBaseboard:OutdoorTemperatureControlled objects within the space or zone in Watts (for rate) or Joules. This is determined by the current heat gain from the heater to the space or zone and the “Fraction Radiant” specified in the input. The radiant gains (long wavelength) are distributed to the surfaces using an area weighting scheme.

Space or Zone Baseboard Convective Heating Rate [W][LINK]

Space or Zone Baseboard Convective Heating Energy [J][LINK]

These output variables are the amount of convective heat gain for all ZoneBaseboard:OutdoorTemperatureControlled objects within the space or zone in Watts (for rate) or Joules. This is determined by the current heat gain from the heater to the space or zone and the “Fraction Radiant” specified in input (1-FractionRadiant = FractionConvected). The convective heat gain is added to the space or zone air heat balance directly.

Space or Zone Baseboard Total Heating Rate [W][LINK]

Space or Zone Baseboard Total Heating Energy [J][LINK]

These output variables are the amount of heat gain for all ZoneBaseboard:OutdoorTemperatureControlled objects within the space or zone in Watts (for rate) or Joules. This is determined by the sum of the radiant and convective heat gains from the baseboard heat.

SwimmingPool:Indoor[LINK]

The Indoor Swimming Pool object is used to describe the indoor swimming pools that are exposed to the internal environment. There are several rules that should be noted regarding the specification of an indoor pool in EnergyPlus. First, the pool is linked to a surface that must be a floor. The pool is assumed to cover the entire floor to which it is linked. If the pool only covers part of the floor in the actual building, then the user must break the floor up into multiple sections.

As pools attempt to achieve a particular water temperature and have a variety of heat losses, heating equipment is necessary to maintain the proper setpoint temperature. In EnergyPlus, the pool itself becomes part of the demand side of a plant loop with heating equipment on the supply side providing whatever heating is needed to maintain the desired temperature. This heating equipment as well as the loop connections must be entered separately and the input shown in this section only details what is needed to specify the pool itself.

There are a variety of rules that limit the application of indoor swimming pools in EnergyPlus. The following are a list of these rules:

  • The pool must reference a valid surface in the input file. This surface must be a floor and cannot be other surface types like ceilings, walls, windows, etc.

  • The pool cannot refer to a surface that is also a radiant system, ventilated slab, or another pool.

  • The surface that the pool references must be modeled using conduction transfer functions (CTF).

  • The pool cannot utilize movable insulation or have a heat source or sink associated with it (something used to model low temperature radiant systems).

The following information is useful for defining and modeling an indoor pool in EnergyPlus. For more information on the algorithm used for this model or details on some of the input parameters, please reference the Indoor Swimming Pool section of the EnergyPlus Engineering Reference document.

Inputs[LINK]

Field: Name[LINK]

This is a unique name associated with the indoor swimming pool.

Field: Surface Name[LINK]

This is the name of the surface (floor) where the pool is located. Pools are not allowed on any surfaces other than a floor. For more rules on surfaces that can be used for pools, please see the information in this section on indoor pools above.

Field: Average Depth[LINK]

This field is the average depth of the pool in meters. If the pool has variable depth, the average depth should be specified to achieve the proper volume of water in the pool.

Field: Activity Factor Schedule Name[LINK]

This field references a schedule that contains values for pool activity. This parameter can be varied using the schedule named here, and it has an impact on the amount of evaporation that will take place from the pool to the surrounding zone air. For example values of the activity factor and what impact it will have on the evaporation of water from the pool, please refer to the Indoor Swimming Pool section of the EnergyPlus Engineering Reference document. If left blank, the activity factor will be assumed to be unity. Note that the activity factor schedule should not be set equal to an occupancy schedule since an activity factor of zero means that no evaporation will take place from the pool.

Field: Make-up Water Supply Schedule Name[LINK]

The schedule named by this field establishes a cold water temperature [C] for the water that replaces the water which is lost from the pool due to evaporation. If blank, water temperatures are calculated by the Site:WaterMainsTemperature object. This field (even if blank) overrides the Cold Water Supply Temperature Schedule in all of the listed WaterUse:Equipment objects.

Field: Cover Schedule Name[LINK]

This schedule defines when the pool water cover is available and affects the evaporation, convection, and radiation rate calculations. A schedule value of 0.0 means that the pool is not covered. A schedule value of 1.0 means the pool is 100% covered. The pool may be fully covered, fully open (uncovered), or partially covered (a value between 0.0 and 1.0). The user also has the option to control the evaporation, convection, short-wavelength radiation, and long-wavelength radiation factors when the pool is covered. These terms are discussed in the next four fields.

Field: Cover Evaporation Factor[LINK]

This input field can optionally be used to modify the pool evaporation rate and is used in conjunction with the pool cover factor defined by the Pool Cover Schedule field (see above). The value for this parameter can normally range from 0.0 to 1.0, where 1 means that the pool cover completely eliminates evaporation from the pool surface, 0 means the pool cover has no effect on evaporation, and fractions in between 0 and 1 result in a fractional reduction in evaporation by the pool cover. So, if this parameter is 0.5 and the pool is 50% covered, the overall reduction in evaporation from a fully uncovered pool is 25% or 0.25.

Field: Cover Convection Factor[LINK]

This input field can optionally be used to modify the pool convection rate and is used in conjunction with the pool cover factor defined by the Pool Cover Schedule field (see above). The value for this parameter can normally range from 0.0 to 1.0, where 1 means that the pool cover completely eliminates convection from the pool surface, 0 means the pool cover has no effect on convection, and fractions in between 0 and 1 result in a fractional reduction in convection by the pool cover. So, if this parameter is 0.5 and the pool is 50% covered, the overall reduction in convection from a fully uncovered pool is 25% or 0.25.

Field: Cover Short-Wavelength Radiation Factor[LINK]

This input field can optionally be used to modify the pool short-wavelength radiation rate and is used in conjunction with the pool cover factor defined by the Pool Cover Schedule field (see above). The value for this parameter can normally range from 0.0 to 1.0, where 1 means that the pool cover completely eliminates short-wavelength radiation from the pool surface, 0 means the pool cover has no effect on short-wavelength radiation, and fractions in between 0 and 1 result in a fractional reduction in short-wavelength radiation by the pool cover. So, if this parameter is 0.5 and the pool is 50% covered, the overall reduction in short-wavelength radiation from a fully uncovered pool is 25% or 0.25. Note that with radiation terms that whatever portion of the short-wavelength radiation is blocked by the cover is transferred via convection to the surrounding zone air.

Field: Cover Long-Wavelength Radiation Factor[LINK]

This input field can optionally be used to modify the pool long-wavelength radiation rate and is used in conjunction with the pool cover factor defined by the Pool Cover Schedule field (see above). The value for this parameter can normally range from 0.0 to 1.0, where 1 means that the pool cover completely eliminates long-wavelength radiation from the pool surface, 0 means the pool cover has no effect on long-wavelength radiation, and fractions in between 0 and 1 result in a fractional reduction in long-wavelength radiation by the pool cover. So, if this parameter is 0.5 and the pool is 50% covered, the overall reduction in long-wavelength radiation from a fully uncovered pool is 25% or 0.25. Note that with radiation terms that whatever portion of the long-wavelength radiation is blocked by the cover is transferred via convection to the surrounding zone air.

Field: Pool Water Inlet Node[LINK]

This input is the name of the node on the demand side of a plant loop that leads into the pool. From the standpoint of an EnergyPlus input file, the pool is placed on a plant demand loop, and the pump and heater reside on the plant supply loop. The pool heater and pump must be defined by other existing EnergyPlus input.

Field: Pool Water Outlet Node[LINK]

This input is the name of the node on the demand side of a plant loop that leads out of the pool. From the standpoint of an EnergyPlus input file, the pool is placed on a plant demand loop, and the pump and heater reside on the plant supply loop. The pool heater and pump must be defined by other existing EnergyPlus input.

Field: Pool Water Maximum Flow Rate[LINK]

This input is the maximum water volumetric flow rate in m3/s going between the pool and the water heating equipment. This along with the pool setpoint temperature and the heating plant equipment outlet temperature will establish the maximum heat addition to the pool. This flow rate to the pool will be varied in an attempt to reach the desired pool water setpoint temperature (see Setpoint Temperature Schedule below).

Field: Pool Miscellaneous Equipment Power[LINK]

This input defines the power consumption rate of miscellaneous equipment such as the filtering and chlorination technology associated with the pool. The units for this input are in power consumption per flow rate of water through the pool from the heater or W/(m3/s). This field will be multiplied by the flow rate of water through the pool to determine the power consumption of this equipment. Any heat generated by this equipment is assumed to have no effect on the pool water itself.

Field: Setpoint Temperature Schedule[LINK]

Pools attempt to maintain a particular water temperature. In EnergyPlus, this field defines the setpoint temperature for the desired pool water temperature. It is input as a schedule to allow the user to vary the pool setpoint temperature as desired. The equipment defined to provide heating for the pool will deliver the necessary hot water to the pool, up to the capacity of that equipment defined by other input by the user.

Field: Maximum Number of People[LINK]

This field defines the maximum occupancy of people actually in the pool and thus will be used with the next two inputs to determine how much heat people contribute to the pool heat balance. People who are not in the pool should be modeled separately using the standard People description for zones.

Field: People Schedule[LINK]

This field defines a schedule that establishes how many people are in the pool at any given time. The current value of this schedule is multiplied by the maximum number of people in the previous field determines how many people are currently in the pool.

Field: People Heat Gain Schedule[LINK]

This field defines the amount of heat given off by an average person in the pool in Watts. This field is a schedule so that this heat gain can be allowed to vary as the type of activity in a pool can vary greatly and thus the amount of heat gain per person also varies. This parameter times the number of people in the pool determines how much heat is added to the pool. All heat given off by people is added to the heat balance of the pool water.

An example of an indoor swimming pool definition is:

SwimmingPool:Indoor,
  Test Pool,             !- Name
  F1-1,                  !- Surface Name
  1.5,                   !- Average Depth {m}
  PoolActivitySched,     !- Pool Activity Schedule
  MakeUpWaterSched,      !- MakeUp Water Temperature Schedule
  PoolCoverSched,        !- Pool Cover Schedule
  0.0,                   !- Cover Evaporation Factor
  0.2,                   !- Cover Convection Factor
  0.9,                   !- Cover Short-Wavelength Radiation Factor
  0.5,                   !- Cover Long-Wavelength Radiation Factor
  Pool Water Inlet Node,    !- Water Inlet Node (Plant/Heater)
  Pool Water Outlet Node,   !- Water Outlet Node (Plant/Heater)
  0.1,                   !- Maximum flow rate from water heating system {m3/s}
  0.6,                   !- Miscellaneous Equipment Power Factor {W/(m3/s)}
  PoolSetpointTempSched, !- Pool Water Setpoint Temperature Schedule
  15,                    !- Maximum Number of People in Pool
  PoolOccupancySched,    !- Pool People Schedule
  PoolOccHeatGainSched;  !- Pool People Heat Gain Schedule

Outputs[LINK]

  • HVAC, Average, Indoor Pool Makeup Water Rate [m3/s]

  • HVAC, Sum, Indoor Pool Makeup Water Volume [m3]

  • HVAC, Average, Indoor Pool Makeup Water Temperature [C]

  • HVAC, Average, Indoor Pool Water Temperature [C]

  • HVAC, Average, Indoor Pool Inlet Water Temperature [C]

  • HVAC, Average, Indoor Pool Inlet Water Mass Flow Rate [kg/s]

  • HVAC, Average, Indoor Pool Miscellaneous Equipment Power [W]

  • HVAC, Sum, Indoor Pool Miscellaneous Equipment Energy [J]

  • HVAC, Average, Indoor Pool Water Heating Rate [W]

  • HVAC, Sum, Indoor Pool Water Heating Energy [J]

  • HVAC, Average, Indoor Pool Radiant to Convection by Cover [W]

  • HVAC, Average, Indoor Pool People Heat Gain [W]

  • HVAC, Average, Indoor Pool Current Activity Factor []

  • HVAC, Average, Indoor Pool Current Cover Factor []

  • HVAC, Average, Indoor Pool Evaporative Heat Loss Rate [W]

  • HVAC, Sum, Indoor Pool Evaporative Heat Loss Energy [J]

  • HVAC, Average, Indoor Pool Saturation Pressure at Pool Temperature [Pa]

  • HVAC, Average, Indoor Pool Partial Pressure of Water Vapor in Air [Pa]

  • HVAC, Average, Indoor Pool Current Cover Evaporation Factor []

  • HVAC, Average, Indoor Pool Current Cover Convective Factor []

  • HVAC, Average, Indoor Pool Current Cover SW Radiation Factor []

  • HVAC, Average, Indoor Pool Current Cover LW Radiation Factor []

Indoor Pool Makeup Water Rate [m3/s][LINK]

The water consumption rate for the makeup water of indoor swimming pool.

Indoor Pool Makeup Water Volume [m3][LINK]

The water consumption for the makeup water of indoor swimming pool.

Indoor Pool Makeup Water Temperature [C][LINK]

The temperature of the makeup water of indoor swimming pool.

Indoor Pool Water Temperature [C][LINK]

The average calculated pool water temperature during the simulation at the time frequency requested.

Indoor Pool Inlet Water Temperature [C][LINK]

The temperature of the water being sent to the pool from the plant heating equipment.

Indoor Pool Inlet Water Mass Flow Rate [kg/s][LINK]

The mass flow rate of water being sent to the pool from the plant heating equipment. Typically this water is being passed through a heater and miscellaneous equipment.

Indoor Pool Miscellaneous Equipment Power [W][LINK]

The miscellaneous equipment power includes the power consumption of pool filter and chlorinator in Watts.

Indoor Pool Miscellaneous Equipment Energy [J][LINK]

The miscellaneous equipment power consumption includes the energy consumption of pool filter and chlorinator in Joules.

Indoor Pool Water Heating Rate [W][LINK]

This is the rate of heating provided by the plant loop to the pool in Watts.

Indoor Pool Water Heating Energy [J][LINK]

This is the amount of heating provided by the plant loop to the pool in Joules over the time step requested.

Indoor Pool Radiant to Convection by Cover [W][LINK]

The pool cover may block some or all of short- and long-wavelength radiation incident on the pool. To account for this and to not have the cover result in energy that is not accounted for by the model, the radiation that is blocked by the cover is converted to a convective gain (or loss) to/from the zone air. This output field reports this value.

Indoor Pool Current Activity Factor [][LINK]

This is the current activity factor as defined by the user input schedule.

Indoor Pool Current Cover Factor [][LINK]

This is the current cover factor as defined by the user input schedule.

Indoor Pool Evaporative Heat Loss Rate [W][LINK]

This is the rate of evaporative heat loss (latent) to the zone from the pool in Watts.

Indoor Pool Evaporative Heat Loss Energy [J][LINK]

This is the amount of evaporative heat loss (latent) to the zone from the pool in in Joules over the time step requested.

Indoor Pool Saturation Pressure at Pool Temperature [Pa][LINK]

This is the saturation pressure of water vapor in air at the pool water temperature.

Indoor Pool Partial Pressure of Water Vapor in Air [Pa][LINK]

This is the partial pressure of water vapor in air at the current zone air conditions for dry bulb temperature and humidity ratio.

Indoor Pool Current Cover Evaporation Factor [][LINK]

This is the current value of the cover evaporation factor that is used as a modifier for the actual evaporation. A value of zero means no evaporation will take place while a value of unity means the maximum allowed evaporation will take place. This value is based on the current cover condition as well as the user input for the cover evaporation factor.

Indoor Pool Current Cover Convective Factor [][LINK]

This is the current value of the cover convective factor that is used as a modifier for the actual convection. A value of zero means the cover will block all convection while a value of unity means that the cover will not affect convection from the water surface at all. This value is based on the current cover condition as well as the user input for the cover convective factor.

Indoor Pool Current Cover SW Radiation Factor [][LINK]

This is the current value of the cover short wavelength radiation factor that is used as a modifier for the actual short wavelength radiation. A value of zero means the cover will block all short wavelength radiation while a value of unity means that the cover will not affect short wavelength radiation from the water surface at all. This value is based on the current cover condition as well as the user input for the cover short wavelength radiation factor.

Indoor Pool Current Cover LW Radiation Factor [][LINK]

This is the current value of the cover long wavelength radiation factor that is used as a modifier for the actual long wavelength radiation. A value of zero means the cover will block all long wavelength radiation while a value of unity means that the cover will not affect long wavelength radiation from the water surface at all. This value is based on the current cover condition as well as the user input for the cover long wavelength radiation factor.

ZoneContaminantSourceAndSink:CarbonDioxide[LINK]

The ZoneContaminantSourceAndSink:CarbonDioxide object allows users to input carbon dioxide sources or sinks in a zone. Note that carbon dioxide generation within a zone can also be specified using People and GasEquipment objects. Multiple ZoneContaminantSourceAndSink:CarbonDioxide objects can be specified for the same zone.

Inputs[LINK]

Field: Name[LINK]

The name of the ZoneContaminantSourceAndSink:CarbonDioxide object. The name for each ZoneContaminantSourceAndSink:CarbonDioxide object must be unique.

Field: Zone Name[LINK]

This field is the name of the zone (ref: Zone) and links a particular ZoneContaminantSourceAndSink:CarbonDioxide object to a thermal zone in the building.

Field: Design Generation Rate[LINK]

This field denotes the design carbon dioxide generation rate (m3/s). The design value is modified by the schedule fraction (see Field: Schedule Name). The resulting volumetric generation rate is converted to mass generation rate using the current zone indoor air density at each time step. The rate can be either positive or negative. A positive value represents a source rate (CO2 addition to the zone air) and a negative value represents a sink rate (CO2 removal from the zone air).

When the mass design generation rate is available, a conversion is required to meet input requirement with volumetric flow rate. This can be accomplished by the mass flow rate divided by the density of carbon dioxide.

Field: Schedule Name[LINK]

This field is the name of the schedule (ref: Schedules) that modifies the design carbon dioxide generation rate (see previous field). The schedule values can be any positive number between 0.0 and 1.0. For each simulation time step, the actual CO2 generation rate in a zone is the product of the Design Generation Rate field (above) and the value specified by this schedule.

An IDF example is provided below:

ZoneContaminantSourceAndSink:CarbonDioxide,
  NORTH_ZONE CO2,       !- Name
  NORTH_ZONE,           !- Zone Name
  1.e-6,                !- Design Generation Rate {m3/s}
  CO2 Source Schedule;  !- Schedule Name

Outputs[LINK]

HVAC,Average, Contaminant Source or Sink CO2 Gain Volume Flow Rate [m3/s]
HVAC,Average, Zone Contaminant Source or Sink CO2 Gain Volume Flow Rate [m3/s]

Contaminant Source or Sink CO2 Gain Volume Flow Rate [m3/s][LINK]

This output is the net carbon dioxide internal gain/loss in for an individual ZoneContaminantSourceAndSink:CarbonDioxide object.

Zone Contaminant Source or Sink CO2 Gain Volume Flow Rate [m3/s][LINK]

This output is the net carbon dioxide internal gain/loss in for all ZoneContaminantSourceAndSink:CarbonDioxide objects in a zone.

ZoneContaminantSourceAndSink:Generic:Constant[LINK]

The ZoneContaminantSourceAndSink:Generic:Constant object specifies the generic contaminant generation rate and removal rate coefficient in a zone. The associated fraction schedules are required for allowing users to change the magnitude of sources and sinks. The object is equivalent to the combination of the constant coefficient model and the burst source model defined in the sources and sinks element types of CONTAM 3.0. The basic equation used to calculate generic contaminant source and sink for the constant model is given below:

where

Sf = Contaminant generic contaminant source strength [m3/s]

Gf = Generic contaminant generation rate [m3/s]

FG = Fraction value from the source fraction schedule at a given time [dimensionless]

= Generic contaminant effective removal rate [m3/s]

FR = Fraction value from the sink fraction schedule at a given time [dimensionless]

Cf = Generic contaminant concentration value at a given previous time step [ppm]

Inputs[LINK]

Field: Name[LINK]

This field represents a unique identifying name.

Field: Zone Name[LINK]

This field signifies the Name of the zone with constant generic contaminant source and sink.

Field: Design Generation Rate[LINK]

This field denotes the full generic contaminant design generation rate (m3/s). The design generation rate is the maximum amount of generic contaminant expected at design conditions. The design value is modified by the schedule fraction (see Field:Generation Schedule Name).

When the mass generation rate is available, the rate must be converted to a volume flow rate. Use the mass flow rate divided by the vapor density of the generic contaminant.

Field: Generation Schedule Name[LINK]

This field is the name of the schedule (ref: Schedule) that modifies the maximum design generation rate (Gf). This fraction between 0.0 and 1.0 is noted as FG in the above equation.

Field: Design Removal Coefficient[LINK]

This field denotes the full generic contaminant design removal coefficient (m3/s). The design removal rate is the maximum amount of generic contaminant expected at design conditions times the generic contaminant concentration in the same zone. The design value is modified by the schedule fraction (see Field:Removal Schedule Name).

Field: Removal Schedule Name[LINK]

This field is the name of the schedule (ref: Schedule) that modifies the maximum design generation rate (Rf). This fraction between 0.0 and 1.0 is noted as FR in the above equation.

An IDF example is provided below:

ZoneContaminantSourceAndSink:Generic:Constant,
  NORTH ZONE GC,        !- Name
  NORTH ZONE,           !- Zone Name
  1.0E-6,               !- Design Generation Rate {m3/s}
  GC Source Schedule,   !- Generation Schedule Name
  1.0E-7,               !- Design Removal Coefficient {m3/s}
  GC Removal Schedule;  !- Removal Schedule Name

Outputs[LINK]

When a ZoneContaminantSourceAndSink:Generic:Constant object is specified, the following output variables are available:

ZONE,Average, Generic Air Contaminant Constant Source Generation Volume Flow Rate [m3/s]

Generic Air Contaminant Constant Source Generation Volume Flow Rate [m3/s][LINK]

This output is the average generic contaminant generation rate from each ZoneContaminantSourceAndSink:Generic:Constant object. The generation rate is a sum of generation and removal rates. The zone air generic contaminant level at the previous zone time step is used in the removal rate calculation.

SurfaceContaminantSourceAndSink:Generic:PressureDriven[LINK]

The SurfaceContaminantSourceAndSink:Generic:PressureDriven object specifies the generic contaminant generation rate coefficient, which is used to calculate the generation rate due to the pressure difference across the surface. The object is equivalent to the pressure driven model defined in the sources and sinks element types of CONTAM 3.0. This object assumes to work with the AirflowNetwork model. The surface has to be defined in the AirflowNetwork:Multizone:Surface. Although the model is designed to be applied to radon and soil gas entry, it is expanded to be applied to all contaminant transport, including generic contaminant. However, it should be used in caution. The basic equation used to calculate generic contaminant source for the pressure driven constant model is provided below:

where

Sf = Generic contaminant source strength [m3/s]

= Generic contaminant generation rate coefficient [m3/s]

FG = Fraction value from the source fraction schedule at a given time [dimensionless]

= Flow power exponent

= Zone pressure [Pa]

= Pressure in an adjacent zone for a interior surface or outdoor for an exterior surface [Pa]

Inputs[LINK]

Field: Name[LINK]

The field signifies the unique identifying name.

Field: Surface Name[LINK]

This field represents the name of the surface as a generic contaminant source using the pressure driven model.

Field: Design Generation Rate Coefficient[LINK]

This field denotes the generic contaminant design generation coefficient (m3/s). The design generation rate is the maximum amount of generic contaminant expected at design conditions times the pressure difference with a power exponent across a surface. The design value is modified by the schedule fraction (see Field:Generation Schedule Name).

Field: Generation Exponent[LINK]

This field denotes the flow power exponent, n, in the contaminant source equation. The valid range is 0.0 to 1.0,

An IDF example is provided below:

SurfaceContaminantSourceAndSink:Generic:PressureDriven,
  WEST ZONE GC BLD,     !- Name
  Zn001:Wall001,        !- Surface Name
  1.0E-6,               !- Design Generation Rate Coefficient {m3/s}
  GC Source Schedule,   !- Generation Schedule Name
  0.5;                  !- Generation Exponent

Outputs[LINK]

When a SurfaceContaminantSourceAndSink:Generic:PressureDriven object is specified, the following output variables are available:

  • ZONE,Average,Generic Air Contaminant Pressure Driven Generation Volume Flow Rate [m3/s]

Generic Air Contaminant Pressure Driven Generation Volume Flow Rate [m3/s][LINK]

This output is the average generic contaminant generation rate from each SurfaceContaminantSourceAndSink:Generic:PressureDriven object.

ZoneContaminantSourceAndSink:Generic:CutoffModel[LINK]

The ZoneContaminantSourceAndSink:Generic contaminant:CutoffModel object specifies the generic contaminant generation rate based on the cutoff concentration model. The basic equation used to calculate generic contaminant source for the pressure driven constant model is given below:

Sf(t)=Gf(t)FG(1Cf(t)Ccutoff)Cf<Ccutoff0CfCcutoff

where

Sf = Generic contaminant source strength [m3/s]

Gf = Generic contaminant generation rate [m3/s]

FG = Fraction value from the source fraction schedule at a given time [dimensionless]

Ccutoff = Cutoff concentration at which emission ceases [ppm]

Cf = Generic contaminant concentration value at a given previous time step [ppm]

Inputs[LINK]

Field: Name[LINK]

The field signifies the unique identifying name.

Field: Zone Name[LINK]

This field represents the name of the zone with generic contaminant source and sink using the cutoff model.

Field: Design Generation Rate Coefficient[LINK]

This field denotes the full generic contaminant design generation rate (m3/s). The design generation rate is the maximum amount of generic contaminant expected at design conditions. The design value is modified by the schedule fraction (see Field:Generation Schedule Name).

When the mass generation rate is available, the rate must be converted to a volume flow rate. Use the mass flow rate divided by the vapor density of the generic contaminant.

Field: Generation Schedule Name[LINK]

This field is the name of the schedule (ref: Schedule) that modifies the maximum design generation rate (Gf). This fraction between 0.0 and 1.0 is noted as FG in the above equation.

Field: Cutoff Generic Contaminant at which Emission Ceases[LINK]

This field is the generic contaminant cutoff concentration level where the source ceases its emission.

An IDF example is provided below:

ZoneContaminantSourceAndSink:Generic:CutoffModel,
  NORTH ZONE GC CutoffModel,            !- Name
  NORTH ZONE,                           !- Zone Name
  1.0E-5,                               !- Design Generation Rate Coefficient {m3/s}
  GC Source Schedule,                   !- Schedule Name
  100000;                               !- Cutoff Generic Contaminant at which Emission Ceases {ppm}

Outputs[LINK]

When a ZoneContaminantSourceAndSink:Generic:CutoffModel object is specified, the following output variables are available:

ZONE,Average, Generic Air Contaminant Cutoff Model Generation Volume Flow Rate [m3/s]

Generic Air Contaminant Cutoff Model Generation Volume Flow Rate [m3/s][LINK]

This output is the average generic contaminant generation rate from each SurfaceContaminantSourceAndSink:Generic:CutoffModel object.

ZoneContaminantSourceAndSink:Generic:DecaySource[LINK]

The ZoneContaminantSourceAndSink:Generic:DecaySource object specifies the generic contaminant generation rate based on the decay source model. The basic equation used to calculate generic contaminant source for the decay source model is given below:

Sf(t)=Gf(t)FGexp(t/tc)

where

Sf = Generic contaminant source strength [m3/s]

Gf = Initial generic contaminant generation rate [m3/s]

FG = Fraction value from the source fraction schedule at a given time [dimensionless]

t = Time since the start of emission [second]

tc = Decay time constant [second]

Inputs[LINK]

Field: Name[LINK]

This field is the unique identifying name.

Field: Zone Name[LINK]

This field represents the name of the zone with a generic contaminant decaying source.

Field: Initial Emission Rate[LINK]

This field denotes the initial generic contaminant design emission rate (m3/s). The generation is controlled by a schedule, as defined in the next field. Generic contaminant emission begins when the schedule changes from a zero to a non-zero value (between zero and one). The initial emission rate is equal to the schedule value times the initial generation rate. A single schedule may be used to initiate several emissions at different times.(see Field:Generation Schedule Name).

Field: Schedule Name[LINK]

This field is the name of the schedule (ref: Schedule) that modifies the maximum design emission rate (Gf). This fraction between 0.0 and 1.0 is noted as FG in the above equation. When the value is equal to 1, the generation rate is used and time is reset to zero. When the value is equal to zero, the schedule value is ignored in the equation.

Field: Decay Time Constant[LINK]

This field is the time at which the generation rate reaches 0.37 of the original rate.

Note: The variable t, time since the start of emission, will be reset to zero, when a new run period starts, or the generation schedule value is equal to zero.

An IDF example is provided below:

ZoneContaminantSourceAndSink:Generic:DecaySource,
  WEST ZONE GC DecaySource, !- Name
  WEST ZONE,              !- Zone Name
  1.0E-5,                 !- Initial Emission Rate {m3/s}
  GC Source Schedule,     !- Schedule Name
  100000;                 !- Delay Time Constant {s}

Outputs[LINK]

When a ZoneContaminantSourceAndSink:Generic:DecaySource object is specified, the following output variables are available:

  • Zone,Average,Generic Air Contaminant Decay Model Generation Volume Flow Rate [m3/s]

  • Zone,Average,Generic Air Contaminant Decay Model Generation Emission Start Elapsed Time [s]

Generic Air Contaminant Decay Model Generation Volume Flow Rate [m3/s][LINK]

This output is the average generic contaminant decay rate from each SurfaceContaminantSourceAndSink:Generic:DecaySource object.

Generic Air Contaminant Decay Model Generation Emission Start Elapsed Time [s][LINK]

This output is the decay time since the start of emission. The start time is either at the beginning of each run period, including design day simulations, or the time when the generation schedule value is zero.

SurfaceContaminantSourceAndSink:Generic:BoundaryLayerDiffusion[LINK]

The SurfaceContaminantSourceAndSink:Generic:BoundaryLayerDiffusion object specifies the generic contaminant generation rate from surface diffusion. The object is equivalent to the boundary layer diffusion model driven model defined in the sources and sinks element types of CONTAM 3.0.

The boundary layer diffusion controlled reversible sink/source model with a linear sorption isotherm follows the descriptions presented in [Axley 1991]. The boundary layer refers to the region above the surface of a material through which a concentration gradient exists between the near-surface concentration and the air-phase concentration. The rate at which a contaminant is transferred onto a surface (sink) is defined as:

where

h = Average film mass transfer coefficient over the sink [m/s]

ρ = Film density of air [kg/m3]

A = Surface area of the adsorbent [m2]

Cf = Concentration in the air at the previous time step [ppm]

Cs = Concentration in the adsorbent [ppm]

k = Henry adsorption constant or partition coefficient [dimensionless]

Inputs[LINK]

Field: Name[LINK]

This field signifies a unique identifying name.

Field: Surface Name[LINK]

This field denotes the name of the surface as a generic contaminant reversible source or sink using the boundary layer diffusion model.

Field: Mass Transfer Coefficient[LINK]

This field specifies the average mass transfer coefficient of the contaminant generic contaminant within the boundary layer (or film) above the surface of the adsorbent.

Field: Schedule Name[LINK]

This field is the name of the schedule (ref: Schedule) that modifies the mass transfer coefficient with the value between 0.0 and 1.0.

Field: Henry Adsorption Constant or Partition Coefficient[LINK]

This field denotes the generic contaminant Henry partition coefficient in the units of dimensionless. The coefficient relates the concentration of the contaminant generic contaminant in the bulk-air to that at the surface of the adsorption material.

An IDF example is provided below:

SurfaceContaminantSourceAndSink:Generic:BoundaryLayerDiffusion,
  WEST ZONE GC BLD,     !- Name
  Zn001:Wall001,        !- Surface Name
  1.0E-2,               !- Mass Transfer Coefficient {m/s}
  GC Source Schedule,   !- Schedule Name
  2.0;                  !- Henry adsorption constant or partition coefficient

Outputs[LINK]

When a SurfaceContaminantSourceAndSink:Generic:BoundaryLayerDiffusion object is specified, the following output variables are available:

  • ZONE,Average, Generic Air Contaminant Boundary Layer Diffusion Generation Volume Flow Rate [m3/s]

  • ZONE,Average, Generic Air Contaminant Boundary Layer Diffusion Inside Face Concentration [ppm]

Generic Air Contaminant Boundary Layer Diffusion Generation Volume Flow Rate [m3/s][LINK]

This output is the average generic contaminant generation rate from each SurfaceContaminantSourceAndSink:Generic:BoundaryLayerDiffusion object.

Generic Air Contaminant Boundary Layer Diffusion Inside Face Concentration [ppm][LINK]

This output is the average generic contaminant level at the interior surface.

SurfaceContaminantSourceAndSink:Generic:DepositionVelocitySink[LINK]

The SurfaceContaminantSourceAndSink:Generic:DepositionVelocitySink object specifies the generic contaminant removal rate from a surface. The object is equivalent to the deposition velocity sink model defined in CONTAM 3.0 sources and sinks element types.

The deposition velocity model provides for the input of a sink’s characteristic in the familiar term of deposition velocity. The removal stops when the sink concentration level is higher than the zone air concentration level. The deposition velocity model equation is:

where

Sf(t) = Removal rate at time t [m3/s]

νd = Deposition velocity [m/s]

As = Deposition surface area [m2]

m = Element multiplier [dimensionless]

Cf(t) = Concentration of contaminant generic contaminant at the previous time step [ppm]

FR = Schedule or control signal value at time t [-]

Inputs[LINK]

Field: Name[LINK]

This field denotes a unique identifying name.

Field: Surface Name[LINK]

This field represents the name of the surface as a generic contaminant sink using the deposition velocity sink model.

Field: Deposition Velocity[LINK]

This field specifies the deposition velocity to the surface of the adsorbent in the units of m/s.

Field: Schedule Name[LINK]

This field is the name of the schedule (ref: Schedule) that modifies the maximum design removal rate (Sf). This fraction between 0.0 and 1.0 is noted as FR in the above equation.

An IDF example is provided below:

SurfaceContaminantSourceAndSink:Generic:DepositionVelocitySink,
  EAST ZONE GC DVS,     !- Name
  Zn002:Wall001,        !- Surface Name
  1.0E-3,               !- Deposition Velocity {m/s}
  GC Source Schedule;   !- Schedule Name

Outputs[LINK]

The following output variables are available when the SurfaceContaminantSourceAndSink:Generic:DepositionVelocitySink object is specified.

  • ZONE,Average, Generic Air Contaminant Deposition Velocity Removal Volume Flow Rate [m3/s]

Generic Air Contaminant Deposition Velocity Removal Volume Flow Rate [m3/s][LINK]

This output is the average generic contaminant generation rate from each SurfaceContaminantSourceAndSink:Generic:DepositionVelocitySink object.

ZoneContaminantSourceAndSink:Generic:DepositionRateSink[LINK]

The ZoneContaminantSourceAndSink:Generic:DepositionRateSink object specifies the generic contaminant removal rate from a zone. The object is equivalent to the deposition rate sink model defined in CONTAM 3.0 sources and sinks element types.

The deposition rate model provides for the input of a sink’s characteristic in the familiar term of deposition rate in a zone. The removal stops when the sink concentration level is higher than the zone air concentration level. The deposition rate model equation is:

Where

Sf(t) = Removal rate at time t [m3/s]

kd = Deposition rate [1/T]

Vz = Zone volume [m3]

m = Element multiplier [dimensionless]

Cf(t) = Concentration of generic contaminant at the previous time step [ppm]

FR = Schedule or control signal value at time t [dimensionless]

Inputs[LINK]

Field: Name[LINK]

This field denotes a unique identifying name.

Field: Zone Name[LINK]

This field represents the name of the zone as a generic contaminant sink using the deposition rate sink model.

Field: Deposition Rate[LINK]

This field specifies the deposition rate to the zone in the units of 1/s.

Field: Schedule Name[LINK]

This field is the name of the schedule (ref: Schedule) that modifies the maximum design removal rate (Sf). This fraction between 0.0 and 1.0 is noted as FR in the above equation.

An IDF example is provided below:

ZoneContaminantSourceAndSink:Generic:DepositionRateSink,
  NORTH ZONE GC DRS,  !- Name
  NORTH ZONE,         !- Zone Name
  1.0E-5,             !- Deposition Rate {m3/s}
  GC Source Schedule; !- Schedule Name

Outputs[LINK]

When the ZoneContaminantSourceAndSink:Generic:DepositionRateSink object is specified, the following output variables are available:

  • ZONE,Average, Generic Air Contaminant Deposition Rate Removal Volume Flow Rate [m3/s]

Generic Air Contaminant Deposition Rate Removal Volume Flow Rate [m3/s][LINK]

This output is the average generic contaminant generation rate from each ZoneContaminantSourceAndSink:Generic:DepositionRateSink object.


  1. Sources: [1]. ASHRAE, 2021. “Thermal Guidelines for Data Processing Environments (5 Edition),” Peachtree Corners: ASHRAE; [2]. Quirk, Davidson, and Schmidt, 2022. “ASHRAE’s Data Center Thermal Guidelines—Air-Cooled Evolution,” ASHRAE Journal, May 2022.