General requirements
Encoding format
- Participating Centres are expected to produce output fields in GRIB2 data format and with consistent units. For more information please refer to WMO Manual on Codes
Parameters
Units
- All fields shall use units as defined in WMO Tables
Output frequency
- The model output steps should be between 1 and 12 hour
Missing values
- Bitmaps shall be used to indicate missing values
Grid and resolution
- The fields have to be provided on a regular latitude‐longitude grid at the resolution that is best matching the native resolution of the direct model output.
- Grids are defined in GRIB2 using an accuracy of 1/1000000 (one millionth) of a degree.
GRIB2 encoding
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. EcCodes provides a simplified access to GRIB2 headers through a set of virtual keys documented here
Encoding details
The complete WMO compliant GRIB2 definitions of all wave parameters are linked in the page LC-WFV technical details
General encoding details
Specific details which should be encoded in GRIB2 sections 1 and 4:
| Section 1 | |||
|---|---|---|---|
| Octets | Key name | Value | Description |
| 6-7 | centre | X | WMO Centre's code (table below) |
| 8-9 | subCentre | X | WMO Sub-Centre's code if needed (table below) |
| 10 | tablesVersion | 19 | The latest WMO table |
| 20 | productionStatusOfProcessedData | 0 | Production data |
| 1 | Test data | ||
| 21 | typeOfProcessedData | 0 | Analysis products |
| 1 | Forecast products | ||
| Section 4 | |||
|---|---|---|---|
| Octets | Key name | Value | Description |
| 8-9 | productDefinitionTemplateNumber | 0 | Analysis and Forecast products (instantaneous) (Analysis or forecast at a horizontal level or in a horizontal layer at a point in time (grib2/tables/17/4.0.table)) |
WMO Centre codes
The codes below are based on WMO Manual 306 - WMO Codes. Each organization must be uniquely identified by its WMO code. If necessary to distinguish between two organizations using the same WMO code the Sub-Centre one which differs must be provided.
| Organisation | Acronym | WMO Centre code | WMO Centre abbrev. | WMO Sub-Centre |
|---|---|---|---|---|
European Centre for Medium-Range Weather, UK | ECMWF | 98 | ecmf | N/A |
| Met office, UK | UKMO | 74 | egrr | N/A |
| Fleet Numerical Meteorology and Oceanography Center, USA | FNMOC | 58 | fnmo | N/A |
| Environment and Climate Change Canada, Canada | ECCC | 54 | cwao | N/A |
| National Centres for Environmental Prediction, USA | NCEP | 7 | kwbc | N/A |
| Météo France, France | METFR | 84 | lfpw | N/A |
| Deutscher Wetterdienst, Germany | DWD | 78 | edzw | N/A |
| Bureau of Meteorology, Australia | BoM | 1 | ammc | |
| Laboratoire D'Océanographie Physique et Spatiale, France | LOPS | 85/84 | lfrb/lfpw | 202 |
| Japan Meteorological Agency, Japan | JMA | 34 | rjtd | N/A |
| Korea Meteorological Administration, Republic of Korea | KMA | 40 | rksl | N/A |
| Puertos del Estado, Spain | PRTOS | 214 | lemm | N/A |
| Danmarks Meteorologiske Institut, Denmark | DMI | 94 | ekmi | N/A |
National Institute of Water and Atmospheric Research, New Zealand | NIWA | 204 | niwa | N/A |
Det Norske Meteorologiske Institutt, Norway | METNO | 88 | enmi | N/A |
Servicio de Hidrografía Naval, Servicio Meteorológico, Argentina | SHNSM | 41 | sabm | N/A |
New Zealand MetService | NZMS | 69 | nzkl | N/A |
| Servizio Meteorologico dell'Aeronautica Militare, Italy | METEOAM | 80 | cnmc | N/A |
Example of the validity type encoding
Instantaneous
This example describes an instantaneous field valid on 20120103 00Z from a forecast starting on 20120101 00Z (time step=48 hours) .
- In bold, the values are fixed. They are meant to be used by all partners
- In green, these are the values for the example.
| Time ( instantaneous ) | ||||
|---|---|---|---|---|
| Start of forecast ( section 1 ) | ||||
Octets | values | Meaning of values | Grib_api values | |
| 12 | Significance of Reference Time | 1 | Start of forecast | |
| 13-14 | Year (four digits) | 2012 | year of start of forecast |
dataDate=20120101 dataTime=0 |
| 15 | Month | 01 | month of start of forecast | |
| 16 | Day | 01 | day of start of forecast | |
| 17 | Hour | 00 | hour of start of forecast | |
| section 4 e.g. template 4.1 | ||||
| 18 | Indicator of unit of time range | 1 | Hour | |
| 19-22 | Forecast time | 48 | Forecast step | stepType=instant, step=48 |
Examples of the required GRIB2 files
parameter | Sample file |
|---|---|
10 metre U wind component | wave.10u.grib2 |
10 metre V wind component | wave.10v.grib2 |
| Mean wave period based on second moment | wave.mp2.grib2 |
| Mean wave direction | wave.mwd.grib2 |
| Peak wave period | wave.pp1d.grib2 |
Significant height of combined wind waves and swell | wave.swh.grib2 |