honeybee-core

library1.64.44pypypi✓ verified 83d ago

A Python library to create, edit, and analyze 3D building geometry for environmental simulation (energy, daylight, comfort). Current version 1.64.44, released regularly via ladybug-tools ecosystem. Used as the core geometry engine for Honeybee plugins.

devops

pip install honeybee-core

github ↗homepage ↗

INSTALL

IMPORT

SIG · HONEYBEE-CORE

honeybee-core

devopspythonv1.64.44

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

HBModel

✓ from honeybee.model import Model

✗ from honeybee import HBModel

HBModel was renamed to Model in v1.x

Room

✓ from honeybee.room import Room

✗ from honeybee import Room

Room is in submodule honeybee.room

Face

✓ from honeybee.face import Face

✗ from honeybee.boundarycondition import Face

Face is not in boundarycondition

Aperture

✓ from honeybee.aperture import Aperture

✗ from honeybee.door import Aperture

Aperture is a separate object from Door

Creates a simple test room from a box and prints its volume and floor area.

from honeybee.room import Room from honeybee.face import Face from honeybee.aperture import Aperture from ladybug_geometry.geometry3d.pointvector import Point3D room = Room.from_box('TestRoom', 10, 10, 3, 0, Point3D(0, 0, 0)) print(room) print('Volume:', room.volume) print('Floor area:', room.floor_area)

Debug

Known issues

breakingIn v1.40, the top-level honeybee module no longer exports core classes directly. Import from submodules (e.g., honeybee.room, honeybee.face).

fix

Use from honeybee.room import Room instead of from honeybee import Room

affects: >=1.40

deprecatedHBModel class was deprecated in v1.50 and replaced by Model in honeybee.model.

fix

Replace HBModel with Model and import from honeybee.model

affects: >=1.50

gotchaGeometry properties (e.g., volume, area) are computed lazily; if you modify geometry after creation, results may be stale unless you call recalculate() on the object.

fix

Run room.recalculate() after modifying geometry to update derived properties.

affects: all

gotchaWhen assigning boundary conditions, Face objects require that the boundary condition object (e.g., Outdoors) is from honeybee.boundarycondition, not a string.

fix

Use from honeybee.boundarycondition import Outdoors and assign: face.boundary_condition = Outdoors()

affects: all

Errors

Common errors & fixes

AttributeError: module 'honeybee' has no attribute 'Room'

Importing from honeybee directly instead of submodule honeybee.room.

fix

Use: from honeybee.room import Room

ImportError: cannot import name 'HBModel' from 'honeybee'

HBModel was renamed to Model; trying to import deprecated name.

fix

Use: from honeybee.model import Model

TypeError: 'Face' object is not callable

Using constructor incorrectly or missing arguments (e.g., Face() without geometry).

fix

Import Face and pass geometry: Face(geometry, boundary_condition=Outdoors())

Upgrade

Version history

1.64.44latest on PyPI · released Jun 4, 2026

Audit

Dependencies

ladybug-geometryrequiredRequired for core geometric operations

ladybug-rhinooptionalRequired only for Rhino geometry conversion

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/ladybug-tools/honeybee-core ↗

homepagehttps://github.com/ladybug-tools/honeybee-core ↗