TROPOMI XCH4 retrievals – Official RPRO product TROPOMI/CH4-RPRO

TROPOMI XCH4 retrievals – Official RPRO product TROPOMI/CH4-RPRO#

Description#

This plugin reads TROPOMI XCH4 retrievals as provided by the official ESA product. It uses the albedo-corrected version of the data, called ‘RPRO’. Data can be downloaded here: `https://catalogue.dataspace.copernicus.eu/resto/api/collections/Sentinel5P/search.json?productType=L2__CH4___`__.

The data is described in Lorente et al. (2023)

Further documentation is available here:

  • Readme https://sentinels.copernicus.eu/documents/247904/3541451/Sentinel-5P-Methane-Product-Readme-File

  • User guide https://sentinel.esa.int/documents/247904/2474726/Sentinel-5P-Level-2-Product-User-Manual-Methane.pdf/1808f165-0486-4840-ac1d-06194238fa96

  • ATBD https://sentinel.esa.int/documents/247904/2476257/Sentinel-5P-TROPOMI-ATBD-Methane-retrieval.pdf/f275eb1d-89a8-464f-b5b8-c7156cda874e

For filtering data, it is recommended (see Readme) to keep only observations with a ’qa_value’ above 0.5.

YAML arguments#

The following arguments are used to configure the plugin. pyCIF will return an exception at the initialization if mandatory arguments are not specified, or if any argument does not fit accepted values or type:

Optional arguments#

orbit_range : optional

Range of orbit IDs to cover

Argument structure:
orb_min : int, optional, default -10

Minimum orbit ID

orb_max : int, optional, default 10000000

Minimum orbit ID

aggreg_freq : str, optional, default “1D”

Frequency at which to aggregate files into intermediate monitor file

crop_domain : optional

Domain where to keep data. Data outside are discarded

Argument structure:
xmin : float, mandatory

West boundary

xmax : float, mandatory

East boundary

ymin : float, mandatory

South boundary

ymax : float, mandatory

North boundary

nlayers : float, optional, default 12

Number of layers expected in the averaging kernels

obs_duration : float, optional, default 0.016666666666666666

Duration of each observation

stationID : str, optional, default “TROPOMI”

Name to put in the ‘station’ column of the output parsed datastore

networkID : str, optional, default “OFFICIAL-RPRO”

Name to put in the ‘network’ column of the output parsed datastore

parameter : str, optional, default “CH4”

Name of the species to put in the ‘parameter’ column of the output parsed datastore

qa_value : float, optional, default 0.5

Keep diagnostic group above qa_value

YAML template#

Please find below a template for a YAML configuration:

 1obsparser:
 2  plugin:
 3    name: TROPOMI
 4    version: CH4-RPRO
 5    type: obsparser
 6
 7  # Optional arguments
 8  orbit_range:
 9    orb_min: XXXXX  # int
10    orb_max: XXXXX  # int
11  aggreg_freq: XXXXX  # str
12  crop_domain:
13    xmin: XXXXX  # float
14    xmax: XXXXX  # float
15    ymin: XXXXX  # float
16    ymax: XXXXX  # float
17  nlayers: XXXXX  # float
18  obs_duration: XXXXX  # float
19  stationID: XXXXX  # str
20  networkID: XXXXX  # str
21  parameter: XXXXX  # str
22  qa_value: XXXXX  # float