Input Output Reference — EnergyPlus 8.6

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

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, and Kansas State University Two-Node 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 Name[LINK]

This field is the name of the zone (ref: Zone) or ZoneList (ref: ZoneList) and links a particular people statement to a thermal zone or set of thermal zones in the building. When the ZoneList option is used then this people definition is applied to each of the zones in the zone list effecting a global definition for the number of people in the zone. The Zonelist option can be used effectively with the people/area and area/person options of the Number of People Calculation Method.

The name of the actual people object becomes <Zone Name> <People Object Name> and should be less than the standard length (100 characters) for a name field. If it is greater than this standard length, it may be difficult to specify in output reporting as it will be truncated. A warning will be shown if the generated name is greater than 100 characters. If it duplicates another such concatenated name, there will be a severe error and terminate the run.

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:

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. (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 Zone Floor Area[LINK]

This factor (person/m2) is used, along with the Zone 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: Zone Floor Area per Person[LINK]

This factor (m2/person) is used, along with the Zone 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.

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 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) is based on Table 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: 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 w/ Person EnergyPlus Schedule Value 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 two options for MRT calculation type: zone averaged and surface weighted. The default calculation is “ZoneAveraged”. In the zone 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 zone. 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 zone 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 zone. 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 AngleFactorList 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” for the MRT calculation type (see the previous input field description). In this case, the field is the name of a surface within the zone 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 “surface weighted” 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).

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

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 fo the dynamic predictive clothing insulation model

Graphical representation fo the dynamic predictive clothing insulation model

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, page 9.9 (for garment values) ) or www.cbe.berkeley.edu/comforttool/.

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.

Field: Thermal Comfort Model Type (up to 5 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,, and AdaptiveCEN15251, the user can request the Fanger, Pierce Two-Node, Kansas State UniversityTwo-Node, and the adaptive comfort models of the ASHRAE Standard 55 and CEN Standard 15251 results for this particular people statement. AdaptiveASH55 is only applicable when the running average outdoor air temperature for the past 7 days is between 10.0 and 33.5C. AdaptiveCEN15251 is only applicable when the running average outdoor air temperature for the past 30 days is between 10.0 and 30.0C. Note that since up to five models may be specified, the user may opt to have EnergyPlus calculate the thermal comfort for people identified with this people statement using all five models if desired. Note that the KSU model is computationally intensive and may noticeably increase the execution time of the simulation. For descriptions of the thermal comfort calculations, see the Engineering Reference document.

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 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
  ZoneAveraged,         !- Mean Radiant Temperature Calculation Type
  ,                     !- Surface Name/Angle Factor List Name
  WORK_EFF_SCH,         !- Work Efficiency 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 Name
  OCCUPY-1,             !- Number of People Schedule Name
  People/Area,          !- Number of People Calculation Method
  ,                     !- Number of People
  .11,                  !- People per Zone Floor Area {person/m2}
  ,                     !- Zone Floor Area per Person {m2/person}
  0.3,                  !- Fraction Radiant
  ,                     !- Sensible Heat Fraction
  ActSchd;              !- Activity Level Schedule Name

Outputs[LINK]

People objects have output variables for individual objects and for 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,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,People Air Temperature [C]

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

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

  • 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 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]

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

Zone People Occupant Count [] [LINK]

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

Zone People Radiant Heating Rate [W] [LINK]

Zone People Radiant Heating Energy [J] [LINK]

These output variables are the amount of radiant heat gain from people within the zone 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.

Zone People Convective Heating Rate [W] [LINK]

Zone People Convective Heating Energy [J] [LINK]

These output variables are the amount of convective heat gain from people within the zone 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.

Zone People Latent Gain Rate [W] [LINK]

Zone People Latent Gain Energy [J] [LINK]

These output variables are the amount of latent heat gain from people within the 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.

Zone People Sensible Heating Rate [W] [LINK]

Zone People Sensible Heating Energy [J] [LINK]

These output variables are the amount of sensible heat gain from people within the 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.

Zone People Total Heating Rate [W] [LINK]

Zone People Total Heating Energy [J] [LINK]

These output variables are the total amount of heat gain from people within the 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.

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

