User Tools

Site Tools


devel:eubrewnetconfiguration

Brewer Configuration constants

Configuration Upload

For a correct understanding of the Configuration Upload Interface, please take a look at the Configuration Upload Instructions – the behaviour of the form is described there.

Constants

List of constants that are included in the Configuration Set.

IdConstantTypeDescriptionSource
ICF O3Brewer Calibration Matrix ZSF DSF Filter
1 brewerid unsigned Brewer id: Instrument Number x x x
2 date date Date when the configuration takes value x x x
3 operative boolean Configuration which is going to be used in data processing
4 oslit1 double Ozone temperature coefficient for slit 1 x x x
5 oslit2 double Ozone temperature coefficient for slit 2 x x x
6 oslit3 double Ozone temperature coefficient for slit 3 x x x
7 oslit4 double Ozone temperature coefficient for slit 4 x x x
8 oslit5 double Ozone temperature coefficient for slit 5 x x x
9 mstep double Micrometer steps/deg x x
10 o3o3rate double O3 on O3 ratio x x x
11 so2o2rate double SO2 on SO2 ratio x x x
12 o3so2rate double O3 on SO2 ratio x x x
13 etco3rate double ETC on O3 ratio x x x
14 etcso2rate double ETC on SO2 ratio x x x
15 deadtime double Dead time (sec) x x x
16 wstepn integer Wavelength calibration step number x x
17 motordelay integer Slit mask motor delay x x
18 uoffset integer Umkehr Offset x x
19 nfilter0 integer Neutral density filter 0 x x x
20 nfilter1 integer Neutral density filter 1 x x x
21 nfilter2 integer Neutral density filter 2 x x x
22 nfilter3 integer Neutral density filter 3 x x x
23 nfilter4 integer Neutral density filter 4 x x x
24 nfilter5 integer Neutral density filter 5 x x x
25 zenithmotor integer Zenith motor steps per rev x x
26 brewer_model string Brewer model type x x
27 com_port integer COM Port number x x
28 o3tempcoef double O3 temperature coefficient for Mercury exit slit x x
29 sl_r5 double R5 Reference x x
30 sl_r6 double R6 Reference x x
31 etc_cor_f0 double ETC Correction for slit 0 x
32 etc_cor_f1 double ETC Correction for slit 1 x
33 etc_cor_f2 double ETC Correction for slit 2 x
34 etc_cor_f3 double ETC Correction for slit 3 x
35 etc_cor_f4 double ETC Correction for slit 4 x
36 etc_cor_f5 double ETC Correction for slit 5 x
37 o3micro1 integer O3 Mic #1 Offset x x
38 o3micro2 integer Mic # Offset x x
39 o3wheel3 integer O3 FW # Offset x x
40 etc_slit0 double ETC for slit 0 x
41 etc_slit2 double ETC for slit 2 x
42 etc_slit3 double ETC for slit 3 x
43 etc_slit4 double ETC for slit 4 x
44 etc_slit5 double ETC for slit 5 x
45 etc_slit6 double ETC for slit 6 x x
46 gslope double Grating slope x x
47 ginter double Grating Intercept x x
48 mzeropos integer Micrometer Zero x x
49 mopeniris integer Iris open steps x x
50 bufferdelay double Buffer delay (sec) x x
51 no2wpos double NO2 FW#1 Pos x x
52 o3wpos integer O3 FW#1 Pos x x
53 f2wpos integer FW#2 Pos x x
54 uvwpos integer uv FW#2 Pos x x
55 szenith integer Zenith Offset x x
56 zuvpos integer Zenith UVB Position x x
57 w_o3_0 double O3 weight for slit 0
58 w_o3_2 double O3 weight for slit 2
59 w_o3_3 double O3 weight for slit 3
60 w_o3_4 double O3 weight for slit 4
61 w_o3_5 double O3 weight for slit 5
62 w_o3_6 double O3 weight for slit 6
63 w_so2_0 double SO2 weigth for slit 0
64 w_so2_2 double SO2 weigth for slit 2
65 w_so2_3 double SO2 weigth for slit 3
66 w_so2_4 double SO2 weigth for slit 4
67 w_so2_5 double SO2 weigth for slit 5
68 w_so2_6 double SO2 weigth for slit 6
69 it double Integration Time x
70 be0 integer Rayleigh Coefficient for slit 0
71 be2 integer Rayleigh Coefficient for slit 2 x
72 be3 integer Rayleigh Coefficient for slit 3 x
73 be4 integer Rayleigh Coefficient for slit 4 x
74 be5 integer Rayleigh Coefficient for slit 5 x
75 be6 integer Rayleigh Coefficient for slit 6 x
76 o3ds integer Apply O3 DS Rejection criteria x
77 o3zs integer Apply O3 ZS Rejection criteria x
78 o3fz integer Apply O3 FZ Rejection criteria x
79 o3fm integer Apply O3 FM Rejection criteria x
80 no2ds integer Apply NO2 DS Rejection criteria x
81 no2zs integer Apply NO2 ZS Rejection criteria x
82 no2fm integer Apply NO2 FM Rejection criteria x
83 mu_ds integer Apply MU DS Rejection criteria x
84 mu_fz integer Apply MU FZ Rejection criteria x
85 mu_fm integer Apply MU FM Rejection criteria x
86 mu_no2 integer Apply MU NO2 Rejection criteria x
87 o3ds_maxstd double Maximum O3 DS Deviation x
88 o3zs_maxstd double Maximum O3 ZS Deviation x
89 o3fz_maxstd double Maximum O3 FZ Deviation x
90 o3fm_maxstd double Maximum O3 FM Deviation x
91 no2ds_maxstd double Maximum NO2 DS Deviation x
92 no2zs_maxstd double Maximum NO2 ZS Deviation x
93 no2fm_maxstd double Maximum NO2 FM Deviation x
94 mu_ds_value double Mu value for O3 DS, ZS x
95 mu_fz_value double Mu value for O3 FZ x
96 mu_fm_value double Mu value for O3 FM x
97 mu_no2_value double Mu value for NO2 x
98 recal_ds integer Apply Recalculate O3 DS, FM, FZ measures x
99 recal_zs integer Recalculate O3 ZS measures x
100 recal_no2ds integer Recalculate NO2 DS, FM measures x
101 recal_no2zs integer Recalculate NO2 ZS measures x
102 sl_recal_cor integer Recalculate SL and N2 SL tests x
103 sl_fit_cor integer Apply smoothing filter x
104 sl_o3_cor integer SL test O3 correction and recalculation x
105 sl_no2_cor integer SL test NO2 correction and recalculation x
106 wl_code integer Data Fields - Daily wl_code x
107 obs_code integer Data Fields - Daily obs_code x
108 column_o3 integer Data Fields - Daily o3 column x
109 stdev_o3 integer Data Fields - Daily o3 std dev x
110 utc_begin integer Data Fields - Daily utc begin x
111 utc_end integer Data Fields - Daily utc end x
112 utc_mean integer Data Fields - Daily utc mean x
113 n_obs integer Data Fields - Daily number of observations x
114 m_mu integer Data Fields - Daily mu x
115 column_so2 integer Data Fields - Daily so2 column x
116 zs_a double ZS A Coefficient of Polynomial x x
117 zs_b double ZS B Coefficient of Polynomial x x
118 zs_c double ZS c Coefficient of Polynomial x x
119 zs_d double ZS D Coefficient of Polynomial x x
120 zs_e double ZS E Coefficient of Polynomial x x
121 zs_f double ZS F Coefficient of Polynomial x x
122 zs_g double ZS G Coefficient of Polynomial x x
123 zs_h double ZS H Coefficient of Polynomial x x
124 zs_k double ZS K Coefficient of Polynomial x x
125 no2abcoef double NO2 absorption Coefficient x x
126 no2dsetc double NO2 DS ETC x x
127 no2zsetc double NO2 ZS ETC x x
128 no2slit1 double NO2 Temperature Coefficient for Slit 1 x x
129 no2slit2 double NO2 Temperature Coefficient for Slit 2 x x
130 no2slit3 double NO2 Temperature Coefficient for Slit 3 x x
131 nos2slit4 double NO2 Temperature Coefficient for Slit 4 x x
132 no2slit5 double NO2 Temperature Coefficient for Slit 5 x x
133 sl_no2 double Standard Lamp for NO2 x
134 country string Country x
135 agency string Agency Name x
136 name string Name of the Station x
137 gaw_id integer GAW Id of the Station x
138 authority string Scientific Authority x
139 version double Version of the O3Brewer software x
140 go3s integer GO3OS Number x
141 press double Pressure x
142 latitude double Latitude x
143 longitude double Longitude x
144 height double Height x
145 utc_offset string UTC offset x
146 gi_factor double GI calibration factor x
147 fs_slit0_nfilter1 integer Filter Spectral for slit 0 and filter 1 x
148 fs_slit0_nfilter2 integer Filter Spectral for slit 0 and filter 2 x
149 fs_slit0_nfilter3 integer Filter Spectral for slit 0 and filter 3 x
150 fs_slit0_nfilter4 integer Filter Spectral for slit 0 and filter 4 x
151 fs_slit0_nfilter5 integer Filter Spectral for slit 0 and filter 5 x
152 fs_slit1_nfilter1 integer Filter Spectral for slit 1 and filter 1 x
153 fs_slit1_nfilter2 integer Filter Spectral for slit 1 and filter 2 x
154 fs_slit1_nfilter3 integer Filter Spectral for slit 1 and filter 3 x
155 fs_slit1_nfilter4 integer Filter Spectral for slit 1 and filter 4 x
156 fs_slit1_nfilter5 integer Filter Spectral for slit 1 and filter 5 x
157 fs_slit2_nfilter1 integer Filter Spectral for slit 2 and filter 1 x
158 fs_slit2_nfilter2 integer Filter Spectral for slit 2 and filter 2 x
159 fs_slit2_nfilter3 integer Filter Spectral for slit 2 and filter 3 x
160 fs_slit2_nfilter4 integer Filter Spectral for slit 2 and filter 4 x
161 fs_slit2_nfilter5 integer Filter Spectral for slit 2 and filter 5 x
162 fs_slit3_nfilter1 integer Filter Spectral for slit 3 and filter 1 x
163 fs_slit3_nfilter2 integer Filter Spectral for slit 3 and filter 2 x
164 fs_slit3_nfilter3 integer Filter Spectral for slit 3 and filter 3 x
165 fs_slit3_nfilter4 integer Filter Spectral for slit 3 and filter 4 x
166 fs_slit3_nfilter5 integer Filter Spectral for slit 3 and filter 5 x
167 fs_slit4_nfilter1 integer Filter Spectral for slit 4 and filter 1 x
168 fs_slit4_nfilter2 integer Filter Spectral for slit 4 and filter 2 x
169 fs_slit4_nfilter3 integer Filter Spectral for slit 4 and filter 3 x
170 fs_slit4_nfilter4 integer Filter Spectral for slit 4 and filter 4 x
171 fs_slit4_nfilter5 integer Filter Spectral for slit 4 and filter 5 x
172 fs_slit5_nfilter1 integer Filter Spectral for slit 5 and filter 1 x
173 fs_slit5_nfilter2 integer Filter Spectral for slit 5 and filter 2 x
174 fs_slit5_nfilter3 integer Filter Spectral for slit 5 and filter 3 x
175 fs_slit5_nfilter4 integer Filter Spectral for slit 5 and filter 4 x
176 fs_slit5_nfilter5 integer Filter Spectral for slit 5 and filter 5 x
177 autohg integer whether or not HP/HG/FR/RE are done automatically as needed to recover and insert HP before HG for MKIII x
178 fw2oscil integer set to 0/1/-1 for going to LOWER/OSCILATE/HIGHER neutral density when testing intensity x
179 fw2poshg integer FW2 position for HG x
180 lowerslimit integer sets the upper limit for count rate at 1 cycle that is acceptable before switching to lower FW2 position. STANDARD is 25000 x
181 upperslimit integer sets the lower limit for count rate at 1 cycle that is acceptable before switching to higher FW2 position. STANDARD is 80000 x
182 cubicdsp integer whether or not to use cubic dispersion x
183 skipds integer if 1 then DS will be skipped if less than 500 counts measured in 1 cycle at ND = 0 x
184 sza_limit double Maximum Solar Zenith angle for filtering in case of single Brewers
185 stray_light_a double Straylight non linear parameters. Formula A(OSC)B+C
186 stray_light_b double Straylight non linear parameters. Formula A(OSC)B+C
187 stray_light_c double Straylight non linear parameters. Formula A(OSC)B+C
188 linear_temp_cor_a double Linear non wavelength dependant temperature correction. Formula A(TEMP)+B
189 linear_tempo_cor_b double Linear non wavelength dependant temperature correction. Formula A(TEMP)+B
190 v2 boolean Validated Configuration
191 modify_date datetime Last Configuration Update Datetime
192 exclusion_list text Date and time ranges excluded from L1.5 and 2.0 processing
193 comments text Provider comments of the configuration

