User Tools

Site Tools


codes:uvaccess

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
codes:uvaccess [2023/09/10 15:17]
jlsolano [GET FUNCTIONS]
codes:uvaccess [2024/04/11 11:51] (current)
jlsolano [UV Access Functions]
Line 2: Line 2:
  
 This pages describes UV-specific access functions. For a general overview of EUBREWNET'​s access functions, as well as a description of common inputs, see the wiki page on the [[codes:​dbaccess#​access_functions|ozone access functions]] This pages describes UV-specific access functions. For a general overview of EUBREWNET'​s access functions, as well as a description of common inputs, see the wiki page on the [[codes:​dbaccess#​access_functions|ozone access functions]]
 +
 +See [[https://​drive.google.com/​file/​d/​1JPpzt8Ab_1A_QzWpZThd0xAXWe3l5ymM/​view?​usp=sharing|this presentation]] for a short overview of the UV configuration and processing levels.
  
 ---- ----
Line 96: Line 98:
       - ''​config_id'':​ ID internally used by EUBREWNET to identify the configuration       - ''​config_id'':​ ID internally used by EUBREWNET to identify the configuration
  
 +==== Get uvrbydate ====
 +  * Function: uvrbydate
 +  * Description:​ This function lists the wavelengths and responsivites for the operative UV configuration at the requested date.
 +  * Example: http://​rbcce.aemet.es/​eubrewnet/​data/​get/​uvrbydate?​brewerid=185&​date=today&​format=text
 +  * Input:
 +      - ''​brewerid'':​ this is the ID of the reference Brewer. This follows the format described in [[codes:​dbaccess#​common_inputs|Brewerid in common inputs]]
 +      - ''​date'':​ date in YYYY-MM-DD format
 +      - ''​format'':​ see [[codes:​dbaccess#​format|Format]]
 +      - ''​fields'':​ see [[codes:​dbaccess#​common_inputs|Fields in common inputs]]
 +  * Output: besides the usual output, the following UV-specific fields are provided:
 +      - ''​config_date'':​ date at which the configuration becomes operative, in YYYYMMDD ​
 +      - ''​config_id'':​ ID internally used by EUBREWNET to identify the configuration
 +      - ''​wavelength'':​ wavelength in Angstroms
 +      - ''​responsivity''​ : responsivity in counts/​mW/​m<​sup>​2</​sup>/​nm
 ==== Get UVL0 ==== ==== Get UVL0 ====
   * Function: UVL0   * Function: UVL0
Line 172: Line 188:
 ==== Process UVL1_5 ==== ==== Process UVL1_5 ====
   * Function: UVL1_5   * Function: UVL1_5
-  * Description:​ Starting from the level 1 UV product, spike and temperature corrections are applied to the irradiances. The spike correction is always applied if needed. ​An operative UV configuration with the [[devel:​eubrewnetconfiguration&#​temperature | Temperature correction ​data]] must be available for the requested period. Output data is further filtered by the [[devel:​eubrewnetconfiguration&#​exclusion_list | UV Exclusion List]]+  * Description:​ Starting from the level 1 UV product, spike and temperature corrections are applied to the irradiances. The spike correction is always applied if needed. ​For the temperature correction, an operative UV configuration with the [[devel:​eubrewnetconfiguration&#​temperature | Temperature correction ​coefficients]] must be available for the requested period. Output data is further filtered by the [[devel:​eubrewnetconfiguration&#​exclusion_list | UV Exclusion List]]
   * Example: https://​rbcce.aemet.es/​eubrewnet/​data/​process/​UVL1_5?​brewerid=185&​date=2021-09-15&​enddate=2021-09-16&​format=text   * Example: https://​rbcce.aemet.es/​eubrewnet/​data/​process/​UVL1_5?​brewerid=185&​date=2021-09-15&​enddate=2021-09-16&​format=text
   * Input:   * Input:
Line 199: Line 215:
 ==== Process UVL1_6 ==== ==== Process UVL1_6 ====
   * Function: UVL1_6   * Function: UVL1_6
-  * Description:​ Starting from the level 1.5 UV product, process the data using the [[https://​www.rivm.nl/​en/​uv-ozone-layer-and-climate/​shicrivm|SHICRIVM code]] developed by Harry Slaper at the [[https://​www.rivm.nl/​en|National Institute of Public Health and the Environment (RIVM)]]. As of 2022-06-22, the output irradiances are calculated using the same generic slit function for all Brewer instruments. Output data is further filtered by SHICRIVM'​s QA/QC, retaining only measurements with GREEN and YELLOW flags. As in the case of level 1.5, output data is further filtered by the [[devel:​eubrewnetconfiguration&#​exclusion_list | UV Exclusion List]]+  * Description:​ Starting from the level 1.5 UV product, process the data using the [[https://​www.rivm.nl/​en/​uv-ozone-layer-and-climate/​shicrivm|SHICRIVM code]] developed by Harry Slaper at the [[https://​www.rivm.nl/​en|National Institute of Public Health and the Environment (RIVM)]]. As of 2022-06-22, the output, shift-corrected ​irradiances are calculated using the same generic slit function for all Brewer instruments. Output data is further filtered by SHICRIVM'​s QA/QC, retaining only measurements with GREEN and YELLOW flags. As in the case of level 1.5, output data is further filtered by the [[devel:​eubrewnetconfiguration&#​exclusion_list | UV Exclusion List]]
   * Example: https://​rbcce.aemet.es/​eubrewnet/​data/​process/​UVL1_6?​brewerid=185&​date=2021-09-15&​format=text   * Example: https://​rbcce.aemet.es/​eubrewnet/​data/​process/​UVL1_6?​brewerid=185&​date=2021-09-15&​format=text
   * Input:   * Input:
Line 214: Line 230:
       - ''​mmmm'':​ decimal minutes from 00:00 to the start of the UV scan       - ''​mmmm'':​ decimal minutes from 00:00 to the start of the UV scan
       - ''​scan'':​ type of UV scan performed (uv, ux, ua, ...)       - ''​scan'':​ type of UV scan performed (uv, ux, ua, ...)
-      - ''​irr_l'',​ where l=2865, 2870, ..., 3630: irradiance at the l wavelength, in W/m2/nm. Corresponds to the ''​Irr instr''​ output of SHICRIVM.+      - ''​irr_l'',​ where l=2865, 2870, ..., 3630: shift-corrected ​irradiance at the l wavelength, in W/m2/nm. Corresponds to the ''​Irr instr''​ output of SHICRIVM.
       - ''​shift_l'':​ wavelength shifts calculated by SHICRIVM       - ''​shift_l'':​ wavelength shifts calculated by SHICRIVM
       - ''​mmmm_l'':​ decimal minute from 00:00 at which the measurement at the l wavelength started       - ''​mmmm_l'':​ decimal minute from 00:00 at which the measurement at the l wavelength started
codes/uvaccess.1694359079.txt.gz ยท Last modified: 2023/09/10 15:17 by jlsolano