.. _data_catalogue:

Data Catalogue
==============

.. _introduction:

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 <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/README.md>`_.

   - Lazily browse the full `monthly catalogue <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/03_lazy_browse_portfolio.ipynb>`_
   - Lazily browse the full `hourly catalogue <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/04_lazy_browse_portfolio_hourly.ipynb>`_
   - Search for variables using the `variable lookup tool <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/05_variable_lookup.ipynb>`_

   See the :ref:`data access page <model_data>` 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 :ref:`hd_sfc` and :ref:`mo_sfc`)
- ``pl``: pressure levels (see :ref:`hd_pl` and :ref:`mo_pl`)
- ``hl``: height levels (see :ref:`hd_hl` and :ref:`mo_hl`)
- ``sol``: soil levels (see :ref:`hd_sol` and :ref:`mo_sol`)
- ``o2d``: ocean 2D (see :ref:`hd_o2d` and :ref:`mo_o2d`)
- ``o3d``: ocean 3D (see :ref:`hd_o3d` and :ref:`mo_o3d`)

.. note::

  ICON does not include the 100m u and v wind components.

.. _portfolio_table:

2. Climate DT Daily and Hourly Output
--------------------------------------

.. _hd_sfc:

2.1 levtype=sfc
~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1

   * - Short name
     - Parameter ID
     - Long name
     - Units
     - Frequency
     - Comments

   * - tclw
     - `78 <https://codes.ecmwf.int/grib/param-db/78>`_
     - Total column cloud liquid water
     - kg m-2
     - hourly
     - 

   * - tciw
     - `79 <https://codes.ecmwf.int/grib/param-db/79>`_
     - Total column cloud ice water
     - kg m-2
     - hourly
     - 

   * - sp
     - `134 <https://codes.ecmwf.int/grib/param-db/134>`_
     - Surface pressure
     - Pa
     - hourly
     - 

   * - tcw
     - `136 <https://codes.ecmwf.int/grib/param-db/136>`_
     - Total column water
     - kg m-2
     - hourly
     - 

   * - tcwv
     - `137 <https://codes.ecmwf.int/grib/param-db/137>`_
     - Total column vertically-integrated water vapour
     - kg m-2
     - hourly
     - 

   * - msl
     - `151 <https://codes.ecmwf.int/grib/param-db/151>`_
     - Mean sea level pressure
     - Pa
     - hourly
     - 

   * - 10u
     - `165 <https://codes.ecmwf.int/grib/param-db/165>`_
     - 10 metre U wind component
     - m s-1
     - hourly
     - 

   * - 10v
     - `166 <https://codes.ecmwf.int/grib/param-db/166>`_
     - 10 metre V wind component
     - m s-1
     - hourly
     - 

   * - 2t
     - `167 <https://codes.ecmwf.int/grib/param-db/167>`_
     - 2 metre temperature
     - K
     - hourly
     - 

   * - 2d
     - `168 <https://codes.ecmwf.int/grib/param-db/168>`_
     - 2 metre dewpoint temperature
     - K
     - hourly
     - 

   * - 10si
     - `207 <https://codes.ecmwf.int/grib/param-db/207>`_
     - 10 metre wind speed
     - m s-1
     - hourly
     - 

   * - skt
     - `235 <https://codes.ecmwf.int/grib/param-db/235>`_
     - Skin temperature
     - K
     - hourly
     - 

   * - sd
     - `228141 <https://codes.ecmwf.int/grib/param-db/228141>`_
     - Snow depth water equivalent
     - kg m-2
     - hourly
     - 

   * - tcc
     - `228164 <https://codes.ecmwf.int/grib/param-db/228164>`_
     - Total Cloud Cover
     - %
     - hourly
     - 

   * - avg_surfror
     - `235020 <https://codes.ecmwf.int/grib/param-db/235020>`_
     - Time-mean surface runoff rate
     - kg m-2 s-1
     - hourly
     - 

   * - avg_ssurfror
     - `235021 <https://codes.ecmwf.int/grib/param-db/235021>`_
     - Time-mean sub-surface runoff rate
     - kg m-2 s-1
     - hourly
     - 

   * - avg_tsrwe
     - `235031 <https://codes.ecmwf.int/grib/param-db/235031>`_
     - Time-mean total snowfall rate water equivalent
     - kg m-2 s-1
     - hourly
     - 

   * - avg_ishf
     - `235033 <https://codes.ecmwf.int/grib/param-db/235033>`_
     - Time-mean surface sensible heat flux
     - W m-2
     - hourly
     - 

   * - avg_slhtf
     - `235034 <https://codes.ecmwf.int/grib/param-db/235034>`_
     - Time-mean surface latent heat flux
     - W m-2
     - hourly
     - 

   * - avg_sdswrf
     - `235035 <https://codes.ecmwf.int/grib/param-db/235035>`_
     - Time-mean surface downward short-wave radiation flux
     - W m-2
     - hourly
     - 

   * - avg_sdlwrf
     - `235036 <https://codes.ecmwf.int/grib/param-db/235036>`_
     - Time-mean surface downward long-wave radiation flux
     - W m-2
     - hourly
     - 

   * - avg_snswrf
     - `235037 <https://codes.ecmwf.int/grib/param-db/235037>`_
     - Time-mean surface net short-wave radiation flux
     - W m-2
     - hourly
     - 

   * - avg_snlwrf
     - `235038 <https://codes.ecmwf.int/grib/param-db/235038>`_
     - Time-mean surface net long-wave radiation flux
     - W m-2
     - hourly
     - 

   * - avg_tnswrf
     - `235039 <https://codes.ecmwf.int/grib/param-db/235039>`_
     - Time-mean top net short-wave radiation flux
     - W m-2
     - hourly
     - 

   * - avg_tnlwrf
     - `235040 <https://codes.ecmwf.int/grib/param-db/235040>`_
     - Time-mean top net long-wave radiation flux
     - W m-2
     - hourly
     - 

   * - avg_iews
     - `235041 <https://codes.ecmwf.int/grib/param-db/235041>`_
     - Time-mean eastward turbulent surface stress
     - N m-2
     - hourly
     - ICON: see errata

   * - avg_inss
     - `235042 <https://codes.ecmwf.int/grib/param-db/235042>`_
     - Time-mean northward turbulent surface stress
     - N m-2
     - hourly
     - ICON: see errata

   * - avg_ie
     - `235043 <https://codes.ecmwf.int/grib/param-db/235043>`_
     - Time-mean moisture flux
     - kg m-2 s-1
     - hourly
     - 

   * - avg_tnswrfcs
     - `235049 <https://codes.ecmwf.int/grib/param-db/235049>`_
     - Time-mean top net short-wave radiation flux, clear sky
     - W m-2
     - hourly
     - 

   * - avg_tnlwrfcs
     - `235050 <https://codes.ecmwf.int/grib/param-db/235050>`_
     - Time-mean top net long-wave radiation flux, clear sky
     - W m-2
     - hourly
     - 

   * - avg_snswrfcs
     - `235051 <https://codes.ecmwf.int/grib/param-db/235051>`_
     - Time-mean surface net short-wave radiation flux, clear sky
     - W m-2
     - hourly
     - 

   * - avg_snlwrfcs
     - `235052 <https://codes.ecmwf.int/grib/param-db/235052>`_
     - Time-mean surface net long-wave radiation flux, clear sky
     - W m-2
     - hourly
     - 

   * - avg_tdswrf
     - `235053 <https://codes.ecmwf.int/grib/param-db/235053>`_
     - Time mean top downward short-wave radiation flux
     - W m-2
     - hourly
     - 

   * - avg_tprate
     - `235055 <https://codes.ecmwf.int/grib/param-db/235055>`_
     - Time-mean total precipitation rate
     - kg m-2 s-1
     - hourly
     - 

   * - lsm
     - `172 <https://codes.ecmwf.int/grib/param-db/172>`_
     - Land-sea mask
     - (0 - 1)
     - daily
     - 

   * - orog
     - `228002 <https://codes.ecmwf.int/grib/param-db/228002>`_
     - Orography
     - m
     - daily
     - ICON: see errata

