This page documents the steps to follow when a data provider plans to implement changes to their system, such as a new version of their model or a change in the configuration.

There can be two types of changes:

  1. A change that  does not affect the number of fields to in the database, for example, a change in resolution or an improved version of the model producing the same fields.
  2. A change in the configuration that affects the number of fields. This could be in the form of:
    1. change to the frequency of time-steps or extend/shorten the length of the forecast
    2. addition/removal of parameters
    3. change to the frequency of the forecast (eg, more runs per day), etc...

In both cases, data providers must update the documentation with what has changed, so users are able to follow the history of a model

Changes to the configuration

When a change affects the number of fields, we ask data providers to:

  • Notify in advance ECMWF
  • Provide test data (if required)
  • Update the documentation

Notify in advance ECMWF

  • describe the change via ECMWF Service Desk form: https://www.ecmwf.int/en/about/contact-us
    • Subject:: select last option "Other"
    • Message: "system change for LC-WFV archive"  + description of the change
  • it will result in creation of a Service Desk ticket which should be used in the following for all further communication (test data, docs update etc..)

Provide test data (if required)

If the change affects how fields are encoded, it is recommended to test the new encoding by ingesting test data in the MARS archive.

Also before sending the test data please use the encoding and basic quality checking tool grib-check as per Recommended support checks (mentioned in Support overview).

Also other checking tools described in those pages shouls be a standard part of your workflow to minimize the support needed in the production phase.

The test data should be provided the same way as the production files with update file name (_prod_ replaced by _test_).  Always inform about provision of the test data via related system change ticket, so that it could be retrieved and tested by ECMWF support.

Update the documentation

Models are documented in two places:

  • Models, which contains an overview of the latest configuration
  • Model upgrades, which contain additional details about the system change