Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion docs/intro.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
"\n",
"A complete list of stations and metadata can be found in the [station catalog](../station_catalog).\n",
"\n",
"For more details on the SolarStations.org catalog, the reader is referred to the data article published in Solar Energy, DOI: [10.1016/j.solener.2025.113457](https://doi.org/10.1016/j.solener.2025.113457). We hope that you will cite the article if you use the catalog in published works.\n",
"For more details on the SolarStations.org catalog, the reader is referred to the data article published in Solar Energy [10.1016/j.solener.2025.113457](https://doi.org/10.1016/j.solener.2025.113457). We hope that you will cite the article if you use the catalog in published works.\n",
"\n",
"To find the nearest station to a point of interest, check out the interactive map below. Note that it is possible to click on a station icon to get the station name and country."
]
Expand Down
2 changes: 1 addition & 1 deletion docs/myst.yml
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ project:
- file: station_network_pvlive.ipynb
- file: station_network_eye2sky.ipynb
title: Eye2sky
- file: geba_network.md
- file: station_network_geba.md
- file: other_data_sources.md
title: Miscellaneous

Expand Down
11 changes: 9 additions & 2 deletions docs/station_catalog.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,14 @@
"metadata": {
"tags": []
},
"source": "# Station catalog\n\nThis site provides an overview of available solar irradiance monitoring stations worldwide and metadata of the stations.\nThe metadata fields are further described in the [metadata](station_metadata) section.\n\nThe table is also available to download in CSV form: {download}`SolarStationsOrg-station-catalog.csv <SolarStationsOrg-station-catalog.csv>`"
"source": [
"# Station catalog\n",
"\n",
"This site provides an overview of available solar irradiance monitoring stations worldwide and metadata of the stations.\n",
"The metadata fields are further described in the section on [metadata](station_metadata).\n",
"\n",
"The table is also available to download as a CSV file: {download}`SolarStationsOrg-station-catalog.csv <SolarStationsOrg-station-catalog.csv>`"
]
},
{
"cell_type": "code",
Expand Down Expand Up @@ -429,4 +436,4 @@
},
"nbformat": 4,
"nbformat_minor": 4
}
}
2 changes: 1 addition & 1 deletion docs/station_metadata.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ The central part of the catalog is the list of stations and their metadata which
* Data availability ("Freely", "Upon request", "Not available", or blank if unknown)
* Station tier (see [station requirements](station_requirements)).
* Instruments and components (see below)
* Long-term annual irradiance (climatology) from NASA POWER (GHI, DNI, and DHI)
* Long-term annual irradiance (climatology) of GHI, DNI, and DHI obtained from NASA POWER

Additional information of some of the metadata fields is provided below.

