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 poster for a short overview of the UV processing levels.
See 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.
Besides the formats described 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 | 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 | jsona example |
Beside the input options described in 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 | 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 | Process UV scans starting after 11:00:00 and ending before 15:30:00 |
Function | Description | Help | Example |
---|---|---|---|
uvscans | Return available UV scans | uvscans | Get uvscans |
compareuvtimes | For two brewers, return the scans starting within some time delta | compareuvtimes | Get compareuvtimes |
compareuv | For two brewers, compare the irradiances for the scans starting within some time delta | compareuv | Get compareuv |
uvrall | return the start dates of all the operative configurations available in EUBREWNET for a specific Brewer | uvrall | Get uvrall |
uvrbydate | return the UVR operative in EUBREWNET for a specific Brewer and date | uvrbydate | Get uvrbydate |
UVL0 | return the raw counts measured by the Brewer | UVL | Get UVL0 |
UVL1 | Returns Level 1 UV | UVL1 | Get UVL1 |
UVL1_5 | Returns Level 1.5 UV | UVL1_5 | Get UVL1_5 |
UVL1_6 | Returns Level 1.6 UV | UVL1_6 | Get UVL1_6 |
UVL2 | Returns Level 2 UV | UVL2 | Get UVL2 |
brewerid
: see Brewerid in common inputsdate
: see Date in common inputsformat
: see Formatfields
: see Fields in common inputswavelength
: wavelength in Angstromsresponsivity
: responsivity in counts/mW/m2/nmbrewerid
: see Brewerid in common inputsdate
: see Date in common inputsformat
: see Formatfields
: see Fields in common inputswavel_diff
: difference from the central wavelengthnorm_counts
: counts normalized to the central peakbrewerid
: see Brewerid in common inputsdate
: see Date in common inputsformat
: see Formatfields
: see Fields in common inputssza
: zenith angleang_resp_1
: angular response normalized to angle 0. Note only ang_resp_1 is used by the BUVIC calculationbrewerid
: see Brewerid in common inputsdate
: see Date in common inputsformat
: see Formatfields
: see Fields in common inputsalbedo
: UV surface albedoalpha
: Angstrom's alphabeta
: Angstrom's betacloud
: Cloud coverbrewerid
: see Brewerid in common inputsdate
: see Date in common inputsformat
: see Formatfields
: see Fields in common inputswavelength
: wavelength in Angstromstempdep
: temperature dependencetempref
: reference temperaturebrewerid
: see Brewerid in common inputsdate
: see Date in common inputsenddate
: see Enddate in common inputsformat
: see Formatfields
: see Fields in common inputsscans
: a comma-separated list of UV scan types to list. If ommited, defaults to ux,ua,uv
scan
: type of UV-scan (ua, ux, uv)mmmm
: decimal minutes from 00:00 to the start of the UV scanbrewerid
: this is the ID of the reference Brewer. This follows the format described in Brewerid in common inputscompid
: this is the ID of the Brewer which is being compared to the reference Brewerdate
: see Date in common inputsenddate
: see Enddate in common inputsformat
: see Formatfields
: see Fields in common inputsscans
: 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 scan
and compscan
: type of UV-scan (ua, ux, uv) of the two Brewersmmmm
and compmmmm
: decimal minutes from 00:00 to the start of the UV scan for the two Brewersdeltaminutes
: diference in decimal minutes between the starting times of the two UV scansbrewerid
: ID of the reference Brewer. This follows the format described in Brewerid in common inputscompid
: ID of the Brewer which is being compared to the reference Brewerdate
: see Date in common inputsenddate
: see Enddate in common inputsformat
: see Formatfields
: see Fields in common inputsscans
: 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 1scan
and compscan
: type of UV-scan (ua, ux, uv) of the two Brewersmmmm
and compmmmm
: decimal minutes from 00:00 to the start of the UV scan for the two Brewersdeltaminutes
: diference in decimal minutes between the starting times of the two UV scansratio_l
: where l=2865, 2870, …, 3630: ratio of compared to reference irradiances at the l wavelengthbrewerid
: this is the ID of the reference Brewer. This follows the format described in Brewerid in common inputsformat
: see Formatfields
: see Fields in common inputsconfig_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 yearconfig_id
: ID internally used by EUBREWNET to identify the configurationbrewerid
: this is the ID of the reference Brewer. This follows the format described in Brewerid in common inputsdate
: date in YYYY-MM-DD formatformat
: see Formatfields
: see Fields in common inputsconfig_date
: date at which the configuration becomes operative, in YYYYMMDD config_id
: ID internally used by EUBREWNET to identify the configurationwavelength
: wavelength in Angstromsresponsivity
: responsivity in counts/mW/m2/nmbrewerid
: see Brewerid in common inputsdate
: see Date in common inputsenddate
: see Enddate in common inputstime
: see Time in UV-specific inputsendtime
: see Endtime in UV-specific inputsscan
: optional, use to select an scan type (ux
, ua
, or uv
)fields
: see Fields in common inputsmeans
: see meansscan
: type of UV scan performed (uv, ux, ua, …)counts_l
, where l=2865, 2870, …, 3630: raw counts at the l wavelengthmmmm_l
: decimal minute from 00:00 at which the measurement at the l wavelength startedmicrometer_l
: micrometer position at which the measurement at the l wavelength was performedbrewerid
: see Brewerid in common inputsdate
: see Date in common inputsenddate
: see Enddate in common inputstime
: see Time in UV-specific inputsendtime
: see Endtime in UV-specific inputsscan
: optional, use to select an scan type (ux
, ua
, or uv
)fields
: see Fields in common inputsmeans
: see meansmmmm
: decimal minutes from 00:00 to the start of the UV scanscan
: type of UV scan performed (uv, ux, ua, …)irr_l
, where l=2865, 2870, …, 3630: irradiance at the l wavelength, in W/m2/nmmmmm_l
: decimal minute from 00:00 at which the measurement at the l wavelength startedduv
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
/25correction_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 herebrewerid
: see Brewerid in common inputsdate
: see Date in common inputsenddate
: see Enddate in common inputstime
: see Time in UV-specific inputsendtime
: see Endtime in UV-specific inputsscan
: optional, use to select an scan type (ux
, ua
, or uv
)fields
: see Fields in common inputsmeans
: see meansmmmm
: decimal minutes from 00:00 to the start of the UV scanscan
: type of UV scan performed (uv, ux, ua, …)irr_l
, where l=2865, 2870, …, 3630: irradiance at the l wavelength, in W/m2/nmmmmm_l
: decimal minute from 00:00 at which the measurement at the l wavelength startedduv
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, respectivelycorrection_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 herebrewerid
: see Brewerid in common inputsdate
: see Date in common inputsenddate
: see Enddate in common inputsscan
: optional, use to select an scan type (ux
, ua
, or uv
)fields
: see Fields in common inputsmeans
: see meansmmmm
: decimal minutes from 00:00 to the start of the UV scanscan
: type of UV scan performed (uv, ux, ua, …)irr_l
, where l=2865, 2870, …, 3630: irradiance at the l wavelength, in W/m2/nmmmmm_l
: decimal minute from 00:00 at which the measurement at the l wavelength startedduv
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, respectivelycorrection_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 herebrewerid
: see Brewerid in common inputsdate
: see Date in common inputsenddate
: see Enddate in common inputstime
: see Time in UV-specific inputsendtime
: see Endtime in UV-specific inputsscan
: optional, use to select an scan type (ux
, ua
, or uv
)fields
: see Fields in common inputsmeans
: see meansmmmm
: decimal minutes from 00:00 to the start of the UV scanscan
: 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 SHICRIVMmmmm_l
: decimal minute from 00:00 at which the measurement at the l wavelength startedduv
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, respectivelycorrection_flag
: binary flag with the corrections applied. For the complete list of corrections and their flag values see hereFunction | Description | Help | Example |
---|---|---|---|
UVL1 | Returns Level 1 UV | UVL1 | Process UVL1 |
UVL1_5 | Returns Level 1.5 UV | UVL1_5 | Process UVL1_5 |
UVL1_6 | Returns Level 1.6 UV | UVL1_6 | Process UVL1_6 |
UVL2 | Returns Level 2 UV | UVL2 | Process UVL2 |
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 |
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 UV exclusion list and has been removed from UVL1.5, UVL1.6, and UVL2 products |
brewerid
: see Brewerid in common inputsdate
: see Date in common inputsenddate
: see Enddate in common inputstime
: see Time in UV-specific inputsendtime
: see Endtime in UV-specific inputsscan
: optional, use to select an scan type (ux
, ua
, or uv
)fields
: see Fields in common inputsmeans
: see meansmmmm
: decimal minutes from 00:00 to the start of the UV scanscan
: type of UV scan performed (uv, ux, ua, …)irr_l
, where l=2865, 2870, …, 3630: irradiance at the l wavelength, in W/m2/nmmmmm_l
: decimal minute from 00:00 at which the measurement at the l wavelength startedduv
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
/25correction_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 heredebug
argument is passed in the URL, this function additionally returns the following fields:count_l0_l
: raw counts at wavelength lstraylight_corr
: straylight correction applied to non-MKIII Brewersbrewerid
: see Brewerid in common inputsdate
: see Date in common inputsenddate
: see Enddate in common inputstime
: see Time in UV-specific inputsendtime
: see Endtime in UV-specific inputsscan
: optional, use to select an scan type (ux
, ua
, or uv
)fields
: see Fields in common inputsmeans
: see meansmmmm
: decimal minutes from 00:00 to the start of the UV scanscan
: type of UV scan performed (uv, ux, ua, …)irr_l
, where l=2865, 2870, …, 3630: irradiance at the l wavelength, in W/m2/nmmmmm_l
: decimal minute from 00:00 at which the measurement at the l wavelength startedduv
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, respectivelycorrection_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 heredebug
argument is passed in the URL, this function additionally returns the following fields:irr_l1_l
: l1 irradiance at wavelength lwl_with_spikes
: wavelengths in which spikes have been detected and correctedrejected
argument is passed in the URL, UVL1_5 also returns the observations inside the UV exclusion list, and aditionally returns the field:filter_flag
: filter flag for each observationbrewerid
: see Brewerid in common inputsdate
: see Date in common inputsenddate
: see Enddate in common inputsscan
: optional, use to select an scan type (ux
, ua
, or uv
)fields
: see Fields in common inputsmeans
: see meansmmmm
: decimal minutes from 00:00 to the start of the UV scanscan
: type of UV scan performed (uv, ux, ua, …)irr_l
, where l=2865, 2870, …, 3630: irradiance at the l wavelength, in W/m2/nmmmmm_l
: decimal minute from 00:00 at which the measurement at the l wavelength startedduv
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, respectivelycorrection_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 heredebug
argument is passed in the URL, this function additionally returns the following fields:irr_l15_l
: L1.5 irradiance at wavelength lo3
: ozone value used by BUVICalpha
: Angström's alpha used by BUVICbeta
: Angström's beta used by BUVICalbedo
: albedo vallue used by BUVICcos_corr
: type of cosine correction, either diffuse
or clear_sky
brewerid
: see Brewerid in common inputsdate
: see Date in common inputsenddate
: see Enddate in common inputstime
: see Time in UV-specific inputsendtime
: see Endtime in UV-specific inputsscan
: optional, use to select an scan type (ux
, ua
, or uv
)fields
: see Fields in common inputsmeans
: see meansmmmm
: decimal minutes from 00:00 to the start of the UV scanscan
: 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 SHICRIVMmmmm_l
: decimal minute from 00:00 at which the measurement at the l wavelength startedduv
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, respectivelycorrection_flag
: binary flag with the corrections applied. For the complete list of corrections and their flag values see heredebug
argument is passed in the URL, this function additionally returns the following fields:irr_l16_l
: L1.6 irradiance at wavelength lshicrivm_qaqc
: SHICRIVM's QA/QC flag colorsrejected
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
: filter flag for each observation