Lesson 9.2Lesson 9.2 · Environmental Analysis & Fabrication
Daylight & Energy with Honeybee
Bridging your model to Radiance and EnergyPlus - and knowing exactly what that buys you
Ladybug shows you the climate. Honeybee runs the physics - and then, honestly, hands the certificate to an engineer.
Honeybee is Ladybug's structural sibling. Where Ladybug maps the sun and wind, Honeybee builds an actual model of your building - rooms, windows, constructions, materials - and hands it to two of the most trusted simulation engines in the world: Radiance for light and EnergyPlus for energy.
That is a big step up in power, and with it comes a bigger responsibility to be honest about what the numbers mean. This lesson builds a simple daylight-and-thermal model, reads its metrics properly, and is very clear about the line: these tools inform design; a qualified engineer certifies performance.
Honeybee translates; Radiance + EnergyPlus solve. sDA = how much is lit; UDI = how much is USEFUL. Engineer certifies.
What Honeybee actually is: a translator to the engines
The single most useful thing to understand is that Honeybee does not compute the physics itself - it is a beautifully organised translator. You build your model in Grasshopper terms, and Honeybee writes the exact input files that industry-standard engines expect, launches them, and reads the results back onto your geometry as colours and numbers. For light that engine is Radiance, the Lawrence Berkeley National Laboratory (LBNL) ray-tracer that has been the daylight-simulation reference for decades and is used across research and practice worldwide. For energy it is EnergyPlus, the US Department of Energy's whole-building simulation engine (frequently reached through OpenStudio, a middle layer that manages models and results).
Why does this distinction matter so much? Because it means Honeybee's credibility is borrowed from validated engines, not invented by a plug-in. When you report a daylight or energy result, you are really reporting Radiance or EnergyPlus output that Honeybee arranged - the same engines a specialist consultant would use. It also means the limits are the engines' limits, and the old rule holds: garbage geometry or wrong material assumptions in, garbage numbers out. A model with reversed surface normals, missing boundary conditions or fantasy construction values will run happily and lie to you confidently.
The reason to work this way rather than exporting to standalone software is the parametric loop. Because the whole model lives on the Grasshopper canvas, you can test daylight or energy across many design variants - driven by the same sliders that drive the form - instead of running one heavyweight study at the very end when nothing can change. That is the entire value proposition: simulation early and often, feeding decisions while they are still cheap to make.
Honeybee = translator, NOT the solver. Radiance (light, LBNL) + EnergyPlus (energy, US-DOE) do the physics.
Building the model: rooms, apertures, constructions
A Honeybee model is more than shapes; it is shapes with meaning. You start by turning closed volumes into Honeybee Rooms (thermal zones). Honeybee automatically works out which faces are walls, floors and roofs, and which touch the outdoors, the ground or another room - the boundary conditions a simulation absolutely needs to be correct, because a wall the model thinks faces outside when it really abuts a neighbour will compute completely wrong heat flow. You then add apertures (windows) to faces, either by drawing them explicitly or by applying a window-to-wall ratio, and you can add shades - overhangs, fins, context buildings - that the simulation will honour.
Then you assign the physics-carrying properties, and this is where realism lives. Constructions define the layered make-up of each wall, roof and window - their U-value (how readily heat passes through) and, for glass, their solar heat gain coefficient and visible transmittance - while materials and modifiers describe surface reflectance for the light simulation. A room with default constructions and a room with a real double-glazed, well-insulated envelope will simulate very differently, and that difference is the entire point of modelling rather than guessing. Honeybee ships sensible libraries, including standards-based construction sets, so you are not inventing values from nothing - but the assignments are design decisions you must consciously own, not defaults to leave untouched.
The parametric prize is that all of this is wired to the canvas. Window size, glazing type, wall build-up, shading depth and orientation are sliders and inputs - so you can ask 'what does a lower glazing ratio do to both daylight and energy?' and get two coupled answers from one change. More glass usually helps daylight but can hurt energy through gain and loss; the sweet spot is a trade-off you can now actually see rather than argue about. That coupled, whole-year view of light and energy from a single model is something hand calculation and rules of thumb simply cannot give you.
Closed volume -> Honeybee Room (zone). Add apertures. Assign constructions + materials. Now it MEANS something.
Daylight metrics that actually mean something
Old daylight practice quoted the daylight factor - the ratio of indoor to outdoor light on a dull, uniformly overcast sky. It is simple, but it deliberately ignores orientation, the actual sun, and location, so it gives the same answer for a room in Reykjavik and one in Chennai. Honeybee + Radiance let you do far better: climate-based daylight modelling (CBDM), which simulates the real sky hour by hour across the whole EPW year for your true site, orientation and geometry, then boils the thousands of results into metrics that describe performance over time rather than at one imaginary instant. Two metrics matter most.
sDA (spatial Daylight Autonomy) answers 'how much of the floor gets enough daylight for enough of the year?' - conventionally, the percentage of the analysis area that reaches at least 300 lux for at least 50% of occupied hours from daylight alone (often written sDA 300/50%). Higher is generally better; it rewards a plan that is genuinely daylit across its depth rather than one bright strip by the glass and a dim cave behind. UDI (Useful Daylight Illuminance) is the honest partner: it reports the fraction of hours daylight sits in a useful band - roughly bright enough to work by, but not so bright it tips into glare and solar overheating (very high illuminance is flagged as excess). Too much sun is not simply 'more daylight'; UDI is what captures that truth, and it is why maximising glazing is not automatically a daylight win.
Read together on the coloured floor plate, these two metrics tell a real, actionable story. A deep single-sided room may be over-bright at the window (glare risk, UDI flagging excess hours) and genuinely gloomy at the back (failing sDA), which points you toward a specific remedy: a light shelf to bounce light deeper, a second aperture or clerestory on the far side, a shallower plan depth, or an internal light-coloured finish to raise reflectance. That is a design conversation the single overcast daylight factor could never even start - and because it is parametric, you can test each remedy and watch sDA and UDI respond.
Energy - and the line you must not cross
On the energy side, Honeybee assembles your rooms, constructions, a weather file and occupancy/equipment/lighting schedules, then runs EnergyPlus to estimate heating and cooling loads, annual energy use and thermal comfort hour by hour over the year. In early design this is gold: you can compare two massings, two glazing ratios or two shading schemes and see which trends better, coupling the daylight win against the energy cost of the glass that delivered it. A worked example of the trade-off: bumping a facade from 40% to 60% glazing might lift sDA by a few points but simultaneously push up cooling load in a hot climate - Honeybee lets you put both numbers on the table and choose deliberately, rather than optimising light while quietly wrecking energy.
Now the line, and it is not optional. These simulations inform design; they do not certify a building. An early Honeybee energy model uses assumed schedules, simplified systems and library constructions - it is a directional comparison, not a compliance calculation. Real code compliance, HVAC sizing and a signed energy or daylight assessment require calibrated modelling and the judgement of a qualified building-services or environmental engineer, working to the local standard. The honest, professional stance - and the one that makes designers trusted collaborators rather than liabilities - is to use Honeybee to make better decisions early and to hand a good, well-organised model to the engineer, never to present a studio simulation as a guarantee. Analysis proposes; engineering certifies.
Compare OPTIONS, don't certify buildings. Assumed schedules + library constructions = direction, not compliance.
Honeybee
Grasshopper toolkit that models a building for simulation
Builds rooms, apertures, constructions; translates to Radiance/EnergyPlus and reads results back. The bridge, not the solver.
Radiance
LBNL ray-tracing engine for lighting and daylight
The daylight-simulation reference for decades. Honeybee drives it for annual, climate-based daylight studies.
EnergyPlus (via OpenStudio)
US-DOE whole-building energy simulation engine
Estimates loads, energy and comfort over the year. Directional in early design; needs calibration for compliance.
sDA - spatial Daylight Autonomy
Share of floor with enough daylight for enough of the year
e.g. % of area reaching 300 lux for 50% of occupied hours. Rewards genuinely daylit plans, not one bright strip.
UDI - Useful Daylight Illuminance
Share of hours daylight sits in a useful (not glary) band
The honest partner to sDA: too much sun is glare and heat, not 'more daylight'.
Workshop - an annual daylight study on one room
You will make one small room into a real Honeybee model and run an annual daylight simulation, then read sDA and UDI as a design brief. Keep the geometry trivial - the learning is in the model setup and the honest reading of the numbers.
Rhino + Grasshopper with Ladybug Tools and Radiance installed (both free). EnergyPlus/OpenStudio optional if you want to also glance at energy. No paid software required.
Goal: build a Honeybee room and run a climate-based daylight study Inputs: Rhino + Grasshopper with Ladybug Tools + Radiance installed, an EPW, one closed box room Time: ~60 minutes
- 1Make a closed box (say 6m deep x 4m wide x 3m tall) in Rhino and convert it to a Honeybee Room so Honeybee resolves the wall/floor/roof/boundary faces automatically.
- 2Add an aperture to one long wall - draw a window or apply a window-to-wall ratio (try 40%). Assign a sensible glazing construction from the library so the glass has real properties.
- 3Set up an annual daylight recipe (Radiance) with the same EPW you used in the Ladybug lesson, place the sensor grid on the working plane, and run it. Expect the first run to take a few minutes.
- 4Colour the floor grid by sDA and by UDI. Read them together: where does the plan pass sDA, and where does UDI flag glare near the glass or gloom at the back?
- 5Change ONE thing - deepen the room to 8m, or drop the glazing ratio - re-run, and write down how sDA and UDI moved. Note explicitly that this is design guidance, not a compliance result.
You’ll walk away with
One coloured daylight plate (sDA and UDI) for a base case and one variant, plus three sentences: what the metrics say, what you would change, and one honest limit of the study (assumptions, library values, or the need for engineering sign-off).
Three altitudes on the same idea
Read the band that fits you — or all three.
Honeybee lets you carry a daylight-and-energy argument through concept design instead of discovering problems at the end. Test glazing ratios and shading against both sDA and energy on your own model, then hand a clean, zoned Honeybee model to your environmental engineer - you arrive at coordination with evidence and a head start, not a blank sheet.
Daylight is an interiors decision as much as an envelope one. A Honeybee sDA/UDI study shows whether the back of a deep space is genuinely usable by daylight or will fight glare at the window - guiding where you place workstations, whether you need a light shelf or sheer, and how much electric light the scheme must add.
Knowing that Honeybee is a translator to Radiance and EnergyPlus - and being able to explain sDA versus UDI - instantly reads as literacy, not buzzwords. Build one small room, run an annual daylight study, and discuss the metrics honestly (including their limits). That maturity impresses reviewers more than a flashy but unexplained result.
“Honeybee runs the daylight and energy simulation, so it's the tool doing the analysis.”
Do it yourself
Think these through - they separate literacy from buzzwords.
- 1In one sentence, what is Honeybee's actual job if it isn't running the physics itself?
- 2Which engine does the daylight, and which does the energy?
- 3Explain sDA and UDI, and why UDI is a more honest picture than 'more daylight is better'.
- 4Why is the daylight factor a weaker metric than a climate-based annual study?
- 5State clearly where a Honeybee study stops and a certifying engineer begins.
The one line to carry out
Peer-reviewed journals & authoritative standards
- 01Ladybug Tools (Ladybug, Honeybee) — Ladybug Tools LLC, 2026.
- 02Radiance - lighting / daylight simulation — LBNL, 2026.
- 03EnergyPlus - building energy simulation — US DOE / NREL, 2026.
- 04Daylighting — Wikipedia, 2026.
So far we have closed the loop with the environment - reading and simulating how a design meets sun, light and energy. The other loop is with the workshop floor: turning a definition into a made object. Next we move from analysis to fabrication, starting with the file-to-factory mindset.
The author
Amogh N P
Architect, interior designer, and creative polymath. Studio Matrx began in his notebooks — his vision of design made honest, useful, and open to everyone. Its Academy is written and taught in his memory, and free, forever.
More about Amogh →