Note that two different methodologies are used in the
Daylighting:Controls object (SplitFlux and DElight) and may be
intermixed in a single IDF but may not be used in the same
zone.
When this object is used, daylighting illuminance levels
are calculated and then used to determine how much the
electric lighting can be reduced. The daylight illuminance
level in a zone depends on many factors, including sky
condition; sun position; calculation point; location, size,
and glass transmittance of windows; window shading devices;
and reflectance of interior surfaces. Reduction of electric
lighting depends on daylight illuminance level, illuminance
set point, fraction of zone controlled and type of lighting
control. Two different methods of computing the daylighitng
illuminance and subsequent lighting reduction called SplitFlux
and DElight. After the object description below is are
sections that describe the two methodologies in more
detail.
The Daylighting Method field can be set to either of the
following: SplitFlux or DElight. Different Zones can have
different settings in the same file but in a single zone only
one method should be used at a time. Guidelines for using the
SplitFlux method and additional details on the DElight method
are shown in following sections.
This alpha field is optional and may be used to define the
name of a schedule that denotes whether or not the control is
available to operate during a given time period. If the
schedule value is greater than zero, then the controls will be
available to operate for that time period. If the schedule
value is zero or less, then the controls will not be
available. If this field is left blank, the controls will be
always available. For example, this can be useful for
scheduling the daylighting controls off during design days so
that the daylighting controls do not affect lighting power
during sizing.
The type of overhead electric lighting control. All
reference points specified are assumed to have this type of
control.
For Lighting Control Type set to Continuous, the overhead
lights dim continuously and linearly from (maximum electric
power, maximum light output) to (minimum electric power,
minimum light output) as the daylight illuminance increases.
The lights stay on at the minimum point with further increase
in the daylight illuminance.
For Lighting Control Type set to Stepped, the electric
power input and light output vary in discrete, equally spaced
steps. The number of steps is given by Number of Steps
(Excluding Off) of Stepped Control. For example, if Number of
Steps = 3 and Illuminance Setpoint = 600, then the following
table shows the fraction of the lights that are on
vs. daylight illuminance.
Example of a Stepped Lighting Control System with
Three Steps
Daylight illuminance
Fraction of lights that are
on
0-200
1.0
200-400
2/3
400-600
1/3
600 and above
0.0
Lighting Control Type set to ContinuousOff is the same
similar to Lighting Control Type set to Continuous except that
the lights switch off completely when the minimum dimming
point is reached.
Field:
Minimum Input Power Fraction for Continuous Dimming
Control[LINK]
For Lighting Control Type set to Continuous, the lowest
power the lighting system can dim down to, expressed as a
fraction of maximum input power (see figure, below). For
Lighting Control Type set to ContinuousOff, this is the power
fraction reached just before the lights switch off
completely.
Illustration of continuous
dimming relationship
The figure shows the relationship between electric light
output and electrical input.
Field:
Minimum Light Output Fraction for Continuous Dimming
Control[LINK]
For Lighting Control Type set to Continuous, the lowest
lighting output the lighting system can dim down to, expressed
as a fraction of maximum light output (see figure). This is
the fractional light output that the system produces at
minimum input power. For Lighting Control Type set to
ContinuousOff, this is the light output fraction reached just
before the lights switch off completely.
The number of steps, excluding off, in a stepped lighting
control system (see figure, below). Required and must be >0
if Lighting Control Type is set to Stepped. The steps are
assumed to be equally spaced.
Stepped lighting control with
Number of Steps = 3.
Field:
Probability Lighting will be Reset When Needed in Manual
Stepped Control[LINK]
May be specified if a stepped lighting control system
(Lighting Control Type set to Stepped) is manually operated,
such as in a simple, one-step (on-off) system. Gives the
probability the occupants of a daylit zone will set the
electric lights to the correct level to obtain the required
illuminance. The rest of the time the lights are assumed to be
set one step too high. For example, consider an on-off
lighting system (Number of Steps = 1) with a set point of 600
lux and 0.7 reset probability. Then, when daylighting exceeds
600 lux, the electric lights will be off 70% of the time and
on 30% of the time.
Field:
Glare Calculation Daylighting Reference Point Name
{#field-glare
calculation-daylighting-reference-point-name}[LINK]
The Daylighting:ReferencePoint
name should be specified that is used for determining the
glare. Only one reference point is used to calculate the
glare. This input is only used in when the Daylighting Method
is set to SplitFlux. This input is ignored when Daylighting
Method is set to DElight.
Field:
Glare Calculation Azimuth Angle of View Direction Clockwise
from Zone y-Axis[LINK]
Daylight glare from a window depends on occupant view
direction. It is highest when you look directly at a window
and decreases as you look away from a window. This field
specifies the view direction for calculating glare. It is the
angle, measured clockwise in the horizontal plane, between the
zone y-axis and the occupant view direction. This input is
only used in when the Daylighting Method is set to SplitFlux.
This input is ignored when Daylighting Method is set to
DElight.
Field:
Maximum Allowable Discomfort Glare Index[LINK]
If a daylit zone has windows with shading devices (except
exterior screens), the shades will be deployed if the daylight
glare at Daylighting:ReferencePoint
specified in the Glare Calculation Daylighting Reference Point
Name field exceeds the value of this field. To get this type
of glare control you have to specify Trigger = Glare,
GlareOrSolarOnWindow, GlareOrHorizontalSolar,
GlareOrOutsideAirTemp, GlareOrZoneAirTemp or GlareOrZoneLoad
in WindowProperty:ShadingControl
for one or more windows in the zone (see
WindowProperty:ShadingControl). This input is only used in
when the Daylighting Method is set to SplitFlux. This input is
ignored when Daylighting Method is set to DElight.
If a zone has two or more windows with glare control, the
shading devices will be deployed one by one in the order in
which the windows are input until the glare level at each
reference point falls below Maximum Allowable Discomfort Glare
Index or is as close as possible to it.
The following table gives recommended values of Maximum
Allowable Discomfort Glare Index.
Recommended Values of Maximum Allowable Discomfort
Glare Index (DGI)
The maximum surface area for nodes in gridding
(subdividing) all surfaces in the zone when Daylighting Method
is set to DElight. All reflective and transmitting surfaces
will be subdivided into approximately square nodes that do not
exceed this maximum. Higher resolution subdivisions require
greater calculation times, but generally produce more accurate
results. This same gridding resolution is also used to
subdivide any Complex Fenestration System surfaces. It is
advisable to perform at least one simulation of new input
using a small gridding resolution such as 0.1m2 to compare
these results against simulation runs at lower resolution
(i.e., higher maximum area nodal grids) to get a sense of
possible levels of error. This input is only used in when the
Daylighting Method is set to DElight. This input is ignored
when Daylighting Method is set to SplitFlux.
Field Set (reference
point name, fraction controlled, illuminance setpoint)[LINK]
This set of fields is used together and can be repeated an
unlimited number of times to specify some of the name of the
reference point, the fraction of the zone lighting controlled
by that reference point and the illuminance setpoint that
should be applied for daylighting control at that reference
point.
The Daylighting:ReferencePoint
name should be specified that is used for determining the
daylighting control sensor location.
Field:
Fraction of Zone Controlled by Reference Point <x>[LINK]
The fraction of the zone’s floor-area whose electric
lighting is controlled by the daylight illuminance at the
named Daylighting:ReferencePoint.
If the sum of the fractions are less than 1.0, the remaining
portion is assumed to have no lighting control.
Field:
Illuminance Setpoint at Reference Point <x>[LINK]
The desired lighting level (in lux) at the named Daylighting:ReferencePoint.
This is the lighting level that would be produced at this
reference point at night if the overhead electric lighting
were operating at full input power. Recommended values depend
on type of activity; they may be found, for example, in the
Lighting Handbook of the Illuminating Engineering Society of
North America. A typical value for general office work
(excluding computer terminals) is 500 lux.
This object is referenced by Daylighting:Controls
to identify the reference point coordinates for each sensor.
The reference points in the zone are where horizontal
daylighting illuminance will be calculated. It is assumed that
the photocells that control the overhead electric lighting
respond to the light levels at the specified coordinates.
Reference points are given in coordinates specified in the GlobalGeometryRules
object Daylighting Reference Point CoordinateSystem field.
When the DElight Daylighting Method is used, there may be
up to a maximum of 100 reference points for each zone. Each
Reference Point that is input does NOT need to be included in
the control of the electric lighting system within the zone.
This is determined by the fraction of the zone controlled by
each Reference Point, which can be input as 0. Note when the
DElight Daylighting Method is used, that the sum of all
Reference Point control fractions must equal 1 to obtain
correct overall results.
The name of the zone in which the reference point is
located.
Fields: (X,Y,Z)
Coordinate of Reference Point[LINK]
These three fields are the X, Y and Z values of the
reference point in the coordinate system you specified for
daylighting reference points in the GlobalGeometryRules
object. Figure
shows an example using the relative coordinate (to zone)
system. Z is typically at desk height (0.8 m).
Example showing location of
daylighting reference points in the zone coordinate system
(relative) of a rectangular zone with three windows. (a)
Perspective view, (b) plan view, (c) elevation view. All
dimensions are in meters.
An IDF example:
Daylighting:Controls,
West Zone_DaylCtrl, !- Name
West Zone, !- Zone Name
SplitFlux, !- Daylighting Method
, !- Availability Schedule Name
Continuous, !- Lighting Control Type
0.3, !- Minimum Input Power Fraction for Continuous or ContinuousOff Dimming Control
0.2, !- Minimum Light Output Fraction for Continuous or ContinuousOff Dimming Control
, !- Number of Stepped Control Steps
1.0, !- Probability Lighting will be Reset When Needed in Manual Stepped Control
West Zone_DaylRefPt1, !- Glare Calculation Daylighting Reference Point Name
180.0, !- Glare Calculation Azimuth Angle of View Direction Clockwise from Zone y-Axis {deg}
20.0, !- Maximum Allowable Discomfort Glare Index
, !- DElight Gridding Resolution {m2}
West Zone_DaylRefPt1, !- Daylighting Reference Point 1 Name
1.0, !- Fraction of Zone Controlled by Reference Point 1
500.; !- Illuminance Setpoint at Reference Point 1 {lux}
Daylighting:ReferencePoint,
West Zone_DaylRefPt1, !- Name
West Zone, !- Zone Name
3.048, !- X-Coordinate of Reference Point {m}
3.048, !- Y-Coordinate of Reference Point {m}
0.9; !- Z-Coordinate of Reference Point {m}
Guidelines
for Daylighting Modeling Ssing the SplitFlux Method)[LINK]
Following are some guidelines for preparing EnergyPlus
input to model the effects of daylighting when using the
SplitFlux method. Before studying these guidelines, however,
you should read the description of each input field under Daylighting:Controls,Daylighting:ReferencePoint,
and review the IDF example, above, and the sample daylighting
input, PurchAirWithDaylighting.idf.
If an exterior wall in a daylit zone has a number of
identical windows, the windows should be entered separately
rather than using a window multiplier (ref:
FenestrationSurface:Detailed). Using a multiplier would give
an incorrect illuminance calculation since individual windows
would not be positioned correctly on the wall.
A zone multiplier should not be used on a daylit zone if
the windows in the zone are shadowed by exterior obstructions
like trees or neighboring buildings, or by obstructions caused
by other parts of building. The reason for this is that the
shadowing on the windows of the multiplied zone may be
different from zone to zone depending on exactly how the
shadows fall on the zones. However, a zone multiplier may be
used on a daylit zone if the shadowing is by overhangs, fins
and/or window setback.
To correctly calculate both direct and inter-reflected
daylight illuminance you should try to model a thermal zone
consisting of several similar rooms separated by interior
walls as a representative room with a zone multiplier (ref:
Zone). An example of this is shown in Figure.
Room-1 is the representative room, with a zone multiplier =
4.
Interior walls IW-1, IW-2 and IW-3 should be treated as
adiabatic, i.e., they should have Outside Boundary Condition =
Surface and Outside Boundary Condition Object = IW-1, IW-2, or
IW-3, respectively (ref: BuildingSurface:Detailed). Similarly,
if the ceiling and floor of Room-1 are interior surfaces, they
should be treated as adiabatic.
For daylighting purposes the
thermal zone enclosed by the dashed boundary line should be
modeled as a typical zone (Room-1) with a zone multiplier of
4.
Sometimes a representative room cannot be found. Figure
shows a section of a building with four rooms having different
daylighting characteristics because of different floor area,
orientation and/or window size. In this case lumping the rooms
into a single thermal zone would give nonsensical daylighting
illuminance values because of the presence of the interior
walls, which EnergyPlus ignores when calculating illuminance
reaching a reference point directly from a window (i.e.,
without reflection). The solution in this case is to describe
each room as a separate thermal zone with its own daylighting
reference points, and input the interior walls because these
will participate in the calculation of inter-reflected
illuminance.
Rooms A, B, C and D have
different daylighting characteristics. If lumped into a single
thermal zone the daylighting calculation will be less accurate
because the blockage of direct light by the interior walls
between these rooms is modeled with some simplifications (see
Interior Obstructions below). To get a good daylighting
calculation each room should be input as a separate thermal
zone.
The SplitFlux daylighting calculation allows a thermal zone
to be divided into multiple independently-controlled lighting
zones. (See the fields: Daylighting Reference Point Name,
Fraction of Zone
Controlled by Reference Point, and Illuminance Setpoint at
Reference Point.) An example is shown in Figure,
where a relatively deep thermal zone has two lighting zones of
equal area.
Two independently-controlled
lighting zones, each with 50% of the area of the thermal
zone.
Fins,
Overhangs and Other Exterior Obstructions[LINK]
The daylighting calculation accounts for the presence of
exterior obstructions in determining the amount of light that
strikes the windows. For daylighting purposes exterior
obstructions fall into three categories:
Building
surfaces like walls and roofs (in an L-shaped building, for
example).
Surfaces associated with window setback.
Category (1) obstructions can have an associated solar
transmittance schedule (see description of the field
Transmittance Schedule Name for these shading surfaces). If
this schedule is not specified, the surface is opaque (has
zero transmittance).
The daylighting calculation takes the transmittance into
account in determining, for example, how much light enters a
window through a translucent awning. It is assumed that the
solar and visible transmittance is the same and that the
surfaces are non-diffusing, i.e., they do not change the
direction of transmitted light. Ref:Daylighting:Controls.
Category (2) and (3) surfaces are assumed to be opaque.
Surfaces in all three categories are assumed to be black,
i.e., they do not reflect light, unless you set if
“Reflections” option is chosen in the Building
object. Then obstructions can reflect light, such as the top
of an overhang reflecting light onto the window above. Ref: Building,
Field: Solar Distribution (with reflections options).
The daylighting calculation accounts for the presence of
interior obstructions that lie between a window and a
reference point. Unlike exterior obstructions, which can be
light transmitting, interior obstructions are assumed to be
opaque. Interior obstructions can reduce or eliminate the
light directly reaching the reference point through a
window.
However, interior obstructions that are walls, ceilings or
floors are reflecting so they contribute to the
inter-reflected component of daylight illuminance as do the
non-obstructing zone surfaces.
Interior obstructions can belong to the Shading object
series. This type of obstruction is assumed to be
non-reflecting so does not contribute to the inter-reflected
component of daylight illuminance.
An example of an interior obstruction that is a wall in an
L-shaped room is shown in Figure.
Here, wall A (or, equivalently, Wall B) prevents light from
directly getting to the Reference Point from the window.
Wall A (or Wall B) is an
interior obstruction that prevents light from directly
reaching the daylighting reference point from the
window.
Double
Façades: Daylighting through Interior Windows[LINK]
The Daylighting:Controls
method, with no additional user input, calculates the
contribution of daylight that passes into a target zone
through interior windows. The origin of this daylight is
exterior windows in adjacent zones that share interior windows
with the target zone. This capability is aimed at daylighting
through a double façade (also called “double
envelope” or “double skin.”)
This is illustrated in Figure,
which shows a double-façade buffer zone, Z0, with exterior
windows EW1 and EW2. Z0 shares interior windows IW1, IW2 and
IW3 with daylit occupied zones ZD1, ZD2 and ZD3, respectively
(“daylit” here means the zone has an associated Daylighting:Controls
object). The daylight illuminance at reference points RP1, RP2
and RP3 comes from the interior windows and has two main
sources:
Daylight that passes through both an exterior window
and an interior window in Z0 and reaches a reference point
without reflection. This is called “direct
illuminance.”
Daylight from Z0 that passes through an interior window
and reaches a reference point by inter-reflection in the
daylit zone. Because the program calculates this source from
the interior solar distribution in Z0 it is recommended that
the most accurate calculation of this distribution be made,
which occurs if Solar Distribution = FullInteriorAndExterior
in the Building
object.
A third possible source is neglected because it is
generally small in double-façade cases. This is daylight that
is reflected from the surfaces of Z0, passes through an
interior window and then reaches a reference point without
inter-reflection in the daylit zone.
PurchAirWithDoubleFacadeDaylighting.idf is an input example
of daylighting through an interior window.
Vertical section through a
double-façade building showing daylighting through interior
windows. The dashed lines show that (1) reference point RP1
receives direct light from exterior window EW1 via interior
window IW1; (2) RP2 receives direct light from EW1 and EW2 via
IW2; and (3) RP3 receives direct light from EW2 via
IW3.
Interior
Window Daylighting Configurations that EnergyPlus Can
Calculate[LINK]
Figure
shows schematically the general configuration of daylighting
through interior windows that can be calculated with
EnergyPlus. Here, daylit zone ZD has one or more interior
windows that are adjacent to other zones, each of which has
one or more exterior windows. ZD itself may or may not have
exterior windows. If it does, than the daylight illuminance
from its exterior and interior windows will be additive. The
zones adjacent to ZD may or may not be daylit and may or may
not have other interior windows that are not adjacent to ZD.
(The program does not consider the illuminance in ZD from
electric lighting in adjacent zones.)
General configuration of
daylighting through interior windows that can be calculated
with EnergyPlus. IW = interior window, EW = exterior
window.
Interior
Window Daylighting Configurations that EnergyPlus Cannot
Calculate[LINK]
Figure
shows schematically a configuration of daylighting through
interior windows that cannot be calculated with EnergyPlus.
Here, zone Z has an interior window that is adjacent to zone
Z1 which in turn has an interior window adjacent to zone Z2.
However, the daylight from the exterior window in Z2 that
enters Z after passing through Z1 is not calculated because Z2
is not adjacent to Z.
Configuration in which
daylighting of zone Z through its interior window cannot be
calculated with EnergyPlus. IW = interior window, EW =
exterior window.
There are two restrictions on the use of exterior-window
shading devices when a daylit zone has interior windows:
1) If two daylit zones share an interior window, neither
zone can have an exterior window whose shading device does
glare control (i.e., the WindowProperty:ShadingControl
for the exterior window has Glare Control Is Active =
Yes).
2) If two daylit zones share an interior window, neither
zone can have an exterior window with a WindowProperty:ShadingControl
that has Shading Control Type =
MeetDaylightIlluminanceSetpoint.
The DElight method of analyzing daylighting in buildings is
very similar to that used in the SplitFlux method and uses the
same Daylighting:Controls
and Daylighting:ReferencePoint
objects but the Daylighting Method should be set to DElight.
For each point in time, DElight calculates the interior
daylighting illuminance at specified reference points and then
determines how much the electric lighting can be reduced while
still achieving a combined daylighting and electric lighting
illuminance target. The daylight illuminance level in a zone
depends on many factors, including exterior light sources;
location, size, and visible light transmittance of simple and
complex fenestration systems; reflectance of interior
surfaces; and location of calculation reference points. The
subsequent reduction of electric lighting depends on daylight
illuminance level, illuminance set point, fraction of zone
controlled, and type of lighting control.
There are two primary differences between the SplitFlux and
DElight methods of calculating interior illuminance levels.
The first is that DElight includes the capability of analyzing
complex fenestration systems that include geometrically
complicated shading systems (e.g., roof monitors) and/or
optically complicated glazings (e.g., prismatic or holographic
glass). The second key difference is that DElight uses a
radiosity method to calculate the effects of light reflection
inside a zone. These methods are discussed in more detail in
the engineering documentation.
There are other important differences between the two
methods. One is the inability of DElight to perform the type
of dynamic shading controls possible using the SplitFlux
method at each point in time during the thermal simulation
(e.g., changes in electrochromic glazing transmittances and
blind slat angles). A second is the current lack of visual
quality (e.g., glare) calculations performed by DElight.
Third, the modeling of interior obstructions is different in
the two methods. In the DElight method interior obstructions
block interreflections but do not block the intial direct
illuminance. In the SplitFlux method, interior obstructions
block the initial direct illuminance but do not block
interreflections. See the engineering documentation for more
details. Fourth, when using DElight daylighting the presence
of exterior shading surfaces such as overhangs is ignored.
Another input object that can only be used when the DElight
Daylighting Method is used is the
Daylighting:DElight:ComplexFenestration object. The DElight
daylighting analysis method can be applied to daylighting
zones that contain only simple fenestration systems such as
windows and skylights that are standard EnergyPlus
sub-surfaces. In this situation, no
Daylighting:DElight:ComplexFenestration object would be
input.
In addition to analyzing simple fenestration systems,
DElight includes the capability of analyzing complex
fenestration systems such as geometrically complicated static
shading systems (e.g., roof monitors) and/or optically
complicated glazings (e.g., prismatic or holographic glass).
This capability is based on characterizing these complex
fenestration systems (CFS) using bi-directional transmittance
distribution functions (BTDF). In general, BTDF data for a
specific CFS must be either measured or simulated (e.g., using
ray-tracing techniques) prior to employing DElight to analyze
it within EnergyPlus. The current implementation of DElight
CFS calculations within EnergyPlus supports two approaches to
the input of BTDF, an analytical approach and a file-based
approach. The details of inputting these two approaches are
described below under the User Complex Fenestration Type
field.
Two analytical CFS BTDF types are currently supported,
window and light shelf. The file-based approach requires that
a user has access to a data file containing raw BTDF data that
DElight reads as additional input during its analysis
calculations. BTDF data files are described separately since
it is anticipated that individual EnergyPlus users will not
create these data files themselves.
The methods related to characterizing and analyzing CFS
using BTDF are still evolving. DElight is an early
implementation of CFS analysis methods. These methods, and the
input associated with them here, will likely change in the
future.
The first form above is for supported analytical CFS types
which currently include WINDOW and LIGHTSHELF. While these
analytical types are relatively simple, they represent
flexible ways to explore diffusing CFS systems and the impact
of light shelves in redirecting light through an aperture.
Each of these types also requires the visible transmittance of
the CFS at normal incidence angle, and a dispersion angle (in
degrees) that represents the “spread” of transmitted light. A
small dispersion angle of 10 corresponds to clear glazing
while a large angle of 90 corresponds to perfectly diffusing
glazing. The “^” symbol must be used as a delimiter between
sub-fields within this Complex Fenestration type name string
as shown in the IDF example for WINDOW below, and in the
DElight sample input data files.
The second form above is for CFS types for which there is
pre-measured or pre-simulated BTDF data. In this case the
Filename sub-field must be a valid data file name that is
associated with an existing BTDF dataset that DElight can use
in its calculations.
The name of the heat transfer surface object instance
hosting this Complex Fenestration, analogous to the Building
Surface Name field for subsurfaces such as Windows. This must
be a valid name that has been associated with a heat transfer
surface contained in the same EnergyPlus input data file.
The name of the Window
(ref: FenestrationSurface:Detailed
object) instance that will be used to account for the
geometry, and the solar/thermal gains/losses, of the Complex
Fenestration system surface. This must be a valid name that
has been associated with a Window
contained in the same EnergyPlus input data file. The geometry
for the Complex Fenestration is taken from the geometry input
for this standard EnergyPlus subsurface, hence the term
“Doppelganger.”
Note that DElight only deals with the visible spectrum of
light transmitted through a Complex Fenestration. To account
for the solar/thermal influences of a Complex Fenestration, a
geometrically coincident subsurface that will be accounted for
by methods already within EnergyPlus must be defined in the
input data file. This is an interim solution to the issue of
accounting for solar/thermal influences that will likely
change as techniques analogous to the daylighting analysis of
BTDF are developed.
The in-plane counter-clockwise rotation angle between the
Complex Fenestration optical reference direction and the base
edge of the Doppelganger Surface geometry. The Complex
Fenestration optical reference direction is the direction of
the zero azimuth angle for the BDTF dataset. This Rotation
angle will typically be zero when the Doppelganger surface is
rectangular and its width edge is aligned with the Complex
Fenestration optical reference direction.
An IDF example for an analytical WINDOW type CFS:
Daylighting:DELight:ComplexFenestration,
Window CFS, !- DElight Complex Fenestration User Name
BTDF^GEN^WINDOW^1.0^20.0, !- Complex Fenestration Type
ZN003:WALL001, !- Complex Fenestration Host Surface
Zn003:Wall001:Doppel001, !- Doppelganger Surface Name
0.0; !- Fenestration Rotation {deg}
In addition to the daylighting-specific outputs for DElight
listed below, two ASCII text files are created during an
EnergyPlus run that includes DElight analysis. Following
completion of an EnergyPlus run, these files are given names
that consist of the project name appended with DElight.in and
DElight.out. The format of these files is described in the
Output Details and Examples document.
Zone,Average,Daylighting Reference Point Illuminance
[lux]
Zone,Average,Daylighting Lighting Power Multiplier []
Daylighting
Reference Point Illuminance [lux][LINK]
The total daylight illuminance at a DElight reference point
from all of the exterior windows in a daylit zone.
The amount by which the overhead electric lighting power in
a zone is multiplied due to usage of DElight calculated
daylighting to dim or switch electric lights. For example, if
the multiplier is M and the electric power without dimming is
P, then the electric power with dimming is M*P. The multiplier
varies from 0.0, which corresponds to maximum dimming (zero
electric lighting), to 1.0, which corresponds to no
dimming.
Beam normal illuminance of the sun at the earth’s surface,
measured in lux (lumens/m\(^{2}\))
Site
Exterior Horizontal Beam Illuminance [lux][LINK]
Beam illuminance on an unobstructed horizontal plane at the
earth’s surface. Equals “Site Exterior Beam Normal
Illuminance” times sine of solar altitude.
Site
Exterior Horizontal Sky Illuminance [lux][LINK]
Illuminance from sky solar radiation on an unobstructed
horizontal plane at the earth’s surface. The total exterior
horizontal illuminance is the sum of “Site Exterior Horizontal
Beam Illuminance” and “Site Exterior Horizontal Sky
Illuminance.”
Site
Beam Solar Radiation Luminous Efficacy [lum/W][LINK]
A measure of the visible light content of beam solar
radiation; equal to the number of lumens per watt of beam
solar radiation. Depends on atmospheric conditions (moisture,
turbidity, cloudiness) and solar altitude.
Site
Sky Diffuse Solar Radiation Luminous Efficacy [lum/W][LINK]
A measure of the visible light content of sky diffuse solar
radiation; equal to the number of lumens per watt of sky
diffuse solar radiation. Depends on atmospheric conditions
(moisture, turbidity, cloudiness) and solar altitude.
Clearness of sky. One of the factors used to determine sky
type and luminous efficacy of solar radiation (see
EnergyPlus Engineering Document). Sky Clearness close
to 1.0 corresponds to an overcast sky. Sky Clearness > 6 is
a clear sky.
Brightness of sky. One of the factors used to determine sky
type and luminous efficacy of solar radiation (see
EnergyPlus Engineering Document).
Daylighting
Window Reference Point <x> View Luminance [cd/m2][LINK]
The area-averaged luminance of an exterior window as viewed
from the first reference point in the daylit zone containing
the window. In general, higher window luminance values are
associated with higher daylight glare values. (Printed only
for exterior windows in daylit zones without interior
windows.)
Daylighting
Window Reference Point <x> Illuminance [lux][LINK]
The contribution from a particular exterior window to the
daylight illuminance at the first reference point in the
daylit zone containing the window. (Not printed for exterior
windows in daylit zones with interior windows.)
Daylighting
Reference Point <x> Illuminance [lux][LINK]
The total daylight illuminance at the first reference point
from all of the windows in a daylit zone.
Daylighting
Reference Point <x> Glare Index [][LINK]
The daylight glare index at the first reference point in a
daylit zone.
Daylighting
Reference Point <x> Glare Index Setpoint Exceeded Time
[hr][LINK]
The number of hours when the calculated daylight glare
index at the first reference point exceeds the glare index
setpoint.
Daylighting
Reference Point <x> Daylight Illuminance Setpoint
Exceeded Time [hr][LINK]
The number of hours when the calculated daylight
illuminance at the first reference point exceeds the daylight
illuminance setpoint.
The amount by which the overhead electric lighting power in
a zone is multiplied due to usage of daylighting to dim or
switch electric lights. For example, if the multiplier is M
and the electric power without dimming is P, then the electric
power with dimming is M*P. The multiplier varies from 0.0,
which corresponds to maximum dimming (zero electric lighting),
to 1.0, which corresponds to no dimming.
The Output:IlluminanceMap
object expands on the reporting capabilities of the
daylighting simulation. For any zone simulated with Daylighting:Controls,
the illuminance map can generate up to 2,500 points of
additional daylighting illuminance values. The resulting map
is output as a comma delimited text file that can be imported
into a spreadsheet program for rapid visualization of the
daylighting illuminance patterns in a zone. The values are
produced on an hourly basis. The Z height of the map is
constant (parallel to a flat floor). More than one illuminance
map can be created for a zone.
The number of daylighting reference points in the X
direction from the minimum to the maximum boundaries. The
maximum number of points that can be generated is 2500 (Number
of X Grid Points X Number of Y Grid Points).
The number of daylighting reference points in the Y
direction from the minimum to the maximum boundaries. The
maximum number of points that can be generated is 2500 (Number
of X Grid Points X Number of Y Grid Points).
Note: Daylighting factors cannot be accurately calculated
for reference points that are very close to a wall or window
(less than 0.15 m or 6 inches). An error is reported for a
reference point that is too close to a window, but no error is
reported for a point that is too close to a wall.
Output:IlluminanceMap,
Daylit Map, ! Map Name
Daylit Zone, ! Zone Name
0, ! Z Height [m]
0.1, ! X Minimum Coordinate [m]
4.9, ! X Maximum Coordinate [m]
10, ! Number of X Grid Points
0.1, ! Y Minimum Coordinate [m]
9.9, ! Y Maximum Coordinate [m]
10; ! Number of Y grid Points
Since not all zones are rectangular, it is possible to have
map points that are outside the zone. Any illuminance
registered at these points is inaccurate and, additionally, a
“*” marks these values for easy observance.
This object specifies the “style” for the illuminance map
output (described in the Output Details and Examples
document). As described early in the document (see: EnergyPlus
Output Processing), the user may select the “style” for the
daylighting illuminance map output file
(eplusmap.<ext>).
For this field, the desired separator for columns is
entered. “Comma” creates comma separated fields/columns in the
outputs (eplusmap.csv file is created). “Tab” creates tab
separated fields/columns in the outputs (eplusmap.tab file is
created). “Fixed” creates space separated fields/columns in
the outputs (eplusmap.txt file is created) but these are not
necessarily lined up for easy printing.
Note that both tab and comma separated files easily import
into Excel™ or other spreadsheet programs. The tab delimited
files can also be viewed by text editors, word processing
programs and easily converted to “tables” within those
programs.
Daylighting devices work in conjunction with the Daylighting:Controls
object to simulate components that can improve daylighting in
a zone.
Daylighting devices are also tightly integrated into the
zone heat balance. The thermal effects of these devices are
simulated with or without the use of a Daylighting:Controls
object.
There are two types of daylighting device in EnergyPlus:
tubular daylighting devices and daylighting shelves.
Tubular daylighting devices (TDDs), also known as tubular
skylights or light pipes, are used to bring natural exterior
daylight into the hard-to-reach, interior spaces of a
building.
TDDs consist of three components: a dome, a pipe, and a
diffuser.
Tubular daylighting device
diagram.
In EnergyPlus each of these components corresponds to an
object in the input file.
The dome and diffuser are defined in the same way as
windows using the FenestrationSurface:Detailed
object. The Surface Type field must be specified as
TubularDaylightDome or TubularDaylightDiffuser
accordingly.
The location and orientation of the dome surface affect the
total amount of daylight collected.
The Base Surface of the diffuser object determines
to which zone the daylighting is delivered. The location and
orientation of the diffuser surface affect the amount of
daylight received at the Daylighting:Controls
reference points.
Although the object definition is the same as for a window,
there are several restrictions on TubularDaylightDome and
TubularDaylightDiffuser objects:
Shading control devices are not allowed.
Frames and dividers are not allowed.
Multipliers must be 1.0.
Dome, diffuser, and pipe areas (as given by diameter)
must be approximately equal.
Outside face environment objects are not
allowed.
Dome and diffuser constructions cannot be more than one
layer.
Since commercial TDDs are assumed to be cylindrical in
shape, it is recommended that the circular areas of the actual
dome and diffuser be approximated with a square of equivalent
area for the TubularDaylightDome and TubularDaylightDiffuser
objects. Although it is possible to use a triangular surface
instead, a square is a much better geometric approximation of
a circle.
Note that the TubularDaylightDome surface is allowed to
have a different position and tilt from the roof base surface.
If the actual TDD projects some height above the roof surface,
the TubularDaylightDome coordinates should be located
accordingly.
Tubular daylighting device DXF
output.
The TubularDaylightDome surface automatically casts a
shadow on the roof base surface. However, since the pipe is
not represented by a surface, it will not cast a shadow. If
this effect must be simulated, one or more SURFACE:SHADING
objects can be used.
The dome and diffuser objects are connected by the
DAYLIGHTING DEVICE:TUBULAR object:
The construction of the TDD pipe. The visible and solar
absorptance of the inside material layer determines the
reflectivity of the inner mirrored surface of the TDD. This is
very important for the overall transmittance of the TDD.
The total length [m] of the TDD pipe between the dome and
the diffuser, including the exterior part above the roof. The
exterior length is determined internally by subtracting the
transition zone lengths from the total length.
Length of pipe [m] in the transition zone. This is used for
determining heat gains due to solar absorbed by the pipe in
each transition zone. The distribution of absorbed solar gains
can be customized by adjusting the length of pipe in each
transition zone. The transition zone gain is proportional to
the length of pipe in the zone. If no transition zones are
specified, all solar absorbed by the pipe is lost to the
exterior environment.
The Transition Zone
Name and Transition Zone
Length fields can be repeated for additional transition
zones.
DaylightingDevice:Tubular,
Pipe1, !- Object Name
Dome1, !- Dome Name
Diffuser1, !- Diffuser Name
Reflective Aluminum, !- Construction Name
0.3556, !- Diameter [m] (approximately 14", a standard size)
1.4, !- Total Length [m] (subtract zone lengths to get outdoor exposed length)
0.28, !- Effective Thermal Resistance [m2-K/W] between TubularDaylightDome and TubularDaylightDiffuser
Attic Zone, !- Transition Zone 1 Name
1.1; !- Transition Zone 1 Length [m]
FenestrationSurface:Detailed,
Dome1, !- Subsurface Name
TubularDaylightDome, !- Surface Type
Clear Acrylic Dome, !- Construction Name (only 1 layer allowed in construction)
Attic Roof, !- Base Surface Name
, !- Outside Face Environment (not allowed for TubularDaylightDome)
0.0, !- VF to Ground
, !- Window Shading Control (not allowed for TubularDaylightDome)
, !- Frame/Divider Name (not allowed for TubularDaylightDome)
1.0, !- Multiplier (must be 1.0 for TubularDaylightDome)
4, !- Number of Vertices
2.3425, 3.1575, 3.9,
2.3425, 2.8425, 3.9,
2.6575, 2.8425, 3.9,
2.6575, 3.1575, 3.9;
FenestrationSurface:Detailed,
Diffuser1, !- Subsurface Name
TubularDaylightDiffuser, !- Surface Type
Frosted Acrylic Diffuser, !- Construction Name (only 1 layer allowed in construction)
Daylit Zone Ceiling, !- Base Surface Name
, !- Outside Face Environment (not allowed for TubularDaylightDiffuser)
0.0, !- VF to Ground
, !- Window Shading Control (not allowed for TubularDaylightDiffuser)
, !- Frame/Divider Name (not allowed for TubularDaylightDiffuser)
1.0, !- Multiplier (must be 1.0 for TubularDaylightDiffuser)
4, !- Number of Vertices
2.3425, 3.1575, 2.5,
2.3425, 2.8425, 2.5,
2.6575, 2.8425, 2.5,
2.6575, 3.1575, 2.5;
This is the transmittance of diffuse visible radiation, or
daylight, through the TDD.
Tubular
Daylighting Device Heat Gain Rate [W][LINK]
This is the rate of heat gain to the zone by the TDD, in
Watts.
Tubular
Daylighting Device Heat Loss Rate [W][LINK]
This is the rate of heat loss from the zone by the TDD, in
Watts.
Tubular
Daylighting Device Pipe Absorbed Solar Radiation Rate [W][LINK]
This is the rate at which solar radiation is absorbed by
the pipe in the TDD, in Watts.
Tubular
Daylighting Device Transmitted Solar Radiation Rate [W][LINK]
This is the rate at which solar radiation is transmitted by
the TDD, in Watts.
In addition, several surface and window variables are also
reported for the TubularDaylightDome and
TubularDaylightDiffuser objects. For the
TubularDaylightDome:
Zone,Average,Surface Outside Face Sunlit Area
[m2]
Zone,Average,Surface Outside Face Sunlit Fraction
[]
Zone,Average,Surface Outside Face Incident Solar
Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Incident Beam Solar
Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Incident Sky Diffuse
Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Incident Ground
Diffuse Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Beam Solar Incident
Angle Cosine Value[]
Zone,Average,Surface Window
Transmitted Solar Radiation Rate [W]
Zone,Average,Surface Window
Total Glazing Layers Absorbed Solar Radiation Rate
[W]
For the TubularDaylightDiffuser:
Zone,Average,Surface Outside Face Incident Solar
Radiation Rate per Area[W/m2] (incident inside of
pipe)
Zone,Average,Surface Window
Transmitted Solar Radiation Rate [W] (same as Tubular
Daylighting Device Transmitted Solar Radiation
Rate)
Zone,Average,Surface Window
Total Glazing Layers Absorbed Solar Radiation Rate
[W]
Daylighting shelves, or simply light shelves, are another
device for bringing more daylight into a building. Installed
as an accessory to a window, daylighting shelves work by
reflecting exterior light onto the ceiling of a room.
Daylighting shelves can have an inside shelf, an outside
shelf, or both.
Daylighting shelf
diagram.
The inside shelf redistributes light that would have
entered the zone anyway. Instead of entering as a beam, all
light is reflected onto the zone ceiling and is converted to
diffuse shortwave radiation.
The outside shelf changes the amount of light entering the
zone. If the shelf surface is more reflective than the ground,
it can increase the amount of light incident on the upper part
of the window. However, the shading effect of the outside
shelf on the lower part of the window must also be considered
as it can easily negate any gain achieved in the upper part of
the window. All light reflected from the outside shelf that
enters the upper window is assumed to strike the ceiling.
Daylighting shelf DXF
output.
In EnergyPlus a daylighting shelf is simulated using a DaylightingDevice:Shelf
object in combination with up to three other objects: a
window, a heat transfer surface, and an attached shading
surface.
The window must be divided into two window surfaces: an
upper window and a lower window. The upper window interacts
directly with the daylighting shelf object and is not allowed
to have any shading control devices or frames or dividers. The
lower window does not interact with the daylighting shelf
object, but does receive shading from the outside shelf. There
are no restrictions on the lower window.
The inside shelf is defined as a regular heat transfer
surface in the zone. However, the surface must have the
Outside Boundary Condition field set to Surface with
itself as the other zone surface. Shading and thermal mass
effects are taken into account.
The outside shelf is defined as a Shading:Zone:Detailed
object. The visible and solar absorptance of the outside
material layer determines the reflectivity of the shelf.
NOTE: Unlike a regular Shading:Zone:Detailed object, the
vertices of the outside shelf surface must be ordered so that
the outward normal vector points upward, i.e. toward
the upper window. This is necessary in order for the outside
shelf to properly receive sunlight and shading from other
surfaces. A mirror shading surface with the outward normal
vector pointing in the opposite direction is automatically
created by the program to shade the lower window.
The inside shelf and outside shelf are both optional.
However, if neither shelf is specified, the daylighting shelf
object has no effect on the simulation.
Reference to a BuildingSurface:Detailed
object. This field is optional. If used, this surface must
have OTHERZONESURFACE specified for the Outside Face
Environment field and the referenced other zone surface
must be itself. The number of vertices of this surface object
must be 4.
Reference to a CONSTRUCTION object. This field is required
if an outside shelf is specified. The visible and solar
absorptance of the outside material layer determines the shelf
reflectivity.
User defined value for the view factor from the window to
the outside shelf. This field is optional. If not specified,
an exact view factor is calculated for two perpendicular
rectangles of the same width having a shared edge. If the
given surfaces do not meet these geometric requirements, it is
necessary to specify a value here.
NOTE: It is up to the user to adjust the view factor to ground
of the upper window to account for the part of the view
blocked by the outside shelf. The calculated View Factor
To Outside Shelf is reported in the eio file for this
purpose. For the typical case where the shelf is parallel to
the ground and the upper window is perpendicular to the
ground, the view factor to ground is simply: 0.5 – View
Factor To Outside Shelf.
DaylightingDevice:Shelf,
Shelf, !- Name
Daylit Upper Window, !- Window Name
Inside Shelf, !- Inside Shelf Name
Outside Shelf, !- Outside Shelf Name
Shelf Construction; !- Outside Shelf Construction Name (required if outside shelf specified)
! 0.29; !- View Factor To Outside Shelf (optional)
FenestrationSurface:Detailed,
Daylit Upper Window, !- Subsurface Name
Window, !- Surface Type
Standard Window, !- Construction Name
Daylit South Wall, !- Base Surface Name
, !- Outside Face Environment
0.211, !- VF to Ground (user must adjust to account for view factor to outside shelf)
, !- Window Shading Control (not allowed)
, !- Frame/Divider Name (not allowed)
1.0, !- Multiplier (must be 1.0)
4, !- Number of Vertices
1.0, 0.0, 2.8,
1.0, 0.0, 2.0,
4.0, 0.0, 2.0,
4.0, 0.0, 2.8;
BuildingSurface:Detailed,
Inside Shelf, !- Surface Name
Wall, !- Surface Type
Shelf Construction, !- Construction Name
Daylit Zone, !- Zone Name
OtherZoneSurface, !- Exterior Conditions (must be OtherZoneSurface)
Inside Shelf, !- Target (must be itself)
NoSun, !- Solar Exposure
NoWind, !- Wind Exposure
0.0, !- VF to Ground
4, !- Number of Vertices
1.0, 0.0, 2.0,
4.0, 0.0, 2.0,
4.0, 1.0, 2.0,
1.0, 1.0, 2.0;
Shading:Zone:Detailed,
Outside Shelf, !- Surface Name
Daylit South Wall, !- Base Surface Name
, !- Shading Transmittance Schedule (default is always opaque)
4, !- Number of Vertices
1.0, 0.0, 2.0, !- Outward normal vector must point up toward the upper window
1.0, -1.0, 2.0,
4.0, -1.0, 2.0,
4.0, 0.0, 2.0;
This object is used to model the impacts on daylighting of
a “light well” that might be associated with exterior windows
such as skylights. The light well model attenuates the light
transmitted by the skylight. The attenuation is characterized
by the well efficiency, which is the ratio of
the amount of light leaving the well to the amount of light
entering the well. The well efficiency varies from close to
1.0 to close to zero if there is high attenuation. The well
efficiency is used only in the EnergyPlus detailed daylighting
calculation, where it multiplies the beam and diffuse light
transmitted by the skylight. (The well efficiency is not used
in calculating the solar gain through the skylight.)
The input object describes the light well using basic
characteristics of the geometry along with the visible
reflectance of the well’s side walls. The following figure
diagrams how the geometry is characterized.
Skylight with light well: (a)
perspective view, (b) vertical section. If the bottom of the
light well is a rectangle of side lengths c and d, as shown in
(a), then the perimeter of the bottom of the well = 2(c+d) and
the area = cd (see description of field names for the Light
Well object).
The name of the exterior window that this Light Well is
associated with. Generally this is a skylight in a roof.
However, light wells can be applied to an exterior window of
any slope. Light wells can be assigned to both rectangular and
triangular exterior windows, but they should not be assigned
to interior windows. Note that the sides of the light well can
be sloped and the bottom of the light well can be any shape,
not just rectangular.
The distance from the bottom of the skylight to the bottom
of the well. If the skylight and well bottom are not coplanar,
this is the distance from the center of the bottom of the
skylight to center of the bottom of the well. See Figure.
The area of the bottom opening of the well. A warning will
be issued if this area is less that the area of the skylight,
including frame if present. See Figure.
The visible reflectance of the side walls of the well. If
the walls do not all have the same reflectance, an
area-weighted average value can be used. This is the
well-wall reflectance expressed as a fraction.
An IDF example:
DaylightingDevice:LightWell, ! The well is 60% reflecting, is 1.2m high and has a 2.5m x 5.5m bottom opening.
Skylight-1, !- Name of Exterior Window that this Light Well Applies To
1.2, !- Height of Well(m)
16.0, !- Perimeter of Bottom of Well (m)
13.75, !- Area of Bottom of Well (m2)
0.60; !- Visible Reflectance of Well Walls
The following table shows what input objects/fields to use
to model different daylighting options. It also gives the name
of an example input, if available, that demonstrates the
option.
Group – Daylighting[LINK]
Daylighting can be invoked in EnergyPlus primarily by the use of the objects: Daylighting:Controls and Daylighting:ReferencePoint. Other objects related to daylighting are Daylighting:DElight:ComplexFenestration, Output:IlluminanceMap, and OutputControl:IlluminanceMap:Style. These are described in the following object descriptions.
Note that two different methodologies are used in the Daylighting:Controls object (SplitFlux and DElight) and may be intermixed in a single IDF but may not be used in the same zone.
Daylighting:Controls[LINK]
When this object is used, daylighting illuminance levels are calculated and then used to determine how much the electric lighting can be reduced. The daylight illuminance level in a zone depends on many factors, including sky condition; sun position; calculation point; location, size, and glass transmittance of windows; window shading devices; and reflectance of interior surfaces. Reduction of electric lighting depends on daylight illuminance level, illuminance set point, fraction of zone controlled and type of lighting control. Two different methods of computing the daylighitng illuminance and subsequent lighting reduction called SplitFlux and DElight. After the object description below is are sections that describe the two methodologies in more detail.
Inputs[LINK]
Field: Name[LINK]
The name of the Daylighting:Controls object.
Field: Zone name[LINK]
The name of the zone to which the following daylighting-related input applies.
Field: Daylighting Method {#field-Daylighting Method}[LINK]
The Daylighting Method field can be set to either of the following: SplitFlux or DElight. Different Zones can have different settings in the same file but in a single zone only one method should be used at a time. Guidelines for using the SplitFlux method and additional details on the DElight method are shown in following sections.
Field: Availability Schedule Name[LINK]
This alpha field is optional and may be used to define the name of a schedule that denotes whether or not the control is available to operate during a given time period. If the schedule value is greater than zero, then the controls will be available to operate for that time period. If the schedule value is zero or less, then the controls will not be available. If this field is left blank, the controls will be always available. For example, this can be useful for scheduling the daylighting controls off during design days so that the daylighting controls do not affect lighting power during sizing.
Field: Lighting Control Type[LINK]
The type of overhead electric lighting control. All reference points specified are assumed to have this type of control.
For Lighting Control Type set to Continuous, the overhead lights dim continuously and linearly from (maximum electric power, maximum light output) to (minimum electric power, minimum light output) as the daylight illuminance increases. The lights stay on at the minimum point with further increase in the daylight illuminance.
For Lighting Control Type set to Stepped, the electric power input and light output vary in discrete, equally spaced steps. The number of steps is given by Number of Steps (Excluding Off) of Stepped Control. For example, if Number of Steps = 3 and Illuminance Setpoint = 600, then the following table shows the fraction of the lights that are on vs. daylight illuminance.
Lighting Control Type set to ContinuousOff is the same similar to Lighting Control Type set to Continuous except that the lights switch off completely when the minimum dimming point is reached.
Field: Minimum Input Power Fraction for Continuous Dimming Control[LINK]
For Lighting Control Type set to Continuous, the lowest power the lighting system can dim down to, expressed as a fraction of maximum input power (see figure, below). For Lighting Control Type set to ContinuousOff, this is the power fraction reached just before the lights switch off completely.
The figure shows the relationship between electric light output and electrical input.
Field: Minimum Light Output Fraction for Continuous Dimming Control[LINK]
For Lighting Control Type set to Continuous, the lowest lighting output the lighting system can dim down to, expressed as a fraction of maximum light output (see figure). This is the fractional light output that the system produces at minimum input power. For Lighting Control Type set to ContinuousOff, this is the light output fraction reached just before the lights switch off completely.
Field: Number of Stepped Control Steps[LINK]
The number of steps, excluding off, in a stepped lighting control system (see figure, below). Required and must be >0 if Lighting Control Type is set to Stepped. The steps are assumed to be equally spaced.
Field: Probability Lighting will be Reset When Needed in Manual Stepped Control[LINK]
May be specified if a stepped lighting control system (Lighting Control Type set to Stepped) is manually operated, such as in a simple, one-step (on-off) system. Gives the probability the occupants of a daylit zone will set the electric lights to the correct level to obtain the required illuminance. The rest of the time the lights are assumed to be set one step too high. For example, consider an on-off lighting system (Number of Steps = 1) with a set point of 600 lux and 0.7 reset probability. Then, when daylighting exceeds 600 lux, the electric lights will be off 70% of the time and on 30% of the time.
Field: Glare Calculation Daylighting Reference Point Name {#field-glare calculation-daylighting-reference-point-name}[LINK]
The Daylighting:ReferencePoint name should be specified that is used for determining the glare. Only one reference point is used to calculate the glare. This input is only used in when the Daylighting Method is set to SplitFlux. This input is ignored when Daylighting Method is set to DElight.
Field: Glare Calculation Azimuth Angle of View Direction Clockwise from Zone y-Axis[LINK]
Daylight glare from a window depends on occupant view direction. It is highest when you look directly at a window and decreases as you look away from a window. This field specifies the view direction for calculating glare. It is the angle, measured clockwise in the horizontal plane, between the zone y-axis and the occupant view direction. This input is only used in when the Daylighting Method is set to SplitFlux. This input is ignored when Daylighting Method is set to DElight.
Field: Maximum Allowable Discomfort Glare Index[LINK]
If a daylit zone has windows with shading devices (except exterior screens), the shades will be deployed if the daylight glare at Daylighting:ReferencePoint specified in the Glare Calculation Daylighting Reference Point Name field exceeds the value of this field. To get this type of glare control you have to specify Trigger = Glare, GlareOrSolarOnWindow, GlareOrHorizontalSolar, GlareOrOutsideAirTemp, GlareOrZoneAirTemp or GlareOrZoneLoad in WindowProperty:ShadingControl for one or more windows in the zone (see WindowProperty:ShadingControl). This input is only used in when the Daylighting Method is set to SplitFlux. This input is ignored when Daylighting Method is set to DElight.
If a zone has two or more windows with glare control, the shading devices will be deployed one by one in the order in which the windows are input until the glare level at each reference point falls below Maximum Allowable Discomfort Glare Index or is as close as possible to it.
The following table gives recommended values of Maximum Allowable Discomfort Glare Index.
Field: DElight Gridding Resolution[LINK]
The maximum surface area for nodes in gridding (subdividing) all surfaces in the zone when Daylighting Method is set to DElight. All reflective and transmitting surfaces will be subdivided into approximately square nodes that do not exceed this maximum. Higher resolution subdivisions require greater calculation times, but generally produce more accurate results. This same gridding resolution is also used to subdivide any Complex Fenestration System surfaces. It is advisable to perform at least one simulation of new input using a small gridding resolution such as 0.1m2 to compare these results against simulation runs at lower resolution (i.e., higher maximum area nodal grids) to get a sense of possible levels of error. This input is only used in when the Daylighting Method is set to DElight. This input is ignored when Daylighting Method is set to SplitFlux.
Field Set (reference point name, fraction controlled, illuminance setpoint)[LINK]
This set of fields is used together and can be repeated an unlimited number of times to specify some of the name of the reference point, the fraction of the zone lighting controlled by that reference point and the illuminance setpoint that should be applied for daylighting control at that reference point.
Field: Daylighting Reference Point Name <x>[LINK]
The Daylighting:ReferencePoint name should be specified that is used for determining the daylighting control sensor location.
Field: Fraction of Zone Controlled by Reference Point <x>[LINK]
The fraction of the zone’s floor-area whose electric lighting is controlled by the daylight illuminance at the named Daylighting:ReferencePoint. If the sum of the fractions are less than 1.0, the remaining portion is assumed to have no lighting control.
Field: Illuminance Setpoint at Reference Point <x>[LINK]
The desired lighting level (in lux) at the named Daylighting:ReferencePoint. This is the lighting level that would be produced at this reference point at night if the overhead electric lighting were operating at full input power. Recommended values depend on type of activity; they may be found, for example, in the Lighting Handbook of the Illuminating Engineering Society of North America. A typical value for general office work (excluding computer terminals) is 500 lux.
Daylighting:ReferencePoint[LINK]
This object is referenced by Daylighting:Controls to identify the reference point coordinates for each sensor. The reference points in the zone are where horizontal daylighting illuminance will be calculated. It is assumed that the photocells that control the overhead electric lighting respond to the light levels at the specified coordinates. Reference points are given in coordinates specified in the GlobalGeometryRules object Daylighting Reference Point CoordinateSystem field.
When the DElight Daylighting Method is used, there may be up to a maximum of 100 reference points for each zone. Each Reference Point that is input does NOT need to be included in the control of the electric lighting system within the zone. This is determined by the fraction of the zone controlled by each Reference Point, which can be input as 0. Note when the DElight Daylighting Method is used, that the sum of all Reference Point control fractions must equal 1 to obtain correct overall results.
Inputs[LINK]
Field: Name[LINK]
The name of the Daylighting:ReferencePoint object.
Field: Zone name[LINK]
The name of the zone in which the reference point is located.
Fields: (X,Y,Z) Coordinate of Reference Point[LINK]
These three fields are the X, Y and Z values of the reference point in the coordinate system you specified for daylighting reference points in the GlobalGeometryRules object. Figure shows an example using the relative coordinate (to zone) system. Z is typically at desk height (0.8 m).
An IDF example:
Guidelines for Daylighting Modeling Ssing the SplitFlux Method)[LINK]
Following are some guidelines for preparing EnergyPlus input to model the effects of daylighting when using the SplitFlux method. Before studying these guidelines, however, you should read the description of each input field under Daylighting:Controls, Daylighting:ReferencePoint, and review the IDF example, above, and the sample daylighting input, PurchAirWithDaylighting.idf.
Use of Window Multipliers[LINK]
If an exterior wall in a daylit zone has a number of identical windows, the windows should be entered separately rather than using a window multiplier (ref: FenestrationSurface:Detailed). Using a multiplier would give an incorrect illuminance calculation since individual windows would not be positioned correctly on the wall.
Use of Zone Multipliers[LINK]
A zone multiplier should not be used on a daylit zone if the windows in the zone are shadowed by exterior obstructions like trees or neighboring buildings, or by obstructions caused by other parts of building. The reason for this is that the shadowing on the windows of the multiplied zone may be different from zone to zone depending on exactly how the shadows fall on the zones. However, a zone multiplier may be used on a daylit zone if the shadowing is by overhangs, fins and/or window setback.
Thermal Zoning for Daylighting[LINK]
To correctly calculate both direct and inter-reflected daylight illuminance you should try to model a thermal zone consisting of several similar rooms separated by interior walls as a representative room with a zone multiplier (ref: Zone). An example of this is shown in Figure. Room-1 is the representative room, with a zone multiplier = 4.
Interior walls IW-1, IW-2 and IW-3 should be treated as adiabatic, i.e., they should have Outside Boundary Condition = Surface and Outside Boundary Condition Object = IW-1, IW-2, or IW-3, respectively (ref: BuildingSurface:Detailed). Similarly, if the ceiling and floor of Room-1 are interior surfaces, they should be treated as adiabatic.
Sometimes a representative room cannot be found. Figure shows a section of a building with four rooms having different daylighting characteristics because of different floor area, orientation and/or window size. In this case lumping the rooms into a single thermal zone would give nonsensical daylighting illuminance values because of the presence of the interior walls, which EnergyPlus ignores when calculating illuminance reaching a reference point directly from a window (i.e., without reflection). The solution in this case is to describe each room as a separate thermal zone with its own daylighting reference points, and input the interior walls because these will participate in the calculation of inter-reflected illuminance.
Multiple Lighting Zones[LINK]
The SplitFlux daylighting calculation allows a thermal zone to be divided into multiple independently-controlled lighting zones. (See the fields: Daylighting Reference Point Name, Fraction of Zone Controlled by Reference Point, and Illuminance Setpoint at Reference Point.) An example is shown in Figure, where a relatively deep thermal zone has two lighting zones of equal area.
Fins, Overhangs and Other Exterior Obstructions[LINK]
The daylighting calculation accounts for the presence of exterior obstructions in determining the amount of light that strikes the windows. For daylighting purposes exterior obstructions fall into three categories:
Fins, overhangs, trees, neighboring buildings, etc., entered with the objects Shading:Zone:Detailed, Shading:Site:Detailed, or Shading:Building:Detailed.
Building surfaces like walls and roofs (in an L-shaped building, for example).
Surfaces associated with window setback.
Category (1) obstructions can have an associated solar transmittance schedule (see description of the field Transmittance Schedule Name for these shading surfaces). If this schedule is not specified, the surface is opaque (has zero transmittance).
The daylighting calculation takes the transmittance into account in determining, for example, how much light enters a window through a translucent awning. It is assumed that the solar and visible transmittance is the same and that the surfaces are non-diffusing, i.e., they do not change the direction of transmitted light. Ref:Daylighting:Controls.
Category (2) and (3) surfaces are assumed to be opaque.
Surfaces in all three categories are assumed to be black, i.e., they do not reflect light, unless you set if “Reflections” option is chosen in the Building object. Then obstructions can reflect light, such as the top of an overhang reflecting light onto the window above. Ref: Building, Field: Solar Distribution (with reflections options).
Interior Obstructions[LINK]
The daylighting calculation accounts for the presence of interior obstructions that lie between a window and a reference point. Unlike exterior obstructions, which can be light transmitting, interior obstructions are assumed to be opaque. Interior obstructions can reduce or eliminate the light directly reaching the reference point through a window.
However, interior obstructions that are walls, ceilings or floors are reflecting so they contribute to the inter-reflected component of daylight illuminance as do the non-obstructing zone surfaces.
Interior obstructions can belong to the Shading object series. This type of obstruction is assumed to be non-reflecting so does not contribute to the inter-reflected component of daylight illuminance.
An example of an interior obstruction that is a wall in an L-shaped room is shown in Figure. Here, wall A (or, equivalently, Wall B) prevents light from directly getting to the Reference Point from the window.
Double Façades: Daylighting through Interior Windows[LINK]
The Daylighting:Controls method, with no additional user input, calculates the contribution of daylight that passes into a target zone through interior windows. The origin of this daylight is exterior windows in adjacent zones that share interior windows with the target zone. This capability is aimed at daylighting through a double façade (also called “double envelope” or “double skin.”)
This is illustrated in Figure, which shows a double-façade buffer zone, Z0, with exterior windows EW1 and EW2. Z0 shares interior windows IW1, IW2 and IW3 with daylit occupied zones ZD1, ZD2 and ZD3, respectively (“daylit” here means the zone has an associated Daylighting:Controls object). The daylight illuminance at reference points RP1, RP2 and RP3 comes from the interior windows and has two main sources:
Daylight that passes through both an exterior window and an interior window in Z0 and reaches a reference point without reflection. This is called “direct illuminance.”
Daylight from Z0 that passes through an interior window and reaches a reference point by inter-reflection in the daylit zone. Because the program calculates this source from the interior solar distribution in Z0 it is recommended that the most accurate calculation of this distribution be made, which occurs if Solar Distribution = FullInteriorAndExterior in the Building object.
A third possible source is neglected because it is generally small in double-façade cases. This is daylight that is reflected from the surfaces of Z0, passes through an interior window and then reaches a reference point without inter-reflection in the daylit zone.
PurchAirWithDoubleFacadeDaylighting.idf is an input example of daylighting through an interior window.
Interior Window Daylighting Configurations that EnergyPlus Can Calculate[LINK]
Figure shows schematically the general configuration of daylighting through interior windows that can be calculated with EnergyPlus. Here, daylit zone ZD has one or more interior windows that are adjacent to other zones, each of which has one or more exterior windows. ZD itself may or may not have exterior windows. If it does, than the daylight illuminance from its exterior and interior windows will be additive. The zones adjacent to ZD may or may not be daylit and may or may not have other interior windows that are not adjacent to ZD. (The program does not consider the illuminance in ZD from electric lighting in adjacent zones.)
Interior Window Daylighting Configurations that EnergyPlus Cannot Calculate[LINK]
Figure shows schematically a configuration of daylighting through interior windows that cannot be calculated with EnergyPlus. Here, zone Z has an interior window that is adjacent to zone Z1 which in turn has an interior window adjacent to zone Z2. However, the daylight from the exterior window in Z2 that enters Z after passing through Z1 is not calculated because Z2 is not adjacent to Z.
Restrictions on Shading Devices[LINK]
There are two restrictions on the use of exterior-window shading devices when a daylit zone has interior windows:
1) If two daylit zones share an interior window, neither zone can have an exterior window whose shading device does glare control (i.e., the WindowProperty:ShadingControl for the exterior window has Glare Control Is Active = Yes).
2) If two daylit zones share an interior window, neither zone can have an exterior window with a WindowProperty:ShadingControl that has Shading Control Type = MeetDaylightIlluminanceSetpoint.
DElight Daylighting Method[LINK]
The DElight method of analyzing daylighting in buildings is very similar to that used in the SplitFlux method and uses the same Daylighting:Controls and Daylighting:ReferencePoint objects but the Daylighting Method should be set to DElight. For each point in time, DElight calculates the interior daylighting illuminance at specified reference points and then determines how much the electric lighting can be reduced while still achieving a combined daylighting and electric lighting illuminance target. The daylight illuminance level in a zone depends on many factors, including exterior light sources; location, size, and visible light transmittance of simple and complex fenestration systems; reflectance of interior surfaces; and location of calculation reference points. The subsequent reduction of electric lighting depends on daylight illuminance level, illuminance set point, fraction of zone controlled, and type of lighting control.
There are two primary differences between the SplitFlux and DElight methods of calculating interior illuminance levels. The first is that DElight includes the capability of analyzing complex fenestration systems that include geometrically complicated shading systems (e.g., roof monitors) and/or optically complicated glazings (e.g., prismatic or holographic glass). The second key difference is that DElight uses a radiosity method to calculate the effects of light reflection inside a zone. These methods are discussed in more detail in the engineering documentation.
There are other important differences between the two methods. One is the inability of DElight to perform the type of dynamic shading controls possible using the SplitFlux method at each point in time during the thermal simulation (e.g., changes in electrochromic glazing transmittances and blind slat angles). A second is the current lack of visual quality (e.g., glare) calculations performed by DElight. Third, the modeling of interior obstructions is different in the two methods. In the DElight method interior obstructions block interreflections but do not block the intial direct illuminance. In the SplitFlux method, interior obstructions block the initial direct illuminance but do not block interreflections. See the engineering documentation for more details. Fourth, when using DElight daylighting the presence of exterior shading surfaces such as overhangs is ignored.
Input for invoking the DElight method involves three object types: Daylighting:Controls, Daylighting:ReferencePoint, and Daylighting:DELight:ComplexFenestration.
Daylighting:DELight:ComplexFenestration[LINK]
Another input object that can only be used when the DElight Daylighting Method is used is the Daylighting:DElight:ComplexFenestration object. The DElight daylighting analysis method can be applied to daylighting zones that contain only simple fenestration systems such as windows and skylights that are standard EnergyPlus sub-surfaces. In this situation, no Daylighting:DElight:ComplexFenestration object would be input.
In addition to analyzing simple fenestration systems, DElight includes the capability of analyzing complex fenestration systems such as geometrically complicated static shading systems (e.g., roof monitors) and/or optically complicated glazings (e.g., prismatic or holographic glass). This capability is based on characterizing these complex fenestration systems (CFS) using bi-directional transmittance distribution functions (BTDF). In general, BTDF data for a specific CFS must be either measured or simulated (e.g., using ray-tracing techniques) prior to employing DElight to analyze it within EnergyPlus. The current implementation of DElight CFS calculations within EnergyPlus supports two approaches to the input of BTDF, an analytical approach and a file-based approach. The details of inputting these two approaches are described below under the User Complex Fenestration Type field.
Two analytical CFS BTDF types are currently supported, window and light shelf. The file-based approach requires that a user has access to a data file containing raw BTDF data that DElight reads as additional input during its analysis calculations. BTDF data files are described separately since it is anticipated that individual EnergyPlus users will not create these data files themselves.
The methods related to characterizing and analyzing CFS using BTDF are still evolving. DElight is an early implementation of CFS analysis methods. These methods, and the input associated with them here, will likely change in the future.
Inputs[LINK]
Field: User Name[LINK]
User name of the DElight daylighting Complex Fenestration to which the following input applies.
Field: Complex Fenestration Type[LINK]
Type name of the DElight daylighting Complex Fenestration system to be analyzed. This type name must take one of the following two forms.
The first form above is for supported analytical CFS types which currently include WINDOW and LIGHTSHELF. While these analytical types are relatively simple, they represent flexible ways to explore diffusing CFS systems and the impact of light shelves in redirecting light through an aperture. Each of these types also requires the visible transmittance of the CFS at normal incidence angle, and a dispersion angle (in degrees) that represents the “spread” of transmitted light. A small dispersion angle of 10 corresponds to clear glazing while a large angle of 90 corresponds to perfectly diffusing glazing. The “^” symbol must be used as a delimiter between sub-fields within this Complex Fenestration type name string as shown in the IDF example for WINDOW below, and in the DElight sample input data files.
The second form above is for CFS types for which there is pre-measured or pre-simulated BTDF data. In this case the Filename sub-field must be a valid data file name that is associated with an existing BTDF dataset that DElight can use in its calculations.
Field: Building Surface Name[LINK]
The name of the heat transfer surface object instance hosting this Complex Fenestration, analogous to the Building Surface Name field for subsurfaces such as Windows. This must be a valid name that has been associated with a heat transfer surface contained in the same EnergyPlus input data file.
Field: Window Name[LINK]
The name of the Window (ref: FenestrationSurface:Detailed object) instance that will be used to account for the geometry, and the solar/thermal gains/losses, of the Complex Fenestration system surface. This must be a valid name that has been associated with a Window contained in the same EnergyPlus input data file. The geometry for the Complex Fenestration is taken from the geometry input for this standard EnergyPlus subsurface, hence the term “Doppelganger.”
Note that DElight only deals with the visible spectrum of light transmitted through a Complex Fenestration. To account for the solar/thermal influences of a Complex Fenestration, a geometrically coincident subsurface that will be accounted for by methods already within EnergyPlus must be defined in the input data file. This is an interim solution to the issue of accounting for solar/thermal influences that will likely change as techniques analogous to the daylighting analysis of BTDF are developed.
Field: Fenestration Rotation[LINK]
The in-plane counter-clockwise rotation angle between the Complex Fenestration optical reference direction and the base edge of the Doppelganger Surface geometry. The Complex Fenestration optical reference direction is the direction of the zero azimuth angle for the BDTF dataset. This Rotation angle will typically be zero when the Doppelganger surface is rectangular and its width edge is aligned with the Complex Fenestration optical reference direction.
An IDF example for an analytical WINDOW type CFS:
Outputs[LINK]
In addition to the daylighting-specific outputs for DElight listed below, two ASCII text files are created during an EnergyPlus run that includes DElight analysis. Following completion of an EnergyPlus run, these files are given names that consist of the project name appended with DElight.in and DElight.out. The format of these files is described in the Output Details and Examples document.
Zone,Average,Daylighting Reference Point Illuminance [lux]
Zone,Average,Daylighting Lighting Power Multiplier []
Daylighting Reference Point Illuminance [lux][LINK]
The total daylight illuminance at a DElight reference point from all of the exterior windows in a daylit zone.
Daylighting Lighting Power Multiplier [][LINK]
The amount by which the overhead electric lighting power in a zone is multiplied due to usage of DElight calculated daylighting to dim or switch electric lights. For example, if the multiplier is M and the electric power without dimming is P, then the electric power with dimming is M*P. The multiplier varies from 0.0, which corresponds to maximum dimming (zero electric lighting), to 1.0, which corresponds to no dimming.
Outputs[LINK]
The following daylighting-specific outputs are available for Daylighting:Controls:
Zone,Average,Site Exterior Beam Normal Illuminance [lux]
Zone,Average,Site Exterior Horizontal Beam Illuminance [lux]
Zone,Average,Site Exterior Horizontal Sky Illuminance [lux]
Zone,Average,Site Beam Solar Radiation Luminous Efficacy [lum/W]
Zone,Average,Site Sky Diffuse Solar Radiation Luminous Efficacy [lum/W]
Zone,Average,Site Daylighting Model Sky Clearness []
Zone,Average,Site Daylighting Model Sky Brightness []
Surface,Average,Daylighting Window Reference Point <x> View Luminance [cd/m2]
Surface,Average,Daylighting Window Reference Point <x> Illuminance [lux]
Zone,Average,Daylighting Reference Point <x> Illuminance [lux]
Zone,Average,Daylighting Reference Point <x> Glare Index []
Zone,Sum,Daylighting Reference Point <x> Glare Index Setpoint Exceeded Time [hr]
Zone,Sum,Daylighting Reference Point <x> Daylight Illuminance Setpoint Exceeded Time [hr]
Zone,Average,Daylighting Lighting Power Multiplier []
Site Exterior Beam Normal Illuminance [lux][LINK]
Beam normal illuminance of the sun at the earth’s surface, measured in lux (lumens/m\(^{2}\))
Site Exterior Horizontal Beam Illuminance [lux][LINK]
Beam illuminance on an unobstructed horizontal plane at the earth’s surface. Equals “Site Exterior Beam Normal Illuminance” times sine of solar altitude.
Site Exterior Horizontal Sky Illuminance [lux][LINK]
Illuminance from sky solar radiation on an unobstructed horizontal plane at the earth’s surface. The total exterior horizontal illuminance is the sum of “Site Exterior Horizontal Beam Illuminance” and “Site Exterior Horizontal Sky Illuminance.”
Site Beam Solar Radiation Luminous Efficacy [lum/W][LINK]
A measure of the visible light content of beam solar radiation; equal to the number of lumens per watt of beam solar radiation. Depends on atmospheric conditions (moisture, turbidity, cloudiness) and solar altitude.
Site Sky Diffuse Solar Radiation Luminous Efficacy [lum/W][LINK]
A measure of the visible light content of sky diffuse solar radiation; equal to the number of lumens per watt of sky diffuse solar radiation. Depends on atmospheric conditions (moisture, turbidity, cloudiness) and solar altitude.
Site Daylighting Model Sky Clearness [][LINK]
Clearness of sky. One of the factors used to determine sky type and luminous efficacy of solar radiation (see EnergyPlus Engineering Document). Sky Clearness close to 1.0 corresponds to an overcast sky. Sky Clearness > 6 is a clear sky.
Site Daylighting Model Sky Brightness [][LINK]
Brightness of sky. One of the factors used to determine sky type and luminous efficacy of solar radiation (see EnergyPlus Engineering Document).
Daylighting Window Reference Point <x> View Luminance [cd/m2][LINK]
The area-averaged luminance of an exterior window as viewed from the first reference point in the daylit zone containing the window. In general, higher window luminance values are associated with higher daylight glare values. (Printed only for exterior windows in daylit zones without interior windows.)
Daylighting Window Reference Point <x> Illuminance [lux][LINK]
The contribution from a particular exterior window to the daylight illuminance at the first reference point in the daylit zone containing the window. (Not printed for exterior windows in daylit zones with interior windows.)
Daylighting Reference Point <x> Illuminance [lux][LINK]
The total daylight illuminance at the first reference point from all of the windows in a daylit zone.
Daylighting Reference Point <x> Glare Index [][LINK]
The daylight glare index at the first reference point in a daylit zone.
Daylighting Reference Point <x> Glare Index Setpoint Exceeded Time [hr][LINK]
The number of hours when the calculated daylight glare index at the first reference point exceeds the glare index setpoint.
Daylighting Reference Point <x> Daylight Illuminance Setpoint Exceeded Time [hr][LINK]
The number of hours when the calculated daylight illuminance at the first reference point exceeds the daylight illuminance setpoint.
Daylighting Lighting Power Multiplier [][LINK]
The amount by which the overhead electric lighting power in a zone is multiplied due to usage of daylighting to dim or switch electric lights. For example, if the multiplier is M and the electric power without dimming is P, then the electric power with dimming is M*P. The multiplier varies from 0.0, which corresponds to maximum dimming (zero electric lighting), to 1.0, which corresponds to no dimming.
Output:IlluminanceMap[LINK]
The Output:IlluminanceMap object expands on the reporting capabilities of the daylighting simulation. For any zone simulated with Daylighting:Controls, the illuminance map can generate up to 2,500 points of additional daylighting illuminance values. The resulting map is output as a comma delimited text file that can be imported into a spreadsheet program for rapid visualization of the daylighting illuminance patterns in a zone. The values are produced on an hourly basis. The Z height of the map is constant (parallel to a flat floor). More than one illuminance map can be created for a zone.
Inputs[LINK]
Field: Name[LINK]
The name of the map object.
Field: Zone Name[LINK]
Reference to a zone with Daylighting:Controls.
Field: Z Height[LINK]
The height or elevation of the grid of daylighting points.
Field: X Minimum Coordinate[LINK]
The minimum X coordinate boundary for the map.
Field: X Maximum Coordinate[LINK]
The maximum X coordinate boundary for the map.
Field: Number of X Grid Points[LINK]
The number of daylighting reference points in the X direction from the minimum to the maximum boundaries. The maximum number of points that can be generated is 2500 (Number of X Grid Points X Number of Y Grid Points).
Field: Y Minimum Coordinate[LINK]
The minimum Y coordinate boundary for the map.
Field: Y Maximum Coordinate[LINK]
The maximum Y coordinate boundary for the map.
Field: Number of Y Grid Points[LINK]
The number of daylighting reference points in the Y direction from the minimum to the maximum boundaries. The maximum number of points that can be generated is 2500 (Number of X Grid Points X Number of Y Grid Points).
Note: Daylighting factors cannot be accurately calculated for reference points that are very close to a wall or window (less than 0.15 m or 6 inches). An error is reported for a reference point that is too close to a window, but no error is reported for a point that is too close to a wall.
Since not all zones are rectangular, it is possible to have map points that are outside the zone. Any illuminance registered at these points is inaccurate and, additionally, a “*” marks these values for easy observance.
OutputControl:IlluminanceMap:Style[LINK]
This object specifies the “style” for the illuminance map output (described in the Output Details and Examples document). As described early in the document (see: EnergyPlus Output Processing), the user may select the “style” for the daylighting illuminance map output file (eplusmap.<ext>).
Inputs[LINK]
Field: Column Separator[LINK]
For this field, the desired separator for columns is entered. “Comma” creates comma separated fields/columns in the outputs (eplusmap.csv file is created). “Tab” creates tab separated fields/columns in the outputs (eplusmap.tab file is created). “Fixed” creates space separated fields/columns in the outputs (eplusmap.txt file is created) but these are not necessarily lined up for easy printing.
Note that both tab and comma separated files easily import into Excel™ or other spreadsheet programs. The tab delimited files can also be viewed by text editors, word processing programs and easily converted to “tables” within those programs.
Daylighting Devices[LINK]
Daylighting devices work in conjunction with the Daylighting:Controls object to simulate components that can improve daylighting in a zone.
Daylighting devices are also tightly integrated into the zone heat balance. The thermal effects of these devices are simulated with or without the use of a Daylighting:Controls object.
There are two types of daylighting device in EnergyPlus: tubular daylighting devices and daylighting shelves.
DaylightingDevice:Tubular[LINK]
Tubular daylighting devices (TDDs), also known as tubular skylights or light pipes, are used to bring natural exterior daylight into the hard-to-reach, interior spaces of a building.
TDDs consist of three components: a dome, a pipe, and a diffuser.
In EnergyPlus each of these components corresponds to an object in the input file.
The dome and diffuser are defined in the same way as windows using the FenestrationSurface:Detailed object. The Surface Type field must be specified as TubularDaylightDome or TubularDaylightDiffuser accordingly.
The location and orientation of the dome surface affect the total amount of daylight collected.
The Base Surface of the diffuser object determines to which zone the daylighting is delivered. The location and orientation of the diffuser surface affect the amount of daylight received at the Daylighting:Controls reference points.
Although the object definition is the same as for a window, there are several restrictions on TubularDaylightDome and TubularDaylightDiffuser objects:
Shading control devices are not allowed.
Frames and dividers are not allowed.
Multipliers must be 1.0.
Dome, diffuser, and pipe areas (as given by diameter) must be approximately equal.
Outside face environment objects are not allowed.
Dome and diffuser constructions cannot be more than one layer.
Since commercial TDDs are assumed to be cylindrical in shape, it is recommended that the circular areas of the actual dome and diffuser be approximated with a square of equivalent area for the TubularDaylightDome and TubularDaylightDiffuser objects. Although it is possible to use a triangular surface instead, a square is a much better geometric approximation of a circle.
Note that the TubularDaylightDome surface is allowed to have a different position and tilt from the roof base surface. If the actual TDD projects some height above the roof surface, the TubularDaylightDome coordinates should be located accordingly.
The TubularDaylightDome surface automatically casts a shadow on the roof base surface. However, since the pipe is not represented by a surface, it will not cast a shadow. If this effect must be simulated, one or more SURFACE:SHADING objects can be used.
The dome and diffuser objects are connected by the DAYLIGHTING DEVICE:TUBULAR object:
Inputs[LINK]
Field: Name[LINK]
The name of the TDD object.
Field: Dome Name[LINK]
Reference to a FenestrationSurface:Detailed object with Surface Type TubularDaylightDome.
Field: Diffuser Name[LINK]
Reference to a FenestrationSurface:Detailed object with Surface Type TubularDaylightDiffuser.
Field: Construction Name[LINK]
The construction of the TDD pipe. The visible and solar absorptance of the inside material layer determines the reflectivity of the inner mirrored surface of the TDD. This is very important for the overall transmittance of the TDD.
Field: Diameter[LINK]
The diameter [m] of the TDD pipe. The area of the pipe must match the areas of the dome and diffuser.
Field: Total Length[LINK]
The total length [m] of the TDD pipe between the dome and the diffuser, including the exterior part above the roof. The exterior length is determined internally by subtracting the transition zone lengths from the total length.
Field: Effective Thermal Resistance[LINK]
The effective thermal resistance [m\(^{2}\)-K/W], i.e. R-value, of the TDD between the exterior dome surface and the interior diffuser surface.
Field: Transition Zone<#> Name[LINK]
Name of zone that the TDD pipe passes through before reaching the delivery zone.
Field: Transition Zone <#> Length[LINK]
Length of pipe [m] in the transition zone. This is used for determining heat gains due to solar absorbed by the pipe in each transition zone. The distribution of absorbed solar gains can be customized by adjusting the length of pipe in each transition zone. The transition zone gain is proportional to the length of pipe in the zone. If no transition zones are specified, all solar absorbed by the pipe is lost to the exterior environment.
The Transition Zone Name and Transition Zone Length fields can be repeated for additional transition zones.
Outputs[LINK]
Zone,Average,Tubular Daylighting Device Transmitted Solar Radiation Rate [W]
Zone,Average,Tubular Daylighting Device Pipe Absorbed Solar Radiation Rate [W]
Zone,Average,Tubular Daylighting Device Heat Gain Rate [W]
Zone,Average,Tubular Daylighting Device Heat Loss Rate [W]
Zone,Average,Tubular Daylighting Device Beam Solar Transmittance []
Zone,Average,Tubular Daylighting Device Beam Visible Transmittance []
Zone,Average,Tubular Daylighting Device Diffuse Solar Transmittance []
Zone,Average,Tubular Daylighting Device Diffuse Visible Transmittance []
Tubular Daylighting Device Beam Solar Transmittance [][LINK]
This is the transmittance of beam solar radiation through the TDD.
Tubular Daylighting Device Beam Visible Transmittance [][LINK]
This is the transmittance of beam visible radiation, or daylight, through the TDD.
Tubular Daylighting Device Diffuse Solar Transmittance [][LINK]
This is the transmittance of diffuse solar radiation through the TDD.
Tubular Daylighting Device Diffuse Visible Transmittance [][LINK]
This is the transmittance of diffuse visible radiation, or daylight, through the TDD.
Tubular Daylighting Device Heat Gain Rate [W][LINK]
This is the rate of heat gain to the zone by the TDD, in Watts.
Tubular Daylighting Device Heat Loss Rate [W][LINK]
This is the rate of heat loss from the zone by the TDD, in Watts.
Tubular Daylighting Device Pipe Absorbed Solar Radiation Rate [W][LINK]
This is the rate at which solar radiation is absorbed by the pipe in the TDD, in Watts.
Tubular Daylighting Device Transmitted Solar Radiation Rate [W][LINK]
This is the rate at which solar radiation is transmitted by the TDD, in Watts.
In addition, several surface and window variables are also reported for the TubularDaylightDome and TubularDaylightDiffuser objects. For the TubularDaylightDome:
Zone,Average,Surface Outside Face Sunlit Area [m2]
Zone,Average,Surface Outside Face Sunlit Fraction []
Zone,Average,Surface Outside Face Incident Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Incident Beam Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Incident Sky Diffuse Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Incident Ground Diffuse Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Beam Solar Incident Angle Cosine Value[]
Zone,Average,Surface Window Transmitted Solar Radiation Rate [W]
Zone,Average,Surface Window Total Glazing Layers Absorbed Solar Radiation Rate [W]
For the TubularDaylightDiffuser:
Zone,Average,Surface Outside Face Incident Solar Radiation Rate per Area[W/m2] (incident inside of pipe)
Zone,Average,Surface Window Transmitted Solar Radiation Rate [W] (same as Tubular Daylighting Device Transmitted Solar Radiation Rate)
Zone,Average,Surface Window Total Glazing Layers Absorbed Solar Radiation Rate [W]
DaylightingDevice:Shelf[LINK]
Daylighting shelves, or simply light shelves, are another device for bringing more daylight into a building. Installed as an accessory to a window, daylighting shelves work by reflecting exterior light onto the ceiling of a room. Daylighting shelves can have an inside shelf, an outside shelf, or both.
The inside shelf redistributes light that would have entered the zone anyway. Instead of entering as a beam, all light is reflected onto the zone ceiling and is converted to diffuse shortwave radiation.
The outside shelf changes the amount of light entering the zone. If the shelf surface is more reflective than the ground, it can increase the amount of light incident on the upper part of the window. However, the shading effect of the outside shelf on the lower part of the window must also be considered as it can easily negate any gain achieved in the upper part of the window. All light reflected from the outside shelf that enters the upper window is assumed to strike the ceiling.
In EnergyPlus a daylighting shelf is simulated using a DaylightingDevice:Shelf object in combination with up to three other objects: a window, a heat transfer surface, and an attached shading surface.
The window must be divided into two window surfaces: an upper window and a lower window. The upper window interacts directly with the daylighting shelf object and is not allowed to have any shading control devices or frames or dividers. The lower window does not interact with the daylighting shelf object, but does receive shading from the outside shelf. There are no restrictions on the lower window.
The inside shelf is defined as a regular heat transfer surface in the zone. However, the surface must have the Outside Boundary Condition field set to Surface with itself as the other zone surface. Shading and thermal mass effects are taken into account.
The outside shelf is defined as a Shading:Zone:Detailed object. The visible and solar absorptance of the outside material layer determines the reflectivity of the shelf.
NOTE: Unlike a regular Shading:Zone:Detailed object, the vertices of the outside shelf surface must be ordered so that the outward normal vector points upward, i.e. toward the upper window. This is necessary in order for the outside shelf to properly receive sunlight and shading from other surfaces. A mirror shading surface with the outward normal vector pointing in the opposite direction is automatically created by the program to shade the lower window.
The inside shelf and outside shelf are both optional. However, if neither shelf is specified, the daylighting shelf object has no effect on the simulation.
Inputs[LINK]
Field: Name[LINK]
The name of the daylighting shelf object.
Field: Window Name[LINK]
Reference to a FenestrationSurface:Detailed object with Surface Type WINDOW.
Field: Inside Shelf Name[LINK]
Reference to a BuildingSurface:Detailed object. This field is optional. If used, this surface must have OTHERZONESURFACE specified for the Outside Face Environment field and the referenced other zone surface must be itself. The number of vertices of this surface object must be 4.
Field: Outside Shelf Name[LINK]
Reference to a Shading:Zone:Detailed object. This field is optional. If used, the number of vertices of this surface object must be 4.
Field: Outside Shelf Construction Name[LINK]
Reference to a CONSTRUCTION object. This field is required if an outside shelf is specified. The visible and solar absorptance of the outside material layer determines the shelf reflectivity.
Field: View Factor To Outside Shelf[LINK]
User defined value for the view factor from the window to the outside shelf. This field is optional. If not specified, an exact view factor is calculated for two perpendicular rectangles of the same width having a shared edge. If the given surfaces do not meet these geometric requirements, it is necessary to specify a value here.
NOTE: It is up to the user to adjust the view factor to ground of the upper window to account for the part of the view blocked by the outside shelf. The calculated View Factor To Outside Shelf is reported in the eio file for this purpose. For the typical case where the shelf is parallel to the ground and the upper window is perpendicular to the ground, the view factor to ground is simply: 0.5 – View Factor To Outside Shelf.
Outputs[LINK]
The view factor to outside shelf calculation shows up in the .eio file along with the associated window and window view factors to sky and ground:
! <Shelf Details>,Name,View Factor to Outside Shelf,Window Name,Window View Factor to Sky,Window View Factor to Ground
SHELF,0.29,DAYLIT UPPER WINDOW,0.50,0.21
This variable reports the calculated View Factor To Outside Shelf so that the user can correctly adjust the view factor to ground of the upper window.
The usual window and surface variables are relevant for the upper window:
Zone,Average,Surface Outside Face Sunlit Area [m2]
Zone,Average,Surface Outside Face Sunlit Fraction []
Zone,Average,Surface Outside Face Incident Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Incident Beam Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Incident Sky Diffuse Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Incident Ground Diffuse Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Beam Solar Incident Angle Cosine Value[]
Zone,Average,Surface Window Transmitted Solar Radiation Rate [W]
Zone,Average,Surface Window Total Glazing Layers Absorbed Solar Radiation Rate [W]
Zone,Average,Surface Window Heat Gain Rate [W]
Zone,Average,Surface Window Heat Loss Rate [W]
The following surface variables are reported for the outside shelf surface, if specified:
Zone,Average,Surface Outside Face Sunlit Area [m2]
Zone,Average,Surface Outside Face Sunlit Fraction []
Zone,Average,Surface Outside Face Incident Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Incident Beam Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Incident Sky Diffuse Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Incident Ground Diffuse Solar Radiation Rate per Area[W/m2]
Zone,Average,Surface Outside Face Beam Solar Incident Angle Cosine Value[]
DaylightingDevice:LightWell[LINK]
This object is used to model the impacts on daylighting of a “light well” that might be associated with exterior windows such as skylights. The light well model attenuates the light transmitted by the skylight. The attenuation is characterized by the well efficiency, which is the ratio of the amount of light leaving the well to the amount of light entering the well. The well efficiency varies from close to 1.0 to close to zero if there is high attenuation. The well efficiency is used only in the EnergyPlus detailed daylighting calculation, where it multiplies the beam and diffuse light transmitted by the skylight. (The well efficiency is not used in calculating the solar gain through the skylight.)
The input object describes the light well using basic characteristics of the geometry along with the visible reflectance of the well’s side walls. The following figure diagrams how the geometry is characterized.
Inputs[LINK]
Field: Exterior Window Name[LINK]
The name of the exterior window that this Light Well is associated with. Generally this is a skylight in a roof. However, light wells can be applied to an exterior window of any slope. Light wells can be assigned to both rectangular and triangular exterior windows, but they should not be assigned to interior windows. Note that the sides of the light well can be sloped and the bottom of the light well can be any shape, not just rectangular.
Field: Height of Well[LINK]
The distance from the bottom of the skylight to the bottom of the well. If the skylight and well bottom are not coplanar, this is the distance from the center of the bottom of the skylight to center of the bottom of the well. See Figure.
Field: Perimeter of Bottom of Well[LINK]
The perimeter of the bottom opening of the well. See Figure.
Field: Area of Bottom of Well[LINK]
The area of the bottom opening of the well. A warning will be issued if this area is less that the area of the skylight, including frame if present. See Figure.
Field: Visible Reflectance of Well Walls[LINK]
The visible reflectance of the side walls of the well. If the walls do not all have the same reflectance, an area-weighted average value can be used. This is the well-wall reflectance expressed as a fraction.
An IDF example:
Daylighting Modeling Options[LINK]
The following table shows what input objects/fields to use to model different daylighting options. It also gives the name of an example input, if available, that demonstrates the option.
*Used only with Daylighting:Controls with the SplitFlux Daylighting Method.
Formerly, only the exterior windows in a zone could provide daylight to that zone.
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.