lbt-dragonfly is a collection of core Python libraries for creating and analyzing urban climate and energy models, including geometric modeling, weather data handling, and simulation setup for building performance analysis. It is part of the Ladybug Tools suite. The current version is 0.13.7, and it typically sees frequent patch releases and minor updates.
pip install lbt-dragonflyVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to create basic geometric and energy model components using `lbt-dragonfly`. It shows the creation of a `Room`, a `Building`, and an `EnergyModel` linked to the building.
Ensure OpenStudio is correctly installed and configured on your system if you intend to use `dragonfly-openstudio` features. Review the Ladybug Tools OpenStudio installation guides for detailed instructions.
Refer to the Ladybug Tools documentation for guides on installing and configuring necessary simulation engines (e.g., OpenStudio) to unlock full simulation capabilities. You will typically need to install these separately.
Always consult the specific class or function documentation for expected input units. Use helper functions for unit conversions where available (e.g., in `ladybug-geometry` or `honeybee`), or convert your data to the expected units before passing them to Dragonfly functions.
Run `pip install lbt-dragonfly` to install the library. If already installed, ensure your Python environment is correctly activated.
Upgrade your `lbt-dragonfly` installation to the latest version: `pip install --upgrade lbt-dragonfly`. If the problem persists, try reinstalling it in a fresh virtual environment.
Ensure the necessary simulation engine (e.g., EnergyPlus, OpenStudio) is installed on your system and its executable path is correctly configured in your system's PATH environment variable, or provided explicitly to the Dragonfly functions that require it. Refer to Ladybug Tools installation guides for engine setup.