Select ``levtype="sfc"`` in the `Polytope Climate DT example notebooks <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/04_lazy_browse_portfolio_hourly.ipynb>`_ to access this stream and browse lazily through these variables.

.. _hd_pl:

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

.. list-table::
   :header-rows: 1

   * - Short name
     - Parameter ID
     - Long name
     - Units
     - Frequency
     - Comments

   * - pv
     - `60 <https://codes.ecmwf.int/grib/param-db/60>`_
     - Potential vorticity
     - K m2 kg-1 s-1
     - hourly
     - 

   * - z
     - `129 <https://codes.ecmwf.int/grib/param-db/129>`_
     - Geopotential
     - m2 s-2
     - hourly
     - 

   * - t
     - `130 <https://codes.ecmwf.int/grib/param-db/130>`_
     - Temperature
     - K
     - hourly
     - 

   * - u
     - `131 <https://codes.ecmwf.int/grib/param-db/131>`_
     - U component of wind
     - m s-1
     - hourly
     - 

   * - v
     - `132 <https://codes.ecmwf.int/grib/param-db/132>`_
     - V component of wind
     - m s-1
     - hourly
     - 

   * - q
     - `133 <https://codes.ecmwf.int/grib/param-db/133>`_
     - Specific humidity
     - kg kg-1
     - hourly
     - 

   * - w
     - `135 <https://codes.ecmwf.int/grib/param-db/135>`_
     - Vertical velocity
     - Pa s-1
     - hourly
     - 

   * - r
     - `157 <https://codes.ecmwf.int/grib/param-db/157>`_
     - Relative humidity
     - %
     - hourly
     - 

   * - clwc
     - `246 <https://codes.ecmwf.int/grib/param-db/246>`_
     - Specific cloud liquid water content
     - kg kg-1
     - hourly
     - 

