{"id":9882,"library":"lbt-honeybee","title":"Honeybee LBT","description":"lbt-honeybee is a Python metapackage that bundles the core Honeybee libraries for environmental building performance analysis. It provides access to tools for creating building geometry, assigning materials and boundary conditions, and preparing models for advanced simulations like daylighting (Radiance) and energy analysis (EnergyPlus/OpenStudio). The current version is 0.9.297, and it sees frequent minor updates, primarily for dependency bumps.","status":"active","version":"0.9.297","language":"en","source_language":"en","source_url":"https://github.com/ladybug-tools/lbt-honeybee","tags":["building analysis","energy simulation","daylighting","radiance","environmental modeling","ladybug tools"],"install":[{"cmd":"pip install lbt-honeybee","lang":"bash","label":"Install core package and dependencies"}],"dependencies":[{"reason":"Provides core geometric and analytical model classes.","package":"honeybee-core"},{"reason":"Adds energy simulation capabilities and related models/objects.","package":"honeybee-energy"},{"reason":"Adds daylighting and glare analysis capabilities and related models/objects.","package":"honeybee-radiance"}],"imports":[{"note":"lbt-honeybee is a metapackage; core classes are imported from 'honeybee' (which is honeybee-core).","wrong":"from lbt_honeybee.model import Model","symbol":"Model","correct":"from honeybee.model import Model"},{"note":"Face objects are part of the core honeybee package.","wrong":"from lbt_honeybee.face import Face","symbol":"Face","correct":"from honeybee.face import Face"},{"note":"Honeybee-energy has its own Model class, often aliased to avoid conflict with honeybee.model.Model.","symbol":"EnergyModel","correct":"from honeybee_energy.model import Model as EnergyModel"},{"note":"Honeybee-radiance also has its own Model class, typically aliased.","symbol":"RadianceModel","correct":"from honeybee_radiance.model import Model as RadianceModel"}],"quickstart":{"code":"from honeybee.model import Model\nfrom honeybee.face import Face\nfrom honeybee.boundary import adiabatic_boundary_condition\nfrom honeybee.geometry.face import rectangular_face_by_origin_and_vectors\n\n# Create a rectangular floor with origin at (0, 0, 0), width 10 and depth 5\nfloor_geo = rectangular_face_by_origin_and_vectors((0,0,0), (10,0,0), (0,5,0))\nfloor = Face('Floor', floor_geo, bc=adiabatic_boundary_condition)\n\n# Create a Model from the floor\nmodel = Model('SimpleFloorModel', faces=[floor])\n\nprint(f\"Created Honeybee Model: {model.display_name}\")\nprint(f\"Model as JSON (first 200 chars):\\n{model.to_json()[:200]}...\")","lang":"python","description":"This quickstart demonstrates how to create a basic Honeybee model using the core library components, representing a simple building floor. It highlights the typical import pattern from `honeybee` (honeybee-core) for foundational elements."},"warnings":[{"fix":"Always check the specific sub-package for the symbol you need. E.g., `from honeybee.model import Model` instead of `from lbt_honeybee.model import Model`.","message":"lbt-honeybee is a metapackage. While it installs all necessary components, you generally import classes and functions from the individual sub-packages (e.g., `honeybee`, `honeybee_energy`, `honeybee_radiance`) rather than `lbt_honeybee` directly.","severity":"gotcha","affected_versions":"All 0.x.x versions"},{"fix":"Pin your dependency to a specific version (e.g., `lbt-honeybee==0.9.297`) and review release notes for breaking changes when updating.","message":"The Honeybee Python SDK is currently in a 0.x.x version series, indicating that its API is not yet stable. Breaking changes may occur between minor versions as the project evolves towards 1.0.","severity":"breaking","affected_versions":"All 0.x.x versions"},{"fix":"Refer to the Ladybug Tools documentation for instructions on installing and configuring the necessary simulation engines for your operating system.","message":"For full energy and daylighting simulation capabilities, external simulation engines like EnergyPlus, OpenStudio, and Radiance must be installed and correctly configured on your system. These are not bundled with the Python package.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-17T00:00:00.000Z","next_check":"2026-07-16T00:00:00.000Z","problems":[{"fix":"Import core classes from `honeybee` (e.g., `from honeybee.model import Model`) or specific sub-packages like `honeybee_energy` or `honeybee_radiance`.","cause":"Attempting to import classes directly from the `lbt_honeybee` package, which is a metapackage and does not contain the core classes itself.","error":"ModuleNotFoundError: No module named 'lbt_honeybee.model'"},{"fix":"Install EnergyPlus and ensure its executables are accessible from your system's PATH. Consult the Ladybug Tools installation guide for detailed steps.","cause":"The EnergyPlus simulation engine is not installed or not correctly configured in the system's PATH, preventing energy simulations.","error":"Error: Failed to find energyplus executable"},{"fix":"Ensure you are using the correct `Model` class for your intended operation. For energy-specific tasks, import `from honeybee_energy.model import Model as EnergyModel` and use that instance.","cause":"Confusing `honeybee.model.Model` (core geometry) with `honeybee_energy.model.Model` (energy model). Specific energy-related methods often reside on the `honeybee_energy` model.","error":"AttributeError: 'Model' object has no attribute 'add_zone'"}]}