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 359.75), 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)

• 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

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)

*3 New code for the WPMIP  to be approved by WMO in Q4 2025

*1 statistically processed (typeOfStatisticalProcessing is set up)

*2 centre/model version dependent (see table with Centre codes 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 accordingly
      • such changes would be handled by WP-MIP project leads (in the already existing data)

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

• centre=323 (WPMIP)
• subCentre (unique for each provider)
  • we keep the subCentre values identical to centre codes for simplicity
    • https://codes.ecmwf.int/grib/format/mars/centre/
• backgroundProcess (unique for each model)
• generatingProcessIdentifier  (unique for each model version)

For example model=ECMWF-AIFS-v1_oic would be encoded using:

• centre=323
• subCentre=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)

Examples of  the required GRIB2 files

• all examples are encoded as the output from ECMWF-IFS-v1_49r1 (test data, steps 0-240h) 
  • productionStatusOfProcessedData=17 (WPMIP test data)
  • centre=323 (WPMIP)
  • subCentre=98 (ECMWF)
  • backgroundProcess=255 (v1_49r1)
  • generatingProcessIdentifier=1 (IFS)
• the data section is removed from the sample data to reduce the file size (thus only meta data matter here)

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