Ironbug Preview Release

Hello community!

Today, I am excited to announce the Ironbug Preview release. Since the beta version that released last summer (this post), I have been using Ironbug’s HVAC components to model both LEED baseline and proposed energy model for three real projects in our office, which include a 160,000 sqft school, a 190,000 sqft office building, and a 1,200,000 sqft 60 floors high-rise commercial building, with all different types of systems in current Honeybee energy modeling workflow. So it is totally possible to do the full energy modeling in Grasshopper with Honeybee. With this new integrated workflow, we are able to minimize the efforts to approach the solutions, the process to full energy modeling, which gives us extra days to really dig into the results and understand some HVAC behaviors.

Lessons learned and experiences can now really be preserved and shared to others; A similar system can be replicated from one project to another with Ctrl+C and Ctrl+V (this might sounds like a joke, but it was impossible in HVAC energy modeling world; as same as Ctrl+Z).

Ironbug has been constantly improved and tested in those three projects, and also upgraded based on comments from @josh.greenfield, @Elliot_Glassman, @HAOBOLIU, @TWANG1017 etc,. Thanks for your testing, and providing variable feedbacks.

For those who hasn’t been following the updates of this project, Ironbug is a group of tools that are written in C# to broad and improve the current Ladybug tools’ capacities and performances. It currently includes two components, ImageViewer, SortByLayers in Laybug category; two components, ReadAnnualResultsIII, IntersectMassesII in Honeybee category; and additional more than 130 HVAC components (by April 14th, 2019) that enables the abailabity for customizing OpenStudio airloops, plantloops, VRF and zone equipments in Grasshopper.

Installation Instructions:

  1. Download the (2.1 MB) from Github release page and unblock the file.


  2. Unzip all files to C:\Ironbug , and open in Grasshopper. (All Rhino versions supported)

  1. Set toggle to true to install.
    Make sure you have OpenStudio 2.5.0 installed at “C:\openstudio-2.5.0”.
    (I have been testing Ironbug with OpenStudio 2.8, and it will be supported when it is released)

  2. Restart the Grasshopper, and you should be able to find Ironbug tab like this:

    Start with Ironbug_HVACTemplates and enjoy!

Some resources:

  1. Add HVAC system from templates.
  1. EnergyPlus Documents
  1. Add output probes to loop.
  1. Create a VRF + DOAS system (this video might be old, but the concept and workflow is the same)
  1. Hydra Share

-Mingbo Peng


@MingboPeng Thanks for your excellent work. Ironbug is a wonderful plug-in for HVAC engineer.


@MingboPeng Thanks for your really good work!

Wonderful work Mingbo!! Thank you!!!

Thanks, Mingbo. Incredible work on your part, have enjoyed test driving it.

@MingboPeng Excellent work! You open a new door to build up a detailed energy model in GH platform!

Thanks, it helps a lot to model detailed HVAC with better visualisation,

Thank you for this. I’ve tried installing it, but for some reason, I’m not getting an ironbug tab. The ironbug file has been copied to the right folder, I’ve restarted rhino and grasshopper several times, but still no tab is showing.

Did you unblock the zip file?

I have downloaded Ironbug version V0.0.14, but there was A problem:
(1. The simulation has not run correctly because of this severe error:
** Severe ** ZoneHVAC:LowTemperatureRadiant:SurfaceGroup = ZONE HVAC LOW TEMPERATURE RADIANT VARIABLE FLOW 2CEILINGS does not have any surfaces listed.

when I applied the self-provided template “Default/Sys13_RadiantPanel+DOAS”. I don’t know whether it was the problem of my computer or other reason .
Thank you


Did you set “radiant panel” construction correctly to ceilings?
Here is an example from @chris :,0