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.

Installation Instructions

Download Ladybug and Honeybee

Remove Old Version

Example Files for Ladybug

Example Files for Honeybee

Ladybug on GitHub

Honeybee on GitHub

Use this Reference for your Publications.

Licensed under @license GPL-3.0+

Read more here

Members: 810
Latest Activity: 1 hour ago


What is Ladybug?

Ladybug is an open source environmental plugin for Grasshopper3D that helps architects and engineers create an environmentally-conscious architectural design.  Ladybug imports standard EnergyPlus Weather files (.EPW) into Grasshopper and provides a variety of 3D interactive graphics to support the decision-making process during the initial stages of design.

What is Honeybee?

Honeybee connects Grasshopper3D to EnergyPlus, Radiance, Daysim and OpenStudio for building energy and daylighting simulation.The Honeybee project intends to make many of the features of these simulation tools available in a parametric way.

You can get started by watching this video:

Here are four separate playlist:

Want to see a full presentation?

Check out this presentation or watch it: Part1Part 2

And this video here:

Discussion Forum

Human Comfort Analysis issues

Hey Mostapha,I'm a colleague of Patrick Chopson and Sandeep Ahuja. We've been working on a HB model for a residential tower in Oakland, CA where we are trying to meet Human Comfort code requirements…Continue

Started by Jeremy Bamberger 1 hour ago.

Read EP results does not access data

Hi Everyone,I've ran into a problem that I've not been able to solve. I made a definition which runs a smooth simulation with the exception of two 'severe' errors which I don't think are very…Continue

Tags: results, EP, read, output, No

Started by Samuel de Vries 9 hours ago.

add a "total building energy consumption" output for the "energy balance" component? 3 Replies

Hi Mostapha and Chris,The new energy balance component is great for understanding the various sources of heat gains and losses!I wonder if we can add an additional output "total building energy…Continue

Started by Grasshope. Last reply by Grasshope 10 hours ago.

Discussion: Accuracy of Daylight simulations with no wall thickness? 1 Reply

Hi All,I'd like to start a discussion, or general questions in regrades to the use of simple models for daylighting analysis. Where we understand that thermal models do not require the thickness of…Continue

Started by Elzine Braasch. Last reply by Chris Mackey 14 hours ago.

Ladybug Tweets

Comment Wall


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

Comment by Robert Narracci 2 hours ago

Thank A!


Comment by Abraham Yezioro 3 hours ago


I suggest you open a new discussion for this issue. It is general enough so it can be accessed easily later on.

LB will be helpful for you only for outdoors. Also take into account that it doesn't take into account reflection of buildings. Just the "plain" weather data.

For interior you need to use HB (and by means of that, Radiance and/or Daysim, depending on the analysis type you are interested on.

The grid size question: It is not that one size is correct and the other isn't. It dependes on the time you have for the calculations to be done. If your model is small and you can afford a small grid size this will be the best (the smaller the grid the more accurate results you'll get). But if the simulation takes longer times then you enter intoa trade off situation: time against accuracy. Comparing a 1 mt grid with a 10 mt grid is exactly his: with the later you sacrifice accuracy, but of course it was really quick for the calculations to finish.


P.S. i'm going to submit a new discussion, related to this one later today (hopefully).

Comment by Robert Narracci 6 hours ago

Hi Mostapha,

I  will be studying façade opacity/transparency and sunshading options for an office building and I thought it would be helpful to do a radiation analysis in LB0.0.59. \

I grabbed your template, reorganized it a bit for a June 21 7am-7pm study (everything in orange bubbles below)… However I realized that the template was only the Sky Dome Visualization tool.

So I took a wild guess and I grabbed the Ladybug_Radiation_Analysis component using it to produce a mesh on the floor of an office building. (everything in white bubble below)

1) Is this the correct component to give me relative values of sunshade behavior? (Later I’ll connect my sunshade geometry into the Context input to block incoming daylight)


2) Is it incorrect to let the grid size be anything except 1m square? (I ask because the individual, total and average Radiation result output values swing wildly when I change the grid size.)

My Best,


Comment by Luca Biselli on September 29, 2015 at 10:00am

Thanks Mostapha. I am trying to simulate annual average solar radiation on some doubly curved panels, to see which ones can have solar cells on, based on their efficiency.

Comment by Mostapha Sadeghipour Roudsari on September 29, 2015 at 9:56am

@Luca, Chris said it all. I just want to add that if you're using Honeybee for daylighting simulation the scale doesn't matter as far as you stay consistent and you're not using BSDF materials. Also you need to change RAD Parameters to match your units.

Comment by Chris Mackey on September 29, 2015 at 5:53am
Ladybug works with nearly all unit systems (including SI and IP). Honeybee works exclusively in meters (as this is the unit system of E+ and we make you use units for our own sanity). So, as long as you stick to Ladybug, feel free to use either m or mm.
Comment by Luca Biselli on September 29, 2015 at 2:29am

Hi Mostapha,

Thank you for the development of Ladybug and Honeybee. They are really great. I am testing some of their features. Is the preferred option to run the analysis in m or in mm?



Comment by Chris Mackey on September 28, 2015 at 11:29pm


This github repository is the one where you should be opening issues about requests and bug reports about Hydra:

Thanks for playing around with it!


Comment by Abraham Yezioro on September 28, 2015 at 2:04pm

Hi Chris nd Mostapha,

Don't know where is the place to give some feedback to the Hydra ...

I'm having some browser issues (Firefox, Chrome and MS Edge) with some of the u[ploaded files: Armature for Maximum Solar, Armature for Energy-Positive Building Experiment and XmasQMEF. The image crashes the page. The worst is in Firefox, where the browser turns black.


Comment by Abraham Yezioro on September 27, 2015 at 8:02am

Uploaded another one ...


Members (810)



Search Grasshopper


  • Add Photos
  • View All

© 2015   Created by Scott Davidson.   Powered by

Badges  |  Report an Issue  |  Terms of Service