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
Last revision Both sides next revision
codes:uvaccess [2023/09/10 15:17]
jlsolano [GET FUNCTIONS]
codes:uvaccess [2024/04/11 11:45]
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/​1UaLn6mOz7WF7X8aWoy8KR8vl5rVpyuE_/​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.txt ยท Last modified: 2024/04/11 11:51 by jlsolano