Select ``levtype="pl"`` in the `Polytope Climate DT example notebooks <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/04_lazy_browse_portfolio_hourly.ipynb>`_ to access these variables.

.. _hd_o2d:

2.3 levtype=o2d
~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1

   * - Short name
     - Parameter ID
     - Long name
     - Units
     - Frequency
     - Comments

   * - avg_sithick
     - `263000 <https://codes.ecmwf.int/grib/param-db/263000>`_
     - Time-mean sea ice thickness
     - m
     - daily
     - 

   * - avg_siconc
     - `263001 <https://codes.ecmwf.int/grib/param-db/263001>`_
     - Time-mean sea ice area fraction
     - Fraction
     - daily
     - 

   * - avg_siue
     - `263003 <https://codes.ecmwf.int/grib/param-db/263003>`_
     - Time-mean eastward sea ice velocity
     - m s-1
     - daily
     - See errata

   * - avg_sivn
     - `263004 <https://codes.ecmwf.int/grib/param-db/263004>`_
     - Time-mean northward sea ice velocity
     - m s-1
     - daily
     - See errata

   * - avg_sivol
     - `263008 <https://codes.ecmwf.int/grib/param-db/263008>`_
     - Time-mean sea ice volume per unit area
     - m3 m-2
     - daily
     - 

   * - avg_snvol
     - `263009 <https://codes.ecmwf.int/grib/param-db/263009>`_
     - Time-mean snow volume over sea ice per unit area
     - m3 m-2
     - daily
     - 

   * - avg_sos
     - `263100 <https://codes.ecmwf.int/grib/param-db/263100>`_
     - Time-mean sea surface practical salinity
     - g kg-1
     - daily
     - 

   * - avg_tos
     - `263101 <https://codes.ecmwf.int/grib/param-db/263101>`_
     - Time-mean sea surface temperature
     - K
     - daily
     - 

   * - avg_hc300m
     - `263121 <https://codes.ecmwf.int/grib/param-db/263121>`_
     - Time-mean vertically-integrated heat content in the upper 300 m
     - J m-2
     - daily
     - 

   * - avg_hc700m
     - `263122 <https://codes.ecmwf.int/grib/param-db/263122>`_
     - Time-mean vertically-integrated heat content in the upper 700 m
     - J m-2
     - daily
     - 

   * - avg_hcbtm
     - `263123 <https://codes.ecmwf.int/grib/param-db/263123>`_
     - Time-mean total column heat content
     - J m-2
     - daily
     - 

   * - avg_zos
     - `263124 <https://codes.ecmwf.int/grib/param-db/263124>`_
     - Time-mean sea surface height
     - m
     - daily
     - 

Select ``levtype="o2d"`` in the `Polytope Climate DT example notebooks <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/04_lazy_browse_portfolio_hourly.ipynb>`_ to access these variables.

.. _hd_o3d:

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)

