Encoding details

General requirements

Encoding format

• WMO GRIB2 data format.

Missing values

• Bitmaps shall be used to indicate missing values.

Grid and resolution

• Each partner will provide their eps data on a 0.25/0.25 regular lat-lon grid (1440x721 grid points, including poles).
• First grid point is 90N 0E. The data will be archived first from west to east (OE to 358.5), and then from north to south (90N to 90S).
• The related GRIB 2 meta data called scanning mode  should equal to 0.

  • Scanning mode 0 i scans positively (west to east) i points are consecutive j scans negatively (north to south)

• The fields have to be provided on...
• Grids are defined in GRIB2 using an accuracy of 1/1000000 (one millionth) of a degree.

Data compression

CCSDS compression should be used

GRIB2 encoding

All data must be encoded following the required rules described below to achieve fully compliant WPMIP format from all centres.

Encoding software

ECMWF makes available a GRIB decoding library (ecCodes) for the benefit of the WMO community. ecCodes can be freely downloaded from here and the documentation can be found here.

For more general information about GRIB2 format please refer to WMO Manual on Codes .

Encoding details

General encoding (TBA)

Specific details which should be encoded in GRIB2 sections 1 and 4:

*1 New WMO tables version 36 (containing also new WPMIP keys) will be officialy released by WMO later in 2025 (November)

*2 New codes for the WPMIP (part of GRIB 2 tables version 36) to be approved by WMO by August 2025 (Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 1.3)

*1 statistically processed (typeOfStatisticalProcessing is set up)

*2 centre/model version dependent (see below)

Centre codes and model versions

WMO Centre key for WPMIP together with subCentre defined for each organization is used to identified each data provider

• it was agreed that a new WMO centre code for WPMIP will be needed 
  • the current deadline for WMO proposals is 3rd October 2025. Proposals made at this meeting will be approved (and new GRIB2/BUFR4 codes available) in May 2026. 
  • it is assumed that centre=323 which is currently free, could be assigned for the project and thus could be used in advance
    • if it changes,  we would have to update the centre code as needed

Model name (e.g. ecmf_AIFS_v1_oic) is identified in ecCodes for given centre, model and model version from following keys:

• centre (unique for each provider)
  • https://codes.ecmwf.int/grib/format/mars/centre/
    • most centre's acronym come originally from GTS ones as per https://community.wmo.int/en/activity-areas/operational-information-service/routeing-catalogues
    • more recently we have started adding new acronyms as needed (without any relations to GTS)
• backgroundProcess (unique for each model)
• generatingProcessIdentifier  (unique for each model version)

For example model=ecmf_AIFS_v1_oic would be encoded using:

• centre=98
• backgroundProcess=1
• generatingProcessIdentifier=1

Initial conditions

• own initial conditions (OIC)
• same initial conditions (SIC)

WMO centre=323 (expected code for WPMIP project in next WMO tables release)

Remarks:

*1 in ECMWF's ecCodes package

*2 to be added to ECMWF's ecCodes package

*3 WMO to be asked for a new code

Examples of  the required GRIB2 files

*1 using "grib_dump -O" command from ecCodes package