frads: Framework for Radiance and EnergyPlus Simulation
frads is a Python library for building lighting and energy simulation. It provides high-level abstractions over Radiance and EnergyPlus, automating matrix-based annual daylight simulation workflows and enabling Radiance–EnergyPlus co-simulation.
Features
- Matrix-based daylight simulation — automates 2-phase, 3-phase, and 5-phase Radiance workflows for fast, accurate annual simulations
- EnergyPlus co-simulation — couples Radiance illuminance calculations with EnergyPlus at each timestep via the EnergyPlus Python API
- Complex fenestration systems — creates and manages BSDF glazing systems (electrochromic, venetian blinds, fabric shades) using pyWinCalc
- Dynamic shading control — implements occupancy-based daylight dimming, glare control, and thermal pre-cooling in a single simulation loop
- Sky and weather — parses EPW/WEA files and generates Perez all-weather and CIE sky models
Installation
pip install frads
All dependencies, including Radiance (via pyradiance) and EnergyPlus (via pyenergyplus_lbnl), are installed automatically.
Quick Start
Run a Radiance three-phase annual simulation:
import frads as fr
cfg = fr.WorkflowConfig.from_dict({
"settings": {
"method": "3phase",
"wea_file": "weather.wea",
},
"model": {
"scene": {"files": ["walls.rad", "floor.rad", "ceiling.rad"]},
"windows": {"window1": {"file": "window.rad", "matrix_name": "bsdf1"}},
"materials": {
"files": ["materials.mat"],
"matrices": {"bsdf1": {"matrix_file": "window.xml"}},
},
"sensors": {"workplane": {"file": "grid.txt"}},
},
})
workflow = fr.ThreePhaseMethod(cfg)
workflow.generate_matrices()
illuminance = workflow.calculate_sensor(
sensor="workplane",
bsdf={"window1": "bsdf1"},
time=..., dni=800, dhi=100,
)
Run an EnergyPlus simulation with Radiance daylighting:
import frads as fr
epmodel = fr.load_energyplus_model("office.idf")
epmodel.add_glazing_system(
fr.create_glazing_system("clear", [fr.LayerInput("clear.json")])
)
with fr.EnergyPlusSetup(epmodel, "weather.epw", enable_radiance=True) as eps:
def controller(state):
if not eps.api.exchange.api_data_fully_ready(state):
return
wpi = eps.calculate_wpi(zone="Zone1", cfs_name={"Window1": "clear"})
eps.actuate_lighting_power("Zone1_Lights", (1 - min(wpi.mean() / 500, 1)) * 1000)
eps.set_callback("callback_begin_system_timestep_before_predictor", controller)
eps.run(annual=True)
Documentation
Full documentation, how-to guides, and API reference are at lbnl-eta.github.io/frads.
Citation
Wang, T., Ward, G., and Lee, E.S. (2021). A Python Library for Radiance Matrix-based Simulation Control and EnergyPlus Integration. Proceedings of Building Simulation 2021, IBPSA, Bruges. PDF
License
Framework for Radiance Simulation Control (frads) Copyright (c) 2019, The Regents of the University of California, through Lawrence Berkeley National Laboratory (subject to receipt of any required approvals from the U.S. Dept. of Energy). All rights reserved.
If you have questions about your rights to use or distribute this software, please contact Berkeley Lab's Intellectual Property Office at IPO@lbl.gov.
NOTICE. This Software was developed under funding from the U.S. Department of Energy and the U.S. Government consequently retains certain rights. As such, the U.S. Government has been granted for itself and others acting on its behalf a paid-up, nonexclusive, irrevocable, worldwide license in the Software to reproduce, distribute copies to the public, prepare derivative works, and perform publicly and display publicly, and to permit others to do so.
1 maintainer
Release files for frads 2.1.16
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| frads-2.1.16.tar.gz | 76.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| frads-2.1.16-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 144.9 kB
Release files / frads-2.1.16.tar.gz
| Download URL | frads-2.1.16.tar.gz |
|---|---|
| Size | 76.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
62e25056e3b74b33418ff25ae4293317d69528834903fe8df9b3719c4536fdbd
|
|
BLAKE2b-256 checksum How to use checksums |
4646ee747eaa97e951a0d130a84be8d35c7a87ce71a09d6e20d40852c71ea2d5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / frads-2.1.16-py3-none-any.whl
| Download URL | frads-2.1.16-py3-none-any.whl |
|---|---|
| Size | 68.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8b34eb78553d32c7585120f34ce0c10049590896c5de449bb8836c289f57a840
|
|
BLAKE2b-256 checksum How to use checksums |
b9763cd1c8ab44235d61101877f99a00082a14659f596a48fa6797a250adb46c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
