algorithmic modeling for Rhino

Release Notes - February 3rd 2015

Ladybug 0.0.59 and Honeybee 0.0.56:


We are all pleased to announce public release of Ladybug 0.0.59 and Honeybee 0.0.56. and you can download it from Food4Rhino. Here are major changes and enhancements.


  1. More Flexible Workflow - Many small modifications were made to support a more flexible workflow, such as the ability to separate a zone created with masses2Zones into editable HBSrfs that can be recombined.  For the energy components, it is now possible to plug custom constructions directly into the components that set the zone constructions without writing them first into the library.  For the daylighting components it is now possible to change all of the materials of specific surface types at once.

  2. Support for Complex Geometry - Many small bugs for complex geometry have been fixed including the ability to import energy results correctly for curved NURBS surfaces as well as unconventional window configurations.  Also, the intersectMasses component now almost always succeeds in splitting all of the surfaces of adjacent zones, no matter how complex the intersection is.

  3. Automatic Download Issues Fixed - Many users who faced issues with not having “gendaymtx.exe” or who had trouble syncing with our github know that we faced an issue with automatic background downloads.

  4. Air Walls - Honeybee EnergyPlus models now officially support air walls (or virtual partitions) in a basic implementation.  Now, any time that you use the air wall construction or set a surface type to “air wall,” the air between adjacent zones will be automatically mixed.  At present, this mixing is just a constant flow based on the surface area between zones connected by air walls multiplied by an adjustable “flow factor.”  It is important to stress that this basic air mixing is not with the EnergyPlus Airflow Network, although the groundwork laid in this release will eventually allow for the implementation of the  Airflow Network in future releases.  As such, this present air mixing is only suitable for multi-zone conditions where there is not significant buoyancy-driven flow between zones.

  5. Natural Ventilation - To go along with the new potential introduced by air walls, there has been a basic implementation of EnergyPlus’s natural ventilation objects in a new component called “Set EP Airflow”.  The current setup allows for three possible types of natural ventilation: 1) natural ventilation through windows (with auto-calculated flow based on window area, outdoor wind speed/direction, and stack effects), 2) custom wind and stack objects that can be used to model things such as chimneys off of single zones, and 3) constant, fan-driven natural ventilation.

  6. Additional Thermal Mass - The capability to add additional thermal mass to zones has been added.  This is useful for factoring in the mass of indoor furniture or heavy interior objects such as chimneys.

  7. New Utility Components - Abraham has added a couple of useful components to help calculate lighting loads based on bulb types and target lighting levels as well as a converter from ACH to the m3/s-m2 that the other HB components accept.  Along this vein, there is also a component for adding in the resistance of Air Films to HB constructions.

  8. Improved and Editable Ideal Air Loads System - The EnergyPlus Ideal Air System now goes through an automatic sizing period at the start of the simulation based on the extreme weeks of the weather file.  Furthermore, the ability to adjust many of the parameters of the ideal air loads system have been added with a new “Set Ideal Air Loads Parameters” component.  The component allows you to add in heat recovery, air side economizers and demand-controlled ventilation.

  9. OpenStudio Export Update - The OpenStudio workflow is still largely under development but this release includes a version with a working VAV and PTHP system template for those curious with experimenting.  Note that not all of the new features available for the basic “Run Energy Simulation” component are available for the OpenStudio component (such as air walls, natural ventilation, or additional thermal mass).

  10. Microclimate/Indoor Comfort Maps - Blossoming from initial experiments with the radiant temperature map, a workflow for looking into sub-zone microclimate and indoor comfort has been initiated.  All components for this are presently under the Honeybee WIP tab but, over the next month, they will be completing their development phase and moving into the rest of the tabs.  If you are interested in testing when they are ready, please let Chris know.  For a teaser video of the intended capabilities, see this video: (



  1. Monthly Bar Chart - After much demand from multiple parties, a new component to create monthly bar and line charts has been added.  The component is particularly useful for plotting the outputs of the “Average Data” component like monthly EPW data or averaged monthly-per hour data.  It also supports daily data and any type of Energy simulation results.

  2. Wind Profile - To go along with the new capabilities of natural ventilation in Honeybee, Ladybug now has a fully fleshed-out Wind Profile component that allows you to visualize how wind speed changes with height in relation to your building geometry.  The component is geared to understanding the conditions of prevailing wind and will be useful in the future for setting up CFD models.  Credit goes to Djordje Spasic for adding in all of the new capabilities. In a similar vein, the appearance of the wind rose has also been improved thanks to suggestions from Alejandra Menchaca.

  3. Faster Solar Adjusted Temperature - Thanks to the SolarCal method from the Center for the Built Environment at UC Berkeley (, the solar adjusted temperature component now includes an option for a much faster calculation that produces results that are very close to those originally obtained with the genCumSky component.  Instead of using the cumulative sky, the component can now accept the direct and diffuse radiation from the ImportEPW component.  Over a whole year, this essentially takes a calculation that used to be a half-hour and shrinks it down to 10 seconds.  Thanks again to those at UC Berkeley for keeping their work open source!

  4. Instructions - Last but not the least, [It took me almost two years to understand this but finally] we have a text file that describes the installation step by step and is way easier to modify than a video. You can find it in the zip file. Credit goes to Chris!


We also want to welcome Anton, Patrick and Sandeep to the teamAnton has kicked off his development by working on a component to import and visualize epw ground temperature data and he will be continuing to develop components to bring in reliable precipitation data to Ladybug.  With this basis, he will continue to implement Honeybee components for ground heat storage, earth tubes, rain collection and hot water systems. Patrick and Sandeep are working on integration of Honeybee to Energy Performance Calculator.


As always let us know your comments and suggestions.


Views: 3885

Replies are closed for this discussion.

Replies to This Discussion

Hi Blanca,

I flip back and forth quite often between imperial and metric projects and usually find that when I recycle code for a daylight simulation I forget to adjust the grid units and crash the simulation. have you checked this?







  • Add Videos
  • View All

© 2024   Created by Scott Davidson.   Powered by

Badges  |  Report an Issue  |  Terms of Service