devel:eubrewnetconfiguration
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
devel:eubrewnetconfiguration [2022/02/16 09:07] jlsolano [Temperature] |
devel:eubrewnetconfiguration [2024/06/06 10:37] (current) jlsolano [Slit Function] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Brewer Configuration constants ====== | ====== Brewer Configuration constants ====== | ||
| ===== Configuration Upload ===== | ===== Configuration Upload ===== | ||
| - | For a correct understanding of the Configuration Upload Interface, please take a look at the [[http://www.eubrewnet.org/cost1207/2015/03/04/configuration-upload-intructions/|Configuration Upload Instructions]] -- the behaviour of the form is described there. | + | For a correct understanding of the Configuration Upload Interface, please take a look at the [[http://eubrewnet.aemet.es/cost1207/2015/03/04/configuration-upload-intructions/|Configuration Upload Instructions]] -- the behaviour of the form is described there. |
| ===== Constants ===== | ===== Constants ===== | ||
| Line 421: | Line 421: | ||
| ==== UV response ==== | ==== UV response ==== | ||
| - | A table with one row for each wavelength (in Angströms) and its corresponding responsivity (in counts/mW/m<sup>2</sup>/nm). This information is provided by the ''UVRJJJYY.BID'' files. | + | The user has to provide a table with one row for each wavelength (in Angströms) and its corresponding responsivity (in counts/mW/m<sup>2</sup>/nm). |
| - | This table is used to convert the raw counts measured by the Brewer to the irradiances (''I'', in W/m<sup>2</sup>/nm) shown in the level 1, 1.5, and 2 UV products | + | 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/m<sup>2</sup>/nm) | ||
| ==== Temperature ==== | ==== Temperature ==== | ||
| Line 429: | Line 431: | ||
| For the UV temperature correction, the user has to provide | For the UV temperature correction, the user has to provide | ||
| - | * A field with a reference temperature (''Tref'', in ºC), and | + | * 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). | + | * 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 [[https://acp.copernicus.org/articles/8/3369/2008/|Lakkala et al., Atmos. Chem. Phys., 8, 3369–3383, 2008]] | All this information can be obtained by the experimental characterization described in [[https://acp.copernicus.org/articles/8/3369/2008/|Lakkala et al., Atmos. Chem. Phys., 8, 3369–3383, 2008]] | ||
| Line 437: | Line 439: | ||
| 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)]''. | 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 ==== | + | ---- |
| - | To calculate the cosine correction, we use a modified version of the [[https://github.com/pec0ra/buvic|Brewer UV Irradiance Calculator (BUVIC)]] developed by Basile Maret and Julian Gröbner at the PMOD/WRC. BUVIC follows the method described in [[https://acp.copernicus.org/articles/8/3369/2008/|Lakkala et al., Atmos. Chem. Phys., 8, 3369–3383, 2008]] | + | ==== Slit Function ==== |
| + | |||
| + | For the SHICRIVM processing of the irradiances at UV level 1.6, a slit function specific to the selected Brewer must be defined in the UV configuration. | ||
| + | |||
| + | The Brewer operator has to provide a table with with one row for each wavelength difference (in nm) with respect to the center of the slit (at position 0), and the corresponding counts normalized to the maximum at the center. | ||
| + | |||
| + | If the Brewer slit has not been experimentally characterized, the operator might use the following ''iz3'' generic slit function: | ||
| + | |||
| + | <code> | ||
| + | -1.0000 -1.61124920000000E-0003 | ||
| + | -0.9500 -4.74222590000000E-0005 | ||
| + | -0.9000 1.45009480000000E-0005 | ||
| + | -0.8500 1.08012790000000E-0005 | ||
| + | -0.8000 5.97901280000000E-0005 | ||
| + | -0.7500 4.00942910000000E-0005 | ||
| + | -0.7000 5.68359410000000E-0005 | ||
| + | -0.6500 1.37432720000000E-0004 | ||
| + | -0.6000 6.33504760000000E-0004 | ||
| + | -0.5500 1.88202150000000E-0002 | ||
| + | -0.5000 8.74465160000000E-0002 | ||
| + | -0.4500 1.77054810000000E-0001 | ||
| + | -0.4000 2.70787010000000E-0001 | ||
| + | -0.3500 3.79304850000000E-0001 | ||
| + | -0.3000 4.96931990000000E-0001 | ||
| + | -0.2500 5.94995930000000E-0001 | ||
| + | -0.2000 6.98289470000000E-0001 | ||
| + | -0.1500 7.79450570000000E-0001 | ||
| + | -0.1000 8.85814640000000E-0001 | ||
| + | -0.0500 9.82557220000000E-0001 | ||
| + | 0.0000 9.97399420000000E-0001 | ||
| + | 0.0500 9.61171110000000E-0001 | ||
| + | 0.1000 8.88221440000000E-0001 | ||
| + | 0.1500 7.92428980000000E-0001 | ||
| + | 0.2000 6.81902030000000E-0001 | ||
| + | 0.2500 5.78801750000000E-0001 | ||
| + | 0.3000 4.89674320000000E-0001 | ||
| + | 0.3500 3.88353780000000E-0001 | ||
| + | 0.4000 2.79554550000000E-0001 | ||
| + | 0.4500 1.65460740000000E-0001 | ||
| + | 0.5000 7.05684620000000E-0002 | ||
| + | 0.5500 2.16502970000000E-0002 | ||
| + | 0.6000 3.17729740000000E-0003 | ||
| + | 0.6500 3.46772700000000E-0004 | ||
| + | 0.7000 2.70033760000000E-0004 | ||
| + | 0.7500 7.18542260000000E-0005 | ||
| + | 0.8000 2.37073290000000E-0005 | ||
| + | 0.8500 4.79062050000000E-0005 | ||
| + | 0.9000 2.38161620000000E-0005 | ||
| + | 0.9500 1.36552080000000E-0005 | ||
| + | 1.0000 1.48133460000000E-0005 | ||
| + | </code> | ||
| + | |||
| + | |||
| + | ---- | ||
| + | ==== Cosine Correction ==== | ||
| In the configuration, the user can provide | In the configuration, the user can provide | ||
| - | * A table with five columns: angle (between 0 and 90 degrees), and angular responses in the N, S, W, and E directions (**as of February 2022, only the angular response in the N direction is used**) | + | * 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 albedo, Angström's alpha and beta, and the cloud optical depth. These meteorological parameters will be used if no information for a specific day is provided in the following table. | + | {{ :devel:arf_measurement.png?direct&400 |}} |
| - | * A table with 5 columns: date (in YYYY-MM-DD format), albedo, Angström's alpha, Angström's beta, and cloud optical depth. | + | * 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 [[https://github.com/pec0ra/buvic|Brewer UV Irradiance Calculator (BUVIC)]] developed by Basile Maret and Julian Gröbner at the [[https://www.pmodwrc.ch/en/home/|PMOD/WRC]]. | ||
| ==== Exclusion List ==== | ==== Exclusion List ==== | ||
| - | Finally, level 1.5 and 2.0 UV products can be filtered using a UV-specific [[http://rbcce.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#exclusion_list1|Exclusion List]] | + | Finally, starting from the level 1.5 UV product, data can be filtered using a UV-specific [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#exclusion_list1|Exclusion List]] |
| ---- | ---- | ||
| Line 485: | Line 543: | ||
| As with any other parameter defined as a filter (see the documentation of the [[codes:ozoneproduct&#level_15_realtime_observation|level 1.5 product]]), the effect of the Exclusion List can be checked using the process function with the &rejected option, e.g: | As with any other parameter defined as a filter (see the documentation of the [[codes:ozoneproduct&#level_15_realtime_observation|level 1.5 product]]), the effect of the Exclusion List can be checked using the process function with the &rejected option, e.g: | ||
| - | http://rbcce.aemet.es/eubrewnet/data/process/O3L1_5?brewerid=185&date=2020-03-22&enddate=2020-03-23&rejected | + | 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. | 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://rbcce.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. | + | 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. |
| ---- | ---- | ||
| Line 501: | Line 559: | ||
| **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. | **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 Arenosillo 2019 campaign has been added to the exclusion list using the following line: | + | For example, B#185's data from the El Arenosillo 2019 campaign has been added to the exclusion list using the following line: |
| <code> | <code> | ||
| Line 509: | Line 567: | ||
| So, if you try to open | So, if you try to open | ||
| - | http://rbcce.aemet.es/eubrewnet/data/process/O3L1_5?brewerid=185&date=2019-06-12&enddate=2019-07-01&format=text | + | 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. | in your browser, you will not get any data. | ||
| Line 515: | Line 573: | ||
| However, if you add ''&allowtag=campaign'' to the URL, so that it looks like | However, if you add ''&allowtag=campaign'' to the URL, so that it looks like | ||
| - | http://rbcce.aemet.es/eubrewnet/data/process/O3L1_5?brewerid=185&date=2019-06-12&enddate=2019-07-01&format=text&allowtag=campaign | + | 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. | 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. | Note that, instead of ''campaign'', you could have used ''are2019'' or ''are'' or ''camp'' -- Eubrewnet will check for incomplete keywords too. | ||
| + | |||
devel/eubrewnetconfiguration.1645002450.txt.gz · Last modified: 2022/02/16 09:07 by jlsolano
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 3.0 Unported
