quartz-solar-forecast 1.0.32

Open Source Solar Forecasting for a Site

Quartz Solar Forecast

The aim of the project is to build an open source PV forecast that is free and easy to use. The forecast provides the expected generation in kw for 0 to 48 hours for a single PV site.

Open Climate Fix also provides a commercial PV forecast, please get in touch at [e-mail]

We recently presented the Quartz Solar Forecast project at FOSDEM 2024 (Free and Open source Software Developers' European Meeting), providing an introduction to Open Climate Fix's motivation for this project and its impact on aiding organizations in resource optimization. To learn more about predictive model's functionality, visit here: Video Recording

The current model uses GFS or ICON NWPs to predict the solar generation at a site

from quartz_solar_forecast.forecast import run_forecast
from quartz_solar_forecast.pydantic_models import PVSite
from datetime import datetime

# make a pv site object
site = PVSite(latitude=51.75, longitude=-1.25, capacity_kwp=1.25)

# run model for today, using ICON NWP data
predictions_df = run_forecast(site=site, ts=datetime.today(), nwp_source="icon")

which should result in a time series similar to this one:

Generating Forecasts

To generate solar forecasts and save them into a CSV file, follow these steps:

1. Navigate to the scripts directory

cd scripts

2. Run the forecast_csv.py script with desired inputs

python forecast_csv.py

Replace the --init_time_freq, --start_datetime, --end_datetime, and --site_name with your desired forecast initialization frequency (in hours), start datetime, end datetime, and the name of the forecast or site, respectively.

Output

The script will generate solar forecasts at the specified intervals between the start and end datetimes. The results will be combined into a CSV file named using the site name, start and end datetimes, and the frequency of forecasts. This file will be saved in the scripts/csv_forecasts directory.

Installation

The source code is currently hosted on GitHub at: https://github.com/openclimatefix/Open-Source-Quartz-Solar-Forecast

Binary installers for the latest released version are available at the Python Package Index (PyPI)

pip install quartz-solar-forecast

You might need to install the following packages first

conda install -c conda-forge pyresample

This can solve the bug: ___kmpc_for_static_fini.

Model

The model is a gradient boosted tree model and uses 9 NWP variables. It is trained on 25,000 PV sites with over 5 years of PV history, which is available here. The training of this model is handled in pv-site-prediction TODO - we need to benchmark this forecast.

The 9 NWP variables, from Open-Meteo documentation, are mentioned above with their appropariate units.

1. Visibility (km), or vis: Distance at which objects can be clearly seen. Can affect the amount of sunlight reaching solar panels.
2. Wind Speed at 10 meters (km/h), or si10 : Wind speed measured at a height of 10 meters above ground level. Important for understanding weather conditions and potential impacts on solar panels.
3. Temperature at 2 meters (°C), or t : Air temperature measure at 2 meters above the ground. Can affect the efficiency of PV systems.
4. Precipiration (mm), or prate : Precipitation (rain, snow, sleet, etc.). Helps to predict cloud cover and potentiel reductions in solar irradiance.
5. Shortwave Radiation (W/m²), or dswrf: Solar radiation in the shortwave spectrum reaching the Earth's surface. Measure of the potential solar energy available for PV systems.
6. Direct Radiation (W/m²) or dlwrf: Longwave (infrared) radiation emitted by the Earth back into the atmosphere. confirm it is correct
7. Cloud Cover low (%), or lcc: Percentage of the sky covered by clouds at low altitudes. Impacts the amount of solar radiation reachign the ground, and similarly the PV system.
8. Cloud Cover mid (%), or mcc : Percentage of the sky covered by clouds at mid altitudes.
9. Cloud Cover high (%), or lcc : Percentage of the sky covered by clouds at high altitude

We also use the following features

• poa_global: The plane of array irradiance, which is the amount of solar radiation that strikes a solar panel.
• poa_global_now_is_zero: A boolean variable that is true if the poa_global is zero at the current time. This is used to help the model learn that the PV generation is zero at night.
• capacity (kw): The capacity of the PV system in kw.
• The model also has a feature to check if these variables are NaNs or not.

The model also uses the following variables, which are currently all set to nan

• recent_power: The mean power over the last 30 minutes
• h_mean: The mean of the recent pv data over the last 7 days
• h_median: The median of the recent pv data over the last 7 days
• h_max: The max of the recent pv data over the last 7 days

Known restrictions

• The model is trained on UK MetOffice NWPs, but when running inference we use GFS data from Open-meteo. The differences between GFS and UK MetOffice could led to some odd behaviours.
• Depending, whether the timestamp for the prediction lays more than 90 days in the past or not, different data sources for the NWP are used. If we predict within the last 90 days, we can use ICON or GFS from the open-meteo Weather Forecast API. Since ICON doesn't provide visibility, this parameter is queried from GFS in any case. If the date for the prediction is further back in time, a reanalysis model of historical data is used (open-meteo | Historical Weather API). The historical weather API doesn't't provide visibility at all, that's why it's set to a maximum of 24000 meter in this case. This can lead to some loss of precision.

Evaluation

To evaluate the model we use the UK PV dataset and the ICON NWP dataset. All the data is publicly available and the evaluation script can be run with the following command

python scripts/run_evaluation.py

The test dataset we used is defined in quartz_solar_forecast/dataset/testset.csv. This contains 50 PV sites, which 50 unique timestamps. The data is from 2021.

The results of the evaluation are as follows The MAE is 0.1906 kw across all horizons.

Horizons	MAE [kw]	MAE [%]
0	0.202 +- 0.03	6.2
1	0.211 +- 0.03	6.4
2	0.216 +- 0.03	6.5
3 - 4	0.211 +- 0.02	6.3
5 - 8	0.191 +- 0.01	6
9 - 16	0.161 +- 0.01	5
17 - 24	0.173 +- 0.01	5.3
24 - 48	0.201 +- 0.01	6.1

If we exclude nighttime, then the average MAE [%] from 0 to 36 forecast hours is 13.0%.

Notes:

• The MAE in % is the MAE divided by the capacity of the PV site. We acknowledge there are a number of different ways to do this.
• It is slightly surprising that the 0-hour forecast horizon and the 24-48 hour horizon have a similar MAE. This may be because the model is trained expecting live PV data, but currently in this project we provide no live PV data.

Abbreviations

• NWP: Numerical Weather Predictions
• GFS: Global Forecast System
• PV: Photovoltaic
• MAE: Mean Absolute Error
• ICON: ICOsahedral Nonhydrostatic
• KW: Kilowatt

FOSDEM

FOSDEM is a free event for software developers to meet, share ideas and collaborate. Every year, thousands of developers of free and open source software from all over the world gather at the event in Brussels. OCF presented Quartz Solar Forecast project at FOSDEM 2024. The link to the original FOSDEM video is availble at Quartz Solar OS: Building an open source AI solar forecast for everyone. It is also available on YouTube

Contribution

We welcome other models.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Peter Dudfield 💻	Megawattz 🤔 📢	EdFage 📖 💻	Chloe Pilon Vaillancourt 📖	rachel tipton 📢	armenbod 🖋 💻	Shreyas Udaya 📖
Aryan Bhosale 📖 💻	Francesco 💻	Rosheen Naeem 📖	Bikram Baruah 💻	Jakob Gebler 🐛	Om Bhojane 💻	Chris Adams 🤔
Mudra Patel 📖

This project follows the all-contributors specification. Contributions of any kind welcome!