This shows you the differences between two versions of the page.
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 |