.. list-table::
   :header-rows: 1

   * - Short name
     - Parameter ID
     - Long name
     - Units
     - Frequency
     - Comments

   * - avg_so
     - `263500 <https://codes.ecmwf.int/grib/param-db/263500>`_
     - Time-mean sea water practical salinity
     - g kg-1
     - daily
     - IFS-NEMO: see errata

   * - avg_thetao
     - `263501 <https://codes.ecmwf.int/grib/param-db/263501>`_
     - Time-mean sea water potential temperature
     - K
     - daily
     - IFS-NEMO: see errata

   * - avg_von
     - `263505 <https://codes.ecmwf.int/grib/param-db/263505>`_
     - Time-mean northward sea water velocity
     - m s-1
     - daily
     - 

   * - avg_uoe
     - `263506 <https://codes.ecmwf.int/grib/param-db/263506>`_
     - Time-mean eastward sea water velocity
     - m s-1
     - daily
     - 

   * - avg_wo
     - `263507 <https://codes.ecmwf.int/grib/param-db/263507>`_
     - 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 <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/04_lazy_browse_portfolio_hourly.ipynb>`_ to access these variables.

.. _hd_hl:

2.5 levtype=hl
~~~~~~~~~~~~~~
These are only for height levels >10m to preserve backwards compatibility with longstanding model fields (2t, 10u, 10v,...).

.. list-table::
   :header-rows: 1

   * - Short name
     - Parameter ID
     - Long name
     - Units
     - Frequency
     - Type of Level
     - Level
     - Comments

   * - u
     - `131 <https://codes.ecmwf.int/grib/param-db/131>`_
     - U component of wind
     - m s-1
     - hourly
     - heightAboveGround
     - 100m
     - Not available for ICON

   * - v
     - `132 <https://codes.ecmwf.int/grib/param-db/132>`_
     - V component of wind
     - m s-1
     - hourly
     - heightAboveGround
     - 100m
     - Not available for ICON
  

Select ``levtype="hl"`` in the `Polytope Climate DT example notebooks <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/04_lazy_browse_portfolio_hourly.ipynb>`_ to access these variables.

.. _hd_sol:

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)

.. list-table::
   :header-rows: 1

   * - Short name
     - Parameter ID
     - Long name
     - Units
     - Frequency
     - Comments

   * - sd
     - `228141 <https://codes.ecmwf.int/grib/param-db/228141>`_
     - Snow depth water equivalent
     - kg m-2
     - hourly
     - Not available for ICON

   * - vsw
     - `260199 <https://codes.ecmwf.int/grib/param-db/260199>`_
     - Volumetric soil moisture
     - m3 m-3
     - hourly
     - ICON: see errata

   * - sot
     - `260360 <https://codes.ecmwf.int/grib/param-db/260360>`_
     - Soil temperature
     - K
     - hourly
     - 

Select ``levtype="sol"`` in the `Polytope Climate DT example notebooks <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/04_lazy_browse_portfolio_hourly.ipynb>`_ to access these variables.


3. Climate DT Monthly Output
-----------------------------

.. _mo_sfc:

