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 |
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. |
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
|
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