Eubrewnet Wiki

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 ozone access functions

See this presentation for a short overview of the AOD configuration and processing of DS measurements.

Besides the common formats described here, the jsona format can also be used to produce 2d arrays for the aod_l and std_aod_l variables, see this example

The output of the GET functions is stored in Eubrewnet's database, from where it's retrieved on each function call with little further processing. They are faster than their equivalent PROCESS functions, which process the data in real time, usually starting from the previous level. Whenever possible, GET functions should be used instead of the PROCESS equivalents.

• Function: JG
• Description: returns the raw, L0 JG data as measured by the Brewer.
• Input:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. format: see common formats and jsona format
  5. fields: see Fields in common inputs
• Output: the output data includes:
  1. nd_filter_position: filter used in the measurement. 0 corresponds to filter position #0, 64 to #1, 128 to #2, 192 to #3, and 256 to #4
  2. raw_counts_w0 to raw_counts_w5: counts in the 6 slits
  3. steps: micrometer step

• Function: JL
• Description: returns the raw, L0 JL data as measured by the Brewer.
• Input:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. format: see common formats and jsona format
  5. fields: see Fields in common inputs
• Output: the output data includes:
  1. nd_filter_position: filter used in the measurement. 0 corresponds to filter position #0, 64 to #1, 128 to #2, 192 to #3, and 256 to #4
  2. raw_counts_w0 to raw_counts_w5: counts in the 6 slits
  3. steps: micrometer step

• 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 J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018). An operative 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:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. format: see common formats and jsona format
  5. fields: see Fields in common inputs
  6. 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, …):
  1. aodconfigid: ID of the AOD configuration used in the calculation
  2. aodconfigdate: date of the AOD configuration used in the calculation
  3. wavelengths_i: wavelength i, in nm
  4. aod_i: AOD for the wavelength i
  5. counts_i: corrected counts for the wavelength i

• 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 J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018). An operative 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:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. format: see common formats and jsona format
  5. fields: see Fields in common inputs
  6. 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, …):
  1. aodconfigid: ID of the AOD configuration used in the calculation
  2. aodconfigdate: date of the AOD configuration used in the calculation
  3. wavelengths_i: wavelength i, in nm
  4. aod_i: AOD for the wavelength i
  5. counts_i: corrected counts for the wavelength i

• Function: AODL1_5
• 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 J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018). An operative AOD configuration must be available for the requested period.
• Input:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. format: see common formats and jsona format
  5. fields: see Fields in common inputs
  6. means: see means
• Output: the following AOD-specific fields are included in the standard output alongside the other usual ones (Brewer ID, pressure, sza, …):
  1. aodconfigid: ID of the AOD configuration used in the calculation
  2. aodconfigdate: date of the AOD configuration used in the calculation
  3. wavelengths_i: wavelength i, in nm. The DS wavelengths are approx. 303, 306, 310, 313, 317, and 320 nm
  4. aod_i: AOD for the wavelength i
  5. 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.

• 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 J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018). An operative AOD configuration must be available for the requested period.
• Input:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. format: see common formats and jsona format
  5. fields: see Fields in common inputs
  6. means: see means
  7. groupsum: (work in progress, use at your own risk!) group all measurements with the same n_sum value and, if there are 30 measurements (4*6 from JG and 1*6 from DS), return them; should only be used on single days, with both DS and JG measurements
• Output: the following AOD-specific fields are included in the standard output alongside the other usual ones (Brewer ID, pressure, sza, …):
  1. aodconfigid: ID of the AOD configuration used in the calculation
  2. aodconfigdate: date of the AOD configuration used in the calculation
  3. wavelengths_i: wavelength i, in nm.
  4. aod_i: AOD for the wavelength i
  5. 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.

• Function: AODL1_5byStation
• Description: This function provides the same output as the 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.
• Input:
  1. gaw_id or woudc_id: GAW or WOUDC ID of the station
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. format: see Format
  5. means: see means
• Output: same as AODL1_5