Interface

Where can the Operators find the different constant in the configuration upload form.

Id Constant Tab Group
1 brewerid
2 date
3 operative
4 oslit1 Ozone / SO2 values O3 Temperature Coefficients
5 oslit2 Ozone / SO2 values O3 Temperature Coefficients
6 oslit3 Ozone / SO2 values O3 Temperature Coefficients
7 oslit4 Ozone / SO2 values O3 Temperature Coefficients
8 oslit5 Ozone / SO2 values O3 Temperature Coefficients
9 mstep Instrumental Constants Instrument Constants
10 o3o3rate Ozone / SO2 values O3 and SO2 Ratios
11 so2o2rate Ozone / SO2 values O3 and SO2 Ratios
12 o3so2rate Ozone / SO2 values O3 and SO2 Ratios
13 etco3rate Ozone / SO2 values Extraterrestial Constants
14 etcso2rate Ozone / SO2 values Extraterrestial Constants
15 deadtime Ozone / SO2 values Other
16 wstepn Instrumental Constants Instrument Constants
17 motordelay Instrumental Constants Instrument Constants
18 uoffset Instrumental Constants Positions and Offsets
19 nfilter0 Ozone / SO2 values Other
20 nfilter1 Ozone / SO2 values Other
21 nfilter2 Ozone / SO2 values Other
22 nfilter3 Ozone / SO2 values Other
23 nfilter4 Ozone / SO2 values Other
24 nfilter5 Ozone / SO2 values Other
25 zenithmotor Instrumental Constants Instrument Constants
26 brewer_model Instrumental Constants Instrument Constants
27 com_port Instrumental Constants Instrument Constants
28 o3tempcoef Ozone / SO2 values O3 Temperature Coefficients
29 sl_r5 Ozone / SO2 values Extraterrestial Constants
30 sl_r6 Ozone / SO2 values Extraterrestial Constants
31 etc_cor_f0 Ozone / SO2 values Extraterrestial Constants
32 etc_cor_f1 Ozone / SO2 values Extraterrestial Constants
33 etc_cor_f2 Ozone / SO2 values Extraterrestial Constants
34 etc_cor_f3 Ozone / SO2 values Extraterrestial Constants
35 etc_cor_f4 Ozone / SO2 values Extraterrestial Constants
36 etc_cor_f5 Ozone / SO2 values Extraterrestial Constants
37 o3micro1 Instrumental Constants Positions and Offsets
38 o3micro2 Instrumental Constants Positions and Offsets
39 o3wheel3 Instrumental Constants Positions and Offsets
46 gslope Instrumental Constants Instrument Constants
47 ginter Instrumental Constants Instrument Constants
48 mzeropos Instrumental Constants Positions and Offsets
49 mopeniris Instrumental Constants Instrument Constants
50 bufferdelay Instrumental Constants Instrument Constants
51 no2wpos Instrumental Constants Positions and Offsets
52 o3wpos Instrumental Constants Positions and Offsets
53 f2wpos Instrumental Constants Positions and Offsets
54 uvwpos UV Values UV Values
55 szenith Instrumental Constants Positions and Offsets
56 zuvpos UV Values UV Values
57 w_o3_0 Ozone / SO2 values Algorithm Dependant
58 w_o3_2 Ozone / SO2 values Algorithm Dependant
59 w_o3_3 Ozone / SO2 values Algorithm Dependant
60 w_o3_4 Ozone / SO2 values Algorithm Dependant
61 w_o3_5 Ozone / SO2 values Algorithm Dependant
62 w_o3_6 Ozone / SO2 values Algorithm Dependant
63 w_so2_0 Ozone / SO2 values Algorithm Dependant
64 w_so2_2 Ozone / SO2 values Algorithm Dependant
65 w_so2_3 Ozone / SO2 values Algorithm Dependant
66 w_so2_4 Ozone / SO2 values Algorithm Dependant
67 w_so2_5 Ozone / SO2 values Algorithm Dependant
68 w_so2_6 Ozone / SO2 values Algorithm Dependant
69 it Ozone / SO2 values Algorithm Dependant
70 be0 Ozone / SO2 values Other
71 be2 Ozone / SO2 values Other
72 be3 Ozone / SO2 values Other
73 be4 Ozone / SO2 values Other
74 be5 Ozone / SO2 values Other
75 be6 Ozone / SO2 values Other
76 o3ds Metadata, WOUDC and Process Rejection Criteria
77 o3zs Metadata, WOUDC and Process Rejection Criteria
78 o3fz Metadata, WOUDC and Process Rejection Criteria
79 o3fm Metadata, WOUDC and Process Rejection Criteria
80 no2ds Metadata, WOUDC and Process Rejection Criteria
81 no2zs Metadata, WOUDC and Process Rejection Criteria
82 no2fm Metadata, WOUDC and Process Rejection Criteria
83 mu_ds Metadata, WOUDC and Process Rejection Criteria
84 mu_fz Metadata, WOUDC and Process Rejection Criteria
85 mu_fm Metadata, WOUDC and Process Rejection Criteria
86 mu_no2 Metadata, WOUDC and Process Rejection Criteria
87 o3ds_maxstd Metadata, WOUDC and Process Rejection Criteria
88 o3zs_maxstd Metadata, WOUDC and Process Rejection Criteria
89 o3fz_maxstd Metadata, WOUDC and Process Rejection Criteria
90 o3fm_maxstd Metadata, WOUDC and Process Rejection Criteria
91 no2ds_maxstd Metadata, WOUDC and Process Rejection Criteria
92 no2zs_maxstd Metadata, WOUDC and Process Rejection Criteria
93 no2fm_maxstd Metadata, WOUDC and Process Rejection Criteria
94 mu_ds_value Metadata, WOUDC and Process Rejection Criteria
95 mu_fz_value Metadata, WOUDC and Process Rejection Criteria
96 mu_fm_value Metadata, WOUDC and Process Rejection Criteria
97 mu_no2_value Metadata, WOUDC and Process Rejection Criteria
98 recal_ds Metadata, WOUDC and Process Recalculation
99 recal_zs Metadata, WOUDC and Process Recalculation
100 recal_no2ds Metadata, WOUDC and Process Recalculation
101 recal_no2zs Metadata, WOUDC and Process Recalculation
102 sl_recal_cor Metadata, WOUDC and Process Recalculation
103 sl_fit_cor Metadata, WOUDC and Process Recalculation
104 sl_o3_cor Metadata, WOUDC and Process Recalculation
105 sl_no2_cor Metadata, WOUDC and Process Recalculation
106 wl_code Metadata, WOUDC and Process WOUDC
107 obs_code Metadata, WOUDC and Process WOUDC
108 column_o3 Metadata, WOUDC and Process WOUDC
109 stdev_o3 Metadata, WOUDC and Process WOUDC
110 utc_begin Metadata, WOUDC and Process WOUDC
111 utc_end Metadata, WOUDC and Process WOUDC
112 utc_mean Metadata, WOUDC and Process WOUDC
113 n_obs Metadata, WOUDC and Process WOUDC
114 m_mu Metadata, WOUDC and Process WOUDC
115 column_so2 Metadata, WOUDC and Process WOUDC
116 zs_a Ozone / SO2 values ZS Setup
117 zs_b Ozone / SO2 values ZS Setup
118 zs_c Ozone / SO2 values ZS Setup
119 zs_d Ozone / SO2 values ZS Setup
120 zs_e Ozone / SO2 values ZS Setup
121 zs_f Ozone / SO2 values ZS Setup
122 zs_g Ozone / SO2 values ZS Setup
123 zs_h Ozone / SO2 values ZS Setup
124 zs_k Ozone / SO2 values ZS Setup
125 no2abcoef NO2 NO2
126 no2dsetc NO2 NO2
127 no2zsetc NO2 NO2
128 no2slit1 NO2 NO2
129 no2slit2 NO2 NO2
130 no2slit3 NO2 NO2
131 no2slit4 NO2 NO2
132 no2slit5 NO2 NO2
133 sl_no2 NO2 NO2
134 country Metadata, WOUDC and Process Metadata
135 agency Metadata, WOUDC and Process Metadata
136 name Metadata, WOUDC and Process Metadata
137 gaw_id Metadata, WOUDC and Process Metadata
138 authority Metadata, WOUDC and Process Metadata
139 version Metadata, WOUDC and Process Metadata
140 go3s Metadata, WOUDC and Process Metadata
141 press Metadata, WOUDC and Process Metadata
142 latitude Metadata, WOUDC and Process Metadata
143 longitude Metadata, WOUDC and Process Metadata
144 height Metadata, WOUDC and Process Metadata
145 utc_offset Metadata, WOUDC and Process Metadata
146 gi_factor Instrumental Constants Instrument Constants
177 autohg Instrumental Constants Extra ICF Fields
178 fw2oscil Instrumental Constants Extra ICF Fields
179 fw2poshg Instrumental Constants Extra ICF Fields
180 lowerslimit Instrumental Constants Extra ICF Fields
181 upperslimit Instrumental Constants Extra ICF Fields
182 cubicdsp Instrumental Constants Extra ICF Fields
183 skipds Instrumental Constants Extra ICF Fields
184 sza_limit Instrumental Constants Solar Zenith Angle and Straylight Corrrections
185 stray_light_a Instrumental Constants Solar Zenith Angle and Straylight Corrrections
186 stray_light_b Instrumental Constants Solar Zenith Angle and Straylight Corrrections
187 stray_light_c Instrumental Constants Solar Zenith Angle and Straylight Corrrections
188 linear_temp_cor_a Ozone / SO2 values O3 Temperature Coefficients
189 linear_tempo_cor_b Ozone / SO2 values O3 Temperature Coefficients
190 v2
191 modify_date
192 exclusion list Metadata, WOUDC and Process Measurement's dates and times excluded from L1.5 and 2.0 processing
193 comments Metadata, WOUDC and Process Comments


Brewer AOD Configuration

For each wavelength, the following variables are defined in the AOD configuration:

Variable Short variable name Position in CSV input line
Wavelength wavel 1
Slit slit 2
Cal Step calstep 3
Full width at half maximum fwhm 4
ETC for filter position 0 etc_fl0 5
ETC for filter position 1 etc_fl1 6
ETC for filter position 2 etc_fl2 7
ETC for filter position 3 etc_fl3 8
ETC for filter position 4 etc_fl4 9
ETC for filter position 5 etc_fl5 10
Rayleigh coefficient (Nicolet) rayleigh 11
Ozone absorption coefficient (Bass and Paur) o3_abs 12
SO2 absorption coefficient so2_abs 13
NO2 absorption coefficient no2_abs 14
Temperature correction, intercept tc_const 15
Temperature correction, linear coefficient tc_lin 16
Temperature correction, quadratic coefficient tc_quad 17
Filter 1 attenuation at_fl1 18
Filter 2 attenuation at_fl2 19
Filter 3 attenuation at_fl3 20
Filter 4 attenuation at_fl4 21
Filter 5 attenuation at_fl5 22
Straylight correction, independent term strayl_const 23
Straylight correction, coefficient of the exponential function strayl_coeff 24
Straylight correction, power of the exponential function strayl_exp 25
Standard lamp correction, intercept sl_ref 26
Standard lamp correction, linear coefficient sl_slope 27
Standard lamp correction, quadratic coefficient sl_quad 28
Extra config param 1 aod_ex1 29
Extra config param 2 aod_ex2 30
Extra config param 3 aod_ex3 31

EUBREWNET's dataserver reads these variables from a CSV-like input, following the order defined in the previous table. In this way, for each wavelength, the CSV input will have one line with the following format:

wavel, slit, calstep, fwhm, etc_fl0, etc_fl1, etc_fl2, etc_fl3, etc_fl4, etc_fl5, rayleigh, o3_abs, so2_abs, no2_abs, tc_const, tc_lin, tc_quad, at_fl1, at_fl2, at_fl3, at_fl4, at_fl5, strayl_const, strayl_coeff, strayl_exp, sl_ref, sl_slope, sl_quad, aod_ex1, aod_ex2, aod_ex3

This CSV input can either be written in a file and then uploaded to EUBREWNET's dataserver, or pasted directly into the AOD configuration input box. If a file is used, it is recommended (although not mandatory) that the filename follows the format AODJJJYY.BID, where JJJ is the day number of the year, YY are the last two digits of the year, and BID is the 3-digits Brewer ID padded with zeros as necessary.



Brewer UV Configuration

The UV configuration interface in EUBREWNET includes the following sections:

UV response

The user has to provide a table with one row for each wavelength (in Angströms) and its corresponding responsivity (in counts/mW/m2/nm).

This information is included in the UVRJJJYY.BID files produced by the standard Brewer software.

This table is used in the UV L1 product to convert the raw counts measured by the Brewer to irradiances (I, in W/m2/nm)

Temperature

For the UV temperature correction, the user has to provide

  • A field with a reference temperature (Tref, in ºC), and
  • A table with one row for each wavelength (in Angströms) and the corresponding temperature dependence factor (Tdep, in 1/ºC).

All this information can be obtained by the experimental characterization described in Lakkala et al., Atmos. Chem. Phys., 8, 3369–3383, 2008

In the level 1.5 UV product, these data are used to calculate irradiances normalized to the reference temperature, I(Tref) = I(T)/[1+Tdep(T-Tref)].

Cosine Correction

In the configuration, the user can provide

  • A table with five columns: angle (between 0 and 90 degrees), and angular responses (measurements from the CR file normalized to the maximum value at 0 degrees) in the N, S, W, and E directions, see the next figure (as of February 2022, only the angular response in the N direction is used)

  • Fields with default values for the surface albedo in the UV, Angström's alpha and beta of aerosols, and the cloud cover (with values from 0 for clear sky to 1 for completely overcast conditions; the cosine correction is only applied for values lower than 0.9). These meteorological parameters will be used if no information for a specific day is provided in the following table.
  • A table with 5 columns: date (in YYYY-MM-DD format), surface albedo in the UV, Angström's alpha and beta of aerosols, and cloud cover. The cloud cover takes values from 0 (clear) to 1 (completely overcast), and the cosine correction is only applied for values lower than 0.9.

These data are used to calculate the cosine correction in the level 2 UV product. For the calculation itself we use a modified version of the Brewer UV Irradiance Calculator (BUVIC) developed by Basile Maret and Julian Gröbner at the PMOD/WRC.

Exclusion List

Finally, starting from the level 1.5 UV product, data can be filtered using a UV-specific Exclusion List



Exclusion List

In the Configuration interface at EUBREWNET's data server, date and time exclusion ranges can be defined in the Exclusion List text box. For Ozone, measurements included in one of these ranges will not be included in the standard output of the L1.5 and L2.0 products.

Each line in the Exclusion List text box defines an exclusion range. Each line must include three fields separated by commas, following the format

YYYY-MM-DD HH:MM:SS, YYYY-MM-DD HH:MM:SS, comment

The first field is the start of the exclusion range, the second its end, and the third a comment.

In the first and second fields, if the seconds are omitted, they will be set to 00. If both the seconds and the minutes are omitted, the server will autocomplete the field to YYYY-MM-DD HH:00:00.

Thus for example, the Exclusion List text box in the Configuration interface may look like

2010-01-01 10:10:00, 2010-01-01 10:30, maintenance
2010-01-02 09, 2010-01-02 12:35:15, more maintenance

Note that 10:30 will be converted to 10:30:00, and 09 to 09:00:00

