Minor doc updates (#244)

* Small doc updates

* Update station_network_bsrn.ipynb

docs/geba_network.md

@@ -1,6 +1,6 @@
 # GEBA
 
-The Global Energy Balance Archive (GEBA) is a global database containing measured energy fluxes at the Earth’s surface and is maintained by ETH Zurich (Switzerland). Notably, the stations included are of varying quality with many only measuring one irradiance component as part of national networks, although many of the historical records extend over several decades.
+The Global Energy Balance Archive (GEBA) is a global database containing measured energy fluxes at the Earth’s surface and is maintained by ETH Zurich in Switzerland. Notably, the stations included are of varying quality with most only measuring one irradiance component as part of national networks, although many of the historical records extend over several decades.
 
 GEBA contains monthly data from a variety of sources, namely from the World Radiation Data Centre (WRDC) in St. Petersburg, national weather services, research networks (BSRN, ARM, SURFRAD), peer-reviewed publications, project and data reports, and personal communications. GEBA is publicly accessible [online](http://www.geba.ethz.ch). Supplementary data are also available [here](https://doi.org/10.1594/PANGAEA.873078). An overview of the measurement locations is presented in the figure below.
 
@@ -29,4 +29,4 @@ The following parameters can be obtained from GEBA:
 * Absorbed shortwave irradiance
 * Circumglobal irradiance
 
-It should be noted that not all the measurement locations are still in operation and have all the parameters available. Additionally, most locations only measure global horizontal irradiance. Unfortunately, GEBA does not provide information on the instrument used to measure solar irradiance components, so the user can't estimate the quality of the data.
+It should be noted that not all the measurement locations are still in operation and have all the parameters available. Unfortunately, GEBA does not provide information on the instrument used to measure solar irradiance components, so the user can't estimate the quality of the data.

docs/intro.ipynb

@@ -15,7 +15,7 @@
     "\n",
     "Ground measured solar irradiance data is extremely valuable and critical for benchmarking solar radiation products, modeling climate processes, and understanding the Earth's radiation budget. However, due to high costs and maintenance requirements, there are only a few hundred high-quality stations globally. Partly due to the scarcity, it has historically been difficult to determine if and where there is a nearby solar irradiance monitoring station. To address this, this site provides an overview of multi-component solar irradiance monitoring stations worldwide and supporting metadata.\n",
     "\n",
-    "A complete list of stations and metadata can be found [here](../station_catalog).\n",
+    "A complete list of stations and metadata can be found in the [station catalog](../station_catalog).\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."
    ]

docs/station_network_bsrn.ipynb

@@ -2819,7 +2819,7 @@
    "metadata": {},
    "source": [
     "## Station requirements\n",
-    "All BSRN stations are required to meet the basic [station requirements](http://bsrn.awi.de/en/stations/join-bsrn/), which include measuring direct normal (DNI), diffuse horizontal (DHI), global horizontal (GHI), and down-welling long-wave irradiance.\n",
+    "All BSRN stations are required to meet the basic [station requirements](http://bsrn.awi.de/en/stations/join-bsrn/), which include measuring direct normal (DNI), diffuse horizontal (DHI), global horizontal (GHI), and down-welling long-wave (LWD) irradiance.\n",
     "\n",
     "Additional metadata may be found at the [BSRN website](https://wiki.pangaea.de/wiki/BSRN#Sortable_Table_of_Stations) and in the individual data files (e.g., horizon profile)."
    ]
@@ -2829,7 +2829,7 @@
    "metadata": {},
    "source": [
     "```{note}\n",
-    "Unlike most solar irradiance monitoring networks, the BSRN website does not have a subpage for each station (with photos, etc.). This would have been very useful when assessing the usage of the station, for example, in regards to the potential impact of nearby structures, etc. Note a few photos of the BSRN stations can be found [here](https://bsrn.awi.de/other/picture-gallery/). The station logbooks are also not available.\n",
+    "Unlike some solar irradiance monitoring networks, the BSRN website does not have a subpage for each station (with photos, etc.). This would have been very useful when assessing the usage of the station, for example, in regards to the potential impact of nearby structures, etc. Note a few photos of the BSRN stations can be found [here](https://bsrn.awi.de/other/picture-gallery/). The station logbooks are also not available.\n",
     "```"
    ]
   },