This field is the “predicted percentage of dissatisfied” (PPD) calculated using the Fanger thermal comfort model.

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 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.5 degrees C from the adaptive comfort temperature. The 90% acceptability limits are defined as no greater than 2.5 degrees C 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).

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

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

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.0 (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 “zoneaveraged” which results in a mean radiant temperature that is characteristic of an “average” location near the center of the zone. 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 zone 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 zone. 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 AngleFactorList input line is intended to give the user this opportunity.

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: Zone Name[LINK]

Zone Name for this surface list. Each of the surfaces listed must be in this zone.

Field: Surface <#> Name[LINK]

This field is the name of a surface in the zone seen by the person.

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. Note that the Surface Name/Angle Factor pair can be repeated up to 20 times. The sum of all angle factors within any angle factor list must equal unity, otherwise the program will not accept the input as valid.

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

ComfortViewFactorAngles,
  South Zone Angle Factors, !- name of angle factor list
  South Zone,           !- Zone Name
  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 Name[LINK]

The field is the name of the thermal zone (ref: Zone) or ZoneList (ref: ZoneLIst) and links this Lights statement to a thermal zone or set of thermal zones in the buidling. When the ZoneList option is used then this lights definition is applied to each of the zones in the zone list effecting a global definition for the amount of light wattage in the zone. The Zonelist option can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method.

The name of the actual lights object becomes <Zone Name> <Lights Object Name> and should be less than the standard length (100 characters) for a name field. If it is greater than this standard length, it may be difficult to specify in output reporting as it will be truncated. A warning will be shown if the generated name is greater than 100 characters. If it duplicates another such concatenated name, there will be a severe error and terminate the run.

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/choices 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. (The Watts per Zone 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 Zone Floor Area[LINK]

This factor (watts/m2) is used, along with the Zone 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:

fconvected = 1.0 – (Return Air Fraction + Fraction Radiant + Fraction Visible)

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 and Figure 51). (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 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 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 daylighting controls.

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. The following special tags will also place the end-use in specific rows in the LEED Summary table EAp2-4/5. Performance Rating Method Compliance: Fans-Parking Garage, Interior Lighting-Process, Cooking, Industrial Process, Elevators and Escalators.

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.

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.

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/OC.

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.

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.

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}
  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 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]

