{ "info": { "author": "Chris Deline", "author_email": "chris.deline@nrel.gov", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Science/Research", "License :: OSI Approved :: BSD License", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.6" ], "description": "[![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)\n[![Build Status](https://travis-ci.org/NREL/bifacialvf.svg?branch=master)](https://travis-ci.org/NREL/bifacialvf)\n\n# bifacialvf - Bifacial PV View Factor model\npython, configuration factor model\n\nOriginal code by Bill Marion\nPython translation by Silvana Ayala\nUpdates by Chris Deline\n\nBased on the publication: \"A Practical Irradiance Model for Bifacial PV Modules\"\nB. Marion, S. MacAlpine, C. Deline, A. Asgharzadeh, F. Toor, D. Riley, J. Stein, C. Hansen\n2017 IEEE Photovoltaic Specialists Conference, Washington DC, 2017\nURL: https://www.nrel.gov/docs/fy17osti/67847.pdf\n\n## Introduction\n\nbifacialvf is a self-contained view factor (or configuration factor) model which\nreplicates a 5-row PV system of infinite extent perpendicular to the module\nrows. The function returns the irradiance profile along the middle (interior)\nrow by default, but user interface options include `'first'`, `'interior'`,\n`'last'`, and `'single'`. Single-axis tracking is supported, and hourly output\nfiles based on TMY inputs are saved. Spatial nonuniformity is reported, with\nmultiple rear-facing irradiances collected on the back of each module row.\n\n## Pre-requisites\nThis software is written for Python 2 or 3. NREL recommends [Anaconda Python](https://www.anaconda.com/download/).\n\n## Install using pip\n[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:\n\n (myenv)$ pip install bifacialvf\n\n### Install development mode from GitHub\nFor those interested in contributing to bifacialvf:\n\n1. Clone the bifacialvf repository: `$ git clone https://github.com/NREL/bifacialvf.git bifacialvf-master`\n2. Navigate to the repository directory where `setup.py` is located: `$ cd bifacialvf-master`\n3. Install via pip in development mode: `$ pip install -e .`\n\n## Usage\n\n import bifacialvf\n\n bifacialvf.simulate(inputTMY, outputfile, tilt, azm, clearance, rowspacing)\n (data, metadata) = bifacialvf.loadVFresults(outputfile)\n\nFor more usage examples, see the Jupyter notebooks in \\docs\\\n\n## Prerequisites\n\n* [NumPy](https://www.numpy.org/)\n* [pvlib python](https://pvlib-python.readthedocs.io/en/stable/)\n\n\n## Main Functions\n\n bifacialvf.simulate(\n TMYtoread, writefiletitle, beta, sazm, C=1, D=0.5,\n rowType = 'interior', transFactor=0.01, cellRows=6,\n PVfrontSurface='glass', PVbackSurface='glass', albedo=0.62,\n tracking=False, backtrack=False, r2r=1.5, Cv=0.05, offset=0)\n\nThis is the main runfile. Hourly TMY3 inputs are read, and an outputfile is saved with\na number of irradiance points along the module chord specified by `cellRows`.\n\n\n loadVFresults.loadVFresults(filename=None)\n\nread in saved file from `bifacialvf.simulate`. If no filename is passed, a tkinter GUI opens for file selection\n\n## Subroutines\n\n`sun.py`: \nSolar position and irradiance-related helper files including\n`hrSolarPos`, `perezComp`, `solarPos`, and `sunIncident`\n\n`vf.py`:\nView Factor helper files to help with configuration-factor calculation\n1-axis tracking and self-shading calculation.\nSubroutines include:\n`getBackSurfaceIrradiances`, `getFrontSurfaceIrradiances`, `getGroundShadeFactors`,\n`getSkyConfigurationFactors`, `trackingBFvaluescalculator`, `rowSpacing`\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/NREL/bifacialvf", "keywords": "bifacial view factor photovoltaics pv", "license": "BSD", "maintainer": "", "maintainer_email": "", "name": "bifacialvf", "package_url": "https://pypi.org/project/bifacialvf/", "platform": "", "project_url": "https://pypi.org/project/bifacialvf/", "project_urls": { "Homepage": "https://github.com/NREL/bifacialvf" }, "release_url": "https://pypi.org/project/bifacialvf/0.1.7/", "requires_dist": [ "numpy", "pvlib (>=0.5.0)" ], "requires_python": "", "summary": "Bifacial PV system evaluation using view factor method", "version": "0.1.7" }, "last_serial": 5493631, "releases": { "0.1.5": [ { "comment_text": "", "digests": { "md5": "5e701ef2ddeb452db43551e6afbad7af", "sha256": "ac3b1827da0e4bcd2784bd58b937d78020ecf92425a5fc06ee22dfbfc50e7863" }, "downloads": -1, "filename": "bifacialvf-0.1.5.tar.gz", "has_sig": false, "md5_digest": "5e701ef2ddeb452db43551e6afbad7af", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29537, "upload_time": "2018-03-09T22:12:04", "url": "https://files.pythonhosted.org/packages/9e/97/92943d68fd7dbe77c3be67eb5da1177b8dec014c2a98b46246217cf6c995/bifacialvf-0.1.5.tar.gz" } ], "0.1.6": [ { "comment_text": "", "digests": { "md5": "8ffde8c28b1eb9cbd9c1f8526c6dc888", "sha256": "a92a86275653768f49ac7248eb6107f455597cda5d6bcc6cd55007eef0a8058f" }, "downloads": -1, "filename": "bifacialvf-0.1.6.tar.gz", "has_sig": false, "md5_digest": "8ffde8c28b1eb9cbd9c1f8526c6dc888", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 31664, "upload_time": "2018-04-08T05:24:14", "url": "https://files.pythonhosted.org/packages/ec/54/07a1a5f05f93d7f7a87f794842e7e06fdd03036aae840757c04a2f26d2d4/bifacialvf-0.1.6.tar.gz" } ], "0.1.7": [ { "comment_text": "", "digests": { "md5": "f1f731d6ac5db3f31cbd245dd256ab2f", "sha256": "b5442fab8e142f845845d01faa5b1f7f74e404b943cc861d4a4431ad7f7641c0" }, "downloads": -1, "filename": "bifacialvf-0.1.7-py3-none-any.whl", "has_sig": false, "md5_digest": "f1f731d6ac5db3f31cbd245dd256ab2f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 957063, "upload_time": "2019-07-06T00:53:54", "url": "https://files.pythonhosted.org/packages/55/cf/4194d4be9d472acf7e52ecf2dee396dc03a52a624e14c7f2941d3f166c2c/bifacialvf-0.1.7-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f48833113e6c150bb644902818f8a7d8", "sha256": "274bf5226e44a7863806530f6849dc1dfa9bac68c7947c1bd40bffdd8ee8feb9" }, "downloads": -1, "filename": "bifacialvf-0.1.7.tar.gz", "has_sig": false, "md5_digest": "f48833113e6c150bb644902818f8a7d8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 34798, "upload_time": "2019-07-06T00:53:56", "url": "https://files.pythonhosted.org/packages/90/87/3e1b219561c78d81fe10292fa3e6490f99af9d22cf76666da1fc1cf459f4/bifacialvf-0.1.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "f1f731d6ac5db3f31cbd245dd256ab2f", "sha256": "b5442fab8e142f845845d01faa5b1f7f74e404b943cc861d4a4431ad7f7641c0" }, "downloads": -1, "filename": "bifacialvf-0.1.7-py3-none-any.whl", "has_sig": false, "md5_digest": "f1f731d6ac5db3f31cbd245dd256ab2f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 957063, "upload_time": "2019-07-06T00:53:54", "url": "https://files.pythonhosted.org/packages/55/cf/4194d4be9d472acf7e52ecf2dee396dc03a52a624e14c7f2941d3f166c2c/bifacialvf-0.1.7-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f48833113e6c150bb644902818f8a7d8", "sha256": "274bf5226e44a7863806530f6849dc1dfa9bac68c7947c1bd40bffdd8ee8feb9" }, "downloads": -1, "filename": "bifacialvf-0.1.7.tar.gz", "has_sig": false, "md5_digest": "f48833113e6c150bb644902818f8a7d8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 34798, "upload_time": "2019-07-06T00:53:56", "url": "https://files.pythonhosted.org/packages/90/87/3e1b219561c78d81fe10292fa3e6490f99af9d22cf76666da1fc1cf459f4/bifacialvf-0.1.7.tar.gz" } ] }