Eubrewnet Wiki

User Tools

Site Tools

Trace: • productsdescription • dbaccess • calibration
codes:calibration

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:calibration [2024/04/05 12:21] – [ERA5 comparison] ajberjoncodes:calibration [2025/10/14 13:09] (current) – ajberjon
Line 1: Line 1:
-===== Calibration Functions =====+/==== Calibration Functions =====
  
 This page provides a brief overview of the functions avaliable in Eubrewnet to determine Brewer configuration parameters. This page provides a brief overview of the functions avaliable in Eubrewnet to determine Brewer configuration parameters.
  
 ---- ----
 +
 ==== Langley ==== ==== Langley ====
   * Function: ''langley''   * Function: ''langley''
   * Description: Determine the ETC and the ETC filter corrections applying the Langley-plot method to each half day.   * Description: Determine the ETC and the ETC filter corrections applying the Langley-plot method to each half day.
-  * Access function example: https://rbcce.aemet.es/eubrewnet/data/cal/langley?brewerid=185&date=2022-04-01&enddate=2022-04-10&format=text +  * Access function example: https://eubrewnet.aemet.es/eubrewnet/data/cal/langley?brewerid=185&date=2022-04-01&enddate=2022-04-10&format=text 
-  * Input: a complete list of input arguments is provided next, but we strongly recommed to use the web interface at https://rbcce.aemet.es/eubrewnet/caldata/langley to access this function+  * Input: a complete list of input arguments is provided next, but we strongly recommed to use the web interface at https://eubrewnet.aemet.es/eubrewnet/caldata/langley to access this function
       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]
       - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]]       - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]]
Line 44: Line 45:
     * Function: ''fcor_o3dif''     * Function: ''fcor_o3dif''
     * Description: this function returns the ETC filter corrections (with respect to the mean of filters 1 and 2) as calculated from the ozone differences of near-simultaneous measurements taken with different filters. Mathematically, for two measurements taken with different filters at almost the same airmass μ and with a ΔO3L1 difference in the (uncorrected) ozone, Δfiltercorr=ΔO3L1∗μ∗abscoeff∗10     * Description: this function returns the ETC filter corrections (with respect to the mean of filters 1 and 2) as calculated from the ozone differences of near-simultaneous measurements taken with different filters. Mathematically, for two measurements taken with different filters at almost the same airmass μ and with a ΔO3L1 difference in the (uncorrected) ozone, Δfiltercorr=ΔO3L1∗μ∗abscoeff∗10
-    * Access function example: https://rbcce.aemet.es/eubrewnet/data/cal/fcor_o3dif?brewerid=185&format=text&minutes=15&airmass=0.03&date=2022-01-01&enddate=2022-02-01+    * Access function example: https://eubrewnet.aemet.es/eubrewnet/data/cal/fcor_o3dif?brewerid=185&format=text&minutes=15&airmass=0.03&date=2022-01-01&enddate=2022-02-01
     * Input:     * Input:
       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]
Line 64: Line 65:
     * Function: ''fcor_o3dif_raw''     * Function: ''fcor_o3dif_raw''
     * Description: this function returns the raw data used in the fcor_o3dif function. That is, it returns Δfiltercorr=ΔO3L1∗μ∗abscoeff∗10 for each pair of measurements, without referring the result to filters 1 and 2 nor calculating any median over a date range.     * Description: this function returns the raw data used in the fcor_o3dif function. That is, it returns Δfiltercorr=ΔO3L1∗μ∗abscoeff∗10 for each pair of measurements, without referring the result to filters 1 and 2 nor calculating any median over a date range.
-    * Access function example: https://rbcce.aemet.es/eubrewnet/data/cal/fcor_o3dif_raw?brewerid=185&format=text&minutes=15&airmass=0.03&date=2022-01-01&enddate=2022-02-01+    * Access function example: https://eubrewnet.aemet.es/eubrewnet/data/cal/fcor_o3dif_raw?brewerid=185&format=text&minutes=15&airmass=0.03&date=2022-01-01&enddate=2022-02-01
     * Input:     * Input:
       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]