If daylighting controls are operating in the zone, all of the 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.

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

  • Zone,Average,Lights Electric Power [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 Electric Energy [J]

  • Zone,Average,Zone Lights Electric Power [W]

  • 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 Electric Energy [J]

Lights Electric Power [W] [LINK]

The electric power input for the lights.

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 Electric Energy [J] [LINK]

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

Zone Lights Electric Power [W] [LINK]

The electric power input for all lights in the zone.

Zone Lights Radiant Heating Rate [W] [LINK]

Zone Lights Radiant Heating Energy [J] [LINK]

The amount of heat gain from all lights in the zone 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.

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

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

The amount of heat gain from all lights in the zone 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.

Zone Lights Convective Heating Rate [W] [LINK]

Zone Lights Convective Heating Energy [J] [LINK]

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

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

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

The amount of heat gain from all lights in the zone 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.

Zone Lights Total Heating Rate [W] [LINK]

Zone Lights Total Heating Energy [J] [LINK]

The total heat gain from all lights in the 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.

Zone Lights Electric Energy [J] [LINK]

The lighting electrical consumption for all lights in the zone including ballasts, if present. This will have the same value as Zone Lights Total Heating Energy (above). However, this amount is also shown in the Electricity meters that are associated with the zone:

Electricity:Facility,

Electricity:Building,

Electricity:Zone:<Zone Name>.

In addition, depending on use, it will be shown in:

InteriorLights: Electricity and

InteriorLights:Electricity:Zone :<Zone Name>.

Outputs[LINK]

As described in the Lights Outputs, values for lights will show up on the following meters:

Distribution of Lights to Meters
Meter Name Scope Lights Specifics
Electricity:Facility Entire Facility All
Electricity:Building All Zones All
Electricity:Zone: <Zone Name> Specific Zone All
InteriorLights:Electricity All Zones Lights Use
InteriorLights:Electricity:Zone: <Zone Name> Specific Zone Lights Use
<End-Use Subcategory> :InteriorLights:Electricity Specific Subcategory Lights Use

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 Name[LINK]

This field is the name of the zone (ref: Zone) or ZoneList (ref: ZoneList) and attaches a particular electric equipment statement to a thermal zone or set of thermal zones in the building. When the ZoneList option is used then this electric equipment definition is applied to each of the zones in the zone list effecting a global definition for the amount of electric wattage in the zone. The Zonelist option can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method.

The name of the actual electric equipment object becomes <Zone Name> <ElectricEquipment Object Name> and should be less than the standard length (100 characters) for a name field. If it is greater than this standard length, it may be difficult to specify in output reporting as it will be truncated. A warning will be shown if the generated name is greater than 100 characters. If it duplicates another such concatenated name, there will be a severe error and terminate the run.

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. 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. (The Watts per Zone 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 Zone Floor Area[LINK]

This factor (watts/m2) is used, along with the Zone 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. The following special tags will also place the end-use in specific rows in the LEED Summary table EAp2-4/5. Performance Rating Method Compliance: Fans-Parking Garage, Interior Lighting-Process, Cooking, Industrial Process, Elevators and Escalators.

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 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 Name[LINK]

This field is the name of the thermal zone (ref: Zone) or ZoneList (ref: ZoneList) and attaches a particular gas equipment statement to a thermal zone or set of thermal zones in the building. When the ZoneList option is used then this gas equipment definition is applied to each of the zones in the zone list effecting a global definition for the amount of gas in the zone. The Zonelist option can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method.

The name of the actual gas equipment object becomes <Zone Name> <GasEquipment Object Name> and should be less than the standard length (100 characters) for a name field. If it is greater than this standard length, it may be difficult to specify in output reporting as it will be truncated. A warning will be shown if the generated name is greater than 100 characters. If it duplicates another such concatenated name, there will be a severe error and terminate the run.

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. (The Power per Zone 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 Zone Floor Area[LINK]

This factor (watts/m2) is used, along with the Zone 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.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. The following special tags will also place the end-use in specific rows in the LEED Summary table EAp2-4/5. Performance Rating Method Compliance: Fans-Parking Garage, Interior Lighting-Process, Cooking, Industrial Process, Elevators and Escalators.

An IDF example:

GasEquipment,
  DORM ROOMS AND COMMON AREAS GasEq 1,  !- Name
  DORM ROOMS AND COMMON AREAS,          !- Zone Name
  Gas Eq Sch,                           !-Schedule Name
  EquipmentLevel,                       !- Design Level Calculation Method
  29287.51,                             !- Design Level {W}
  ,                                     !- Power per Zone 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 Name
  Gas Eq Sch,                           !- Schedule Name
  Watts/Area,                           !- Design Level Calculation Method
  ,                                     !- Design Level {W}
  197,                                  !- Power per Zone 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 Name[LINK]

This field is the name of the thermal zone (ref: Zone) or ZoneList (ref: ZoneList) and attaches a particular hot water equipment statement to a thermal zone or set of thermal zones in the building. When the ZoneList option is used then this hot water equipment definition is applied to each of the zones in the zone list effecting a global definition for the amount of hot water in the zone. The Zonelist option can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method.

The name of the actual hot water equipment object becomes <Zone Name> <HotWaterEquipment Object Name> and should be less than the standard length (100 characters) for a name field. If it is greater than this standard length, it may be difficult to specify in output reporting as it will be truncated. A warning will be shown if the generated name is greater than 100 characters. If it duplicates another such concatenated name, there will be a severe error and terminate the run.

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. (The Power per Zone 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 Zone Floor Area[LINK]

This factor (watts/m2) is used, along with the Zone 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 obejct). 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. The following special tags will also place the end-use in specific rows in the LEED Summary table EAp2-4/5. Performance Rating Method Compliance: Fans-Parking Garage, Interior Lighting-Process, Cooking, Industrial Process, Elevators and Escalators.

IDF Examples:

HotWaterEquipment,
  SPACE2-1 HWEq 1,    !- Name
  SPACE2-1,           !- Zone Name
  EQUIP-1,            !- SCHEDULE Name
  EquipmentLevel,     !- Design Level calculation method
  300,                !- Design Level {W}
  ,                   !- Power per Zone 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 Name
  HotWater Eq Sch,                    !- Schedule Name
  Watts/Area,                         !- Design Level Calculation Method
  ,                                   !- Design Level {W}
  50,                                 !- Power per Zone 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 Name[LINK]

This field is the name of the thermal zone (ref: Zone) and attaches a particular steam equipment statement to a thermal zone or set of thermal zones in the building. When the ZoneList option is used then this steam equipment definition is applied to each of the zones in the zone list effecting a global definition for the amount of steam in the zone. This option can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method.

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 Zone 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 Zone Floor Area[LINK]

This factor (watts/m2) is used, along with the Zone 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. The following special tags will also place the end-use in specific rows in the LEED Summary table EAp2-4/5. Performance Rating Method Compliance: Fans-Parking Garage, Interior Lighting-Process, Cooking, Industrial Process, Elevators and Escalators.

IDF Examples:

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

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.

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

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 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 scheduled 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 sits 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 sits 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 Heating Rate [W]

  • HVAC, Sum, Indoor Pool 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 Heating Rate [W] [LINK]

This is the rate of heating provided by the plant loop to the pool in Watts.

Indoor Pool 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.

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, PropaneGas, FuelOil#1, FuelOil#2, Diesel, Gasoline, Coal, Steam, DistrictHeating, 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 Name[LINK]

This field is the name of the thermal zone (ref: Zone) and attaches a particular other equipment statement to a thermal zone or set of thermal zones in the building. When the ZoneList option is used then this other equipment definition is applied to each of the zones in the zone list effecting a global definition for the amount of other in the zone. This option can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method.

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 Zone 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 Zone Floor Area[LINK]

This factor (watts/m2) is used, along with the Zone 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. The following special tags will also place the end-use in specific rows in the LEED Summary table EAp2-4/5. Performance Rating Method Compliance: Fans-Parking Garage, Interior Lighting-Process, Cooking, Industrial Process, Elevators and Escalators.

IDF Examples

OtherEquipment,
    BASE-1 OthEq 1, !- Name
    PropaneGas,  !- Fuel Use Type
    BASE-1, !- Zone Name 
    ALWAYSON, !- SCHEDULE Name
    EquipmentLevel, !- Design Level calculation method
    6766., !- Design Level {W}
    , !- Power per Zone 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

Outputs[LINK]

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

Electric Equipment

  • Zone,Average,Electric Equipment Electric Power [W]

  • Zone,Sum,Electric Equipment Electric 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,Zone Electric Equipment Electric Power [W]

  • Zone,Sum,Zone Electric Equipment Electric 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 Gas Rate [W]

  • Zone,Sum,Gas Equipment Gas 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,Zone Gas Equipment Gas Rate [W]

  • Zone,Sum,Zone Gas Equipment Gas 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,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,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,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 Electric Power [W] [LINK]

Electric Equipment Electric 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. This energy use is added to the electricity meters that are associated with the zone – Electricity:Facility, Electricity:Buidling, Electricity:Zone:<Zone Name>, InteriorEquipment:Electricity: :Zone:<Zone Name>, and <End-Use Subcategory>:InteriorEquipment:Electricity.

Gas Equipment Gas Rate [W] [LINK]

Gas Equipment Gas 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. This energy use is added to the gas meters that are associated with the zone – Gas:Facility, Gas:Buidling, Gas:Zone:<Zone Name>, InteriorEquipment:Gas: :Zone:<Zone Name>, and <End-Use Subcategory>:InteriorEquipment:Gas.

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

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. This energy use is added to the district heating meters that are associated with the zone – DistrictHeating:Facility, DistrictHeating:Buidling, DistrictHeating:Zone:<Zone Name>, InteriorEquipment: DistrictHeating: :Zone:<Zone Name>, and <End-Use Subcategory>:InteriorEquipment: DistrictHeating.

Steam Equipment District Heating Rate [W] [LINK]

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. This energy use is added to the district heating meters that are associated with the zone – DistrictHeating:Facility, DistrictHeating:Buidling, DistrictHeating:Zone:<Zone Name>, InteriorEquipment: DistrictHeating: :Zone:<Zone Name>, and <End-Use Subcategory>:InteriorEquipment: DistrictHeating.

Other Equipment Fuel Rate [W] [LINK]

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. This energy use is added to the appropriate fuel meters that are associated with the zone – <Fuel Type>:Facility, <Fuel Type>:Buidling, <Fuel Type>:Zone:<Zone Name>, InteriorEquipment:<Fuel Type>: :Zone:<Zone Name>, and <End-Use Subcategory>:InteriorEquipment:<Fuel Type>.

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 Name[LINK]

This field is the name of the thermal zone (ref: Zone) which contains this ElectricEquipment:ITE:AirCooled object.

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 Zone 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 Zone 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 deg. 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, 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.

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

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.

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

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.

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). Subcategories are also reported in the ABUPS table. 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). Subcategories are also reported in the ABUPS table. 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). Subcategories are also reported in the ABUPS table. The default is ITE-UPS

