Skip to main content
U.S. Department of Energy
Office of Scientific and Technical Information

pvlib iotools—Open-source Python functions for seamless access to solar irradiance data

Journal Article · · Solar Energy

Access to accurate solar resource data is critical for numerous applications, including estimating the yield of solar energy systems, developing radiation models, and validating irradiance datasets. However, lack of standardization in data formats and access interfaces across providers constitutes a major barrier to entry for new users. pvlib python’s iotools subpackage aims to solve this issue by providing standardized Python functions for reading local files and retrieving data from external providers. All functions follow a uniform pattern and return convenient data outputs, allowing users to seamlessly switch between data providers and explore alternative datasets. The pvlib package is community-developed on GitHub: https://github.com/pvlib/pvlib-python. As of pvlib python version 0.9.5, the iotools subpackage supports 12 different datasets, including ground measurement, reanalysis, and satellite-derived irradiance data. The supported ground measurement networks include the Baseline Surface Radiation Network (BSRN), NREL MIDC, SRML, SOLRAD, SURFRAD, and the US Climate Reference Network (CRN). Additionally, satellite-derived and reanalysis irradiance data from the following sources are supported: PVGIS (SARAH & ERA5), NSRDB PSM3, and CAMS Radiation Service (including McClear clear-sky irradiance).

Research Organization:
Sandia National Laboratories (SNL-NM), Albuquerque, NM (United States); Univ. of Arizona, Tucson, AZ (United States)
Sponsoring Organization:
USDOE Office of Energy Efficiency and Renewable Energy (EERE), Renewable Power Office. Solar Energy Technologies Office; USDOE National Nuclear Security Administration (NNSA); Danish Energy Agency (DEA)
Grant/Contract Number:
NA0003525; EE0008214
OSTI ID:
2311327
Report Number(s):
SAND--2023-13720J
Journal Information:
Solar Energy, Journal Name: Solar Energy Vol. 266; ISSN 0038-092X
Publisher:
ElsevierCopyright Statement
Country of Publication:
United States
Language:
English

References (22)

The ERA5 global reanalysis journal June 2020
twoaxistracking – a python package for simulating self-shading of two-axis tracking solar collectors journal January 2022
Extensive validation of CM SAF surface radiation products over Europe journal September 2017
The National Solar Radiation Data Base (NSRDB) journal June 2018
A new solar radiation database for estimating PV performance in Europe and Africa journal June 2012
Evaluation of global horizontal irradiance estimates from ERA5 and COSMO-REA6 reanalyses using ground and satellite-based data journal April 2018
SolarData: An R package for easy access of publicly available solar datasets journal September 2018
SolarData package update v1.1: R functions for easy access of Baseline Surface Radiation Network (BSRN) journal August 2019
OpenSolar: Promoting the openness and accessibility of diverse public solar datasets journal August 2019
irradpy: Python package for MERRA-2 download, extraction and usage for clear-sky irradiance modelling journal March 2020
Benchmarking on improvement and site-adaptation techniques for modeled solar radiation datasets journal May 2020
Structure of a comprehensive solar radiation dataset journal November 2020
Measurement and modeling of diffuse irradiance masking on tilted planes for solar engineering applications journal January 2022
Fast radiative transfer parameterisation for assessing the surface solar irradiance: The Heliosat‑4 method journal February 2017
Improving the McClear model estimating the downwelling solar radiation at ground level in cloud-free conditions – McClear‑v3 journal June 2019
Surface solar irradiation retrieval from MSG/SEVIRI based on APOLLO Next Generation and HELIOSAT‑4 methods journal December 2022
The NOAA Integrated Surface Irradiance Study (ISIS)—A New Surface Radiation Monitoring Program journal December 1996
SURFRAD—A National Surface Radiation Budget Network for Atmospheric Research journal October 2000
U.S. Climate Reference Network after One Decade of Operations: Status and Assessment journal April 2013
An Update on SURFRAD—The GCOS Surface Radiation Budget Network for the Continental United States journal October 2005
pvlib python: a python package for modeling solar energy systems journal September 2018
Baseline Surface Radiation Network (BSRN): structure and data description (1992–2017) journal January 2018