3.1 levtype=sfc
~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1

   * - Short name
     - Parameter ID
     - Long name
     - Units
     - Comments

   * - avg_tclw
     - `235087 <https://codes.ecmwf.int/grib/param-db/235087>`_
     - Time-mean total column liquid water
     - kg m-2
     - 

   * - avg_tciw
     - `235088 <https://codes.ecmwf.int/grib/param-db/235088>`_
     - Time-mean total column cloud ice water
     - kg m-2
     - 

   * - avg_sp
     - `235134 <https://codes.ecmwf.int/grib/param-db/235134>`_
     - Time-mean surface pressure
     - Pa
     - 

   * - avg_tcw
     - `235136 <https://codes.ecmwf.int/grib/param-db/235136>`_
     - Time-mean total column water
     - kg m-2
     - 

   * - avg_tcwv
     - `235137 <https://codes.ecmwf.int/grib/param-db/235137>`_
     - Time-mean total column vertically-integrated water vapour
     - kg m-2
     - 

   * - avg_msl
     - `235151 <https://codes.ecmwf.int/grib/param-db/235151>`_
     - Time-mean mean sea level pressure
     - Pa
     - 

   * - avg_10u
     - `235165 <https://codes.ecmwf.int/grib/param-db/235165>`_
     - Time-mean 10 metre U wind component
     - m s-1
     - 

   * - avg_10v
     - `235166 <https://codes.ecmwf.int/grib/param-db/235166>`_
     - Time-mean 10 metre V wind component
     - m s-1
     - 

   * - avg_2t
     - `228004 <https://codes.ecmwf.int/grib/param-db/228004>`_
     - Time-mean 2 metre temperature
     - K
     - 

   * - avg_2d
     - `235168 <https://codes.ecmwf.int/grib/param-db/235168>`_
     - Time-mean 2 metre dewpoint temperature
     - K
     - 

   * - avg_10ws
     - `228005 <https://codes.ecmwf.int/grib/param-db/228005>`_
     - Time-mean 10 metre wind speed
     - m s-1
     - 

   * - avg_skt
     - `235079 <https://codes.ecmwf.int/grib/param-db/235079>`_
     - Time-mean skin temperature
     - K
     - 

   * - avg_sd
     - `235078 <https://codes.ecmwf.int/grib/param-db/235078>`_
     - Time-mean snow depth water equivalent
     - kg m-2
     - 

   * - avg_tcc
     - `235288 <https://codes.ecmwf.int/grib/param-db/235288>`_
     - Time-mean total cloud cover
     - %
     - ICON: see errata

   * - avg_surfror
     - `235020 <https://codes.ecmwf.int/grib/param-db/235020>`_
     - Time-mean surface runoff rate
     - kg m-2 s-1
     - 

   * - avg_ssurfror
     - `235021 <https://codes.ecmwf.int/grib/param-db/235021>`_
     - Time-mean sub-surface runoff rate
     - kg m-2 s-1
     - 

   * - avg_tsrwe
     - `235031 <https://codes.ecmwf.int/grib/param-db/235031>`_
     - Time-mean total snowfall rate water equivalent
     - kg m-2 s-1
     - 

   * - avg_ishf
     - `235033 <https://codes.ecmwf.int/grib/param-db/235033>`_
     - Time-mean surface sensible heat flux
     - W m-2
     - 

   * - avg_slhtf
     - `235034 <https://codes.ecmwf.int/grib/param-db/235034>`_
     - Time-mean surface latent heat flux
     - W m-2
     - 

   * - avg_sdswrf
     - `235035 <https://codes.ecmwf.int/grib/param-db/235035>`_
     - Time-mean surface downward short-wave radiation flux
     - W m-2
     - 

   * - avg_sdlwrf
     - `235036 <https://codes.ecmwf.int/grib/param-db/235036>`_
     - Time-mean surface downward long-wave radiation flux
     - W m-2
     - 

   * - avg_snswrf
     - `235037 <https://codes.ecmwf.int/grib/param-db/235037>`_
     - Time-mean surface net short-wave radiation flux
     - W m-2
     - 

   * - avg_snlwrf
     - `235038 <https://codes.ecmwf.int/grib/param-db/235038>`_
     - Time-mean surface net long-wave radiation flux
     - W m-2
     - 

   * - avg_tnswrf
     - `235039 <https://codes.ecmwf.int/grib/param-db/235039>`_
     - Time-mean top net short-wave radiation flux
     - W m-2
     - 

   * - avg_tnlwrf
     - `235040 <https://codes.ecmwf.int/grib/param-db/235040>`_
     - Time-mean top net long-wave radiation flux
     - W m-2
     - 

   * - avg_iews
     - `235041 <https://codes.ecmwf.int/grib/param-db/235041>`_
     - Time-mean eastward turbulent surface stress
     - N m-2
     - ICON: see errata

   * - avg_inss
     - `235042 <https://codes.ecmwf.int/grib/param-db/235042>`_
     - Time-mean northward turbulent surface stress
     - N m-2
     - ICON: see errata

   * - avg_ie
     - `235043 <https://codes.ecmwf.int/grib/param-db/235043>`_
     - Time-mean moisture flux
     - kg m-2 s-1
     - 

   * - avg_tnswrfcs
     - `235049 <https://codes.ecmwf.int/grib/param-db/235049>`_
     - Time-mean top net short-wave radiation flux, clear sky
     - W m-2
     - 

   * - avg_tnlwrfcs
     - `235050 <https://codes.ecmwf.int/grib/param-db/235050>`_
     - Time-mean top net long-wave radiation flux, clear sky
     - W m-2
     - 

   * - avg_snswrfcs
     - `235051 <https://codes.ecmwf.int/grib/param-db/235051>`_
     - Time-mean surface net short-wave radiation flux, clear sky
     - W m-2
     - 

   * - avg_snlwrfcs
     - `235052 <https://codes.ecmwf.int/grib/param-db/235052>`_
     - Time-mean surface net long-wave radiation flux, clear sky
     - W m-2
     - 

   * - avg_tdswrf
     - `235053 <https://codes.ecmwf.int/grib/param-db/235053>`_
     - Time mean top downward short-wave radiation flux
     - W m-2
     - 

   * - avg_tprate
     - `235055 <https://codes.ecmwf.int/grib/param-db/235055>`_
     - Time-mean total precipitation rate
     - kg m-2 s-1
     - 

