1.2 Mac Installation Steps - ladybug-tools/lbt-grasshopper GitHub Wiki

Mac Installation Steps

  1. Download the latest version of the Ladybug Tools plugin on Food4Rhino.

  2. Inside the download, you will find an installer.gh file. Open it in Grasshopper and and you will see two components with True/False toggles connected to them. Go to the first component and set it to True by double-clicking on it.

First Component

The component will take a second to run while it downloads Python to your machine. Python is the computer language in which Ladybug Tools is written and is one of the fastest-growing programming languages.

  1. When the component finishes, it will tell you the next steps, the first of which is to unzip the build of Python that just downloaded to your machine. Navigate to the location noted in the output of the component. This should be /Users/[USERNAME]/ladybug_tools/python.zip but with your own username for [USERNAME].

python.zip

Unzip the file INTO THE SAME PLACE AS THE .ZIP file. At the end you should have something that looks like this:

Install Python Location

  1. Go back to the installer.gh file and set the second toggle to True:

Second Component

This component will take a few seconds to run as it downloads the Ladybug Tools core libraries into the Python installation that you just unzipped. This component also downloads all of the Ladybug Tools Grasshopper components. Lastly, a library of default assets (constructions, schedules, modifiers, etc.) will be downloaded to \ladybug_tools\resources\standards.

  1. Restart Rhino and you should see the Ladybug Tools components available in new tabs. Congratulations! You now have a working version of Ladybug Tools.

Optional Steps

1. Install Radiance - If you want to be able to run daylight and solar simulations, you must install Radiance. Radiance is a physics-based rendering engine, which is what Honeybee uses for all daylight and spatial solar studies. Check the compatibility matrix to determine which version of Radiance is compatible with your version of Ladybug Tools. Download that version of Radiance from the Radiance Github. Run the Radiance executable and accept all of the defaults.

2. Install OpenStudio - If you want to be able to run energy simulations, you must install OpenStudio. OpenStudio is a programming interface for EnergyPlus, which is the engine that Honeybee uses for building energy simulation. Check the compatibility matrix to determine which version of OpenStudio is compatible with your version of Ladybug Tools. Download that version of OpenStudio from the OpenStudio Github. Run the OpenStudio executable to completion. While it is not required, when you get to "Installation Folder," we recommend installing it in your [USERNAME]/ladybug_tools folder in order to keep all of your Ladybug Tools resources in once place (though the default location is acceptable). Note that you should use your own username for [USERNAME].

Install OpenStudio Location

3. Install URBANopt - If you want to be able to use the Dragonfly "Run URBANopt" component to run urban district energy simulations, you must install URBANopt. URBANopt is software package that leverages OpenStudio and EnergyPlus to model the energy use of urban districts. Download the latest URBANopt executable installer from the URBANopt documentation and run the installer to completion, accepting all of the defaults.