Copied to clipboard

Upcoming Atmospheric Change - Coming February 2025

We would like to notify you about upcoming changes to our Atmospheric weather API parameters, which may affect your data processing and integration. Depending on your chosen parameters, you may be impacted by one or more of these changes. This will be deployed as an immediate switchover.

Pressure Level (ISBL) and Height Level (AGL) vertical level changes

Pressure Level (ISBL) and Height level (AGL) values will no longer include a decimal point and will be presented as whole numbers (e.g., 10000.0 will be 10000).

Example of how this will change file naming:

If you are taking this file:
isbl_cloud-cover_1000.0_+RR

It will become:
isbl_cloud-cover_1000_+RR

DBLY Vertical Level - Ranges

The vertical Depth Levels (DBLY) will be presented as ranges instead of mid-point decimal values.

Current DBLY level value Corrected DBLY level value File names change example
0.05m 0\10cm dbly_soil-moisture+soil-temperature_0.05_+RR
Will become:
dbly_soil-moisture+soil-temperature_0-10cm_+RR
0.225m 10\35cm dbly_soil-moisture+soil-temperature_0.225_+RR
Will become:
dbly_soil-moisture+soil-temperature_10-35cm_+RR
0.675m 35\100cm dbly_soil-moisture+soil-temperature_0.675_+RR
Will become:
dbly_soil-moisture+soil-temperature_35-100cm _+RR
2.0m 100\300cm dbly_soil-moisture+soil-temperature_2.0_+RR
Will become:
dbly_soil-moisture+soil-temperature_100-300cm _+RR

Note: The corrected level values will use a hyphen instead of the backslash as shown in the examples above.

Cloud Base Cover – Multiple Levels

The cloudbaseforcloudcover parameters in our API will support multiple levels, replacing the previous single-value format.

ASL geometric altitude

This change will affect the Global deterministic 10km and MOGREPS-G models.
The following parameters will be merged into a single parameter:

  • geometric-altitude-asl-at-cloud-base-where-cloud-cover-2p5-oktas
  • geometric-altitude-asl-at-cloud-base-where-cloud-cover-4p5-oktas

The new single parameter will have multiple levels available (31.25 and 56.25) and will be called:

  • geometric-altitude-asl

The parameter previously ending in 2p5-oktas will now be geometric-altitude-asl at 31.25, 4p5-oktas will be 56.25.

Example of how this will change file naming:

If you are taking this file:
cloudbaseforcloudcover_geometric-altitude-asl-at-cloud-base-where-cloud-cover-2p5-oktas_+RR

It will become:
cloudbaseforcloudcover_geometric-altitude-asl_31.25_+RR

AGL geometric height

This change will affect the UK deterministic 2km model.
The following parameters will be merged into a single parameter:

  • geometric-height-agl-at-cloud-base-where-cloud-cover-0p1-oktas
  • geometric-height-agl-at-cloud-base-where-cloud-cover-2p5-oktas
  • geometric-height-agl-at-cloud-base-where-cloud-cover-4p5-oktas

The new single parameter will have multiple levels available (1.25, 31.25 and 56.25) and will be called:

  • geometric-height-agl

The parameter previously ending in 0p1-oktas will now be geometric-height-agl at 1.25, 2p5-oktas will be 31.25 and 4p5-oktas will be 56.25.

Example of how this will change file naming:

If you are taking this file:
cloudbaseforcloudcover_geometric-height-agl-at-cloud-base-where-cloud-cover-2p5-oktas_+RR

It will become:
cloudbaseforcloudcover_geometric-height-agl_31.25_+RR

Parameter name corrections

We are correcting the parameter names for the following parameters. The table below outlines the parameters being corrected and examples of how this will change file naming.

