algorithmic modeling for Rhino


Ladybug + Honeybee

Ladybug and Honeybee are two free and open source environmental plugins for Grasshopper to help designers create an environmentally-conscious architectural design.

Read release notes

Download Ladybug.0.0.55 and Honeybee 0.0.51

Example Files for Ladybug

Example Files for Honeybee

Ladybug on GitHubHoneybee on GitHub

Current developers:

Mostapha Sadeghipour Roudsari, Chris Mackey and Saeran Vasanthakumar

Ladybug started by Mostapha Sadeghipour Roudsari is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License. Based on a work at

Members: 369
Latest Activity: 1 hour ago





What is Ladybug?

Ladybug is a free and open source environmental plugin for Grasshopper to help designers create an environmentally-conscious architectural design.  The initial step in the design process should be the weather data analysis; a thorough understanding of the weather data will, more likely, lead designers to high-performance design decisions.

Ladybug imports standard EnergyPlus Weather files (.EPW) in Grasshopper and provides a variety of 2D and 3D designer-friendly interactive graphics to support the decision-making process during the initial stages of design. The tool also provides further support for designers to test their initial design options for implications from radiation and sunlight-hours analyses results. Integration with Grasshopper allows for an almost instantaneous feedback on design modifications, and as it runs within the design environment, the information and analysis is interactive.


What is Honeybee?

Honeybee is a free and open source plugin to connect Grasshopper3D to EnergyPlus, Radiance, Daysim and OpenStudio for building energy and daylighting simulation.

Current release includes all the daylighting components and let the users to:

  • 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 CIE Standard skies. 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.


Ok! I like it. How do I start?

  1. Download Ladybug and Honeybee:
    You can download the components from this link. There are two key points that you should be aware of before you download the ‘bug.

    First, Due to the current limitations of Python in Grasshopper there is no simple way to make GHA files from Python scripts so for now I decided to distribute it as UserObjects.

    Second, Ladybug only works on Rhino 5.0. Unfortunately, there is no version for Rhino 4. You can download an evaluation version of Rhino 5 for free. You also need to have  GHPython and Grasshopper 0.9.0061 or higher installed on your system.

  2. Installation:  There is no installation! After you download the files just drag and drop the files into Grasshopper canvas. You should then see the Ladybug and Honeybee tabs in Grasshopper.

    Note: If you have an older version of Ladybug or Honeybee already installed download and open this file in Grasshopper and set remove to True. It will automatically remove the old version.

  3. Check the sample file and watch the videos: If you haven’t watched them yet, watch the videos on top of this page.  It shows what Ladybug and Honeybee do; more videos are available on my channel. I will, periodically, capture and upload more videos.

    Ladybug has a teaching resources page where you can find more useful resources. If you have some teaching materials upload them in the same page so others can use it.

How can I support it?

  1. Send your feedback: You can comment on the grasshopper group page, create discussions, or email at thisisladybug [at] gmail [dot] com. Sending comments to the group can get others involved, which is a big plus, but we will always be happy to read your feedbacks via email as well.
  2. Spread the word: Let more people know about Ladybug. Like it on Facebook or follow it on Twitter.
  3. Donate the project:  [I think I will provide a link later!]


I know Python. Does it make any difference?

Yes! It does. You can be part of Ladybug development and make a big difference! Simply fork Ladybug repository in GitHub, develop your own components or modify the available components and share it back to the community!


How is Ladybug  and Honeybee licensed?

Creative Commons License

Ladybug started by Mostapha Sadeghipour Roudsari is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.
Based on a work at

It means you can copy, distribute and transmit the work or remix it to adapt the work. You can also use it to make commercial use of the work, BUT you must attribute that the work is based on Ladybug, and if you alter, transform, or build upon Ladybug, you may distribute the resulting work only under the same or similar license. This process will ensure that Ladybug and its future versions will stay free and accessible for everyone.

