/pvlib-python

A set of documented functions for simulating the performance of photovoltaic energy systems.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

TravisCI Coverage Status codecov Documentation Status DOI status Code Quality: Python Total Alerts

pvlib python is a community supported tool that provides a set of functions and classes for simulating the performance of photovoltaic energy systems. pvlib python was originally ported from the PVLIB MATLAB toolbox developed at Sandia National Laboratories and it implements many of the models and methods developed at the Labs. More information on Sandia Labs PV performance modeling programs can be found at https://pvpmc.sandia.gov/. We collaborate with the PVLIB MATLAB project, but operate independently of it.

Documentation

Full documentation can be found at readthedocs.

Installation

pvlib-python releases may be installed using the pip and conda tools. Please see the Installation page of the documentation for complete instructions.

pvlib-python is compatible with Python 3.5 and above.

Python 2.7 support ended on June 1, 2019, with pvlib-python 0.6.3.

Contributing

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

License

BSD 3-clause

Getting support

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

The pvlib-python google group is used for discussing various topics of interest to the pvlib-python community. We also make new version announcements on the google group.

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

Citing

If you use pvlib-python in a published work, please cite:

William F. Holmgren, Clifford W. Hansen, and Mark A. Mikofski. "pvlib python: a python package for modeling solar energy systems." Journal of Open Source Software, 3(29), 884, (2018). https://doi.org/10.21105/joss.00884

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