Current parameter name Corrected parameter name Level types affected Models affected File names change example
geopotential-height geometric-altitude-asl mixedlayercapeequil,
mostunstcapeequil,
effinflowlayertop
Global 10km,
UK 2km (Standard),
MOGREPS-G
mixedlayercapeequil_geopotential-height_+RR
Will become:
mixedlayercapeequil_ geometric-altitude-asl_+RR
geopotential-height geometric-altitude-asl effinflowlayerbase Global 10km,
UK 2km (Standard)
effinflowlayerbase_geopotential-height_+RR
Will become:
effinflowlayerbase_geometric-altitude-asl_+RR
geometric-altitude-above-mean-sea-level geometric-altitude-asl mudl Global 10km,
UK 2km (Standard),
MOGREPS-G
mudl_geometric-altitude-above-mean-sea-level_+RR
Will become:
mudl_geometric-altitude-asl_+RR
geometric-altitude-above-mean-sea-level geometric-altitude-asl wbzeroisotherm Global 10km,
UK 2km (Standard)
wbzeroisotherm_geometric-altitude-above-mean-sea-level_+RR
Will become:
wbzeroisotherm_geometric-altitude-asl_+RR
fog-fraction fraction-of-cloud-cover agl Global 10km,
UK 2km (Standard),
UK 2km (Lat-long),
MOGREPS-G
agl_fog-fraction_+RR
Will become:
agl_fraction-of-cloud-cover_+RR
snowfall-accumulation-water-equivalent-1h large-scale-snowfall-accumulation-water-equivalent-1h ground Global 10km,
MOGREPS-G
ground_snowfall-accumulation-water-equivalent-1h_+RR
Will become:
ground_large-scale_snowfall-accumulation-water-equivalent-1h_+RR
snowfall-accumulation-water-equivalent-3h large-scale-snowfall-accumulation-water-equivalent-3h ground Global 10km,
MOGREPS-G
ground_snowfall-accumulation-water-equivalent-3h_+RR
Will become:
ground_large-scale_snowfall-accumulation-water-equivalent-3h_+RR
snowfall-accumulation-water-equivalent-6h large-scale-snowfall-accumulation-water-equivalent-6h ground Global 10km ground_snowfall-accumulation-water-equivalent-6h_+RR
Will become:
ground_large-scale_snowfall-accumulation-water-equivalent-6h_+RR
total-lightning-flash-accumulation-1h total-lightning-flash-density-1h atmosphere UK 2km (Standard),
UK 2km (Lat-long),
MOGREPS-UK
atmosphere_total-lightning-flash-accumulation-1h_+RR
Will become:
atmosphere_total-lightning-flash-density-1h_+RR
total-lightning-flash-accumulation-3h total-lightning-flash-density-3h atmosphere UK 2km (Standard),
UK 2km (Lat-long)
atmosphere_total-lightning-flash-accumulation-3h_+RR
Will become:
atmosphere_total-lightning-flash-density-3h_+RR
geometric-height-above-ground-level geometric-height-agl isbl UK 2km (Standard),
UK 2km (Lat-long)
isbl_geometric-height-above-ground-level_+RR
Will become:
isbl_geometric-height-agl_+RR
geometric-height-above-ground-level geometric-height-agl wbzeroisotherm,
zeroisotherm
UK 2km (Standard) wbzeroisotherm_geometric-height-above-ground-level_2024051403
Will become:
wbzeroisotherm_geometric-height-agl_2024051403
rain-precipitation-accumulation-1h rainfall-accumulation-1h ground UK 2km (Standard),
UK 2km (Lat-long),
MOGREPS-UK
ground_rain-precipitation-accumulation-1h_+RR
Will become:
ground_rainfall-accumulation-1h_+RR
rain-precipitation-accumulation-3h rainfall-accumulation-3h ground UK 2km (Standard),
UK 2km (Lat-long)
ground_rain-precipitation-accumulation-3h_+RR
Will become:
ground_rainfall-accumulation-3h_+RR
total-snowfall-rate-water-equivalent snowfall-rate-water-equivalent ground UK 2km (Standard),
UK 2km (Lat-long),
MOGREPS-UK
ground_total-snowfall-rate-water-equivalent_+RR
Will become:
ground_snowfall-rate-water-equivalent_+RR
total-snowfall-rate-water-equivalent-max-1h snowfall-rate-water-equivalent-max-1h ground UK 2km (Standard),
UK 2km (Lat-long)
ground_total-snowfall-rate-water-equivalent-max-1h_+RR
Will become:
ground_snowfall-rate-water-equivalent-max-1h_+RR
total-snowfall-rate-water-equivalent-max-3h snowfall-rate-water-equivalent-max-3h ground UK 2km (Standard),
UK 2km (Lat-long)
ground_total-snowfall-rate-water-equivalent-max-3h_+RR
Will become:
ground_snowfall-rate-water-equivalent-max-3h_+RR
dust-mass-mixing-ratio-division-1 dust-mass-mixing-ratio-0.2-4.0-microns isbl, agl Global 10km agl_dust-mass-mixing-ratio-division-1_5.0_+RR
Will become:
agl_dust-mass-mixing-ratio-0.2-4.0-microns_5.0_+RR
dust-mass-mixing-ratio-division-2 dust-mass-mixing-ratio-4.0-20.0-microns isbl, agl Global 10km agl_dust-mass-mixing-ratio-division-2_5.0_+RR
Will become:
agl_dust-mass-mixing-ratio-4.0-20.0-microns_5.0_+RR