An IDF example:

ElectricEquipment:ITE:AirCooled,
  Data Center Servers,     !- Name
  Main Zone,               !- Zone Name
  Watts/Unit,              !- Design Power Input Calculation Method
  500,                     !- Watts per Unit {W}
  200,                     !- Number of Units
  ,                        !- Watts per Zone 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

ElectricEquipment:ITE:AirCooled Outputs

  • Zone,Average,ITE CPU Electric Power [W]

  • Zone,Average,ITE Fan Electric Power [W]

  • Zone,Average,ITE UPS Electric Power [W]

  • Zone,Average,ITE CPU Electric Power at Design Inlet Conditions [W]

  • Zone,Average,ITE Fan Electric Power 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 Electric Energy [J]

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

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

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

  • Zone,Sum,ITE Fan Electric 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,Zone ITE CPU Electric Power [W]

  • Zone,Average,Zone ITE Fan Electric Power [W]

  • Zone,Average,Zone ITE UPS Electric Power [W]

  • Zone,Average,Zone ITE CPU Electric Power at Design Inlet Conditions [W]

  • Zone,Average,Zone ITE Fan Electric Power 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 Electric Energy [J]

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

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

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

  • Zone,Sum,Zone ITE Fan Electric 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]

Zone ITE CPU Electric Power [W] [LINK]

