algorithmic modeling for Rhino


Ladybug + Honeybee

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

Release notes

Download Ladybug and Honeybee

Example Files for Ladybug

Example Files for Honeybee

Ladybug on GitHubHoneybee on GitHub

Developers: Mostapha, Chris, Saeran and Chien Si

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

Members: 440
Latest Activity: 5 minutes 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


Release Notes - September 15thLadybug 0.0.58 and Honeybee 0.0.55: We are all pleased to announce that, after months of development and a long fruitful summer, we will be releasing a new stable…Continue

Tags: OpenStudio, EnergyPlus, Radiance, Comfort, 0.0.55

Started by Chris Mackey. Last reply by Chris Mackey 22 hours ago.

Azimuth/Alttude problem 4 Replies

Hi Mostapha,I did a crossed verification between many solar simulation softwares and saw a shifting in the results produced by…Continue

Started by laurent lescop. Last reply by laurent lescop on Thursday.

Ladybug + Honeybee Wiki 8 Replies

Greetings LB+HB Community!I write to start a discussion about the future LB+HB wiki.  Please post here any suggested features that you might want for the wiki and any good examples of other wikis…Continue

Tags: Roudsari, Chris, Mackey, Mostapha, Suggestions

Started by Chris Mackey. Last reply by Wim R.M. Dekeyser on Thursday.

Add Glazing 20 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 Mostapha Sadeghipour Roudsari on Thursday.

Ladybug Tweets

Comment Wall


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

Comment by Brian Ringley 5 minutes ago

Wonderful those all work. Going HAM w/Andrew's HUD tools as we speak.

Comment by Mostapha Sadeghipour Roudsari on Saturday

Hi Brian. Good point. There are couple of solutions that I can think of.

1. Use Grasshopper's orient component and orient it to any new plane that you want. (You can also use it with Ladybug's orient to camera component and orient it to your view.)

2. Use createLegend component and create your own and locate it in any location that you want.

3. Use Mesh2Screen from Andrew's Human plugin and orient the legend to screen.

Comment by Brian Ringley on Friday

Is there a way to modify the default legend orientation? It seems to be more suited for the northern hemisphere where you're often orienting views toward a south view of the building (from Y-), but since I'm running Ladybug on some Australian projects I'm finding that I'm rotating legend information 180 degrees so I can view it from the north (from Y+). If there's not a way let me know and maybe this is something I can add as a vector or 0-360 degree input to the legendParameters user object.

Comment by Mostapha Sadeghipour Roudsari on September 6, 2014 at 8:53pm

Hi Michalina! Sorry that I missed your comment. Congratulations and wish you all the best. :)

Comment by Mostapha Sadeghipour Roudsari on September 4, 2014 at 7:24am

Hi Aaron. It sounds like a problem that comes with using an older version of Honeybee_Honeybee with a newer version of other components. I recently added a versionCompatability check to all the components so if you are using updated components it should give you a warning! I am not sure why updateHoneybee didn't really update your components. I think I need to add few lines to remove the old version before copying the new ones. They should look like this:

I can check your file later in the evening. Please open a discussion for cases like this instead of sending a comment.



Comment by Aaron Loomans on September 3, 2014 at 4:17pm


Help! I'm getting the error that 'createHBZones is not defined'. I don't think it's a problem with the geometry, it's all closed polysurfaces. I thought maybe my honeybee was out of date so I reinstalled and re-dropped the update and honeybee_honeybee components and ran them. Still not working, what am I doing wrong?!

Files attached


Comment by djordje on August 28, 2014 at 2:16pm

great to hear that :)

Comment by Michalina Dengusiak on August 28, 2014 at 2:07pm

Honeybee shape and color evolves - me too, my first day at school. Done!

Comment by Thomas Lechner on August 27, 2014 at 1:20am


thanks, that is what I was looking for - tried changing the -O1 to -O0 in the .bat and applied that data - in a firs quick calc i got different results - so there seems to be at least something working - have to compare that to radiance results.

it would be great if this function could be implemented - for basic daylight design - this would be a great feature to get for example lowest and highest loads on windows during a certain time an so on - thank you for your great work!

Comment by Mostapha Sadeghipour Roudsari on August 26, 2014 at 9:42pm

Hi Thomas and Reinier,

Reinier is right that the component won't consider reflections, however there is a way to generate visible range of light for the sky and then use Ladybug radiation component. You can use -O key in gendaymtx to only output visible radiance:

In case you want to do the adjustment make sure to run comparative runs with Honeybee before using it for multiple cases and I think you SHOULD NOT use this method for any interior analysis. 


Members (440)



Search Grasshopper


  • Add Photos
  • View All

© 2014   Created by Scott Davidson.   Powered by

Badges  |  Report an Issue  |  Terms of Service