Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Data on constant pressure levels (type=pl) are provided at level=100 only.
  • Data on theta levels (type=pt) are provided at level=300 for type=fc and level=265 only for type=an.
  • Data on potential vorticity levels (levtype=pv) are provided at level=1500 only.
  • Parameters accumulated from the start of the forecast have the ecCodes startStep key consistently set to 0 and, consequently, stepRange=0-24 in GRIB2 compared to stepRange=24, etc, in GRIB1
  • Parameters accumulated from the start of the forecast are not provided at stepRange=0. 

Directory structure of static sample dataset

...

Data are ordered in a MARS-like folder structure under <root_dir>/<class>/<stream>/<type>/<levtype>.  Shown below is a diagrammatic layout of the directory structure under <root_dir>=/ec/vol/mtg2_sample/: 

No Format
<root_dir>/od/enfo
└── pf
    ├── pl
    ├── pt
    ├── pv
    ├── sfc
    └── sol

<root_dir>/od/oper
├── an
│   ├── ml
│   ├── pl
│   ├── pt
│   ├── pv
│   ├── sfc
│   └── sol
└── fc
    ├── ml
    ├── pl
    ├── pt
    ├── pv
    ├── sfc
    └── sol

<root_dir>/od/scdawaef
├──└── anpf
   ├── ml
│   ├── pl
│   ├── pt
│   ├── pv└── sfc

<root_dir>/od/wave
├── an  ├── └── sfc
│   └── sol
└── fc
    ├──└── ml
    ├── pl
    ├── pt
    ├── pv
    ├── sfc
    └── sol

<root_dir>/od/scwv
├── an
│   └── sfc
└── fc
    └── sfc

<root_dir>/od/waef
└── pf
    └── sfc

<root_dir>/od/wave
├── an
│   └── sfc
└── fc
    └── sfc

sfc


Structure of file namesStructure of filenames

Each directory at the end of the tree contains one file per parameter containing all forecast time steps.  The files are named <paramId>_<class>_<stream>_<type>_<levtype>_<shortName>_<year>_<expver>_<gridType>.grib2 and are based on the ecCodes paramId, shortName and gridType and the MARS class, stream, type, levtype used for the current operational output at IFS cy49r1.

...

For example, in GRIB1, there is a paramId for Volumetric soil water layer 1 and a different paramId for Volumetric soil water layer 2, etc.  In GRIB2, only a single paramId is used for Volumetric soil water, with the layer 1 having level=1 and layer 2 having level=2. having level=2. 

Old paramIdOld shortNameNew paramIdNew shortNamelevelnameunits
139stl1260360sot1Soil temperatureK
170stl2260360sot2Soil temperatureK
183stl3260360sot3Soil temperatureK
236stl4260360sot4Soil temperatureK
39swvl1260199vsw1Volumetric soil moisturem**3 m**-3
40swvl2260199vsw2Volumetric soil moisturem**3 m**-3
41swvl3260199vsw3Volumetric soil moisturem**3 m**-3
42swvl4260199vsw4Volumetric soil moisturem**3 m**-3
35istl1262024sit1Sea ice temperature K
36istl2262024sit2Sea ice temperature K
37istl3262024sit3Sea ice temperature K
38istl4262024sit4Sea ice temperature K

...

To retrieve these parameters in GRIB2 from MARS, users will need to use the new paramId and also specify the statistical processing time window using a new MARS keyword - timespan - that is to be introduced. 

Maximum 10m wind gust

Old paramIdOld shortNameNew ParamIdNew shortNametimespanstepTypenameunits
4910fg237318max_i10fg1h/3h/6hmaxTime-maximum 10 metre wind gustm s**-1
22802810fg3237318max_i10fg3hmaxTime-maximum 10 metre wind gust m s**-1
12310fg6237318max_i10fg6hmaxTime-maximum 10 metre wind gust m s**-1

...

1

Maximum and minimum 2m temperature

Old paramIdOld shortNameNew ParamIdNew shortNametimespanstepTypenameunits
201mx2t237167max_2t1h/3h/6hmaxTime-maximum 2 metre temperature K
202mn2t238167min_2t1h/3h/6hminTime-minimum 2 metre temperatureK
228026mx2t3237167max_2t3hmaxTime-maximum 2 metre temperature K
228027mn2t3238167min_2t3hminTime-minimum 2 metre temperatureK
121mx2t6237167max_2t6hmaxTime-maximum 2 metre temperature K
122mn2t6238167min_2t6hminTime-minimum 2 metre temperature K

Maximum and minimum total precipitation rate

