ECMWF grib2 data files ECMWF/grib2

ECMWF grib2 data files ECMWF/grib2#

Description#

Read grib files from ECMWF

Grib files are provided either for 3D fields or, for surface variables, for 2D fields. Activate the surface option for treating 2D grib files. In case of grib files for cumulated variables, activate the decumul option. In this case 2 dates are saved in the fetch list and the decumulation is next_date - date

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#

dir : str, optional, default “”

Path to the corresponding component. This value is used if not provided in parameters

file : str, optional, default “”

File format in the given directory. This value is used if not provided in parameters

varname : str, optional, default “”

Variable name to use to read data filesinstead of the parameter name if different to the parameter name

file_freq : str, optional, default “3H”

Frequency at which files are saved

split_freq : str, optional

Force splitting the processing at a given frequency different to file_freq

decumul : bool, optional, default False

activates decumulation

cumul_length : int, optional, default 12

if cumulation length differ from 12h, in hour

surface : bool, optional, default False

for treating 2D fields (e.g. surface variables)

expand_psurf : bool, optional, default False

Expand surface pressure to full pressure field

pressure_thickness : bool, optional, default False

Returns the pressure thickness of each level. To be used with expand_psurf

domain_file : str, optional

Name of the file to use to deduce the domain, if different from the file format specified for data reading

delta_tolerance : int, optional, default 1

Tolerance for getting the closest valid file.The value is multiplied by file_freq.

filter_by_keys : optional

Can filter only some variables following some keys:

Argument structure:
edition : int, optional

Filter by edition.

dir_hcoord_corner : str, optional, default “”

Directory containing file_hcoord_corner. Use this argument if the grid is octahedral

file_hcoord_corner : str, optional, default “”

csv file giving the coordinates of grid corners for octahedral grids

YAML template#

Please find below a template for a YAML configuration:

 1field:
 2  plugin:
 3    name: ECMWF
 4    version: grib2
 5    type: field
 6
 7  # Optional arguments
 8  dir: XXXXX  # str
 9  file: XXXXX  # str
10  varname: XXXXX  # str
11  file_freq: XXXXX  # str
12  split_freq: XXXXX  # str
13  decumul: XXXXX  # bool
14  cumul_length: XXXXX  # int
15  surface: XXXXX  # bool
16  expand_psurf: XXXXX  # bool
17  pressure_thickness: XXXXX  # bool
18  domain_file: XXXXX  # str
19  delta_tolerance: XXXXX  # int
20  filter_by_keys:
21    edition: XXXXX  # int
22  dir_hcoord_corner: XXXXX  # str
23  file_hcoord_corner: XXXXX  # str