@@ -2846,7 +2846,11 @@
    "source": [
     "## Data quality\n",
     "\n",
-    "It should be noted that BSRN stations do not receive specific funding but rely on national funding (e.g., meteorological institutes or research organizations) which represents a serious challenge when making long-term measurements. While the instrumentation used at BSRN stations represents the state-of-the-art, quality procedures and maintenance practices vary greatly, and consequently data quality. For example, the Cabauw (CAB) station is a station with a generally very high data quality partly owing to station inspections each work day. In contrast, data from the Brasilia (BRB), Gandhinagar (GAN), and Gurgaon (GUR) stations have been found to have periods with low data quality. In short, any kind of irradiance measurements should not be used without meticulous inspection by the data user."
+    "It should be noted that BSRN stations do not receive specific funding but rely on national funding (e.g., meteorological institutes or research organizations) which represents a serious challenge when making long-term measurements. While the instrumentation used at BSRN stations represents the state-of-the-art, quality procedures and maintenance practices vary greatly, and consequently data quality. For example, the Cabauw (CAB) station is a station with a generally very high data quality partly owing to station inspections each work day. In contrast, data from the Brasilia (BRB), Gandhinagar (GAN), and Gurgaon (GUR) stations have been found to have periods with low data quality. In short, any kind of irradiance measurements should not be used without meticulous inspection by the data user.\n",
+    "\n",
+    "```{warning}\n",
+    "WRMC highly recommends that all users do their own quality checks of the data after extracting BSRN-data!\n",
+    "```"
    ]
   },
   {
@@ -2857,16 +2861,12 @@
    "source": [
     "## Data retrieval\n",
     "\n",
-    "Data from the BSRN stations are stored in monthly files for each station and can be freely downloaded either via [FTP](https://bsrn.awi.de/?id=387) or from the [Pangea](https://bsrn.awi.de/data/data-retrieval-via-pangaea/) data portal. The data on the FTP server is identical to the data on Pangea. Credentials for accessing the BSRN FTP server can be obtained as described in the [data release guidelines](https://bsrn.awi.de/data/conditions-of-data-release). All of the files on the FTP server are in the rather archaic station-to-archive file format, which is described in the [Update of the Technical Plan for BSRN data management](https://bsrn.awi.de/fileadmin/user_upload/bsrn.awi.de/Publications/Hegner.pdf). There is no standard for when data becomes available, which can vary between a few months to more than a year.\n",
+    "Data from the BSRN stations are stored in monthly files for each station and can be freely downloaded either via [FTP](https://bsrn.awi.de/?id=387) or from the [Pangea](https://bsrn.awi.de/data/data-retrieval-via-pangaea/) data portal (the data is identical to the data on Pangea. Credentials for accessing the BSRN FTP server can be obtained as described in the [data release guidelines](https://bsrn.awi.de/data/conditions-of-data-release). All of the files on the FTP server are in the rather archaic station-to-archive file format, which is described in the [Update of the Technical Plan for BSRN data management](https://bsrn.awi.de/fileadmin/user_upload/bsrn.awi.de/Publications/Hegner.pdf). There is no standard for when data becomes available, which can vary between a few months to more than a year.\n",
     "\n",
     "```{admonition} Data release guidelines\n",
     "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",
-    "```{warning}\n",
-    "WRMC highly recommends that all users do their own quality checks of the data after extracting BSRN-data!\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 [`get_bsrn`](https://pvlib-python.readthedocs.io/en/stable/reference/generated/pvlib.iotools.get_bsrn.html) function. An example of how to use pvlib to download two months of data from the Cabauw (CAB) station is shown below:"
    ]
   },
@@ -3026,7 +3026,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.4"
+   "version": "3.11.7"
   }
  },
  "nbformat": 4,

docs/station_network_midc.ipynb