Select ``levtype="sfc"`` in the `Polytope Climate DT example notebooks <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/03_lazy_browse_portfolio.ipynb>`_ to access these variables.

.. _mo_pl:

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

.. list-table::
   :header-rows: 1

   * - Short name
     - Parameter ID
     - Long name
     - Units
     - Comments

   * - avg_pv
     - `235100 <https://codes.ecmwf.int/grib/param-db/235100>`_
     - Time-mean potential vorticity
     - K m2 kg-1 s-1
     - Only standard resolution

   * - avg_z
     - `235129 <https://codes.ecmwf.int/grib/param-db/235129>`_
     - Time-mean geopotential
     - m2 s-2
     - Only standard resolution

   * - avg_t
     - `235130 <https://codes.ecmwf.int/grib/param-db/235130>`_
     - Time-mean temperature
     - K
     - Only standard resolution

   * - avg_u
     - `235131 <https://codes.ecmwf.int/grib/param-db/235131>`_
     - Time-mean U component of wind
     - m s-1
     - Only standard resolution

   * - avg_v
     - `235132 <https://codes.ecmwf.int/grib/param-db/235132>`_
     - Time-mean V component of wind
     - m s-1
     - Only standard resolution

   * - avg_q
     - `235133 <https://codes.ecmwf.int/grib/param-db/235133>`_
     - Time-mean specific humidity
     - kg kg-1
     - Only standard resolution

   * - avg_w
     - `235135 <https://codes.ecmwf.int/grib/param-db/235135>`_
     - Time-mean vertical velocity
     - Pa s-1
     - Only standard resolution

   * - avg_r
     - `235157 <https://codes.ecmwf.int/grib/param-db/235157>`_
     - Time-mean relative humidity
     - %
     - Only standard resolution

   * - avg_clwc
     - `235246 <https://codes.ecmwf.int/grib/param-db/235246>`_
     - Time-mean specific cloud liquid water content
     - kg kg-1
     - Only standard resolution

Select ``levtype="pl"`` in the `Polytope Climate DT example notebooks <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/03_lazy_browse_portfolio.ipynb>`_ to access these variables.

.. _mo_o2d:

3.3 levtype=o2d
~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1

   * - Short name
     - Parameter ID
     - Long name
     - Units
     - Comments

   * - avg_sithick
     - `263000 <https://codes.ecmwf.int/grib/param-db/263000>`_
     - Time-mean sea ice thickness
     - m
     - 

   * - avg_siconc
     - `263001 <https://codes.ecmwf.int/grib/param-db/263001>`_
     - Time-mean sea ice area fraction
     - Fraction
     - 

   * - avg_siue
     - `263003 <https://codes.ecmwf.int/grib/param-db/263003>`_
     - Time-mean eastward sea ice velocity
     - m s-1
     - See errata

   * - avg_sivn
     - `263004 <https://codes.ecmwf.int/grib/param-db/263004>`_
     - Time-mean northward sea ice velocity
     - m s-1
     - See errata

   * - avg_sivol
     - `263008 <https://codes.ecmwf.int/grib/param-db/263008>`_
     - Time-mean sea ice volume per unit area
     - m3 m-2
     - 

   * - avg_snvol
     - `263009 <https://codes.ecmwf.int/grib/param-db/263009>`_
     - Time-mean snow volume over sea ice per unit area
     - m3 m-2
     - 

   * - avg_sos
     - `263100 <https://codes.ecmwf.int/grib/param-db/263100>`_
     - Time-mean sea surface practical salinity
     - g kg-1
     - 

   * - avg_tos
     - `263101 <https://codes.ecmwf.int/grib/param-db/263101>`_
     - Time-mean sea surface temperature
     - K
     - 

   * - avg_hc300m
     - `263121 <https://codes.ecmwf.int/grib/param-db/263121>`_
     - Time-mean vertically-integrated heat content in the upper 300 m
     - J m-2
     - 

   * - avg_hc700m
     - `263122 <https://codes.ecmwf.int/grib/param-db/263122>`_
     - Time-mean vertically-integrated heat content in the upper 700 m
     - J m-2
     - 

   * - avg_hcbtm
     - `263123 <https://codes.ecmwf.int/grib/param-db/263123>`_
     - Time-mean total column heat content
     - J m-2
     - 

   * - avg_zos
     - `263124 <https://codes.ecmwf.int/grib/param-db/263124>`_
     - Time-mean sea surface height
     - m
     - 

