===== UV 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/1-OMhy6x3qNXf5lESnDPcPcDlJ71IoBTy/view?usp=sharing|this poster]] for a short overview of the UV processing levels. See [[https://drive.google.com/file/d/1JPpzt8Ab_1A_QzWpZThd0xAXWe3l5ymM/view?usp=sharing|this presentation]] for more details on the UV configuration. Note levels 1.6 and 2 were interchanged after this talk was presented: level 1.6 now corresponds to the cosine correction, and level 2, to the wavelength-shift correction. ---- ===== COMMON OPTIONS ===== ==== Formats ==== Besides the formats described [[codes:dbaccess#format|here]], two further values can be passed in the URL to the ''format'' argument: ^ Format input ^ Description ^ Example ^ ^ zip | returns a zip with separate files for each scan; these separate files are written in the SHICrivm text format | [[http://eubrewnet.aemet.es/eubrewnet/data/process/UVL1_6?brewerid=185&date=2021-09-15&format=zip|zip example]] | ^ jsona | spectral variables such as ''irr_l'' or ''aod_l'', where ''l'' is the wavelength, are written together as single 2d arrays, with the first dimension as the date and time, and the second as the wavelength. The date and time are written in the ''gmt'' variable as usual, and wavelengths, in the new ''wavel'' variable | [[http://eubrewnet.aemet.es/eubrewnet/data/process/UVL1_6?brewerid=185&date=2021-09-15&format=jsona|jsona example]] | ==== Input ==== Beside the input options described in [[codes:dbaccess#common_inputs]], selected UV functions also support: ^ Parameter ^ Description ^ Example ^ ^ time | time in ''HH[:MM[:SS]]'' format, to select the time to start the UV processing in each day | [[http://eubrewnet.aemet.es/eubrewnet/data/process/UVL1_6?brewerid=185&date=2021-09-15&time=11&format=text|Process UV scans starting after 11:00:00]] | ^ endtime | time in ''HH[:MM[:SS]]'' format, to be used together with the ''time'' variable (see above) to select a time range in each day for the UV processing. If omitted, defaults to 23:59:59 | [[http://eubrewnet.aemet.es/eubrewnet/data/process/UVL1_6?brewerid=185&date=2021-09-15&time=11&endtime=15:30&format=text|Process UV scans starting after 11:00:00 and ending before 15:30:00]] | ---- ===== GET FUNCTIONS ===== ^ Function ^ Description ^ Help ^ Example ^ ^ uvscans | Return available UV scans | [[codes:uvaccess#get_uvscans|uvscans]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/uvscans?brewerid=157&date=2022-03-09&format=text|Get uvscans]] | ^ compareuvtimes | For two brewers, return the scans starting within some time delta | [[codes:uvaccess#get_compareuvtimes|compareuvtimes]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/compareuvtimes?brewerid=157&compid=183&date=2022-03-07&format=text|Get compareuvtimes]] | ^ compareuv | For two brewers, compare the irradiances for the scans starting within some time delta | [[codes:uvaccess#get_compareuv|compareuv]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/compareuv?brewerid=157&compid=183&date=2022-03-07&format=text|Get compareuv]] | ^ uvrall | return the start dates of all the operative configurations available in EUBREWNET for a specific Brewer | [[codes:uvaccess#get_uvrall|uvrall]] | [[http://eubrewnet.aemet.es/eubrewnet/data/get/uvrall?brewerid=185&format=text|Get uvrall]] | ^ uvrbydate | return the UVR operative in EUBREWNET for a specific Brewer and date | [[codes:uvaccess#get_uvrbydate|uvrbydate]] | [[http://eubrewnet.aemet.es/eubrewnet/data/get/uvrbydate?brewerid=185&date=today&format=text|Get uvrbydate]] | ^ UVL0 | return the raw counts measured by the Brewer | [[codes:uvaccess#get_uvl0|UVL]] | [[http://eubrewnet.aemet.es/eubrewnet/data/get/UVL0?brewerid=150&date=2021-08-03&format=text|Get UVL0]] | ^ UVL1 | Returns Level 1 UV | [[codes:uvaccess#get_uvl1|UVL1]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/UVL1?brewerid=185&date=2021-10-13&enddate=2021-10-15&format=text|Get UVL1]] | ^ UVL1_5 | Returns Level 1.5 UV | [[codes:uvaccess#get_uvl1_5|UVL1_5]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/UVL1_5?brewerid=185&date=2021-10-14|Get UVL1_5]] | ^ UVL1_6 | Returns Level 1.6 UV | [[codes:uvaccess#get_uvl1_6|UVL1_6]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/UVL1_6?brewerid=185&date=2021-10-14&format=text|Get UVL1_6]] | ^ UVL2 | Returns Level 2 UV | [[codes:uvaccess#get_uvl2|UVL2]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/UVL2?brewerid=185&date=2021-10-14&format=text|Get UVL2]] | ==== Get uvrbydate ==== * Function: uvrbydate * Description: return the operative UVR at the selected date * Example: http://rbcce.aemet.es/eubrewnet/data/get/uvrbydate?brewerid=185&date=2019-09-13&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''format'': see [[codes:dbaccess#format|Format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] * Output: besides de standard output (Brewer ID, config ID, ...) the following fields are provided: - ''wavelength'': wavelength in Angstroms - ''responsivity'': responsivity in counts/mW/m2/nm ==== Get uvslitbydate ==== * Function: uvslitbydate * Description: return the brewer slit function stored in the operative configuration at the selected date * Example: http://rbcce.aemet.es/eubrewnet/data/get/uvslitbydate?brewerid=185&date=2024-06-05&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''format'': see [[codes:dbaccess#format|Format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] * Output: besides de standard output (Brewer ID, config ID, ...) the following fields are provided: - ''wavel_diff'': difference from the central wavelength - ''norm_counts'': counts normalized to the central peak ==== Get uvarfbydate ==== * Function: uvarfbydate * Description: return the angular response stored in the operative configuration at the selected date * Example: https://rbcce.aemet.es/eubrewnet/data/get/uvarfbydate?brewerid=185&date=2024-09-18&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''format'': see [[codes:dbaccess#format|Format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] * Output: besides de standard output (Brewer ID, config ID, ...) the following fields are provided: - ''sza'': zenith angle - ''ang_resp_1'': angular response normalized to angle 0. Note only ang_resp_1 is used by the BUVIC calculation ==== Get uvmeteoforadate ==== * Function: uvmeteoforadate * Description: return UV surface albedo, Angstrom's alpha and beta parameters, and cloud cover stored in the operative configuration at the selected date * Example: https://rbcce.aemet.es/eubrewnet/data/get/uvmeteoforadate?brewerid=185&date=2024-08-25&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''format'': see [[codes:dbaccess#format|Format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] * Output: besides de standard output (Brewer ID, config ID, ...) the following fields are provided: - ''albedo'': UV surface albedo - ''alpha'': Angstrom's alpha - ''beta'': Angstrom's beta - ''cloud'': Cloud cover ==== Get uvtempcorbydate ==== * Function: uvtempcorbydate * Description: return the temperature correction stored in the operative configuration at the selected date * Example: https://rbcce.aemet.es/eubrewnet/data/get/uvtempcorbydate?brewerid=150&date=2024-09-13&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''format'': see [[codes:dbaccess#format|Format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] * Output: besides de standard output (Brewer ID, config ID, ...) the following fields are provided: - ''wavelength'': wavelength in Angstroms - ''tempdep'': temperature dependence - ''tempref'': reference temperature ==== Get uvscans ==== * Function: uvscans * Description: This function lists the UV scans available in Eubrewnet for a specific Brewer and date range * Example: https://eubrewnet.aemet.es/eubrewnet/data/get/uvscans?brewerid=157&date=2022-03-09&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] - ''format'': see [[codes:dbaccess#format|Format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] - ''scans'': a comma-separated list of UV scan types to list. If ommited, defaults to ''ux,ua,uv'' * Output: besides de standard output (Brewer ID, gmt, ...) the following UV-specific fields are provided: - ''scan'': type of UV-scan (ua, ux, uv) - ''mmmm'': decimal minutes from 00:00 to the start of the UV scan ==== Get compareuvtimes ==== * Function: compareuvtimes * Description: This function lists the UV scans available in Eubrewnet in a date range, for two input Brewers. * Example: https://eubrewnet.aemet.es/eubrewnet/data/get/compareuvtimes?brewerid=157&compid=183&date=2022-03-07&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]] - ''compid'': this is the ID of the Brewer which is being compared to the reference Brewer - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] - ''format'': see [[codes:dbaccess#format|Format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] - ''scans'': a comma-separated list of UV scan types to list. If ommited, defaults to ''ux,ua,uv'' - ''maxminutes'': maximum difference between the scans of the two Brewers. If omitted, it defaults to 5 minutes * Output: besides the usual output, the following UV-specific fields are provided: - ''scan'' and ''compscan'': type of UV-scan (ua, ux, uv) of the two Brewers - ''mmmm'' and ''compmmmm'': decimal minutes from 00:00 to the start of the UV scan for the two Brewers - ''deltaminutes'': diference in decimal minutes between the starting times of the two UV scans ==== Get compareuv ==== * Function: compareuv * Description: This function lists the irradiance ratios in a date range, for two input Brewers. * Example: https://eubrewnet.aemet.es/eubrewnet/data/get/compareuv?brewerid=157&compid=183&date=2022-03-07&maxminutes=0.5&format=text * Input: - ''brewerid'': ID of the reference Brewer. This follows the format described in [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''compid'': ID of the Brewer which is being compared to the reference Brewer - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] - ''format'': see [[codes:dbaccess#format|Format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] - ''scans'': a comma-separated list of UV scan types to list. If ommited, defaults to ''ux,ua,uv'' - ''maxminutes'': maximum difference between the scans of the two Brewers. If omitted, it defaults to 5 minutes - ''level'': UV product level used to calculate the irradiances. If omitted, defaults to level 1 * Output: besides the usual output, the following UV-specific fields are provided: - ''scan'' and ''compscan'': type of UV-scan (ua, ux, uv) of the two Brewers - ''mmmm'' and ''compmmmm'': decimal minutes from 00:00 to the start of the UV scan for the two Brewers - ''deltaminutes'': diference in decimal minutes between the starting times of the two UV scans - ''ratio_l'': where l=2865, 2870, …, 3630: ratio of compared to reference irradiances at the l wavelength ==== Get uvrall ==== * Function: uvrall * Description: This function lists the start dates of the operative UV configurations available in EUBREWNET. * Example: http://eubrewnet.aemet.es/eubrewnet/data/get/uvrall?brewerid=185&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]] - ''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_doy'': same as above, but in JJJYY format, where JJJ is the day number of the year - ''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://eubrewnet.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/m2/nm ==== Get UVL0 ==== * Function: UVL0 * Description: return the raw counts measured by the Brewer. * Example: http://eubrewnet.aemet.es/eubrewnet/data/get/uvl0?brewerid=150&date=2021-08-03&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] - ''time'': see [[codes:uvaccess#input|Time in UV-specific inputs]] - ''endtime'': see [[codes:uvaccess#input|Endtime in UV-specific inputs]] - ''scan'': optional, use to select an scan type (''ux'', ''ua'' , or ''uv'') - ''format'': see [[codes:dbaccess#format|Format]] and [[codes:uvaccess#formats|UV format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] - ''means'': see [[codes:dbaccess#means|means]] * Output: the following UV-specific fields are included in the standard output alongside the other usual ones (Brewer ID, latitude, pressure, ...): - ''scan'': type of UV scan performed (uv, ux, ua, ...) - ''counts_l'', where l=2865, 2870, ..., 3630: raw counts at the l wavelength - ''mmmm_l'': decimal minute from 00:00 at which the measurement at the l wavelength started - ''micrometer_l'': micrometer position at which the measurement at the l wavelength was performed ==== Get UVL1 ==== * Function: UVL1 * Description: converts the raw counts measured by the Brewer to irradiances (in W/m2/nm) using the operative UV response. An operative UV configuration with the [[devel:eubrewnetconfiguration&#uv_response | UV response]] must be available for the requested period. * Example: https://eubrewnet.aemet.es/eubrewnet/data/get/UVL1?brewerid=185&date=2021-10-13&enddate=2021-10-15&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] - ''time'': see [[codes:uvaccess#input|Time in UV-specific inputs]] - ''endtime'': see [[codes:uvaccess#input|Endtime in UV-specific inputs]] - ''scan'': optional, use to select an scan type (''ux'', ''ua'' , or ''uv'') - ''format'': see [[codes:dbaccess#format|Format]] and [[codes:uvaccess#formats|UV format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] - ''means'': see [[codes:dbaccess#means|means]] * Output: the following UV-specific fields are included in the standard output alongside the other usual ones (Brewer ID, config_date, config_id, pressure, ...): - ''mmmm'': decimal minutes from 00:00 to the start of the UV scan - ''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 - ''mmmm_l'': decimal minute from 00:00 at which the measurement at the l wavelength started - ''duv'' and ''duv_cost'': erythema-weighted UV irradiances, using the same method as in the standard Brewer software, and the method proposed during COST Action ES1207 (EUBREWNET) - ''uvi'' and ''uvi_cost'': UV indexes calculated as ''duv''/25 and ''duv_cost''/25 - ''correction_flag'': flag with the corrections applied. In the level 1 UV product, only the straylight correction for non MK III Brewers is applied. For the complete list of corrections and their flag values see [[codes:uvaccess#uv_corrections_flag | here]] ==== Get 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. 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://eubrewnet.aemet.es/eubrewnet/data/get/UVL1_5?brewerid=185&date=2021-10-14 * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] - ''time'': see [[codes:uvaccess#input|Time in UV-specific inputs]] - ''endtime'': see [[codes:uvaccess#input|Endtime in UV-specific inputs]] - ''scan'': optional, use to select an scan type (''ux'', ''ua'' , or ''uv'') - ''format'': see [[codes:dbaccess#format|Format]] and [[codes:uvaccess#formats|UV format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] - ''means'': see [[codes:dbaccess#means|means]] * Output: the following UV-specific fields are included in the standard output alongside the other usual ones (Brewer ID, config_date, config_id, pressure, ...): - ''mmmm'': decimal minutes from 00:00 to the start of the UV scan - ''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 - ''mmmm_l'': decimal minute from 00:00 at which the measurement at the l wavelength started - ''duv'' and ''duv_cost'': erythema-weighted UV irradiances, using the same method as in the standard Brewer software, and the method proposed during COST Action ES1207 (EUBREWNET) - ''uvi'' and ''uvi_cost'': UV indexes calculated as ''duv''/25 and ''duv_cost''/25, respectively - ''correction_flag'': binary flag with the corrections applied. In the level 1.5 UV product, the spike and temperature correction may be applied. For the complete list of corrections and their flag values see [[codes:uvaccess#uv_corrections_flag | here]] ==== Get UVL1_6 ==== * Function: UVL1_6 * Description: Starting from the level 1.5 UV product, the cosine correction is applied to the irradiances.The cosine correction is calculated using the BUVIC (Brewer UV Irradiance Calculation) code, developed by J. Gröbner and B. Maret at the PMOD/WRC in 2020, and available at https://github.com/pec0ra/buvic. An operative UV configuration with the [[devel:eubrewnetconfiguration&#cosine_correction | Cosine correction data]] must be available for the requested period, otherwise level 1.5 data is returned. As in the case of level 1.5, output data is further filtered by the [[devel:eubrewnetconfiguration&#exclusion_list | UV Exclusion List]] * Example: https://eubrewnet.aemet.es/eubrewnet/data/get/UVL1_6?brewerid=185&date=2021-10-14&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] - ''scan'': optional, use to select an scan type (''ux'', ''ua'' , or ''uv'') - ''format'': see [[codes:dbaccess#format|Format]] and [[codes:uvaccess#formats|UV format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] - ''means'': see [[codes:dbaccess#means|means]] * Output: the following UV-specific fields are included in the standard output alongside the other usual ones (Brewer ID, config_date, config_id, pressure, ...): - ''mmmm'': decimal minutes from 00:00 to the start of the UV scan - ''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 - ''mmmm_l'': decimal minute from 00:00 at which the measurement at the l wavelength started - ''duv'' and ''duv_cost'': erythema-weighted UV irradiances, using the same method as in the standard Brewer software, and the method proposed during COST Action ES1207 (EUBREWNET) - ''uvi'' and ''uvi_cost'': UV indexes calculated as ''duv''/25 and ''duv_cost''/25, respectively - ''correction_flag'': binary flag with the corrections applied. In the level 2 UV product, either a clear sky or a diffuse cosine correction may be applied. For the complete list of corrections and their flag values see [[codes:uvaccess#uv_corrections_flag | here]] ==== Get UVL2 ==== * Function: UVL2 * Description: Starting from the level 1.6 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)]]. Shift-corrected irradiances are calculated using the [[devel:eubrewnetconfiguration&#slit_function|slit function defined in the operative UV configuration]]. 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.6, output data is further filtered by the [[devel:eubrewnetconfiguration&#exclusion_list | UV Exclusion List]] * Example: https://eubrewnet.aemet.es/eubrewnet/data/get/UVL2?brewerid=185&date=2021-10-14&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] - ''time'': see [[codes:uvaccess#input|Time in UV-specific inputs]] - ''endtime'': see [[codes:uvaccess#input|Endtime in UV-specific inputs]] - ''scan'': optional, use to select an scan type (''ux'', ''ua'' , or ''uv'') - ''format'': see [[codes:dbaccess#format|Format]] and [[codes:uvaccess#formats|UV format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] - ''means'': see [[codes:dbaccess#means|means]] * Output: the following UV-specific fields are included in the standard output alongside the other usual ones (Brewer ID, config_date, config_id, pressure, ...): - ''mmmm'': decimal minutes from 00:00 to the start of the UV scan - ''scan'': type of UV scan performed (uv, ux, ua, ...) - ''irr_l'', where l=2865, 2870, ..., 3630: shift-corrected irradiance for the Brewer slit function at the l wavelength, in W/m2/nm. Corresponds to the ''Irr instr'' output of SHICRIVM. - ''irr_st_l'', where l=2865, 2870, ..., 3630: shift-corrected irradiance for a standard triangular slit function at the l wavelength, in W/m2/nm. Corresponds to the ''Irr st'' output of SHICRIVM. - ''shift_l'': wavelength shifts calculated by SHICRIVM - ''mmmm_l'': decimal minute from 00:00 at which the measurement at the l wavelength started - ''duv'' and ''duv_cost'': erythema-weighted UV irradiances, using the same method as in the standard Brewer software, and the method proposed during COST Action ES1207 (EUBREWNET) - ''uvi'' and ''uvi_cost'': UV indexes calculated as ''duv''/25 and ''duv_cost''/25, respectively - ''correction_flag'': binary flag with the corrections applied. For the complete list of corrections and their flag values see [[codes:uvaccess#uv_corrections_flag | here]] ---- ===== PROCESS FUNCTIONS ===== ^ Function ^ Description ^ Help ^ Example ^ ^ UVL1 | Returns Level 1 UV | [[codes:uvaccess#process_uvl1|UVL1]] | [[https://eubrewnet.aemet.es/eubrewnet/data/process/UVL1?brewerid=185&date=2021-09-15&enddate=2021-09-16&format=text|Process UVL1]] | ^ UVL1_5 | Returns Level 1.5 UV | [[codes:uvaccess#process_uvl1_5|UVL1_5]] | [[https://eubrewnet.aemet.es/eubrewnet/data/process/UVL1_5?brewerid=185&date=2021-09-15&enddate=2021-09-16&format=text|Process UVL1_5]] | ^ UVL1_6 | Returns Level 1.6 UV | [[codes:uvaccess#process_uvl1_6|UVL1_6]] | [[https://eubrewnet.aemet.es/eubrewnet/data/process/UVL1_6?brewerid=185&date=2021-09-15&format=text|Process UVL1_6]] | ^ UVL2 | Returns Level 2 UV | [[codes:uvaccess#process_uvl2|UVL2]] | [[https://eubrewnet.aemet.es/eubrewnet/data/process/UVL2?brewerid=185&date=2021-09-15&enddate=2021-09-16&format=text|Process UVL2]] | ==== UV Corrections Flag ==== The following table shows the complete list of UV-specific corrections and their flag values. The final flag value corresponds to the sum of all the individual flag values applied. ^ Flag name ^ Flag value ^ Description ^ | FLAG_UV_STRAYLIGHT_COR | 1 | Straylight correction for non MK III Brewers has been applied in UVL1 | | FLAG_UV_SPIKES_COR | 2 | Spike correction has been applied in UVL1_5 | | FLAG_UV_TEMPERATURE_COR | 4 | Temperature correction has been applied in UVL1_5 | | FLAG_UV_COSINE_CLEARSKY_COR | 8 | Cosine correction in clear-sky conditions has been applied in UVL1_6 | | FLAG_UV_COSINE_DIFFUSE_COR | 16 | Cosine correction in cloudy conditions has been applied in UVL1_6 | | FLAG_UV_SHICRIVM_INSTR | 32 | Instrumental irradiances calculated with SHICRIVM in UVL2 | ==== UV Filter Flag ==== The following table shows the complete list of UV-specific data filters and their flag values. The final flag value corresponds to the sum of all the individual flag values applied. ^ Flag name ^ Flag value ^ Description ^ | FLAG_UV_SHICRIVM_BLACK_GREY_RED | 16 | Observation flagged as black, grey or red by SHICRIVM in UVL2 | | FLAG_UV_BLACKLIST | 32 | Observation date and time is affected by the [[devel:eubrewnetconfiguration#exclusion_list | UV exclusion list]] and has been removed from UVL1.5, UVL1.6, and UVL2 products | ==== Process UVL1 ==== * Function: UVL1 * Description: converts the raw counts measured by the Brewer to irradiances (in W/m2/nm) using the operative UV response. An operative UV configuration with the [[devel:eubrewnetconfiguration&#uv_response | UV response]] must be available for the requested period. * Example: https://eubrewnet.aemet.es/eubrewnet/data/process/UVL1?brewerid=185&date=2021-09-15&enddate=2021-09-16&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] - ''time'': see [[codes:uvaccess#input|Time in UV-specific inputs]] - ''endtime'': see [[codes:uvaccess#input|Endtime in UV-specific inputs]] - ''scan'': optional, use to select an scan type (''ux'', ''ua'' , or ''uv'') - ''format'': see [[codes:dbaccess#format|Format]] and [[codes:uvaccess#formats|UV format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] - ''means'': see [[codes:dbaccess#means|means]] * Output: the following UV-specific fields are included in the standard output alongside the other usual ones (Brewer ID, config_date, config_id, pressure, ...): - ''mmmm'': decimal minutes from 00:00 to the start of the UV scan - ''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 - ''mmmm_l'': decimal minute from 00:00 at which the measurement at the l wavelength started - ''duv'' and ''duv_cost'': erythema-weighted UV irradiances, using the same method as in the standard Brewer software, and the method proposed during COST Action ES1207 (EUBREWNET) - ''uvi'' and ''uvi_cost'': UV indexes calculated as ''duv''/25 and ''duv_cost''/25 - ''correction_flag'': flag with the corrections applied. In the level 1 UV product, only the straylight correction for non MK III Brewers is applied. For the complete list of corrections and their flag values see [[codes:uvaccess#uv_corrections_flag | here]] * Debug output: if the ''debug'' argument is passed in the URL, this function additionally returns the following fields: - ''count_l0_l'': raw counts at wavelength l - ''straylight_corr'': straylight correction applied to non-MKIII Brewers ==== Process 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. 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://eubrewnet.aemet.es/eubrewnet/data/process/UVL1_5?brewerid=185&date=2021-09-15&enddate=2021-09-16&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] - ''time'': see [[codes:uvaccess#input|Time in UV-specific inputs]] - ''endtime'': see [[codes:uvaccess#input|Endtime in UV-specific inputs]] - ''scan'': optional, use to select an scan type (''ux'', ''ua'' , or ''uv'') - ''format'': see [[codes:dbaccess#format|Format]] and [[codes:uvaccess#formats|UV format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] - ''means'': see [[codes:dbaccess#means|means]] * Output: the following UV-specific fields are included in the standard output alongside the other usual ones (Brewer ID, config_date, config_id, pressure, ...): - ''mmmm'': decimal minutes from 00:00 to the start of the UV scan - ''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 - ''mmmm_l'': decimal minute from 00:00 at which the measurement at the l wavelength started - ''duv'' and ''duv_cost'': erythema-weighted UV irradiances, using the same method as in the standard Brewer software, and the method proposed during COST Action ES1207 (EUBREWNET) - ''uvi'' and ''uvi_cost'': UV indexes calculated as ''duv''/25 and ''duv_cost''/25, respectively - ''correction_flag'': binary flag with the corrections applied. In the level 1.5 UV product, the spike and temperature correction may be applied. For the complete list of corrections and their flag values see [[codes:uvaccess#uv_corrections_flag | here]] * Debug output: if the ''debug'' argument is passed in the URL, this function additionally returns the following fields: - ''irr_l1_l'': l1 irradiance at wavelength l - ''wl_with_spikes'': wavelengths in which spikes have been detected and corrected * Rejected output: if the ''rejected'' argument is passed in the URL, UVL1_5 also returns the observations inside the [[devel:eubrewnetconfiguration#exclusion_list | UV exclusion list]], and aditionally returns the field: - ''filter_flag'': [[codes:uvaccess#uv_filter_flag |filter flag]] for each observation ==== Process UVL1_6 ==== * Function: UVL1_6 * Description: Starting from the level 1.5 UV product, the cosine correction is applied to the irradiances.The cosine correction is calculated using the BUVIC (Brewer UV Irradiance Calculation) code, developed by J. Gröbner and B. Maret at the PMOD/WRC in 2020, and available at https://github.com/pec0ra/buvic. An operative UV configuration with the [[devel:eubrewnetconfiguration&#cosine_correction | Cosine correction data]] must be available for the requested period, otherwise level 1.5 data is returned. As in the case of level 1.5, output data is further filtered by the [[devel:eubrewnetconfiguration&#exclusion_list | UV Exclusion List]] * Example: https://eubrewnet.aemet.es/eubrewnet/data/process/UVL1_6?brewerid=185&date=2021-09-15&enddate=2021-09-16&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] - ''scan'': optional, use to select an scan type (''ux'', ''ua'' , or ''uv'') - ''format'': see [[codes:dbaccess#format|Format]] and [[codes:uvaccess#formats|UV format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] - ''means'': see [[codes:dbaccess#means|means]] * Output: the following UV-specific fields are included in the standard output alongside the other usual ones (Brewer ID, config_date, config_id, pressure, ...): - ''mmmm'': decimal minutes from 00:00 to the start of the UV scan - ''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 - ''mmmm_l'': decimal minute from 00:00 at which the measurement at the l wavelength started - ''duv'' and ''duv_cost'': erythema-weighted UV irradiances, using the same method as in the standard Brewer software, and the method proposed during COST Action ES1207 (EUBREWNET) - ''uvi'' and ''uvi_cost'': UV indexes calculated as ''duv''/25 and ''duv_cost''/25, respectively - ''correction_flag'': binary flag with the corrections applied. In the level 2 UV product, either a clear sky or a diffuse cosine correction may be applied. For the complete list of corrections and their flag values see [[codes:uvaccess#uv_corrections_flag | here]] * Debug output: if the ''debug'' argument is passed in the URL, this function additionally returns the following fields: - ''irr_l15_l'': L1.5 irradiance at wavelength l - ''o3'': ozone value used by BUVIC - ''alpha'': Angström's alpha used by BUVIC - ''beta'': Angström's beta used by BUVIC - ''albedo'': albedo vallue used by BUVIC - ''cos_corr'': type of cosine correction, either ''diffuse'' or ''clear_sky'' ==== Process UVL2 ==== * Function: UVL2 * Description: Starting from the level 1.6 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)]]. Shift-corrected irradiances are calculated using the [[devel:eubrewnetconfiguration&#slit_function|slit function defined in the operative UV configuration]]. 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.6, output data is further filtered by the [[devel:eubrewnetconfiguration&#exclusion_list | UV Exclusion List]] * Example: https://eubrewnet.aemet.es/eubrewnet/data/process/UVL2?brewerid=185&date=2021-09-15&format=text * Input: - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] - ''time'': see [[codes:uvaccess#input|Time in UV-specific inputs]] - ''endtime'': see [[codes:uvaccess#input|Endtime in UV-specific inputs]] - ''scan'': optional, use to select an scan type (''ux'', ''ua'' , or ''uv'') - ''format'': see [[codes:dbaccess#format|Format]] and [[codes:uvaccess#formats|UV format]] - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] - ''means'': see [[codes:dbaccess#means|means]] * Output: the following UV-specific fields are included in the standard output alongside the other usual ones (Brewer ID, config_date, config_id, pressure, ...): - ''mmmm'': decimal minutes from 00:00 to the start of the UV scan - ''scan'': type of UV scan performed (uv, ux, ua, ...) - ''irr_l'', where l=2865, 2870, ..., 3630: shift-corrected irradiance for the Brewer slit function at the l wavelength, in W/m2/nm. Corresponds to the ''Irr instr'' output of SHICRIVM. - ''irr_st_l'', where l=2865, 2870, ..., 3630: shift-corrected irradiance for a standard triangular slit function at the l wavelength, in W/m2/nm. Corresponds to the ''Irr st'' output of SHICRIVM. - ''shift_l'': wavelength shifts calculated by SHICRIVM - ''mmmm_l'': decimal minute from 00:00 at which the measurement at the l wavelength started - ''duv'' and ''duv_cost'': erythema-weighted UV irradiances, using the same method as in the standard Brewer software, and the method proposed during COST Action ES1207 (EUBREWNET) - ''uvi'' and ''uvi_cost'': UV indexes calculated as ''duv''/25 and ''duv_cost''/25, respectively - ''correction_flag'': binary flag with the corrections applied. For the complete list of corrections and their flag values see [[codes:uvaccess#uv_corrections_flag | here]] * Debug output: if the ''debug'' argument is passed in the URL, this function additionally returns the following fields: - ''irr_l16_l'': L1.6 irradiance at wavelength l - ''shicrivm_qaqc'': SHICRIVM's QA/QC flag colors * Rejected output: if the ''rejected'' argument is passed in the URL, UVL2 also returns the observations flagged as black, grey, or red by SHICRIVM, and aditionally returns the field: - ''filter_flag'': [[codes:uvaccess#uv_filter_flag |filter flag]] for each observation ----