Skip to main content

Framework for lighting and energy simulations

Project description

Install + Test Upload Python Package Downloads

frads: Framework for lighting and energy simulation

This is the repository for frads development. frads faciliates lighting and energy simulation by calling Radiance and EnergyPlus within the Python environment. Radiance is a free and open-source, raytracing-based lighting engine that is used extensively by engineering firms for innovative solar control, lighting, and daylighting design to improve the energy efficiency of buildings. With matrix algebraic methods, climate-based annual simulations can now be conducted in less than two minutes. frads automates setup of these simulations by providing end users with an open-source, high-level abstraction of the Radiance command-line workflow (Unix toolbox model), helping to reduce the steep learning curve and associated user errors. frads also provides the necessary infrastructure needed for seamless integration of Radiance and other modeling tools, such as EnergyPlus.

Documentation

Contact/ Support

We welcome beta users of frads. Feel free to post questions and suggestions in the Discussion section of this GitHub site or contact the principal author at taoningwang@lbl.gov. Information about Radiance can be found at: https://www.radiance-online.org . The Radiance community is active and welcomes new users via the Radiance Discourse site or Unmet Hours.

Testing

frads uses Radiance tools in its implementation. Radiance models have been rigorously tested and validated using laboratory and outdoor field data, demonstrating its superior performance in delivering photometrically accurate, photorealistic results. Each Radiance commit and release is tested using the GitHub Action system. Unit tests were developed for most of the major Radiance programs. Tests are performed using Radiance radcompare, which was designed specifically to test Monte Carlo ray-tracing algorithms. Integration tests are the main type of test performed for frads commit and releases. These tests also use the GitHub Action system.

Releases

frads is a work in progress (see to-do list below). frads has been tested on the latest official release of Radiance (September 2020, v5.3) but may not have been tested on the latest HEAD release, which contains source code changes made as recently as yesterday. frads has also been tested on the latest official EnergyPlus release (> v9.3).

Installation

Before you can use frads, you need to install it.

Install Python

Being a Python based library, you'll need to install Python first. Python version 3.8 or newer is required for frads.

Get the latest version of Python at https://www.python.org/downloads/ or with your operating system’s package manager.

You can verify that Python is installed by typing python from your cmd/powershell/terminal; you should see something like:

$ python
Python 3.X.X
[GCC 4.x] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>

After you have Python installed, you should have pip command available in your shell environment as well. You can then use pip to install frads:

Install frads

After you have pyenergyplus installed, you can then use pip to install frads:

$ python -m pip install frads

Verifying

To verify that frads can be seen by Python, type python from your shell. Then at the Python prompt, try to import frads

>>> import frads
>>> print(frads.__version__)
1.0.0

Reference

Wang, T., "Frads: A Python Library for Radiance Simulation Control", 2021 Radiance workshop, Bilbao, Spain, August 19, 2021, ppt , voice recording

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, International Building Performance Simulation Association, Bruges, September 1-3, 2021. Publication to be posted: pdf

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

frads-2.1.8.tar.gz (71.3 kB view details)

Uploaded Source

Built Distribution

frads-2.1.8-py3-none-any.whl (64.2 kB view details)

Uploaded Python 3

File details

Details for the file frads-2.1.8.tar.gz.

File metadata

  • Download URL: frads-2.1.8.tar.gz
  • Upload date:
  • Size: 71.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.23

File hashes

Hashes for frads-2.1.8.tar.gz
Algorithm Hash digest
SHA256 536cd9081ffce233f5257f9926351fd2db058ca9cdca080d341ec17cfef3724e
MD5 625963a792a4b410f57191335deed4fc
BLAKE2b-256 268c6541696842cb25fba52c4c3b1be8191d03bb58bc4c493f57c88117c3834d

See more details on using hashes here.

File details

Details for the file frads-2.1.8-py3-none-any.whl.

File metadata

  • Download URL: frads-2.1.8-py3-none-any.whl
  • Upload date:
  • Size: 64.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.23

File hashes

Hashes for frads-2.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 dc4eca32478e03922c3dcc6681f77a2b0b940ffa00c70cd7ce4a20be9fd786cb
MD5 00b782ef34de4fa593d59d50c6818235
BLAKE2b-256 f0b93d44917383a7e83b187d3a44401b187312684641652ee7f1544c03795dac

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page