codes:aodaccess
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
codes:aodaccess [2023/04/21 10:38] jlsolano [Get AODL1_5] |
codes:aodaccess [2024/05/07 15:01] (current) jlsolano [GET FUNCTIONS] |
||
|---|---|---|---|
| Line 12: | Line 12: | ||
| ===== GET FUNCTIONS ===== | ===== GET FUNCTIONS ===== | ||
| + | |||
| + | 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 ^ Short Description ^ Long Description ^Link ^ | ^ Function ^ Short Description ^ Long Description ^Link ^ | ||
| + | ^ 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]] | | ||
| ^ 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_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_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 ==== | ||
| + | * Function: JG | ||
| + | * Description: returns the raw, L0 JG data as measured by the Brewer. | ||
| + | * 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]] | ||
| + | * Output: the output data includes: | ||
| + | - ''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 | ||
| + | - ''raw_counts_w0'' to ''raw_counts_w5'': counts in the 6 slits | ||
| + | - ''steps'': micrometer step | ||
| + | |||
| + | ---- | ||
| + | ==== Get JL ==== | ||
| + | * Function: JL | ||
| + | * Description: returns the raw, L0 JL data as measured by the Brewer. | ||
| + | * 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]] | ||
| + | * Output: the output data includes: | ||
| + | - ''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 | ||
| + | - ''raw_counts_w0'' to ''raw_counts_w5'': counts in the 6 slits | ||
| + | - ''steps'': micrometer step | ||
| + | |||
| + | ---- | ||
| ==== Get AODL1_5 ==== | ==== Get AODL1_5 ==== | ||
| * Function: AODL1_5 | * Function: AODL1_5 | ||
| Line 34: | Line 70: | ||
| **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_5byStation ==== | ==== Get AODL1_5byStation ==== | ||
| Line 52: | Line 90: | ||
| ^ 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]] | | ||
| + | ^ AODL1 | Returns Level 1 DS corrected counts (dark counts, dead time, temperature, filter attenuation, Sun-Earth distance, and polarization) | [[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 | [[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 | [[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 | [[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 | [[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 from JG measurements | [[codes:aodaccess#process_AODL1_5JG|AODL1_5JG]] | [[https://rbcce-test.aemet.es/eubrewnet/data/process/AODL1_5JG?brewerid=185&date=2022-08-01&format=text|Process AODL1_5JG]] | | + | ^ 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=2023-11-12&format=text|Process AODL1_5JG]] | |
| - | ^ AODL1_5ALL | Returns Level 1.5 AOD from DS and JG measurements | [[codes:aodaccess#process_AODL1_5ALL|AODL1_5ALL]] | [[https://rbcce-test.aemet.es/eubrewnet/data/process/AODL1_5ALL?brewerid=185&date=2022-08-01&format=text&fields=gmt,wavel|Process AODL1_5ALL]] | | + | ^ 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=2023-11-12&format=text&fields=gmt,wavel|Process AODL1_5ALL]] | |
| + | |||
| + | ---- | ||
| ==== AOD Filter Flags ==== | ==== AOD Filter Flags ==== | ||
| Line 66: | Line 110: | ||
| | 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. | ||
| + | * 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 ==== | ||
| + | * Function: AODL1 | ||
| + | * Description: returns the DS corrected counts for the AOD calculation. Corrections included are dark counts, dead time, temperature, filter attenuation, Earth-Sun distance, and polarization. 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=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. 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 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 | ||
| Line 74: | Line 172: | ||
| - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] | - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]] | ||
| - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] | - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]] | ||
| - | - ''format'': see [[codes:dbaccess#format|Format]] | + | - ''format'': see [[codes:dbaccess#format|common formats]] and [[codes:uvaccess#formats|jsona format]] |
| + | - ''fields'': see [[codes:dbaccess#common_inputs|Fields in common inputs]] | ||
| - ''debug'': returns additional information, including separate contributions to the AOD from the Ozone, Rayleigh, and counts. | - ''debug'': returns additional information, including separate contributions to the AOD from the Ozone, Rayleigh, and counts. | ||
| - ''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]] | ||
| Line 86: | Line 185: | ||
| - ''std_aod_i'': standard deviation of the AOD summaries at wavelength //i// | - ''std_aod_i'': standard deviation of the AOD summaries at 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]] | + | * 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]] | ||
| + | ---- | ||
| ==== Process AODL1_5ALL ==== | ==== Process AODL1_5ALL ==== | ||
| * 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]] | + | * 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]] | ||
codes/aodaccess.1682073536.txt.gz · Last modified: 2023/04/21 10:38 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