Line 90: Line 91:
     * Function: ''fcor_fioavg''     * Function: ''fcor_fioavg''
     * Description: this function returns the ETC filter corrections (with respect to the mean of filters 1 and 2) as calculated from the results of the Brewer filter tests with the standard lamp, as found in the FIOAVG file.     * Description: this function returns the ETC filter corrections (with respect to the mean of filters 1 and 2) as calculated from the results of the Brewer filter tests with the standard lamp, as found in the FIOAVG file.
-    * Access function example: https://rbcce.aemet.es/eubrewnet/data/cal/fcor_fioavg?brewerid=185&format=text&date=2022-01-01&enddate=today+    * Access function example: https://eubrewnet.aemet.es/eubrewnet/data/cal/fcor_fioavg?brewerid=185&format=text&date=2022-01-01&enddate=today
     * Input:     * Input:
       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]
Line 109: Line 110:
   * Function: ''TempCoef''   * Function: ''TempCoef''
   * Description: This function analyses the temperature sensitivity of SL measurements.   * Description: This function analyses the temperature sensitivity of SL measurements.
-  * Example: https://eubrewnet.aemet.es/eubrewnet/data/process/TempCoef?brewerid=40&tc&tmin=5&tmax=40&alpha=3&date=2021-07-06&enddate=2021-07-16&format=text+  * Example: http://eubrewnet.aemet.es/eubrewnet/data/process/TempCoef?brewerid=258&tmin=5&tmax=40&alpha=3&date=2023-02-22&enddate=2023-06-22&format=text&time&urlconfig&dt=0.000000028
   * Input:   * Input:
       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]
Line 132: Line 133:
       - ''tmax'': Maximum temperature used in the linear regression.       - ''tmax'': Maximum temperature used in the linear regression.
       - If the parameter ''time'' is passed, three more coefficients are returned (the time dependence considered is of degree 3) together with their standard errors: c,sc,d,sd,e,se.        - If the parameter ''time'' is passed, three more coefficients are returned (the time dependence considered is of degree 3) together with their standard errors: c,sc,d,sd,e,se. 
 +
 ---- ----
  
Line 167: Line 169:
   * Function: ''CI'' or ''CJ''    * Function: ''CI'' or ''CJ'' 
   * Description: Return the data from the CI (forward scan) or CJ (forward and backward scans) lamp tests. For CJ, the two scans are shown as two measurements with close but different times.   * Description: Return the data from the CI (forward scan) or CJ (forward and backward scans) lamp tests. For CJ, the two scans are shown as two measurements with close but different times.