GRIB changes

The grib codes for the following parameters will be changing:

Parameter Name Level type Current parameter ID New parameter ID Current GRIB Code New GRIB Code
Height (ASL) at base of convective inflow effinflowlayerbase geopotential-height geometric-altitude-asl 0-3-5 0-3-33
Height (ASL) at top of convective inflow effinflowlayertop geopotential-height geometric-altitude-asl 0-3-5 0-3-33
Height (ASL) at mixed layer CAPE equilibrium level mixedlayercapeequil geopotential-height geometric-altitude-asl 0-3-5 0-3-33
Height (ASL) at most unstable CAPE equilibrium level mostunstcapeequil geopotential-height geometric-altitude-asl 0-3-5 0-3-33
Height (ASL) of most unstable departure level mudl geometric-altitude-above-mean-sea-level geometric-altitude-asl 0-3-192 (local) 0-3-33
Dust mass mixing ratio (division 1) isbl dust-mass-mixing-ratio-division-1 dust-mass-mixing-ratio-0.2-4.0-microns 0-13-193 (local) 0-20-193 (local)
Dust mass mixing ratio (division 1) agl dust-mass-mixing-ratio-division-1 dust-mass-mixing-ratio-0.2-4.0-microns 0-13-193 (local) 0-20-193 (local)
Dust mass mixing ratio (division 2) isbl dust-mass-mixing-ratio-division-2 dust-mass-mixing-ratio-4.0-20.0-microns 0-13-194 (local) 0-20-194 (local)
Dust mass mixing ratio (division 2) agl dust-mass-mixing-ratio-division-2 dust-mass-mixing-ratio-4.0-20.0-microns 0-13-194 (local) 0-20-194 (local)

Other changes

  • If you are using the SubCentre provided in the GRIB2 files, this is being updated from 5 to its correct value 0.

What action is required?

If you take data for any of the parameters that are being updated, and have file names hard coded into your scripts and integrations, you will need to update to accommodate new file naming formats to avoid disruption to your service. We apologise for any inconvenience this may cause and appreciate your understanding.

To get your exact filename updates please call the order latest endpoint after this release has been implemented, as specified above. Details on how to do this can be found on the documentation page.

For best practice, we suggest avoiding hard coding file names in your scripts and integrations. Instead, dynamically pull these file names to minimise the impact of similar changes in the future. This approach will help ensure your workflows and data handling processes remain robust and adaptable to updates in our API.

We apologise for any inconvenience this may cause and appreciate your understanding as we strive to improve our services. If you have any questions or need assistance with this transition, please do not hesitate to contact our support team.

Technical lookup

On this page we use some IDs for model, parameters and level types that are returned by our API. These are often abbreviations of their full display names used on our website. To avoid any confusion, below are the IDs generated by our API along with the corresponding display names shown on our website.

Models

ID Display name
mo-global Global 10km
mo-uk UK 2km (Standard)
mo-uk-latlon UK 2km (Lat-long)
mo-mogrepsg MOGREPS-G
mo-mogrepsuk MOGREPS-UK

Level types

ID Display name
isbl Pressure Level (isbl x 33)
agl Height level (agl x 34)
dbly Depth Level (dbly x 4)
cloudbaseforcloudcover Cloud base
effinflowlayerbase Effective inflow layer base
effinflowlayertop Effective inflow layer top
mixedlayercapeequil Mixed layer CAPE equilibrium
mostunstcapeequil Most unstable CAPE equilibrium
mudl Most unstable departure level
wbzeroisotherm Wet bulb freezing level
zeroisotherm Freezing level
ground Ground
atmosphere Atmosphere

Parameters

