Page to detail some of the changes users should expect when sub-hourly data is supported in MARS requests.

The sub-hourly support will arrive along with ecCodes 2.34.

See also the Sub-hourly support in ecCodes information page.

Introduction

In the current version the MARS ecosystem, sub-hourly data is not supported. Coming along with ecCodes 2.34 there will be sub-hourly support within the MARS ecosystem, which will give support for data encoded in units below hours, namely in minutes (m) or seconds (s).

The key points:

• MARS requests will accept the sub-hourly units in the step keyword:
  e.g. 15m, 30m.
• MARS requests will support mixed units in the step keyword:
  e.g. 1h15m, 1h30m.
• MARS requests will also accept the sub-hourly units via a helper keyword stepunits keyword:
  e.g. step=15/30,stepunits=m.
• MARS requests for statistically processed parameters follow the same notions:
  e.g. step=30m-45m/45m-1/1-1h15m ↔ step=30-45/45-60/60-75,stepunits=m
• MARS requests will assume hours without unit specification:
  e.g. step=15/30 → I want data at 15 hours and 30 hours into the forecast

The step units supported in GRIB2 can be found here.

We will compare the before and after behaviour to illustrate what the sub-hourly version brings to ecCodes in more detail below.

MARS request for instantaneous data

Let's take an instantaneous example and have a look at a few ways we could specify the MARS request:

MARS request for statistically processed data

Let's take a statistically processed example and have a look at a few ways we could specify the MARS request: