Table of Contents

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 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.


COMMON OPTIONS

Formats

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

Input

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

GET FUNCTIONS

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

Get uvrbydate

Get uvslitbydate

Get uvarfbydate

Get uvmeteoforadate

Get uvtempcorbydate

Get uvscans

Get compareuvtimes

Get compareuv

Get uvrall

Get uvrbydate

Get UVL0

Get UVL1

Get UVL1_5

Get UVL1_6

Get UVL2


PROCESS FUNCTIONS

Function 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

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 UV exclusion list and has been removed from UVL1.5, UVL1.6, and UVL2 products

Process UVL1

Process UVL1_5

Process UVL1_6

Process UVL2