This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
codes:aodaccess [2024/05/07 14:36] jlsolano [Process AODL1_5JG] |
codes:aodaccess [2024/05/21 12:20] jlsolano [Get AODL1_5byStation] |
||
---|---|---|---|
Line 2: | Line 2: | ||
This pages describes AOD-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 [[codes:dbaccess#access_functions|ozone access functions]] | This pages describes AOD-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 [[codes:dbaccess#access_functions|ozone access functions]] | ||
+ | |||
+ | See [[https://drive.google.com/file/d/1kO0fLzxqnSLcqCWElXv0bdpBwewdGYYN/view?usp=sharing|this presentation]] for a short overview of the AOD configuration and processing of DS measurements. | ||
---- | ---- | ||
Line 18: | Line 20: | ||
^ JG | Returns the raw, L0 data from the JG measurements as measured by the Brewer | [[codes:aodaccess#get_JG|JG]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/JG?brewerid=185&date=2022-07-15&format=text|Get JG]] | | ^ JG | Returns the raw, L0 data from the JG measurements as measured by the Brewer | [[codes:aodaccess#get_JG|JG]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/JG?brewerid=185&date=2022-07-15&format=text|Get JG]] | | ||
^ JL | Returns the raw, L0 data from the JL measurements as measured by the Brewer | [[codes:aodaccess#get_JL|JL]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/JL?brewerid=257&date=2023-05-07&format=text|Get JL]] | | ^ JL | Returns the raw, L0 data from the JL measurements as measured by the Brewer | [[codes:aodaccess#get_JL|JL]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/JL?brewerid=257&date=2023-05-07&format=text|Get JL]] | | ||
- | ^ AODL1_5 | Returns the Aerosol Optical Depth Level 1.5 product |[[codes:aodaccess#get_AODL1_5|AODL1_5]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/AODL1_5?brewerid=185&date=2020-10-01&enddate=2020-10-10|Get AODL1_5]] | | + | ^ AODL1 | Returns the Aerosol Optical Depth Level 1 product for DS measurements |[[codes:aodaccess#get_AODL1|AODL1]] | [[http://eubrewnet.aemet.es/eubrewnet/data/get/AODL1?brewerid=185&date=2023-11-12&format=text|Get AODL1]] |
+ | ^ AODL1ALL | Returns the Aerosol Optical Depth Level 1 product for both DS and JG measurements |[[codes:aodaccess#get_AODL1ALL|AODL1ALL]] | [[http://eubrewnet.aemet.es/eubrewnet/data/get/AODL1ALL?brewerid=185&date=2023-11-12&format=text|Get AODL1ALL]] | | ||
+ | ^ AODL1_5 | Returns the Aerosol Optical Depth Level 1.5 product for DS measurements |[[codes:aodaccess#get_AODL1_5|AODL1_5]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/AODL1_5?brewerid=185&date=2020-10-01&enddate=2020-10-10|Get AODL1_5]] | | ||
+ | ^ AODL1_5ALL | Returns the Aerosol Optical Depth Level 1.5 product for both DS and JG measurements |[[codes:aodaccess#get_AODL1_5ALL|AODL1_5ALL]] | [[https://eubrewnet.aemet.es/eubrewnet/data/get/AODL1_5ALL?brewerid=185&date=2020-10-01&enddate=2020-10-10|Get AODL1_5ALL]] | | ||
^ AODL1_5byStation | For the selected station, returns the Aerosol Optical Depth Level 1.5 product |[[codes:aodaccess#get_AODL1_5byStation|AODL1_5byStation]] | [[http://eubrewnet.aemet.es/eubrewnet/data/get/AODL1_5byStation?gaw_id=IZO&date=2020-04-05&enddate=2020-04-06&format=text|Get AODL1_5byStation]] | | ^ AODL1_5byStation | For the selected station, returns the Aerosol Optical Depth Level 1.5 product |[[codes:aodaccess#get_AODL1_5byStation|AODL1_5byStation]] | [[http://eubrewnet.aemet.es/eubrewnet/data/get/AODL1_5byStation?gaw_id=IZO&date=2020-04-05&enddate=2020-04-06&format=text|Get AODL1_5byStation]] | | ||
+ | |||
+ | ---- | ||
==== Get JG ==== | ==== Get JG ==== | ||
* Function: JG | * Function: JG | ||
Line 34: | Line 41: | ||
- ''steps'': micrometer step | - ''steps'': micrometer step | ||
+ | ---- | ||
==== Get JL ==== | ==== Get JL ==== | ||
* Function: JL | * Function: JL | ||
Line 47: | Line 55: | ||
- ''raw_counts_w0'' to ''raw_counts_w5'': counts in the 6 slits | - ''raw_counts_w0'' to ''raw_counts_w5'': counts in the 6 slits | ||
- ''steps'': micrometer step | - ''steps'': micrometer step | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ==== Get AODL1 ==== | ||
+ | * Function: AODL1 | ||
+ | * Description: for DS measurements, returns the AOD and corrected counts for the AOD calculation. Corrections included are dark counts, dead time, temperature, filter attenuation, Earth-Sun distance, and polarization. O3L1 ozone is used in the AOD calculation. For full details of the AOD determination, see [[https://www.atmos-chem-phys.net/18/3885/2018/ | J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018)]]. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] must be available for the requested period. | ||
+ | * Example: http://eubrewnet.aemet.es/eubrewnet/data/get/AODL1?brewerid=185&date=2023-11-12&format=text | ||
+ | * Input: | ||
+ | - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] | ||
+ | - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] | ||
+ | - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] | ||
+ | - ''format'': see [[codes:dbaccess#format|common formats]] and [[codes:uvaccess#formats|jsona format]] | ||
+ | - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] | ||
+ | - ''showerrors'': displays errors found during the calculation. | ||
+ | * Output: the following AOD-specific fields are included in the standard output alongside the other usual ones (Brewer ID, pressure, sza, ...): | ||
+ | - ''aodconfigid'': ID of the AOD configuration used in the calculation | ||
+ | - ''aodconfigdate'': date of the AOD configuration used in the calculation | ||
+ | - ''wavelengths_i'': wavelength //i//, in nm | ||
+ | - ''aod_i'': AOD for the wavelength //i// | ||
+ | - ''counts_i'': corrected counts for the wavelength //i// | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ==== Get AODL1ALL ==== | ||
+ | * Function: AODL1ALL | ||
+ | * Description: for both DS and JG measurements, returns the AOD and corrected counts for the AOD calculation. Corrections included are dark counts, dead time, temperature, filter attenuation, Earth-Sun distance, and polarization. O3L1 ozone is used in the AOD calculation. For full details of the AOD determination, see [[https://www.atmos-chem-phys.net/18/3885/2018/ | J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018)]]. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] must be available for the requested period. | ||
+ | * Example: http://eubrewnet.aemet.es/eubrewnet/data/get/AODL1ALL?brewerid=185&date=2023-11-12&format=text | ||
+ | * Input: | ||
+ | - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] | ||
+ | - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] | ||
+ | - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] | ||
+ | - ''format'': see [[codes:dbaccess#format|common formats]] and [[codes:uvaccess#formats|jsona format]] | ||
+ | - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] | ||
+ | - ''showerrors'': displays errors found during the calculation. | ||
+ | * Output: the following AOD-specific fields are included in the standard output alongside the other usual ones (Brewer ID, pressure, sza, ...): | ||
+ | - ''aodconfigid'': ID of the AOD configuration used in the calculation | ||
+ | - ''aodconfigdate'': date of the AOD configuration used in the calculation | ||
+ | - ''wavelengths_i'': wavelength //i//, in nm | ||
+ | - ''aod_i'': AOD for the wavelength //i// | ||
+ | - ''counts_i'': corrected counts for the wavelength //i// | ||
+ | |||
+ | ---- | ||
==== Get AODL1_5 ==== | ==== Get AODL1_5 ==== | ||
* Function: AODL1_5 | * Function: AODL1_5 | ||
- | * Description: returns Aerosol Optical Depth summaries for the wavelengths considered -- as of October 2020, counts are taken from DS measurements so the AOD is calculated for the six wavelengths at approx. 303, 306, 310, 313, 317, and 320 nm, provided a calibration exists for each of them. For the the Ozone contribution to the AOD, the O3L1.5 data is used. For full details of the AOD determination, see [[https://www.atmos-chem-phys.net/18/3885/2018/ | J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018)]]. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] must be available for the requested period. | + | * Description: returns Aerosol Optical Depth summaries for the DS wavelengths, provided a calibration exists for each of them. For the the Ozone contribution to the AOD, the O3L1.5 data is used. For full details of the AOD determination, see [[https://www.atmos-chem-phys.net/18/3885/2018/ | J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018)]]. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] must be available for the requested period. |
* Input: | * Input: | ||
- ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] | - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] | ||
Line 60: | Line 110: | ||
- ''aodconfigid'': ID of the AOD configuration used in the calculation | - ''aodconfigid'': ID of the AOD configuration used in the calculation | ||
- ''aodconfigdate'': date of the AOD configuration used in the calculation | - ''aodconfigdate'': date of the AOD configuration used in the calculation | ||
- | - ''wavelengths_i'': wavelength //i//, in nm. As of October 2020, counts are taken from DS measurements so the AOD is calculated for the six wavelengths at approx. 303, 306, 310, 313, 317, and 320 nm | + | - ''wavelengths_i'': wavelength //i//, in nm. The DS wavelengths are approx. 303, 306, 310, 313, 317, and 320 nm |
- ''aod_i'': AOD for the wavelength //i// | - ''aod_i'': AOD for the wavelength //i// | ||
- ''std_aod_i'': standard deviation of the AOD summaries at wavelength //i// | - ''std_aod_i'': standard deviation of the AOD summaries at wavelength //i// | ||
Line 66: | Line 116: | ||
**Note**: the ''airmass'' field corresponds to the aerosol airmass, which is currently approximated by the Rayleigh airmass. | **Note**: the ''airmass'' field corresponds to the aerosol airmass, which is currently approximated by the Rayleigh airmass. | ||
+ | ---- | ||
+ | |||
+ | ==== Get AODL1_5ALL ==== | ||
+ | * Function: AODL1_5ALL | ||
+ | * Description: For both DS and JG, returns Aerosol Optical Depth summaries for all the wavelengths with a calibration. For the the Ozone contribution to the AOD, the O3L1.5 data is used. For full details of the AOD determination, see [[https://www.atmos-chem-phys.net/18/3885/2018/ | J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018)]]. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] must be available for the requested period. | ||
+ | * Input: | ||
+ | - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] | ||
+ | - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] | ||
+ | - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] | ||
+ | - ''format'': see [[codes:dbaccess#format|common formats]] and [[codes:uvaccess#formats|jsona format]] | ||
+ | - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] | ||
+ | - ''means'': see [[codes:dbaccess#means|means]] | ||
+ | * Output: the following AOD-specific fields are included in the standard output alongside the other usual ones (Brewer ID, pressure, sza, ...): | ||
+ | - ''aodconfigid'': ID of the AOD configuration used in the calculation | ||
+ | - ''aodconfigdate'': date of the AOD configuration used in the calculation | ||
+ | - ''wavelengths_i'': wavelength //i//, in nm. | ||
+ | - ''aod_i'': AOD for the wavelength //i// | ||
+ | - ''std_aod_i'': standard deviation of the AOD summaries at wavelength //i// | ||
+ | |||
+ | **Note**: the ''airmass'' field corresponds to the aerosol airmass, which is currently approximated by the Rayleigh airmass. | ||
+ | |||
+ | ---- | ||
==== Get AODL1_5byStation ==== | ==== Get AODL1_5byStation ==== | ||
- | * Function: O3L1_5byStation | + | * Function: AODL1_5byStation |
* Description: This function provides the same output as the [[codes:aodaccess#get_aodl1_5|AODL1_5]] described above, but for the requested station. As of September 2020, the station products will output the data of the first Brewer defined for a station, or, if not available, that of the second. If data of the second Brewer is also not available, data of the third Brewer will be used, and so on. | * Description: This function provides the same output as the [[codes:aodaccess#get_aodl1_5|AODL1_5]] described above, but for the requested station. As of September 2020, the station products will output the data of the first Brewer defined for a station, or, if not available, that of the second. If data of the second Brewer is also not available, data of the third Brewer will be used, and so on. | ||
* Example: http://eubrewnet.aemet.es/eubrewnet/data/get/AODL1_5byStation?gaw_id=IZO&date=2020-04-05&enddate=2020-04-06&format=text -- note that in the output there is data for both Brewers #157 and #185: the former is the first Brewer defined in the station view (http://eubrewnet.aemet.es/eubrewnet/station/view/9) but it was not operating on 2020-04-05; Brewer #183 is the second instrument defined for the station, but it was also not operating on this day, so the data of B#185 has been used. | * Example: http://eubrewnet.aemet.es/eubrewnet/data/get/AODL1_5byStation?gaw_id=IZO&date=2020-04-05&enddate=2020-04-06&format=text -- note that in the output there is data for both Brewers #157 and #185: the former is the first Brewer defined in the station view (http://eubrewnet.aemet.es/eubrewnet/station/view/9) but it was not operating on 2020-04-05; Brewer #183 is the second instrument defined for the station, but it was also not operating on this day, so the data of B#185 has been used. | ||
Line 80: | Line 152: | ||
---- | ---- | ||
+ | ==== Get AODConfigAll ==== | ||
+ | * Function: AODConfigAll | ||
+ | * Description: return a summary of all the available AOD configurations | ||
+ | * Example: http://eubrewnet.aemet.es/eubrewnet/data/get/AODConfigAll?format=text | ||
+ | * Input: | ||
+ | - ''brewerid'': optional, to show only the configurations of the requested Brewer | ||
+ | * Output: a table with ''brewerid'', ''date'', and ''comments'' fields | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | ==== Get AODConfigbyDate ==== | ||
+ | * Function: AODConfigbyDate | ||
+ | * Description: return the operative AOD configuration for the requested Brewer and date | ||
+ | * Example: http://eubrewnet.aemet.es/eubrewnet/data/get/AODConfigbyDate?format=text&brewer=185&date=2024-05-21 | ||
+ | * Input: | ||
+ | - ''brewerid'': id of the requested Brewer | ||
+ | - ''date'': date to check | ||
+ | * Output: a table with the complete AOD configuration, one line for each wavelength | ||
+ | |||
+ | ---- | ||
===== PROCESS FUNCTIONS ===== | ===== PROCESS FUNCTIONS ===== | ||
^ Function ^ Description ^ Help ^ Example ^ | ^ Function ^ Description ^ Help ^ Example ^ | ||
- | ^ AODL1_5 | Returns Level 1.5 AOD | [[codes:aodaccess#process_AODL1_5|AODL1_5]] | [[http://eubrewnet.aemet.es/eubrewnet/data/process/AODL1_5?brewerid=185&date=2019-11-01&enddate=2019-11-12|Process AODL1_5]] | | + | ^ JGL1 | Returns Level 1 JG corrected counts (dark counts, dead time, temperature, and filter attenuation) | [[codes:aodaccess#process_JGL1|JGL1]] | [[https://rbcce.aemet.es/eubrewnet/data/process/JGL1?brewerid=185&date=2023-11-12&format=text|Process AODL1JG]] | |
- | ^ AODL1_5JG | Returns Level 1.5 AOD from JG measurements | [[codes:aodaccess#process_AODL1_5JG|AODL1_5JG]] | [[https://rbcce.aemet.es/eubrewnet/data/process/AODL1_5JG?brewerid=185&date=2022-08-01&format=text|Process AODL1_5JG]] | | + | ^ AODL1 | Returns Level 1 DS corrected counts (dark counts, dead time, temperature, filter attenuation, Sun-Earth distance, and polarization) and AOD | [[codes:aodaccess#process_AODL1|AODL1]] | [[http://eubrewnet.aemet.es/eubrewnet/data/process/AODL1?brewerid=185&date=2019-11-01&enddate=2019-11-12|Process AODL1]] | |
- | ^ AODL1_5ALL | Returns Level 1.5 AOD from DS and JG measurements | [[codes:aodaccess#process_AODL1_5ALL|AODL1_5ALL]] | [[https://rbcce.aemet.es/eubrewnet/data/process/AODL1_5ALL?brewerid=185&date=2022-08-01&format=text&fields=gmt,wavel|Process AODL1_5ALL]] | | + | ^ AODL1JG | Returns Level 1 JG corrected counts and AOD | [[codes:aodaccess#process_AODL1JG|AODL1JG]] | [[https://rbcce.aemet.es/eubrewnet/data/process/AODL1JG?brewerid=185&date=2023-11-12&format=text|Process AODL1JG]] | |
+ | ^ AODL1ALL | Returns Level 1 DS and JG corrected counts and AOD | [[codes:aodaccess#process_AODL1ALL|AODL1ALL]] | [[https://rbcce.aemet.es/eubrewnet/data/process/AODL1ALL?brewerid=185&date=2023-11-12&format=text&fields=gmt,wavel|Process AODL1_5ALL]] | | ||
+ | ^ AODL1_5 | Returns Level 1.5 AOD for DS measurements | [[codes:aodaccess#process_AODL1_5|AODL1_5]] | [[http://eubrewnet.aemet.es/eubrewnet/data/process/AODL1_5?brewerid=185&date=2019-11-01&enddate=2019-11-12|Process AODL1_5]] | | ||
+ | ^ AODL1_5JG | Returns Level 1.5 AOD for JG measurements | [[codes:aodaccess#process_AODL1_5JG|AODL1_5JG]] | [[https://rbcce.aemet.es/eubrewnet/data/process/AODL1_5JG?brewerid=185&date=2023-11-12&format=text|Process AODL1_5JG]] | | ||
+ | ^ AODL1_5ALL | Returns Level 1.5 AOD for DS and JG measurements | [[codes:aodaccess#process_AODL1_5ALL|AODL1_5ALL]] | [[https://rbcce.aemet.es/eubrewnet/data/process/AODL1_5ALL?brewerid=185&date=2023-11-12&format=text&fields=gmt,wavel|Process AODL1_5ALL]] | | ||
+ | |||
+ | ---- | ||
==== AOD Filter Flags ==== | ==== AOD Filter Flags ==== | ||
Line 97: | Line 196: | ||
| FLAG_AOD_BAD_OZONE_FILT | 64 | The ozone data does not have a filter_flag of 0 | | | FLAG_AOD_BAD_OZONE_FILT | 64 | The ozone data does not have a filter_flag of 0 | | ||
+ | ---- | ||
+ | ==== Process JGL1 ==== | ||
+ | * Function: JGL1 | ||
+ | * Description: returns the JG counts corrected for dark counts, dead time, temperature, and filter attenuation -- ie, the same corrections as O3L1. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] must be available for the requested period. | ||
+ | * Example: http://eubrewnet.aemet.es/eubrewnet/data/process/JGL1?brewerid=185&date=2023-11-12&format=text | ||
+ | * Input: | ||
+ | - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] | ||
+ | - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] | ||
+ | - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] | ||
+ | - ''format'': see [[codes:dbaccess#format|common formats]] and [[codes:uvaccess#formats|jsona format]] | ||
+ | - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] | ||
+ | - ''showerrors'': displays errors found during the calculation. | ||
+ | - ''step'': optional, return data only for the requested micrometer step. | ||
+ | * Output: the following AOD-specific fields are included in the standard output alongside the other usual ones (Brewer ID, pressure, sza, ...): | ||
+ | - ''aodconfigid'': ID of the AOD configuration used in the calculation | ||
+ | - ''aodconfigdate'': date of the AOD configuration used in the calculation | ||
+ | - ''wavelengths_i'': wavelength //i//, in nm. As of October 2020, counts are taken from DS measurements so the AOD is calculated for the six wavelengths at approx. 303, 306, 310, 313, 317, and 320 nm | ||
+ | - ''counts_i'': corrected counts for the wavelength //i// | ||
+ | |||
+ | ---- | ||
==== Process AODL1 ==== | ==== Process AODL1 ==== | ||
* Function: AODL1 | * Function: AODL1 | ||
- | * Description: returns the DS corrected counts for the AOD calculation. For full details of the AOD determination, see [[https://www.atmos-chem-phys.net/18/3885/2018/ | J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018)]]. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] must be available for the requested period. | + | * Description: returns the AOD and DS corrected counts for the AOD calculation. Corrections included are dark counts, dead time, temperature, filter attenuation, Earth-Sun distance, and polarization. O3L1 ozone is used in the AOD calculation. For full details of the AOD determination, see [[https://www.atmos-chem-phys.net/18/3885/2018/ | J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018)]]. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] must be available for the requested period. |
- | * Example: http://eubrewnet.aemet.es/eubrewnet/data/process/AODL1?brewerid=185&date=2019-11-01&enddate=2019-11-12 | + | * Example: http://eubrewnet.aemet.es/eubrewnet/data/process/AODL1?brewerid=185&date=2023-11-12&format=text |
* Input: | * Input: | ||
- ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] | - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]] | ||
Line 108: | Line 227: | ||
- ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] | - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] | ||
- ''showerrors'': displays errors found during the calculation. | - ''showerrors'': displays errors found during the calculation. | ||
- | | + | - ''step'': optional, return data only for the requested micrometer step |
* Output: the following AOD-specific fields are included in the standard output alongside the other usual ones (Brewer ID, pressure, sza, ...): | * Output: the following AOD-specific fields are included in the standard output alongside the other usual ones (Brewer ID, pressure, sza, ...): | ||
- ''aodconfigid'': ID of the AOD configuration used in the calculation | - ''aodconfigid'': ID of the AOD configuration used in the calculation | ||
- ''aodconfigdate'': date of the AOD configuration used in the calculation | - ''aodconfigdate'': date of the AOD configuration used in the calculation | ||
- | - ''wavelengths_i'': wavelength //i//, in nm. As of October 2020, counts are taken from DS measurements so the AOD is calculated for the six wavelengths at approx. 303, 306, 310, 313, 317, and 320 nm | + | - ''wavelengths_i'': wavelength //i//, in nm. The DS six wavelengths are approx. 303, 306, 310, 313, 317, and 320 nm |
+ | - ''aod_i'': AOD for the wavelength //i// | ||
- ''counts_i'': corrected counts for the wavelength //i// | - ''counts_i'': corrected counts for the wavelength //i// | ||
---- | ---- | ||
+ | ==== Process AODL1JG ==== | ||
+ | * Function: AODL1JG | ||
+ | * Description: returns the corrected counts for the wavelengths in the AOD-specific JG measurements. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] for JG wavelengths must be available for the requested period. | ||
+ | * Example: https://eubrewnet.aemet.es/eubrewnet/data/process/AODL1JG?brewerid=185&date=2023-11-12&format=text | ||
+ | * Input: same as [[codes:aodaccess#process_aodl1|process AOD L1]] | ||
+ | * Ouput: same as [[codes:aodaccess#process_aodl1|process AOD L1]] | ||
+ | ---- | ||
+ | ==== Process AODL1ALL ==== | ||
+ | * Function: AODL1ALL | ||
+ | * Description: returns corrected counts for the wavelengths in both the DS and the AOD-specific JG measurements. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] must be available for the requested period. | ||
+ | * Example: return the wavelengths measured in each observation: [[https://eubrewnet.aemet.es/eubrewnet/data/process/AODL1ALL?brewerid=185&date=2023-11-12&format=text&fields=gmt,wavel*]] | ||
+ | * Input: same as [[codes:aodaccess#process_aodl1|process AOD L1]] | ||
+ | * Ouput: same as [[codes:aodaccess#process_aodl1|process AOD L1]] | ||
+ | |||
+ | ---- | ||
==== Process AODL1_5 ==== | ==== Process AODL1_5 ==== | ||
* Function: AODL1_5 | * Function: AODL1_5 | ||
- | * Description: returns Aerosol Optical Depth summaries for the wavelengths considered -- as of October 2020, counts are taken from DS measurements so the AOD is calculated for the six wavelengths at approx. 303, 306, 310, 313, 317, and 320 nm, provided a calibration exists for each of them. For the the Ozone contribution to the AOD, the O3L1.5 data is used. For full details of the AOD determination, see [[https://www.atmos-chem-phys.net/18/3885/2018/ | J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018)]]. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] must be available for the requested period. | + | * Description: returns Aerosol Optical Depth summaries for the DS measurements, at wavelengths of approx. 303, 306, 310, 313, 317, and 320 nm, provided a calibration exists for each of them. For the the Ozone contribution to the AOD, the O3L1.5 data is used. For full details of the AOD determination, see [[https://www.atmos-chem-phys.net/18/3885/2018/ | J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018)]]. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] must be available for the requested period. |
* Example: http://eubrewnet.aemet.es/eubrewnet/data/process/AODL1_5?brewerid=185&date=2019-11-01&enddate=2019-11-12 | * Example: http://eubrewnet.aemet.es/eubrewnet/data/process/AODL1_5?brewerid=185&date=2019-11-01&enddate=2019-11-12 | ||
* Input: | * Input: | ||
Line 131: | Line 266: | ||
- ''rejected'': returns all the individual measurements, including those rejected. As in the case of Ozone, the cause for rejection is coded in the ''aod_filter_flag'' fields -- the values are analogue to those of the [[codes:ozoneproduct#level_15_realtime_observation | Ozone filter flag]], see [[codes:aodaccess#aod_filter_flag|this table]] | - ''rejected'': returns all the individual measurements, including those rejected. As in the case of Ozone, the cause for rejection is coded in the ''aod_filter_flag'' fields -- the values are analogue to those of the [[codes:ozoneproduct#level_15_realtime_observation | Ozone filter flag]], see [[codes:aodaccess#aod_filter_flag|this table]] | ||
- ''showerrors'': displays errors found during the calculation. | - ''showerrors'': displays errors found during the calculation. | ||
+ | - ''step'': optional, return data only for the requested micrometer step | ||
- ''means'': see [[codes:dbaccess#means|means]] | - ''means'': see [[codes:dbaccess#means|means]] | ||
* Output: the following AOD-specific fields are included in the standard output alongside the other usual ones (Brewer ID, pressure, sza, ...): | * Output: the following AOD-specific fields are included in the standard output alongside the other usual ones (Brewer ID, pressure, sza, ...): | ||
Line 138: | Line 274: | ||
- ''aod_i'': AOD for the wavelength //i// | - ''aod_i'': AOD for the wavelength //i// | ||
- ''std_aod_i'': standard deviation of the AOD summaries at wavelength //i// | - ''std_aod_i'': standard deviation of the AOD summaries at wavelength //i// | ||
+ | - ''counts_i'': corrected counts for the wavelength //i// | ||
+ | ---- | ||
==== Process AODL1_5JG ==== | ==== Process AODL1_5JG ==== | ||
* Function: AODL1_5JG | * Function: AODL1_5JG | ||
* Description: returns Aerosol Optical Depth summaries for the wavelengths in the AOD-specific JG measurements. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] for JG wavelengths must be available for the requested period. | * Description: returns Aerosol Optical Depth summaries for the wavelengths in the AOD-specific JG measurements. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] for JG wavelengths must be available for the requested period. | ||
- | * Example: https://rbcce-test.aemet.es/eubrewnet/data/process/AODL1_5JG?brewerid=185&date=2022-08-01&format=text | + | * Example: https://eubrewnet.aemet.es/eubrewnet/data/process/AODL1_5JG?brewerid=185&date=2023-11-12&format=text |
* Input: same as [[codes:aodaccess#process_aodl1_5|process AOD L1.5]]. Note that ''means'' might mix different wavelengths! | * Input: same as [[codes:aodaccess#process_aodl1_5|process AOD L1.5]]. Note that ''means'' might mix different wavelengths! | ||
* Ouput: same as [[codes:aodaccess#process_aodl1_5|process AOD L1.5]] | * Ouput: same as [[codes:aodaccess#process_aodl1_5|process AOD L1.5]] | ||
Line 150: | Line 288: | ||
* Function: AODL1_5ALL | * Function: AODL1_5ALL | ||
* Description: returns Aerosol Optical Depth summaries for the wavelengths in both the DS and the AOD-specific JG measurements. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] must be available for the requested period. | * Description: returns Aerosol Optical Depth summaries for the wavelengths in both the DS and the AOD-specific JG measurements. An operative [[http://eubrewnet.aemet.es/dokuwiki/doku.php?id=devel:eubrewnetconfiguration&#brewer_aod_configuration | AOD configuration]] must be available for the requested period. | ||
- | * Example: return the wavelengths measured in each observation: [[https://rbcce-test.aemet.es/eubrewnet/data/process/AODL1_5ALL?brewerid=185&date=2022-08-01&format=text&fields=gmt,wavel*]] | + | * Example: return the wavelengths measured in each observation: [[https://eubrewnet.aemet.es/eubrewnet/data/process/AODL1_5ALL?brewerid=185&date=2023-11-12&format=text&fields=gmt,wavel*]] |
* Input: same as [[codes:aodaccess#process_aodl1_5|process AOD L1.5]]. Note that ''means'' might mix different wavelengths! | * Input: same as [[codes:aodaccess#process_aodl1_5|process AOD L1.5]]. Note that ''means'' might mix different wavelengths! | ||
* Ouput: same as [[codes:aodaccess#process_aodl1_5|process AOD L1.5]] | * Ouput: same as [[codes:aodaccess#process_aodl1_5|process AOD L1.5]] | ||