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).
Each internal gains object has a field for “Zone
or ZoneList
or Space
or SpaceList
Name”. All internal gains are modeled at the Space
level, so each internal gain input object may be expanded to
multiple instances of that gain according to the following
rules with names constructed using the <Object Name>,
<Zone Name>, or <Space Name>. If the resulting
concatenated name is greater than 100 characters a warning
will be shown and it will be truncated. If the resulting name
duplicates another such concatenated name, there will be a
severe error and terminate the run. The concatenated name is
used when referring to specific instances of internal gains
for Output:Variables, Energy Management System (EMS) controls,
and Demand Limiting Controls.
Space Name
will result in one instance of the internal gain, named
<Object Name>. The full magnitude of the gain will be
applied to the Space
using the design level, space floor area, or space occupancy
as appropriate.
SpaceList Name
will result in one instance of the internal gain for each
Space
in the SpaceList,
named <Space Name> <Object Name>. The full
magnitude of the gain will be applied to each Space
in the SpaceList
using the design level, space floor area, or space occupancy
as appropriate.
Zone Name
will result in one instance of the internal gain for each
Space
in the Zone.
If there is only one Space
in the Zone,
then the single instance will be named <Object Name>. If
there is more than one Space
in the Zone,
then each instance will be named <Space Name> <Object
Name>. The full magnitude of the gain will be split between
the Spaces in the Zone
apportioned by the Space
floor area or occupancy depending on the input method.
ZoneList Name
will result in one instance of the internal gain for each
Space
in each Zone
in the ZoneList.
Each instance will be named <Space Name> <Object
Name>. The full magnitude of the gain will be applied to
each Zone
in the ZoneList
then split between the Spaces in each Zone
apportioned by the Space
floor area or occupancy depending on the input method.
As an example, assume that Zone
1 contains Space
1A and Space
1B, and Zone
2 contains only Space
2 (objects are abbreviated for clarity):
Space,
Space 1A, !- Name
Zone 1, !- Zone Name
75.0, !- Floor Area
Space,
Space 1B, !- Name
Zone 1; !- Zone Name
25.0, !- Floor Area
Space,
Space 2, !- Name
Zone 2, !- Zone Name
SpaceList,
All Spaces, !- Name
Space 1A, !- Space 1 Name
Space 1B, !- Space 2 Name
Space 2, !- Space 3 Name
People,
Office People, !- Name
Zone 1, !- Zone or ZoneList or Space or SpaceList Name
100.0, !- Number of People
People,
Lunchroom People, !- Name
Zone 2, !- Zone or ZoneList or Space or SpaceList Name
50.0, !- Number of People
People,
Cleaning Crew, !- Name
All Spaces, !- Zone or ZoneList or Space or SpaceList Name
2.0, !- Number of People
Resulting instances of People:
Space 1A Office People, 75 people. (concatenated name, apportioned by space floor area)
Space 1B Office People, 25 people. (concatenated name, apportioned by space floor area)
Lunchroom People, 50 people. (simple object name for a single space)
Space 1A Cleaning Crew, 2 people. (full load applied to each space in SpaceList)
Space 1B Cleaning Crew, 2 people.
Space 2 Cleaning Crew, 2 people.
The people statement is used to model the occupant’s effect
on the space conditions. The following definition addresses
the basic affects as well as providing information that can be
used to report the thermal comfort of a group of occupants.
The Fanger, Pierce Two-Node, Kansas State University Two-Node,
ASHRAE Standard 55 Elevated Air Cooling Effect model, and
ASHRAE Standard 55 Ankle Draft Risk thermal comfort models are
available in EnergyPlus. A user may select any of these models
for each People
statement by simply adding the appropriate choice keyword
after the air velocity schedule name. Thermal comfort
calculations will only be made for people statements that
include specific requests for these thermal comfort models.
This object also requires input of carbon dioxide generation
rate based on people activity level for zone carbon dioxide
simulations.
The name of the People
object. Must be unique across all People
objects.
Field: Zone or
ZoneList or Space or SpaceList Name[LINK]
This field applies this People
object to one or more thermal zones or spaces in the building.
The Zone,
Zonelist or SpaceList
options can be used effectively with the people/area and
area/person options of the Number of People
Calculation Method to place a varying number of people at the
same density in each zone or space. The names of the actual
people objects may be concatenated as <Space Name>
<People Object Name>. See Specifying Applicable Zone(s)
or Space(s) for more details.
When multiple people objects are defined for the same zone,
and they have different SET, PMV, Heat/Cold Stress Temperature
Threshold, a warning message will be produced to caution users
that zone-level resilience metrics results will only be
meaningful if each zone has at most one People
object defined. This is especially true for SET Degree-Hours
and Discomfort-Weighted Exceedance Hours tables. In the SET
Degree-Hour case, this is because in the calculation of zone
level Heating/Cooling SET Degree-Hours, if multiple People
objects are defined for one zone, EnergyPlus will only use the
SET of one People
object to compute the zone level SET Degree-Hours, and
neglecting the SET of other people object defined in the same
zone. As a result, when multiple people objects with different
SET, PMV, or Heat/Cold Stress Temperature are linked to one
zone, the corresponding zone-level resilience metrics results
might be invalid.
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.
This field is a key/choice field that tells which of the
next three fields are filled and is descriptive of the method
for calculating the nominal number of occupants (people) in
the Zone.
The key/choices are:
People
With this choice, the method used will be a straight
insertion of the number of occupants (people). (The Number of
People
field should be filled.)
People/Area
With this choice, the method used will be a factor per
floor area of the zone. (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).
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.
This factor (person/m\(^{2}\)) 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”.
This factor (m\(^{2}\)/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”.
This field is a decimal number between 0.0 and 1.0 and is
used to characterize the type of heat being given off by
people in a zone. The number specified in this field will be
multiplied by the total sensible energy emitted by people to
give the amount of long wavelength radiation gain from human
beings in a zone. The remainder of the sensible load is
assumed to be convective heat gain. Note that latent gains
from people are not included in either the radiant or
convective heat gains. See the Engineering Reference document
for more details. Default value is 0.30.
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.
This field is the name of the schedule that determines the
amount of heat gain per person in the zone under design
conditions. This heat gain impacts the basic zone heat balance
as well as the modeling of thermal comfort. This value is
modified somewhat based on a correlation to account for
variations in space temperature. The schedule values may be
any positive number and the units for this parameter is Watts
per person. This schedule represents the total heat gain per
person including convective, radiant, and latent. An internal
algorithm is used to determine what fraction of the total is
sensible and what fraction is latent. Then, the sensible
portion is divided into radiant and convective portions using
the value specified for Fraction Radiant (above). See the
Engineering Reference document for more details.
Values for activity level can range anywhere from
approximately 100-150 Watts per person for most office
activities up to over 900 Watts per person for strenuous
physical activities such as competitive wrestling. The
following table (Table 1)
is based on Table [table:wind-speed-profile-coefficients-ashrae]
from the 2005 ASHRAE Handbook of Fundamentals, page 8.6. In
addition to the information from the ASHRAE HOF, there is an
added column of values in W/Person such as necessary for the
activity level schedule values. This column uses the standard
adult body surface area of 1.8 m\(^{2}\) to multiply the activity
levels in W/m\(^{2}\) 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.
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.
This field is used in the calculation of hours of safety
for cold events, which is defined as the longest duration
(number of hours), starting from the beginning time of the
risk period (e.g., the start time of a power outage), to not
below a certain temperature threshold (specified in this
field). If not specified, 60F (or 15.56C) will be used as the
default temperature threshold.
This field is used in the calculation of hours of safety
for hot events, which is defined as the longest duration
(number of hours), starting from the beginning time of the
risk period (e.g., the start time of a power outage), to not
above a certain temperature threshold (specified in this
field). If not specified, 86F (or 30C) will be used as the
default temperature threshold.
This field accepts either “Yes” or “No” as values. When
“Yes” is specified, warnings are generated when the space
conditions are outside of the ASHRAE 55 comfort range as
discussed in the sections that follow titled “Simplified
ASHRAE 55-2004 Graph Related Outputs” and “Simplified ASHRAE
55 Warnings.” The default is not to provide these warnings so
if you want to know if your space is outside this comfort
range you must set this field to Yes.
Metabolic Rates for Various Activities
Activity
Activity Level Schedule Value
(W/Person)
Activity Level (W/m\(^2\))
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/m\(^{2}\)
Field:
Mean Radiant Temperature Calculation Type[LINK]
This field specifies the type of Mean Radiant Temperature
(MRT) calculation the user wishes to use for the thermal
comfort model. At the present time, there are three options
for MRT calculation type: zone averaged, surface weighted, and
a list of angle factors. The default calculation is
“ZoneAveraged” and is used if field is left blank. 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 ComfortViewFactorAngles
object (see next object description) is intended to give the
user this opportunity.
This field is only valid when the user selects
“SurfaceWeighted” or “AngleFactor” for the MRT calculation
type (see the previous input field description). In the case
of “SurfaceWeighted”, the field is the name of a surface
within the 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 “SurfaceWeighted” MRT calculation method is the average of
the temperature of the surface specified in this field and the
“zone averaged” MRT (see the Mean Radiant Temperature
calculation type field above). In the case of “AngleFactor”,
the field is the name of a ComfortViewFactorAngles
input object defined elsewhere. This field is required when
the previous field is set to “SurfaceWeighted” or
“AngleFactor” and is set to run one of the following thermal
comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 or
AnkleDraftASH55.
This field is the name of the schedule that determines the
efficiency of energy usage within the human body that will be
used for thermal comfort calculations. Note that all energy
produced by the body is assumed to be converted to heat for
the zone heat balance calculation. A value of zero corresponds
to all of the energy produced in the body being converted to
heat. A value of unity corresponds to all of the energy
produced in the body being converted to mechanical energy. The
values for this parameter defined in the schedule must be
between 0.0 and 1.0. Any value greater than zero will result
in a reduction of heat that impacts the thermal comfort energy
balance of a person within the space, resulting in PMV results
appearing lower than expected. Ensure that if this value is
non-zero, the base activity level is chosen to ensure that the
net activity converted to heat and zone conditions are
sufficient to maintain thermal comfort. This field is required
to run one of the following thermal comfort models: Fanger,
Pierce, KSU, CoolingEffectASH55 or AnkleDraftASH55. If a
schedule is listed here but no thermal comfort model is
selected, then a warning message will be produced and this
schedule will be listed as unused in the error file.
This field is a key/choice field that tells which of the
next two fields are filled and is descriptive of the method
for calculating the clothing insulation value of occupants
(people) in the Zone.
The key/choices are:
ClothingInsulationSchedule
With this choice, the method used will be a straight
insertion of the scheduled clothing insulation values of
occupants (people). (The Clothing Insulation Schedule Name
field should be filled.)
DynamicClothingModelASHRAE55
With this choice, the method used will be the dynamic
predictive clothing insulation model developed by Schiavon and
Lee (2013) based on 6,333 selected observations taken from
ASHRAE RP-884 and RP-921 databases. It varies the clothing
insulation as a function of outdoor air temperature measured
at 6am as illustrated below.
CalculationMethodSchedule
With this choice, the method used can be either the
ClothingInsulationSchedule or the
DynamicClothingModelASHRAE55, depending on a schedule (to be
entered as the next field) that determines which method to use
in different time of a day. When this option is chosen, the
next field “Clothing Insulation Calculation Method Schedule
Name” is a required input.
Graphical representation of the
dynamic predictive clothing insulation model [fig:graphical-representation-of-the-dynamic]
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.
This field is the name of the schedule that defines the
amount of clothing being worn by a typical zone occupant
during various times in the simulation period. The choice from
the Clothing Insulation Calculation Method field should be
“ClothingInsulationSchedule”. This parameter
must be a positive real number and has units of Clo. Typical
values for Clo can be seen in the ASHRAE 2009 HOF Table 7,
page 9.8 (for clothing ensembles) and Table [table:window-modeling-options],
page 9.9 (for garment values) ) or
www.cbe.berkeley.edu/comforttool/. This field is required to
run one of the following thermal comfort models: Fanger,
Pierce, KSU, CoolingEffectASH55 or AnkleDraftASH55. If a
schedule is listed here but no thermal comfort model is
selected, then a warning message will be produced and this
schedule will be listed as unused in the error file.
This field is the name of the schedule that approximates
the amount of air movement in the space as a function of time
throughout the simulation period. The user has control over
this parameter through the schedule that requires the
individual numbers in the schedule to be positive real numbers
having units of meters per second. This field is required to
run one of the following thermal comfort models: Fanger,
Pierce, KSU, CoolingEffectASH55 or AnkleDraftASH55. If a
schedule is listed here but no thermal comfort model is
selected, then a warning message will be produced and this
schedule will be listed as unused in the error file.
Field:
Thermal Comfort Model Type (up to 7 allowed)[LINK]
The final one to five fields are optional and are intended
to trigger various thermal comfort models within EnergyPlus.
By entering the keywords Fanger, Pierce, KSU, AdaptiveASH55,
AdaptiveCEN15251, CoolingEffectASH55, and AnkleDraftASH55, the
user can request the Fanger, Pierce Two-Node, Kansas State
UniversityTwo-Node, the adaptive comfort models of the ASHRAE
Standard 55 and CEN Standard 15251, ASHRAE Standard 55
Elevated Air Cooling Effect model, and ASHRAE Standard 55
Ankle Draft Risk model results for this particular people
statement. Detailed descriptions and requirements of the seven
models as listed below.
Fanger
Fanger’s Comfort model is applied to calculate related
thermal comfort metrics. Fanger Model PMV, PPD, and Clothing
Surface Temperature are calculated and reported as each time
step. Apart from existing required fields in People
object, extra fields required for this model include Surface
Name/Angle Factor List Name, Work Efficiency Schedule Name,
Clothing Insulation Schedule Name, and Air Velocity Schedule
Name.
Pierce
The Pierce Two-Node model is applied to calculate related
thermal comfort metrics. Pierce Model Effective Temperature
PMV, Standard Effective Temperature PMV, Discomfort Index,
Thermal Sensation Index, and Standard Effective Temperature
are calculated and reported as each time step.Apart from
existing required fields in People
object, extra fields required for this model include Surface
Name/Angle Factor List Name, Work Efficiency Schedule Name,
Clothing Insulation Schedule Name, and Air Velocity Schedule
Name.
KSU
The KSU Two-Node Model is applied to calculate related
thermal comfort metrics. KSU Model Thermal Sensation Vote is
calculated and reported as each time step. Note that the KSU
model is computationally intensive and may noticeably increase
the execution time of the simulation. Apart from existing
required fields in People
object, extra fields required for this model include Surface
Name/Angle Factor List Name, Work Efficiency Schedule Name,
Clothing Insulation Schedule Name, and Air Velocity Schedule
Name.
AdaptiveASH55
Adaptive Comfort Model Based on ASHRAE Standard 55-2010 is
applied to calculate related thermal comfort metrics. ASHRAE
55 Adaptive Model 90% Acceptability Status, 80% Acceptability
Status, Running Average Outdoor Air Temperature, and the
Adaptive Model Temperature are calculated and reported as each
time step. AdaptiveASH55 is only applicable when the running
average outdoor air temperature for the past 7 days is between
10.0 and 33.5C.
AdaptiveCEN15251
Adaptive Comfort Model Based on European Standard
EN15251-2007 is applied to calculate related thermal comfort
metrics. CEN 15251 Adaptive Model Category I/II/II Status,
Running Average Outdoor Air Temperature, and the Adaptive
Model Temperature are calculated and reported as each time
step. AdaptiveCEN15251 is only applicable when the running
average outdoor air temperature for the past 30 days is
between 10.0 and 30.0C.
CoolingEffectASH55
ASHRAE 55-2017 Elevated Air Speed Cooling Effect Model is
applied to calculate related thermal comfort metrics. Elevated
Air Speed Cooling Effect, Cooling Effect Adjusted PMV, and
Cooling Effect Adjusted PPD are calculated and reported as
each time step. Apart from existing required fields in People
object, extra fields required for this model include Surface
Name/Angle Factor List Name, Work Efficiency Schedule Name,
Clothing Insulation Schedule Name, and Air Velocity Schedule
Name.
AnkleDraftASH55
ASHRAE 55-2017 Ankle Draft Risk Model is applied to
calculate related thermal comfort metrics. Zone
Thermal Comfort ASHRAE 55 Ankle Draft PPD is calculated and
reported as each time step. Apart from existing required
fields in People
object, extra fields required for this model include Surface
Name/Angle Factor List Name, Work Efficiency Schedule Name,
Clothing Insulation Schedule Name, Air Velocity Schedule Name,
and Ankle Level Air Velocity Schedule Name. Ankle draft PPD
calculations are only applicable for relative air velocity is
below 0.2 m/s, and the subject’s metabolic rate and clothing
level should be kept below 1.3 met and 0.7 clo. PPD at ankle
draft will be set to -1.0 if if these conditions are not
met.
For descriptions of the thermal comfort calculations, see
the Engineering Reference document.
Note that since up to seven models may be specified, the
user may opt to have EnergyPlus calculate the thermal comfort
for people identified with this people statement using all
seven models if desired.
Field:
Ankle Level Air Velocity Schedule Name[LINK]
This field is the name of the schedule that approximates
the amount of air movement at the occupants’ ankle level (0.1
m above floor level) as a function of time throughout the
simulation period. The user has control over this parameter
through the schedule that requires the individual numbers in
the schedule to be positive real numbers having units of
meters per second. This field is required to run the
AnkleDraftASH55 thermal comfort model. If a schedule is listed
here but no thermal comfort model is selected, then a warning
message will be produced and this schedule will be listed as
unused in the error file.
The following IDF example allows for a maximum of 31 people
with scheduled occupancy of “Office Occupancy”, 60% radiant
using an Activity Schedule of “Activity Sch”. The example
allows for thermal comfort reporting.
People,
Kitchen_ZN_1_FLR_1, !- Name
Kitchen_ZN_1_FLR_1, !- Zone or ZoneList or Space or SpaceList Name
BLDG_OCC_SCH, !- Number of People Schedule Name
People, !- Number of People Calculation Method
25.2000,,, !- Number of People, People per Zone Floor Area, Zone Floor Area per Person
0.3000, !- Fraction Radiant
AUTOCALCULATE, !- Sensible Heat Fraction
ACTIVITY_SCH, !- Activity Level Schedule Name
3.82E-8, !- Carbon Dioxide Generation Rate {m3/s-W}
No, !- Enable ASHRAE 55 Comfort Warnings
ZoneAveraged, !- Mean Radiant Temperature Calculation Type
, !- Surface Name/Angle Factor List Name
WORK_EFF_SCH, !- Work Efficiency Schedule Name
ClothingInsulationSchedule, !- Clothing Insulation Calculation Method
, !- Clothing Insulation Calculation Method Schedule Name
CLOTHING_SCH, !- Clothing Insulation Schedule Name
AIR_VELO_SCH, !- Air Velocity Schedule Name
Fanger; !- Thermal Comfort Model 1 Type
A simpler example, without using the thermal comfort
reporting option:
People,
RIGHT FORK, !- Name
RIGHT FORK, !- Zone or ZoneListName
Dorm Occupancy, !- Number of People Schedule Name
people, !- Number of People Calculation Method
8.00000, !- Number of People,
, !- People per Zone Floor Area
, !- Zone Floor Area per Person
0.6000000, !- Fraction Radiant
Autocalculate, !- Sensible Heat Fraction
Activity Sch, !- Activity level Schedule Name
And with the sensible fraction specified:
People,
SPACE1-1 People 1, !- Name
SPACE1-1, !- Zone or ZoneListName
OCCUPY-1, !- Number of People Schedule Name
people, !- Number of People Calculation Method
11, !- Number of People
, !- People per Zone Floor Area
, !- Zone Floor Area per Person
0.3, !- Fraction Radiant
0.55, !- Sensible Heat Fraction
ActSchd; !- Activity level Schedule Name
ZoneList,AllOccupiedZones,SPACE1-1,SPACE2-1,SPACE3-1,SPACE4-1,SPACE5-1;
People,
AllZones with People, !- Name
AllOccupiedZones, !- Zone or ZoneList or Space or SpaceList Name
OCCUPY-1, !- Number of People Schedule Name
People/Area, !- Number of People Calculation Method
, !- Number of People
.11, !- People per Zone Floor Area {person/m2}
, !- Zone Floor Area per Person {m2/person}
0.3, !- Fraction Radiant
, !- Sensible Heat Fraction
ActSchd, !- Activity Level Schedule Name
3.82E-8, !- Carbon Dioxide Generation Rate {m3/s-W}
No, !- Enable ASHRAE 55 Comfort Warnings
surfaceweighted, !- Mean Radiant Temperature Calculation Type
Zn001:Wall001, !- Surface Name/Angle Factor List Name
Work Eff Sch, !- Work Efficiency Schedule Name
ClothingInsulationSchedule, !- Clothing Insulation Calculation Method
, !- Clothing Insulation Calculation Method Schedule Name
Clothing Sch, !- Clothing Insulation Schedule Name
Air Velo Sch, !- Air Velocity Schedule Name
FANGER, !- Thermal Comfort Model 1 Type
PIERCE, !- Thermal Comfort Model 2 Type
KSU; !- Thermal Comfort Model 3 Type
It should be noted that if a user is trying to output the
Standard Effective Temperature (SET) that the Pierce two-node
model must be selected. This variable is calculated as part of
the Pierce model and can be seen in the output by requesting
Zone
Thermal Comfort Pierce Model Standard Effective
Temperature.
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.
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.
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.
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.
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.
This output variable represents the zone air temperature
based on the Fanger thermal comfort model. If there is a ZoneControl:Thermostat:ThermalComfort
object specified and the thermal zone is occupied, then the
value of “People
Air Temperature” is determined based on the thermal comfort
that satisfies the thermal comfort setpoint PMV value
specified; otherwise, it is set to average zone air
temperature.
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.
This field is the total number of people within the space
or zone during the timestep in question.
Space or Zone
People Radiant Heating Rate [W][LINK]
Space or Zone
People Radiant Heating Energy [J][LINK]
These output variables are the amount of radiant heat gain
from people within the space or zone in Watts (for rate) or
Joules. This is determined by the current sensible heat gain
from people to the space or zone and the “Fraction Radiant”
specified in the input. The radiant gains from people are
distributed to the surfaces using an area weighting
scheme.
Space or Zone
People Convective Heating Rate [W][LINK]
Space or Zone
People Convective Heating Energy [J][LINK]
These output variables are the amount of convective heat
gain from people within the space or zone in Watts (for rate)
or Joules. This is determined by the current sensible heat
gain from people to the space or zone and the “Fraction
Radiant” specified in input. Note that the radiant and
convective gains should add up to the sensible heat gain from
people. The convective heat gain from people is added to the
space or zone air heat balance directly.
These output variables are the amount of latent heat gain
from people within the space or zone in Watts (for rate) or
Joules. This amount is based on the number of people in the
space as well as the total amount of energy produced by a
typical person defined by the activity schedule in the input.
An internal algorithm is used to determine what fraction of
the total is sensible and what fraction is latent. Details
about this split are included in the Engineering Reference
document.
Space or Zone
People Sensible Heating Rate [W][LINK]
Space or Zone
People Sensible Heating Energy [J][LINK]
These output variables are the amount of sensible heat gain
from people within the space or zone in Watts (for rate) or
Joules. This amount is based on the number of people in the
space as well as the total amount of energy produced by a
typical person defined by the activity schedule in the input.
An internal algorithm (described in the Engineering Reference
document) is used to determine what fraction of the total is
sensible and what fraction is latent. The sensible plus the
latent heat gain from people equals the total gain specified
in the input.
Space or Zone
People Total Heating Energy [J][LINK]
These output variables are the total amount of heat gain
from people within the space or zone in Watts (for rate) or
Joules. Derived from the activity level times the number of
occupants, this is summed for each people object within a
zone.
Zone
Thermal Comfort Mean Radiant Temperature [C][LINK]
This output variable is the mean radiant temperature used
in the thermal comfort calculations. This value is computed
according to the “MRT Calculation Type” specified in the
PEOPLE object. If a high temperature radiant system is
present in the zone, this value will be adjusted according to
the current heater operation and the “Fraction of radiant
energy incident on people” specified in the HIGH TEMP RADIANT
SYSTEM object.
Zone
Thermal Comfort Operative Temperature [C][LINK]
This output variable is the operative temperature as
defined by the thermal comfort operations. Specifically, it is
the average of the thermal comfort mean radiant temperature
and the zone air temperature.
Note for all Thermal Comfort reporting: Though the
published values for thermal comfort “vote” have a discrete
scale (e.g. –3 to +3 or –4 to +4), the calculations in
EnergyPlus are carried out on a continuous scale and, thus,
reporting may be “off the scale” with specific conditions
encountered in the space. This is not necessarily an error in
EnergyPlus – rather a different approach that does not take
the “limits” of the discrete scale values into account.
This field is the “predicted mean vote” (PMV) calculated
using the Fanger thermal comfort model. Details on the
equations used to calculate the Fanger PMV are shown in the
EnergyPlus Engineering Reference. If the zone in question is
currently being controlled using a thermostat object, then the
value of the PMV is determined by using the air temperature
and humidity that is calculated at the system time step;
otherwise, if the zone is uncontrolled, the PMV is determined
using the zone air temperature and humidity that is averaged
over the zone time step.
This field is the “predicted percentage of dissatisfied”
(PPD) calculated using the Fanger thermal comfort model.
Details on the equations used to calculate the Fanger PPD are
shown in the EnergyPlus Engineering Reference. If the zone in
question is currently being controlled using a thermostat
object, then the value of the PPD is determined by using the
air temperature and humidity that is calculated at the system
time step; otherwise, if the zone is uncontrolled, the PPD is
determined using the zone air temperature and humidity that is
averaged over the zone time step.
Zone
Thermal Comfort Clothing Surface Temperature [C][LINK]
This output variable is the calculation of the clothing
surface temperature using the Fanger thermal comfort
model.
Zone
Thermal Comfort Pierce Model Effective Temperature PMV [][LINK]
This field is the “predicted mean vote” (PMV) calculated
using the effective temperature and the Pierce two-node
thermal comfort model.
Zone
Thermal Comfort Pierce Model Standard Effective Temperature
PMV [][LINK]
This field is the “predicted mean vote” (PMV) calculated
using the “standard” effective temperature and the Pierce
two-node thermal comfort model.
Zone
Thermal Comfort Pierce Model Discomfort Index [][LINK]
This field is the “discomfort index” calculated using the
the Pierce two-node thermal comfort model.
Zone
Thermal Comfort Pierce Model Thermal Sensation Index [][LINK]
This field is the “thermal sensation index” (PMV)
calculated using the Pierce two-node thermal comfort
model.
Zone
Thermal Comfort Pierce Model Standard Effective Temperature
[C][LINK]
This field is the “standard effective temperature” (SET)
calculated using the Pierce two-node thermal comfort model.
Note that if a user wishes to report the Pierce Model SET that
it must be done using the Pierce two-node model and the user
must select “Pierce” as one of the Thermal Comfort model types
as shown above in the input syntax for the People
statement.
Zone
Thermal Comfort KSU Model Thermal Sensation Vote [][LINK]
This field is the “thermal sensation vote” (TSV) calculated
using the KSU two-node thermal comfort model.
Zone
Thermal Comfort ASHRAE 55 Adaptive Model 90% Acceptability
Status [][LINK]
This field is to report whether the operative temperature
falls into the 90% acceptability limits of the adaptive
comfort in ASHRAE 55-2010. A value of 1 means within
(inclusive) the limits, a value of 0 means outside the limits,
and a value of -1 means not applicable (when unoccupied or
running average outdoor temp is outside the range of 10.0 to
33.5C).
Zone
Thermal Comfort ASHRAE 55 Adaptive Model 80% Acceptability
Status [][LINK]
This field is to report whether the operative temperature
falls into the 80% acceptability limits of the adaptive
comfort in ASHRAE 55-2010. A value of 1 means within
(inclusive) the limits, a value of 0 means outside the limits,
and a value of -1 means not applicable (when unoccupied or
running average outdoor temp is outside the range of 10.0 to
33.5C).
Zone
Thermal Comfort ASHRAE 55 Adaptive Model Running Average
Outdoor Air Temperature [C][LINK]
This field reports the mean monthly outdoor air
temperature, an input parameter for the ASHRAE-55 adaptive
comfort model. This can be computed in two ways. If the .stat
file is provided for the simulation, this field will reflect
the monthly daily average temperature.
If the .epw file is used, the field reports the simple
running average of the daily average outdoor dry-bulb
temperatures of the previous 30 days.
Zone
Thermal Comfort ASHRAE 55 Adaptive Model Temperature [C][LINK]
This field reports the ideal indoor operative temperature,
or comfort temperature, as determined by the ASHRAE-55
adaptive comfort model. The 80% acceptability limits for
indoor operative temperature are defined as no greater than
3.5\(^\circ\)C from the
adaptive comfort temperature. The 90% acceptability limits are
defined as no greater than 2.5\(^\circ\)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.5\(^\circ\)C).
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.0\(^\circ\)C).
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.0\(^\circ\)C).
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.0\(^\circ\)C).
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.0\(^\circ\)C).
Zone
Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling
Effect[LINK]
This field is the calculated Cooling Effect of the elevated
air speed in degree celsius. It is the value that, when
subtracted equally from both the average air temperature and
the mean radiant temperature, yields the same SET under still
air as in the first SET calculation under elevated air
speed.
Zone
Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect
Adjusted PMV[LINK]
This field is the “predicted mean vote” (PMV) calculated
using the Fanger PMV model, adjusted by the ASHRAE 55 Elevated
Air Speed Cooling Effect. The Cooling Effect adjusted PMV for
an environment with elevated average air speed is calculated
using the adjusted average air temperature, the adjusted
radiant temperature, and still air (0.1 m/s).
Zone
Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect
Adjusted PPD[LINK]
This field is the “predicted percentage of dissatisfied”
(PPD) calculated using the Fanger PMV-PPD model, adjusted by
the ASHRAE 55 Elevated Air Speed Cooling Effect. The Cooling
Effect adjusted PPD for an environment with elevated average
air speed is calculated using the adjusted average air
temperature, the adjusted radiant temperature, and still air
(0.1 m/s).
Zone
Thermal Comfort ASHRAE 55 Ankle Draft PPD[LINK]
This field is the “ppredicted percentage of dissatisfied”
(PPD) on draft at ankle level. It is used as the metric to
evaluate the ankle draft risk as a function of PMV and air
speed at the ankle level (0.1 m).
The following output variables are all based on whether the
humidity ratio and the operative temperature is within the
region shown in ASHRAE Standard 55-2004 in Figure 5.2.1.1. For
these outputs the operative temperature is simplified to be
the average of the air temperature and the mean radiant
temperature. For summer, the 0.5 Clo level is used and, for
winter, the 1.0 Clo level is used. The graphs below are based
on the following tables which extend the ASHRAE values to zero
humidity ratio.
Winter Clothes (1.0 Clo)
Operative Temperature (C)
Humidity Ratio
(kgWater/kgDryAir)
19.6
0.012
23.9
0.012
26.3
0.000
21.7
0.000
Winter Comfort Range [fig:winter-comfort-range]
Summer Clothes (0.5 Clo)
Operative Temperature (C)
Humidity Ratio
(kgWater/kgDryAir)
23.6
0.012
26.8
0.012
28.3
0.000
25.1
0.000
Summer Comfort Range [fig:summer-comfort-range]
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)
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.6\(^\circ\)C to 21.7\(^\circ\)C)—heating setpoints may
need to be nearer 22.2\(^\circ\)C (72\(^\circ\)F) than 21.1\(^\circ\)C (70\(^\circ\)F).
Unoccupied heating setpoint should be nearer 16.7\(^\circ\)C (62\(^\circ\)F) rather than 12.8\(^\circ\)C (55\(^\circ\)F) 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.4\(^\circ\)C (85\(^\circ\)F) rather than 40.0\(^\circ\)C (104\(^\circ\)F) to reduce the start up
recovery.
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 enclosure mean
radiant temperature and the temperature of the surface that
the person is near and uses this value as the mean radiant
temperature when calculating thermal comfort.
The third option is for the user to more explicitly
position the person within the space by defining the angle
factors from the person to the various surfaces in the same
radiant enclosure. This option requires the user to list the
surfaces that the person can see from a radiation standpoint
and also define the angle (or view) factor for each surface.
The AngleFactorList input line is intended to give the user
this opportunity.
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.
This field is the name of a surface in the radiant
enclosure seen by the person. All surfaces listed should be in
the same radiant enclosure. This should also be the same
radiant enclosure as the People
instance which references this ComfortViewFactorAngles
object. If not, a warning will be issued, but the simulation
will proceed with the specified surfaces.
This field is the fraction that this surface contributes to
the total mean radiant temperature. This can be thought of as
a weighting factor for this surface and the actual mean
radiant temperature used in the thermal comfort model is
simply the sum of all angle factors multiplied by the
corresponding inside surface temperature, weighted by the
surface emissivity. The sum of all angle factors within any
angle factor list must equal unity, otherwise the program will
not accept the input as valid.
Note that the Surface Name/Angle Factor pair is extensible
to accommodate as many surfaces as required.
An example IDF with an electric low temperature radiant
system is shown below.
ComfortViewFactorAngles,
South Zone Angle Factors, !- name of angle factor list
, !- 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
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.
Field: Zone or
ZoneList or Space or SpaceList Name[LINK]
This field applies this Lights
object to one or more thermal zones or spaces in the building.
The Zone,
Zonelist or SpaceList
options can be used effectively with the watts/area and
watts/person options of the Design Level Calculation Method to
place a varying lighting load at the same density in each zone
or space. The names of the actual lights objects may be
concatenated as <Space Name> <Lights Object Name>.
See Specifying Applicable Zone(s) or Space(s) for more
details.
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.
This field is a key/choice field that tells which of the
next three fields are filled and is descriptive of the method
for calculating the nominal lighting level in the Zone.
The key/choice options are:
LightingLevel
With this choice, the method used will be a straight
insertion of the lighting level (Watts) for the Zone. (The
Lighting Level field should be filled.)
Watts/Area
With this choice, the method used will be a factor per
floor area of the zone. (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).
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.
This factor (watts/m\(^{2}\)) 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”.
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”.
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:
The fraction of the heat from lights that goes into the
zone return air (i.e., into the zone outlet node). If the
return air flow is zero or the zone has no return air system,
the program will put this fraction into the zone air. Return
Air Fraction should be non-zero only for luminaires that are
return-air ducted (see Table 4
and Figure 4).
(However, see the field “Return Air Fraction Is Calculated
from Plenum Temperature,” below, for an approach to modeling
the case where Return Air Fraction is caused by
conduction between a luminaire that is in contact
with a return-air plenum.)
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.
The fraction of heat from lights that goes into the zone as
visible (short-wave) radiation. The program calculates how
much of this radiation is absorbed by the inside surfaces of
the zone according the area times solar absorptance product of
these surfaces.
Approximate values of Return Air Fraction, Fraction Radiant
and Fraction Visible are given in Table 4
for overhead fluorescent lighting for a variety of luminaire
configurations. The data is based on ASHRAE 1282-RP “Lighting
Heat Gain Distribution in Buildings” by Daniel E. Fisher and
Chanvit Chantrasrisalai.
: Approximate values of Return Air Fraction, Fraction
Radiant and Fraction Visible for overhead fluorescent lighting
for different luminaire configurations.
This field defines the daylighting control for the LIGHTS
object.
If Daylighting:Controls
is specified for the space or zone, this field is used as an
on/off flag for dimming controls. If set to 0.0, the lights
are not dimmed by the daylighting controls. If set to 1.0, the
lights are allowed to be dimmed by the applicable daylighting
control. If daylighting controls are operating in the space or
zone, all of the applicable Lights
objects with a Fraction Replaceable greater than zero will be
reduced by a multiplicative factor that accounts for how much
the electric lighting is lowered due to daylighting (ref.
Daylighting Lighting Power Multiplier).
Allows you to specify a user-defined end-use subcategory,
e.g., “Task Lights”,
“Hall Lights”,
etc. A new meter for reporting is created for each unique
subcategory (ref: Output:Meter
objects). Subcategories are also reported in the ABUPS table.
If this field is omitted or blank, the lights will be assigned
to the “General” end-use subcategory. Any text may be used
here to categorize the end-uses in the ABUPS End Uses by
Subcategory table and the LEED EAp2-4/5. Performance Rating
Method Compliance table.
Field:
Return Air Fraction Calculated from Plenum Temperature[LINK]
Accepts values Yes or No (the default). Yes is for advanced
used only. In this case the program will calculate the return
air fraction by assuming that it is due to conduction of some
of the light heat into the zone’s return air plenum and that
the amount of the conduction depends on the plenum air
temperature. A Yes value should only be used for luminaires
that are recessed and non-vented, as shown in Figure 4.
The value you enter for the Return Air Fraction field will
be ignored and you can enter, for fluorescent lighting,
Fraction Radiant = 0.37 and Fraction Visible = 0.18, as
indicated in Table 4.
This feature requires that the coefficients described below
be determined from measurements or detailed calculations since
they are very sensitive to the luminaire type, lamp type,
thermal resistance between fixture and plenum, etc.
If “Return Air Fraction Is Calculated from Plenum
Temperature” = Yes, the return air fraction is calculated
each timestep from the following empirical
correlation:
\[(\rm{Return Air
Fraction})_{\rm{calculated}} = C_{1} - C_{2} \times
T_{\rm{plenum}}\]
where T\(_{\rm{plenum}}\)
is the previous-time-step value of the return plenum air
temperature (C),
and C\(_{1}\) and C\(_{2}\) 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 \(f_{\rm{convected}}\) by a scale
factor such that
Name of the return air node for this heat gain. If left
blank, it defaults to the first return air node for the zone
containing this Lights
object. Leave blank when using a ZoneList
name.
Name of the exhaust air node for this heat gain. If left
blank, no heat gain from return air fraction will be added to
the zone exhaust node. When the exhaust node name is entered,
the return air heat gain will be shared by both return and
exhaust nodes. The equipment can draw air from the exhaust
node, but the inlet air properties is combined properties with
mixing mass flow rates of both nodes and added lights heat
gain.
Vertical section through a zone
and its return air plenum showing recessed lighting (not to
scale). The heat from lights is divided into four fractions,
three of which—ReturnAirFraction, FractionRadiant and
FractionConvected—depend on plenum air temperature. [fig:vertical-section-through-a-zone-and-its]
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
ZoneList,AllOccupiedZones,SPACE1-1,SPACE2-1,SPACE3-1,SPACE4-1,SPACE5-1;
Lights,
AllZones with Lights, !- Name
AllOccupiedZones, !- Zone or ZoneList or Space or SpaceList Name
LIGHTS-1, !- Schedule Name
Watts/Area, !- Design Level Calculation Method
, !- Lighting Level {W}
16, !- Watts per Zone Floor Area {W/m2}
, !- Watts per Person {W/person}
0.2, !- Return Air Fraction
0.59, !- Fraction Radiant
0.2, !- Fraction Visible
0, !- Fraction Replaceable
GeneralLights; !- End-Use Subcategory
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.
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.
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.
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.
The lighting electrical consumption including ballasts, if
present. This will have the same value as Lights
Total Heating Energy (above).
The energy amount is also included in the following
Electricity meters:
Electricity:Facility
Electricity:Building
Electricity:Zone:<Zone Name>
Electricity:SpaceType:<Space Type Name>
InteriorLights:Electricity
InteriorLights:Electricity:Zone:<Zone Name>
InteriorLights:Electricity:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorLights:Electricity
<End-Use Subcategory>:InteriorLights:Electricity:Zone:<Zone Name>
<End-Use Subcategory>:InteriorLights:Electricity:SpaceType:<Space Type Name>
Space or Zone
Lights Radiant Heating Rate [W][LINK]
Space or Zone
Lights Radiant Heating Energy [J][LINK]
The amount of heat gain from all lights in the space or
zone that is in the form of long-wave (thermal) radiation
entering the space or zone. This heat is absorbed by the
inside surfaces of the space or zone according to an area
times long-wave absorptance weighting scheme.
Space or
Zone Lights Visible Radiation Heating Rate [W][LINK]
Space
or Zone Lights Visible Radiation Heating Energy [J][LINK]
The amount of heat gain from all lights in the space or
zone that is in the form of visible (short-wave) radiation
entering the space or zone. This heat is absorbed by the
inside surfaces of the space or zone according to an area
times short-wave absorptance weighting scheme.
Space or Zone
Lights Convective Heating Rate [W][LINK]
Space or Zone
Lights Convective Heating Energy [J][LINK]
The amount of heat gain from all lights in the space or
zone that is convected to the space or zone air.
Space or Zone
Lights Return Air Heating Rate [W][LINK]
Space or Zone
Lights Return Air Heating Energy [J][LINK]
The amount of heat gain from all lights in the space or
zone that goes into the space or zone’s return air (and,
therefore, does not directly contribute to the space or zone
load). If the space or zone has no return air system or the
space or zone’s air system is off, this heat will be added to
the space or zone air.
Space or Zone
Lights Total Heating Energy [J][LINK]
The total heat gain from all lights in the space or zone.
It is the sum of the following four outputs, i.e., Total Heat
Gain = Return Air Heat Gain + Radiant Heat Gain + Visible Heat
Gain + Convective Heat Gain. It is also equal to the
electrical input to the lights.
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.
Field: Zone or
ZoneList or Space or SpaceList Name[LINK]
This field applies this ElectricEquipment
object to one or more thermal zones or spaces in the building.
The Zone,
Zonelist or SpaceList
options can be used effectively with the watts/area and
watts/person options of the Design Level Calculation Method to
place a varying equipment load at the same density in each
zone or space. The names of the actual electric equipment
objects may be concatenated as <Space Name>
<ElectricEquipment Object Name>. See Specifying
Applicable Zone(s) or Space(s) for more details.
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.
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).
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.
This factor (watts/m\(^{2}\)) 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”.
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”.
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:
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.
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.
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.
Allows you to specify a user-defined end-use subcategory,
e.g., “Computers”, “Copy Machines”, etc. A new meter for
reporting is created for each unique subcategory (ref: Output:Meter
objects). Subcategories are also reported in the ABUPS table.
If this field is omitted or blank, the equipment will be
assigned to the “General” end-use subcategory. Any text may be
used here to categorize the end-uses in the ABUPS End Uses by
Subcategory table and the LEED Summary table EAp2-4/5.
Performance Rating Method Compliance.
An IDF example:
ElectricEquipment,
DORM ROOMS AND COMMON AREAS ElecEq 1, !- Name
DORM ROOMS AND COMMON AREAS, !- Zone Name
Residence Equipment, !- SCHEDULE Name
EquipmentLevel, !- Design Level calculation method
9210.921, !- Design Level {W}
, !- Watts per Zone Floor Area {watts/m2}
, !- Watts per Person {watts/person}
0.0000000E+00, !- Fraction Latent
0.3000000, !- Fraction Radiant
0.0000000E+00, !- Fraction Lost
Computers; !- End-use Subcategory
ZoneList,AllOccupiedZones,SPACE1-1,SPACE2-1,SPACE3-1,SPACE4-1,SPACE5-1;
ElectricEquipment,
AllZones with Electric Equipment, !- Name
AllOccupiedZones, !- Zone or ZoneList or Space or SpaceList Name
EQUIP-1, !- Schedule Name
Watts/Person, !- Design Level Calculation Method
, !- Design Level {W}
, !- Watts per Zone Floor Area {W/m2}
96, !- Watts per Person {W/person}
0, !- Fraction Latent
0.3, !- Fraction Radiant
0; !- Fraction Lost
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.
Field: Zone or
ZoneList or Space or SpaceList Name[LINK]
This field applies this GasEquipment
object to one or more thermal zones or spaces in the building.
The Zone,
Zonelist or SpaceList
options can be used effectively with the watts/area and
watts/person options of the Design Level Calculation Method to
place a varying equipment load at the same density in each
zone or space. The names of the actual gas equipment objects
may be concatenated as <Space Name> <GasEquipment
Object Name>. See Specifying Applicable Zone(s) or Space(s)
for more details.
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.
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).
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.
This factor (watts/m\(^{2}\)) 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”.
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”.
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:
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.
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.
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.
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
CO\(_{2}\) emission rate at
11.7 lbs CO\(_{2}\) per
therm. The CO\(_{2}\)
emission rate is provided by U.S. Energy Information
Administration, “Frequently Asked Questions - Environment,
Questions About Environmental Emissions”, http://tonto.eia.doe.gov/ask/environment_faqs.asp#CO2_quantity,
January 2010. The maximum value for this input field is
3.45\(\times\)10\(^{-7}\) m3/s-W.
Allows you to specify a user-defined end-use subcategory,
e.g., “Cooking”, “Clothes Drying”, etc. A new meter for
reporting is created for each unique subcategory (ref: Output:Meter
objects). Subcategories are also reported in the ABUPS table.
If this field is omitted or blank, the equipment will be
assigned to the “General” end-use subcategory. Any text may be
used here to categorize the end-uses in the ABUPS End Uses by
Subcategory table and the LEED Summary table EAp2-4/5
Performance Rating Method Compliance.
An IDF example:
GasEquipment,
DORM ROOMS AND COMMON AREAS GasEq 1, !- Name
DORM ROOMS AND COMMON AREAS, !- Zone or ZoneList or Space or SpaceList Name
Gas Eq Sch, !-Schedule Name
EquipmentLevel, !- Design Level Calculation Method
29287.51, !- Design Level {W}
, !- Power per 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 or ZoneList or Space or SpaceList 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
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.
Field: Zone or
ZoneList or Space or SpaceList Name[LINK]
This field applies this HotWaterEquipment
object to one or more thermal zones or spaces in the building.
The Zone,
Zonelist or SpaceList
options can be used effectively with the watts/area and
watts/person options of the Design Level Calculation Method to
place a varying equipment load at the same density in each
zone or space. The names of the actual hot water equipment
objects may be concatenated as <Space Name>
<HotWaterEquipment Object Name>. See Specifying
Applicable Zone(s) or Space(s) for more details.
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.
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).
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.
This factor (watts/m\(^{2}\)) 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”.
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”.
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:
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.
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.
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.
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 and the LEED Summary table EAp2-4/5
Performance Rating Method Compliance.
IDF Examples:
HotWaterEquipment,
SPACE2-1 HWEq 1, !- Name
SPACE2-1, !- Zone or ZoneList or Space or SpaceList Name
EQUIP-1, !- SCHEDULE Name
EquipmentLevel, !- Design Level calculation method
300, !- Design Level {W}
, !- Power per 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 or ZoneList or Space or SpaceList 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
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.
Field: Zone
or ZoneList or Space or SpaceList Name[LINK]
This field applies this SteamEquipment
object to one or more thermal zones or spaces in the building.
The Zone,
Zonelist or SpaceList
options can be used effectively with the watts/area and
watts/person options of the Design Level Calculation Method to
place a varying equipment load at the same density in each
zone or space. The names of the actual steam equipment objects
may be concatenated as <Space Name> <SteamEquipment
Object Name>. See Specifying Applicable Zone(s) or Space(s)
for more details.
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.
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).
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.
This factor (watts/m\(^{2}\)) 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”.
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”.
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:
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.
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.
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.
Allows you to specify a user-defined end-use subcategory,
e.g., “Cooking”, “Clothes Drying”, etc. A new meter for
reporting is created for each unique subcategory (ref: Output:Meter
objects). Subcategories are also reported in the ABUPS table.
If this field is omitted or blank, the equipment will be
assigned to the “General” end-use subcategory. Any text may be
used here to categorize the end-uses in the ABUPS End Uses by
Subcategory table and the LEED Summary table EAp2-4/5
Performance Rating Method Compliance.
IDF Examples:
SteamEquipment,
SPACE4-1 ElecEq 1, !- Name
SPACE4-1, !- Zone or ZoneList or Space or SpaceList Name
EQUIP-1, !- SCHEDULE Name
EquipmentLevel, !- Design Level calculation method
1050, !- Design Level {W}
, !- Power per 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
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).
This field designates the appropriate meter for the
equipment. Valid fuel types are: None, Electricity,
NaturalGas, Propane, FuelOilNo1, FuelOilNo2, 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 or Space or SpaceList Name[LINK]
This field applies this OtherEquipment
object to one or more thermal zones or spaces in the building.
The Zone,
Zonelist or SpaceList
options can be used effectively with the watts/area and
watts/person options of the Design Level Calculation Method to
place a varying equipment load at the same density in each
zone or space. The names of the actual other equipment objects
may be concatenated as <Space Name> <OtherEquipment
Object Name>. See Specifying Applicable Zone(s) or Space(s)
for more details.
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.
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).
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.
This factor (watts/m\(^{2}\)) 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”.
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”.
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:
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.
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.
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.
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.
Allows you to specify a user-defined end-use subcategory,
e.g., “Cooking”, “Clothes Drying”, etc. A new meter for
reporting is created for each unique subcategory (ref: Output:Meter
objects). Subcategories are also reported in the ABUPS table.
If this field is omitted or blank, the equipment will be
assigned to the “General” end-use subcategory. Any text may be
used here to categorize the end-uses in the ABUPS End Uses by
Subcategory table and in the LEED Summary table EAp2-4/5
Performance Rating Method Compliance.
IDF Examples
OtherEquipment,
BASE-1 OthEq 1, !- Name
Propane, !- Fuel Use Type
BASE-1, !- Zone or ZoneList or Space or SpaceList Name
ALWAYSON, !- SCHEDULE Name
EquipmentLevel, !- Design Level calculation method
6766., !- Design Level {W}
, !- Power per 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
Space or
Zone Electric Equipment Electricity Rate [W][LINK]
Space or
Zone Electric Equipment Electricity Energy [J][LINK]
The electric equipment electric power consumption in Watts
(for power) or Joules (for energy). It is the sum of the
radiant, convective, latent and lost components. Electric
Equipment Electricity Energy is added to the following
electricity meters:
Electricity:Facility
Electricity:Building
Electricity:Zone:<Zone Name>
Electricity:SpaceType:<Space Type Name>
InteriorEquipment:Electricity
InteriorEquipment:Electricity:Zone:<Zone Name>
InteriorEquipment:Electricity:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorEquipment:Electricity
<End-Use Subcategory>:InteriorEquipment:Electricity:Zone:<Zone Name>
<End-Use Subcategory>:InteriorEquipment:Electricity:SpaceType:<Space Type Name>
Space or Zone Gas
Equipment NaturalGas Rate [W][LINK]
Space or Zone Gas
Equipment NaturalGas Energy [J][LINK]
The gas equipment natural gas consumption in Watts (for
power) or Joules (for energy). It is the sum of the radiant,
convective, latent and lost components. Gas Equipment
NaturalGas Energy is added to the following NaturalGas
meters:
NaturalGas:Facility
NaturalGas:Building
NaturalGas:Zone:<Zone Name>
NaturalGas:SpaceType:<Space Type Name>
InteriorEquipment:NaturalGas
InteriorEquipment:NaturalGas:Zone:<Zone Name>
InteriorEquipment:NaturalGas:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorEquipment:NaturalGas
<End-Use Subcategory>:InteriorEquipment:NaturalGas:Zone:<Zone Name>
<End-Use Subcategory>:InteriorEquipment:NaturalGas:SpaceType:<Space Type Name>
Hot Water
Equipment District Heating Rate [W][LINK]
Hot
Water Equipment District Heating Energy [J][LINK]
Space or
Zone Hot Water Equipment District Heating Rate [W][LINK]
Space
or Zone Hot Water Equipment District Heating Energy [J][LINK]
The hot water equipment district heating consumption in
Watts (for power) or Joules (for energy). It is the sum of the
radiant, convective, latent and lost components. Hot Water
Equipment District Heating Energy is added to the following
district heating meters:
DistrictHeating:Facility
DistrictHeating:Building
DistrictHeating:Zone:<Zone Name>
DistrictHeating:SpaceType:<Space Type Name>
InteriorEquipment:DistrictHeating
InteriorEquipment:DistrictHeating:Zone:<Zone Name>
InteriorEquipment:DistrictHeating:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorEquipment:DistrictHeating
<End-Use Subcategory>:InteriorEquipment:DistrictHeating:Zone:<Zone Name>
<End-Use Subcategory>:InteriorEquipment:DistrictHeating:SpaceType:<Space Type Name>
Space or
Zone Steam Equipment District Heating Rate [W][LINK]
Space
or Zone Steam Equipment District Heating Energy [J][LINK]
The steam equipment district heating consumption in Watts
(for power) or Joules (for energy). It is the sum of the
radiant, convective, latent and lost components. Steam
Equipment District Heating Energy is added to the
following:
DistrictHeating:Facility
DistrictHeating:Building
DistrictHeating:Zone:<Zone Name>
DistrictHeating:SpaceType:<Space Type Name>
InteriorEquipment:DistrictHeating
InteriorEquipment:DistrictHeating:Zone:<Zone Name>
InteriorEquipment:DistrictHeating:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorEquipment:DistrictHeating
<End-Use Subcategory>:InteriorEquipment:DistrictHeating:Zone:<Zone Name>
<End-Use Subcategory>:InteriorEquipment:DistrictHeating:SpaceType:<Space Type Name>
Space or Zone Other
Equipment Fuel Energy [J][LINK]
The other equipment fuel consumption in Watts (for power)
or Joules (for energy). It is the sum of the radiant,
convective, latent and lost components. Other Equipment Fuel
Energy is added to the following fuel meters corresponding to
the Fuel Type input. If Fuel Type = None, this energy is not
metered.
Space or Zone
<Type> Equipment Radiant Heating Rate [W][LINK]
Space or Zone
<Type> Equipment Radiant Heating Energy [J][LINK]
The amount of heat gain from equipment that is in the form
of long-wave (thermal) radiation entering the zone. This heat
is absorbed by the inside surfaces of the space or zone
according to an area times long-wave absorptance weighting
scheme.
Space or Zone
<Type> Equipment Total Heating Rate [W][LINK]
Space or Zone
<Type> Equipment Total Heating Energy [J][LINK]
The total heat gain from equipment. It is the sum of the
following components: Total Heat Gain = Radiant Heat Gain +
Convective Heat Gain + Latent Heat Gain. It is also equal to
the power input to the equipment minus any Lost Heat.
This object describes air-cooled electric information
technology equipment (ITE) which has variable power
consumption as a function of loading and temperature.
This field applies this ElectricEquipment:ITE:AirCooled
object to a thermal zone or space in the building. If a Zone
Name is specified and the zone contains more than one Space,
the names of the actual IT equipment objects will be
concatenated as <Space Name> <ITEquipment Object
Name>. See Specifying Applicable Zone(s) or Space(s) for
more details.
This field specifies the method used to calculate the IT
inlet temperature and zone return air temperature.
If FlowFromSystem is chosen, the zone is
assumed to be well-mixed.
If FlowControlWithApproachTemperatures is
chosen, Supply and Return approach temperature should be
defined to indicate the temperature difference due to the air
distribution. The inputs of Air Inlet Connection
Type, Design Recirculation Fraction and
Recirculation Function of Loading and Supply Temperature
Curve Name are ignored. For multiple ITE objects defined
for one zone, the same calculation method should apply. The
FlowControlWithApproachTemperatures only
applies to ITE zones with single duct VAV terminal unit. Other
return air heat gains from window or lights are not allowed
when FlowControlWithApproachTemperatures is
chosen.
The default method is FlowFromSystem.
Field:
Design Power Input Calculation Method[LINK]
This field is a key/choice field that tells which of the
next two fields are filled and is descriptive of the method
for calculating the nominal electric power input to the ITE.
The key/choices are:
Watts/Unit:
With this choice, the design power input will be the
product of Design Level per Unit and Number of Units. (Both of
these fields should be filled.) This is the default.
Watts/Area:
With this choice, the design power input will be a factor
per floor area of the zone. (The Watts per Zone
Floor Area field should be filled).
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”.
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.
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”.
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.
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).
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 m\(^3\)/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).
Specifies the allowable operating conditions for the air
inlet conditions. The available inputs are A1, A2, A3, A4, B,
C, H1, or None. This is used to report the “ITE Air Inlet
Operating Range Exceeded Time.” If None is specified (the
default), then no reporting of time outside allowable
conditions will be done.
The related reporting variables (such as “ITE Air Inlet
Operating Range Exceeded Time”) are based on the following
limits1 on the air inlet
temperature and humidity conditions shown in Table 5:
ElectricEquipment:ITE:AirCooled Air Inlet Limiting
Temperature and Humidity Levels
Specifies the type of connection between the zone and the
ITE air inlet node. The choices are:
AdjustedSupply:
This option is used to apply a recirculation adjustment to
the ITE inlet conditions. If this option is specified, then
the Supply Air Node Name is required and the air inlet
temperature to the ITE will be the current supply air node
temperature adjusted by the current recirculation fraction.
All heat output is added to the zone air heat balance as a
convective gain. AdjustedSupply is the default.
ZoneAirNode:
This option is used if there is no containment and the ITE
air inlet node is at the average zone condition. All heat
output is added to the zone air heat balance as a convective
gain.
RoomAirModel:
This option connects the ITE air inlet and outlet nodes to
a room air model (Ref. RoomAirModelType
and RoomAir:Node). Currently in EnergyPlus, this option has
not been fully implemented. If the user chooses this option,
the program will issue a warning message and this field will
be adjusted to ZoneAirNode.
This field is only used when Air Flow Calculation Method is
FlowFromSystem.
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.
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.
Specifies the node name of the supply air inlet node
service this ITE. If the Air Node Connection Type =
AdjustedSupply ,then this field is required, and the
conditions at this node will be used to determine the ITE air
inlet conditions. This field is also required if reporting of
the Supply Heat Index is desired. Also required if Calculation
Method =
FlowControlWithApproachTemperatures.
Specifies the recirculation fraction for this equipment at
design conditions. This field is used only if the Air Node
Connection Type = AdjustedSupply. The recirculation fraction
is defined as the ratio of recirculated air flow to total air
flow entering the ITE. Recirculation is dependent upon many
factors including rack and containment configuration. The
default is 0.0 (no recirculation). This field is only used
when Air Flow Calculation Method =
FlowFromSystem.
Field:
Recirculation Function of Loading and Supply Temperature Curve
Name[LINK]
The name of a two-variable curve or table lookup object
which modifies the Design Recirculation Fraction as a function
of CPU loading (\(x\)) and
supply air node temperature (\(y\)). This curve (table) should
equal 1.0 at design conditions (CPU loading = 1.0 and Design
Entering Air Temperature). This field is used only if the Air
Node Connection Type = AdjustedSupply. If this curve is left
blank, then the curve is assumed to always equal 1.0. This
field is only used when Air Flow Calculation Method =
FlowFromSystem.
Field:
Design Electric Power Supply Efficiency[LINK]
This field is a decimal number used to specify the
efficiency of the power supply system serving this ITE. The
default is 1.0.
Field:
Electric Power Supply Efficiency Function of Part Load Ratio
Curve Name[LINK]
The name of a single-variable curve or table lookup object
which modifies the electric power supply efficiency as a
function of part load ratio (\(x\)). This curve (table) should
equal 1.0 at the design power consumption (part load ratio =
1.0). If this curve is left blank, then the curve is assumed
to always equal 1.0.
Field:
Fraction of Electric Power Supply Losses to Zone[LINK]
This field is a decimal number between 0.0 and 1.0 and is
used to specify the fraction of the electric power supply
losses which are a heat gain to the zone containing the ITE.
If this value is less than 1.0, the remainder of the losses
are assumed to be lost to the outdoors. The default is
1.0.
This equipment is metered on the Interior Equipment end-use
category for Electricity. This field allows you to specify a
user-defined end-use subcategory for the CPU power
consumption. A new meter for reporting is created for each
unique subcategory (ref: Output:Meter
object). Any text may be used here to categorize the end-uses
in the ABUPS End Uses by Subcategory table and in the LEED
Summary table EAp2-4/5 Performance Rating Method Compliance.
The default is ITE-CPU.
This equipment is metered on the Interior Equipment end-use
category for Electricity. This field allows you to specify a
user-defined end-use subcategory for the fan power
consumption. A new meter for reporting is created for each
unique subcategory (ref: Output:Meter
object). Any text may be used here to categorize the end-uses
in the ABUPS End Uses by Subcategory table and in the LEED
Summary table EAp2-4/5 Performance Rating Method Compliance.
The default is ITE-Fans.
Field:
Electric Power Supply End-Use Subcategory[LINK]
This equipment is metered on the Interior Equipment end-use
category for Electricity. This field allows you to specify a
user-defined end-use subcategory for the electric power supply
power consumption. A new meter for reporting is created for
each unique subcategory (ref: Output:Meter
object). Any text may be used here to categorize the end-uses
in the ABUPS End Uses by Subcategory table and in the LEED
Summary table EAp2-4/5 Performance Rating Method Compliance.
The default is ITE-UPS
The difference of the IT inlet temperature from the AHU
supply air temperature (\({\Delta}T_{\textrm{supply}} =
T_{\textrm{in}}-T_{\textrm{supply}}\)). Either Supply
Temperature Difference or Supply Temperature Difference
Schedule is required if Air Flow Calculation Method is set to
FlowControlWithApproachTemperatures. This
field is ignored when Air Flow Calculation Method is
FlowFromSystem.
Field:
Supply Temperature Difference Schedule[LINK]
The difference schedule of the IT inlet temperature from
the AHU supply air temperature (\({\Delta}T_{\textrm{supply}} =
T_{\textrm{in}}-T_{\textrm{supply}}\)). Either Supply
Temperature Difference or Supply Temperature Difference
Schedule is required if Air Flow Calculation Method is set to
FlowControlWithApproachTemperatures. This
field is ignored when Air Flow Calculation Method is
FlowFromSystem.
The difference of the actual AHU return air temperature to
the IT equipment outlet temperature (\({\Delta}T_{\textrm{return}} =
T_{\textrm{return}}-T_{\textrm{out}}\)). Either Return
Temperature Difference or Return Temperature Difference
Schedule is required if Air Flow Calculation Method is set to
FlowControlWithApproachTemperatures. This
field is ignored when Air Flow Calculation Method is
FlowFromSystem.
Field:
Return Temperature Difference Schedule[LINK]
The difference schedule of the actual AHU return air
temperature to the IT equipment outlet temperature (\({\Delta}T_{\textrm{return}} =
T_{\textrm{return}}-T_{\textrm{out}}\)). Either Return
Temperature Difference or Return Temperature Difference
Schedule is required if Air Flow Calculation Method is set to
FlowControlWithApproachTemperatures. This
field is ignored when Air Flow Calculation Method is
FlowFromSystem.
An IDF example:
ElectricEquipment:ITE:AirCooled,
Data Center Servers, !- Name
Main Zone, !- Zone or Space Name
FlowFromSystem, !- Air Flow Calculation Method
Watts/Unit, !- Design Power Input Calculation Method
500, !- Watts per Unit {W}
200, !- Number of Units
, !- Watts per 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
Another IDF example when Air Flow Calculation Method =
FlowControlWithApproachTemperatures:
ElectricEquipment:ITE:AirCooled,
SmallDataCenter ComputerRoom Elec Equip, !- Name
ComputerRoom ZN, !- Zone or Space Name
FlowControlWithApproachTemperatures, !- Air Flow Calculation Method
Watts/Area, !- Design Power Input Calculation Method
, !- Watts per Unit {W}
, !- Number of Units
430.556416668389, !- Watts per Zone Floor Area {W/m2}
Data Center Operation Schedule, !- Design Power Input Schedule Name
DataCenter Equipment_SCH, !- CPU Loading Schedule Name
Data Center Servers Power fLoadTemp, !- CPU Power Input Function of Loading and Air Temperature Curve Name
0.4, !- Design Fan Power Input Fraction
0.0001, !- Design Fan Air Flow Rate per Power Input {m3/s-W}
Data Center Servers Airflow fLoadTemp, !- Air Flow Function of Loading and Air Temperature Curve Name
ECM FanPower fFlow, !- Fan Power Input Function of Flow Curve Name
15, !- Design Entering Air Temperature {C}
A3, !- Environmental Class
AdjustedSupply, !- Air Inlet Connection Type
, !- Air Inlet Room Air Model Node Name
, !- Air Outlet Room Air Model Node Name
Node 6, !- Supply Air Node Name
0, !- Design Recirculation Fraction
Data Center Recirculation fLoadTemp, !- Recirculation Function of Loading and Supply Temperature Curve Name
0.9, !- Design Electric Power Supply Efficiency
UPS Efficiency fPLR, !- Electric Power Supply Efficiency Function of Part Load Ratio Curve Name
1, !- Fraction of Electric Power Supply Losses to Zone
ITE-CPU, !- CPU End-Use Subcategory
ITE-Fans, !- Fan End-Use Subcategory
ITE-UPS, !- Electric Power Supply End-Use Subcategory
3, !- field Supply Approach Temperature
, !- field Supply Approach Temperature Schedule
-3, !- field Return Approach Temperature
; !- field Return Approach Temperature Schedule
The electric power (or energy) input to the ITE equipment
CPU (total power input less cooling fan power). The ITE CPU
Electricity Energy output is also added to a meter object with
Resource Type = Electricity, End Use Key = InteriorEquipment,
Group Key = Building
(Ref. Output:Meter
object).
Space
or Zone ITE CPU Electricity Rate at Design Inlet Conditions
[W][LINK]
ITE
CPU Electricity Rate at Design Inlet Conditions [W][LINK]
Space
or Zone ITE CPU Electricity Energy at Design Inlet Conditions
[J][LINK]
ITE
CPU Electricity Energy at Design Inlet Conditions [J][LINK]
The electric power (or energy) input to the ITE equipment
CPU (total power input less cooling fan power) if the air
inlet temperature were held at the design condition. May be
used to calculate “IT efficiency”, the ratio of (IT energy
consumed in the facility) / (IT energy that would have been
consumed in the facility if the ITE were held at the reference
temperature).
The electric power (or energy) input to the ITE cooling
fan. The ITE Fan Electricity Energy output is also added to a
meter object with Resource Type = Electricity, End Use Key =
InteriorEquipment, Group Key = Building
(Ref. Output:Meter
object).
Space
or Zone ITE Fan Electricity Rate at Design Inlet Conditions
[W][LINK]
ITE
Fan Electricity Rate at Design Inlet Conditions [W][LINK]
Space
or Zone ITE Fan Electricity Energy at Design Inlet Conditions
[J][LINK]
ITE
Fan Electricity Energy at Design Inlet Conditions [J][LINK]
The electric power (or energy) input to the ITE cooling fan
if the air inlet temperature were held at the design
condition. May be used to calculate “IT efficiency”, the ratio
of (IT energy consumed in the facility) / (IT energy that
would have been consumed in the facility if the ITE were held
at the reference temperature).
The net electric power (or energy) input to the ITE
equipment UPS (total power input less power delivered to ITE).
The ITE UPS Electricity Energy output is also added to a meter
object with Resource Type = Electricity, End Use Key =
InteriorEquipment, Group Key = Building
(Ref. Output:Meter
object).
The ITE CPU Electricity Energy, ITE Fan Electricity Energy,
and ITE UPS Electricity Energy are each included separately in
the following Electricity meters, with their respective
end-use subcategory:
Electricity:Facility
Electricity:Building
Electricity:Zone:<Zone Name>
Electricity:SpaceType:<Space Type Name>
InteriorEquipment:Electricity
InteriorEquipment:Electricity:Zone:<Zone Name>
InteriorEquipment:Electricity:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorEquipment:Electricity
<End-Use Subcategory>:InteriorEquipment:Electricity:Zone:<Zone Name>
<End-Use Subcategory>:InteriorEquipment:Electricity:SpaceType:<Space Type Name>
Space or Zone
ITE UPS Heat Gain to Zone Rate [W][LINK]
The heat gain rate (or energy) to the zone from the UPS and
from the CPU and fans if the ITE. Air Inlet Connection Type is
AdjustedSupply or ZoneAirNode. If RoomAirModel is selected,
then only the heat gain from the UPS is added directly to the
zone air heat balance, the heat gain from the CPU and fans
will be added to the ITE air Outlet Room Air Model Node
Space
or Zone ITE Standard Density Air Volume Flow Rate [m3/s][LINK]
ITE
Standard Density Air Volume Flow Rate [m3/s][LINK]
Reports the average air volume flow rate through the ITE
over the reporting interval. Standard density in EnergyPlus
corresponds to 20\(^\circ\)C
dry bulb, dry air, and nominally adjusted for elevation.
Space
or Zone ITE Current Density Air Volume Flow Rate [m3/s][LINK]
ITE
Current Density Air Volume Flow Rate [m3/s][LINK]
Reports the average air volume flow rate through the ITE
over the reporting interval, calculated using the current
density at the air inlet node.
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. \(\textrm{SHI} = (T_{\textrm{in}} -
T_{\textrm{supply}})/(T_{\textrm{out}}-T_{\textrm{supply}})\)
where \(T_{\textrm{in}}\) is
the dry-bulb temperature of the air entering the ITE, Tout is
the dry-bulb temperature of the air leaving the ITE, and \(T_{\textrm{supply}}\) is the
dry-bulb temperature at the Supply Air Node. If a Supply Air
Node Name is not specified for this object, then this output
will not be reported.
Space
or Zone ITE Any Air Inlet Operating Range Exceeded Time
[hr][LINK]
ITE
Air Inlet Operating Range Exceeded Time [hr][LINK]
Hours when the dry-bulb and/or dewpoint temperature of the
air entering the ITE is outside the range specified by the ITE
Environmental Class.
Space
or Zone ITE Any Air Inlet Dry-Bulb Temperature Above Operating
Range Time [hr][LINK]
ITE
Air Inlet Dry-Bulb Temperature Above Operating Range Time
[hr][LINK]
Hours when the dry-bulb temperature of the air entering the
ITE is above the range specified by the ITE Environmental
Class.
ITE
Air Inlet Dry-Bulb Temperature Difference Above Operating
Range [deltaC][LINK]
The temperature difference (in \(\Delta^\circ\)C) between the air
inlet dry-bulb temperature and the maximum allowable dry-bulb
temperature specified by the ITE Environmental Class. Only
positive values are reported. When the dry-bulb temperature of
the air entering the ITE is below the maximum specified by the
ITE Environmental Class, this output will be zero.
Space
or Zone ITE Any Air Inlet Dry-Bulb Temperature Below Operating
Range Time [hr][LINK]
ITE
Air Inlet Dry-Bulb Temperature Below Operating Range Time
[hr][LINK]
Hours when the dry-bulb temperature of the air entering the
ITE is above the range specified by the ITE Environmental
Class.
ITE
Air Inlet Dry-Bulb Temperature Difference Below Operating
Range [deltaC][LINK]
The temperature difference (in \(\Delta^{\circ}\)C) between the
air inlet dry-bulb temperature and the minimum allowable
dry-bulb temperature specified by the ITE Environmental Class.
Only negative values are reported. When the dry-bulb
temperature of the air entering the ITE is above the minimum
specified by the ITE Environmental Class, this output will be
zero.
Space
or Zone ITE Any Air Inlet Dewpoint Temperature Above Operating
Range Time [hr][LINK]
ITE
Air Inlet Dewpoint Temperature Above Operating Range Time
[hr][LINK]
Hours when the dewpoint temperature of the air entering the
ITE is above the range specified by the ITE Environmental
Class.
ITE
Air Inlet Dewpoint Temperature Difference Above Operating
Range [deltaC][LINK]
The temperature difference (in \(\Delta^{\circ}\)C) between the
air inlet dewpoint temperature and the maximum allowable
dewpoint temperature specified by the ITE Environmental Class.
Only positive values are reported. When the dewpoint
temperature of the air entering the ITE is below the maximum
specified by the ITE Environmental Class, this output will be
zero.
Space
or Zone ITE Any Air Inlet Dewpoint Temperature Below Operating
Range Time [hr][LINK]
ITE
Air Inlet Dewpoint Temperature Below Operating Range Time
[hr][LINK]
Hours when the dewpoint temperature of the air entering the
ITE is above the range specified by the ITE Environmental
Class.
ITE
Air Inlet Dewpoint Temperature Difference Below Operating
Range [deltaC][LINK]
The temperature difference (in \(\Delta^{\circ}\)C) between the
air inlet dewpoint temperature and the minimum allowable
dewpoint temperature specified by the ITE Environmental Class.
Only negative values are reported. When the dewpoint
temperature of the air entering the ITE is above the minimum
specified by the ITE Environmental Class, this output will be
zero.
Space
or Zone ITE Any Air Inlet Relative Humidity Above Operating
Range Time [hr][LINK]
ITE
Air Inlet Relative Humidity Above Operating Range Time
[hr][LINK]
Hours when the relative humidity of the air entering the
ITE is above the range specified by the ITE Environmental
Class.
ITE
Air Inlet Relative Humidity Difference Above Operating Range
[%][LINK]
The temperature difference (in \(\Delta^{\circ}\)C) between the
air inlet relative humidity and the maximum allowable relative
humidity specified by the ITE Environmental Class. Only
positive values are reported. When the relative humidity of
the air entering the ITE is below the maximum specified by the
ITE Environmental Class, this output will be zero.
Space
or Zone ITE Any Air Inlet Relative Humidity Below Operating
Range Time [hr][LINK]
ITE
Air Inlet Relative Humidity Below Operating Range Time
[hr][LINK]
Hours when the relative humidity of the air entering the
ITE is above the range specified by the ITE Environmental
Class.
ITE
Air Inlet Relative Humidity Difference Below Operating Range
[%][LINK]
The difference (in \(\Delta\%\)) between the air inlet
relative humidity and the minimum allowable relative humidity
(RH) specified by the ITE Environmental Class. Only negative
values are reported. When the relative humidity of the air
entering the ITE is above the minimum specified by the ITE
Environmental Class, this output will be zero.
Zone ITE
Adjusted Return Air Temperature [C][LINK]
Return air temperature after adjustment by ITE objects.
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
Field: Zone or
ZoneList or Space or SpaceList Name[LINK]
This field applies this ZoneBaseboard:OutdoorTemperatureControlled
object to one or more thermal zones or spaces in the building.
The names of the actual baseboard heat objects may be
concatenated as <Space Name> <ZoneBaseboard Object
Name>. See Specifying Applicable Zone(s) or Space(s) for
more details.
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.
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.
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.
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.
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.
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.
Allows you to specify a user-defined end-use subcategory,
e.g., “Perimeter Baseboards”, etc. A new meter for reporting
is created for each unique subcategory (ref: Output:Meter
objects). Any text may be used here to categorize the end-uses
in the ABUPS End Uses by Subcategory table and in the LEED
Summary table EAp2-4/5 Performance Rating Method Compliance.
If this field is omitted or blank, the baseboard equipment
will be assigned to the “General” end-use subcategory.
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\(^\circ\)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}
The outdoor temperature controlled baseboard heat option is
assumed to be fueled by electricity. This field is the same as
the Baseboard Total Heating Energy (above) in joules. This
energy is included in the following meters:
Electricity:Facility
Electricity:Building
Electricity:Zone:<Zone Name>
Electricity:SpaceType:<Space Type Name>
InteriorEquipment:Electricity
InteriorEquipment:Electricity:Zone:<Zone Name>
InteriorEquipment:Electricity:SpaceType:<Space Type Name>
<End-Use Subcategory>:InteriorEquipment:Electricity
<End-Use Subcategory>:InteriorEquipment:Electricity:Zone:<Zone Name>
<End-Use Subcategory>:InteriorEquipment:Electricity:SpaceType:<Space Type Name>
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.
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.
These output variables are the amount of heat gain for the
ZoneBaseboard:OutdoorTemperatureControlled
object in Watts (for rate) or Joules. This is determined by
the sum of the radiant and convective heat gains from the
baseboard heat.
Space or Zone
Baseboard Electricity Rate [W][LINK]
Space or Zone
Baseboard Electricity Energy [J][LINK]
The outdoor temperature controlled baseboard heat option is
assumed to be fueled by electricity. This field is the same as
the Baseboard Total Heating Energy (above) in joules.
Space or Zone
Baseboard Radiant Heating Rate [W][LINK]
Space or Zone
Baseboard Radiant Heating Energy [J][LINK]
These output variables are the amount of radiant heat gain
for all ZoneBaseboard:OutdoorTemperatureControlled
objects within the space or zone in Watts (for rate) or
Joules. This is determined by the current heat gain from the
heater to the space or zone and the “Fraction Radiant”
specified in the input. The radiant gains (long wavelength)
are distributed to the surfaces using an area weighting
scheme.
Space or
Zone Baseboard Convective Heating Rate [W][LINK]
Space or
Zone Baseboard Convective Heating Energy [J][LINK]
These output variables are the amount of convective heat
gain for all ZoneBaseboard:OutdoorTemperatureControlled
objects within the space or zone in Watts (for rate) or
Joules. This is determined by the current heat gain from the
heater to the space or zone and the “Fraction Radiant”
specified in input (1-FractionRadiant = FractionConvected).
The convective heat gain is added to the space or zone air
heat balance directly.
Space or Zone
Baseboard Total Heating Rate [W][LINK]
Space or Zone
Baseboard Total Heating Energy [J][LINK]
These output variables are the amount of heat gain for all
ZoneBaseboard:OutdoorTemperatureControlled
objects within the space or zone in Watts (for rate) or
Joules. This is determined by the sum of the radiant and
convective heat gains from the baseboard heat.
The Indoor Swimming Pool object is used to describe the
indoor swimming pools that are exposed to the internal
environment. There are several rules that should be noted
regarding the specification of an indoor pool in EnergyPlus.
First, the pool is linked to a surface that must be a floor.
The pool is assumed to cover the entire floor to which it is
linked. If the pool only covers part of the floor in the
actual building, then the user must break the floor up into
multiple sections.
As pools attempt to achieve a particular water temperature
and have a variety of heat losses, heating equipment is
necessary to maintain the proper setpoint temperature. In
EnergyPlus, the pool itself becomes part of the demand side of
a plant loop with heating equipment on the supply side
providing whatever heating is needed to maintain the desired
temperature. This heating equipment as well as the loop
connections must be entered separately and the input shown in
this section only details what is needed to specify the pool
itself.
There are a variety of rules that limit the application of
indoor swimming pools in EnergyPlus. The following are a list
of these rules:
The pool must reference a valid surface in the input
file. This surface must be a floor and cannot be other surface
types like ceilings, walls, windows, etc.
The pool cannot refer to a surface that is also a
radiant system, ventilated slab, or another pool.
The surface that the pool references must be modeled
using conduction transfer functions (CTF).
The pool cannot utilize movable insulation or have a
heat source or sink associated with it (something used to
model low temperature radiant systems).
The following information is useful for defining and
modeling an indoor pool in EnergyPlus. For more information on
the algorithm used for this model or details on some of the
input parameters, please reference the indoor pool section of
the EnergyPlus Engineering Reference document.
This is the name of the surface (floor) where the pool is
located. Pools are not allowed on any surfaces other than a
floor. For more rules on surfaces that can be used for pools,
please see the information in this section on indoor pools
above.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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
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.
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.
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.
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.
This field denotes the design carbon dioxide generation
rate (m\(^{3}\)/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 (CO\(_{2}\) addition to
the zone air) and a negative value represents a sink rate
(CO\(_{2}\) 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.
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 CO\(_{2}\) 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
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]
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:
This field denotes the full generic contaminant design
generation rate (m\(^{3}\)/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.
This field is the name of the schedule (ref: Schedule) that
modifies the maximum design generation rate (G\(_{f}\)). This fraction between
0.0 and 1.0 is noted as F\(_{G}\) in the above equation.
This field denotes the full generic contaminant design
removal coefficient (m\(^{3}\)/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).
This field is the name of the schedule (ref: Schedule) that
modifies the maximum design generation rate (R\(_{f}\)). This fraction between
0.0 and 1.0 is noted as F\(_{R}\) 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
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.
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:
This field denotes the generic contaminant design
generation coefficient (m\(^{3}\)/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).
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:
This field denotes the full generic contaminant design
generation rate (m\(^{3}\)/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.
This field is the name of the schedule (ref: Schedule) that
modifies the maximum design generation rate (G\(_{f}\)). This fraction between
0.0 and 1.0 is noted as F\(_{G}\) 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}
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:
This field denotes the initial generic contaminant design
emission rate (m\(^{3}\)/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).
This field is the name of the schedule (ref: Schedule) that
modifies the maximum design emission rate (G\(_{f}\)). This fraction between
0.0 and 1.0 is noted as F\(_{G}\) 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.
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}
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.
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:
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.
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
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:
This field is the name of the schedule (ref: Schedule) that
modifies the maximum design removal rate (S\(_{f}\)). This fraction between
0.0 and 1.0 is noted as F\(_{R}\) 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
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:
This field is the name of the schedule (ref: Schedule) that
modifies the maximum design removal rate (S\(_{f}\)). This fraction between
0.0 and 1.0 is noted as F\(_{R}\) 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
Group – Internal Gains (People, Lights, Other internal zone equipment)[LINK]
Not all the influence for energy consumption in the building is due to envelope and ambient conditions. This group of objects describes other internal gains that may come into play (People, Lights, Various Equipment Types).
Specifying Applicable Zone(s) or Space(s)[LINK]
Each internal gains object has a field for “Zone or ZoneList or Space or SpaceList Name”. All internal gains are modeled at the Space level, so each internal gain input object may be expanded to multiple instances of that gain according to the following rules with names constructed using the <Object Name>, <Zone Name>, or <Space Name>. If the resulting concatenated name is greater than 100 characters a warning will be shown and it will be truncated. If the resulting name duplicates another such concatenated name, there will be a severe error and terminate the run. The concatenated name is used when referring to specific instances of internal gains for Output:Variables, Energy Management System (EMS) controls, and Demand Limiting Controls.
will result in one instance of the internal gain, named <Object Name>. The full magnitude of the gain will be applied to the Space using the design level, space floor area, or space occupancy as appropriate.
will result in one instance of the internal gain for each Space in the SpaceList, named <Space Name> <Object Name>. The full magnitude of the gain will be applied to each Space in the SpaceList using the design level, space floor area, or space occupancy as appropriate.
will result in one instance of the internal gain for each Space in the Zone. If there is only one Space in the Zone, then the single instance will be named <Object Name>. If there is more than one Space in the Zone, then each instance will be named <Space Name> <Object Name>. The full magnitude of the gain will be split between the Spaces in the Zone apportioned by the Space floor area or occupancy depending on the input method.
will result in one instance of the internal gain for each Space in each Zone in the ZoneList. Each instance will be named <Space Name> <Object Name>. The full magnitude of the gain will be applied to each Zone in the ZoneList then split between the Spaces in each Zone apportioned by the Space floor area or occupancy depending on the input method.
One exception to this is ElectricEquipment:ITE:AirCooled which only allows Zone or Space Name. If a Zone Name is specified which contains more than one Space, the same rules apply.
As an example, assume that Zone 1 contains Space 1A and Space 1B, and Zone 2 contains only Space 2 (objects are abbreviated for clarity):
People[LINK]
The people statement is used to model the occupant’s effect on the space conditions. The following definition addresses the basic affects as well as providing information that can be used to report the thermal comfort of a group of occupants. The Fanger, Pierce Two-Node, Kansas State University Two-Node, ASHRAE Standard 55 Elevated Air Cooling Effect model, and ASHRAE Standard 55 Ankle Draft Risk thermal comfort models are available in EnergyPlus. A user may select any of these models for each People statement by simply adding the appropriate choice keyword after the air velocity schedule name. Thermal comfort calculations will only be made for people statements that include specific requests for these thermal comfort models. This object also requires input of carbon dioxide generation rate based on people activity level for zone carbon dioxide simulations.
Inputs[LINK]
Field: Name[LINK]
The name of the People object. Must be unique across all People objects.
Field: Zone or ZoneList or Space or SpaceList Name[LINK]
This field applies this People object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the people/area and area/person options of the Number of People Calculation Method to place a varying number of people at the same density in each zone or space. The names of the actual people objects may be concatenated as <Space Name> <People Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.
When multiple people objects are defined for the same zone, and they have different SET, PMV, Heat/Cold Stress Temperature Threshold, a warning message will be produced to caution users that zone-level resilience metrics results will only be meaningful if each zone has at most one People object defined. This is especially true for SET Degree-Hours and Discomfort-Weighted Exceedance Hours tables. In the SET Degree-Hour case, this is because in the calculation of zone level Heating/Cooling SET Degree-Hours, if multiple People objects are defined for one zone, EnergyPlus will only use the SET of one People object to compute the zone level SET Degree-Hours, and neglecting the SET of other people object defined in the same zone. As a result, when multiple people objects with different SET, PMV, or Heat/Cold Stress Temperature are linked to one zone, the corresponding zone-level resilience metrics results might be invalid.
Field: Number of People Schedule Name[LINK]
This field is the name of the schedule (ref: Schedules) that modifies the number of people parameter (see Number of People Calculation Method and related fields). The schedule values can be any positive number. The actual number of people in a zone as defined by this statement is the product of the number of people field and the value of the schedule specified by name in this field.
Field: Number of People Calculation Method[LINK]
This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal number of occupants (people) in the Zone. The key/choices are:
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.)
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).
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/m\(^{2}\)) 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 (m\(^{2}\)/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. Default value is 0.30.
Field: Sensible Heat Fraction[LINK]
The user can use this field to specify a fixed sensible fraction for the heat gain due to this PEOPLE object. Normally the program calculates the sensible/latent split; this field gives the user control over this split. This field is autocalculated: if the field is blank or autocalculate, the program will calculate the sensible/latent split; if a value is entered, it will be used as the sensible fraction of the current total heat gain.
Field: Activity Level Schedule Name[LINK]
This field is the name of the schedule that determines the amount of heat gain per person in the zone under design conditions. This heat gain impacts the basic zone heat balance as well as the modeling of thermal comfort. This value is modified somewhat based on a correlation to account for variations in space temperature. The schedule values may be any positive number and the units for this parameter is Watts per person. This schedule represents the total heat gain per person including convective, radiant, and latent. An internal algorithm is used to determine what fraction of the total is sensible and what fraction is latent. Then, the sensible portion is divided into radiant and convective portions using the value specified for Fraction Radiant (above). See the Engineering Reference document for more details.
Values for activity level can range anywhere from approximately 100-150 Watts per person for most office activities up to over 900 Watts per person for strenuous physical activities such as competitive wrestling. The following table (Table 1) is based on Table [table:wind-speed-profile-coefficients-ashrae] from the 2005 ASHRAE Handbook of Fundamentals, page 8.6. In addition to the information from the ASHRAE HOF, there is an added column of values in W/Person such as necessary for the activity level schedule values. This column uses the standard adult body surface area of 1.8 m\(^{2}\) to multiply the activity levels in W/m\(^{2}\) that are used in the table. Warnings are produced when the activity level schedule values fall outside normal ranges. Having too low or too high values can also skew thermal comfort reporting values.
Field: Carbon Dioxide Generation Rate[LINK]
This numeric input field specifies carbon dioxide generation rate per person with units of m3/s-W. The total carbon dioxide generation rate from this object is:
Number of People * People Schedule * People Activity * Carbon Dioxide Generation Rate. The default value is 3.82E-8 m3/s-W (obtained from ASHRAE Standard 62.1-2007 value at 0.0084 cfm/met/person over the general adult population). The maximum value can be 10 times the default value.
Field: Cold Stress Temperature Threshold[LINK]
This field is used in the calculation of hours of safety for cold events, which is defined as the longest duration (number of hours), starting from the beginning time of the risk period (e.g., the start time of a power outage), to not below a certain temperature threshold (specified in this field). If not specified, 60F (or 15.56C) will be used as the default temperature threshold.
Field: Heat Stress Temperature Threshold[LINK]
This field is used in the calculation of hours of safety for hot events, which is defined as the longest duration (number of hours), starting from the beginning time of the risk period (e.g., the start time of a power outage), to not above a certain temperature threshold (specified in this field). If not specified, 86F (or 30C) will be used as the default temperature threshold.
Field: Enable ASHRAE 55 comfort warnings[LINK]
This field accepts either “Yes” or “No” as values. When “Yes” is specified, warnings are generated when the space conditions are outside of the ASHRAE 55 comfort range as discussed in the sections that follow titled “Simplified ASHRAE 55-2004 Graph Related Outputs” and “Simplified ASHRAE 55 Warnings.” The default is not to provide these warnings so if you want to know if your space is outside this comfort range you must set this field to Yes.
Field: Mean Radiant Temperature Calculation Type[LINK]
This field specifies the type of Mean Radiant Temperature (MRT) calculation the user wishes to use for the thermal comfort model. At the present time, there are three options for MRT calculation type: zone averaged, surface weighted, and a list of angle factors. The default calculation is “ZoneAveraged” and is used if field is left blank. 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 ComfortViewFactorAngles object (see next object description) is intended to give the user this opportunity.
Field: Surface Name/Angle Factor List Name[LINK]
This field is only valid when the user selects “SurfaceWeighted” or “AngleFactor” for the MRT calculation type (see the previous input field description). In the case of “SurfaceWeighted”, the field is the name of a surface within the 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 “SurfaceWeighted” MRT calculation method is the average of the temperature of the surface specified in this field and the “zone averaged” MRT (see the Mean Radiant Temperature calculation type field above). In the case of “AngleFactor”, the field is the name of a ComfortViewFactorAngles input object defined elsewhere. This field is required when the previous field is set to “SurfaceWeighted” or “AngleFactor” and is set to run one of the following thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 or AnkleDraftASH55.
Field: Work Efficiency Schedule Name[LINK]
This field is the name of the schedule that determines the efficiency of energy usage within the human body that will be used for thermal comfort calculations. Note that all energy produced by the body is assumed to be converted to heat for the zone heat balance calculation. A value of zero corresponds to all of the energy produced in the body being converted to heat. A value of unity corresponds to all of the energy produced in the body being converted to mechanical energy. The values for this parameter defined in the schedule must be between 0.0 and 1.0. Any value greater than zero will result in a reduction of heat that impacts the thermal comfort energy balance of a person within the space, resulting in PMV results appearing lower than expected. Ensure that if this value is non-zero, the base activity level is chosen to ensure that the net activity converted to heat and zone conditions are sufficient to maintain thermal comfort. This field is required to run one of the following thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 or AnkleDraftASH55. If a schedule is listed here but no thermal comfort model is selected, then a warning message will be produced and this schedule will be listed as unused in the error file.
Field: Clothing Insulation Calculation Method[LINK]
This field is a key/choice field that tells which of the next two fields are filled and is descriptive of the method for calculating the clothing insulation value of occupants (people) in the Zone. The key/choices are:
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.)
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.
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.
Field: Clothing Insulation Calculation Method Schedule Name[LINK]
This field specifies which clothing insulation method (ClothingInsulationSchedule or DynamicClothingModelASHRAE55) to use at a particular time of the day. A schedule value of 1 means the ClothingInsulationSchedule method, and 2 means the DynamicClothingModelASHRAE55 method. This field is only required when the “Clothing Insulation Calculation Method” field is set to CalculationMethodSchedule. If this field is left blank, the specified clothing insulation calculation method will be used and not changed during the simulation.
Field: Clothing Insulation Schedule Name[LINK]
This field is the name of the schedule that defines the amount of clothing being worn by a typical zone occupant during various times in the simulation period. The choice from the Clothing Insulation Calculation Method field should be “ClothingInsulationSchedule”. This parameter must be a positive real number and has units of Clo. Typical values for Clo can be seen in the ASHRAE 2009 HOF Table 7, page 9.8 (for clothing ensembles) and Table [table:window-modeling-options], page 9.9 (for garment values) ) or www.cbe.berkeley.edu/comforttool/. This field is required to run one of the following thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 or AnkleDraftASH55. If a schedule is listed here but no thermal comfort model is selected, then a warning message will be produced and this schedule will be listed as unused in the error file.
Field: Air Velocity Schedule Name[LINK]
This field is the name of the schedule that approximates the amount of air movement in the space as a function of time throughout the simulation period. The user has control over this parameter through the schedule that requires the individual numbers in the schedule to be positive real numbers having units of meters per second. This field is required to run one of the following thermal comfort models: Fanger, Pierce, KSU, CoolingEffectASH55 or AnkleDraftASH55. If a schedule is listed here but no thermal comfort model is selected, then a warning message will be produced and this schedule will be listed as unused in the error file.
Field: Thermal Comfort Model Type (up to 7 allowed)[LINK]
The final one to five fields are optional and are intended to trigger various thermal comfort models within EnergyPlus. By entering the keywords Fanger, Pierce, KSU, AdaptiveASH55, AdaptiveCEN15251, CoolingEffectASH55, and AnkleDraftASH55, the user can request the Fanger, Pierce Two-Node, Kansas State UniversityTwo-Node, the adaptive comfort models of the ASHRAE Standard 55 and CEN Standard 15251, ASHRAE Standard 55 Elevated Air Cooling Effect model, and ASHRAE Standard 55 Ankle Draft Risk model results for this particular people statement. Detailed descriptions and requirements of the seven models as listed below.
Fanger’s Comfort model is applied to calculate related thermal comfort metrics. Fanger Model PMV, PPD, and Clothing Surface Temperature are calculated and reported as each time step. Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, and Air Velocity Schedule Name.
The Pierce Two-Node model is applied to calculate related thermal comfort metrics. Pierce Model Effective Temperature PMV, Standard Effective Temperature PMV, Discomfort Index, Thermal Sensation Index, and Standard Effective Temperature are calculated and reported as each time step.Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, and Air Velocity Schedule Name.
The KSU Two-Node Model is applied to calculate related thermal comfort metrics. KSU Model Thermal Sensation Vote is calculated and reported as each time step. Note that the KSU model is computationally intensive and may noticeably increase the execution time of the simulation. Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, and Air Velocity Schedule Name.
Adaptive Comfort Model Based on ASHRAE Standard 55-2010 is applied to calculate related thermal comfort metrics. ASHRAE 55 Adaptive Model 90% Acceptability Status, 80% Acceptability Status, Running Average Outdoor Air Temperature, and the Adaptive Model Temperature are calculated and reported as each time step. AdaptiveASH55 is only applicable when the running average outdoor air temperature for the past 7 days is between 10.0 and 33.5C.
Adaptive Comfort Model Based on European Standard EN15251-2007 is applied to calculate related thermal comfort metrics. CEN 15251 Adaptive Model Category I/II/II Status, Running Average Outdoor Air Temperature, and the Adaptive Model Temperature are calculated and reported as each time step. AdaptiveCEN15251 is only applicable when the running average outdoor air temperature for the past 30 days is between 10.0 and 30.0C.
ASHRAE 55-2017 Elevated Air Speed Cooling Effect Model is applied to calculate related thermal comfort metrics. Elevated Air Speed Cooling Effect, Cooling Effect Adjusted PMV, and Cooling Effect Adjusted PPD are calculated and reported as each time step. Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, and Air Velocity Schedule Name.
ASHRAE 55-2017 Ankle Draft Risk Model is applied to calculate related thermal comfort metrics. Zone Thermal Comfort ASHRAE 55 Ankle Draft PPD is calculated and reported as each time step. Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, Air Velocity Schedule Name, and Ankle Level Air Velocity Schedule Name. Ankle draft PPD calculations are only applicable for relative air velocity is below 0.2 m/s, and the subject’s metabolic rate and clothing level should be kept below 1.3 met and 0.7 clo. PPD at ankle draft will be set to -1.0 if if these conditions are not met.
For descriptions of the thermal comfort calculations, see the Engineering Reference document.
Note that since up to seven models may be specified, the user may opt to have EnergyPlus calculate the thermal comfort for people identified with this people statement using all seven models if desired.
Field: Ankle Level Air Velocity Schedule Name[LINK]
This field is the name of the schedule that approximates the amount of air movement at the occupants’ ankle level (0.1 m above floor level) as a function of time throughout the simulation period. The user has control over this parameter through the schedule that requires the individual numbers in the schedule to be positive real numbers having units of meters per second. This field is required to run the AnkleDraftASH55 thermal comfort model. If a schedule is listed here but no thermal comfort model is selected, then a warning message will be produced and this schedule will be listed as unused in the error file.
The following IDF example allows for a maximum of 31 people with scheduled occupancy of “Office Occupancy”, 60% radiant using an Activity Schedule of “Activity Sch”. The example allows for thermal comfort reporting.
A simpler example, without using the thermal comfort reporting option:
And with the sensible fraction specified:
Global People Object:
Outputs[LINK]
People objects have output variables for individual objects and for space and zone totals.
People specific outputs include:
Zone,Average,People Occupant Count []
Zone,Sum,People Radiant Heating Energy [J]
Zone,Average,People Radiant Heating Rate [W]
Zone,Sum,People Convective Heating Energy [J]
Zone,Average,People Convective Heating Rate [W]
Zone,Sum,People Sensible Heating Energy [J]
Zone,Average,People Sensible Heating Rate [W]
Zone,Sum,People Latent Gain Energy [J]
Zone,Average,People Latent Gain Rate [W]
Zone,Sum,People Total Heating Energy [J]
Zone,Average,People Total Heating Rate [W]
Zone,Average,Space People Occupant Count []
Zone,Sum,Space People Radiant Heating Energy [J]
Zone,Average,Space People Radiant Heating Rate [W]
Zone,Sum,Space People Convective Heating Energy [J]
Zone,Average,Space People Convective Heating Rate [W]
Zone,Sum,Space People Sensible Heating Energy [J]
Zone,Average,Space People Sensible Heating Rate [W]
Zone,Sum,Space People Latent Gain Energy [J]
Zone,Average,Space People Latent Gain Rate [W]
Zone,Sum,Space People Total Heating Energy [J]
Zone,Average,Space People Total Heating Rate [W]
Zone,Average,Zone People Occupant Count []
Zone,Sum,Zone People Radiant Heating Energy [J]
Zone,Average,Zone People Radiant Heating Rate [W]
Zone,Sum,Zone People Convective Heating Energy [J]
Zone,Average,Zone People Convective Heating Rate [W]
Zone,Sum,Zone People Sensible Heating Energy [J]
Zone,Average,Zone People Sensible Heating Rate [W]
Zone,Sum,Zone People Latent Gain Energy [J]
Zone,Average,Zone People Latent Gain Rate [W]
Zone,Sum,Zone People Total Heating Energy [J]
Zone,Average,Zone People Total Heating Rate [W]
Zone,Average,People Air Temperature [C]
Zone,Average,People Air Relative Humidity [%]
Zone,Average,Zone Thermal Comfort Mean Radiant Temperature [C]
Zone,Average,Zone Thermal Comfort Operative Temperature [C]
Zone,Average,Zone Thermal Comfort Fanger Model PMV []
Zone,Average,Zone Thermal Comfort Fanger Model PPD [%]
Zone,Average,Zone Thermal Comfort Clothing Surface Temperature [C]
Zone,Average,Zone Thermal Comfort Pierce Model Effective Temperature PMV []
Zone,Average,Zone Thermal Comfort Pierce Model Standard Effective Temperature PMV []
Zone,Average,Zone Thermal Comfort Pierce Model Discomfort Index []
Zone,Average,Zone Thermal Comfort Pierce Model Thermal Sensation Index []
Zone,Average,Zone Thermal Comfort Pierce Model Standard Effective Temperature [C]
Zone,Average,Zone Thermal Comfort KSU Model Thermal Sensation Index []
Zone,Average,Zone Thermal Comfort ASHRAE 55 Adaptive Model 80% Acceptability Status []
Zone,Average,Zone Thermal Comfort ASHRAE 55 Adaptive Model 90% Acceptability Status []
Zone,Average,Zone Thermal Comfort ASHRAE 55 Adaptive Model Running Average Outdoor Air Temperature [C]
Zone,Average,Zone Thermal Comfort ASHRAE 55 Adaptive Model Temperature [C]
Zone,Average,Zone Thermal Comfort CEN 15251 Adaptive Model Category I Status []
Zone,Average,Zone Thermal Comfort CEN 15251 Adaptive Model Category II Status []
Zone,Average,Zone Thermal Comfort CEN 15251 Adaptive Model Category III Status
Zone,Average,Zone Thermal Comfort CEN 15251 Adaptive Model Running Average Outdoor Air Temperature [C]
Zone,Average,Zone Thermal Comfort CEN 15251 Adaptive Model Temperature [C]
Zone,Average,Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect [C]
Zone,Average,Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect Adjusted PMV []
Zone,Average,Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect Adjusted PPD []
Zone,Average,Zone Thermal Comfort ASHRAE 55 Ankle Draft PPD []
It should be noted that if a user is trying to output the Standard Effective Temperature (SET) that the Pierce two-node model must be selected. This variable is calculated as part of the Pierce model and can be seen in the output by requesting Zone Thermal Comfort Pierce Model Standard Effective Temperature.
People Occupant Count [][LINK]
This field is the number of people for this PEOPLE object during the timestep in question.
People Radiant Heating Rate [W][LINK]
People Radiant Heating Energy [J][LINK]
These output variables are the amount of radiant heat gain for this People object in Watts (for rate) or Joules. This is determined by the current sensible heat gain from people to the zone and the “Fraction Radiant” specified in the input. The radiant gains from people are distributed to the surfaces using an area weighting scheme.
People Convective Heating Rate [W][LINK]
People Convective Heating Energy [J][LINK]
These output variables are the amount of convective heat gain for this People object in Watts (for rate) or Joules. This is determined by the current sensible heat gain from people to the zone and the “Fraction Radiant” specified in input. Note that the radiant and convective gains should add up to the sensible heat gain from people. The convective heat gain from people is added to the zone air heat balance directly.
People Latent Gain Rate [W][LINK]
People Latent Gain Energy [J][LINK]
These output variables are the amount of latent heat gain for this People object in Watts (for rate) or Joules. This amount is based on the number of people in the space as well as the total amount of energy produced by a typical person defined by the activity schedule in the input. An internal algorithm is used to determine what fraction of the total is sensible and what fraction is latent. Details about this split are included in the Engineering Reference document.
People Sensible Heating Rate [W][LINK]
People Sensible Heating Energy [J][LINK]
These output variables are the amount of sensible heat gain for this People object in Watts (for rate) or Joules. This amount is based on the number of people in the space as well as the total amount of energy produced by a typical person defined by the activity schedule in the input. An internal algorithm (described in the Engineering Reference document) is used to determine what fraction of the total is sensible and what fraction is latent. The sensible plus the latent heat gain from people equals the total gain specified in the input.
People Total Heating Rate [W][LINK]
People Total Heating Energy [J][LINK]
These output variables are the total amount of heat gain for this People object in Watts (for rate) or Joules. This is derived from the activity level times the number of occupants.
People Air Temperature [C][LINK]
This output variable represents the zone air temperature based on the Fanger thermal comfort model. If there is a ZoneControl:Thermostat:ThermalComfort object specified and the thermal zone is occupied, then the value of “People Air Temperature” is determined based on the thermal comfort that satisfies the thermal comfort setpoint PMV value specified; otherwise, it is set to average zone air temperature.
People Air Relative Humidity [%][LINK]
This output variable represents the zone air relative humidity based on the Fanger thermal comfort model. If there is a ZoneControl:Thermostat:ThermalComfort object specified and the thermal zone is occupied, then the value of “People Air Relative Humidity” is determined from the mean zone air temperature and zone air humidity ratio that satisfies the thermal comfort setpoint PMV value specified; otherwise, it is calculated from the zone air temperature and humidity ratio averaged over the time step.
Space or Zone People Occupant Count [][LINK]
This field is the total number of people within the space or zone during the timestep in question.
Space or Zone People Radiant Heating Rate [W][LINK]
Space or Zone People Radiant Heating Energy [J][LINK]
These output variables are the amount of radiant heat gain from people within the space or zone in Watts (for rate) or Joules. This is determined by the current sensible heat gain from people to the space or zone and the “Fraction Radiant” specified in the input. The radiant gains from people are distributed to the surfaces using an area weighting scheme.
Space or Zone People Convective Heating Rate [W][LINK]
Space or Zone People Convective Heating Energy [J][LINK]
These output variables are the amount of convective heat gain from people within the space or zone in Watts (for rate) or Joules. This is determined by the current sensible heat gain from people to the space or zone and the “Fraction Radiant” specified in input. Note that the radiant and convective gains should add up to the sensible heat gain from people. The convective heat gain from people is added to the space or zone air heat balance directly.
Space or Zone People Latent Gain Rate [W][LINK]
Space or Zone People Latent Gain Energy [J][LINK]
These output variables are the amount of latent heat gain from people within the space or zone in Watts (for rate) or Joules. This amount is based on the number of people in the space as well as the total amount of energy produced by a typical person defined by the activity schedule in the input. An internal algorithm is used to determine what fraction of the total is sensible and what fraction is latent. Details about this split are included in the Engineering Reference document.
Space or Zone People Sensible Heating Rate [W][LINK]
Space or Zone People Sensible Heating Energy [J][LINK]
These output variables are the amount of sensible heat gain from people within the space or zone in Watts (for rate) or Joules. This amount is based on the number of people in the space as well as the total amount of energy produced by a typical person defined by the activity schedule in the input. An internal algorithm (described in the Engineering Reference document) is used to determine what fraction of the total is sensible and what fraction is latent. The sensible plus the latent heat gain from people equals the total gain specified in the input.
Space or Zone People Total Heating Rate [W][LINK]
Space or Zone People Total Heating Energy [J][LINK]
These output variables are the total amount of heat gain from people within the space or zone in Watts (for rate) or Joules. Derived from the activity level times the number of occupants, this is summed for each people object within a zone.
Zone Thermal Comfort Mean Radiant Temperature [C][LINK]
This output variable is the mean radiant temperature used in the thermal comfort calculations. This value is computed according to the “MRT Calculation Type” specified in the PEOPLE object. If a high temperature radiant system is present in the zone, this value will be adjusted according to the current heater operation and the “Fraction of radiant energy incident on people” specified in the HIGH TEMP RADIANT SYSTEM object.
Zone Thermal Comfort Operative Temperature [C][LINK]
This output variable is the operative temperature as defined by the thermal comfort operations. Specifically, it is the average of the thermal comfort mean radiant temperature and the zone air temperature.
Note for all Thermal Comfort reporting: Though the published values for thermal comfort “vote” have a discrete scale (e.g. –3 to +3 or –4 to +4), the calculations in EnergyPlus are carried out on a continuous scale and, thus, reporting may be “off the scale” with specific conditions encountered in the space. This is not necessarily an error in EnergyPlus – rather a different approach that does not take the “limits” of the discrete scale values into account.
Zone Thermal Comfort Fanger Model PMV [][LINK]
This field is the “predicted mean vote” (PMV) calculated using the Fanger thermal comfort model. Details on the equations used to calculate the Fanger PMV are shown in the EnergyPlus Engineering Reference. If the zone in question is currently being controlled using a thermostat object, then the value of the PMV is determined by using the air temperature and humidity that is calculated at the system time step; otherwise, if the zone is uncontrolled, the PMV is determined using the zone air temperature and humidity that is averaged over the zone time step.
Zone Thermal Comfort Fanger Model PPD [%][LINK]
This field is the “predicted percentage of dissatisfied” (PPD) calculated using the Fanger thermal comfort model. Details on the equations used to calculate the Fanger PPD are shown in the EnergyPlus Engineering Reference. If the zone in question is currently being controlled using a thermostat object, then the value of the PPD is determined by using the air temperature and humidity that is calculated at the system time step; otherwise, if the zone is uncontrolled, the PPD is determined using the zone air temperature and humidity that is averaged over the zone time step.
Zone Thermal Comfort Clothing Surface Temperature [C][LINK]
This output variable is the calculation of the clothing surface temperature using the Fanger thermal comfort model.
Zone Thermal Comfort Pierce Model Effective Temperature PMV [][LINK]
This field is the “predicted mean vote” (PMV) calculated using the effective temperature and the Pierce two-node thermal comfort model.
Zone Thermal Comfort Pierce Model Standard Effective Temperature PMV [][LINK]
This field is the “predicted mean vote” (PMV) calculated using the “standard” effective temperature and the Pierce two-node thermal comfort model.
Zone Thermal Comfort Pierce Model Discomfort Index [][LINK]
This field is the “discomfort index” calculated using the the Pierce two-node thermal comfort model.
Zone Thermal Comfort Pierce Model Thermal Sensation Index [][LINK]
This field is the “thermal sensation index” (PMV) calculated using the Pierce two-node thermal comfort model.
Zone Thermal Comfort Pierce Model Standard Effective Temperature [C][LINK]
This field is the “standard effective temperature” (SET) calculated using the Pierce two-node thermal comfort model. Note that if a user wishes to report the Pierce Model SET that it must be done using the Pierce two-node model and the user must select “Pierce” as one of the Thermal Comfort model types as shown above in the input syntax for the People statement.
Zone Thermal Comfort KSU Model Thermal Sensation Vote [][LINK]
This field is the “thermal sensation vote” (TSV) calculated using the KSU two-node thermal comfort model.
Zone Thermal Comfort ASHRAE 55 Adaptive Model 90% Acceptability Status [][LINK]
This field is to report whether the operative temperature falls into the 90% acceptability limits of the adaptive comfort in ASHRAE 55-2010. A value of 1 means within (inclusive) the limits, a value of 0 means outside the limits, and a value of -1 means not applicable (when unoccupied or running average outdoor temp is outside the range of 10.0 to 33.5C).
Zone Thermal Comfort ASHRAE 55 Adaptive Model 80% Acceptability Status [][LINK]
This field is to report whether the operative temperature falls into the 80% acceptability limits of the adaptive comfort in ASHRAE 55-2010. A value of 1 means within (inclusive) the limits, a value of 0 means outside the limits, and a value of -1 means not applicable (when unoccupied or running average outdoor temp is outside the range of 10.0 to 33.5C).
Zone Thermal Comfort ASHRAE 55 Adaptive Model Running Average Outdoor Air Temperature [C][LINK]
This field reports the mean monthly outdoor air temperature, an input parameter for the ASHRAE-55 adaptive comfort model. This can be computed in two ways. If the .stat file is provided for the simulation, this field will reflect the monthly daily average temperature.
If the .epw file is used, the field reports the simple running average of the daily average outdoor dry-bulb temperatures of the previous 30 days.
Zone Thermal Comfort ASHRAE 55 Adaptive Model Temperature [C][LINK]
This field reports the ideal indoor operative temperature, or comfort temperature, as determined by the ASHRAE-55 adaptive comfort model. The 80% acceptability limits for indoor operative temperature are defined as no greater than 3.5\(^\circ\)C from the adaptive comfort temperature. The 90% acceptability limits are defined as no greater than 2.5\(^\circ\)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.5\(^\circ\)C).
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.0\(^\circ\)C).
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.0\(^\circ\)C).
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.0\(^\circ\)C).
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.0\(^\circ\)C).
Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect[LINK]
This field is the calculated Cooling Effect of the elevated air speed in degree celsius. It is the value that, when subtracted equally from both the average air temperature and the mean radiant temperature, yields the same SET under still air as in the first SET calculation under elevated air speed.
Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect Adjusted PMV[LINK]
This field is the “predicted mean vote” (PMV) calculated using the Fanger PMV model, adjusted by the ASHRAE 55 Elevated Air Speed Cooling Effect. The Cooling Effect adjusted PMV for an environment with elevated average air speed is calculated using the adjusted average air temperature, the adjusted radiant temperature, and still air (0.1 m/s).
Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect Adjusted PPD[LINK]
This field is the “predicted percentage of dissatisfied” (PPD) calculated using the Fanger PMV-PPD model, adjusted by the ASHRAE 55 Elevated Air Speed Cooling Effect. The Cooling Effect adjusted PPD for an environment with elevated average air speed is calculated using the adjusted average air temperature, the adjusted radiant temperature, and still air (0.1 m/s).
Zone Thermal Comfort ASHRAE 55 Ankle Draft PPD[LINK]
This field is the “ppredicted percentage of dissatisfied” (PPD) on draft at ankle level. It is used as the metric to evaluate the ankle draft risk as a function of PMV and air speed at the ankle level (0.1 m).
Outputs[LINK]
The following output variables are all based on whether the humidity ratio and the operative temperature is within the region shown in ASHRAE Standard 55-2004 in Figure 5.2.1.1. For these outputs the operative temperature is simplified to be the average of the air temperature and the mean radiant temperature. For summer, the 0.5 Clo level is used and, for winter, the 1.0 Clo level is used. The graphs below are based on the following tables which extend the ASHRAE values to zero humidity ratio.
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.
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.6\(^\circ\)C to 21.7\(^\circ\)C)—heating setpoints may need to be nearer 22.2\(^\circ\)C (72\(^\circ\)F) than 21.1\(^\circ\)C (70\(^\circ\)F).
Unoccupied heating setpoint should be nearer 16.7\(^\circ\)C (62\(^\circ\)F) rather than 12.8\(^\circ\)C (55\(^\circ\)F) 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.4\(^\circ\)C (85\(^\circ\)F) rather than 40.0\(^\circ\)C (104\(^\circ\)F) 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 enclosure mean radiant temperature and the temperature of the surface that the person is near and uses this value as the mean radiant temperature when calculating thermal comfort.
The third option is for the user to more explicitly position the person within the space by defining the angle factors from the person to the various surfaces in the same radiant enclosure. This option requires the user to list the surfaces that the person can see from a radiation standpoint and also define the angle (or view) factor for each surface. 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 is ignored.
Field: Surface <#> Name[LINK]
This field is the name of a surface in the radiant enclosure seen by the person. All surfaces listed should be in the same radiant enclosure. This should also be the same radiant enclosure as the People instance which references this ComfortViewFactorAngles object. If not, a warning will be issued, but the simulation will proceed with the specified surfaces.
Field: Angle Factor <#>[LINK]
This field is the fraction that this surface contributes to the total mean radiant temperature. This can be thought of as a weighting factor for this surface and the actual mean radiant temperature used in the thermal comfort model is simply the sum of all angle factors multiplied by the corresponding inside surface temperature, weighted by the surface emissivity. The sum of all angle factors within any angle factor list must equal unity, otherwise the program will not accept the input as valid.
Note that the Surface Name/Angle Factor pair is extensible to accommodate as many surfaces as required.
An example IDF with an electric low temperature radiant system is shown below.
Lights[LINK]
The Lights statement allows you to specify information about a zone’s electric lighting system, including design power level and operation schedule, and how the heat from lights is distributed thermally.
A zone may have multiple Lights statements. For example, one statement may describe the general lighting in the zone and another the task lighting. Or you can use multiple Lights statements for a zone that has two or more general lighting systems that differ in design level, schedule, etc.
Inputs[LINK]
Field: Name[LINK]
The name of the Lights object.
Field: Zone or ZoneList or Space or SpaceList Name[LINK]
This field applies this Lights object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method to place a varying lighting load at the same density in each zone or space. The names of the actual lights objects may be concatenated as <Space Name> <Lights Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.
Field: Schedule Name[LINK]
The name of the schedule that modifies the lighting power design level (see Design Level Calculation Method field and related subsequent fields). The schedule values can be any positive number. The electrical input for lighting in a particular timestep is the product of the design level and the value of this schedule in that timestep. If the design level is the maximum lighting power input the schedule should contain values between 0.0 and 1.0.
Field: Design Level Calculation Method[LINK]
This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal lighting level in the Zone. The key/choice options are:
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.)
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).
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/m\(^{2}\)) 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:
\[f_{\textrm{convected}} = 1.0 - (\textrm{Return Air Fraction} + \textrm{Fraction Radiant} + \textrm{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 4 and Figure 4). (However, see the field “Return Air Fraction Is Calculated from Plenum Temperature,” below, for an approach to modeling the case where Return Air Fraction is caused by conduction between a luminaire that is in contact with a return-air plenum.)
Field: Fraction Radiant[LINK]
The fraction of heat from lights that goes into the zone as long-wave (thermal) radiation. The program calculates how much of this radiation is absorbed by the inside surfaces of the zone according the area times thermal absorptance product of these surfaces.
Field: Fraction Visible[LINK]
The fraction of heat from lights that goes into the zone as visible (short-wave) radiation. The program calculates how much of this radiation is absorbed by the inside surfaces of the zone according the area times solar absorptance product of these surfaces.
Approximate values of Return Air Fraction, Fraction Radiant and Fraction Visible are given in Table 4 for overhead fluorescent lighting for a variety of luminaire configurations. The data is based on ASHRAE 1282-RP “Lighting Heat Gain Distribution in Buildings” by Daniel E. Fisher and Chanvit Chantrasrisalai.
1 Recessed, Parabolic Louver, Non-Vented, T8 - Ducted 0.27 0.27 0.21 0.25 5 Recessed, Direct/Indirect, T8 - Ducted 0.27 0.22 0.17 0.34
1 Recessed, Parabolic Louver, Non-Vented, T8 - Half Typical Supply Airflow Rate 0.45 0.30 0.22 0.03 3 Recessed, Parabolic Louver, Vented, T8 - Half Typical Supply Airflow Rate 0.43 0.25 0.21 0.11 5 Recessed, Direct/Indirect, T8 - Half Typical Supply Airflow Rate 0.43 0.27 0.18 0.12
1 Recessed, Parabolic Louver, Non-Vented, T8 - Half Typical Supply Airflow Rate 0.10 0.16 0.20 0.54 3 Recessed, Parabolic Louver, Vented, T8 - Half Typical Supply Airflow Rate 0.11 0.15 0.19 0.55 5 Recessed, Direct/Indirect, T8 - Half Typical Supply Airflow Rate 0.04 0.13 0.16 0.67
: Approximate values of Return Air Fraction, Fraction Radiant and Fraction Visible for overhead fluorescent lighting for different luminaire configurations.
Field: Fraction Replaceable[LINK]
This field defines the daylighting control for the LIGHTS object.
If Daylighting:Controls is specified for the space or zone, this field is used as an on/off flag for dimming controls. If set to 0.0, the lights are not dimmed by the daylighting controls. If set to 1.0, the lights are allowed to be dimmed by the applicable daylighting control. If daylighting controls are operating in the space or zone, all of the applicable Lights objects with a Fraction Replaceable greater than zero will be reduced by a multiplicative factor that accounts for how much the electric lighting is lowered due to daylighting (ref. Daylighting Lighting Power Multiplier).
Field: End-Use Subcategory[LINK]
Allows you to specify a user-defined end-use subcategory, e.g., “Task Lights”, “Hall Lights”, etc. A new meter for reporting is created for each unique subcategory (ref: Output:Meter objects). Subcategories are also reported in the ABUPS table. If this field is omitted or blank, the lights will be assigned to the “General” end-use subcategory. Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and the LEED EAp2-4/5. Performance Rating Method Compliance table.
Field: Return Air Fraction Calculated from Plenum Temperature[LINK]
Accepts values Yes or No (the default). Yes is for advanced used only. In this case the program will calculate the return air fraction by assuming that it is due to conduction of some of the light heat into the zone’s return air plenum and that the amount of the conduction depends on the plenum air temperature. A Yes value should only be used for luminaires that are recessed and non-vented, as shown in Figure 4.
The value you enter for the Return Air Fraction field will be ignored and you can enter, for fluorescent lighting, Fraction Radiant = 0.37 and Fraction Visible = 0.18, as indicated in Table 4.
This feature requires that the coefficients described below be determined from measurements or detailed calculations since they are very sensitive to the luminaire type, lamp type, thermal resistance between fixture and plenum, etc.
If “Return Air Fraction Is Calculated from Plenum Temperature” = Yes, the return air fraction is calculated each timestep from the following empirical correlation:
\[(\rm{Return Air Fraction})_{\rm{calculated}} = C_{1} - C_{2} \times T_{\rm{plenum}}\]
where T\(_{\rm{plenum}}\) is the previous-time-step value of the return plenum air temperature (C),
and C\(_{1}\) and C\(_{2}\) 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 \(f_{\rm{convected}}\) by a scale factor such that
\[(\rm{Return Air Fraction})_{\rm{calculated}} + (\rm{Fraction Radiant})_{\rm{modified}} + (f_{\rm{convected}})_{\rm{modified}} + (\rm{Fraction Visible})_{\rm{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 C\(_{1}\) in the equation for (Return Air Fraction)\(_{calculated}\).
Field: Return Air Fraction Function of Plenum Temperature Coefficient 2[LINK]
The coefficient C\(_{2}\) in the equation for (Return Air Fraction)\(_{calculated}\). Its units are 1/\(^\circ\)C.
Field: Return Air Heat Gain Node Name[LINK]
Name of the return air node for this heat gain. If left blank, it defaults to the first return air node for the zone containing this Lights object. Leave blank when using a ZoneList name.
Field:Exhaust Air Heat Gain Node Name[LINK]
Name of the exhaust air node for this heat gain. If left blank, no heat gain from return air fraction will be added to the zone exhaust node. When the exhaust node name is entered, the return air heat gain will be shared by both return and exhaust nodes. The equipment can draw air from the exhaust node, but the inlet air properties is combined properties with mixing mass flow rates of both nodes and added lights heat gain.
An IDF example:
Global Lights Object:
Outputs[LINK]
Lights objects have output variables for individual objects and for space and zone totals.
A related output is Daylighting Lighting Power Multiplier.
Zone,Average,Lights Electricity Rate [W]
Zone,Sum,Lights Radiant Heat Gain [J]
Zone,Average,Lights Radiant Heating Rate [W]
Zone,Sum,Lights Visible Radiation Heating Energy [J]
Zone,Average,Lights Visible Radiation Heating Rate [W]
Zone,Sum,Lights Convective Heating Energy [J]
Zone,Average,Lights Convective Heating Rate [W]
Zone,Sum,Lights Return Air Heating Energy [J]
Zone,Average,Lights Return Air Heating Rate [W]
Zone,Sum,Lights Total Heating Energy [J]
Zone,Average,Lights Total Heating Rate [W]
Zone,Sum,Lights Electricity Energy [J]
Zone,Average,Space Lights Electricity Rate [W]
Zone,Average,Space Lights Electricity Energy [J]
Zone,Sum,Space Lights Radiant Heating Energy [J]
Zone,Average,Space Lights Radiant Heating Rate [W]
Zone,Sum,Space Lights Visible Radiation Heating Energy [J]
Zone,Average,Space Lights Visible Radiation Heating Rate [W]
Zone,Sum,Space Lights Convective Heating Energy [J]
Zone,Average,Space Lights Convective Heating Rate [W]
Zone,Sum,Space Lights Return Air Heating Energy [J]
Zone,Average,Space Lights Return Air Heating Rate [W]
Zone,Sum,Space Lights Total Heating Energy [J]
Zone,Average,Space Lights Total Heating Rate [W]
Zone,Sum,Space Lights Electricity Energy [J]
Zone,Average,Zone Lights Electricity Rate [W]
Zone,Average,Zone Lights Electricity Energy [J]
Zone,Sum,Zone Lights Radiant Heating Energy [J]
Zone,Average,Zone Lights Radiant Heating Rate [W]
Zone,Sum,Zone Lights Visible Radiation Heating Energy [J]
Zone,Average,Zone Lights Visible Radiation Heating Rate [W]
Zone,Sum,Zone Lights Convective Heating Energy [J]
Zone,Average,Zone Lights Convective Heating Rate [W]
Zone,Sum,Zone Lights Return Air Heating Energy [J]
Zone,Average,Zone Lights Return Air Heating Rate [W]
Zone,Sum,Zone Lights Total Heating Energy [J]
Zone,Average,Zone Lights Total Heating Rate [W]
Zone,Sum,Zone Lights Electricity Energy [J]
Lights Radiant Heating Rate [W][LINK]
Lights Radiant Heating Energy [J][LINK]
The amount of heat gain from lights that is in the form of long-wave (thermal) radiation entering the zone. This heat is absorbed by the inside surfaces of the zone according to an area times long-wave absorptance weighting scheme.
Lights Visible Radiation Heating Rate [W][LINK]
Lights Visible Radiation Heating Energy [J][LINK]
The amount of heat gain from lights that is in the form of visible (short-wave) radiation entering the zone. This heat is absorbed by the inside surfaces of the zone according to an area times short-wave absorptance weighting scheme.
Lights Convective Heating Rate [W][LINK]
Lights Convective Heating Energy [J][LINK]
The amount of heat gain from lights that is convected to the zone air.
Lights Return Air Heating Rate [W][LINK]
Lights Return Air Heating Energy [J][LINK]
The amount of heat gain from lights that goes into the zone’s return air (and, therefore, does not directly contribute to the zone load). If the zone has no return air system or the zone’s air system is off, this heat will be added to the zone air.
Lights Total Heating Rate [W][LINK]
Lights Total Heating Energy [J][LINK]
The total heat gain from lights. It is the sum of the following four outputs, i.e., Total Heat Gain \(=\) Return Air Heat Gain \(+\) Radiant Heat Gain \(+\) Visible Heat Gain \(+\) Convective Heat Gain. It is also equal to the electrical input to the lights.
Lights Electricity Rate [W][LINK]
The electric power input for the lights.
Lights Electricity Energy [J][LINK]
The lighting electrical consumption including ballasts, if present. This will have the same value as Lights Total Heating Energy (above).
The energy amount is also included in the following Electricity meters:
Space or Zone Lights Radiant Heating Rate [W][LINK]
Space or Zone Lights Radiant Heating Energy [J][LINK]
The amount of heat gain from all lights in the space or zone that is in the form of long-wave (thermal) radiation entering the space or zone. This heat is absorbed by the inside surfaces of the space or zone according to an area times long-wave absorptance weighting scheme.
Space or Zone Lights Visible Radiation Heating Rate [W][LINK]
Space or Zone Lights Visible Radiation Heating Energy [J][LINK]
The amount of heat gain from all lights in the space or zone that is in the form of visible (short-wave) radiation entering the space or zone. This heat is absorbed by the inside surfaces of the space or zone according to an area times short-wave absorptance weighting scheme.
Space or Zone Lights Convective Heating Rate [W][LINK]
Space or Zone Lights Convective Heating Energy [J][LINK]
The amount of heat gain from all lights in the space or zone that is convected to the space or zone air.
Space or Zone Lights Return Air Heating Rate [W][LINK]
Space or Zone Lights Return Air Heating Energy [J][LINK]
The amount of heat gain from all lights in the space or zone that goes into the space or zone’s return air (and, therefore, does not directly contribute to the space or zone load). If the space or zone has no return air system or the space or zone’s air system is off, this heat will be added to the space or zone air.
Space or Zone Lights Total Heating Rate [W][LINK]
Space or Zone Lights Total Heating Energy [J][LINK]
The total heat gain from all lights in the space or zone. It is the sum of the following four outputs, i.e., Total Heat Gain = Return Air Heat Gain + Radiant Heat Gain + Visible Heat Gain + Convective Heat Gain. It is also equal to the electrical input to the lights.
Space or Zone Lights Electricity Rate [W][LINK]
Space or Zone Lights Electricity Energy [J][LINK]
The electric power input for all lights in the space or zone. This will have the same value as Zone Lights Total Heating Rate or Energy (above).
ElectricEquipment[LINK]
The object models equipment in the zone which consumes electricity, such as computers, televisions, and cooking equipment, also known as “plug loads.” All of the energy consumed by the equipment becomes a heat gain in the zone or is lost (exhausted) as specified below.
Inputs[LINK]
Field: Name[LINK]
The name of the ElectricEquipment object.
Field: Zone or ZoneList or Space or SpaceList Name[LINK]
This field applies this ElectricEquipment object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method to place a varying equipment load at the same density in each zone or space. The names of the actual electric equipment objects may be concatenated as <Space Name> <ElectricEquipment Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.
Field: Schedule Name[LINK]
This field is the name of the schedule that modifies the design level parameter for electric equipment (see Design Level Calculation Method field and related subsequent fields). The schedule values can be any positive number. The actual electrical input for equipment in a zone as defined by this statement is the product of the design level field and the value of the schedule specified by name in this field.
Field: Design Level Calculation Method[LINK]
This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal electric equipment level in the Zone. The key/choices are:
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.)
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).
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/m\(^{2}\)) 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:
\[f_{\rm{convected}} = 1.0 - (\rm{Fraction Latent} + \rm{Fraction Radiant} + \rm{Fraction Lost})\]
You will get an error message if Fraction Latent + Fraction Radiant + Fraction Lost exceeds 1.0.
Field: Fraction Latent[LINK]
This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of latent heat given off by electric equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by electric equipment to give the amount of latent energy produced by the electric equipment. This energy affects the moisture balance within the zone.
Field: Fraction Radiant[LINK]
This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of long-wave radiant heat being given off by electric equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by electric equipment to give the amount of long wavelength radiation gain from electric equipment in a zone.
Field: Fraction Lost[LINK]
This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of “lost” heat being given off by electric equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by electric equipment to give the amount of heat which is “lost” and does not impact the zone energy balances. This might correspond to electrical energy converted to mechanical work or heat that is vented to the atmosphere.
Field: End-Use Subcategory[LINK]
Allows you to specify a user-defined end-use subcategory, e.g., “Computers”, “Copy Machines”, etc. A new meter for reporting is created for each unique subcategory (ref: Output:Meter objects). Subcategories are also reported in the ABUPS table. If this field is omitted or blank, the equipment will be assigned to the “General” end-use subcategory. Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and the LEED Summary table EAp2-4/5. Performance Rating Method Compliance.
An IDF example:
Global ElectricEquipment example:
GasEquipment[LINK]
The object models equipment in the zone which consumes natural gas, such as cooking equipment or a gas fireplace. All of the energy consumed by the equipment becomes a heat gain in the zone or is lost (exhausted) as specified below.
Inputs[LINK]
Field: Name[LINK]
The name of the GasEquipment object.
Field: Zone or ZoneList or Space or SpaceList Name[LINK]
This field applies this GasEquipment object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method to place a varying equipment load at the same density in each zone or space. The names of the actual gas equipment objects may be concatenated as <Space Name> <GasEquipment Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.
Field: Schedule Name[LINK]
This field is the name of the schedule that modifies the design level parameter for gas equipment (see Design Level Calculation Method field and related subsequent fields). The schedule values can be any positive number. The actual energy input for gas equipment in a zone as defined by this statement is the product of the design level field and the value of the schedule specified by name in this field.
Field: Design Level Calculation Method[LINK]
This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal gas equipment level in the Zone. The key/choices are:
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.)
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).
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/m\(^{2}\)) 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:
\[f_{convected} = 1.0 - (\rm{Fraction Latent} + \rm{Fraction Radiant} + \rm{Fraction Lost})\]
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 CO\(_{2}\) emission rate at 11.7 lbs CO\(_{2}\) per therm. The CO\(_{2}\) emission rate is provided by U.S. Energy Information Administration, “Frequently Asked Questions - Environment, Questions About Environmental Emissions”, http://tonto.eia.doe.gov/ask/environment_faqs.asp#CO2_quantity, January 2010. The maximum value for this input field is 3.45\(\times\)10\(^{-7}\) m3/s-W.
Field: End-Use Subcategory[LINK]
Allows you to specify a user-defined end-use subcategory, e.g., “Cooking”, “Clothes Drying”, etc. A new meter for reporting is created for each unique subcategory (ref: Output:Meter objects). Subcategories are also reported in the ABUPS table. If this field is omitted or blank, the equipment will be assigned to the “General” end-use subcategory. Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and the LEED Summary table EAp2-4/5 Performance Rating Method Compliance.
An IDF example:
Global Gas Equipment example:
HotWaterEquipment[LINK]
The object models hot water equipment in the zone which consumes district heating, such as cooking equipment or process loads. All of the energy consumed by the equipment becomes a heat gain in the zone or is lost (exhausted) as specified below. This object consumes district heating energy directly and does not cause a load on a hot water plant loop or water heater. For domestic hot water uses, such as sinks and showers, see WaterUse:Equipment.
Inputs[LINK]
Field: Name[LINK]
The name of the HotWaterEquipment object.
Field: Zone or ZoneList or Space or SpaceList Name[LINK]
This field applies this HotWaterEquipment object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method to place a varying equipment load at the same density in each zone or space. The names of the actual hot water equipment objects may be concatenated as <Space Name> <HotWaterEquipment Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.
Field: Schedule Name[LINK]
This field is the name of the schedule that modifies the design level parameter for hot water equipment (see Design Level Calculation Method field and related subsequent fields). The schedule values can be any positive number. The actual energy input for hot water equipment in a zone as defined by this statement is the product of the design level field and the value of the schedule specified by name in this field.
Field: Design Level Calculation Method[LINK]
This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal hot water equipment level in the Zone. The key/choices are:
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.)
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).
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/m\(^{2}\)) 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:
\[f_{\rm{convected}} = 1.0 - (\rm{Fraction Latent} + \rm{Fraction Radiant} + \rm{Fraction Lost})\]
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 and the LEED Summary table EAp2-4/5 Performance Rating Method Compliance.
IDF Examples:
Global Hot Water Equipment example:
SteamEquipment[LINK]
The object models steam equipment in the zone which consumes district heating, such as cooking equipment or process loads. All of the energy consumed by the equipment becomes a heat gain in the zone or is lost (exhausted) as specified below. This object consumes district heating energy directly and does not cause a load on a steam plant loop.
Inputs[LINK]
Field: Name[LINK]
The name of the SteamEquipment object.
Field: Zone or ZoneList or Space or SpaceList Name[LINK]
This field applies this SteamEquipment object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method to place a varying equipment load at the same density in each zone or space. The names of the actual steam equipment objects may be concatenated as <Space Name> <SteamEquipment Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.
Field: Schedule Name[LINK]
This field is the name of the schedule that modifies the design level parameter for steam equipment (see Design Level Calculation Method field and related subsequent fields). The schedule values can be any positive number. The actual energy input for steam equipment in a zone as defined by this statement is the product of the design level field and the value of the schedule specified by name in this field.
Field: Design Level Calculation Method[LINK]
This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal steam equipment level in the Zone. The key/choices are:
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.)
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).
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/m\(^{2}\)) 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:
\[f_{\rm{convected}} = 1.0 - (\rm{Fraction Latent} + \rm{Fraction Radiant} + \rm{Fraction Lost})\]
You will get an error message if Fraction Latent + Fraction Radiant + Fraction Lost exceeds 1.0.
Field: Fraction Latent[LINK]
This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of latent heat given off by steam equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by steam equipment to give the amount of latent energy produced by the steam equipment. This energy affects the moisture balance within the zone.
Field: Fraction Radiant[LINK]
This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of long-wave radiant heat being given off by steam equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by steam equipment to give the amount of long wavelength radiation gain from steam equipment in a zone.
Field: Fraction Lost[LINK]
This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of “lost” heat being given off by steam equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by steam equipment to give the amount of heat which is “lost” and does not impact the zone energy balances. This might correspond to input energy converted to mechanical work or heat that is vented to the atmosphere.
Field: End-Use Subcategory[LINK]
Allows you to specify a user-defined end-use subcategory, e.g., “Cooking”, “Clothes Drying”, etc. A new meter for reporting is created for each unique subcategory (ref: Output:Meter objects). Subcategories are also reported in the ABUPS table. If this field is omitted or blank, the equipment will be assigned to the “General” end-use subcategory. Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and the LEED Summary table EAp2-4/5 Performance Rating Method Compliance.
IDF Examples:
OtherEquipment[LINK]
Other Equipment object is provided as an additional source for heat gains or losses directly to the zone with a fuel type that is configurable. If a fuel type is specified, the energy is attributed to the appropriate end use. Otherwise, a loss can be entered by putting a negative value into the Design Level field and this object will not have an end-use component – gains or losses do not show up in the bottom energy lines (except as influencing overall zone gains or losses).
Inputs[LINK]
Field: Name[LINK]
The name of the OtherEquipment object.
Field: Fuel Type[LINK]
This field designates the appropriate meter for the equipment. Valid fuel types are: None, Electricity, NaturalGas, Propane, FuelOilNo1, FuelOilNo2, Diesel, Gasoline, Coal, 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 or Space or SpaceList Name[LINK]
This field applies this OtherEquipment object to one or more thermal zones or spaces in the building. The Zone, Zonelist or SpaceList options can be used effectively with the watts/area and watts/person options of the Design Level Calculation Method to place a varying equipment load at the same density in each zone or space. The names of the actual other equipment objects may be concatenated as <Space Name> <OtherEquipment Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.
Field: Schedule Name[LINK]
This field is the name of the schedule that modifies the design level parameter for other equipment (see Design Level Calculation Method field and related subsequent fields). The schedule values can be any positive number. The actual energy input for other equipment in a zone as defined by this statement is the product of the design level field and the value of the schedule specified by name in this field.
Field: Design Level Calculation Method[LINK]
This field is a key/choice field that tells which of the next three fields are filled and is descriptive of the method for calculating the nominal other equipment level in the Zone. The key/choices are:
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.)
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).
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/m\(^{2}\)) 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:
\[f_{\rm{convected}} = 1.0 - (\rm{Fraction Latent} + \rm{Fraction Radiant} + \rm{Fraction Lost})\]
You will get an error message if \(\rm{Fraction Latent} + \rm{Fraction Radiant} + \rm{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 other equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by other equipment to give the amount of latent energy produced by the other equipment. This energy affects the moisture balance within the zone.
Field: Fraction Radiant[LINK]
This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of long-wave radiant heat being given off by other equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by other equipment to give the amount of long wavelength radiation gain from other equipment in a zone.
Field: Fraction Lost[LINK]
This field is a decimal number between 0.0 and 1.0 and is used to characterize the amount of “lost” heat being given off by other equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by other equipment to give the amount of heat which is “lost” and does not impact the zone energy balances. This might correspond to input energy converted to mechanical work or heat that is vented to the atmosphere.
Field: Carbon Dioxide Generation Rate[LINK]
This numeric input field specifies carbon dioxide generation rate with units of m3/s-W. The default value of 0.0 assumes the equipment is fully vented to outdoors. The maximum value for this input field is 3.45E-7 m3/s-W.
Field: End-Use Subcategory[LINK]
Allows you to specify a user-defined end-use subcategory, e.g., “Cooking”, “Clothes Drying”, etc. A new meter for reporting is created for each unique subcategory (ref: Output:Meter objects). Subcategories are also reported in the ABUPS table. If this field is omitted or blank, the equipment will be assigned to the “General” end-use subcategory. Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and in the LEED Summary table EAp2-4/5 Performance Rating Method Compliance.
IDF Examples
Internal Gain Equipment Outputs[LINK]
Each type of equipment object has output variables for individual objects and for space and zone totals.
Electric Equipment
Zone,Average,Electric Equipment Electricity Rate [W]
Zone,Sum,Electric Equipment Electricity Energy [J]
Zone,Sum,Electric Equipment Radiant Heating Energy [J]
Zone,Average,Electric Equipment Radiant Heating Rate [W]
Zone,Sum,Electric Equipment Convective Heating Energy [J]
Zone,Average,Electric Equipment Convective Heating Rate [W]
Zone,Sum,Electric Equipment Latent Gain Energy [J]
Zone,Average,Electric Equipment Latent Gain Rate [W]
Zone,Sum,Electric Equipment Lost Heat Energy [J]
Zone,Average,Electric Equipment Lost Heat Rate [W]
Zone,Sum,Electric Equipment Total Heating Energy [J]
Zone,Average,Electric Equipment Total Heating Rate [W]
Zone,Average,Space Electric Equipment Electricity Rate [W]
Zone,Sum,Space Electric Equipment Electricity Energy [J]
Zone,Sum,Space Electric Equipment Radiant Heating Energy [J]
Zone,Average,Space Electric Equipment Radiant Heating Rate [W]
Zone,Sum,Space Electric Equipment Convective Heating Energy [J]
Zone,Average,Space Electric Equipment Convective Heating Rate [W]
Zone,Sum,Space Electric Equipment Latent Gain Energy [J]
Zone,Average,Space Electric Equipment Latent Gain Rate [W]
Zone,Sum,Space Electric Equipment Lost Heat Energy [J]
Zone,Average,Space Electric Equipment Lost Heat Rate [W]
Zone,Sum,Space Electric Equipment Total Heating Energy [J]
Zone,Average,Space Electric Equipment Total Heating Rate [W]
Zone,Average,Zone Electric Equipment Electricity Rate [W]
Zone,Sum,Zone Electric Equipment Electricity Energy [J]
Zone,Sum,Zone Electric Equipment Radiant Heating Energy [J]
Zone,Average,Zone Electric Equipment Radiant Heating Rate [W]
Zone,Sum,Zone Electric Equipment Convective Heating Energy [J]
Zone,Average,Zone Electric Equipment Convective Heating Rate [W]
Zone,Sum,Zone Electric Equipment Latent Gain Energy [J]
Zone,Average,Zone Electric Equipment Latent Gain Rate [W]
Zone,Sum,Zone Electric Equipment Lost Heat Energy [J]
Zone,Average,Zone Electric Equipment Lost Heat Rate [W]
Zone,Sum,Zone Electric Equipment Total Heating Energy [J]
Zone,Average,Zone Electric Equipment Total Heating Rate [W]
Gas Equipment
Zone,Average,Gas Equipment 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,Space Gas Equipment Gas Rate [W]
Zone,Sum,Space Gas Equipment Gas Energy [J]
Zone,Sum,Space Gas Equipment Radiant Heating Energy [J]
Zone,Average,Space Gas Equipment Radiant Heating Rate [W]
Zone,Sum,Space Gas Equipment Convective Heating Energy [J]
Zone,Average,Space Gas Equipment Convective Heating Rate [W]
Zone,Sum,Space Gas Equipment Latent Gain Energy [J]
Zone,Average,Space Gas Equipment Latent Gain Rate [W]
Zone,Sum,Space Gas Equipment Lost Heat Energy [J]
Zone,Average,Space Gas Equipment Lost Heat Rate [W]
Zone,Sum,Space Gas Equipment Total Heating Energy [J]
Zone,Average,Space Gas Equipment Total Heating Rate [W]
Zone,Average,Zone Gas Equipment 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,Space Hot Water Equipment District Heating Rate [W]
Zone,Sum,Space Hot Water Equipment District Heating Energy [J]
Zone,Sum,Space Hot Water Equipment Radiant Heating Energy [J]
Zone,Average,Space Hot Water Equipment Radiant Heating Rate [W]
Zone,Sum,Space Hot Water Equipment Convective Heating Energy [J]
Zone,Average,Space Hot Water Equipment Convective Heating Rate [W]
Zone,Sum,Space Hot Water Equipment Latent Gain Energy [J]
Zone,Average,Space Hot Water Equipment Latent Gain Rate [W]
Zone,Sum,Space Hot Water Equipment Lost Heat Energy [J]
Zone,Average,Space Hot Water Equipment Lost Heat Rate [W]
Zone,Sum,Space Hot Water Equipment Total Heating Energy [J]
Zone,Average,Space Hot Water Equipment Total Heating Rate [W]
Zone,Average,Zone Hot Water Equipment District Heating Rate [W]
Zone,Sum,Zone Hot Water Equipment District Heating Energy [J]
Zone,Sum,Zone Hot Water Equipment Radiant Heating Energy [J]
Zone,Average,Zone Hot Water Equipment Radiant Heating Rate [W]
Zone,Sum,Zone Hot Water Equipment Convective Heating Energy [J]
Zone,Average,Zone Hot Water Equipment Convective Heating Rate [W]
Zone,Sum,Zone Hot Water Equipment Latent Gain Energy [J]
Zone,Average,Zone Hot Water Equipment Latent Gain Rate [W]
Zone,Sum,Zone Hot Water Equipment Lost Heat Energy [J]
Zone,Average,Zone Hot Water Equipment Lost Heat Rate [W]
Zone,Sum,Zone Hot Water Equipment Total Heating Energy [J]
Zone,Average,Zone Hot Water Equipment Total Heating Rate [W]
Steam Equipment
Zone,Average,Steam Equipment District Heating Rate [W]
Zone,Sum,Steam Equipment District Heating Energy [J]
Zone,Sum,Steam Equipment Radiant Heating Energy [J]
Zone,Average,Steam Equipment Radiant Heating Rate [W]
Zone,Sum,Steam Equipment Convective Heating Energy [J]
Zone,Average,Steam Equipment Convective Heating Rate [W]
Zone,Sum,Steam Equipment Latent Gain Energy [J]
Zone,Average,Steam Equipment Latent Gain Rate [W]
Zone,Sum,Steam Equipment Lost Heat Energy [J]
Zone,Average,Steam Equipment Lost Heat Rate [W]
Zone,Sum,Steam Equipment Total Heating Energy [J]
Zone,Average,Steam Equipment Total Heating Rate [W]
Zone,Average,Space Steam Equipment District Heating Rate [W]
Zone,Sum,Space Steam Equipment District Heating Energy [J]
Zone,Sum,Space Steam Equipment Radiant Heating Energy [J]
Zone,Average,Space Steam Equipment Radiant Heating Rate [W]
Zone,Sum,Space Steam Equipment Convective Heating Energy [J]
Zone,Average,Space Steam Equipment Convective Heating Rate [W]
Zone,Sum,Space Steam Equipment Latent Gain Energy [J]
Zone,Average,Space Steam Equipment Latent Gain Rate [W]
Zone,Sum,Space Steam Equipment Lost Heat Energy [J]
Zone,Average,Space Steam Equipment Lost Heat Rate [W]
Zone,Sum,Space Steam Equipment Total Heating Energy [J]
Zone,Average,Space Steam Equipment Total Heating Rate [W]
Zone,Average,Zone Steam Equipment District Heating Rate [W]
Zone,Sum,Zone Steam Equipment District Heating Energy [J]
Zone,Sum,Zone Steam Equipment Radiant Heating Energy [J]
Zone,Average,Zone Steam Equipment Radiant Heating Rate [W]
Zone,Sum,Zone Steam Equipment Convective Heating Energy [J]
Zone,Average,Zone Steam Equipment Convective Heating Rate [W]
Zone,Sum,Zone Steam Equipment Latent Gain Energy [J]
Zone,Average,Zone Steam Equipment Latent Gain Rate [W]
Zone,Sum,Zone Steam Equipment Lost Heat Energy [J]
Zone,Average,Zone Steam Equipment Lost Heat Rate [W]
Zone,Sum,Zone Steam Equipment Total Heating Energy [J]
Zone,Average,Zone Steam Equipment Total Heating Rate [W]
Other Equipment
Zone,Average,Other Equipment Fuel Rate [W]
Zone,Sum,Other Equipment Fuel Energy [J]
Zone,Sum,Other Equipment Radiant Heating Energy [J]
Zone,Average,Other Equipment Radiant Heating Rate [W]
Zone,Sum,Other Equipment Convective Heating Energy [J]
Zone,Average,Other Equipment Convective Heating Rate [W]
Zone,Sum,Other Equipment Latent Gain Energy [J]
Zone,Average,Other Equipment Latent Gain Rate [W]
Zone,Sum,Other Equipment Lost Heat Energy [J]
Zone,Average,Other Equipment Lost Heat Rate [W]
Zone,Sum,Other Equipment Total Heating Energy [J]
Zone,Average,Other Equipment Total Heating Rate [W]
Zone,Sum,Space Other Equipment Radiant Heating Energy [J]
Zone,Average,Space Other Equipment Radiant Heating Rate [W]
Zone,Sum,Space Other Equipment Convective Heating Energy [J]
Zone,Average,Space Other Equipment Convective Heating Rate [W]
Zone,Sum,Space Other Equipment Latent Gain Energy [J]
Zone,Average,Space Other Equipment Latent Gain Rate [W]
Zone,Sum,Space Other Equipment Lost Heat Energy [J]
Zone,Average,Space Other Equipment Lost Heat Rate [W]
Zone,Sum,Space Other Equipment Total Heating Energy [J]
Zone,Average,Space Other Equipment Total Heating Rate [W]
Zone,Sum,Zone Other Equipment Radiant Heating Energy [J]
Zone,Average,Zone Other Equipment Radiant Heating Rate [W]
Zone,Sum,Zone Other Equipment Convective Heating Energy [J]
Zone,Average,Zone Other Equipment Convective Heating Rate [W]
Zone,Sum,Zone Other Equipment Latent Gain Energy [J]
Zone,Average,Zone Other Equipment Latent Gain Rate [W]
Zone,Sum,Zone Other Equipment Lost Heat Energy [J]
Zone,Average,Zone Other Equipment Lost Heat Rate [W]
Zone,Sum,Zone Other Equipment Total Heating Energy [J]
Zone,Average,Zone Other Equipment Total Heating Rate [W]
Electric Equipment Electricity Rate [W][LINK]
Electric Equipment Electricity Energy [J][LINK]
Space or Zone Electric Equipment Electricity Rate [W][LINK]
Space or Zone Electric Equipment Electricity Energy [J][LINK]
The electric equipment electric power consumption in Watts (for power) or Joules (for energy). It is the sum of the radiant, convective, latent and lost components. Electric Equipment Electricity Energy is added to the following electricity meters:
Gas Equipment NaturalGas Rate [W][LINK]
Gas Equipment NaturalGas Energy [J][LINK]
Space or Zone Gas Equipment NaturalGas Rate [W][LINK]
Space or Zone Gas Equipment NaturalGas Energy [J][LINK]
The gas equipment natural gas consumption in Watts (for power) or Joules (for energy). It is the sum of the radiant, convective, latent and lost components. Gas Equipment NaturalGas Energy is added to the following NaturalGas meters:
Hot Water Equipment District Heating Rate [W][LINK]
Hot Water Equipment District Heating Energy [J][LINK]
Space or Zone Hot Water Equipment District Heating Rate [W][LINK]
Space or Zone Hot Water Equipment District Heating Energy [J][LINK]
The hot water equipment district heating consumption in Watts (for power) or Joules (for energy). It is the sum of the radiant, convective, latent and lost components. Hot Water Equipment District Heating Energy is added to the following district heating meters:
Steam Equipment District Heating Rate [W][LINK]
Steam Equipment District Heating Energy [J][LINK]
Space or Zone Steam Equipment District Heating Rate [W][LINK]
Space or Zone Steam Equipment District Heating Energy [J][LINK]
The steam equipment district heating consumption in Watts (for power) or Joules (for energy). It is the sum of the radiant, convective, latent and lost components. Steam Equipment District Heating Energy is added to the following:
Other Equipment Fuel Rate [W][LINK]
Other Equipment Fuel Energy [J][LINK]
Space or Zone Other Equipment Fuel Rate [W][LINK]
Space or Zone Other Equipment Fuel Energy [J][LINK]
The other equipment fuel consumption in Watts (for power) or Joules (for energy). It is the sum of the radiant, convective, latent and lost components. Other Equipment Fuel Energy is added to the following fuel meters corresponding to the Fuel Type input. If Fuel Type = None, this energy is not metered.
<Type> Equipment Radiant Heating Rate [W][LINK]
<Type> Equipment Radiant Heating Energy [J][LINK]
Space or Zone <Type> Equipment Radiant Heating Rate [W][LINK]
Space or Zone <Type> Equipment Radiant Heating Energy [J][LINK]
The amount of heat gain from equipment that is in the form of long-wave (thermal) radiation entering the zone. This heat is absorbed by the inside surfaces of the space or zone according to an area times long-wave absorptance weighting scheme.
<Type> Equipment Convective Heating Rate [W][LINK]
<Type> Equipment Convective Heating Energy [J][LINK]
Space or Zone <Type> Equipment Convective Heating Rate [W][LINK]
Space or Zone <Type> Equipment Convective Heating Energy [J][LINK]
The amount of heat gain from equipment that is convected to the space or zone air.
<Type> Latent Gain Rate [W][LINK]
<Type> Equipment Latent Gain Energy [J][LINK]
Space or Zone <Type> Latent Gain Rate [W][LINK]
Space or Zone <Type> Equipment Latent Gain Energy [J][LINK]
The amount of heat gain from equipment that goes added to the space or zone air as a latent (moisture) gain.
<Type> Lost Heat Rate [W][LINK]
<Type> Equipment Lost Heat Energy [J][LINK]
Space or Zone <Type> Lost Heat Rate [W][LINK]
Space or Zone <Type> Equipment Lost Heat Energy [J][LINK]
The amount of energy input to the equipment that is removed (exhausted) and does not add any heat gain to the space or zone.
<Type> Equipment Total Heating Rate [W][LINK]
<Type> Equipment Total Heating Energy [J][LINK]
Space or Zone <Type> Equipment Total Heating Rate [W][LINK]
Space or Zone <Type> Equipment Total Heating Energy [J][LINK]
The total heat gain from equipment. It is the sum of the following components: Total Heat Gain = Radiant Heat Gain + Convective Heat Gain + Latent Heat Gain. It is also equal to the power input to the equipment minus any Lost Heat.
ElectricEquipment:ITE:AirCooled[LINK]
This object describes air-cooled electric information technology equipment (ITE) which has variable power consumption as a function of loading and temperature.
Inputs[LINK]
Field: Name[LINK]
The name of this object.
Field: Zone or Space Name[LINK]
This field applies this ElectricEquipment:ITE:AirCooled object to a thermal zone or space in the building. If a Zone Name is specified and the zone contains more than one Space, the names of the actual IT equipment objects will be concatenated as <Space Name> <ITEquipment Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.
Field: Air Flow Calculation Method[LINK]
This field specifies the method used to calculate the IT inlet temperature and zone return air temperature.
If FlowFromSystem is chosen, the zone is assumed to be well-mixed.
If FlowControlWithApproachTemperatures is chosen, Supply and Return approach temperature should be defined to indicate the temperature difference due to the air distribution. The inputs of Air Inlet Connection Type, Design Recirculation Fraction and Recirculation Function of Loading and Supply Temperature Curve Name are ignored. For multiple ITE objects defined for one zone, the same calculation method should apply. The FlowControlWithApproachTemperatures only applies to ITE zones with single duct VAV terminal unit. Other return air heat gains from window or lights are not allowed when FlowControlWithApproachTemperatures is chosen.
The default method is FlowFromSystem.
Field: Design Power Input Calculation Method[LINK]
This field is a key/choice field that tells which of the next two fields are filled and is descriptive of the method for calculating the nominal electric power input to the ITE. The key/choices are:
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.
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 m\(^3\)/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 \(^\circ\)C at design conditions. The default is 15\(^\circ\)C.
Field: Environmental Class[LINK]
Specifies the allowable operating conditions for the air inlet conditions. The available inputs are A1, A2, A3, A4, B, C, H1, or None. This is used to report the “ITE Air Inlet Operating Range Exceeded Time.” If None is specified (the default), then no reporting of time outside allowable conditions will be done.
The related reporting variables (such as “ITE Air Inlet Operating Range Exceeded Time”) are based on the following limits1 on the air inlet temperature and humidity conditions shown in Table 5:
Field: Air Inlet Connection Type[LINK]
Specifies the type of connection between the zone and the ITE air inlet node. The choices are:
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.
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.
This option connects the ITE air inlet and outlet nodes to a room air model (Ref. RoomAirModelType and RoomAir:Node). Currently in EnergyPlus, this option has not been fully implemented. If the user chooses this option, the program will issue a warning message and this field will be adjusted to ZoneAirNode.
This field is only used when Air Flow Calculation Method is FlowFromSystem.
Field: Air Inlet Room Air Model Node Name[LINK]
Specifies the name of a room air model node (ref. RoomAir:Node) which is the air inlet to this equipment. This field is required if the Air Node Connection Type = RoomAirModel.
Field: Air Outlet Room Air Model Node Name[LINK]
Specifies the node name of a room air model node (ref. RoomAir:Node) which is the air outlet from this equipment. This field is required if the Air Node Connection Type = RoomAirModel.
Field: Supply Air Node Name[LINK]
Specifies the node name of the supply air inlet node service this ITE. If the Air Node Connection Type = AdjustedSupply ,then this field is required, and the conditions at this node will be used to determine the ITE air inlet conditions. This field is also required if reporting of the Supply Heat Index is desired. Also required if Calculation Method = FlowControlWithApproachTemperatures.
Field: Design Recirculation Fraction[LINK]
Specifies the recirculation fraction for this equipment at design conditions. This field is used only if the Air Node Connection Type = AdjustedSupply. The recirculation fraction is defined as the ratio of recirculated air flow to total air flow entering the ITE. Recirculation is dependent upon many factors including rack and containment configuration. The default is 0.0 (no recirculation). This field is only used when Air Flow Calculation Method = FlowFromSystem.
Field: Recirculation Function of Loading and Supply Temperature Curve Name[LINK]
The name of a two-variable curve or table lookup object which modifies the Design Recirculation Fraction as a function of CPU loading (\(x\)) and supply air node temperature (\(y\)). This curve (table) should equal 1.0 at design conditions (CPU loading = 1.0 and Design Entering Air Temperature). This field is used only if the Air Node Connection Type = AdjustedSupply. If this curve is left blank, then the curve is assumed to always equal 1.0. This field is only used when Air Flow Calculation Method = FlowFromSystem.
Field: Design Electric Power Supply Efficiency[LINK]
This field is a decimal number used to specify the efficiency of the power supply system serving this ITE. The default is 1.0.
Field: Electric Power Supply Efficiency Function of Part Load Ratio Curve Name[LINK]
The name of a single-variable curve or table lookup object which modifies the electric power supply efficiency as a function of part load ratio (\(x\)). This curve (table) should equal 1.0 at the design power consumption (part load ratio = 1.0). If this curve is left blank, then the curve is assumed to always equal 1.0.
Field: Fraction of Electric Power Supply Losses to Zone[LINK]
This field is a decimal number between 0.0 and 1.0 and is used to specify the fraction of the electric power supply losses which are a heat gain to the zone containing the ITE. If this value is less than 1.0, the remainder of the losses are assumed to be lost to the outdoors. The default is 1.0.
Field: CPU End-Use Subcategory[LINK]
This equipment is metered on the Interior Equipment end-use category for Electricity. This field allows you to specify a user-defined end-use subcategory for the CPU power consumption. A new meter for reporting is created for each unique subcategory (ref: Output:Meter object). Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and in the LEED Summary table EAp2-4/5 Performance Rating Method Compliance. The default is ITE-CPU.
Field: Fan End-Use Subcategory[LINK]
This equipment is metered on the Interior Equipment end-use category for Electricity. This field allows you to specify a user-defined end-use subcategory for the fan power consumption. A new meter for reporting is created for each unique subcategory (ref: Output:Meter object). Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and in the LEED Summary table EAp2-4/5 Performance Rating Method Compliance. The default is ITE-Fans.
Field: Electric Power Supply End-Use Subcategory[LINK]
This equipment is metered on the Interior Equipment end-use category for Electricity. This field allows you to specify a user-defined end-use subcategory for the electric power supply power consumption. A new meter for reporting is created for each unique subcategory (ref: Output:Meter object). Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and in the LEED Summary table EAp2-4/5 Performance Rating Method Compliance. The default is ITE-UPS
Field: Supply Temperature Difference[LINK]
The difference of the IT inlet temperature from the AHU supply air temperature (\({\Delta}T_{\textrm{supply}} = T_{\textrm{in}}-T_{\textrm{supply}}\)). Either Supply Temperature Difference or Supply Temperature Difference Schedule is required if Air Flow Calculation Method is set to FlowControlWithApproachTemperatures. This field is ignored when Air Flow Calculation Method is FlowFromSystem.
Field: Supply Temperature Difference Schedule[LINK]
The difference schedule of the IT inlet temperature from the AHU supply air temperature (\({\Delta}T_{\textrm{supply}} = T_{\textrm{in}}-T_{\textrm{supply}}\)). Either Supply Temperature Difference or Supply Temperature Difference Schedule is required if Air Flow Calculation Method is set to FlowControlWithApproachTemperatures. This field is ignored when Air Flow Calculation Method is FlowFromSystem.
Field: Return Temperature Difference[LINK]
The difference of the actual AHU return air temperature to the IT equipment outlet temperature (\({\Delta}T_{\textrm{return}} = T_{\textrm{return}}-T_{\textrm{out}}\)). Either Return Temperature Difference or Return Temperature Difference Schedule is required if Air Flow Calculation Method is set to FlowControlWithApproachTemperatures. This field is ignored when Air Flow Calculation Method is FlowFromSystem.
Field: Return Temperature Difference Schedule[LINK]
The difference schedule of the actual AHU return air temperature to the IT equipment outlet temperature (\({\Delta}T_{\textrm{return}} = T_{\textrm{return}}-T_{\textrm{out}}\)). Either Return Temperature Difference or Return Temperature Difference Schedule is required if Air Flow Calculation Method is set to FlowControlWithApproachTemperatures. This field is ignored when Air Flow Calculation Method is FlowFromSystem.
An IDF example:
Another IDF example when Air Flow Calculation Method = FlowControlWithApproachTemperatures:
Outputs[LINK]
ElectricEquipment:ITE:AirCooled Outputs:
Zone,Average,ITE CPU Electricity Rate [W]
Zone,Average,ITE Fan Electricity Rate [W]
Zone,Average,ITE UPS Electricity Rate [W]
Zone,Average,ITE CPU Electricity Rate at Design Inlet Conditions [W]
Zone,Average,ITE Fan Electricity Rate at Design Inlet Conditions [W]
Zone,Average,ITE UPS Heat Gain to Zone Rate [W]
Zone,Average,ITE Total Heat Gain to Zone Rate [W]
Zone,Sum,ITE CPU Electricity Energy [J]
Zone,Sum,ITE Fan Electricity Energy [J]
Zone,Sum,ITE UPS Electricity Energy [J]
Zone,Sum,ITE CPU Electricity Energy at Design Inlet Conditions [J]
Zone,Sum,ITE Fan Electricity Energy at Design Inlet Conditions [J]
Zone,Sum,ITE UPS Heat Gain to Zone Energy [J]
Zone,Sum,ITE Total Heat Gain to Zone Energy [J]
Zone,Average,ITE Standard Density Air Volume Flow Rate [m3/s]
Zone,Average,ITE Current Density Air Volume Flow Rate [m3/s]
Zone,Average,ITE Air Mass Flow Rate [kg/s]
Zone,Average,ITE Air Inlet Dry-Bulb Temperature [C]
Zone,Average,ITE Air Inlet Dewpoint Temperature [C]
Zone,Average,ITE Air Inlet Relative Humidity [%]
Zone,Average,ITE Air Outlet Dry-Bulb Temperature [C]
Zone,Average,ITE Supply Heat Index []
Zone,Sum,ITE Air Inlet Operating Range Exceeded Time [hr]
Zone,Sum,ITE Air Inlet Dry-Bulb Temperature Above Operating Range Time [hr]
Zone,Sum,ITE Air Inlet Dry-Bulb Temperature Below Operating Range Time [hr]
Zone,Sum,ITE Air Inlet Dewpoint Temperature Above Operating Range Time [hr]
Zone,Sum,ITE Air Inlet Dewpoint Temperature Below Operating Range Time [hr]
Zone,Sum,ITE Air Inlet Relative Humidity Above Operating Range Time [hr]
Zone,Sum,ITE Air Inlet Relative Humidity Below Operating Range Time [hr]
Zone,Average,ITE Air Inlet Dry-Bulb Temperature Difference Above Operating Range [deltaC]
Zone,Average,ITE Air Inlet Dry-Bulb Temperature Difference Below Operating Range [deltaC]
Zone,Average,ITE Air Inlet Dewpoint Temperature Difference Above Operating Range [deltaC]
Zone,Average,ITE Air Inlet Dewpoint Temperature Difference Below Operating Range [deltaC]
Zone,Average,ITE Air Inlet Relative Humidity Difference Above Operating Range [%]
Zone,Average,ITE Air Inlet Relative Humidity Difference Below Operating Range [%]
Zone,Average,Space ITE CPU Electricity Rate [W]
Zone,Average,Space ITE Fan Electricity Rate [W]
Zone,Average,Space ITE UPS Electricity Rate [W]
Zone,Average,Space ITE CPU Electricity Rate at Design Inlet Conditions [W]
Zone,Average,Space ITE Fan Electricity Rate at Design Inlet Conditions [W]
Zone,Average,Space ITE UPS Heat Gain to Zone Rate [W]
Zone,Average,Space ITE Total Heat Gain to Zone Rate [W]
Zone,Sum,Space ITE CPU Electricity Energy [J]
Zone,Sum,Space ITE Fan Electricity Energy [J]
Zone,Sum,Space ITE UPS Electricity Energy [J]
Zone,Sum,Space ITE CPU Electricity Energy at Design Inlet Conditions [J]
Zone,Sum,Space ITE Fan Electricity Energy at Design Inlet Conditions [J]
Zone,Sum,Space ITE UPS Heat Gain to Zone Energy [J]
Zone,Sum,Space ITE Total Heat Gain to Zone Energy [J]
Zone,Average,Space ITE Standard Density Air Volume Flow Rate [m3/s]
Zone,Average,Space ITE Air Mass Flow Rate [kg/s]
Zone,Average,Space ITE Average Supply Heat Index []
Zone,Sum,Space ITE Any Air Inlet Operating Range Exceeded Time [hr]
Zone,Sum,Space ITE Any Air Inlet Dry-Bulb Temperature Above Operating Range Time [hr]
Zone,Sum,Space ITE Any Air Inlet Dry-Bulb Temperature Below Operating Range Time [hr]
Zone,Sum,Space ITE Any Air Inlet Dewpoint Temperature Above Operating Range Time [hr]
Zone,Sum,Space ITE Any Air Inlet Dewpoint Temperature Below Operating Range Time [hr]
Zone,Sum,Space ITE Any Air Inlet Relative Humidity Above Operating Range Time [hr]
Zone,Sum,Space ITE Any Air Inlet Relative Humidity Below Operating Range Time [hr]
Zone,Average,Zone ITE Adjusted Return Air Temperature [C]
Zone,Average,Zone ITE CPU Electricity Rate [W]
Zone,Average,Zone ITE Fan Electricity Rate [W]
Zone,Average,Zone ITE UPS Electricity Rate [W]
Zone,Average,Zone ITE CPU Electricity Rate at Design Inlet Conditions [W]
Zone,Average,Zone ITE Fan Electricity Rate at Design Inlet Conditions [W]
Zone,Average,Zone ITE UPS Heat Gain to Zone Rate [W]
Zone,Average,Zone ITE Total Heat Gain to Zone Rate [W]
Zone,Sum,Zone ITE CPU Electricity Energy [J]
Zone,Sum,Zone ITE Fan Electricity Energy [J]
Zone,Sum,Zone ITE UPS Electricity Energy [J]
Zone,Sum,Zone ITE CPU Electricity Energy at Design Inlet Conditions [J]
Zone,Sum,Zone ITE Fan Electricity Energy at Design Inlet Conditions [J]
Zone,Sum,Zone ITE UPS Heat Gain to Zone Energy [J]
Zone,Sum,Zone ITE Total Heat Gain to Zone Energy [J]
Zone,Average,Zone ITE Standard Density Air Volume Flow Rate [m3/s]
Zone,Average,Zone ITE Air Mass Flow Rate [kg/s]
Zone,Average,Zone ITE Average Supply Heat Index []
Zone,Sum,Zone ITE Any Air Inlet Operating Range Exceeded Time [hr]
Zone,Sum,Zone ITE Any Air Inlet Dry-Bulb Temperature Above Operating Range Time [hr]
Zone,Sum,Zone ITE Any Air Inlet Dry-Bulb Temperature Below Operating Range Time [hr]
Zone,Sum,Zone ITE Any Air Inlet Dewpoint Temperature Above Operating Range Time [hr]
Zone,Sum,Zone ITE Any Air Inlet Dewpoint Temperature Below Operating Range Time [hr]
Zone,Sum,Zone ITE Any Air Inlet Relative Humidity Above Operating Range Time [hr]
Zone,Sum,Zone ITE Any Air Inlet Relative Humidity Below Operating Range Time [hr]
Space or Zone ITE CPU Electricity Rate [W][LINK]
ITE CPU Electricity Rate [J][LINK]
Space or Zone ITE CPU Electricity Energy [J][LINK]
ITE CPU Electricity Energy [J][LINK]
The electric power (or energy) input to the ITE equipment CPU (total power input less cooling fan power). The ITE CPU Electricity Energy output is also added to a meter object with Resource Type = Electricity, End Use Key = InteriorEquipment, Group Key = Building (Ref. Output:Meter object).
Space or Zone ITE CPU Electricity Rate at Design Inlet Conditions [W][LINK]
ITE CPU Electricity Rate at Design Inlet Conditions [W][LINK]
Space or Zone ITE CPU Electricity Energy at Design Inlet Conditions [J][LINK]
ITE CPU Electricity Energy at Design Inlet Conditions [J][LINK]
The electric power (or energy) input to the ITE equipment CPU (total power input less cooling fan power) if the air inlet temperature were held at the design condition. May be used to calculate “IT efficiency”, the ratio of (IT energy consumed in the facility) / (IT energy that would have been consumed in the facility if the ITE were held at the reference temperature).
Space or Zone ITE Fan Electricity Rate [W][LINK]
ITE Fan Electricity Rate [W][LINK]
Space or Zone ITE Fan Electricity Energy [J][LINK]
ITE Fan Electricity Energy [J][LINK]
The electric power (or energy) input to the ITE cooling fan. The ITE Fan Electricity Energy output is also added to a meter object with Resource Type = Electricity, End Use Key = InteriorEquipment, Group Key = Building (Ref. Output:Meter object).
Space or Zone ITE Fan Electricity Rate at Design Inlet Conditions [W][LINK]
ITE Fan Electricity Rate at Design Inlet Conditions [W][LINK]
Space or Zone ITE Fan Electricity Energy at Design Inlet Conditions [J][LINK]
ITE Fan Electricity Energy at Design Inlet Conditions [J][LINK]
The electric power (or energy) input to the ITE cooling fan if the air inlet temperature were held at the design condition. May be used to calculate “IT efficiency”, the ratio of (IT energy consumed in the facility) / (IT energy that would have been consumed in the facility if the ITE were held at the reference temperature).
Space or Zone ITE UPS Electricity Rate [W][LINK]
ITE UPS Electricity Rate [W][LINK]
Space or Zone ITE UPS Electricity Energy [J][LINK]
ITE UPS Electricity Energy [J][LINK]
The net electric power (or energy) input to the ITE equipment UPS (total power input less power delivered to ITE). The ITE UPS Electricity Energy output is also added to a meter object with Resource Type = Electricity, End Use Key = InteriorEquipment, Group Key = Building (Ref. Output:Meter object).
ITE Electricity Meters[LINK]
The ITE CPU Electricity Energy, ITE Fan Electricity Energy, and ITE UPS Electricity Energy are each included separately in the following Electricity meters, with their respective end-use subcategory:
Space or Zone ITE UPS Heat Gain to Zone Rate [W][LINK]
ITE UPS Heat Gain to Zone Rate [W][LINK]
Space or Zone ITE UPS Heat Gain to Zone Energy [J][LINK]
ITE UPS Heat Gain to Zone Energy [J][LINK]
The heat gain rate (or energy) to the zone from the UPS.
Space or Zone ITE Total Heat Gain to Zone Rate [W][LINK]
ITE Total Heat Gain to Zone Rate [W][LINK]
Space or Zone ITE Total Heat Gain to Zone Energy [J][LINK]
ITE Total Heat Gain to Zone Energy [J][LINK]
The heat gain rate (or energy) to the zone from the UPS and from the CPU and fans if the ITE. Air Inlet Connection Type is AdjustedSupply or ZoneAirNode. If RoomAirModel is selected, then only the heat gain from the UPS is added directly to the zone air heat balance, the heat gain from the CPU and fans will be added to the ITE air Outlet Room Air Model Node
Space or Zone ITE Standard Density Air Volume Flow Rate [m3/s][LINK]
ITE Standard Density Air Volume Flow Rate [m3/s][LINK]
Reports the average air volume flow rate through the ITE over the reporting interval. Standard density in EnergyPlus corresponds to 20\(^\circ\)C dry bulb, dry air, and nominally adjusted for elevation.
Space or Zone ITE Current Density Air Volume Flow Rate [m3/s][LINK]
ITE Current Density Air Volume Flow Rate [m3/s][LINK]
Reports the average air volume flow rate through the ITE over the reporting interval, calculated using the current density at the air inlet node.
Space or Zone ITE Air Mass Flow Rate [kg/s][LINK]
ITE Air Mass Flow Rate [kg/s][LINK]
Reports the average air mass flow rate through the ITE over the reporting interval, calculated using the current density at the air inlet node.
ITE Air Inlet Dry-Bulb Temperature [C][LINK]
The dry-bulb temperature of the air entering the ITE.
ITE Air Inlet Dewpoint Temperature [C][LINK]
The dewpoint temperature of the air entering the ITE.
ITE Air Inlet Relative Humidity [%][LINK]
The dewpoint temperature of the air entering the ITE.
ITE Air Outlet Dry-Bulb Temperature [C][LINK]
The dry-bulb temperature of the air leaving the ITE.
Space or Zone ITE Average Supply Heat Index [][LINK]
ITE Supply Heat Index [][LINK]
The supply heat index (SHI) for this equipment. SHI is a dimensionless measure of recirculation of hot air into the cold air intake of the ITE. \(\textrm{SHI} = (T_{\textrm{in}} - T_{\textrm{supply}})/(T_{\textrm{out}}-T_{\textrm{supply}})\) where \(T_{\textrm{in}}\) is the dry-bulb temperature of the air entering the ITE, Tout is the dry-bulb temperature of the air leaving the ITE, and \(T_{\textrm{supply}}\) is the dry-bulb temperature at the Supply Air Node. If a Supply Air Node Name is not specified for this object, then this output will not be reported.
Space or Zone ITE Any Air Inlet Operating Range Exceeded Time [hr][LINK]
ITE Air Inlet Operating Range Exceeded Time [hr][LINK]
Hours when the dry-bulb and/or dewpoint temperature of the air entering the ITE is outside the range specified by the ITE Environmental Class.
Space or Zone ITE Any Air Inlet Dry-Bulb Temperature Above Operating Range Time [hr][LINK]
ITE Air Inlet Dry-Bulb Temperature Above Operating Range Time [hr][LINK]
Hours when the dry-bulb temperature of the air entering the ITE is above the range specified by the ITE Environmental Class.
ITE Air Inlet Dry-Bulb Temperature Difference Above Operating Range [deltaC][LINK]
The temperature difference (in \(\Delta^\circ\)C) between the air inlet dry-bulb temperature and the maximum allowable dry-bulb temperature specified by the ITE Environmental Class. Only positive values are reported. When the dry-bulb temperature of the air entering the ITE is below the maximum specified by the ITE Environmental Class, this output will be zero.
Space or Zone ITE Any Air Inlet Dry-Bulb Temperature Below Operating Range Time [hr][LINK]
ITE Air Inlet Dry-Bulb Temperature Below Operating Range Time [hr][LINK]
Hours when the dry-bulb temperature of the air entering the ITE is above the range specified by the ITE Environmental Class.
ITE Air Inlet Dry-Bulb Temperature Difference Below Operating Range [deltaC][LINK]
The temperature difference (in \(\Delta^{\circ}\)C) between the air inlet dry-bulb temperature and the minimum allowable dry-bulb temperature specified by the ITE Environmental Class. Only negative values are reported. When the dry-bulb temperature of the air entering the ITE is above the minimum specified by the ITE Environmental Class, this output will be zero.
Space or Zone ITE Any Air Inlet Dewpoint Temperature Above Operating Range Time [hr][LINK]
ITE Air Inlet Dewpoint Temperature Above Operating Range Time [hr][LINK]
Hours when the dewpoint temperature of the air entering the ITE is above the range specified by the ITE Environmental Class.
ITE Air Inlet Dewpoint Temperature Difference Above Operating Range [deltaC][LINK]
The temperature difference (in \(\Delta^{\circ}\)C) between the air inlet dewpoint temperature and the maximum allowable dewpoint temperature specified by the ITE Environmental Class. Only positive values are reported. When the dewpoint temperature of the air entering the ITE is below the maximum specified by the ITE Environmental Class, this output will be zero.
Space or Zone ITE Any Air Inlet Dewpoint Temperature Below Operating Range Time [hr][LINK]
ITE Air Inlet Dewpoint Temperature Below Operating Range Time [hr][LINK]
Hours when the dewpoint temperature of the air entering the ITE is above the range specified by the ITE Environmental Class.
ITE Air Inlet Dewpoint Temperature Difference Below Operating Range [deltaC][LINK]
The temperature difference (in \(\Delta^{\circ}\)C) between the air inlet dewpoint temperature and the minimum allowable dewpoint temperature specified by the ITE Environmental Class. Only negative values are reported. When the dewpoint temperature of the air entering the ITE is above the minimum specified by the ITE Environmental Class, this output will be zero.
Space or Zone ITE Any Air Inlet Relative Humidity Above Operating Range Time [hr][LINK]
ITE Air Inlet Relative Humidity Above Operating Range Time [hr][LINK]
Hours when the relative humidity of the air entering the ITE is above the range specified by the ITE Environmental Class.
ITE Air Inlet Relative Humidity Difference Above Operating Range [%][LINK]
The temperature difference (in \(\Delta^{\circ}\)C) between the air inlet relative humidity and the maximum allowable relative humidity specified by the ITE Environmental Class. Only positive values are reported. When the relative humidity of the air entering the ITE is below the maximum specified by the ITE Environmental Class, this output will be zero.
Space or Zone ITE Any Air Inlet Relative Humidity Below Operating Range Time [hr][LINK]
ITE Air Inlet Relative Humidity Below Operating Range Time [hr][LINK]
Hours when the relative humidity of the air entering the ITE is above the range specified by the ITE Environmental Class.
ITE Air Inlet Relative Humidity Difference Below Operating Range [%][LINK]
The difference (in \(\Delta\%\)) between the air inlet relative humidity and the minimum allowable relative humidity (RH) specified by the ITE Environmental Class. Only negative values are reported. When the relative humidity of the air entering the ITE is above the minimum specified by the ITE Environmental Class, this output will be zero.
Zone ITE Adjusted Return Air Temperature [C][LINK]
Return air temperature after adjustment by ITE objects.
ZoneBaseboard:OutdoorTemperatureControlled[LINK]
This object specifies outside temperature-controlled (OTC) baseboard heating. The capacities (high and low) are specified in W at the temperatures specified. The schedule allows both capacities to change hourly on a proportional basis. This baseboard heater does not operate if the outdoor dry-bulb is above the high temperature limit. Between the high temperature and the low temperature, the capacity is interpolated (linear) between the high and the low capacity values. Below the low temperature, the capacity is set at the low capacity value. This allows the user to add baseboard heat to a perimeter zone starting at a prescribed temperature and then slowly increases this capacity to a max value.
Example:
Inputs[LINK]
Field: Name[LINK]
The name of the ZoneBaseboard:OutdoorTemperatureControlled object.
Field: Zone or ZoneList or Space or SpaceList Name[LINK]
This field applies this ZoneBaseboard:OutdoorTemperatureControlled object to one or more thermal zones or spaces in the building. The names of the actual baseboard heat objects may be concatenated as <Space Name> <ZoneBaseboard Object Name>. See Specifying Applicable Zone(s) or Space(s) for more details.
Field: Schedule Name[LINK]
This field is the name of the schedule that modifies the capacities (high and low) for baseboard heat equipment (see next four fields). The schedule values can be any positive number. The actual energy input for the baseboard equipment in a zone as defined by this statement depends on the actual outdoor temperature and where that temperature is in the range of Low Temperature to High Temperature.
Field: Capacity at Low Temperature[LINK]
This is the baseboard equipment capacity (Watts) at the low temperature limit. This is the maximum capacity of the baseboard equipment in full load operation. This field is autosizable.
Field: Low Temperature[LINK]
If the outdoor dry-bulb temperature (degrees Celsius) is at or below the low temperature the baseboard heater operates at the low temperature capacity. This field is autosizable. The lowest design outdoor dry bulb temperature is chosen, if autosized.
Field: Capacity at High Temperature[LINK]
This is the baseboard equipment capacity (Watts) at the high temperature limit. This field is autosizable. The capacity at low temperature is prorated against the reference low and high temperature fields, if autosized.
Field: High Temperature[LINK]
If the outdoor dry-bulb temperature (degrees Celsius) is greater than the high temperature the baseboard heater will not operate. This field is autosizable. If autosized, this is equal to the design zone heating setpoint temperature described below, so that the capacity at high temperature is zero.
Field: Fraction Radiant[LINK]
This field is a decimal number between 0.0 and 1.0 and is used to characterize the type of heat being given off by baseboard heat equipment in a zone. The number specified in this field will be multiplied by the total energy consumed by the baseboard heat equipment to give the amount of long wavelength radiation gain to the zone.
Field: End-Use Subcategory[LINK]
Allows you to specify a user-defined end-use subcategory, e.g., “Perimeter Baseboards”, etc. A new meter for reporting is created for each unique subcategory (ref: Output:Meter objects). Any text may be used here to categorize the end-uses in the ABUPS End Uses by Subcategory table and in the LEED Summary table EAp2-4/5 Performance Rating Method Compliance. If this field is omitted or blank, the baseboard equipment will be assigned to the “General” end-use subcategory.
Field: Design Zone Heating Setpoint[LINK]
This is heating setpoint temperature in the zone where the unit serves. This is used to autosize high temperature and capacity at high temperature fields. The default value is 20\(^\circ\)C.
An IDF example:
Outputs[LINK]
ZoneBaseboard:OutdoorTemperatureControlled objects have output variables for individual objects and for zone totals. The following outputs are available:
Zone,Average,Baseboard Electricity Rate [W]
Zone,Sum,Baseboard Electricity Energy [J]
Zone,Sum,Baseboard Radiant Heating Energy [J]
Zone,Average,Baseboard Radiant Heating Rate [W]
Zone,Sum,Baseboard Convective Heating Energy [J]
Zone,Average,Baseboard Convective Heating Rate [W]
Zone,Sum,Baseboard Total Heating Energy [J]
Zone,Average,Baseboard Total Heating Rate [W]
Zone,Average,Space Baseboard Electricity Rate [W]
Zone,Sum,Space Baseboard Electricity Energy [J]
Zone,Sum,Space Baseboard Radiant Heating Energy [J]
Zone,Average,Space Baseboard Radiant Heating Rate [W]
Zone,Sum,Space Baseboard Convective Heating Energy [J]
Zone,Average,Space Baseboard Convective Heating Rate [W]
Zone,Sum,Space Baseboard Total Heating Energy [J]
Zone,Average,Space Baseboard Total Heating Rate [W]
Zone,Average,Zone Baseboard Electricity Rate [W]
Zone,Sum,Zone Baseboard Electricity Energy [J]
Zone,Sum,Zone Baseboard Radiant Heating Energy [J]
Zone,Average,Zone Baseboard Radiant Heating Rate [W]
Zone,Sum,Zone Baseboard Convective Heating Energy [J]
Zone,Average,Zone Baseboard Convective Heating Rate [W]
Zone,Sum,Zone Baseboard Total Heating Energy [J]
Zone,Average,Zone Baseboard Total Heating Rate [W]
Baseboard Electricity Rate [W][LINK]
This field is the electric power for the ZoneBaseboard:OutdoorTemperatureControlled object in Watts.
Baseboard Electricity Energy [J][LINK]
The outdoor temperature controlled baseboard heat option is assumed to be fueled by electricity. This field is the same as the Baseboard Total Heating Energy (above) in joules. This energy is included in the following meters:
Baseboard Radiant Heating Rate [W][LINK]
Baseboard Radiant Heating Energy [J][LINK]
These output variables are the amount of radiant heat gain for the ZoneBaseboard:OutdoorTemperatureControlled object in Watts (for rate) or Joules. This is determined by the current heat gain from the heater to the zone and the “Fraction Radiant” specified in the input. The radiant gains (long wavelength) are distributed to the surfaces using an area weighting scheme.
Baseboard Convective Heating Rate [W][LINK]
Baseboard Convective Heating Energy [J][LINK]
These output variables are the amount of convective heat gain for the ZoneBaseboard:OutdoorTemperatureControlled object in Watts (for rate) or Joules. This is determined by the current heat gain from the heater to the zone and the “Fraction Radiant” specified in input (1-FractionRadiant = FractionConvected). The convective heat gain is added to the zone air heat balance directly.
Baseboard Total Heating Rate [W][LINK]
Baseboard Total Heating Energy [J][LINK]
These output variables are the amount of heat gain for the ZoneBaseboard:OutdoorTemperatureControlled object in Watts (for rate) or Joules. This is determined by the sum of the radiant and convective heat gains from the baseboard heat.
Space or Zone Baseboard Electricity Rate [W][LINK]
This field is the electric power for all ZoneBaseboard:OutdoorTemperatureControlled objects within the space or zone in Watts.
Space or Zone Baseboard Electricity Energy [J][LINK]
The outdoor temperature controlled baseboard heat option is assumed to be fueled by electricity. This field is the same as the Baseboard Total Heating Energy (above) in joules.
Space or Zone Baseboard Radiant Heating Rate [W][LINK]
Space or Zone Baseboard Radiant Heating Energy [J][LINK]
These output variables are the amount of radiant heat gain for all ZoneBaseboard:OutdoorTemperatureControlled objects within the space or zone in Watts (for rate) or Joules. This is determined by the current heat gain from the heater to the space or zone and the “Fraction Radiant” specified in the input. The radiant gains (long wavelength) are distributed to the surfaces using an area weighting scheme.
Space or Zone Baseboard Convective Heating Rate [W][LINK]
Space or Zone Baseboard Convective Heating Energy [J][LINK]
These output variables are the amount of convective heat gain for all ZoneBaseboard:OutdoorTemperatureControlled objects within the space or zone in Watts (for rate) or Joules. This is determined by the current heat gain from the heater to the space or zone and the “Fraction Radiant” specified in input (1-FractionRadiant = FractionConvected). The convective heat gain is added to the space or zone air heat balance directly.
Space or Zone Baseboard Total Heating Rate [W][LINK]
Space or Zone Baseboard Total Heating Energy [J][LINK]
These output variables are the amount of heat gain for all ZoneBaseboard:OutdoorTemperatureControlled objects within the space or zone in Watts (for rate) or Joules. This is determined by the sum of the radiant and convective heat gains from the baseboard heat.
SwimmingPool:Indoor[LINK]
The Indoor Swimming Pool object is used to describe the indoor swimming pools that are exposed to the internal environment. There are several rules that should be noted regarding the specification of an indoor pool in EnergyPlus. First, the pool is linked to a surface that must be a floor. The pool is assumed to cover the entire floor to which it is linked. If the pool only covers part of the floor in the actual building, then the user must break the floor up into multiple sections.
As pools attempt to achieve a particular water temperature and have a variety of heat losses, heating equipment is necessary to maintain the proper setpoint temperature. In EnergyPlus, the pool itself becomes part of the demand side of a plant loop with heating equipment on the supply side providing whatever heating is needed to maintain the desired temperature. This heating equipment as well as the loop connections must be entered separately and the input shown in this section only details what is needed to specify the pool itself.
There are a variety of rules that limit the application of indoor swimming pools in EnergyPlus. The following are a list of these rules:
The pool must reference a valid surface in the input file. This surface must be a floor and cannot be other surface types like ceilings, walls, windows, etc.
The pool cannot refer to a surface that is also a radiant system, ventilated slab, or another pool.
The surface that the pool references must be modeled using conduction transfer functions (CTF).
The pool cannot utilize movable insulation or have a heat source or sink associated with it (something used to model low temperature radiant systems).
The following information is useful for defining and modeling an indoor pool in EnergyPlus. For more information on the algorithm used for this model or details on some of the input parameters, please reference the indoor pool section of the EnergyPlus Engineering Reference document.
Inputs[LINK]
Field: Name[LINK]
This is a unique name associated with the indoor swimming pool.
Field: Surface Name[LINK]
This is the name of the surface (floor) where the pool is located. Pools are not allowed on any surfaces other than a floor. For more rules on surfaces that can be used for pools, please see the information in this section on indoor pools above.
Field: Average Depth[LINK]
This field is the average depth of the pool in meters. If the pool has variable depth, the average depth should be specified to achieve the proper volume of water in the pool.
Field: Activity Factor Schedule Name[LINK]
This field references a schedule that contains values for pool activity. This parameter can be varied using the schedule named here, and it has an impact on the amount of evaporation that will take place from the pool to the surrounding zone air. For example values of the activity factor and what impact it will have on the evaporation of water from the pool, please refer to the Indoor Swimming Pool section of the EnergyPlus Engineering Reference document. If left blank, the activity factor will be assumed to be unity. Note that the activity factor 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:
Outputs[LINK]
HVAC, Average, Indoor Pool Makeup Water Rate [m3/s]
HVAC, Sum, Indoor Pool Makeup Water Volume [m3]
HVAC, Average, Indoor Pool Makeup Water Temperature [C]
HVAC, Average, Indoor Pool Water Temperature [C]
HVAC, Average, Indoor Pool Inlet Water Temperature [C]
HVAC, Average, Indoor Pool Inlet Water Mass Flow Rate [kg/s]
HVAC, Average, Indoor Pool Miscellaneous Equipment Power [W]
HVAC, Sum, Indoor Pool Miscellaneous Equipment Energy [J]
HVAC, Average, Indoor Pool Water Heating Rate [W]
HVAC, Sum, Indoor Pool Water Heating Energy [J]
HVAC, Average, Indoor Pool Radiant to Convection by Cover [W]
HVAC, Average, Indoor Pool People Heat Gain [W]
HVAC, Average, Indoor Pool Current Activity Factor []
HVAC, Average, Indoor Pool Current Cover Factor []
HVAC, Average, Indoor Pool Evaporative Heat Loss Rate [W]
HVAC, Sum, Indoor Pool Evaporative Heat Loss Energy [J]
HVAC, Average, Indoor Pool Saturation Pressure at Pool Temperature [Pa]
HVAC, Average, Indoor Pool Partial Pressure of Water Vapor in Air [Pa]
HVAC, Average, Indoor Pool Current Cover Evaporation Factor []
HVAC, Average, Indoor Pool Current Cover Convective Factor []
HVAC, Average, Indoor Pool Current Cover SW Radiation Factor []
HVAC, Average, Indoor Pool Current Cover LW Radiation Factor []
Indoor Pool Makeup Water Rate [m3/s][LINK]
The water consumption rate for the makeup water of indoor swimming pool.
Indoor Pool Makeup Water Volume [m3][LINK]
The water consumption for the makeup water of indoor swimming pool.
Indoor Pool Makeup Water Temperature [C][LINK]
The temperature of the makeup water of indoor swimming pool.
Indoor Pool Water Temperature [C][LINK]
The average calculated pool water temperature during the simulation at the time frequency requested.
Indoor Pool Inlet Water Temperature [C][LINK]
The temperature of the water being sent to the pool from the plant heating equipment.
Indoor Pool Inlet Water Mass Flow Rate [kg/s][LINK]
The mass flow rate of water being sent to the pool from the plant heating equipment. Typically this water is being passed through a heater and miscellaneous equipment.
Indoor Pool Miscellaneous Equipment Power [W][LINK]
The miscellaneous equipment power includes the power consumption of pool filter and chlorinator in Watts.
Indoor Pool Miscellaneous Equipment Energy [J][LINK]
The miscellaneous equipment power consumption includes the energy consumption of pool filter and chlorinator in Joules.
Indoor Pool Water Heating Rate [W][LINK]
This is the rate of heating provided by the plant loop to the pool in Watts.
Indoor Pool Water Heating Energy [J][LINK]
This is the amount of heating provided by the plant loop to the pool in Joules over the time step requested.
Indoor Pool Radiant to Convection by Cover [W][LINK]
The pool cover may block some or all of short- and long-wavelength radiation incident on the pool. To account for this and to not have the cover result in energy that is not accounted for by the model, the radiation that is blocked by the cover is converted to a convective gain (or loss) to/from the zone air. This output field reports this value.
Indoor Pool Current Activity Factor [][LINK]
This is the current activity factor as defined by the user input schedule.
Indoor Pool Current Cover Factor [][LINK]
This is the current cover factor as defined by the user input schedule.
Indoor Pool Evaporative Heat Loss Rate [W][LINK]
This is the rate of evaporative heat loss (latent) to the zone from the pool in Watts.
Indoor Pool Evaporative Heat Loss Energy [J][LINK]
This is the amount of evaporative heat loss (latent) to the zone from the pool in in Joules over the time step requested.
Indoor Pool Saturation Pressure at Pool Temperature [Pa][LINK]
This is the saturation pressure of water vapor in air at the pool water temperature.
Indoor Pool Partial Pressure of Water Vapor in Air [Pa][LINK]
This is the partial pressure of water vapor in air at the current zone air conditions for dry bulb temperature and humidity ratio.
Indoor Pool Current Cover Evaporation Factor [][LINK]
This is the current value of the cover evaporation factor that is used as a modifier for the actual evaporation. A value of zero means no evaporation will take place while a value of unity means the maximum allowed evaporation will take place. This value is based on the current cover condition as well as the user input for the cover evaporation factor.
Indoor Pool Current Cover Convective Factor [][LINK]
This is the current value of the cover convective factor that is used as a modifier for the actual convection. A value of zero means the cover will block all convection while a value of unity means that the cover will not affect convection from the water surface at all. This value is based on the current cover condition as well as the user input for the cover convective factor.
Indoor Pool Current Cover SW Radiation Factor [][LINK]
This is the current value of the cover short wavelength radiation factor that is used as a modifier for the actual short wavelength radiation. A value of zero means the cover will block all short wavelength radiation while a value of unity means that the cover will not affect short wavelength radiation from the water surface at all. This value is based on the current cover condition as well as the user input for the cover short wavelength radiation factor.
Indoor Pool Current Cover LW Radiation Factor [][LINK]
This is the current value of the cover long wavelength radiation factor that is used as a modifier for the actual long wavelength radiation. A value of zero means the cover will block all long wavelength radiation while a value of unity means that the cover will not affect long wavelength radiation from the water surface at all. This value is based on the current cover condition as well as the user input for the cover long wavelength radiation factor.
ZoneContaminantSourceAndSink:CarbonDioxide[LINK]
The ZoneContaminantSourceAndSink:CarbonDioxide object allows users to input carbon dioxide sources or sinks in a zone. Note that carbon dioxide generation within a zone can also be specified using People and GasEquipment objects. Multiple ZoneContaminantSourceAndSink:CarbonDioxide objects can be specified for the same zone.
Inputs[LINK]
Field: Name[LINK]
The name of the ZoneContaminantSourceAndSink:CarbonDioxide object. The name for each ZoneContaminantSourceAndSink:CarbonDioxide object must be unique.
Field: Zone Name[LINK]
This field is the name of the zone (ref: Zone) and links a particular ZoneContaminantSourceAndSink:CarbonDioxide object to a thermal zone in the building.
Field: Design Generation Rate[LINK]
This field denotes the design carbon dioxide generation rate (m\(^{3}\)/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 (CO\(_{2}\) addition to the zone air) and a negative value represents a sink rate (CO\(_{2}\) 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 CO\(_{2}\) 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:
Outputs[LINK]
Contaminant Source or Sink CO2 Gain Volume Flow Rate [m3/s][LINK]
This output is the net carbon dioxide internal gain/loss in \(\frac{m^{3}}{s}\) for an individual ZoneContaminantSourceAndSink:CarbonDioxide object.
Zone Contaminant Source or Sink CO2 Gain Volume Flow Rate [m3/s][LINK]
This output is the net carbon dioxide internal gain/loss in \(\frac{m^{3}}{s}\) for all ZoneContaminantSourceAndSink:CarbonDioxide objects in a zone.
ZoneContaminantSourceAndSink:Generic:Constant[LINK]
The ZoneContaminantSourceAndSink:Generic:Constant object specifies the generic contaminant generation rate and removal rate coefficient in a zone. The associated fraction schedules are required for allowing users to change the magnitude of sources and sinks. The object is equivalent to the combination of the constant coefficient model and the burst source model defined in the sources and sinks element types of CONTAM 3.0. The basic equation used to calculate generic contaminant source and sink for the constant model is given below:
\[{S_f}(t) = {G_f}(t)\cdot{F_G} - {R_f}(t)\cdot{C_f}(t)\cdot 10^{-6}\cdot{F_R}\]
where
\(S_{f}\) = Contaminant generic contaminant source strength [m\(^{3}\)/s]
\(G_{f}\) = Generic contaminant generation rate [m\(^{3}\)/s]
\(F_{G}\) = Fraction value from the source fraction schedule at a given time [dimensionless]
\(R_{f}\) = Generic contaminant effective removal rate [m\(^{3}\)/s]
F\(_{R}\) = Fraction value from the sink fraction schedule at a given time [dimensionless]
C\(_{f}\) = 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 (m\(^{3}\)/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 (G\(_{f}\)). This fraction between 0.0 and 1.0 is noted as F\(_{G}\) in the above equation.
Field: Design Removal Coefficient[LINK]
This field denotes the full generic contaminant design removal coefficient (m\(^{3}\)/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 (R\(_{f}\)). This fraction between 0.0 and 1.0 is noted as F\(_{R}\) in the above equation.
An IDF example is provided below:
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:
\[{S_f}(t) = {H_f}(t)\cdot{F_G}\cdot{\left( {{P_j} - {P_i}} \right)^n}\]
where
\(S_{f}\) = Generic contaminant source strength [m\(^{3}\)/s]
\(H_{f}\) = Generic contaminant generation rate coefficient [m\(^{3}\)/s]
\(F_{G}\) = Fraction value from the source fraction schedule at a given time [dimensionless]
\({n}\) = Flow power exponent
\(P_{i}\) = Zone pressure [Pa]
\(P_{j}\) = 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 (m\(^{3}\)/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:
Outputs[LINK]
When a SurfaceContaminantSourceAndSink:Generic:PressureDriven object is specified, the following output variables are available:
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:
\[{S_f}(t) = \left\{ \begin{array}{l}{G_f}(t)*{F_G}*\left( {1 - \frac{{{C_f}(t)}}{{{C_{cutoff}}}}} \right)\;\;\;\;\;{C_f} < {C_{cutoff}}\\0\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;\;{C_f} \ge {C_{cutoff}}\end{array} \right\}\]
where
\(S_{f}\) = Generic contaminant source strength [m\(^{3}\)/s]
\(G_{f}\) = Generic contaminant generation rate [m\(^{3}\)/s]
\(F_{G}\) = Fraction value from the source fraction schedule at a given time [dimensionless]
\(C_{\rm{cutoff}}\) = Cutoff concentration at which emission ceases [ppm]
\(C_{f}\) = 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 (m\(^{3}\)/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 (G\(_{f}\)). This fraction between 0.0 and 1.0 is noted as F\(_{G}\) 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:
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:
\[{S_f}(t) = {G_f}(t){F_G}\exp ( - t/{t_c})\]
where
S\(_{f}\) = Generic contaminant source strength [m\(^{3}\)/s]
G\(_{f}\) = Initial generic contaminant generation rate [m\(^{3}\)/s]
F\(_{G}\) = Fraction value from the source fraction schedule at a given time [dimensionless]
\(t\) = Time since the start of emission [second]
t\(_{c}\) = 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 (m\(^{3}\)/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 (G\(_{f}\)). This fraction between 0.0 and 1.0 is noted as F\(_{G}\) 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:
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:
\[{S_f} = h \cdot \rho \cdot A\left( {{C_f} - \frac{{{C_s}}}{k}} \right)*10^{-6}\]
where
h = Average film mass transfer coefficient over the sink [m/s]
\(\rho\) = Film density of air [kg/m\(^{3}\)]
A = Surface area of the adsorbent [m\(^{2}\)]
C\(_{f}\) = Concentration in the air at the previous time step [ppm]
C\(_{s}\) = 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:
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:
\[{S_f}(t) = {\nu_d}{A_s}m \cdot {C_f}(t)\cdot 10^{-6} \cdot F{}_R\]
where
\(S_f (t)\) = Removal rate at time t [m\(^{3}\)/s]
\(\nu_d\) = Deposition velocity [m/s]
\(A_s\) = Deposition surface area [m\(^{2}\)]
\(m\) = Element multiplier [dimensionless]
\(C_f (t)\) = Concentration of contaminant generic contaminant at the previous time step [ppm]
\(\rm{F}_{R}\) = 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 (S\(_{f}\)). This fraction between 0.0 and 1.0 is noted as F\(_{R}\) in the above equation.
An IDF example is provided below:
Outputs[LINK]
The following output variables are available when the SurfaceContaminantSourceAndSink:Generic:DepositionVelocitySink object is specified.
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:
\[{S_f}(t) = {k_d}{V_z} \cdot {C_f}(t) \cdot 10^{-6} \cdot {F_R} \cdot m\]
Where
S\(_{f}\)(t) = Removal rate at time t [m\(^{3}\)/s]
k\(_{d}\) = Deposition rate [1/T]
V\(_{z}\) = Zone volume [m\(^{3}\)]
m = Element multiplier [dimensionless]
C\(_{f}\)(t) = Concentration of generic contaminant at the previous time step [ppm]
F\(_{R}\) = 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 (S\(_{f}\)). This fraction between 0.0 and 1.0 is noted as F\(_{R}\) in the above equation.
An IDF example is provided below:
Outputs[LINK]
When the ZoneContaminantSourceAndSink:Generic:DepositionRateSink object is specified, the following output variables are available:
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.
Sources: [1]. ASHRAE, 2021. “Thermal Guidelines for Data Processing Environments (5\(^{\textrm{th}}\) Edition),” Peachtree Corners: ASHRAE; [2]. Quirk, Davidson, and Schmidt, 2022. “ASHRAE’s Data Center Thermal Guidelines—Air-Cooled Evolution,” ASHRAE Journal, May 2022.↩︎
Documentation content copyright © 1996-2026 The Board of Trustees of the University of Illinois and the Regents of the University of California through the Ernest Orlando Lawrence Berkeley National Laboratory. All rights reserved. EnergyPlus is a trademark of the US Department of Energy.
This documentation is made available under the EnergyPlus Open Source License v1.0.