Question-and-Answer Resource for the Building Energy Modeling Community
Get s tarted with the Help page

# Revision history [back]

I had to do a little homework myself to be able to provide a reasonable answer.

(DA) is the percentage of the time-in-use that a certain user-defined lux threshold is reached through the use of just daylight. DA is usually given as an annual value but seasonal, monthly and daily presentations can be made. For more historic details, see the Daylighting Pattern Guide site.

All available reporting are described in the Input Output Reference document at the end of the section that describes the object (e.g., Daylighting:xxxxxxxx). From these description, it appears that post-processing of results will be required to ascertain the results your looking for.

These are the available reporting options:

Daylighting Output

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 1 View Luminance [cd/m2]
Surface,Average,Daylighting Window Reference Point 1 Illuminance [lux]
Zone,Average,Daylighting Reference Point 1 Illuminance [lux]
Zone,Average,Daylighting Reference Point 1 Glare Index []
Zone,Sum,Daylighting Reference Point 1 Glare Index Setpoint Exceeded Time [hr]
Zone,Sum,Daylighting Reference Point 1 Daylight Illuminance Setpoint Exceeded Time [hr]
Surface,Average,Daylighting Window Reference Point 2 View Luminance [cd/m2]
Surface,Average,Daylighting Window Reference Point 2 Illuminance [lux]
Zone,Average,Daylighting Reference Point 2 Illuminance [lux], if applicable
Zone,Average,Daylighting Reference Point 2 Glare Index [], if applicable
Zone,Sum,Daylighting Reference Point 2 Glare Index Setpoint Exceeded Time [hr]
Zone,Sum,Daylighting Reference Point 2 Daylight Illuminance Setpoint Exceeded Time [hr]
Zone,Average,Daylighting Lighting Power Multiplier []


I had to do a little homework myself to be able to provide a reasonable answer.

(DA) is the percentage of the time-in-use that a certain user-defined lux threshold is reached through the use of just daylight. DA is usually given as an annual value but seasonal, monthly and daily presentations can be made. For more historic details, see the Daylighting Pattern Guide site.

There are two forms of reporting. Time series reports are available when using Output:Variable statements and summary results are provided in various formats (e.g., html, tabular, etc).

All available time series reporting are described in the Input Output Reference document at the end of the section that describes the object (e.g., Daylighting:xxxxxxxx). From these description, descriptions, it appears that post-processing of results will be required to ascertain the results your looking for.

Summary reports are described in the OutputDetailsAndExample document. I don't think DA is available.

These are the available time series reporting options:

Daylighting Output

The following daylighting-specific outputs are (mostly) available for Daylighting:Controls:

Zone,Average,Site Output:Variable,*,Site Exterior Beam Normal Illuminance [lux]
Zone,Average,Site Illuminance,hourly;
Output:Variable,*,Site Exterior Horizontal Beam Illuminance [lux]
Zone,Average,Site Illuminance,hourly;
Output:Variable,*,Site Exterior Horizontal Sky Illuminance [lux]
Zone,Average,Site Illuminance,hourly;
Output:Variable,*,Site Beam Solar Radiation Luminous Efficacy [lum/W]
Zone,Average,Site Efficacy,hourly;
Output:Variable,*,Site Sky Diffuse Solar Radiation Luminous Efficacy [lum/W]
Zone,Average,Site Efficacy,hourly;
Output:Variable,*,Site Daylighting Model Sky Clearness []
Zone,Average,Site Clearness,hourly;
Output:Variable,*,Site Daylighting Model Sky Brightness []
Surface,Average,Daylighting Brightness,hourly;
Output:Variable,*,Daylighting Window Reference Point 1 View Luminance [cd/m2]
Surface,Average,Daylighting Luminance,hourly;
Output:Variable,*,Daylighting Window Reference Point 1 Illuminance [lux]
Zone,Average,Daylighting Reference Point 1 Illuminance [lux]
Zone,Average,Daylighting Illuminance,hourly;
Output:Variable,*,Daylighting Reference Point 1 Illuminance,hourly;
Output:Variable,*,Daylighting Reference Point 1 Glare Index []
Zone,Sum,Daylighting Index,hourly;
Output:Variable,*,Daylighting Reference Point 1 Glare Index Setpoint Exceeded Time [hr]
Zone,Sum,Daylighting Time,hourly;
Output:Variable,*,Daylighting Reference Point 1 Daylight Illuminance Setpoint Exceeded Time [hr]
Surface,Average,Daylighting Time,hourly;
Output:Variable,*,Daylighting Window Reference Point 2 View Luminance [cd/m2]
Surface,Average,Daylighting Luminance,hourly;
Output:Variable,*,Daylighting Window Reference Point 2 Illuminance [lux]
Zone,Average,Daylighting Reference Point 2 Illuminance [lux], if applicable
Zone,Average,Daylighting Illuminance,hourly;
Output:Variable,*,Daylighting Reference Point 2 Illuminance,hourly;
Output:Variable,*,Daylighting Reference Point 2 Glare Index [], if applicable
Zone,Sum,Daylighting Index,hourly;
Output:Variable,*,Daylighting Reference Point 2 Glare Index Setpoint Exceeded Time [hr]
Zone,Sum,Daylighting Time,hourly;
Output:Variable,*,Daylighting Reference Point 2 Daylight Illuminance Setpoint Exceeded Time [hr]
Zone,Average,Daylighting Time,hourly;
Output:Variable,*,Daylighting Lighting Power Multiplier []
Multiplier,hourly;


