Data Catalogue¶
1. Introduction¶
This page provides the data catalogue of the parameters provided as part of the DestinE Climate DT data portfolio for the generation 2 simulations. The two streams available are clmn and clte, with clmn being used for the monthly means.
Note
For an instant xarray-view of the data in Python, please refer to the Polytope Climate DT example notebooks.
Lazily browse the full monthly catalogue
Lazily browse the full hourly catalogue
Search for variables using the variable lookup tool
See the data access page for how to perform analyses from any local or HPC environment.
Some key facts:
Temporal resolution:
Hourly atmospheric fields (clte)
Daily mean ocean fields (clte)
Monthly mean atmospheric fields (clmn)
Monthly mean ocean fields (clmn)
Spatial resolution:
resolution=high→ HEALPIX H1024 (closest HEALPix resolution to the native resolution of the model run at ~5 km) or H512 (~10 km)resolution=standard→ HEALPIX H128 (interpolated from the native resolution of the model)
Data is provided on various levtype values:
sfc: surface / single level (see 2.1 levtype=sfc and 3.1 levtype=sfc)pl: pressure levels (see 2.2 levtype=pl and 3.2 levtype=pl)hl: height levels (see 2.5 levtype=hl and 3.5 levtype=hl)sol: soil levels (see 2.6 levtype=sol and 3.6 levtype=sol)o2d: ocean 2D (see 2.3 levtype=o2d and 3.3 levtype=o2d)o3d: ocean 3D (see 2.4 levtype=o3d and 3.4 levtype=o3d)
Note
ICON does not include the 100m u and v wind components.
2. Climate DT Daily and Hourly Output¶
2.1 levtype=sfc¶
Short name |
Parameter ID |
Long name |
Units |
Frequency |
Comments |
|---|---|---|---|---|---|
tclw |
Total column cloud liquid water |
kg m-2 |
hourly |
||
tciw |
Total column cloud ice water |
kg m-2 |
hourly |
||
sp |
Surface pressure |
Pa |
hourly |
||
tcw |
Total column water |
kg m-2 |
hourly |
||
tcwv |
Total column vertically-integrated water vapour |
kg m-2 |
hourly |
||
msl |
Mean sea level pressure |
Pa |
hourly |
||
10u |
10 metre U wind component |
m s-1 |
hourly |
||
10v |
10 metre V wind component |
m s-1 |
hourly |
||
2t |
2 metre temperature |
K |
hourly |
||
2d |
2 metre dewpoint temperature |
K |
hourly |
||
10si |
10 metre wind speed |
m s-1 |
hourly |
||
skt |
Skin temperature |
K |
hourly |
||
sd |
Snow depth water equivalent |
kg m-2 |
hourly |
||
tcc |
Total Cloud Cover |
% |
hourly |
||
avg_surfror |
Time-mean surface runoff rate |
kg m-2 s-1 |
hourly |
||
avg_ssurfror |
Time-mean sub-surface runoff rate |
kg m-2 s-1 |
hourly |
||
avg_tsrwe |
Time-mean total snowfall rate water equivalent |
kg m-2 s-1 |
hourly |
||
avg_ishf |
Time-mean surface sensible heat flux |
W m-2 |
hourly |
||
avg_slhtf |
Time-mean surface latent heat flux |
W m-2 |
hourly |
||
avg_sdswrf |
Time-mean surface downward short-wave radiation flux |
W m-2 |
hourly |
||
avg_sdlwrf |
Time-mean surface downward long-wave radiation flux |
W m-2 |
hourly |
||
avg_snswrf |
Time-mean surface net short-wave radiation flux |
W m-2 |
hourly |
||
avg_snlwrf |
Time-mean surface net long-wave radiation flux |
W m-2 |
hourly |
||
avg_tnswrf |
Time-mean top net short-wave radiation flux |
W m-2 |
hourly |
||
avg_tnlwrf |
Time-mean top net long-wave radiation flux |
W m-2 |
hourly |
||
avg_iews |
Time-mean eastward turbulent surface stress |
N m-2 |
hourly |
ICON: see errata |
|
avg_inss |
Time-mean northward turbulent surface stress |
N m-2 |
hourly |
ICON: see errata |
|
avg_ie |
Time-mean moisture flux |
kg m-2 s-1 |
hourly |
||
avg_tnswrfcs |
Time-mean top net short-wave radiation flux, clear sky |
W m-2 |
hourly |
||
avg_tnlwrfcs |
Time-mean top net long-wave radiation flux, clear sky |
W m-2 |
hourly |
||
avg_snswrfcs |
Time-mean surface net short-wave radiation flux, clear sky |
W m-2 |
hourly |
||
avg_snlwrfcs |
Time-mean surface net long-wave radiation flux, clear sky |
W m-2 |
hourly |
||
avg_tdswrf |
Time mean top downward short-wave radiation flux |
W m-2 |
hourly |
||
avg_tprate |
Time-mean total precipitation rate |
kg m-2 s-1 |
hourly |
||
lsm |
Land-sea mask |
(0 - 1) |
daily |
||
orog |
Orography |
m |
daily |
ICON: see errata |
Select levtype="sfc" in the Polytope Climate DT example notebooks to access this stream and browse lazily through these variables.
2.2 levtype=pl¶
19 pressure levels: (1000, 925, 850, 700, 600, 500, 400, 300, 250, 200, 150, 100, 70, 50, 30, 20, 10, 5, 1)
Type of Level: isobaricInhPa
Short name |
Parameter ID |
Long name |
Units |
Frequency |
Comments |
|---|---|---|---|---|---|
pv |
Potential vorticity |
K m2 kg-1 s-1 |
hourly |
||
z |
Geopotential |
m2 s-2 |
hourly |
||
t |
Temperature |
K |
hourly |
||
u |
U component of wind |
m s-1 |
hourly |
||
v |
V component of wind |
m s-1 |
hourly |
||
q |
Specific humidity |
kg kg-1 |
hourly |
||
w |
Vertical velocity |
Pa s-1 |
hourly |
||
r |
Relative humidity |
% |
hourly |
||
clwc |
Specific cloud liquid water content |
kg kg-1 |
hourly |
Select levtype="pl" in the Polytope Climate DT example notebooks to access these variables.
2.3 levtype=o2d¶
Short name |
Parameter ID |
Long name |
Units |
Frequency |
Comments |
|---|---|---|---|---|---|
avg_sithick |
Time-mean sea ice thickness |
m |
daily |
||
avg_siconc |
Time-mean sea ice area fraction |
Fraction |
daily |
||
avg_siue |
Time-mean eastward sea ice velocity |
m s-1 |
daily |
See errata |
|
avg_sivn |
Time-mean northward sea ice velocity |
m s-1 |
daily |
See errata |
|
avg_sivol |
Time-mean sea ice volume per unit area |
m3 m-2 |
daily |
||
avg_snvol |
Time-mean snow volume over sea ice per unit area |
m3 m-2 |
daily |
||
avg_sos |
Time-mean sea surface practical salinity |
g kg-1 |
daily |
||
avg_tos |
Time-mean sea surface temperature |
K |
daily |
||
avg_hc300m |
Time-mean vertically-integrated heat content in the upper 300 m |
J m-2 |
daily |
||
avg_hc700m |
Time-mean vertically-integrated heat content in the upper 700 m |
J m-2 |
daily |
||
avg_hcbtm |
Time-mean total column heat content |
J m-2 |
daily |
||
avg_zos |
Time-mean sea surface height |
m |
daily |
Select levtype="o2d" in the Polytope Climate DT example notebooks to access these variables.
2.4 levtype=o3d¶
ICON: 72 model levels (1, …, 72) and 73 half-levels (1, …, 73)
NEMO: 75 model levels (1, …, 75)
FESOM: 69 model levels (1, …, 69) and 70 half-levels (1, …, 70)
Short name |
Parameter ID |
Long name |
Units |
Frequency |
Comments |
|---|---|---|---|---|---|
avg_so |
Time-mean sea water practical salinity |
g kg-1 |
daily |
IFS-NEMO: see errata |
|
avg_thetao |
Time-mean sea water potential temperature |
K |
daily |
IFS-NEMO: see errata |
|
avg_von |
Time-mean northward sea water velocity |
m s-1 |
daily |
||
avg_uoe |
Time-mean eastward sea water velocity |
m s-1 |
daily |
||
avg_wo |
Time-mean upward sea water velocity |
m s-1 |
daily |
Provided on half-levels. Not available for ICON. |
Select levtype="o3d" in the Polytope Climate DT example notebooks to access these variables.
2.5 levtype=hl¶
These are only for height levels >10m to preserve backwards compatibility with longstanding model fields (2t, 10u, 10v,…).
Short name |
Parameter ID |
Long name |
Units |
Frequency |
Type of Level |
Level |
Comments |
|---|---|---|---|---|---|---|---|
u |
U component of wind |
m s-1 |
hourly |
heightAboveGround |
100m |
Not available for ICON |
|
v |
V component of wind |
m s-1 |
hourly |
heightAboveGround |
100m |
Not available for ICON |
Select levtype="hl" in the Polytope Climate DT example notebooks to access these variables.
2.6 levtype=sol¶
IFS: 4 model levels: (1, …, 4) (depths 0.07 m, 0.21 m, 0.72 m, 1.89 m) ICON: 5 model levels: (1, …, 5) (depths 0.065 m, 0.319 m, 1.232 m, 4.134 m, 9.834 m)
Short name |
Parameter ID |
Long name |
Units |
Frequency |
Comments |
|---|---|---|---|---|---|
sd |
Snow depth water equivalent |
kg m-2 |
hourly |
Not available for ICON |
|
vsw |
Volumetric soil moisture |
m3 m-3 |
hourly |
ICON: see errata |
|
sot |
Soil temperature |
K |
hourly |
Select levtype="sol" in the Polytope Climate DT example notebooks to access these variables.
3. Climate DT Monthly Output¶
3.1 levtype=sfc¶
Short name |
Parameter ID |
Long name |
Units |
Comments |
|---|---|---|---|---|
avg_tclw |
Time-mean total column liquid water |
kg m-2 |
||
avg_tciw |
Time-mean total column cloud ice water |
kg m-2 |
||
avg_sp |
Time-mean surface pressure |
Pa |
||
avg_tcw |
Time-mean total column water |
kg m-2 |
||
avg_tcwv |
Time-mean total column vertically-integrated water vapour |
kg m-2 |
||
avg_msl |
Time-mean mean sea level pressure |
Pa |
||
avg_10u |
Time-mean 10 metre U wind component |
m s-1 |
||
avg_10v |
Time-mean 10 metre V wind component |
m s-1 |
||
avg_2t |
Time-mean 2 metre temperature |
K |
||
avg_2d |
Time-mean 2 metre dewpoint temperature |
K |
||
avg_10ws |
Time-mean 10 metre wind speed |
m s-1 |
||
avg_skt |
Time-mean skin temperature |
K |
||
avg_sd |
Time-mean snow depth water equivalent |
kg m-2 |
||
avg_tcc |
Time-mean total cloud cover |
% |
ICON: see errata |
|
avg_surfror |
Time-mean surface runoff rate |
kg m-2 s-1 |
||
avg_ssurfror |
Time-mean sub-surface runoff rate |
kg m-2 s-1 |
||
avg_tsrwe |
Time-mean total snowfall rate water equivalent |
kg m-2 s-1 |
||
avg_ishf |
Time-mean surface sensible heat flux |
W m-2 |
||
avg_slhtf |
Time-mean surface latent heat flux |
W m-2 |
||
avg_sdswrf |
Time-mean surface downward short-wave radiation flux |
W m-2 |
||
avg_sdlwrf |
Time-mean surface downward long-wave radiation flux |
W m-2 |
||
avg_snswrf |
Time-mean surface net short-wave radiation flux |
W m-2 |
||
avg_snlwrf |
Time-mean surface net long-wave radiation flux |
W m-2 |
||
avg_tnswrf |
Time-mean top net short-wave radiation flux |
W m-2 |
||
avg_tnlwrf |
Time-mean top net long-wave radiation flux |
W m-2 |
||
avg_iews |
Time-mean eastward turbulent surface stress |
N m-2 |
ICON: see errata |
|
avg_inss |
Time-mean northward turbulent surface stress |
N m-2 |
ICON: see errata |
|
avg_ie |
Time-mean moisture flux |
kg m-2 s-1 |
||
avg_tnswrfcs |
Time-mean top net short-wave radiation flux, clear sky |
W m-2 |
||
avg_tnlwrfcs |
Time-mean top net long-wave radiation flux, clear sky |
W m-2 |
||
avg_snswrfcs |
Time-mean surface net short-wave radiation flux, clear sky |
W m-2 |
||
avg_snlwrfcs |
Time-mean surface net long-wave radiation flux, clear sky |
W m-2 |
||
avg_tdswrf |
Time mean top downward short-wave radiation flux |
W m-2 |
||
avg_tprate |
Time-mean total precipitation rate |
kg m-2 s-1 |
Select levtype="sfc" in the Polytope Climate DT example notebooks to access these variables.
3.2 levtype=pl¶
19 pressure levels: (1000, 925, 850, 700, 600, 500, 400, 300, 250, 200, 150, 100, 70, 50, 30, 20, 10, 5, 1) Type of Level: isobaricInhPa
Short name |
Parameter ID |
Long name |
Units |
Comments |
|---|---|---|---|---|
avg_pv |
Time-mean potential vorticity |
K m2 kg-1 s-1 |
Only standard resolution |
|
avg_z |
Time-mean geopotential |
m2 s-2 |
Only standard resolution |
|
avg_t |
Time-mean temperature |
K |
Only standard resolution |
|
avg_u |
Time-mean U component of wind |
m s-1 |
Only standard resolution |
|
avg_v |
Time-mean V component of wind |
m s-1 |
Only standard resolution |
|
avg_q |
Time-mean specific humidity |
kg kg-1 |
Only standard resolution |
|
avg_w |
Time-mean vertical velocity |
Pa s-1 |
Only standard resolution |
|
avg_r |
Time-mean relative humidity |
% |
Only standard resolution |
|
avg_clwc |
Time-mean specific cloud liquid water content |
kg kg-1 |
Only standard resolution |
Select levtype="pl" in the Polytope Climate DT example notebooks to access these variables.
3.3 levtype=o2d¶
Short name |
Parameter ID |
Long name |
Units |
Comments |
|---|---|---|---|---|
avg_sithick |
Time-mean sea ice thickness |
m |
||
avg_siconc |
Time-mean sea ice area fraction |
Fraction |
||
avg_siue |
Time-mean eastward sea ice velocity |
m s-1 |
See errata |
|
avg_sivn |
Time-mean northward sea ice velocity |
m s-1 |
See errata |
|
avg_sivol |
Time-mean sea ice volume per unit area |
m3 m-2 |
||
avg_snvol |
Time-mean snow volume over sea ice per unit area |
m3 m-2 |
||
avg_sos |
Time-mean sea surface practical salinity |
g kg-1 |
||
avg_tos |
Time-mean sea surface temperature |
K |
||
avg_hc300m |
Time-mean vertically-integrated heat content in the upper 300 m |
J m-2 |
||
avg_hc700m |
Time-mean vertically-integrated heat content in the upper 700 m |
J m-2 |
||
avg_hcbtm |
Time-mean total column heat content |
J m-2 |
||
avg_zos |
Time-mean sea surface height |
m |
Select levtype="o2d" in the Polytope Climate DT example notebooks to access these variables.
3.4 levtype=o3d¶
ICON: 72 model levels (1, …, 72) NEMO: 75 model levels: (1, …, 75) FESOM: 69 model levels: (1, …, 69)
Short name |
Parameter ID |
Long name |
Units |
Comments |
|---|---|---|---|---|
avg_von |
Time-mean northward sea water velocity |
m s-1 |
||
avg_so |
Time-mean sea water practical salinity |
g kg-1 |
Only standard resolution. IFS-NEMO: see errata |
|
avg_thetao |
Time-mean sea water potential temperature |
K |
Only standard resolution. IFS-NEMO: see errata |
|
avg_uoe |
Time-mean eastward sea water velocity |
m s-1 |
Only standard resolution |
|
avg_wo |
Time-mean upward sea water velocity |
m s-1 |
Provided on half-levels. Not available for ICON. |
Select levtype="o3d" in the Polytope Climate DT example notebooks to access these variables.
3.5 levtype=hl¶
These are only for height levels >10m to preserve backwards compatibility with longstanding model fields (2t, 10u, 10v,…).
Short name |
Parameter ID |
Long name |
Units |
Type of Level |
Level |
Comments |
|---|---|---|---|---|---|---|
avg_u |
Time-mean U component of wind |
m s-1 |
heightAboveGround |
100m |
Not available for ICON |
|
avg_v |
Time-mean V component of wind |
m s-1 |
heightAboveGround |
100m |
Not available for ICON |
Select levtype="hl" in the Polytope Climate DT example notebooks to access these variables.
3.6 levtype=sol¶
IFS: 4 model levels: (1, …, 4) (depths 0.07 m, 0.21 m, 0.72 m, 1.89 m) ICON: 5 model levels: (1, …, 5) (depths 0.065 m, 0.319 m, 1.232 m, 4.134 m, 9.834 m)
Short name |
Parameter ID |
Long name |
Units |
Comments |
|---|---|---|---|---|
avg_sd |
Time-mean snow depth water equivalent |
kg m-2 |
Not available for ICON |
|
avg_vsw |
Time-mean volumetric soil moisture |
m3 m-3 |
||
avg_sot |
Time-mean soil temperature |
K |
Select levtype="sol" in the Polytope Climate DT example notebooks to access these variables.
4. Full data layout¶
Example structure:
"class": "d1"
"dataset": "climate-dt"
"generation": "2"
"expver": "0001"
"stream": "clte"
"type": "fc"
"realization": "1"
"activity": "baseline"
"experiment": "historical"
"date": "YYYYMMDD"
"model": "ICON"
"resolution": "high"
"levtype": "o2d"
"time": "0000"
"param": 263000, 263001, ...
"levtype": "pl"
"levelist": "1000/.../1"
"time": "0000/0100/.../2300"
"levtype": "sfc"
"time": "0000/.../2300"
5. Errata¶
Across all models and experiments over the whole timespan: parameters 263003 and 263004 (avg_siue, avg_sivn: Time-mean eastward/northward sea ice velocity [m s-1]) have non-zero values in regions where parameter 263001 (avg_siconc: Time-mean sea ice area fraction [0 - 1 ]) is zero. If the sea ice area fraction is zero, then the sea ice velocities should be masked out.
ICON¶
The Orography (orog, parameter ID: 228002) is 0 everywhere.
ICON historical (climatedt-gen2-icon-baseline-hist-5km-r1):
Volumetric soil moisture (vsw, parameter ID: 260199) level 5 missing for 01.01.1990 – 31.12.2009.
Total cloud cover monthly average (avg_tcc, parameter ID: 235288) not available. See hourly values (parameter ID: 228164).
ICON projection (climatedt-gen2-icon-projections-ssp370-5km-r1):
Total cloud cover monthly average (avg_tcc, parameter ID: 235288) not available. See hourly values (parameter ID: 228164).
ICON control (climatedt-gen2-icon-baseline-cont-5km-r1):
Volumetric soil moisture (vsw, parameter ID: 260199) level 5 missing for 01.01.1990 – 31.12.2003.
Total cloud cover monthly average (avg_tcc, parameter ID: 235288) not available. See hourly values (parameter ID: 228164).
Time-mean eastward turbulent surface stress (avg_iews, parameter ID: 235041) and Time-mean northward turbulent surface stress (avg_inss, parameter ID: 235042) are not averaged but accumulated. The values are accumulated over one hour. This simulation uses a timestep of 40s, therefore this error can be corrected by dividing the hourly values by 90. Time period affected: 01.01.1990 – 31.12.1994.
IFS-NEMO¶
The output parameters in the portfolio are the EOS80 variables 263500 avg_so (practical salinity) and 263501 avg_thetao (potential temperature). For IFS-NEMO though the TEOS10 variables, i.e. absolute salinity and conservative temperature, are saved with those param IDs. This applies to both daily and monthly data.