Level types affected Current parameter Name New parameter Name Current parameter ID New parameter ID
Cloud base Height (ASL) of 2p5 oktas cloud base Height (ASL) of cloud base geometric-altitude-asl-at-cloud-base-where-cloud-cover-2p5-oktas geometric-altitude-asl
Cloud base Height (ASL) of 4p5 oktas cloud base Height (ASL) of cloud base geometric-altitude-asl-at-cloud-base-where-cloud-cover-4p5-oktas geometric-altitude-asl
Cloud base Height (AGL) of 0p1 oktas cloud base Height (AGL) of cloud base geometric-height-agl-at-cloud-base-where-cloud-cover-0p1-oktas geometric-height-agl
Cloud base Height (AGL) of 2p5 oktas cloud base Height (AGL) of cloud base geometric-height-agl-at-cloud-base-where-cloud-cover-2p5-oktas geometric-height-agl
Cloud base Height (AGL) of 4p5 oktas cloud base Height (AGL) of cloud base geometric-height-agl-at-cloud-base-where-cloud-cover-4p5-oktas geometric-height-agl
Mixed layer CAPE equiibrium Height (ASL) at mixed layer CAPE equilibrium level Height (ASL) at mixed layer CAPE equilibrium level geopotential-height geometric-altitude-asl
Most unstable CAPE equilibrium Height (ASL) at most unstable CAPE equilibrium level Height (ASL) at most unstable CAPE equilibrium level geopotential-height geometric-altitude-asl
Effective inflow layer top Height (ASL) at top of convective inflow Height (ASL) at top of convective inflow geopotential-height geometric-altitude-asl
Effective inflow layer base Height (ASL) at base of convective inflow Height (ASL) at base of convective inflow geopotential-height geometric-altitude-asl
Most unstable departure level Height (ASL) of most unstable departure level Height (ASL) of most unstable departure level geometric-altitude-above-mean-sea-level geometric-altitude-asl
Wet bulb freezing level Height (ASL) of wet bulb freezing level Height (ASL) of wet bulb freezing level geometric-altitude-above-mean-sea-level geometric-altitude-asl
Height level (agl x 34) Fog fraction at 1.5m Fraction of cloud cover at 1.5m fog-fraction fraction-of-cloud-cover
Ground Snowfall accumulation - 1 hour Large scale snowfall accumulation - 1 hour snowfall-accumulation-water-equivalent-1h large-scale-snowfall-accumulation-water-equivalent-1h
Ground Snowfall accumulation - 3 hour Large scale snowfall accumulation - 3 hour snowfall-accumulation-water-equivalent-3h large-scale-snowfall-accumulation-water-equivalent-3h
Ground Snowfall accumulation - 6 hour Large scale snowfall accumulation - 6 hour snowfall-accumulation-water-equivalent-6h large-scale-snowfall-accumulation-water-equivalent-6h
Atmosphere Lightning flash accumulation - 1 hour Lightning flash density - 1 hour total-lightning-flash-accumulation-1h total-lightning-flash-density-1h
Atmosphere Lightning flash accumulation - 3 hour Lightning flash density - 3 hour total-lightning-flash-accumulation-3h total-lightning-flash-density-3h
Pressure Level (isbl x 33) Geometric height Geometric height geometric-height-above-ground-level geometric-height-agl
Freezing level Height (AGL) at freezing level Height (AGL) at freezing level geometric-height-above-ground-level geometric-height-agl
Wet bulb freezing level Height (AGL) of wet bulb freezing level Height (AGL) of wet bulb freezing level geometric-height-above-ground-level geometric-height-agl
Ground Rainfall accumulation - 1 hour Rainfall accumulation - 1 hour rain-precipitation-accumulation-1h rainfall-accumulation-1h
Ground Rainfall accumulation - 3 hour Rainfall accumulation - 3 hour rain-precipitation-accumulation-3h rainfall-accumulation-3h
Ground Snowfall rate Snowfall rate total-snowfall-rate-water-equivalent snowfall-rate-water-equivalent
Ground Snowfall rate - 1 hour maxiumum Snowfall rate - 1 hour maxiumum total-snowfall-rate-water-equivalent-max-1h snowfall-rate-water-equivalent-max-1h
Ground Snowfall rate - 3 hour maximum Snowfall rate - 3 hour maximum total-snowfall-rate-water-equivalent-max-3h snowfall-rate-water-equivalent-max-3h
Pressure Level (isbl x 33) Dust mass mixing ratio (division 1) Dust mass mixing ratio (0.2-4.0 microns) dust-mass-mixing-ratio-division-1 dust-mass-mixing-ratio-0.2-4.0-microns
Height level (agl x 34) Dust mass mixing ratio (division 1) Dust mass mixing ratio (0.2-4.0 microns) dust-mass-mixing-ratio-division-1 dust-mass-mixing-ratio-0.2-4.0-microns
Pressure Level (isbl x 33) Dust mass mixing ratio (division 2) Dust mass mixing ratio (4.0-20.0 microns) dust-mass-mixing-ratio-division-2 dust-mass-mixing-ratio-4.0-20.0-microns
Height level (agl x 34) Dust mass mixing ratio (division 2) Dust mass mixing ratio (4.0-20.0 microns) dust-mass-mixing-ratio-division-2 dust-mass-mixing-ratio-4.0-20.0-microns