TROPOMI-GOSAT XCH4 retrievals from Balasus TROPOMI/CH4-BLENDED

TROPOMI-GOSAT XCH4 retrievals from Balasus TROPOMI/CH4-BLENDED#

Description#

This plugin reads TROPOMI XCH4 retrievals as provided by Balasus et al. Data can be downloaded here: <https://dataverse.harvard.edu/dataverse/blended-tropomi-gosat-methane>

The data is described in Balasus et al. (2023) <https://doi.org/10.5194/amt-16-3787-2023>

For filtering data, the article mentions that:

  • highest quality data should be kept: ‘qa’ = 1

  • filtering coastal scenes: removing pixels with ‘surface classification’ = 3 or (‘surface classification’ = 2 & SWIR chi2 > 20000)

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#

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 “BLENDED”

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

filter_coastal_scene : bool, optional, default True

Threshold for chi-square value

qa_value : float, optional, default 1

Keep diagnostic group equal to qa_value

YAML template#

Please find below a template for a YAML configuration:

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