ITE CPU Electric Power [W]

Zone ITE CPU Electric Energy [J] [LINK]

ITE CPU Electric Energy [J] [LINK]

The electric power (or energy) input to the ITE equipment CPU (total power input less cooling fan power). The ITE CPU Electric Energy output is also added to a meter object with Resource Type = Electricity, End Use Key = InteriorEquipment, Group Key = Building (Ref. Output:Meter object).

Zone ITE CPU Electric Power at Design Inlet Conditions [W] [LINK]

ITE CPU Electric Power at Design Inlet Conditions [W] [LINK]

Zone ITE CPU Electric Energy at Design Inlet Conditions [J] [LINK]

ITE CPU Electric 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).

Zone ITE Fan Electric Power [W] [LINK]

ITE Fan Electric Power [W] [LINK]

Zone ITE Fan Electric Energy [J] [LINK]

ITE Fan Electric Energy [J] [LINK]

The electric power (or energy) input to the ITE cooling fan. The ITE Fan Electric Energy output is also added to a meter object with Resource Type = Electricity, End Use Key = InteriorEquipment, Group Key = Building (Ref. Output:Meter object).

Zone ITE Fan Electric Power at Design Inlet Conditions [W] [LINK]

ITE Fan Electric Power at Design Inlet Conditions [W] [LINK]

Zone ITE Fan Electric Energy at Design Inlet Conditions [J] [LINK]

ITE Fan Electric 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).

Zone ITE UPS Electric Power [W] [LINK]

ITE UPS Electric Power [W] [LINK]

Zone ITE UPS Electric Energy [J] [LINK]

ITE UPS Electric 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 Electric Energy output is also added to a meter object with Resource Type = Electricity, End Use Key = InteriorEquipment, Group Key = Building (Ref. Output:Meter object).

Zone ITE UPS Heat Gain to Zone Rate [W] [LINK]

ITE UPS Heat Gain to Zone Rate [W] [LINK]

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.

Zone ITE Total Heat Gain to Zone Rate [W] [LINK]

