NOTE: As of March 2021, this package has been deprecated in favor of the newer LBT-2-PH. This older IDF-2-PH package will ONLY work with the older LadyugTools v0.0.66. In order to work with the new LadybugTools V1+, please use the LBT-2-PH. instead. Note that the IDf-2-PH is no longer being developed or supported.

To check out the new updated LBT-2-PH package, follow this link to:

a set of tools to drive PHPP models from
within grasshopper using Honeybee and EnergyPlus.

Disclaimer: Before you continue note that these tools in no way replace the PHPP or Honeybee, nor are they affiliated with the Ladybug Tools team or Passive House Institute in any way. These tools are created independently and are simply provided here for use by those who are interested. These tools are in an early, early stage of development: do not use them on important files or projects. We're not responsible for anything that breaks as a result. Use at your own risk.

The IDF2PH toolkit is made of three main pieces:

Rhino 3d Logo

New PHPP Tools for Rhino

Honeybee Logo

New PHPP Tools for Honeybee

EnergyPlus Logo

A New IDF->PHPP Exporter

The IDF2PH tools allow you to construct, refine and control the entire PHPP static energy model from with Rhino's grasshopper environment while simultaneously creating a parallel model within Honeybee and EnergyPlus for dynamic model assessment. These tools allow for a wide variety of uses and levels of detail, from simple geometry export from the IDF up to complete PHPP control and multi-zone modeling. The tools can also be used for simple IDF-->PHPP export and conversion even without using any of the Honeybee or Rhino side components.

What you'll need for these tools to work:

IDF2PH | Piece 1: Rhino PHPP Objects

GH Model Components


GH Model Components


GH Model Components


GH Model Components

TFA Rooms

GH Model Components


GH Model Components


The Rhino side plugins allow you to easily host attribute data on Rhino geometry which will flow into the IDF2PH plugins and PHPP model. This includes assembly information such as U-Values as well as names, types and exposures (ground, air, etc..). All this data is stored in the Rhino file and can be edited and updated at any time.

IDF2PH | Piece 2: HB PHPP Objects

GH Model Components

Model PHPP Objects such as
Windows, Surfaces, HRV, DHW

GH IDF2Excel Components

Convert IDF to PHPP
and Write to Excel

The Grasshopper side components allow you to read object attributes from Rhino, add additional data or information, and pass this building data to both the EnergyPlus IDF as well as the PHPP output model. These components work 'in-line' with the existing Honeybee tools and supplement them where needed in order to correctly format information for the PHPP.

IDF2PH | Piece 3: IDF-->PHPP Exporter

EnergyPlus Logo

IDF2PH will automatically read, organized and export the EnergyPlus model to a PHPP Excel file from within the Grasshopper environment. IDF2PH will work with multi-zone models and allow you the option of writing each thermal zone to a separate PHPP, or combining them all together into a single output file.