Skip to main content

Tools to interface with Radiance for the PV researcher

Project description



Main branch: Build Status Coverage Status Documentation Status DOI status

Development branch: Build Status Coverage Status Documentation Status


bifacial_radiance contains a series of Python wrapper functions to make working with RADIANCE easier, particularly for the PV researcher interested in bifacial PV performance. For more information, check out our documentation, Tutorials in the form of Jupyter Notebooks, or reffer to our Wiki and Issues page.

Installation This video shows how to install the bifacial_radiance software and all associated software needed. More info on the Wiki. Instructions are also shown below.

For detailed instructions of how to install bifacial_radiance, you can also refer to the installation guide


A GUI has been added in version 3.0. The GUI reads/writes all input parameters necessary to run a simulation, and runs the specified simulation by calling the correct functions with the specified parameters. So no need to use a journal or a script! But you still need to install following the procedure below.

To run the gui, import bifacial_radiance and run bifacial_radiance.gui()



We have a tutorial video, showing how the program is structured, how to use the Jupyter tutorials and the GUI. You can watch it here Tutorial Webinar, with the slides available here.

Check out the Jupyter Tutorial Notebooks to see detailed examples of the capacities of bifacial_radiance. The Intro examples and the readthedocs documentation also provide a good starting point.


We need your help to make bifacial_radiance a great tool! Please see the Contributing page for more on how you can contribute. The long-term success of bifacial_radiance requires substantial community support.


Bifacial_radiance open source code is copyrighted by the Alliance for Sustainable Energy and licensed with BSD-3-Clause terms, found here.

Getting Support

If you suspect that you may have discovered a bug or if you'd like to change something about bifacial_radiance, then please make an issue on our GitHub issues page.

bifacial_radiance questions can be asked on Stack Overflow and tagged with the bifacial_radiance tag.

The bifacial-radiance google group has just started, and will be used for discussing various topics of interest to the bifacial-radiance community. We also make new version announcements on the google group.


If you use bifacial_radiance in a published work, please cite:

Ayala Pelaez and Deline, (2020). bifacial_radiance: a python package for modeling bifacial solar photovoltaic systems. Journal of Open Source Software, 5(50), 1865,

Please also cite the DOI corresponding to the specific version of bifacial_radiance that you used. bifacial_radiance DOIs are listed at

Additional bifacial_radiance publications with validation of the software include:

Or check our Github Wiki for a complete list of publications.

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

bifacial_radiance-0.4.2.tar.gz (2.0 MB view hashes)

Uploaded source

Built Distribution

bifacial_radiance-0.4.2-py2.py3-none-any.whl (2.0 MB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page