Eubrewnet Wiki

User Tools

Site Tools

Trace: • aodaccess
codes:aodaccess

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
codes:aodaccess [2024/05/17 12:06] – [Process AODL1_5] jlsolanocodes:aodaccess [2025/02/14 14:09] (current) – external edit 127.0.0.1
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 7: Line 9:
  
 ==== Formats ==== ==== Formats ====
-Besides the common formats described [[codes:dbaccess#format|here]], the [[codes:uvaccess#formats|jsona]] format can also be used to produce 2d arrays for the ''aod_l'' and ''std_aod_l'' variables, see [[https://rbcce.aemet.es/eubrewnet/data/process/AODL1_5?brewerid=005&date=2017-07-01&format=jsona|this example]]+Besides the common formats described [[codes:dbaccess#format|here]], the [[codes:uvaccess#formats|jsona]] format can also be used to produce 2d arrays for the ''aod_l'' and ''std_aod_l'' variables, see [[https://eubrewnet.aemet.es/eubrewnet/data/process/AODL1_5?brewerid=005&date=2017-07-01&format=jsona|this example]]
  
 ---- ----
Line 23: Line 25:
 ^ 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_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]] |
 +^ AODConfigAll | return all AOD configurations |[[codes:aodaccess#get_AODConfigAll|AODConfigAll]] | [[http://eubrewnet.aemet.es/eubrewnet/data/get/AODConfigAll?format=text|Get AODConfigAll]] |
 +^ AODConfigbyDate | return the operative AOD configuration for the requested Brewer and date |[[codes:aodaccess#get_AODConfigbyDate|AODConfigbyDate]] | [[http://eubrewnet.aemet.es/eubrewnet/data/get/AODConfigbyDate?format=text&brewerid=185&date=2024-05-21|Get AODConfigbyDate]] |
  
 ---- ----
 +
 +
 ==== Get JG ==== ==== Get JG ====
   * Function: JG   * Function: JG
Line 126: Line 132:
       - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]]       - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]]
       - ''means'': see [[codes:dbaccess#means|means]]       - ''means'': see [[codes:dbaccess#means|means]]
 +      - ''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, ...):   * 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
Line 137: Line 144:
 ---- ----
 ==== 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 150: Line 157:
 ---- ----
  
 +==== 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
 +      - ''non_operative'': optional, to show also non-operative configurations
 +  * 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&brewerid=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 ^
-^ 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]] |+^ JGL1 | Returns Level 1 JG corrected counts (dark counts, dead time, temperature, and filter attenuation) | [[codes:aodaccess#process_JGL1|JGL1]] | [[https://eubrewnet.aemet.es/eubrewnet/data/process/JGL1?brewerid=185&date=2023-11-12&format=text|Process AODL1JG]] |
 ^ 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 | 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]] |
-^ 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]] | +^ AODL1JG | Returns Level 1 JG corrected counts and AOD | [[codes:aodaccess#process_AODL1JG|AODL1JG]] | [[https://eubrewnet.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]] | +^ AODL1ALL | Returns Level 1 DS and JG corrected counts and AOD | [[codes:aodaccess#process_AODL1ALL|AODL1ALL]] | [[https://eubrewnet.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_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|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_5JG | Returns Level 1.5 AOD for JG measurements | [[codes:aodaccess#process_AODL1_5JG|AODL1_5JG]] | [[https://eubrewnet.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]] |+^ AODL1_5ALL | Returns Level 1.5 AOD for DS and JG measurements | [[codes:aodaccess#process_AODL1_5ALL|AODL1_5ALL]] | [[https://eubrewnet.aemet.es/eubrewnet/data/process/AODL1_5ALL?brewerid=185&date=2023-11-12&format=text&fields=gmt,wavel|Process AODL1_5ALL]] |
  
 ---- ----
Line 210: Line 239:
       - ''wavelengths_i'': wavelength //i//, in nm. The DS six wavelengths are 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//       - ''aod_i'': AOD for the wavelength //i//
-      - ''counts_i'': corrected counts for the wavelength //i//+      - ''counts_i'': corrected counts for the wavelength //i//  in real (not brewer) space 
  
 ---- ----
Line 232: Line 262:
 ==== 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
   * Input:   * Input:
       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]
Line 251: Line 281:
       - ''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//+      - ''counts_i'': corrected counts for the wavelength //i// in real (not brewer) space
  
 ---- ----
codes/aodaccess.1715947600.txt.gz · Last modified: 2024/05/17 12:06 by jlsolano