ITE Total Heat Gain to Zone Rate [W] [LINK]

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

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 20ºC dry bulb, dry air, and nominally adjusted for elevation.

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.

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.

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. SHI = (Tin – Tsupply)/(Tout-Tsupply) where Tin is the dry-bulb temperature of the air entering the ITE, Tout is the dry-bulb temperature of the air leaving the ITE, and Tsupply 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.

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.

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

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

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

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

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

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 temperature difference (in degrees DeltaC) between the air inlet relative humidity and the minimum allowable relative humidity 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.

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 m3/s for an individual ZoneContaminantSourceAndSink:CarbonDioxide object.

Zone Contaminant Source or Sink CO2 Gain Volume Flow Rate [m3/s] [LINK]

This output variable reports the total (net) carbon dioxide internal gains/losses in cubic meters per second for a zone, including impacts from three objects: ZoneContaminantSourceAndSink:CarbonDioxide, People, and GasEquipment. Positive values denote carbon dioxide generation (gain or source), while negative values denote carbon dioxide removal (loss or sink).

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:

Sf(t)=Gf(t)FGRf(t)Cf(t)1.0E6FR

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]

Rf = 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:

Sf(t)=Hf(t)FG(PjPi)n

where

Sf = Generic contaminant source strength [m3/s]

Hf = Generic contaminant generation rate coefficient [m3/s]

FG = Fraction value from the source fraction schedule at a given time [dimensionless]

n = Flow power exponent

Pi = Zone pressure [Pa]

Pj = 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 egenration 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:

Sf=hρA(CfCsk)1.0E6

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:

Sf(t)=νdAsmCf(t)1.0E6FR

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:

Sf(t)=kdVzCf(t)1.0E6FRm

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.

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
> 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 Name[LINK]

This field is the name of the zone and attaches the baseboard heat equipment statement to a thermal zone in the building.

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). Subcategories are also reported in the ABUPS table. 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 20°C.

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 Electric Power [W]

  • Zone,Sum,Baseboard Electric 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,Zone Baseboard Electric Power [W]

  • Zone,Sum,Zone Baseboard Electric 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 Electric Power [W] [LINK]

This field is the electric power for the ZoneBaseboard:OutdoorTemperatureControlled object in Watts.

Baseboard Electric 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.

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.

Zone Baseboard Electric Power [W] [LINK]

This field is the electric power for all ZoneBaseboard:OutdoorTemperatureControlled objects within the zone in Watts.

Zone Baseboard Electric 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. However, this amount is also shown in the Electricity meters that are associated with the zone – Electricity:Facility, Electricity:Buidling, Electricity:Zone:<Zone Name>, and InteriorEquipment:Electricity.

Zone Baseboard Radiant Heating Rate [W] [LINK]

Zone Baseboard Radiant Heating Energy [J] [LINK]

These output variables are the amount of radiant heat gain for all ZoneBaseboard:OutdoorTemperatureControlled objects within the zone 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.

Zone Baseboard Convective Heating Rate [W] [LINK]

Zone Baseboard Convective Heating Energy [J] [LINK]

These output variables are the amount of convective heat gain for all ZoneBaseboard:OutdoorTemperatureControlled objects within the zone 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.

Zone Baseboard Total Heating Rate [W] [LINK]

Zone Baseboard Total Heating Energy [J] [LINK]

These output variables are the amount of heat gain for all ZoneBaseboard:OutdoorTemperatureControlled objects within the zone in Watts (for rate) or Joules. This is determined by the sum of the radiant and convective heat gains from the baseboard heat.

Outputs[LINK]

As described in each of the equipment sections, values for specific equipments will show up on the following meters:

Distribution of Equipment to Meters
Meter Name Scope Equipment Specfics
Electricity:Facility Entire Facility Electric Equipment, OTC Baseboard Heat
Electricity:Building All Zones Electric Equipment, OTC Baseboard Heat
Electricity:Zone: <Zone Name> Specific Zone Electric Equipment, OTC Baseboard Heat
InteriorEquipment:Electricity AllZones Electric Equipment, OTC Baseboard Heat
<End-Use Subcategory> :InteriorEquipment:Electricity Specific Subcategory Electric Equipment, OTC Baseboard Heat
Gas:Facility Entire Facility Gas Equipment
Gas:Building All Zones Gas Equipment
Gas:Zone: <Zone Name> Specific Zone Gas Equipment
InteriorEquipment:Gas AllZones Gas Equipment
<End-Use Subcategory> :InteriorEquipment:Gas Specific Subcategory Gas Equipment