Old paramIdOld shortNameOld unitsNew paramIdNew shortNametimespanstepTypenameunits
228226mxtprkg m**-2 s**-1 237055max_tprate1h/3h/6hmaxTime-maximum total precipitation ratekg m**-2 s**-1 
228227mntprkg m**-2 s**-1 238055min_tprate1h/3h/6hminTime-minimum total precipitation ratekg m**-2 s**-1 
228222mxtpr3kg m**-2 s**-1 237055max_tprate3hmaxTime-maximum total precipitation ratekg m**-2 s**-1
228223mntpr3kg m**-2 s**-1 238055min_tprate3hminTime-minimum total precipitation ratekg m**-2 s**-1
228224mxtpr6kg m**-2 s**-1 237055max_tprate6hmaxTime-maximum total precipitation ratekg m**-2 s**-1
228225mntpr6kg m**-2 s**-1 238055min_tprate6hminTime-minimum total precipitation ratekg m**-2 s**-1

...

**-1

Maximum CAPE and CAPE Shear

Old paramIdOld shortNameOld unitsNew paramIdNew shortNametimespanstepTypenameunits
228035mxcape6J kg**-1237287max_cape6hmaxTime-maximum convective available potential energy J kg**-1
228036mxcapes6m**2 s**-2237321max_capes6hmaxTime-maximum convective available potential energy shearm**2 s**-2

Mean total lightning flash density

Old paramIdOld shortNameOld unitsNew paramIdNew shortNametimespanstepTypenameunits
228051litota1km**-2 day**-1235326avg_litoti1h/3h/6havgTime-mean total lightning flash density km**-2 day**-1
228057litota3km**-2 day**-1235326avg_litoti3havgTime-mean total lightning flash density km**-2 day**-1
228058litota6km**-2 day**-1235326avg_litoti6havgTime-mean total lightning flash density km**-2 day**-1

...

**-1

Most severe and most frequent precipitation type

Old paramIdOld shortNameNew paramIdNew shortNametimespanstepTypename
260318ptype_sev1h260682sev_ptype1hseverityTime-severity precipitation type
260319ptype_sev3h260682sev_ptype3hseverityTime-severity precipitation type
260338ptype_sev6h260682sev_ptype6hseverityTime-severity precipitation type
260320ptype_freq1h260683freq_ptype1hmodeTime-mode precipitation type
260321ptype_freq3h260683freq_ptype3hmodeTime-mode precipitation type
260339ptype_freq6h260683freq_ptype6hmodeTime-mode precipitation type

...

  • the unit of Sea surface practical salinity and Average sea water practical salinity in the upper 300 m has changed from psu to g/kg;
  • the unit of the Average sea water potential temperature in the upper 300m has changed from degrees Celsius to Kelvin.
Old paramIdOld shortNameOld unitsNew paramIdNew shortNamenameunits
151130sopsu262100sosSea surface practical salinityg kg**-1
151131ocum s**-1262140sveEastward surface sea water velocitym s**-1
151132ocvm s**-1262139svnNorthward surface sea water velocitym s**-1
151145zosm262124zosSea surface heightm
151148mldm3067mldMixed layer depthm
151163t20dm262104t20dDepth of 20 C isothermm
151164tav300degrees C262144pt300mAverage sea water potential temperature in the upper 300mK
151175sav300psu262118sc300mAverage sea water practical salinity in the upper 300 mg kg**-1
174098sithickm262000sithickSea ice thicknessm

...

In GRIB1, parameters that are fluxes of chemical species have different paramIds for each chemical species and type of flux.  In GRIB2, a unique paramId indicates the type of flux and a new key called chemShortName identifies the chemical.  For example, paramId=435000 refers to the Net ecosystem exchange flux and the chemShortName=CO2 identifies this as the Carbon dioxide net ecosystem exchange flux.

Old paramIdOld shortNameOld unitsNew paramIdNew shortNamechemShortNamestepTypenameunits
228080aco2neekg m**-2435002aneefCO2accumAccumulated net ecosystem exchange fluxkg m**-2
228081aco2gppkg m**-2436002agppfCO2accumAccumulated gross primary production fluxkg m**-2
228082aco2reckg m**-2437002aerfCO2accumAccumulated ecosystem respiration fluxkg m**-2
228083fco2neekg m**-2435000neefCO2instantNet ecosystem exchange fluxkg m**-2 s**-1
228084fco2gppkg m**-2436000gppfCO2instantGross primary production fluxkg m**-2 s**-1
228085fco2reckg m**-2437000erfCO2instantEcosystem respiration fluxkg m**-2 s**-1

...