Eubrewnet Wiki

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 ozone access functions

See this presentation for a short overview of the UV configuration and processing levels.

Besides the formats described here, two further values can be passed in the URL to the format argument:

Beside the input options described in common_inputs, selected UV functions also support:

• Function: uvscans
• Description: This function lists the UV scans available in Eubrewnet for a specific Brewer and date range
• Example: https://rbcce.aemet.es/eubrewnet/data/get/uvscans?brewerid=157&date=2022-03-09&format=text
• Input:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. format: see Format
  5. fields: see Fields in common inputs
  6. 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:
  1. scan: type of UV-scan (ua, ux, uv)
  2. mmmm: decimal minutes from 00:00 to the start of the UV scan

• Function: compareuvtimes
• Description: This function lists the UV scans available in Eubrewnet in a date range, for two input Brewers.
• Example: https://rbcce.aemet.es/eubrewnet/data/get/compareuvtimes?brewerid=157&compid=183&date=2022-03-07&format=text
• Input:
  1. brewerid: this is the ID of the reference Brewer. This follows the format described in Brewerid in common inputs
  2. compid: this is the ID of the Brewer which is being compared to the reference Brewer
  3. date: see Date in common inputs
  4. enddate: see Enddate in common inputs
  5. format: see Format
  6. fields: see Fields in common inputs
  7. scans: a comma-separated list of UV scan types to list. If ommited, defaults to ux,ua,uv
  8. 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:
  1. scan and compscan: type of UV-scan (ua, ux, uv) of the two Brewers
  2. mmmm and compmmmm: decimal minutes from 00:00 to the start of the UV scan for the two Brewers
  3. deltaminutes: diference in decimal minutes between the starting times of the two UV scans

• Function: compareuv
• Description: This function lists the irradiance ratios in a date range, for two input Brewers.
• Example: https://rbcce.aemet.es/eubrewnet/data/get/compareuv?brewerid=157&compid=183&date=2022-03-07&maxminutes=0.5&format=text
• Input:
  1. brewerid: ID of the reference Brewer. This follows the format described in Brewerid in common inputs
  2. compid: ID of the Brewer which is being compared to the reference Brewer
  3. date: see Date in common inputs
  4. enddate: see Enddate in common inputs
  5. format: see Format
  6. fields: see Fields in common inputs
  7. scans: a comma-separated list of UV scan types to list. If ommited, defaults to ux,ua,uv
  8. maxminutes: maximum difference between the scans of the two Brewers. If omitted, it defaults to 5 minutes
  9. 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:
  1. scan and compscan: type of UV-scan (ua, ux, uv) of the two Brewers
  2. mmmm and compmmmm: decimal minutes from 00:00 to the start of the UV scan for the two Brewers
  3. deltaminutes: diference in decimal minutes between the starting times of the two UV scans
  4. ratio_l: where l=2865, 2870, …, 3630: ratio of compared to reference irradiances at the l wavelength

• Function: uvrall
• Description: This function lists the start dates of the operative UV configurations available in EUBREWNET.
• Example: http://rbcce.aemet.es/eubrewnet/data/get/uvrall?brewerid=185&format=text
• Input:
  1. brewerid: this is the ID of the reference Brewer. This follows the format described in Brewerid in common inputs
  2. format: see Format
  3. fields: see Fields in common inputs
• Output: besides the usual output, the following UV-specific fields are provided:
  1. config_date: date at which the configuration becomes operative, in YYYYMMDD
  2. config_doy: same as above, but in JJJYY format, where JJJ is the day number of the year
  3. config_id: ID internally used by EUBREWNET to identify the configuration

• 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:
  1. brewerid: this is the ID of the reference Brewer. This follows the format described in Brewerid in common inputs
  2. date: date in YYYY-MM-DD format
  3. format: see Format
  4. fields: see Fields in common inputs
• Output: besides the usual output, the following UV-specific fields are provided:
  1. config_date: date at which the configuration becomes operative, in YYYYMMDD
  2. config_id: ID internally used by EUBREWNET to identify the configuration
  3. wavelength: wavelength in Angstroms
  4. responsivity : responsivity in counts/mW/m²/nm

• Function: UVL0
• Description: return the raw counts measured by the Brewer.
• Example: http://rbcce.aemet.es/eubrewnet/data/get/uvl0?brewerid=150&date=2021-08-03&format=text
• Input:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. time: see Time in UV-specific inputs
  5. endtime: see Endtime in UV-specific inputs
  6. scan: optional, use to select an scan type (ux, ua , or uv)
  7. format: see Format and UV format
  8. fields: see Fields in common inputs
  9. means: see means
• Output: the following UV-specific fields are included in the standard output alongside the other usual ones (Brewer ID, latitude, pressure, …):
  1. scan: type of UV scan performed (uv, ux, ua, …)
  2. counts_l, where l=2865, 2870, …, 3630: raw counts at the l wavelength
  3. mmmm_l: decimal minute from 00:00 at which the measurement at the l wavelength started
  4. micrometer_l: micrometer position at which the measurement at the l wavelength was performed

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.

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.

