https://github.com/NREL/bifacialvf

Bifacial PV View Factor model for system performance calculation
https://github.com/NREL/bifacialvf

Last synced: 3 months ago
JSON representation

Bifacial PV View Factor model for system performance calculation

• Host: GitHub
• URL: https://github.com/NREL/bifacialvf
• Owner: NREL
• License: other
• Created: 2017-12-13T19:23:14.000Z (almost 7 years ago)
• Default Branch: main
• Last Pushed: 2024-05-03T19:57:07.000Z (6 months ago)
• Last Synced: 2024-06-11T17:39:31.378Z (5 months ago)
• Language: Python
• Homepage: https://bifacialvf.readthedocs.io
• Size: 39 MB
• Stars: 29
• Watchers: 8
• Forks: 17
• Open Issues: 16
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• open-sustainable-technology - bifacialvf - Bifacial PV View Factor model for system performance calculation. (Renewable Energy / Photovoltaics and Solar Energy)

README

        
![logo](docs/images_wiki/bifacialVF.png)

# Bifacial PV View Factor model

[![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)

[![Build Status](https://travis-ci.org/NREL/bifacialvf.svg?branch=main)](https://travis-ci.org/NREL/bifacialvf)

[![DOI](https://zenodo.org/badge/114160149.svg)](https://zenodo.org/badge/latestdoi/114160149)

keywords: python, configuration factor model, electrical model mismatch for bifacial modules.

## Introduction

bifacialvf is a self-contained view factor (or configuration factor) model which

replicates a 5-row PV system of infinite extent perpendicular to the module

rows. The function returns the irradiance profile along the middle (interior)

row by default, but user interface options include `'first'`, `'interior'`,

`'last'`, and `'single'`. Single-axis tracking is supported, and hourly output

files based on TMY inputs are saved. Spatial nonuniformity is reported, with

multiple rear-facing irradiances collected on the back of each module row.

Bilinear interpolation code add-on to bifacialvf (description below) to pre-generate IV arrays and bifacial coefficients, and to examine the energy production with back side irradiance mismatch for either a portrait or landscape module.   

Included are IV curves and bifacial info for a Yingli (standard) module. 

## Pre-requisites

This software is written for Python 2 or 3. NREL recommends [Anaconda Python](https://www.anaconda.com/download/).

## Install using pip

[bifacialvf](https://pypi.org/project/bifacialvf/) is at the Python Package Index (PyPI). Use pip to install the latest release in your conda environment or virtualenv:

    (myenv)$ pip install bifacialvf

### Install development mode from GitHub

For those interested in contributing to bifacialvf:

1. Clone the bifacialvf repository: `$ git clone https://github.com/NREL/bifacialvf.git bifacialvf-main`

2. Navigate to the repository directory where `setup.py` is located: `$ cd bifacialvf-main`

3. Install via pip in development mode: `$ pip install -e .`

## Usage

For usage examples, see the Jupyter notebooks in \docs\

## License

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

## Citing bifacialVF

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

    Marion, B., MacAlpine, S., Deline, C., Asgharzadeh, A., Toor, F., Riley, D., … Hansen, C. (2017). A Practical Irradiance Model for Bifacial PV Modules: Preprint. In 44th IEEE Photovoltaic Specialists Conference. Washington, DC. https://www.nrel.gov/docs/fy17osti/67847.pdf. NREL/CP-5J00-67847

Please also cite the DOI corresponding to the specific version of bifacialVF that you used. bifacialvf DOIs are listed at [Zenodo.org](https://zenodo.org/search?page=1&size=20&q=conceptrecid:6369162&all_versions&sort=-version). 

    Silvana Ovaitt, Chris Deline, Mark Mikofski, & Nick DiOrio. (2022). NREL/bifacialvf: v0.1.8 Release (v0.1.8). Zenodo. https://doi.org/10.5281/zenodo.6369162

Bilinear Interpolation based on the publications:

    De Soto, W., Klein, S. A., & Beckman, W. A. (2006). Improvement and validation of a model for photovoltaic array performance. Solar Energy, 80(1), 78–88. https://doi.org/10.1016/j.solener.2005.06.010

    Marion, B., Rummel, S., & Anderberg, A. (2004). Current--voltage curve translation by bilinear interpolation. Progress in Photovoltaics: Research and Applications, 12(8), 593–607.

bifacialvf: Original code by Bill Marion, Python translation by Silvana Ayala, Updates by Chris Deline & team

Original bilinear interpolation code by Sara MacAlpine, Python translation & Updates by Silvana Ayala

PVMismatch add-on: PVmismatch code from [PVMismatch](https://github.com/SUNPower/PVMismatch), by Sunpower