Discussion Forum

Simulating IES lamps file through RAD materials 4 Replies

Hi to everyone,in this tutorial ( ) is…Continue

Started by Claudio Campanile. Last reply by Claudio Campanile 1 hour ago.

3d Result Visualization 8 Replies

This discussion is in response to…Continue

Tags: Mesh, 3D, Visualization, Result

Started by Mostapha Sadeghipour Roudsari. Last reply by Abraham Yezioro 23 hours ago.

Add Glazing 3 Replies

Hello everybody,I encountered an annoying problem with glazing.I want to use the component Add Glazing in order to define all the glazed surface by myself (and not based on ratio). I succeeded in…Continue

Started by Oussennan. Last reply by Oussennan yesterday.

Data reliability 5 Replies

Hi everyone,I'm an Italian student at the University of Pisa. Due to the fact that I'm doing my thesis through Ladybug and Honeybee I had to verify Ladybug+Honeybee data reliability. Down here you…Continue

Started by Claudio Campanile. Last reply by mehrnoosh yesterday.

Ladybug Tweets

Comment Wall


You need to be a member of Ladybug + Honeybee to add comments!

Comment by Mostapha Sadeghipour Roudsari on Sunday

Hi Abraham. Absolutely. I tried to rewrite the whole component once but I wasn't able to finish it. It will have similar outputs to viewRose component so you can customize it for your own use. -Mostapha

Comment by Abraham Yezioro on April 13, 2014 at 12:03am

Hi Mostapha,

Will be true to assume the Shading Mask will have also transparency output?



Comment by David on April 12, 2014 at 7:16pm

Amazballs, just as the prompt answer. Keep it up :)

Comment by Mostapha Sadeghipour Roudsari on April 12, 2014 at 7:11pm

Hi David, Thanks. You shouldn't feel bad as to my knowledge it is not possible to render meshes with transparent colors. Here is a wish-like discussion.

In that image I'm using an old version of Ladybug where the output of skyDome was Breps. In the newer versions it is a colored mesh. You can still convert the meshes to breps and apply transparent colors to them as a work around.

However, your post reminded me that how cool a transparent sky dome is. I added an extra output to the component so you will have access to the breps and can apply transparent colors to them as you can see in the image below.

Here is the updated file: 

Comment by David on April 12, 2014 at 3:31pm

Hi there,

First of all, great work on Ladybug and Honeybee. Really looking forward to the Butterfly so I can stop using Geco/Ecotect/WinAir for the CFD.

Secondly, and I feel stupid for asking, but I couldn't figure out how you got your meshes transparent (especially the skydome) as in your (kick ass) presentation.


Comment by Mostapha Sadeghipour Roudsari on April 10, 2014 at 6:16am

Petar, I can't reproduce that issue on my system. Can you check the output of Honeybee_Honeybee component and make sure everything is fine? The issue should be solved if you let the Honeybee fly again!

As a side note, reflectance values should be between 0 and 1. 1.5 is not a valid input. For some reason I forgot to catch this in the material component.

Please open discussions for cases that you need to share files. Thanks. :)

Comment by Petar Pejic on April 10, 2014 at 3:48am



Hi Mostapha, could you check out this file? I have trouble all of the sudden running some honeybee components. It reports different messages

Comment by Abraham Yezioro on April 8, 2014 at 7:15am

Hi Mehrnoosh,

I suggest to open a discussion and attach the problem file, so any of the followers can help. Will be more effective.


Comment by mehrnoosh on April 8, 2014 at 6:50am

hi Mostafa ,

I could not solve the problem, even by changing the folder name.

i attached the file again .

thank you


Comment by Michalina Dengusiak on April 3, 2014 at 11:10am

Hello world...


Members (369)



Search Grasshopper


  • Add Photos
  • View All

© 2014   Created by Scott Davidson.   Powered by

Badges  |  Report an Issue  |  Terms of Service