• 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 UV response must be available for the requested period.
• Example: https://rbcce.aemet.es/eubrewnet/data/process/UVL1?brewerid=185&date=2021-09-15&enddate=2021-09-16&format=text
• Input:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. time: see Time in UV-specific inputs
  5. endtime: see Endtime in UV-specific inputs
  6. scan: optional, use to select an scan type (ux, ua , or uv)
  7. format: see Format and UV format
  8. fields: see Fields in common inputs
  9. means: see 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, …):
  1. mmmm: decimal minutes from 00:00 to the start of the UV scan
  2. scan: type of UV scan performed (uv, ux, ua, …)
  3. irr_l, where l=2865, 2870, …, 3630: irradiance at the l wavelength, in W/m2/nm
  4. mmmm_l: decimal minute from 00:00 at which the measurement at the l wavelength started
  5. 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)
  6. uvi and uvi_cost: UV indexes calculated as duv/25 and duv_cost/25
  7. 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 here
• Debug output: if the debug argument is passed in the URL, this function additionally returns the following fields:
  1. count_l0_l: raw counts at wavelength l
  2. straylight_corr: straylight correction applied to non-MKIII Brewers

• 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 Temperature correction coefficients must be available for the requested period. Output data is further filtered by the 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
• Input:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. time: see Time in UV-specific inputs
  5. endtime: see Endtime in UV-specific inputs
  6. scan: optional, use to select an scan type (ux, ua , or uv)
  7. format: see Format and UV format
  8. fields: see Fields in common inputs
  9. means: see 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, …):
  1. mmmm: decimal minutes from 00:00 to the start of the UV scan
  2. scan: type of UV scan performed (uv, ux, ua, …)
  3. irr_l, where l=2865, 2870, …, 3630: irradiance at the l wavelength, in W/m2/nm
  4. mmmm_l: decimal minute from 00:00 at which the measurement at the l wavelength started
  5. 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)
  6. uvi and uvi_cost: UV indexes calculated as duv/25 and duv_cost/25, respectively
  7. 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 here
• Debug output: if the debug argument is passed in the URL, this function additionally returns the following fields:
  1. irr_l1_l: l1 irradiance at wavelength l
  2. 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 UV exclusion list, and aditionally returns the field:
  1. filter_flag: filter flag for each observation

• Function: UVL1_6
• Description: Starting from the level 1.5 UV product, process the data using the SHICRIVM code developed by Harry Slaper at the National Institute of Public Health and the Environment (RIVM). Shift-corrected irradiances are calculated using the http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#slit_function. 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 UV Exclusion List
• Example: https://rbcce.aemet.es/eubrewnet/data/process/UVL1_6?brewerid=185&date=2021-09-15&format=text
• Input:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. time: see Time in UV-specific inputs
  5. endtime: see Endtime in UV-specific inputs
  6. scan: optional, use to select an scan type (ux, ua , or uv)
  7. format: see Format and UV format
  8. fields: see Fields in common inputs
  9. means: see 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, …):
  1. mmmm: decimal minutes from 00:00 to the start of the UV scan
  2. scan: type of UV scan performed (uv, ux, ua, …)
  3. 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.
  4. shift_l: wavelength shifts calculated by SHICRIVM
  5. mmmm_l: decimal minute from 00:00 at which the measurement at the l wavelength started
  6. 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)
  7. uvi and uvi_cost: UV indexes calculated as duv/25 and duv_cost/25, respectively
  8. correction_flag: binary flag with the corrections applied. For the complete list of corrections and their flag values see here
• Debug output: if the debug argument is passed in the URL, this function additionally returns the following fields:
  1. irr_l15_l: L1.5 irradiance at wavelength l
  2. shicrivm_qaqc: SHICRIVM's QA/QC flag colors
• Rejected output: if the rejected argument is passed in the URL, UVL1_6 also returns the observations flagged as black, grey, or red by SHICRIVM, and aditionally returns the field:
  1. filter_flag: filter flag for each observation

• Function: UVL2
• Description: Starting from the level 1.6 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 Cosine correction data must be available for the requested period. As in the case of level 1.6, output data is further filtered by the UV Exclusion List
• Example: https://rbcce.aemet.es/eubrewnet/data/process/UVL2?brewerid=185&date=2021-09-15&enddate=2021-09-16&format=text
• Input:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. scan: optional, use to select an scan type (ux, ua , or uv)
  5. format: see Format and UV format
  6. fields: see Fields in common inputs
  7. means: see 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, …):
  1. mmmm: decimal minutes from 00:00 to the start of the UV scan
  2. scan: type of UV scan performed (uv, ux, ua, …)
  3. irr_l, where l=2865, 2870, …, 3630: irradiance at the l wavelength, in W/m2/nm
  4. mmmm_l: decimal minute from 00:00 at which the measurement at the l wavelength started
  5. 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)
  6. uvi and uvi_cost: UV indexes calculated as duv/25 and duv_cost/25, respectively
  7. 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 here
• Debug output: if the debug argument is passed in the URL, this function additionally returns the following fields:
  1. irr_l16_l: L1.6 irradiance at wavelength l
  2. o3: ozone value used by BUVIC
  3. alpha: Angström's alpha used by BUVIC
  4. beta: Angström's beta used by BUVIC
  5. albedo: albedo vallue used by BUVIC
  6. cos_corr: type of cosine correction, either diffuse or clear_sky