cover illuminance

Daylight Simulation with HoneyBee

  |   environmental design, Guides and tutorials

NOTE: Patches available for download use Honeybee & Ladybug 0.0.61 version Feb 05 2017. Using different version could cause problems. In that case it is strongly recommended to rebuild the patches with the owned version or use update component.

In this section it is possible to download two  Grasshopper files to perform indoor natural lighting simulation.
The first file is used to perform summary analyzes and includes the parametric generation of the architectural space to be analyzed. The second is to be used to evaluate analytically predefined architectural masses that can still be modified and evaluated dynamically.

These patches are aimed at users without specific knowledge of visual programming and grasshopper in particular. For this reason few  data entry operations (labeled in magenta) are required and, without any coding, is immediately possible to display  results activating the preview box marked in blue. To execute the calculation  it is only required  to set “true” the compute  buttons having previously deactivated (“false”) others in execution.


01. Daylight Parametric Simulation  

[DOWLOAD ver. 64 for LEED:]

[DOWLOAD Old ver 61:]

To use for a quick and preliminary  simulations in the Early Stage Design creating parametrically a shoe box with glazing ratio percentage and shading system. Daylight Factor, Leed benchmarking and other Point in Time/Annual evaluation are generated


02. Daylight Detailed  Simulation

[DOWNLOAD ver. 64 for LEED:]

[DOWNLOAD Old ver 61:]


To use for a more detailed simulation based on a predefined architectural model that is possible to modify and evaluate in a dynamic way.

Daylight Factor, Leed benchmarking and other Point in Time/Annual evaluation are generated


Both files include the main simulation processes on annual base  and on  a specific hour (Point-in-Time) with the following characteristics and outputs:

  • Daytime Illumination Average (DIA)
  • Daylight Factor (DF)
  • Daylight Autonomy (DA)
  • Useful Daylight Illuminance (UDI)
  • spatial Daylight Autonomy (sDA)

(For an explanation of these coefficients:



In addition to the classic display of numerical values on the model, the detailed simulation patch also allows rendering  in High Range Definition and in False Color.


As described above, the patches do not require programming skills, nevertheless it is necessary to pay close attention to the phase of architectural masses generation and the radiativity specification of their surfaces.

As a  Rhinoceros plug-in, Grasshopper works using the Boundary Representation (B-rep or BREP) and requires to describe architectural masses with planar surfaces. For that reason architectural models must be modeled in Rhino using planar surfaces or solids to explode in surfaces. The same actions must be adopted for models generated in other CAD 3D modelers and imported in Rhino.





Energy modeling with Grasshopper. Plugin installation & Tutorials playlist

Quick start with HoneyBee and how to set True North

Grasshopper basics. Tutorials from the program developer

 BREP – Boundaries representation Fundamentals for geometry modeling

 How to solve surfaces adjacency and intersection.

 Simple Conceptual Mass. Automatic floors and mass thermal zones generation

 Curvilinear mass planarization in EnergyPlus geometry.