@@ -9,7 +9,7 @@
     "\n",
     "The [Measurement and Instrumentation Data Center (MIDC)](https://midcdmz.nrel.gov/) is operated by NREL and provides irradiance and meteorological data from a number of ground stations in the U.S. The stations vary in quality, with some stations measuring all three components with high-quality instruments and other stations featuring a rotating shadow band pyranometer.\n",
     "\n",
-    "The most notable station is the [Baseline Measurement System (BMS)](https://midcdmz.nrel.gov/apps/sitehome.pl?site=BMS) at NREL's [Solar Radiation Research Laboratory (SRRL)](https://www.nrel.gov/esif/solar-radiation-research-laboratory.html) outside of Denver, Colorado. The BMS features the world's largest collection of operating pyranometers and pyrheliometers. A number of sky imagers, PV reference cells, and spectral radiometers are also located at the site. Instruments at the BMS are cleaned each weekday and frequently calibrated. Thus, due to the large collection of co-located and well maintained instruments, the BMS data is ideal for comparing different types of instruments.\n",
+    "The most notable station is the [Baseline Measurement System (BMS)](https://midcdmz.nrel.gov/apps/sitehome.pl?site=BMS) at NREL's [Solar Radiation Research Laboratory (SRRL)](https://www.nrel.gov/esif/solar-radiation-research-laboratory.html) outside of Denver, Colorado. The BMS features the world's largest collection of operating pyranometers and pyrheliometers. A number of sky imagers, PV reference cells, and spectral radiometers are also located at the site. Instruments at the BMS are cleaned each weekday and frequently calibrated. Due to the large collection of co-located and well maintained instruments, the BMS data is ideal for comparing different types of instruments.\n",
     "\n",
     "Note, the MIDC includes several inactive stations. Also, several of the active stations are no longer cleaned or calibrated frequently. For these reasons, the SolarStations.Org catalog only includes the SRRL BMS, SOLARTAC, and Flatirons M2 sites, as these measures all three irradiance components and are active. See the map below for the locations of the stations."
    ]

docs/station_network_srml.ipynb

@@ -827,7 +827,6 @@
     "    end='2020-06-30',\n",
     "    url='http://solardata.uoregon.edu/download/Archive/')\n",
     "\n",
-    "# print the first 12 rows of data\n",
     "show(df.head(), scrollX=True, scrollCollapse=True, paging=False, maxColumns=100, dom=\"tpr\")"
    ]
   },

docs/station_requirements.md

@@ -6,17 +6,17 @@ This section defines the minimum requirements for a station to be included in th
 Accepted stations are classified into two different categories: Tier 1 and Tier 2 stations, which are defined below.
 
 ### Tier 1 stations
-Tier 1 stations are defined as those that meet all of the following requirements:
-* measurement of direct normal irradiance (DNI) with a Class A thermopile pyrheliometer mounted on a solar tracker
+Tier 1 stations are defined as those that meet all of the following requirements (classification is according to ISO 9060):
+* measurement of direct normal irradiance (DNI) with a Spectrally Flat Class A thermopile pyrheliometer mounted on a solar tracker
 * measurement of diffuse horizontal irradiance (DHI) with a Spectrally Flat Class A thermopile pyranometer shaded by a shading ball
 * measurement of global horizontal irradiance (GHI) with a Spectrally Flat Class A thermopile pyranometer
 
-Separate measurement of GHI is required for Tier 1 stations as most quality control procedures rely on comparing the measured and calculated GHI (closure equation). Stations in the [BSRN network](station_network_bsrn) are examples of Tier 1 stations.
+Separate measurement of GHI is required for Tier 1 stations as most quality control procedures rely on comparing the measured GHI and GHI derived from direct and diffuse irradiance (closure equation). Stations in the [BSRN network](station_network_bsrn) are examples of Tier 1 stations.
 
 ### Tier 2 stations
 Tier 2 stations are defined as those that do not meet the Tier 1 requirements but meet one of the following specifications:
 * Meets two of the three requirements of Tier 1 stations
-* Measures GHI and DHI using a rotating shading band pyranometer or SPN1
+* 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. 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.
+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.