bifacial_radiance

Toolkit for working with RADIANCE for the ray-trace modeling of Bifacial Photovoltaics.
https://github.com/NREL/bifacial_radiance

Category: Renewable Energy
Sub Category: Photovoltaics and Solar Energy

Keywords

bifacial gui photovoltaics radiance renewable-energy renewables

Keywords from Contributors

solar-energy photovoltaic reliability transforms measur archiving recycle projection animals conversion

Last synced: about 5 hours ago
JSON representation

Repository metadata

Toolkit for working with RADIANCE for the ray-trace modeling of Bifacial Photovoltaics

Host: GitHub
URL: https://github.com/NREL/bifacial_radiance
Owner: NREL
License: bsd-3-clause
Created: 2017-12-13T17:56:18.000Z (over 7 years ago)
Default Branch: main
Last Pushed: 2025-02-14T16:21:14.000Z (2 months ago)
Last Synced: 2025-04-22T07:45:01.648Z (5 days ago)
Topics: bifacial, gui, photovoltaics, radiance, renewable-energy, renewables
Language: Python
Homepage: https://bifacial-radiance.readthedocs.io
Size: 81.8 MB
Stars: 97
Watchers: 17
Forks: 55
Open Issues: 83
Releases: 26
Metadata Files:
- Readme: README.md
- License: LICENSE

bifacial_radiance

Main branch:

Development branch:

Introduction

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

https://youtu.be/4A9GocfHKyM
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

GUI!

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()

GUI

Usage

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.

Contributing

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.

License

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.

Citing

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, https://doi.org/10.21105/joss.01865

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

Additional bifacial_radiance publications with validation of the software include:

Deline, Chris, and Ayala, Silvana. Bifacial_Radiance. Computer Software. https://github.com/NREL/bifacial_radiance. USDOE Office of Energy Efficiency and Renewable Energy (EERE), Solar Energy Technologies Office (EE-4S). 17 Dec. 2017. Web. doi:10.11578/dc.20180530.16. https://www.osti.gov/doecode/biblio/6869
Ayala Pelaez S, Deline C, Greenberg P, Stein JS, Kostuk RK. Model and validation of single-axis tracking with bifacial PV. IEEE J Photovoltaics. 2019;9(3):715-721. https://ieeexplore.ieee.org/document/8644027 and https://www.nrel.gov/docs/fy19osti/72039.pdf (pre-print, conference version)
Ayala Pelaez, Deline C, MacAlpine M, Marion B, Stein J, Kostuk K. Comparison of Bifacial Solar Irradiance Model Predictions with Field Validation. IEEE J Photovoltaics. 2019; 9(1):82-87. https://ieeexplore.ieee.org/document/8534404

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

Owner metadata

Name: National Renewable Energy Laboratory
Login: NREL
Email:
Kind: organization
Description:
Website: http://www.nrel.gov
Location: Golden, CO
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/1906800?v=4
Repositories: 599
Last ynced at: 2024-12-18T09:41:07.898Z
Profile URL: https://github.com/NREL

GitHub Events

Total

Issues event: 7
Watch event: 7
Issue comment event: 7
Push event: 1
Pull request event: 1
Fork event: 8
Create event: 1

Last Year

Issues event: 7
Watch event: 7
Issue comment event: 7
Push event: 1
Pull request event: 1
Fork event: 8
Create event: 1

Committers metadata

Last synced: 5 days ago

Total Commits: 1,431
Total Committers: 16
Avg Commits per committer: 89.438
Development Distribution Score (DDS): 0.448

Commits in past year: 97
Committers in past year: 4
Avg Commits per committer in past year: 24.25
Development Distribution Score (DDS) in past year: 0.093

Name	Email	Commits
cdeline	c**e@n**v	790
Silvana Ayala	s**a@n**v	410
Ayala	s**a@n**v	131
Arefeen	s**n@n**v	32
Kevin Anderson	k**n@n**v	21
Brown	m**2@n**v	13
Jason Alderman	a**n@g**m	9
Mark Mikofski	b**o@y**m	8
mcbrown042	7****2	3
echedey-ls	8****s	3
dependabot[bot]	4****]	3
Matt Prilliman	M**n@n**v	3
M B	8****t	2
Mandy Lewis	a**0@u**a	1
Kirsten Perry	7****l	1
Cameron Stark	C****k	1

Committer domains:

nrel.gov: 7
uottawa.ca: 1

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 390
Total pull requests: 192
Average time to close issues: 5 months
Average time to close pull requests: 15 days
Total issue authors: 93
Total pull request authors: 16
Average comments per issue: 2.12
Average comments per pull request: 1.35
Merged pull request: 161
Bot issues: 0
Bot pull requests: 5

