Copied to clipboard

File naming conventions

This page describes the conventions used in generating the file names made available via our atmospheric model data api.

By Latest run / Specific Run

There are two different ways to request the atmospheric model data file

  • by latest run for that model run
  • by specific run

The two different request profiles will retrieve the same data so in normal operation both options are not required.

Latest Run (+RR)

This request retrieves the latest data available for a particular run e.g. +00 or +15 for the midnight and 3pm run respectively.

Specific Run (YYYYMMDDRR)

This requests a specific run on a specific day.

2021030906 will retrieve the data files for the 06:00 run on the 9-Mar 2021

We retain atmospheric model data files for the last two days

File Name Components

When files are generated we always try to honour any preferences you have set on the order but we may require to deliver your files with a lower level of granularity (splitting by parameter, level or time step) as we restrict files to a maximum size.

The files generated for each order are listed on the order summary page and follow the convention below.

<leveltype>_{parameterid}_(level)_<run>_(timestep)

Naming Component

Optionality

Notes

leveltype

always present

One of atmosphere, atmospheretop, ground, maxwind, meansea, zeroisotherm, isbl, agl

More on level types

parameterId

at least one entry, can repeat

Multiple parameterids exist in a list separated by '+' if file sizes permit aggregation

level

optional

Height (agl - above ground level) or pressure (isbl - isobaric pressure level)

run (RR)

always present

Depends on the api request used.

For a specific date 'YYYYMMDDRR' where RR is the run time in the day.

For latest data, date is discarded and only 'RR' included which will be in the range of 00-23.

More on api requests and integration

time step (T)

optional

When split by time step forecast time step is appended

member (mnn)

optional for ensemble models (MOGREPS-G)

prefixed with 'm' and a member id that varies by run time, so suffixes range from

  • 00/ 12 runs: ‘m0’ to 'm17’
  • 06/ 18 runs: ‘m0’ and ‘m18' to 'm34’

Sample file names

File per timestep

atmosphere_total-cloud-cover_+RR_T
atmosphere_total-cloud-cover_YYYYMMDDRR_T

  • Example
    atmosphere_total-cloud-cover_+00_0
    atmosphere_total-cloud-cover_2020070600_0

Multiple timesteps in one file

atmosphere_total-cloud-cover_+RR
atmosphere_total-cloud-cover_YYYYMMDDRR

  • Example
    atmosphere_total-cloud-cover_+00
    atmosphere_total-cloud-cover_2020070600

Ensemble model split by member

atmosphere_total-cloud-cover_+RR_mnn
atmosphere_total-cloud-cover_YYYYMMDDRR_mnn

  • Example
    atmosphere_total-cloud-cover_+00_m0
    atmosphere_total-cloud-cover_2020070600_m25