The Exclusion List can include dates in which the configuration is not active. In that case, they will be simply ignored. In the above example, if the configuration is active from 2020-01-01 to the present, the two exclusion ranges won't have any effect (but they will still be saved to the configuration, and they will show up in the “Exclusion List” text box)

For Ozone, editing the Exclusion List in a configuration will have the same effect as changing any other parameter affecting levels 1.5 and 2.0. In particular, once the user clicks on “Submit Changes”, the server will issue a message stating that it's going to reprocess the data. The server will automatically send an email to the user once the reprocessing is finished.

As with any other parameter defined as a filter (see the documentation of the level 1.5 product), the effect of the Exclusion List can be checked using the process function with the &rejected option, e.g:

http://eubrewnet.aemet.es/eubrewnet/data/process/O3L1_5?brewerid=185&date=2020-03-22&enddate=2020-03-23&rejected

This will give a list of all the L1.5 individual measurements. If there are measurements affected by the Exclusion List, they will have a value greater or equal than 32 in the filter_flag field.

If the data has been completely processed, a call using the standard get function (e.g., http://eubrewnet.aemet.es/eubrewnet/data/get.json/O3L1_5?brewerid=185&date=2020-03-22&enddate=2020-03-23) will omit all the measurements included in the Exclusion List.


Getting the data omitted by the exclusion list

There are two ways to bypass the exclusion list using the process function:

1) As mentioned above, you can pass the option rejected to get all the data removed by Eubrewnet's data filters.

2) If you just want to bypass some line of the exclusion list, you can pass the allowtag=xxx option, where xxx is (part) of a keyword in the comment of a exclusion range.

For example, B#185's data from the El Arenosillo 2019 campaign has been added to the exclusion list using the following line:

2019-06-12 00:00:00, 2019-07-01 00:00:00, campaign are2019

So, if you try to open

http://eubrewnet.aemet.es/eubrewnet/data/process/O3L1_5?brewerid=185&date=2019-06-12&enddate=2019-07-01&format=text

in your browser, you will not get any data.

However, if you add &allowtag=campaign to the URL, so that it looks like

http://eubrewnet.aemet.es/eubrewnet/data/process/O3L1_5?brewerid=185&date=2019-06-12&enddate=2019-07-01&format=text&allowtag=campaign

you will now get the campaign's data – Eubrewnet has omitted the exclusion ranges which include the keyword campaign in the comment.

Note that, instead of campaign, you could have used are2019 or are or camp – Eubrewnet will check for incomplete keywords too.

devel/eubrewnetconfiguration.txt · Last modified: 2024/03/25 16:00 by jlsolano