Expand Down
15 changes: 2 additions & 13 deletions docs/station_network_bsrn.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
"# Baseline Surface Radiation Network (BSRN)\n",
"\n",
"The [Baseline Surface Radiation Network (BSRN)](https://bsrn.awi.de/) is a global network of high-quality solar irradiance monitoring stations under the [World Climate Research Programme (WCRP)](https://www.wcrp-climate.org/) (Driemel et al., 2018). The procedures of the BSRN are described in great detail in the [BSRN Operations Manual\n",
"Version 2.1](https://bsrn.awi.de/fileadmin/user_upload/bsrn.awi.de/Publications/McArthur.pdf).\n",
"Version 2.1](https://bsrn.awi.de/fileadmin/user_upload/bsrn.awi.de/Publications/McArthur.pdf). The BSRN is also described in https://doi.org/10.5194/essd-10-1491-2018.\n",
"\n",
"According to the [World Radiation Monitoring Center (WRMC)](https://bsrn.awi.de/project/objectives/):\n",
"> The data [from the BSRN stations] are of primary importance in supporting the validation and confirmation of satellite and computer model estimates of these quantities. At a small number of stations (currently 74 in total, 58 active) in contrasting climatic zones, covering a latitude range from 80°N to 90°S, solar and atmospheric radiation is measured with instruments of the highest available accuracy and with high time resolution.\n",
Expand Down Expand Up @@ -2867,7 +2867,7 @@
"Please read the [BSRN data release guidelines](https://bsrn.awi.de/data/conditions-of-data-release/) before using any data and make sure to properly cite the BSRN.\n",
"```\n",
"\n",
"The station-to-archive files can be parsed and downloaded using the [pvlib-python](https://pvlib-python.readthedocs.io) library, specifically the [`pvlib.iotools.get_bsrn`](https://pvlib-python.readthedocs.io/en/stable/reference/generated/pvlib.iotools.get_bsrn.html) function. If you use the pvlib iotools for published work, please cite Jensen et al. (2023) which provides additional background information. An example of how to use pvlib to download two months of data from the Cabauw (CAB) station is shown below:"
"The station-to-archive files can be parsed and downloaded using the [pvlib-python](https://pvlib-python.readthedocs.io) library, specifically the [`pvlib.iotools.get_bsrn`](https://pvlib-python.readthedocs.io/en/stable/reference/generated/pvlib.iotools.get_bsrn.html) function (described in https://doi.org/10.1016/j.solener.2023.112092). If you use the pvlib iotools for published work, please cite Jensen et al. (2023) which provides additional background information. An example of how to use pvlib to download two months of data from the Cabauw (CAB) station is shown below:"
]
},
{
Expand Down Expand Up @@ -2991,17 +2991,6 @@
"Notice how there are multiple periods where there is gaps in the irradiance data."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## References\n",
"\n",
"* A. Driemel, J. Augustine, K. Behrens, S. Colle, C. Cox, E. Cuevas-Agulló, F. M. Denn, T. Duprat, M. Fukuda, H. Grobe, M. Haeffelin, G. Hodges, N. Hyett, O. Ijima, A. Kallis, W. Knap, V. Kustov, C. N. Long, D. Longenecker, A. Lupi, M. Maturilli, M. Mimouni, L. Ntsangwane, H. Ogihara, X. Olano, M. Olefs, M. Omori, L. Passamani, E. B. Pereira, H. Schmithüsen, S. Schumacher, R. Sieger, J. Tamlyn, R. Vogt, L. Vuilleumier, X. Xia, A. Ohmura, and G. König-Langlo. Baseline surface radiation network (BSRN): structure and data description (1992–2017). Earth System Science Data, 10(3):1491–1501, 2018. doi: [10.5194/essd-10-1491-2018](https://doi.org/10.5194/essd-10-1491-2018).\n",
"\n",
"* Adam R. Jensen, Kevin S. Anderson, William F. Holmgren, Mark A. Mikofski, Clifford W. Hansen, Leland J. Boeman, and Roel Loonen. Pvlib iotools—open-source python functions for seamless access to solar irradiance data. Solar Energy, 266:112092, 2023. doi: [10.1016/j.solener.2023.112092](https://doi.org/10.1016/j.solener.2023.112092).."
]
},
{
"cell_type": "code",
"execution_count": null,
Expand Down
11 changes: 1 addition & 10 deletions docs/station_network_eye2sky.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
"metadata": {},
"source": [
"# Eye2sky network\n",
"This page presents an overview of the [Eye2Sky cloud camera network](https://www.dlr.de/en/ve/research-and-transfer/research-infrastructure/laboratories-infrastructures/eye2sky) in north-west Germany. Part of the dataset has been made [public on Zenodo](https://zenodo.org/records/12804613), and an example of how to retrieve data using Python is provided. See [Schmidt et al. (2022)](https://doi.org/10.1049/icp.2022.2778) for more information.\n",
"This page presents an overview of the [Eye2Sky cloud camera network](https://www.dlr.de/en/ve/research-and-transfer/research-infrastructure/laboratories-infrastructures/eye2sky) in north-west Germany. Part of the dataset has been made [public on Zenodo](https://zenodo.org/records/12804613), and an example of how to retrieve data using Python is provided. See https://doi.org/10.1049/icp.2022.2778 for more information.\n",
"\n",
"> \"In north-west Germany between Oldenburg, the North Sea coast and the Dutch border, the Institute of Networked Energy Systems operates the unique Eye2Sky cloud camera network as a research infrastructure. The network is growing dynamically and currently consists of around 30 stations. The heart of each station is a cloud camera, also known as an all-sky imager (ASI). This is a commercially available webcam with a fisheye lens supplemented by a ventilation and heating system that ensures optimum image quality even in bad weather. A third of the stations are equipped with a rotating shadowband irradiometer (RSI), other radiation sensors and meteorological sensors for temperature and humidity, for example, to validate and calibrate the algorithms.\"\n"
]
Expand Down Expand Up @@ -2522,15 +2522,6 @@
" plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## References\n",
"\n",
"* T. Schmidt, J. Stührenberg, N. Blum, J. Lezaca, A. Hammer and T. Vogt, \"A network of all sky imagers (ASI) enabling accurate and high-resolution very short-term forecasts of solar irradiance,\" 21st Wind & Solar Integration Workshop (WIW 2022), Hybrid Conference, The Hague, Netherlands, 2022, pp. 372-378, doi: [10.1049/icp.2022.2778](https://doi.org/10.1049/icp.2022.2778)."
]
},
{
"cell_type": "code",
"execution_count": null,
Expand Down
File renamed without changes.
24 changes: 6 additions & 18 deletions docs/station_network_midc.ipynb

Large diffs are not rendered by default.

13 changes: 2 additions & 11 deletions docs/station_network_solrad.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
"\n",
"The [SOLRAD](https://gml.noaa.gov/grad/solrad/) network consists of 9 surface radiation monitoring stations and is operated by the [National Oceanic and Atmospheric Administration (NOAA)](https://www.noaa.gov/).\n",
"\n",
"The reader is referred to Hicks et al. (1996) for background information on the SOLRAD network.\n",
"The reader is referred to https://doi.org/10.1175/1520-0477(1996)077%3C2857:TNISIS%3E2.0.CO;2 for background information on the SOLRAD network.\n",
"\n",
"```{admonition} Instrument calibrations\n",
":class: dropdown\n",
Expand Down Expand Up @@ -809,7 +809,7 @@
"\n",
"Measurements from the SOLRAD stations are stored in daily ASCII text files and can be freely downloaded from the [SOLRAD FTP server](https://gml.noaa.gov/aftp/data/radiation/solrad/). Since January 1st 2015, data has been logged as 1-minute averages of 1-second samples. Prior to this, the data was stored as 3-minute averages.\n",
"\n",
"Data can be downloaded and parsed conveniently using the pvlib-python iotools module using the function [`pvlib.iotools.get_solrad`](https://pvlib-python.readthedocs.io/en/stable/reference/generated/pvlib.iotools.get_solrad.html). If you use pvlib iotools for published work, please cite Jensen et al. (2023) which provides additional background information. The use of the function is shown below, demonstrating how to retrieve five days of data:"
"Data can be downloaded and parsed conveniently using the pvlib-python iotools module using the function [`pvlib.iotools.get_solrad`](https://pvlib-python.readthedocs.io/en/stable/reference/generated/pvlib.iotools.get_solrad.html). If you use pvlib iotools for published work, please cite https://doi.org/10.1016/j.solener.2023.112092 which provides additional background information. The use of the function is shown below, demonstrating how to retrieve five days of data:"
]
},
{
Expand Down Expand Up @@ -1023,15 +1023,6 @@
" ax.set_ylim(-10, 1400)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## References\n",
"* Adam R. Jensen, Kevin S. Anderson, William F. Holmgren, Mark A. Mikofski, Clifford W. Hansen, Leland J. Boeman, and Roel Loonen. Pvlib iotools—open-source python functions for seamless access to solar irradiance data. Solar Energy, 266:112092, 2023. doi: [10.1016/j.solener.2023.112092](https://doi.org/10.1016/j.solener.2023.112092).\n",
"* B. B. Hicks, J. J. DeLuisi, and D. R. Matt. The NOAA integrated surface irradiance study (ISIS) - a new surface radiation monitoring program. Bulletin of the American Meteorological Society, 77(12):2857–2864, 1996. doi: [10.1175/1520-0477(1996)077<2857:TNISIS>2.0.CO;2](https://doi.org/10.1175/1520-0477(1996)077<2857:TNISIS>2.0.CO;2)."
]
},
{
"cell_type": "code",
"execution_count": null,
Expand Down
10 changes: 1 addition & 9 deletions docs/station_network_srml.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -737,7 +737,7 @@
"source": [
"## Data retrieval\n",
"\n",
"Data from the SRML stations are stored in monthly files for each station and can be freely [downloaded](http://solardata.uoregon.edu/SelectArchivalUpdatedFormat.html) from their website. The data can also be downloaded programmatically using the [pvlib-python](https://pvlib-python.readthedocs.io) library, specifically the [`pvlib.iotools.get_srml`](https://pvlib-python.readthedocs.io/en/stable/reference/generated/pvlib.iotools.get_srml.html) function. If you use pvlib iotools for published work, please cite Jensen et al. (2023) which provides additional background information. A list of the station acronyms can be found [here](http://solardata.uoregon.edu/StationIDCodes.html).\n",
"Data from the SRML stations are stored in monthly files for each station and can be freely [downloaded](http://solardata.uoregon.edu/SelectArchivalUpdatedFormat.html) from their website. The data can also be downloaded programmatically using the [pvlib-python](https://pvlib-python.readthedocs.io) library, specifically the [`pvlib.iotools.get_srml`](https://pvlib-python.readthedocs.io/en/stable/reference/generated/pvlib.iotools.get_srml.html) function. If you use pvlib iotools for published work, please cite https://doi.org/10.1016/j.solener.2023.112092 which provides additional background information. A list of the station acronyms can be found [here](http://solardata.uoregon.edu/StationIDCodes.html).\n",
"\n",
"An example of how to use pvlib to download data from the [Hermiston station](http://solardata.uoregon.edu/Hermiston.html) for June 2020 is shown here:"
]
Expand Down Expand Up @@ -894,14 +894,6 @@
"_ = axes[4].set_ylabel('Wind\\nspeed [m/s]'), axes[4].set_ylim(0,15)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## References\n",
"* Adam R. Jensen, Kevin S. Anderson, William F. Holmgren, Mark A. Mikofski, Clifford W. Hansen, Leland J. Boeman, and Roel Loonen. Pvlib iotools—open-source python functions for seamless access to solar irradiance data. Solar Energy, 266:112092, 2023. doi: [10.1016/j.solener.2023.112092](https://doi.org/10.1016/j.solener.2023.112092)."
]
},
{
"cell_type": "code",
"execution_count": null,
Expand Down
14 changes: 2 additions & 12 deletions docs/station_network_surfrad.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
"\n",
"The [SURFRAD](https://gml.noaa.gov/grad/surfrad/sitepage.html) network was established in 1993 and is operated by the [National Oceanic and Atmospheric Administration (NOAA)](https://www.noaa.gov/). The network features six active and two inactive stations in the contiguous United States. The stations are all Tier 1 stations and measurements are generally of a very high quality due to rigorous maintenance procedures and frequent inspection of data.\n",
"\n",
"The reader is referred to Augustine et al. (2000) and Augustine et al. (2005) for background information on the SURFRAD network.\n",
"The reader is referred to https://doi.org/10.1175/1520-0477(2000)081%3C2341:SANSRB%3E2.3.CO;2 and https://doi.org/10.1175/JTECH1806.1 for information on the SURFRAD network.\n",
"\n",
"```{admonition} Instrument calibrations\n",
":class: dropdown\n",
Expand Down Expand Up @@ -838,7 +838,7 @@
"\n",
"Measurements from the SURFRAD stations are stored in daily ASCII text files and can be freely downloaded from the [SURFRAD FTP server](https://gml.noaa.gov/aftp/data/radiation/surfrad/). Since January 1st, 2009, data has been logged as 1-minute averages. Prior to this, the data was stored as 3-minute averages.\n",
"\n",
"Individual data files can be downloaded and parsed conveniently using the pvlib-python iotools module using the function [`pvlib.iotools.read_surfrad`](https://pvlib-python.readthedocs.io/en/stable/reference/generated/pvlib.iotools.read_surfrad.html). Note, there is not yet a function to retrieve multiple SURFRAD files given a station and a date range. If you use pvlib iotools for published work, please cite Jensen et al. (2023) which provides additional background information. The use of the function is shown below, demonstrating how to retrieve five days of data:"
"Individual data files can be downloaded and parsed conveniently using the pvlib-python iotools module using the function [`pvlib.iotools.read_surfrad`](https://pvlib-python.readthedocs.io/en/stable/reference/generated/pvlib.iotools.read_surfrad.html). Note, there is not yet a function to retrieve multiple SURFRAD files given a station and a date range. If you use pvlib iotools for published work, please cite https://doi.org/10.1016/j.solener.2023.112092 which provides additional background information. The use of the function is shown below, demonstrating how to retrieve five days of data:"
]
},
{
Expand Down Expand Up @@ -1301,16 +1301,6 @@
" ax.set_ylim(-10, 1400)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## References\n",
"* Adam R. Jensen, Kevin S. Anderson, William F. Holmgren, Mark A. Mikofski, Clifford W. Hansen, Leland J. Boeman, and Roel Loonen. Pvlib iotools—open-source python functions for seamless access to solar irradiance data. Solar Energy, 266:112092, 2023. doi: [10.1016/j.solener.2023.112092](https://doi.org/10.1016/j.solener.2023.112092).\n",
"* J. A. Augustine, J. J. DeLuisi, and C. N. Long. SURFRAD — A national surface radiation budget network for atmospheric research. Bulletin of the American Meteorological Society, 81:2341–2357, 2000. doi: [10.1175/1520-0477(2000)081<2341:SANSRB>2.3.CO;2](https://doi.org/10.1175/1520-0477(2000)081<2341:SANSRB>2.3.CO;2).\n",
"* J. A. Augustine, G. B. Hodges, C. R. Cornwall, J. J. Michalsky, and C. I. Medina. An update on SURFRAD — the GCOS surface radiation budget network for the continental United States. Journal of Atmospheric and Oceanic Technology, 22:1460–1472, 2005. doi: [10.1175/JTECH1806.1](https://doi.org/10.1175/JTECH1806.1)"
]
},
{
"cell_type": "code",
"execution_count": null,
Expand Down
10 changes: 7 additions & 3 deletions docs/station_requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
This section defines the minimum requirements for a station to be included in the list of multi-component solar irradiance monitoring stations. The most restricting criteria is that stations are required to measure at least two of the three irradiance components, such that the remaining component can be calculated.

## Station categorization
Accepted stations are classified into two different categories: Tier 1 and Tier 2 stations, which are defined below.
Accepted stations are classified into two different categories: Tier 1 and Tier 2 stations, which are defined below (see https://doi.org/10.1016/j.solener.2023.112092).

### Tier 1 stations
Tier 1 stations are defined as those that meet all of the following requirements (classification is according to ISO 9060):
Expand All @@ -18,5 +18,9 @@ Tier 2 stations are defined as those that do not meet the Tier 1 requirements bu
* Meets two of the three requirements of Tier 1 stations
* Measures GHI and DHI using a rotating shadowband pyranometer or SPN1

### Non-qualifying stations
Stations that only measure GHI are not considered, which is in part because there are thousands of such stations worldwide and there are limited methods for assessing the quality of the measurements. Also, stations that measure DHI using a manually adjusted shadow band are generally not considered, as such measurements are notoriously unreliable due to the shadow band having to be adjusted every few days.
Note, stations that measure DHI using a manually adjusted shadow band are not included in the catalog, as such measurements are notoriously unreliable due to the shadow band having to be adjusted every few days.

### Tier 3 stations (not included)
Tier 3 stations are defines as those that only measure GHI. Automatic weather stations featuring a single pyranometer are examples of Tier 3 stations.

Tier 3 stations are not included in this catalog, which is in part because there are thousands of such stations worldwide and there are limited methods for assessing the quality of the measurements.
Loading