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: 432
Latest Activity: yesterday





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

Annual Daylight Simulation (MassesToZones component) struggles with "donut" shaped BREPS 4 Replies

Working from example file 06, from honeybee, the annual daylight analysis....Everything works fine when i reference masses that are relatively simple extrusions of a boundary curve, such as the…Continue

Started by Octagon26. Last reply by Octagon26 on Tuesday.

Ladybug + Honeybee Wiki 4 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 Saeran Vasanthakumar on Monday.

Ladybug Radiation Analysis Legend not appearing 4 Replies

Hello Mostapha,I ve been using Ladybug to run some Radiation Analysis,For some dates, (not all of them), there seems to be some issue with the legend not showing up when I set the Analysis period to…Continue

Tags: legend, period, analysis, ladybug

Started by Dimitrios Papadopoulos. Last reply by Dimitrios Papadopoulos on Monday.

Ladybug and Honeybee Presentation at IBPSA-USA New York Regional Chapter 1 Reply

Hi all,1. Chris, Chien Si and I will present Ladybug and Honeybee at IBSA-USA NYC this Thursday (August 21st). The presentation will include some of the latest developments that we are working on. If…Continue

Started by Mostapha Sadeghipour Roudsari. Last reply by Michal Dengusiak on Monday.

Ladybug Tweets

Comment Wall


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

Comment by Mostapha Sadeghipour Roudsari on Monday

A good practice is to change the name of radFile for each run so you get separate folders. In case you are worried about the results to be overwritten accidentally set overwriteResults input to False.

Comment by Octagon26 on Monday

Working on the annual daylight simulations here... this is probably really obvious, but QUESTION: is there a way to save the simulation result so that if the file is closed, and then re-opened, you do not need to run the analysis again to view the falsecolor mapping (e.g. results) ?


Comment by Reinier Zeldenrust on Friday

Hi, I don't think it takes into account reflected radiation. If you hover over the component it does tell you all the specifics of the calculation and says that if you need reflection etc. that it's best to look at the Honeybee components. 

Comment by Octagon26 on Friday

Quick question. With the gen cumulative sky implementation in Ladybug, do the calculations account for the contribution of radiation to a target surface which is reflected off of the "context" passed to the component? Or does it just account for the direct line-of-sight contribution of diffuse and direct solar radiation between the target surface and the sky vault?   I am going to do a little test of this, but i though i would just ask. Presumably, if reflected radiation is considered, then material properties must be defined somewhere...

Comment by Jason Smith on June 28, 2014 at 9:05pm

Thanks for the quick reply Mostapha! The sample file in the discussion you linked works fine on my machine, not sure what the issue is...I did start a new discussion here...Thanks again!

Comment by Mostapha Sadeghipour Roudsari on June 28, 2014 at 7:55pm

Hi Jason, You don't need to use Mass2Zone. You can use createHBSrfs instead. There are examples in discussions including this one. If it didn't solve the issue please start a new discussion and upload an example file.

Comment by Jason Smith on June 28, 2014 at 7:49pm
Hi Mostapha, I'm trying to create a definition to perform an annual daylight analysis without using a mass2zone as a starting point (I've modeled walls and glass already and want to use the rhino geometry as a start point). Everything looks like it works in gHop, but the cmd windows run indefinitely... I'd it possible to cook the analysis this way or do I have to start with a mass 2 zone component?
Comment by kostas mourkos on June 23, 2014 at 1:16pm

Many thanks for your answer . I had to move the sunpath, now it works fine.


Comment by Abraham Yezioro on June 23, 2014 at 12:45pm

Kostas, you need to set the sunpath scale and the shading mask to the same value. Also take care they both have the same base point. Those two should do the trick.


Comment by kostas mourkos on June 23, 2014 at 9:58am

Hi Mostapha , I was trying to overlay the shading mask with the sun path but with no success.

Thanks in advance.



Members (432)



Search Grasshopper


  • Add Videos
  • View All

© 2014   Created by Scott Davidson.   Powered by

Badges  |  Report an Issue  |  Terms of Service