Select ``levtype="o2d"`` in the `Polytope Climate DT example notebooks <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/03_lazy_browse_portfolio.ipynb>`_ to access these variables.

.. _mo_o3d:

3.4 levtype=o3d
~~~~~~~~~~~~~~~
ICON: 72 model levels (1, ..., 72)
NEMO: 75 model levels: (1, ..., 75)
FESOM: 69 model levels: (1, ..., 69)

.. list-table::
   :header-rows: 1

   * - Short name
     - Parameter ID
     - Long name
     - Units
     - Comments

   * - avg_von
     - `263505 <https://codes.ecmwf.int/grib/param-db/263505>`_
     - Time-mean northward sea water velocity
     - m s-1
     - 

   * - avg_so
     - `263500 <https://codes.ecmwf.int/grib/param-db/263500>`_
     - Time-mean sea water practical salinity
     - g kg-1
     - Only standard resolution. IFS-NEMO: see errata

   * - avg_thetao
     - `263501 <https://codes.ecmwf.int/grib/param-db/263501>`_
     - Time-mean sea water potential temperature
     - K
     - Only standard resolution. IFS-NEMO: see errata

   * - avg_uoe
     - `263506 <https://codes.ecmwf.int/grib/param-db/263506>`_
     - Time-mean eastward sea water velocity
     - m s-1
     - Only standard resolution

   * - avg_wo
     - `263507 <https://codes.ecmwf.int/grib/param-db/263507>`_
     - 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 <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/03_lazy_browse_portfolio.ipynb>`_ to access these variables.

.. _mo_hl:

3.5 levtype=hl
~~~~~~~~~~~~~~
These are only for height levels >10m to preserve backwards compatibility with longstanding model fields (2t, 10u, 10v,...).

.. list-table::
   :header-rows: 1

   * - Short name
     - Parameter ID
     - Long name
     - Units
     - Type of Level
     - Level
     - Comments

   * - avg_u
     - `235131 <https://codes.ecmwf.int/grib/param-db/235131>`_
     - Time-mean U component of wind
     - m s-1
     - heightAboveGround
     - 100m
     - Not available for ICON

   * - avg_v
     - `235132 <https://codes.ecmwf.int/grib/param-db/235132>`_
     - 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 <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/03_lazy_browse_portfolio.ipynb>`_ to access these variables.

.. _mo_sol:

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)

.. list-table::
   :header-rows: 1

   * - Short name
     - Parameter ID
     - Long name
     - Units
     - Comments

   * - avg_sd
     - `235078 <https://codes.ecmwf.int/grib/param-db/235078>`_
     - Time-mean snow depth water equivalent
     - kg m-2
     - Not available for ICON

   * - avg_vsw
     - `235077 <https://codes.ecmwf.int/grib/param-db/235077>`_
     - Time-mean volumetric soil moisture
     - m3 m-3
     - 

   * - avg_sot
     - `235094 <https://codes.ecmwf.int/grib/param-db/235094>`_
     - Time-mean soil temperature
     - K
     - 

Select ``levtype="sol"`` in the `Polytope Climate DT example notebooks <https://github.com/destination-earth-digital-twins/polytope-examples/blob/main/climate-dt/explorer/03_lazy_browse_portfolio.ipynb>`_ to access these variables.

.. _data_layout:

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"

.. _errata:

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.