Skip to content

#40 pvdaq docs #42

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

#40 pvdaq docs #42

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3664f2b
Update entry for 7334 with 5-minute averages. Fixes #40
cdeline Sep 2, 2025
7f2897f
Document PV Output and PVDB dataset details
cdeline Sep 2, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions pvdaq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@ The Data Prize entries were submitted in one of two categories: systems < 5 MW D
#### > 5 MW DC system IDs:

* **7333** - A 257 MW Single-axis tracker facility in California. This dataset is at a very high time resolution of 10s for all channels.
* **7334** - This is the same dataset as 7333, except averaged to 5-minute intervals. This makes it more convenient to download and analyze.
* **9069** - A 38.7 MW Fixed ground-mount facility in Georgia

#### Details on the Prize Datasets
Expand All @@ -33,6 +34,14 @@ These datasets differ from the regular PVDAQ repository storage architecture (Se

**Note:** *Some of the prize datasets are extremely large and can have 10s of GBs of data. These could take a long time to download so please plan accordingly*

### PV Output
[PVOutput.org](https://pvoutput.org) is a free service for sharing, comparing and monitoring live solar photovoltaic (PV) and energy consumption data. Through the site, users can upload their own system production data, either manually or via API credentials. To date, over 800MW of systems are being recorded in this way. This PVDAQ site is sharing daily rolled-up energy data for PVOutput systems under a commercial license agreement. Full 5-minute data can be obtained via a [paid commercial license with PVOutput.org](https://pvoutput.org/services.jsp?id=101001).

A subset of systems are shared here which have reached a data completeness / quality score of 0.6 as determined by [solardatatools](https://github.com/slacgismo/solar-data-tools), and a dataset length of at least 4 years. These systems are primarily residential systems which are self-reported by users. Additional details for the systems can be investigated at their owners sites at pvoutput.org, linked through the description pages.

### PVDB
The PVDB dataset was made available through a collaboration between SunPower and the [SLAC GISMo team](https://esd.slac.stanford.edu/divisions/applied-energy). There are 226 residential sites and 12 commercial rooftop/carport sites in this dataset, all located in Orange County, California.

## Data Dictionary

The PVDAQ data is partitioned by system_id, year, month and day. Raw data is reported at 15 minute increments in ISO 8601 date and time. The timestamp is striped and data is averaged daily. An example file output is included here.
Expand Down