honeybee-radiance-folder

Honeybee Radiance Folder is a Python library to read, write and validate the Radiance folder structure.

Installation

pip install -U honeybee-radiance-folder

API Documentation

Usage

# create a Radiance Model folder
import os
from honeybee_radiance_folder import ModelFolder

rf = 'c:/ladybug/sample_folder'
folder = ModelFolder(rf)
folder.write(overwrite=True)

# check the folders and files created in model folder
for f in os.listdir(folder.model_folder(full=True)):
    print(f)

aperture
folder.cfg
grid
scene

# load a Radiance folder

# in this case we are loading the folder from sample folder in radiance folder repository
# you can download it from here
# https://github.com/ladybug-tools/radiance-folder-structure/tree/master/project_folder
from honeybee_radiance_folder import ModelFolder

radiance_folder = r'./tests/assets/project_folder'
folder = ModelFolder(radiance_folder)

# get input files for scene
for f in folder.scene_files(black_out=False, rel_path=True):
    print(f)

model/scene/context.mat
model/scene/context.rad
model/scene/partition.mat
model/scene/partition.rad
model/scene/partition_glass.mat
model/scene/partition_glass.rad
model/scene/room_envelope.mat
model/scene/room_envelope.rad

# and apertures
for f in folder.aperture_files(black_out=False, rel_path=True):
    print(f)

model\aperture\aperture.mat
model\aperture\aperture.rad

# and finally get aperture groups - south window in this case
# and check each state
for count, ap in enumerate(folder.aperture_groups(interior=False)):
    print('Aperture group %d: %s' % (count + 1, ap.identifier))
    for state in ap.states:
        print('- %s: %s' % (state.identifier, state.default))

Aperture group 1: south_window
- 0_clear: south_window..default..000.rad
- 1_diffuse: south_window..default..001.rad

Release files for honeybee-radiance-folder 2.11.17

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for honeybee-radiance-folder 2.11.17
File	Size	Uploaded
honeybee_radiance_folder-2.11.17.tar.gz	21.3 kB	Jan 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for honeybee-radiance-folder 2.11.17
File	Interpreter	ABI	Platform	Reset
honeybee_radiance_folder-2.11.17-py3-none-any.whl 22.0 kB Jan 13, 2026	Python 3	none	any	Details

Total release size:43.2 kB

Release files / honeybee_radiance_folder-2.11.17.tar.gz

Download URL	honeybee_radiance_folder-2.11.17.tar.gz
Size	21.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`cc009e91c7b8deeac5f04a65b6b26599d51e9443b8eb0b4b76d7bb8b72ce5542`
BLAKE2b-256 checksum How to use checksums	`cc3ef495c28e376e0f37750b605f9d5cadb347f9c0fdc97147ed4679a87d2a73`
Upload date	Jan 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.12`

Release files / honeybee_radiance_folder-2.11.17-py3-none-any.whl

Download URL	honeybee_radiance_folder-2.11.17-py3-none-any.whl
Size	22.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4e3583247f12059f3914d3dc36506d21188c7d0feb4046b2a4c40a6df8538454`
BLAKE2b-256 checksum How to use checksums	`818ef9e0978118b41913b5108b6d9bb0bf20c9a694d26d706db3f432f6515bd9`
Upload date	Jan 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.12`