{"id":23856,"library":"honeybee-energy","title":"honeybee-energy","description":"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.","status":"active","version":"1.119.1","language":"python","source_language":"en","source_url":"https://github.com/ladybug-tools/honeybee-energy","tags":["energy simulation","building","honeybee","openstudio","energyplus"],"install":[{"cmd":"pip install honeybee-energy","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Core geometry and data structures","package":"honeybee-core","optional":false},{"reason":"OpenStudio translation for EnergyPlus","package":"honeybee-openstudio","optional":false}],"imports":[{"note":"honeybee-energy uses underscore namespace, not dot.","wrong":"from honeybee.energy.load import EnergyPlusLoad","symbol":"EnergyPlusLoad","correct":"from honeybee_energy.load import EnergyPlusLoad"},{"note":"","wrong":"","symbol":"Construction","correct":"from honeybee_energy.construction import Construction"}],"quickstart":{"code":"from honeybee_energy.material import EnergyWindowMaterialGlazing\nfrom honeybee_energy.construction import WindowConstruction\n\n# Create a simple glazing material\nmat = EnergyWindowMaterialGlazing(\n    'LowE Glass',\n    thickness=0.003,\n    solar_transmittance=0.45,\n    solar_reflectance=0.36,\n    visible_transmittance=0.7,\n    visible_reflectance=0.21,\n    infrared_transmittance=0.0,\n    emissivity=0.84\n)\nprint(mat)\n\n# Create a window construction\nconstr = WindowConstruction('LowE Window', [mat])\nprint(constr)","lang":"python","description":"Create a simple glazing material and window construction."},"warnings":[{"fix":"Replace all 'honeybee.energy' with 'honeybee_energy' in imports.","message":"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.","severity":"breaking","affected_versions":">=1.100.0"},{"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'.","message":"Always pin honeybee-core and honeybee-openstudio versions alongside honeybee-energy. Mismatched versions cause cryptic AttributeErrors.","severity":"gotcha","affected_versions":"all"},{"fix":"Use factory functions or construct objects directly instead of relying on 'honeybee_energy.lib'.","message":"The 'honeybee_energy.lib' module with predefined constructions and materials is deprecated in favor of programmatic creation.","severity":"deprecated","affected_versions":">=1.100.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Change import to 'from honeybee_energy import ...'.","cause":"Using old dot-based import path (e.g., from honeybee.energy import ...). In modern versions (>=1.100.0) the package is honeybee_energy.","error":"ModuleNotFoundError: No module named 'honeybee.energy'"},{"fix":"Use fully qualified imports: 'from honeybee_energy.construction import Construction'.","cause":"Omitting the full submodule path. Use 'from honeybee_energy.construction import Construction' instead of 'from honeybee_energy import construction'.","error":"AttributeError: module 'honeybee_energy' has no attribute 'construction'"},{"fix":"Use 'identifier' instead of 'name' for the first positional argument in honeybee objects.","cause":"Passing 'name' as a keyword argument to certain objects that expect 'identifier' instead. Many honeybee classes use 'identifier' for the unique name.","error":"TypeError: __init__() got an unexpected keyword argument 'name'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}