rdtools

An open source library to support reproducible technical analysis of time series data from photovoltaic energy systems.
https://github.com/nrel/rdtools

Last synced: about 16 hours ago
JSON representation

Repository metadata

PV Analysis Tools in Python

• Host: GitHub
• URL: https://github.com/nrel/rdtools
• Owner: NREL
• License: mit
• Created: 2016-11-18T22:17:01.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-05-01T14:11:20.000Z (10 days ago)
• Last Synced: 2024-05-10T06:04:04.939Z (2 days ago)
• Language: Python
• Homepage: https://rdtools.readthedocs.io/
• Size: 64.2 MB
• Stars: 141
• Watchers: 28
• Forks: 60
• Open Issues: 58
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

README

        


Master branch:

[![Build Status](https://github.com/NREL/rdtools/workflows/pytest/badge.svg?branch=master)](https://github.com/NREL/rdtools/actions?query=branch%3Amaster)

Development branch:

[![Build Status](https://github.com/NREL/rdtools/workflows/pytest/badge.svg?branch=development)](https://github.com/NREL/rdtools/actions?query=branch%3Adevelopment)

Code coverage:

[![codecov](https://codecov.io/gh/NREL/rdtools/graph/badge.svg?token=K2HDjFkBws)](https://codecov.io/gh/NREL/rdtools)

RdTools is an open-source library to support reproducible technical analysis of

time series data from photovoltaic energy systems. The library aims to provide

best practice analysis routines along with the building blocks for users to

tailor their own analyses.

Current applications include the evaluation of PV production over several years to obtain

rates of performance degradation and soiling loss. RdTools can handle

both high frequency (hourly or better) or low frequency (daily, weekly,

etc.) datasets. Best results are obtained with higher frequency data.

RdTools can be installed automatically into Python from PyPI using the

command line:

```

pip install rdtools

```

For API documentation and full examples, please see the [documentation](https://rdtools.readthedocs.io).

RdTools currently is tested on Python 3.7+.

## Citing RdTools

To cite RdTools, please use the following along with the version number

and the specific DOI coresponding to that version from [Zenodo](https://doi.org/10.5281/zenodo.1210316):

-  Michael G. Deceglie, Ambarish Nag, Adam Shinn, Gregory Kimball,

   Daniel Ruth, Dirk Jordan, Jiyang Yan, Kevin Anderson, Kirsten Perry,

   Mark Mikofski, Matthew Muller, Will Vining, and Chris Deline

   RdTools, version {insert version}, Compuer Software,

   https://github.com/NREL/rdtools. DOI:{insert DOI}

The underlying workflow of RdTools has been published in several places.

If you use RdTools in a published work, you may also wish to cite the following as

appropriate:

-  Dirk Jordan, Chris Deline, Sarah Kurtz, Gregory Kimball, Michael Anderson, "Robust PV

   Degradation Methodology and Application", IEEE Journal of

   Photovoltaics, 8(2) pp. 525-531, 2018, DOI: [10.1109/JPHOTOV.2017.2779779](https://doi.org/10.1109/JPHOTOV.2017.2779779)

-  Michael G. Deceglie, Leonardo Micheli and Matthew Muller, "Quantifying Soiling Loss

   Directly From PV Yield," in IEEE Journal of Photovoltaics, 8(2),

   pp. 547-551, 2018, DOI: [10.1109/JPHOTOV.2017.2784682](https://doi.org/10.1109/JPHOTOV.2017.2784682)

-  Kevin Anderson and Ryan Blumenthal, "Overcoming Communications Outages in

   Inverter Downtime Analysis", 2020 IEEE 47th Photovoltaic Specialists

   Conference (PVSC)" DOI: [10.1109/PVSC45281.2020.9300635](https://doi.org/10.1109/PVSC45281.2020.9300635)

-  Kirsten Perry, Matthew Muller and Kevin Anderson, "Performance Comparison of Clipping

   Detection Techniques in AC Power Time Series," 2021 IEEE 48th Photovoltaic

   Specialists Conference (PVSC), pp. 1638-1643 2021, DOI: [10.1109/PVSC43889.2021.9518733](https://doi.org/10.1109/PVSC43889.2021.9518733).

## References

The clear sky temperature calculation, `clearsky_temperature.get_clearsky_tamb()`, uses data

from images created by Jesse Allen, NASA’s Earth Observatory using data courtesy of the MODIS Land Group.

https://neo.sci.gsfc.nasa.gov/view.php?datasetId=MOD_LSTD_CLIM_M

https://neo.sci.gsfc.nasa.gov/view.php?datasetId=MOD_LSTN_CLIM_M

Other useful references which may also be consulted for degradation rate methodology include:

  - D. C. Jordan, M. G. Deceglie, S. R. Kurtz, "PV degradation methodology comparison — A basis for a standard", in 43rd IEEE Photovoltaic Specialists Conference, Portland, OR, USA, 2016, DOI: 10.1109/PVSC.2016.7749593.

  - Jordan DC, Kurtz SR, VanSant KT, Newmiller J, Compendium of Photovoltaic Degradation Rates, Progress in Photovoltaics: Research and Application, 2016, 24(7), 978 - 989.

  - D. Jordan, S. Kurtz, PV Degradation Rates – an Analytical Review, Progress in Photovoltaics: Research and Application, 2013, 21(1), 12 - 29.

  - E. Hasselbrink, M. Anderson, Z. Defreitas, M. Mikofski, Y.-C.Shen, S. Caldwell, A. Terao, D. Kavulak, Z. Campeau, D. DeGraaff, "Validation of the PVLife model using 3 million module-years of live site data", 39th IEEE Photovoltaic Specialists Conference, Tampa, FL, USA, 2013, p. 7 – 13, DOI: 10.1109/PVSC.2013.6744087.

## Further Instructions and Updates

Check out the [wiki](https://github.com/NREL/rdtools/wiki) for additional usage documentation, and for information on development goals and framework.
      

---

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-04-12T13:49:57.639Z
• Profile URL: https://github.com/NREL

---

GitHub Events

Total

• Create event: 269
• Commit comment event: 2
• Release event: 32
• Delete event: 215
• Member event: 14
• Pull request event: 453
• Fork event: 63
• Issues event: 243
• Watch event: 144
• Issue comment event: 811
• Push event: 1165
• Pull request review event: 480
• Gollum event: 15
• Pull request review comment event: 628

Last Year

• Fork event: 3
• Create event: 35
• Commit comment event: 1
• Release event: 5
• Issues event: 23
• Watch event: 18
• Delete event: 23
• Member event: 1
• Issue comment event: 48
• Push event: 106
• Pull request review event: 16
• Pull request review comment event: 7
• Pull request event: 47

---

Committers metadata

Last synced: 2 days ago

Name	Email	Commits
Michael Deceglie	m****e@n****v	248
Adam Shinn	a****n@g****m	65
Kevin Anderson	5****l	55
Kevin Anderson	k****n@n****v	48
Michael Deceglie	m****i@m****l	42
Michael Deceglie	m****i@m****v	30
Chris Deline	c****e@n****v	22
Ambarish Nag	a****g@n****v	21
dependabot[bot]	4****]	18
GregoryKimball	g****l@s****m	12
Mark Mikofski	b****o@y****m	7
Michael Deceglie	m****i@s****v	6
martin-springer	m****s@g****m	5
Michael Deceglie	m****i@s****v	4
Jiyang Yan	j****1@u****u	4
Michael Deceglie	m****i@s****v	2
Kirsten Perry	7****l	1
Martin Springer	9****r	1
Sandra Villamar	1****r	1
Will Vining	w****g@g****m	1
nb137	n****7	1
Michael Deceglie	m****i@s****v	1
Traveler	t****r@M****l	1
martin-springer	m****s@g****m	1

Committer domains:

• nrel.gov: 4
• ssl-vpn-10-10-140-10.nrel.gov: 1
• ssl-vpn-10-136-240.nrel.gov: 1
• uci.edu: 1
• ssl-vpn-10-136-28.nrel.gov: 1
• ssl-vpn-10-10-137-78.nrel.gov: 1
• sunpowercorp.com: 1
• mdecegli-30388s.nrel.gov: 1

---

Issue and Pull Request metadata

Last synced: 1 day ago

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

---

---

---

Package metadata

• Total packages: 3
• Total downloads:
  • pypi: 1,116 last-month
• Total dependent packages: 0 (may contain duplicates)
• Total dependent repositories: 3 (may contain duplicates)
• Total versions: 34
• Total maintainers: 1

---

Dependencies

Score: 15.492442619361578