-  * Example: [[https://rbcce.aemet.es/eubrewnet/data/get/CJ?brewerid=258&date=2023-04-01&enddate=2023-05-01&format=text&fields=gmt,lamp,raw_counts*]]+  * Example: [[https://eubrewnet.aemet.es/eubrewnet/data/get/CJ?brewerid=258&date=2023-04-01&enddate=2023-05-01&format=text&fields=gmt,lamp,raw_counts*]]
   * Input:   * Input:
       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]
Line 189: Line 191:
   * Function: ''CZ''    * Function: ''CZ'' 
   * Description: Return the data from the CZ lamp tests. Because in this test the wavelengths are defined by the Brewer operator, Eubrewnet's output is different than in the case of the CI/CJ tests. In particular,  the ''l'' in fields such as ''mmmm_l'' is now just a numerical index from 0 to 149, and the wavelengths are shown in the new ''wavelengths_l'' fields   * Description: Return the data from the CZ lamp tests. Because in this test the wavelengths are defined by the Brewer operator, Eubrewnet's output is different than in the case of the CI/CJ tests. In particular,  the ''l'' in fields such as ''mmmm_l'' is now just a numerical index from 0 to 149, and the wavelengths are shown in the new ''wavelengths_l'' fields
-  * Example: [[https://rbcce.aemet.es/eubrewnet/data/get/CZ?brewerid=183&date=2023-02-11&format=text]]+  * Example: [[https://eubrewnet.aemet.es/eubrewnet/data/get/CZ?brewerid=183&date=2023-02-11&format=text]]
   * Input: same as for the CI and CJ functions, see above   * Input: same as for the CI and CJ functions, see above
   * Output: the output is quite similar to that of the CI and CJ functions, the main difference being that the ''_l'' suffix is now a numerical index instead of a wavelength. There are also some new fields:   * Output: the output is quite similar to that of the CI and CJ functions, the main difference being that the ''_l'' suffix is now a numerical index instead of a wavelength. There are also some new fields:
Line 201: Line 203:
   * Function: ''NI''    * Function: ''NI'' 
   * Description: Return the data from the NI responsivity tests.    * Description: Return the data from the NI responsivity tests. 
-  * Example: [[https://rbcce.aemet.es/eubrewnet/data/get/NI?brewerid=185&date=2022-08-31&format=text]]+  * Example: [[https://eubrewnet.aemet.es/eubrewnet/data/get/NI?brewerid=185&date=2022-08-31&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 218: Line 220:
   * Functions: ''HS'' and ''HL''   * Functions: ''HS'' and ''HL''
   * Description: Return the data from the short (2950 – 2984 Å) and long (3331 – 3351 Å) wavelength-range Mercury lamp tests   * Description: Return the data from the short (2950 – 2984 Å) and long (3331 – 3351 Å) wavelength-range Mercury lamp tests
-  * Example: [[https://rbcce.aemet.es/eubrewnet/data/get/HL?brewerid=185&date=2022-08-31&format=text]]+  * Example: [[https://eubrewnet.aemet.es/eubrewnet/data/get/HL?brewerid=185&date=2022-08-31&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 233: Line 235:
 ---- ----
  
-==== ERA5 comparison ====+==== compareERA5 ====
   * Functions: ''compareERA5''   * Functions: ''compareERA5''
-  * Description: Compares the hourly average 1.5 level ozone product for a given brewer with the [[https://cds.climate.copernicus.eu/cdsapp#!/dataset/reanalysis-era5-pressure-levels|Total ozone column product from the ERA5 reanalysis provided by ECMWF]]. +  * Description: Compares the hourly average 1.5 level ozone product for a given brewer with the [[https://cds.climate.copernicus.eu/datasets/reanalysis-era5-pressure-levels?tab=overview|Total ozone column product from the ERA5 reanalysis provided by ECMWF]].  
-  * Example: [[http://eubrewnet.aemet.es/eubrewnet/data/get/compareERA5?brewerid=157&date=2022-01-01&enddate=2022-01-31&format=text]]+  * Example: [[http://eubrewnet.aemet.es/eubrewnet/data/get/compareERA5?brewerid=157&stationid=9&date=2022-01-01&enddate=2022-01-31&format=text]]
   * Input:   * Input:
       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]       - ''brewerid'': see [[codes:dbaccess#common_inputs|Brewerid in common inputs]]
 +      - ''stationid'': Eubrewnet station id. If ''stationid'' is not provided, the station where the Brewer is located in ''date'' is used to select the ERA5 data.
       - ''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|Format]]
       - ''debug'': In the output, individual measurements are returned instead of hourly averages.       - ''debug'': In the output, individual measurements are returned instead of hourly averages.
 +      - ''v2'': The comparison is made using the ozone product level 1.5 version 2 for the Brewer.
 +
   * Output:   * Output:
       - ''gmt'': UTC time.       - ''gmt'': UTC time.
Line 249: Line 254:
       - ''diff'': difference between o3_avg and o3_era5 in Dobson units.       - ''diff'': difference between o3_avg and o3_era5 in Dobson units.
       - ''reldiff'': relative difference between o3_avg and o3_era5 in %       - ''reldiff'': relative difference between o3_avg and o3_era5 in %
-.+
 ---- ----
  
 +==== ERA5 ====
 +  * Functions: ''ERA5''
 +  * Description: Retrieve the [[https://cds.climate.copernicus.eu/cdsapp#!/dataset/reanalysis-era5-pressure-levels|Total ozone column product from the ERA5 reanalysis provided by ECMWF]].
 +  * Example: [[http://eubrewnet.aemet.es/eubrewnet/data/get/ERA5?gaw_id=IZO&date=2022-01-01&enddate=2022-01-13&format=text]]
 +  * Input:
 +      - ''gaw_id'' or ''stationid'': GAW or Eubrewnet station id.
 +      - ''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|Format]]
  
 +  * Output:
 +      - ''gmt'': UTC time.
 +      - ''o3'' Total ozone column from ERA5 for the station at which the brewer was at ''date''.
 +      - ''stationid'': Eubrewnet station id.
 +
 +----
 +
 +==== compareO3 ====
 +  * Functions: ''compareO3''
 +  * Description: compare the O3L1.5 measurements of two brewers
 +  * Example: [[http://eubrewnet.aemet.es/eubrewnet/data/get/compareO3?brewerid=185&compid=258&date=2024-08-23&format=text&maxminutes=10&avg]]
 +  * Input:
 +      - ''brewerid'' and ''compid'': ids of the reference and to-be-compared brewers, respectively.
 +      - ''maxminutes'': maximum difference in minutes between the measurements of the two brewers. If not provided, defaults to 2.5 minutes
 +      - ''avg'': return the average of the comp measurements corresponding to each one of the reference. If not passed as an argument, each individual measurement is listed in the output
 +      - ''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|Format]]
 +
 +  * Output:
 +      - ''gmt'' and ''compgmt'': UTC time of the reference and to-be-compared brewers, respectively.
 +      - ''o3'' and ''compo3'': total ozone column values.
 +      - ''airmass'' and ''compairmass'': airmasses.
 +      - ''osc'' and ''composc'': OSC=ozone*airmass values
 +      - ''filt'' and ''compfilt'': filter positions
 +      - ''deltaminutes'': difference in minutes between the measurements
 +      - (only if ''avg'' is passed as option) ''compn'' and ''compsdo3'': number of measurements and the standard deviation of the o3, respectively, for all the comp measurements within ''maxminutes'' of the time of the reference. Note the other comp fields correspond to averages of the comp measurements.
 +
 +----
 +
 +==== o3diff ====
 +  * Functions: ''o3diff''
 +  * Description: compare the O3L1.5 measurements of two brewers. 
 +  * Example: [[http://eubrewnet.aemet.es/eubrewnet/data/get/o3diff?brewerid=185&ref=157,183,185&stationid=9&date=2024-01-01&enddate=2024-01-30&format=text]]
 +  * Input:
 +      - ''brewerid'' and ''ref'': Id of the input Brewer and of the reference to which it is compared. The reference can include several brewer Ids separated by commas.
 +      - ''stationid'': Id of the gestation to limit the data to.
 +      - ''date'': see [[codes:dbaccess#common_inputs|Date in common inputs]]
 +      - ''enddate'': see [[codes:dbaccess#common_inputs|Enddate in common inputs]]
 +      - ''timew'': duration in minutes of the time window in which the values of the input Brewer and the reference are averaged as coincident data. Defaults to a value of 5 minutes.
 +      - ''format'': see [[codes:dbaccess#format|Format]]
 +      - ''v2ins'': The comparison is made using the ozone product level 1.5 version 2 for the instrument.
 +      - ''v2ref'': The comparison is made using the ozone product level 1.5 version 2 for the reference.
 +
 +  * Output:
 +      - ''gmt'': UTC start time of the time window.
 +      - ''o3'': total ozone column for the reference.
 +      - ''diff'': ozone relative difference in % between the input brewer and the reference.
 +      - ''airmass'': mean airmass.
 +      - ''temperature'': mean temperature for the input brewer.
 +
 +----
  
  
codes/calibration.1712319696.txt.gz · Last modified: 2024/04/05 12:21 by ajberjon