# bifacial_radiance
Main branch: [](https://github.com/nrel/bifacial_radiance/actions)
[](https://coveralls.io/github/NREL/bifacial_radiance?branch=main)
[](https://bifacial-radiance.readthedocs.io/en/latest/?badge=stable)
[](https://doi.org/10.5281/zenodo.3860350)
[](https://joss.theoj.org/papers/b018890e2ab7ddf723d37b17e308e273)
Development branch: [](https://github.com/nrel/bifacial_radiance/actions)
[](https://coveralls.io/github/NREL/bifacial_radiance?branch=development)
[](https://bifacial-radiance.readthedocs.io/en/latest/?badge=latest)
## 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](https://bifacial-radiance.readthedocs.io),
[Tutorials in the form of Jupyter Notebooks](docs/tutorials/), or reffer to our [Wiki](https://github.com/NREL/bifacial_radiance/wiki)
and [Issues](https://github.com/NREL/bifacial_radiance/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](https://bifacial-radiance.readthedocs.io/en/stable/user_guide/installation.html)
## 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()
## 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](https://www.youtube.com/watch?v=1X9L-R-RVGA), with the [slides available here](https://www.nrel.gov/docs/fy20osti/75218.pdf).
Check out the [Jupyter Tutorial Notebooks](docs/tutorials/) to see detailed examples of the capacities of bifacial_radiance.
The [Intro examples](https://bifacial-radiance.readthedocs.io/en/stable/introexamples.html) and the [readthedocs documentation](https://bifacial-radiance.readthedocs.io) also provide a good starting point.
## Contributing
We need your help to make bifacial_radiance a great tool! Please see the [Contributing page](https://bifacial-radiance.readthedocs.io/en/stable/contributing.html) 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](https://github.com/NREL/bifacial_radiance/blob/master/LICENSE).
## 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](https://github.com/NREL/bifacial_radiance/issues).
bifacial_radiance questions can be asked on
[Stack Overflow](http://stackoverflow.com) and tagged with
the [bifacial_radiance](http://stackoverflow.com/questions/tagged/bifacial_radiance) tag.
The [bifacial-radiance google group](https://groups.google.com/forum/#!forum/bifacial_radiance)
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](https://zenodo.org/search?page=1&size=20&q=conceptrecid:3860349&all_versions&sort=-version)
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](https://github.com/NREL/bifacial_radiance/wiki) for a complete list of publications.
Raw data
{
"_id": null,
"home_page": "https://github.com/NREL/bifacial_radiance",
"name": "bifacial-radiance",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "bifacial radiance photovoltaics pv ray tracing",
"author": "Chris Deline",
"author_email": "chris.deline@nrel.gov",
"download_url": "https://files.pythonhosted.org/packages/04/98/faa156c5cf199bbd0808546e4aef545a05834d65a7dfb20072ea42a56ca6/bifacial_radiance-0.4.4.tar.gz",
"platform": null,
"description": "\n\n# bifacial_radiance\nMain branch: [](https://github.com/nrel/bifacial_radiance/actions)\n[](https://coveralls.io/github/NREL/bifacial_radiance?branch=main)\n[](https://bifacial-radiance.readthedocs.io/en/latest/?badge=stable)\n[](https://doi.org/10.5281/zenodo.3860350)\n[](https://joss.theoj.org/papers/b018890e2ab7ddf723d37b17e308e273)\n\nDevelopment branch: [](https://github.com/nrel/bifacial_radiance/actions)\n[](https://coveralls.io/github/NREL/bifacial_radiance?branch=development)\n[](https://bifacial-radiance.readthedocs.io/en/latest/?badge=latest)\n\n## Introduction\n\nbifacial_radiance contains a series of Python wrapper functions to make working with \nRADIANCE easier, particularly for the PV researcher interested in bifacial PV \nperformance. For more information, check out our [documentation](https://bifacial-radiance.readthedocs.io), \n[Tutorials in the form of Jupyter Notebooks](docs/tutorials/), or reffer to our [Wiki](https://github.com/NREL/bifacial_radiance/wiki)\nand [Issues](https://github.com/NREL/bifacial_radiance/issues) page. \n\n## Installation\n\nhttps://youtu.be/4A9GocfHKyM\nThis video shows how to install the bifacial_radiance software and all associated software needed. More info on the Wiki. Instructions are also shown below.\n\nFor detailed instructions of how to install bifacial_radiance, you can also refer to the [installation guide](https://bifacial-radiance.readthedocs.io/en/stable/user_guide/installation.html)\n\n## GUI! \n\nA 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. \n\nTo run the gui, import bifacial_radiance and run bifacial_radiance.gui()\n\n\n\n\n## Usage\n\nWe 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](https://www.youtube.com/watch?v=1X9L-R-RVGA), with the [slides available here](https://www.nrel.gov/docs/fy20osti/75218.pdf).\n\nCheck out the [Jupyter Tutorial Notebooks](docs/tutorials/) to see detailed examples of the capacities of bifacial_radiance.\nThe [Intro examples](https://bifacial-radiance.readthedocs.io/en/stable/introexamples.html) and the [readthedocs documentation](https://bifacial-radiance.readthedocs.io) also provide a good starting point.\n\n## Contributing\n\nWe need your help to make bifacial_radiance a great tool! Please see the [Contributing page](https://bifacial-radiance.readthedocs.io/en/stable/contributing.html) for more on how you can contribute. The long-term success of bifacial_radiance requires substantial community support.\n\n## License\n\nBifacial_radiance open source code is copyrighted by the Alliance for Sustainable Energy and licensed with BSD-3-Clause terms, found [here](https://github.com/NREL/bifacial_radiance/blob/master/LICENSE).\n\n## Getting Support\n\nIf you suspect that you may have discovered a bug or if you'd like to\nchange something about bifacial_radiance, then please make an issue on our\n[GitHub issues page](https://github.com/NREL/bifacial_radiance/issues).\n\nbifacial_radiance questions can be asked on\n[Stack Overflow](http://stackoverflow.com) and tagged with\nthe [bifacial_radiance](http://stackoverflow.com/questions/tagged/bifacial_radiance) tag.\n\nThe [bifacial-radiance google group](https://groups.google.com/forum/#!forum/bifacial_radiance) \nhas just started, and will be used for discussing various topics of interest to the bifacial-radiance\ncommunity. We also make new version announcements on the google group.\n\n## Citing\n\nIf you use bifacial_radiance in a published work, please cite:\n\n 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\n\n\nPlease also cite the DOI corresponding to the specific version of bifacial_radiance that you used. bifacial_radiance DOIs are listed at [Zenodo.org](https://zenodo.org/search?page=1&size=20&q=conceptrecid:3860349&all_versions&sort=-version)\n\nAdditional bifacial_radiance publications with validation of the software include:\n* 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\n* 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)\n* 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\n\nOr check our [Github Wiki](https://github.com/NREL/bifacial_radiance/wiki) for a complete list of publications.\n",
"bugtrack_url": null,
"license": "BSD License (3 clause)",
"summary": "Tools to interface with Radiance for the PV researcher",
"version": "0.4.4",
"project_urls": {
"Homepage": "https://github.com/NREL/bifacial_radiance"
},
"split_keywords": [
"bifacial",
"radiance",
"photovoltaics",
"pv",
"ray",
"tracing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a06600e8dcee08ce2704ecc48e0fda119eb135b00b542d9c8d13c5b64a543135",
"md5": "b153894cd27f223ca26c7c7d169de49e",
"sha256": "a74c99726332ffcd168472fc517c30246c8a0268bd25e1ebce31fadcaef55ac3"
},
"downloads": -1,
"filename": "bifacial_radiance-0.4.4-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "b153894cd27f223ca26c7c7d169de49e",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 2079932,
"upload_time": "2024-10-14T21:44:41",
"upload_time_iso_8601": "2024-10-14T21:44:41.814667Z",
"url": "https://files.pythonhosted.org/packages/a0/66/00e8dcee08ce2704ecc48e0fda119eb135b00b542d9c8d13c5b64a543135/bifacial_radiance-0.4.4-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0498faa156c5cf199bbd0808546e4aef545a05834d65a7dfb20072ea42a56ca6",
"md5": "1d099ffcea2a4ae7ae97f7ead8d69891",
"sha256": "b105a918b9eeb116327dc423c9da736376c912b2f42c722eb18873bab3582cb5"
},
"downloads": -1,
"filename": "bifacial_radiance-0.4.4.tar.gz",
"has_sig": false,
"md5_digest": "1d099ffcea2a4ae7ae97f7ead8d69891",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 14732161,
"upload_time": "2024-10-14T21:44:44",
"upload_time_iso_8601": "2024-10-14T21:44:44.040011Z",
"url": "https://files.pythonhosted.org/packages/04/98/faa156c5cf199bbd0808546e4aef545a05834d65a7dfb20072ea42a56ca6/bifacial_radiance-0.4.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-14 21:44:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "NREL",
"github_project": "bifacial_radiance",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "docutils",
"specs": [
[
"<",
"0.20"
]
]
},
{
"name": "coverage",
"specs": [
[
"==",
"7.6.1"
]
]
},
{
"name": "cycler",
"specs": [
[
"==",
"0.12.1"
]
]
},
{
"name": "idna",
"specs": [
[
"==",
"3.10"
]
]
},
{
"name": "importlib-metadata",
"specs": [
[
"==",
"8.5.0"
]
]
},
{
"name": "ipython",
"specs": [
[
"==",
"8.13.0"
]
]
},
{
"name": "kiwisolver",
"specs": [
[
"==",
"1.4.7"
]
]
},
{
"name": "matplotlib",
"specs": [
[
"==",
"3.7.5"
]
]
},
{
"name": "more-itertools",
"specs": [
[
"==",
"10.5.0"
]
]
},
{
"name": "numba",
"specs": [
[
"==",
"0.58.1"
]
]
},
{
"name": "numpy",
"specs": [
[
"==",
"1.24.4"
]
]
},
{
"name": "pandas",
"specs": [
[
"==",
"2.0.3"
]
]
},
{
"name": "pluggy",
"specs": [
[
"==",
"1.5.0"
]
]
},
{
"name": "pvlib",
"specs": [
[
"==",
"0.11.0"
]
]
},
{
"name": "pvmismatch",
"specs": [
[
"==",
"4.1"
]
]
},
{
"name": "py",
"specs": [
[
"==",
"1.11.0"
]
]
},
{
"name": "pyparsing",
"specs": [
[
"==",
"3.1.4"
]
]
},
{
"name": "pysmarts",
"specs": [
[
"==",
"0.0.1"
]
]
},
{
"name": "pytest",
"specs": [
[
"==",
"8.3.3"
]
]
},
{
"name": "pytest-cov",
"specs": [
[
"==",
"5.0.0"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
"==",
"2.9.0.post0"
]
]
},
{
"name": "pytz",
"specs": [
[
"==",
"2024.2"
]
]
},
{
"name": "six",
"specs": [
[
"==",
"1.16.0"
]
]
},
{
"name": "sphinx",
"specs": [
[
"==",
"7.1.2"
]
]
},
{
"name": "pydata-sphinx-theme",
"specs": [
[
"==",
"0.14.4"
]
]
},
{
"name": "sphinx-autoapi",
"specs": [
[
"==",
"3.3.2"
]
]
},
{
"name": "sphinx-rtd-theme",
"specs": [
[
"==",
"3.0.1"
]
]
},
{
"name": "requests",
"specs": []
},
{
"name": "future",
"specs": []
}
],
"lcname": "bifacial-radiance"
}
JSON
