Skip to content

Installation

James Ramsden edited this page Dec 19, 2022 · 2 revisions

Introduction

The Python extensions provided here aim to simplify several workflows integrating Ladybug Tools as part of general engineering workstreams. They are distributed as part of the BHoM, and constitute a mirror-image of the LadybugTools Python environment created when installing Pollination. Currently Pollination version 1.3.3 is supported.

Prerequisites

You must have the following installed in order for this toolkits Python environment installation to work fully:

... and that's it! Unless you want to use the tools via your BHoM UI of choice (Grasshopper, Revit, Excel, ...).

Installing the LadybugTools_Toolkit Python environment

In your BHoM UI of choice, run the following method:

>>> BH.Engine.LadybugTools.Compute.InstallPythonEnv_LBT

Running this method will, if necessary, install the base BHoM Python environment. Once the base has been installed, then it will be used as the basis from which a new virtual Python environment is created, mirroring the Python environment provided by Pollination - but with the addition of the code available here.

Beta 6.0 known issue

There is a known issue with the Beta 6.0 release that may prevent some LadybugTools_Toolkit components from working correctly.

If you are having problems on upgrade, please try the following:

  1. Ensure that Excel, Revit and Rhino are closed
  2. Delete this folder and all of its contents: C:\ProgramData\BHoM\Extensions\PythonEnvironments
  3. From your BHoM interface of choice, run the InstallPythonEnv_LBT method as above to reinstall the environment.

This known issue is scheduled to be resolved in the 6.1 beta release.