• Function: AODConfigAll
• Description: return a summary of all the available AOD configurations
• Example: http://eubrewnet.aemet.es/eubrewnet/data/get/AODConfigAll?format=text
• Input:
  1. brewerid: optional, to show only the configurations of the requested Brewer
  2. non_operative: optional, to show also non-operative configurations
• Output: a table with brewerid, date, and comments fields

• 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&brewerid=185&date=2024-05-21
• Input:
  1. brewerid: id of the requested Brewer
  2. date: date to check
• Output: a table with the complete AOD configuration, one line for each wavelength

• 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 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:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. format: see common formats and jsona format
  5. fields: see Fields in common inputs
  6. showerrors: displays errors found during the calculation.
  7. 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, …):
  1. aodconfigid: ID of the AOD configuration used in the calculation
  2. aodconfigdate: date of the AOD configuration used in the calculation
  3. 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
  4. counts_i: corrected counts for the wavelength i

• Function: AODL1
• 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 J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018). An operative AOD configuration must be available for the requested period.
• Example: http://eubrewnet.aemet.es/eubrewnet/data/process/AODL1?brewerid=185&date=2023-11-12&format=text
• Input:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. format: see common formats and jsona format
  5. fields: see Fields in common inputs
  6. showerrors: displays errors found during the calculation.
  7. 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, …):
  1. aodconfigid: ID of the AOD configuration used in the calculation
  2. aodconfigdate: date of the AOD configuration used in the calculation
  3. wavelengths_i: wavelength i, in nm. The DS six wavelengths are approx. 303, 306, 310, 313, 317, and 320 nm
  4. aod_i: AOD for the wavelength i
  5. counts_i: corrected counts for the wavelength i in real (not brewer) space

• Function: AODL1JG
• Description: returns the corrected counts for the wavelengths in the AOD-specific JG measurements. An operative 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 process AOD L1
• Ouput: same as process AOD L1

• Function: AODL1ALL
• Description: returns corrected counts for the wavelengths in both the DS and the AOD-specific JG measurements. An operative 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 process AOD L1
• Ouput: same as process AOD L1

• Function: AODL1_5
• 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 J. López-Solano et al., Atmos. Chem. Phys. 18, 3885–3902 (2018). An operative 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
• Input:
  1. brewerid: see Brewerid in common inputs
  2. date: see Date in common inputs
  3. enddate: see Enddate in common inputs
  4. format: see common formats and jsona format
  5. fields: see Fields in common inputs
  6. debug: returns additional information, including separate contributions to the AOD from the Ozone, Rayleigh, and counts.
  7. 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 Ozone filter flag, see this table
  8. showerrors: displays errors found during the calculation.
  9. step: optional, return data only for the requested micrometer step
  10. means: see means
• Output: the following AOD-specific fields are included in the standard output alongside the other usual ones (Brewer ID, pressure, sza, …):
  1. aodconfigid: ID of the AOD configuration used in the calculation
  2. aodconfigdate: date of the AOD configuration used in the calculation
  3. 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
  4. aod_i: AOD for the wavelength i
  5. std_aod_i: standard deviation of the AOD summaries at wavelength i
  6. counts_i: corrected counts for the wavelength i in real (not brewer) space

• Function: AODL1_5JG
• Description: returns Aerosol Optical Depth summaries for the wavelengths in the AOD-specific JG measurements. An operative AOD configuration for JG wavelengths must be available for the requested period.
• Example: https://eubrewnet.aemet.es/eubrewnet/data/process/AODL1_5JG?brewerid=185&date=2023-11-12&format=text
• Input: same as process AOD L1.5. Note that means might mix different wavelengths!
• Ouput: same as process AOD L1.5

• Function: AODL1_5ALL
• Description: returns Aerosol Optical Depth summaries for the wavelengths in both the DS and the AOD-specific JG measurements. An operative AOD configuration must be available for the requested period.
• 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 process AOD L1.5. Note that means might mix different wavelengths!
• Ouput: same as process AOD L1.5