honeybee-energy

1.119.1 verified Fri May 01 auth: no python

Energy simulation library for the honeybee ecosystem. Provides classes for energy simulation setups, constructions, loads, materials, schedules, and OpenStudio translations. Version 1.119.1 released April 2026, with weekly bugfix releases.

pip install honeybee-energy

Common errors

error ModuleNotFoundError: No module named 'honeybee.energy' ↓

cause Using old dot-based import path (e.g., from honeybee.energy import ...). In modern versions (>=1.100.0) the package is honeybee_energy.

fix

Change import to 'from honeybee_energy import ...'.

error AttributeError: module 'honeybee_energy' has no attribute 'construction' ↓

cause Omitting the full submodule path. Use 'from honeybee_energy.construction import Construction' instead of 'from honeybee_energy import construction'.

fix

Use fully qualified imports: 'from honeybee_energy.construction import Construction'.

error TypeError: __init__() got an unexpected keyword argument 'name' ↓

cause Passing 'name' as a keyword argument to certain objects that expect 'identifier' instead. Many honeybee classes use 'identifier' for the unique name.

fix

Use 'identifier' instead of 'name' for the first positional argument in honeybee objects.

Warnings

breaking In honeybee-energy >=1.100.0, the import paths changed from dot (honeybee.energy) to underscore (honeybee_energy). Old code using 'from honeybee.energy import ...' will break. ↓

fix Replace all 'honeybee.energy' with 'honeybee_energy' in imports.

gotcha Always pin honeybee-core and honeybee-openstudio versions alongside honeybee-energy. Mismatched versions cause cryptic AttributeErrors. ↓

fix Install using pip with version constraints, e.g., pip install 'honeybee-energy>=1.119,<1.120' 'honeybee-core>=1.64,<1.65' 'honeybee-openstudio>=0.4,<0.5'.

deprecated The 'honeybee_energy.lib' module with predefined constructions and materials is deprecated in favor of programmatic creation. ↓

fix Use factory functions or construct objects directly instead of relying on 'honeybee_energy.lib'.

Imports

EnergyPlusLoad

wrong

from honeybee.energy.load import EnergyPlusLoad

correct

from honeybee_energy.load import EnergyPlusLoad

honeybee-energy uses underscore namespace, not dot.

Construction

from honeybee_energy.construction import Construction

Quickstart

Create a simple glazing material and window construction.

from honeybee_energy.material import EnergyWindowMaterialGlazing
from honeybee_energy.construction import WindowConstruction

# Create a simple glazing material
mat = EnergyWindowMaterialGlazing(
    'LowE Glass',
    thickness=0.003,
    solar_transmittance=0.45,
    solar_reflectance=0.36,
    visible_transmittance=0.7,
    visible_reflectance=0.21,
    infrared_transmittance=0.0,
    emissivity=0.84
)
print(mat)

# Create a window construction
constr = WindowConstruction('LowE Window', [mat])
print(constr)