Grasshopper Docs

Community documentation for Grasshopper add-ons & plugins

00 | Honeybee
01 | Daylight | Material
02 | Daylight | Light Source
03 | Daylight | Recipes
04 | Daylight | Daylight
05 | Energy | Building Program
06 | Energy | Material | Construction
07 | Energy | Schedule
08 | Energy | Set Zone Properties
09 | Energy | HVACSystems
10 | Energy | Energy
11 | THERM
12 | Developers
13 | WIP

Use this component to calculate the Lighting Density Per Area Load from information about your bulb, fixture type, mainteneance, and required lighting level.
Plug the result to the Honeybee setEPZoneLoads component, lightingDensityPerArea_ input


Light Level_lightLevelA number representing the required light level in the room in lux. For instance, 500 lux for a typical office area or 300 lux for a typical residential space. Note that a lux value input here means that light level is reached everywhere on the room floor plan.Goo
Luminous EfficacyluminousEfficacy_A value between 0 and 100 that represents how well a light source produces visible light in lumens/Watt. More specifically, it is the ratio of luminous flux (in Lumens) coming from a buld to electrical power (in Watts) going into the bulb. Here are some common options: 92 = Fluorescent (T5 tube) 81 = 8.7 W LED screw base lamp (120 V) 80 = Fluorescent (T8 tube) 52 = Compact Flourescent 13.8 = Incandescent 0.3 = Candle The default is set to 80 lm/W for Fluorescent (T8), which is also close to LED lamps. Sources -,
Maintenance FactormaintenanceFactor_A number between 0 and 1 that represents how often the lights are cleaned and replaced (higher numbers mean more often). It takes into account such factors as decreased efficiency with age, accumulation of dust within the fitting itself and the depreciation of reflectance as walls and reflecting surfaces age. For convenience, it is usually given as three options: 0.70 = Good 0.65 = Medium 0.55 = Poor The default is set to 0.65 for Medium. Source -
Coefficient Of UtilizationcoefficientOfUtilization_A number between 0 and 1 that represents the fraction of the lumens from the bulb that finally find their way to the work plane (higher values indicate a more efficient fixture). This number depends on the particular fixture type, the number of lamps in it, the lens used, its beam pattern, the shape of the room (Room Cavity Ratio, RCR) and the reflectances of the ceiling (Rc), walls (Rw) and floor (Rf). Here are some common Examples: 0.84 = Basic Fluorescent Strip 0.72 = Deep-Cell Parabolic Louver 0.55 = Small-Cell Parabolic Louver The default is set to 0.84 for a Basic Fluorescent Strip Source -


OutoutThe execution information, as output and error streamsString
Lighting Density Per ArealightingDensityPerArea(W/m2)The lighting load per square meter of floor, which can be plugged into the "Set EnergyPlus Loads" component.Goo

Video Tutorials

Site design © Robin Rodricks.   Co-created by Andrew Heumann.   Honeybee and associated data © 2022 Ladybug Tools.  
Rhinoceros and Grasshopper are registered trademarks of Robert McNeel & Associates.  Hosted by GitHub

Report an Issue  |  Terms of Service