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: 436
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

Please help me have a look at how to solve this problem.It's about Honeybee. 3 Replies

Please help me have a look at how to solve this problem.It's about Honeybee.It's ok when I run it on the first time.But now it can't work.The following is the content of the tip.{0}0. Loading RAD…Continue

Started by Bill Chow. Last reply by Abraham Yezioro yesterday.

Honeybee materialLib Exception 2 Replies

Leaving this narrative of fixes up here in case someone searches for the keywords, otherwise I fixed what I broke. The definition setup itself works.----Edit 2: Solved. Old version of…Continue

Started by Max D. Last reply by Max D on Friday.

Handling complex geometry in Honeybee vs DIVA 3 Replies

Honeybee and Ladybug work great when using relatively simple geometry, either generated in Rhino or Grasshopper. However, sometimes I receive a more complex file for analysis, and when I try to use…Continue

Started by Reinier Zeldenrust. Last reply by Mostapha Sadeghipour Roudsari on Friday.

Ladybug and Honeybee Presentation at IBPSA-USA New York Regional Chapter 6 Replies

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 Reinier Zeldenrust on Friday.

Ladybug Tweets

Comment Wall


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

Comment by djordje on Thursday

great to hear that :)

Comment by Michalina Dengusiak on Thursday

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. 

Comment by Thomas Lechner on August 26, 2014 at 12:04pm

yes that is what i thought - converting them.

with honeybee and radiance it is a bit too complicated and processor intense i guess for easy estimations -- what im looking for is the radiation component but  with lux  - what i thought is - in the weather file there are the measured lux already wirtten - so it should be the same calculation as for kw - do you think there is a possibility to "manipulate" that componente in order to get that terms?

Comment by Reinier Zeldenrust on August 26, 2014 at 7:31am

Hi Thomas, for lux levels you will have to use the Honeybee components that calculate luminance and illuminance using Radiance

You could theoretically take the kW figures from Ladybug and convert them to lux using the relevant efficacy figures in lm/W (which will depend on the weather) but those will be very approximate as they don't include reflection. 

Comment by Thomas Lechner on August 26, 2014 at 7:01am

Hello, is there any way in Ladybug to get lux values instead of kw when doing an analysis - as there are lux values in the weather data it should be possible - right? maybe i just missed the option - i only find radiation analysis - thanks

Comment by Abraham Yezioro on August 25, 2014 at 2:43pm


I bet it is an update issue. Last date of tehe component is Aug 20. You are using an "old" version. Try to re-insert the component from the LB tab (instead of assuming the automatic update will take care of the issue).

Comment by Aaron Loomans on August 25, 2014 at 11:51am

I'm having an issue with the ladybug radiation analysis component, getting the error "too many values to unpack" when just a couple hours ago the same model and component were running fine. I ran updates and don't believe that's the issue. How do I troubleshoot?


Comment by Mostapha Sadeghipour Roudsari on August 23, 2014 at 10:25am

Hi Dimitris. If I understand it right it is very similar to VSC with the difference that it will be calculated on a horizontal grid. You can find the line by culling mesh surfaces under .2%. Feel free to open a discussion and add more details about the calculation method.


Members (436)



Search Grasshopper


  • Add Photos
  • View All

© 2014   Created by Scott Davidson.   Powered by

Badges  |  Report an Issue  |  Terms of Service