I had to do a little homework myself to be able to provide a reasonable answer.

(DA) is the percentage of the time-in-use that a certain user-defined lux threshold is reached through the use of just daylight. DA is usually given as an annual value but seasonal, monthly and daily presentations can be made. For more historic details, see the Daylighting Pattern Guide site.

There are two forms of reporting. Time series reports are available when using Output:Variable statements and summary results are provided in various formats (e.g., html, tabular, etc).

All available time series reporting are described in the Input Output Reference document at the end of the section that describes the object (e.g., Daylighting:xxxxxxxx). From these descriptions, it appears that post-processing of results will be required to ascertain the results your looking for.

Summary reports are described in the OutputDetailsAndExample document. I don't think DA is available.

EMS sensors are described in the EMS_Application_Guide document, or if you include simple EMS instruction in your input file (e.g., EMS global variable statement [see EMS example files]), all available EMS actuators and sensors will be reported to the EMS data dictionary (edd) file. A quick review of this document did not show anything related to daylighting.

These are the available time series reporting options:

Daylighting Output

The following daylighting-specific outputs are (mostly) available for Daylighting:Controls:

Output:Variable,*,Site Exterior Beam Normal Illuminance,hourly;
Output:Variable,*,Site Exterior Horizontal Beam Illuminance,hourly;
Output:Variable,*,Site Exterior Horizontal Sky Illuminance,hourly;
Output:Variable,*,Site Beam Solar Radiation Luminous Efficacy,hourly;
Output:Variable,*,Site Sky Diffuse Solar Radiation Luminous Efficacy,hourly;
Output:Variable,*,Site Daylighting Model Sky Clearness,hourly;
Output:Variable,*,Site Daylighting Model Sky Brightness,hourly;
Output:Variable,*,Daylighting Window Reference Point 1 View Luminance,hourly;
Output:Variable,*,Daylighting Window Reference Point 1 Illuminance,hourly;
Output:Variable,*,Daylighting Reference Point 1 Illuminance,hourly;
Output:Variable,*,Daylighting Reference Point 1 Glare Index,hourly;
Output:Variable,*,Daylighting Reference Point 1 Glare Index Setpoint Exceeded Time,hourly;
Output:Variable,*,Daylighting Reference Point 1 Daylight Illuminance Setpoint Exceeded Time,hourly;
Output:Variable,*,Daylighting Window Reference Point 2 View Luminance,hourly;
Output:Variable,*,Daylighting Window Reference Point 2 Illuminance,hourly;
Output:Variable,*,Daylighting Reference Point 2 Illuminance,hourly;
Output:Variable,*,Daylighting Reference Point 2 Glare Index,hourly;
Output:Variable,*,Daylighting Reference Point 2 Glare Index Setpoint Exceeded Time,hourly;
Output:Variable,*,Daylighting Reference Point 2 Daylight Illuminance Setpoint Exceeded Time,hourly;
Output:Variable,*,Daylighting Lighting Power Multiplier,hourly;