Question-and-Answer Resource for the Building Energy Modeling Community
Get started with the Help page
Ask Your Question

Read Daylight Metrics CSV Files

asked 2016-08-15 00:15:39 -0500

adityord's avatar

updated 2017-05-04 08:48:27 -0500

Can someone explain me how to read the Data of DaylightMetrics? DaylightMetrics of my Models

For example : What the meaning of Daylit, Daylit occupied etc.. and how the numbers come?

edit retag flag offensive close merge delete

1 Answer

Sort by ยป oldest newest most voted

answered 2016-08-15 15:12:24 -0500

updated 2016-08-16 11:09:55 -0500

Short Answer: If you had a space that was routinely occupied well into the evening, or conversely vacant for half the day, the metrics would potentially tell the wrong story, is all.

Longer Answer: The reason there are three values for each daylight metric (sDA excepted) is there is no prescribed temporal range for them. The OpenStudio Radiance measure just calculates for the three most interesting ranges, daylit, occupied, and "daylit and occupied". It's obviously pointless to calculate the daylight metric for nighttime hours, we know that is zero, right? But depending on the space type, it may be more useful to calculate the daylight metrics for when a space is known to be in use. We know the occupancy status from the occupancy schedule that is part of the OpenStudio model, and the daylit hours from the weather file, and the interior daylight illuminance from the Radiance simulation. From there we simply calculate the metrics, based on these three temporal input ranges. sDA has a specific range as dictated by IESNA (LM-83-12) for now, so that one we calculate accordingly -- just the one way.

As for the other elements in the data:

metric_value - this is the metric. I don't know how to make this any clearer.

hours_met - number of hours where the metric criterion was satisfied. In your example, this would be the number of hours where the daylight illuminance was >= 500 lux (for DA and conDA) or >=100 <=3000 lux (for UDI).

input_hours - number of hours that met the criteria for consideration, i.e. were either daylit, occupied, or (daylit AND occupied), per column 'C' in the dataset.

edit flag offensive delete link more


how about the Metric Value, Hours_met, Input_hours meaning? i dont get that

adityord's avatar adityord  ( 2016-08-15 22:50:04 -0500 )edit

I updated the answer. Again, the "metric_value" is simply the metric. It's the percentage of the input hours that received enough daylight to satisfy the metric criteria. Make sense?

rpg777's avatar rpg777  ( 2016-08-16 11:12:03 -0500 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer

Training Workshops


Question Tools

1 follower


Asked: 2016-08-15 00:15:39 -0500

Seen: 1,036 times

Last updated: Aug 16 '16