Past year issues: 35
Past year pull requests: 36
Past year average time to close issues: 18 days
Past year average time to close pull requests: 10 days
Past year issue authors: 9
Past year pull request authors: 4
Past year average comments per issue: 1.43
Past year average comments per pull request: 0.78
Past year merged pull request: 31
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/NREL/bifacial_radiance

Top Issue Authors

shirubana (144)
cdeline (77)
mikofski (7)
dalonsoa (7)
wholmgren (5)
Leo-Raumann (5)
dvalencia00 (5)
VENKATESHYARAMACHA (5)
ECSape (4)
olipfeifferthkoeln (4)
DS-Sagar (4)
StainesThomas (3)
lherrero01 (3)
mcbrown042 (3)
AgravatSM (3)

Top Pull Request Authors

cdeline (115)
shirubana (42)
kandersolar (7)
jalderman9 (5)
dependabot[bot] (5)
mikofski (5)
m-bartlett (2)
mjprilliman (2)
kperrynrel (2)
amir-asgharzadeh (1)
CameronTStark (1)
sofiatoropovaa (1)
echedey-ls (1)
jsstein (1)
mandylewis (1)

Top Issue Labels

Wishlists (33)
bug (31)
Fixed in development branch (29)
enhancement (27)
v0_5_0 (26)
v0_3_5 (26)
v0_3_4 (18)
v0_6_0 (11)
JOSS (9)
v0_3_3 (8)
HPC (6)
v0_4_1 (6)
gencumsky (5)
linux (5)
question (4)
v_0_4_2 (4)
geometry (2)
error message improvement (2)
help wanted (1)
dependencies (1)
Pvlib (1)
documentation (1)
wontfix (1)
contribution (1)
tutorial bug (1)

Top Pull Request Labels

Fixed in development branch (8)
dependencies (5)
v0_3_5 (2)
tutorial bug (1)

Package metadata

Total packages: 1
Total downloads:
- pypi: 1,092 last-month
Total dependent packages: 1
Total dependent repositories: 1
Total versions: 15
Total maintainers: 1

pypi.org: bifacial-radiance

Tools to interface with Radiance for the PV researcher

Homepage: https://github.com/NREL/bifacial_radiance
Documentation: https://bifacial-radiance.readthedocs.io/
Licenses: BSD License (3 clause)
Latest release: 0.4.4 (published 6 months ago)
Last Synced: 2025-04-26T13:36:29.946Z (1 day ago)
Versions: 15
Dependent Packages: 1
Dependent Repositories: 1
Downloads: 1,092 Last month
Rankings:
- Dependent packages count: 3.244%
- Forks count: 6.058%
- Stargazers count: 8.186%
- Average: 10.602%
- Downloads: 13.436%
- Dependent repos count: 22.088%
Maintainers (1)
- cdeline

Dependencies

requirements.txt pypi

coverage ==6.3.1
cycler ==0.11.0
docutils <0.18
future *
idna ==3.3
importlib-metadata ==4.10.1
ipython ==7.31.1
kiwisolver ==1.3.2
matplotlib ==3.5.1
more-itertools ==8.12.0
numpy ==1.21.5
pandas ==1.3.5
pluggy ==1.0.0
pvlib ==0.9.0
pvmismatch ==4.1
py ==1.11.0
pyparsing ==3.0.7
pysmarts ==0.0.1
pytest ==7.0.0
pytest-cov ==3.0.0
python-dateutil ==2.8.2
pytz ==2021.3
requests *
six ==1.16.0
sphinx-autoapi ==1.8.4
sphinx-rtd-theme ==1.0.0

setup.py pypi

configparser *
pandas *
pvlib *
pvmismatch *
requests *

.github/workflows/deploy.yaml actions

actions/checkout v2 composite
actions/setup-python v2 composite
actions/upload-artifact v2 composite

.github/workflows/docker.yml actions

actions/checkout v2 composite
docker/build-push-action v2 composite
docker/login-action v1 composite
docker/setup-buildx-action v1 composite

.github/workflows/pytest.yaml actions

GabrielBB/xvfb-action v1 composite
actions/checkout v2 composite
actions/setup-python v2 composite

docker/Dockerfile docker

python 3.7.8-buster build

Score: 14.964055215380593

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

bifacial_radiance

Keywords

Keywords from Contributors

Repository metadata

README.md

bifacial_radiance

Introduction

Installation

GUI!

Usage

Contributing

License

Getting Support

Citing

Owner metadata

GitHub Events

Total

Last Year

Committers metadata

Committer domains:

Issue and Pull Request metadata

Top Issue Authors

Top Pull Request Authors

Top Issue Labels

Top Pull Request Labels

Package metadata

pypi.org: bifacial-radiance

Dependencies