Ladybug 0.0.54 & Honeybee 0.0.50 Release


We are extremely excited today to release Honeybee version 0.0.50 (and Ladybug 0.0.54) after months of development and testing. The current version of Honeybee includes 64 components that enable users to run variety of daylight analyses using RADIANCE and Daysim.

Here is a short list highlighting some of the capabilities of this current Honeybee release:

  • Prepare geometry: Users can create geometry for simulations by either starting with a mass and quickly turning it to a complete zone or creating the geometry surface by surface, enabling maximal freedom and control.

  • Generate RADIANCE materials: Users can generate a wide variety of Radiance materials by either specifying a material color or inputting individual numeric values for material properties.

  • Generate RADIANCE skies: Honeybee supports several sky types including a Climate-based sky, a Cumulative Climate-based sky, and several Standard CIE skies. And that’s not all! You can also visualize the sky by using the “watch the sky” component.

  • Run several types of RADIANCE simulations: Honeybee enables users to run several types of accurate image-based analyses to produce images for luminance, Illuminance or Radiation. Honeybee supports all of the Radiance view types including Fish-eye, Parallel and Perspective, as well as both rendered and FalseColor images. There are even components that enable users to calculate Daylight Factor and the Vertical Sky Component! Lastly, users can run image-based glare analyses using evalglare.

  • Run annual daylight analyses: Honeybee uses the Daysim engine to run annual daylight analysis. There is a full set of components for setting up this type of daylight study and another set for exploring the results. If you dare, you can even setup annual runs with dynamic blinds and advanced lighting controls! All right from Grasshopper!

Here is what you will need to do:

“Radiance is a suite of programs for the analysis and visualization of lighting in design. Greg Ward developed RADIANCE at Lawrence Berkeley National Laboratory.”

“DAYSIM is a validated, RADIANCE-based daylighting analysis software that models the annual amount of daylight in and around buildings. The overall development of DAYSIM has been coordinated by Christoph Reinhart since 1998.” Read more about Daysim on the website (

Make sure that you install both RADIANCE and DAYSIM in folders with no spaces in the file path (e.g. “C:\Program Files” has a space between “Program” and “Files”). A good option for each is C:\RADIANCE and C:\Daysim, which are usually the default locations when you run the downloaded installers.

If you want to run Glare analysis, you need to download EvalGlare from this link: ( Evalgalare is developed by J. Wienold at Fraunhofer ISE.

To produce false color images, you need to download FalseColor2 from this link: ( FlaseColor2 is developed by Thomas Bleicher and is based on RADIANCE falsecolor.

Copy both evalglare.exe and falsecolor2.exe to C:\RADIANCE\bin (or wherever you have installed RADIANCE\bin).

We have put together some example files based on the different analysis types and you should use these to get yourself started with the ‘bee. You can download them from the link on the group page.

Ladybug also has four five new components. Chris and Saeran each developed two different types of Solar Fan and Solar Envelope components! Yes! Now you have more than one option to choose based on your design problem. Follow this discussion for more information and be sure to give them a try.

Last but not least, we give so many thanks to all of our great users who tested the Honeybee through its multiple iterations. Special thanks to Abraham and Daniel. Thanks again for all the support, great suggestions and comments. We really cannot thank you enough.

As always, please keep the suggestions coming and keep a critical eye to the ‘bug, ‘bee and the results of your studies!


Mostapha, Chris and Saeran

PS.1. Honeybee is a part of the Ladybug plugin and is under the same license as Ladybug.

PS.2. We know that a single key installation is something that many users might want but we thought that it is more important that users have a good understanding of the programs that are under the hood of HoneyBee and we accordingly ask you to download and install RADIANCE, DAYSIM and the other applications separately from the Honeybee components. Honeybee is, after all, just an interface and all of the hard calculations are done using validated engines (such as RADIANCE and DAYSIM), which have been developed by some of the greatest scientists over years. By making users aware of where their results are coming from, we also hope to avoid questions about whether the results accurate or not. You can trust that the engines are accurate but an accurate engine is just one element needed to achieve an accurate result. Without the ability to understand the inputs, interpret the outputs, or have a sense what is happening under the hood, users may find themselves at a loss.

PS.3. As mentioned before, the energy simulation components are still under development and are not included in this package. If you compare the Honeybee of last March ( with the current version here, we are sure that then you probably agree that there is a good reason for this delay.


Mostapha, Chris and Saeran:

Congratulations and thank you for sharing.

I can say that this is a piece of work that a lot of people will get a lot of benefit.

Great job!!



Thanks Mostapha , Chris and Saeran
So great, i was reading all features ,. awesome…


Brilliant stuff. Congrats Mostapha!


Great job! congratulations! … I am starting installation process…


Thanks Mostapha!


where can i download the sample files?


Check the main page. From there:

Example Files for Ladybug

Example Files for Honeybee




Is there a plugin or a definition to let grasshopper open Evalglare and load the output image for glare analysis??? something where you can insert the image file location string and open it in Evalglare

That would be very helpfull!!


Hi Dalia, Honeybee has a glare analysis plugin which uses evalglare for glare analysis. You can also locate the work area. Check Honeybee example files for the glare analysis example.



I just download the “RADIANCE 4.2 for Windows” successfully, but when I double click it. An error comes out saying “Common causes include incomplete download and damaged media…”

So I am here to ask if you know how to fix it?



Hi Michael,

The error tells me that the download wasn’t probably successful. Can you check the size of the file? It should be 13.9 MB (14,647,001 bytes).

I also captured a video that shows how you can install these packages which may help:…


I would say also that you need to be patient with the Radiance website. It often happens that the download fails. Just look on your browser if the download is completed successfully.



Hi Mostapha,

Yesterday, I figure it out. The reason why the error occurs is because when I download the file. My Astrill is on.(Astrill is a software I used to change my VPN to go to Youtube ). So when I close Astrill and download it. It works now.

So I can enjoy the Ladybug&Honeybee.

Great job!

Thank you guys so much!!!


Hi Mostapha,

The RadiationAnalysis component mentions it returns values in Wh/m2 and Wh, but the generated legend says kWh/m2. The latter seems to be right.


Hi Diederik, Thank you for reporting this. I added it as an issue and we will get it fixed ( -Mostapha


Hi guys.

Looks great!

I downloaded your example file 00_getting started and got this error -

what should i do?




Hi Ionathan,

You need to download a newer version of GHPython.

You can download it from this link and replace it with the current version that you have.

Hope it helps,



Hi guys,

I properly installed Radiance and Daysim as instructed , in addition to the Ladybug+HoneyBee user objects. However, while the tabs and icons appear in grasshopper, everytime I drag and drop a Ladybug or Honeybee component, I get an error “The User Object could not be created as the base type is missing”.


Hi Ammar,

Do you have GHPython installed on your system?

This discussion may help:…