OceanDataStore 0.3.0__py3-none-any.whl

OceanDataStore/catalog/stac/README.md

@@ -0,0 +1,34 @@
+## OceanDataStore Spatio-Temporal Access Catalogs (STAC)
+
+### Creating the NOC STAC:
+To create a new local copy of the NOC Spatio-Temporal Access Catalog, run the `create_noc_stac.py` script in a Python virtual environment:
+
+```python
+python3 create_noc_stac.py
+```
+
+This will create a new directory `noc-stac` inside the `catalogs/` directory storing a STAC containing NOC Near-Present Day & RAPID-Evolution model datasets. Further datasets will be added to the `noc-stac` in the future.
+
+---
+
+### Uploading a STAC to the JASMIN Object Store:
+
+To upload a new or updated STAC to the `noc-msm` JASMIN Cloud Object Store tenancy, use a applicable CLI, such as `s5cmd`.
+
+Note, this will require permission to write to the `oceandatastore` bucket within the `noc-msm` tenancy.
+
+For example, to upload an updated `noc-stac`:
+
+```bash
+# Remove existing noc-stac:
+s5cmd --endpoint-url https://noc-msm-o.s3-ext.jc.rl.ac.uk --profile noc_msm rm s3://oceandatastore/noc-stac/*
+
+# Copy local noc-stac to OceanDataStore bucket:
+s5cmd --endpoint-url https://noc-msm-o.s3-ext.jc.rl.ac.uk --profile noc_msm cp "path/to/noc-stac/*" s3://oceandatastore/noc-stac/
+```
+
+where `noc_msm` is the profile used to provide your user credentials for the `noc-msm` tenancy
+
+This will make the updated STAC publicly accessible via read-only access at the following URL:
+
+https://noc-msm-o.s3-ext.jc.rl.ac.uk/oceandatastore/noc-stac/catalog.json

OceanDataStore/catalog/stac/__init__.py

@@ -0,0 +1,30 @@
+"""
+OceanDataStore: STAC Catalog Module
+
+Tools for constructing the NOC Spatio-Temporal Asset Catalog (STAC) to local JSON files.
+"""
+from OceanDataStore.catalog.stac.npd_era5_collection import create_npd_era5_collection
+from OceanDataStore.catalog.stac.npd_jra55_collection import create_npd_jra55_collection
+from OceanDataStore.catalog.stac.rapid_evo_collection import create_rapid_evo_collection
+from OceanDataStore.catalog.stac.ods_obs_collection import (
+    create_nsidc_collection,
+    create_woa23_collection,
+    create_oisst_collection,
+    create_en4_collection,
+    create_armor3d_collection,
+    create_hadisst_collection,
+    create_era5_collection
+)
+
+__all__ = (
+    "create_npd_era5_collection",
+    "create_npd_jra55_collection",
+    "create_rapid_evo_collection",
+    "create_nsidc_collection",
+    "create_woa23_collection",
+    "create_oisst_collection",
+    "create_en4_collection",
+    "create_armor3d_collection",
+    "create_hadisst_collection",
+    "create_era5_collection"
+)

OceanDataStore/catalog/stac/create_noc_stac.py

@@ -0,0 +1,109 @@
+"""
+create_noc_stac.py
+
+Description:
+Script to define the National Oceanography Centre (NOC)
+Spatio-Temporal Access Catalog and write to JSON files.
+
+Authors:
+    - Ollie Tooth (oliver.tooth@noc.ac.uk)
+"""
+# -- Import Python Modules -- #
+import datetime
+import logging
+import os
+
+import pystac
+
+from OceanDataStore.catalog.stac import (
+    create_npd_era5_collection,
+    create_npd_jra55_collection,
+    create_rapid_evo_collection,
+    create_nsidc_collection,
+    create_woa23_collection,
+    create_oisst_collection,
+    create_en4_collection,
+    create_armor3d_collection,
+    create_hadisst_collection,
+    create_era5_collection
+)
+from OceanDataStore.cli import initialise_logging
+
+logger = logging.getLogger(__name__)
+
+def create_noc_stac():
+    """
+    Create the NOC STAC and write to JSON files.
+    """
+    # =========== Configure OceanDataStore Logging =========== #
+    initialise_logging()
+
+    # =========== Define NOC STAC =========== #
+    noc_stac = pystac.Catalog(id="noc-stac",
+                            title="NOC STAC Catalog",
+                            description="National Oceanography Centre Spatio-Temporal Asset Catalog for Ocean Model and Observational Data.\n\n**About:**\n\nThe National Oceanography Centre (NOC) is one of the world's leading oceanographic institutions and has been in existence, in its various forms, for over six decades.\nWe undertake world-leading research from coastal seas to deep water, to enhance understanding of the ocean and to address critical environmental challenges.\n\n**Links:**\n- [Website](https://noc.ac.uk)\n- [OceanDataStore](https://noc-msm.github.io/OceanDataStore/)",
+                            stac_extensions=None,
+                            extra_fields={
+                                "last_update": datetime.datetime.now().isoformat(timespec="hours"),
+                                "catalog_version": "0.3.0",
+                                "contacts": "Oliver Tooth (oliver.tooth@noc.ac.uk), Adam Blaker (atb299@noc.ac.uk), Andrew Coward (acc@noc.ac.uk)",
+                                },
+                            )
+
+    logging.info(f"Completed: Created NOC STAC Catalog with ID: {noc_stac.id}")
+
+    # -- Add Rapid-Evolution Collection to NOC STAC Catalog -- #
+    rapid_evo_collection = create_rapid_evo_collection(credentials_json="/dssgfs01/working/otooth/AtlantiS/credentials/rapid_evo_credentials.json")
+    noc_stac.add_child(rapid_evo_collection)
+
+    # -- Add NOC Near-Present Day JRA55-do Collection to NOC STAC Catalog -- #
+    npd_jra55v1_collection = create_npd_jra55_collection()
+    noc_stac.add_child(npd_jra55v1_collection)
+
+    # -- Add NOC Near-Present Day ERA5 Collection to NOC STAC Catalog -- #
+    npd_era5v1_collection = create_npd_era5_collection()
+    noc_stac.add_child(npd_era5v1_collection)
+
+    logging.info(f"Completed: Added NOC Near-Present Day Collections to NOC STAC: {noc_stac.id}")
+
+    # -- Add NSIDC Sea Ice Index Collection to NOC STAC Catalog -- #
+    nsidc_collection = create_nsidc_collection()
+    noc_stac.add_child(nsidc_collection)
+
+    # -- Add WOA23 Collection to NOC STAC Catalog -- #
+    woa23_collection = create_woa23_collection()
+    noc_stac.add_child(woa23_collection)
+
+    # -- Add OISST Collection to NOC STAC Catalog -- #
+    oisst_collection = create_oisst_collection()
+    noc_stac.add_child(oisst_collection)
+
+    # -- Add EN4.2.2 Collection to NOC STAC Catalog -- #
+    en4_collection = create_en4_collection()
+    noc_stac.add_child(en4_collection)
+
+    # -- Add ARMOR3D Collection to NOC STAC Catalog -- #
+    armor3d_collection = create_armor3d_collection()
+    noc_stac.add_child(armor3d_collection)
+
+    # -- Add HadISST1 Collection to NOC STAC Catalog -- #
+    hadisst_collection = create_hadisst_collection()
+    noc_stac.add_child(hadisst_collection)
+
+    # -- Add ERA5 Collection to NOC STAC Catalog -- #
+    era5_collection = create_era5_collection()
+    noc_stac.add_child(era5_collection)
+
+    logging.info(f"Completed: Added Ocean Observation Collections to NOC STAC: {noc_stac.id}")
+
+    # -- Write NOC STAC Catalog to local filesystem -- #
+    logging.info(f"NOC STAC {noc_stac.id} Summary:")
+    print(noc_stac.describe())
+
+    noc_stac.normalize_hrefs(root_href="https://noc-msm-o.s3-ext.jc.rl.ac.uk/noc-stac/")
+    noc_stac.save(catalog_type=pystac.CatalogType.RELATIVE_PUBLISHED, dest_href=os.path.join(os.getcwd(), "noc-stac"))
+    logging.info(f"Completed: Write NOC STAC to -> {os.path.join(os.getcwd(), 'noc-stac')}")
+
+if __name__ == "__main__":
+    # -- Create NOC STAC Catalog -- #
+    create_noc_stac()

OceanDataStore/catalog/stac/npd_era5_collection.py

@@ -0,0 +1,364 @@
+"""
+npd_collections.py
+
+Description:
+Function to create the National Oceanography Centre (NOC) 
+Near-Present Day Spatio-Temporal Access Catalog Collection.
+
+Authors:
+    - Ollie Tooth (oliver.tooth@noc.ac.uk)
+"""
+# -- Import Python Modules -- #
+import datetime
+import logging
+
+import pystac
+import xarray as xr
+
+from OceanDataStore.catalog.stac.utils import (
+        create_item_with_icechunk_asset,
+        open_icechunk_store,
+)
+
+
+def description_from_prefix(prefix: str, ds: xr.Dataset) -> str:
+        """
+        Define Item description based on the prefix and Dataset attributes.
+        
+        Parameters:
+        ----------
+        prefix : str
+            Prefix of Icechunk repository,
+            
+        ds : xr.Dataset
+            Dataset opened from Icechunk repository, which contains global attributes
+            'aggregation_frequency' and 'aggregation' used to define Item description.
+            
+        Returns:
+        -------
+        description : str
+            Description of NEMO model output Item.
+        """
+        # --- Validate input arguments --- #
+        if not isinstance(prefix, str):
+                raise TypeError("'prefix' must be a string.")
+        if not isinstance(ds, xr.Dataset):
+                raise TypeError("'ds' must be an xarray.Dataset.")
+        
+
+        # --- --- Define the item description based on the prefix --- #
+        if 'domain' in prefix:
+            description = "**Global ocean model domain and mesh mask variables.**"
+        elif 'T' in prefix:
+            description = f"**{ds.attrs.get('aggregation_frequency', 'monthly').capitalize()} {ds.attrs.get('aggregation', 'mean')} global ocean scalar outputs defined at {prefix[0]}-points.**"
+        elif 'U' in prefix:
+            description = f"**{ds.attrs.get('aggregation_frequency', 'monthly').capitalize()} {ds.attrs.get('aggregation', 'mean')} global ocean zonal vector outputs defined at {prefix[0]}-points.**"
+        elif 'V' in prefix:
+            description = f"**{ds.attrs.get('aggregation_frequency', 'monthly').capitalize()} {ds.attrs.get('aggregation', 'mean')} global ocean meridional vector outputs defined at {prefix[0]}-points.**"
+        elif 'W' in prefix:
+            description = f"**{ds.attrs.get('aggregation_frequency', 'monthly').capitalize()} {ds.attrs.get('aggregation', 'mean')} global ocean vertical vector outputs defined at {prefix[0]}-points.**"
+        elif 'I' in prefix:
+            description = f"**{ds.attrs.get('aggregation_frequency', 'monthly').capitalize()} {ds.attrs.get('aggregation', 'mean')} global sea-ice outputs defined at T-points.**"
+        elif 'S' in prefix:
+            description = f"**{ds.attrs.get('aggregation_frequency', 'monthly').capitalize()} {ds.attrs.get('aggregation', 'mean')} global ocean scalar outputs.**"
+        elif 'M' in prefix:
+            description = f"**{ds.attrs.get('aggregation_frequency', 'monthly').capitalize()} {ds.attrs.get('aggregation', 'mean')} ocean physics transect outputs defined at {prefix.split('/')[-1]}.**"
+        else:
+            raise ValueError(f"Unable to determine variable type from prefix: {prefix}")
+
+
+        return description
+
+
+def create_npd_era5_collection() -> pystac.Collection:
+    """
+    Create the NOC Near-Present Day ERA-5 STAC Collection.
+    
+    Returns:
+    -------
+    npd_collection : pystac.Collection
+        NOC Near-Present Day ERA-5 STAC Collection.
+    """
+    # ==== Define NOC Near-Present Day Collection ==== #
+    # Define the spatial extent for the collection:
+    spatial_extent = pystac.SpatialExtent(bboxes=[[-180.0, -90.0, 0, 180.0, 90.0, 6000]])
+
+    # Define the current temporal extent for the collection:
+    collection_interval = sorted([datetime.datetime(year=1976, month=1, day=1), datetime.datetime(year=2026, month=5, day=15)])
+    temporal_extent = pystac.TemporalExtent(intervals=[collection_interval])
+
+    # Define the Near-Present Day Collection:
+    npd_collection = pystac.Collection(
+        id="noc-npd-era5",
+        title="NOC Near-Present Day ERA-5 Collection",
+        description="**About:**\n\nCollection of multi-decadal Near-Present Day ocean model hindcast simulations produced by the National Oceanography Centre (NOC) using bias-corrected ERA-5 atmospheric forcing as part of the Atlantic Climate and Environment Strategic Science (AtlantiS) programme.\n\n**More Information:**\n - [AtlantiS](https://atlantis.ac.uk)\n - [NOC Near-Present Day](https://noc-msm.github.io/NOC_Near_Present_Day/)",
+        extent=pystac.Extent(spatial=spatial_extent, temporal=temporal_extent),
+        # Open Government License (OGL) - UK version 3.0 - http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/
+        license="OGL-UK-3.0",
+        extra_fields=dict(contact="Ollie Tooth (oliver.tooth@noc.ac.uk)", project="AtlantiS", status="ongoing", update_frequency="biannual", last_data_update="2026-06-10"),
+        keywords=["NOC", "Near-Present Day", "AtlantiS", "hindcast", "global", "model", "ocean", "sea-ice"],
+        providers=[
+            pystac.Provider(
+                name="National Oceanography Centre (NOC)",
+                description="National Oceanography Centre (United Kingdom) - Ocean Modelling Group.",
+                roles=[pystac.ProviderRole.PRODUCER, pystac.ProviderRole.LICENSOR],
+                url="https://noc-msm.github.io/NOC_Near_Present_Day/"
+            ),
+            pystac.Provider(
+                name="JASMIN",
+                description="JASMIN Environmental Data Analysis Facility (United Kingdom).",
+                roles=[pystac.ProviderRole.HOST],
+                url="https://jasmin.ac.uk"
+            )
+        ],
+    )
+
+    logging.info(f"Completed: Created STAC Collection with ID: {npd_collection.id}")
+
+    # ==== Define NOC Near-Present Day Model Configuration Catalogs ==== #
+    npd_eorca1_era5v1 = pystac.Catalog(
+        id="npd-eorca1-era5v1",
+        title="eORCA1 ERA5v1 NPD Catalog",
+        description="Catalog of eORCA1 ERA-5 Near-Present Day ocean sea-ice simulations performed by the National Oceanography Centre."
+        )
+
+    logging.info(f"-> Completed: Created STAC Catalog with ID: {npd_eorca1_era5v1.id}")
+
+    npd_eorca025_era5v1 = pystac.Catalog(
+        id="npd-eorca025-era5v1",
+        title="eORCA025 ERA5v1 NPD Catalog",
+        description="Catalog of eORCA025 ERA-5 Near-Present Day ocean sea-ice simulations performed by the National Oceanography Centre.",
+        )
+
+    logging.info(f"-> Completed: Created STAC Catalog with ID: {npd_eorca025_era5v1.id}")
+
+    npd_eorca12_era5v1 = pystac.Catalog(
+        id="npd-eorca12-era5v1",
+        title="eORCA12 ERA5v1 NPD Catalog",
+        description="Catalog of eORCA12 ERA-5 Near-Present Day ocean sea-ice simulations performed by the National Oceanography Centre.",
+        )
+
+    logging.info(f"-> Completed: Created STAC Catalog with ID: {npd_eorca12_era5v1.id}")
+
+    # ==== Define NOC Near-Present Day Model Variant Catalogs ==== #
+    r1i1c1f1_eorca1_era5v1 = pystac.Catalog(
+        id="r1i1c1f1",
+        title="eORCA1 ERA5v1 NPD: r1i1c1f1 Catalog",
+        description="Catalog of eORCA1 ERA-5 Near-Present Day ocean physics & sea-ice outputs for model variant: r1i1c1f1.\n\n**Variant Label:**\n\nRealisation=1, Initialisation=1, Configuration=1, Forcing=1."
+        )
+
+    logging.info(f"-> Completed: Created STAC Catalog with ID: {r1i1c1f1_eorca1_era5v1.id}")
+
+    r1i1c1f1_eorca025_era5v1 = pystac.Catalog(
+        id="r1i1c1f1",
+        title="eORCA025 ERA5v1 NPD: r1i1c1f1 Catalog",
+        description="Catalog of eORCA025 ERA-5 Near-Present Day ocean physics & sea-ice outputs for model variant: r1i1c1f1.\n\n**Variant Label:**\n\nRealisation=1, Initialisation=1, Configuration=1, Forcing=1."
+        )
+
+    logging.info(f"-> Completed: Created STAC Catalog with ID: {r1i1c1f1_eorca025_era5v1.id}")
+
+    r1i1c1f1_eorca12_era5v1 = pystac.Catalog(
+        id="r1i1c1f1",
+        title="eORCA12 ERA5v1 NPD: r1i1c1f1 Catalog",
+        description="Catalog of eORCA12 ERA-5 Near-Present Day ocean physics & sea-ice outputs for model variant: r1i1c1f1.\n\n**Variant Label:**\n\nRealisation=1, Initialisation=1, Configuration=1, Forcing=1."
+        )
+
+    logging.info(f"-> Completed: Created STAC Catalog with ID: {r1i1c1f1_eorca12_era5v1.id}")
+
+    # -- Add Items to NOC Near-Present Day eORCA1 ERA5v1 {gn} Sub-Catalog -- #
+    # Define the store credentials for the eORCA1 ERA5v1 NPD data:
+    bucket = "npd-eorca1-era5v1"
+    for prefix in ["T1y", "U1y", "V1y", "W1y", "I1y", "S1y", "T1m", "U1m", "V1m", "W1m", "I1m", "S1m",
+                   "domain/domain_cfg"
+                   ]:
+        # Open dataset from Icechunk repository:
+        ds = open_icechunk_store(bucket=bucket, prefix=prefix, branch="main")
+
+        item = create_item_with_icechunk_asset(
+            ds=ds,
+            id=f"noc-npd-era5/{bucket}/{ds.attrs.get('variant', 'r1i1c1f1')}/{prefix}",
+            bucket=bucket,
+            prefix=prefix,
+            title=f"NPD eORCA1 ERA5v1 {prefix}",
+            description=description_from_prefix(prefix=prefix, ds=ds),
+            start_date="1976-01-01",
+            end_date="2026-05-15",
+            collection=bucket
+            )
+        # Add item to the eORCA1 ERA5v1 NPD global native model grid catalog:
+        r1i1c1f1_eorca1_era5v1.add_item(item)
+
+    logging.info(f"-> Completed: Added Items to STAC Catalog with ID: {r1i1c1f1_eorca1_era5v1.id}")
+
+    # -- Add Items to NOC Near-Present Day eORCA1 ERA5v1 {tn} Sub-Catalog -- #
+    # Define the store credentials for the eORCA1 ERA5v1 NPD data:
+    for prefix in ["M1m/MOVE_16N", "M1m/SAMBA_34_5S", "M1m/RAPID_26N", "M1m/OSNAP"]:
+        # Open dataset from Icechunk repository:
+        ds = open_icechunk_store(bucket=bucket, prefix=prefix, branch="main")
+        
+        item = create_item_with_icechunk_asset(
+            ds=ds,
+            id=f"noc-npd-era5/{bucket}/{ds.attrs.get('variant', 'r1i1c1f1')}/{prefix}",
+            bucket=bucket,
+            prefix=prefix,
+            title=f"NPD eORCA1 ERA5v1 {prefix}",
+            description=description_from_prefix(prefix=prefix, ds=ds),
+            platform=ds.attrs.get('platform', 'tn'),
+            start_date="1976-01-01",
+            end_date="2026-05-15",
+            collection=bucket
+            )
+        # Add item to the eORCA1 ERA5v1 NPD transect catalog:
+        r1i1c1f1_eorca1_era5v1.add_item(item)
+
+    logging.info(f"-> Completed: Added Items to STAC Catalog with ID: {r1i1c1f1_eorca1_era5v1.id}")
+
+    # -- Add Items to NOC Near-Present Day eORCA025 ERA5v1 {gn} Sub-Catalog -- #
+    # Define the store credentials for the eORCA025 ERA5v1 NPD data:
+    bucket = "npd-eorca025-era5v1"
+    for prefix in ["T1y_3d", "T1y_4d", "U1y_3d", "U1y_4d", "V1y_3d", "V1y_4d", "W1y_4d", "I1y_3d", "S1y_1d",
+                   "T1m_3d", "T1m_4d", "U1m_3d", "U1m_4d", "V1m_3d", "V1m_4d", "W1m_4d", "I1m_3d", "S1m_1d",
+                   "T5d_3d", "T5d_4d", "U5d_3d", "U5d_4d", "V5d_3d", "V5d_4d", "I5d_3d", "S5d_1d",
+                   "domain/domain_cfg"
+                   ]:
+        # Open dataset from Icechunk repository:
+        ds = open_icechunk_store(bucket=bucket, prefix=prefix, branch="main")
+
+        item = create_item_with_icechunk_asset(
+            ds=ds,
+            id=f"noc-npd-era5/{bucket}/{ds.attrs.get('variant', 'r1i1c1f1')}/{prefix}",
+            bucket=bucket,
+            prefix=prefix,
+            title=f"NPD eORCA025 ERA5v1 {prefix}",
+            description=description_from_prefix(prefix=prefix, ds=ds),
+            start_date="1976-01-01",
+            end_date="2026-05-15",
+            collection=bucket
+            )
+        # Add item to the eORCA025 ERA5v1 NPD global native model grid catalog:
+        r1i1c1f1_eorca025_era5v1.add_item(item)
+
+    logging.info(f"-> Completed: Added Items to STAC Catalog with ID: {r1i1c1f1_eorca025_era5v1.id}")
+
+    # -- Add Items to NOC Near-Present Day eORCA025 ERA5v1 {tn} Sub-Catalog -- #
+    # Define the store credentials for the eORCA025 ERA5v1 NPD data:
+    for prefix in ["M1m/MOVE_16N", "M1m/SAMBA_34_5S", "M1m/RAPID_26N", "M1m/OSNAP"]:
+        # Open dataset from Icechunk repository:
+        ds = open_icechunk_store(bucket=bucket, prefix=prefix, branch="main")
+
+        item = create_item_with_icechunk_asset(
+            ds=ds,
+            id=f"noc-npd-era5/{bucket}/{ds.attrs.get('variant', 'r1i1c1f1')}/{prefix}",
+            bucket=bucket,
+            prefix=prefix,
+            title=f"NPD eORCA025 ERA5v1 {prefix}",
+            description=description_from_prefix(prefix=prefix, ds=ds),
+            platform=ds.attrs.get('platform', 'tn'),
+            start_date="1976-01-01",
+            end_date="2026-05-15",
+            collection=bucket
+            )
+        # Add item to the eORCA025 ERA5v1 NPD transect catalog:
+        r1i1c1f1_eorca025_era5v1.add_item(item)
+
+    logging.info(f"-> Completed: Added Items to STAC Catalog with ID: {r1i1c1f1_eorca025_era5v1.id}")
+
+    # -- Add Items to NOC Near-Present Day eORCA12 ERA5v1 Sub-Catalog -- #
+    # Define the store credentials for the eORCA12 ERA5v1 NPD data:
+    bucket = "npd-eorca12-era5v1"
+
+    # Add annual-mean and monthly mean Icechunk repositories:
+    for prefix in ["T1y_3d", "T1y_4d", "U1y_3d", "U1y_4d", "V1y_3d", "V1y_4d", "W1y_4d", "I1y_3d", "S1y_1d",
+                   "T1m_3d", "T1m_4d", "U1m_3d", "U1m_4d", "V1m_3d", "V1m_4d", "W1m_4d", "I1m_3d", "S1m_1d",
+                   "domain/domain_cfg",
+                   ]:
+        # Open dataset from Icechunk repository:
+        ds = open_icechunk_store(bucket=bucket, prefix=prefix, branch="main")
+
+        item = create_item_with_icechunk_asset(
+            ds=ds,
+            id=f"noc-npd-era5/{bucket}/{ds.attrs.get('variant', 'r1i1c1f1')}/{prefix}",
+            bucket=bucket,
+            prefix=prefix,
+            title=f"NPD eORCA12 ERA5v1 {prefix}",
+            description=description_from_prefix(prefix=prefix, ds=ds),
+            start_date="1976-01-01",
+            end_date="2026-05-15",
+            collection=bucket
+            )
+        # Add item to the eORCA12 ERA5v1 NPD global native model grid catalog:
+        r1i1c1f1_eorca12_era5v1.add_item(item)
+
+    # Add root group for hierarchical Icechunk repository:
+    ds = open_icechunk_store(bucket=bucket, prefix="eorca12-era5v1-5d", branch="main")
+    item = create_item_with_icechunk_asset(
+        ds=ds,
+        id=f"noc-npd-era5/{bucket}/{ds.attrs.get('variant', 'r1i1c1f1')}/eorca12-era5v1-5d",
+        bucket=bucket,
+        prefix="eorca12-era5v1-5d",
+        title="NPD eORCA12 ERA5v1 5d",
+        description="**5-day mean global ocean outputs.**",
+        start_date="1990-01-01",
+        end_date="2024-12-31",
+        collection=bucket,
+        )
+    # Add item to the eORCA12 ERA5v1 NPD global native model grid catalog:
+    r1i1c1f1_eorca12_era5v1.add_item(item)
+
+    # Add individual groups in hierarchical Icechunk repository:
+    for prefix in ["T5d", "U5d", "V5d"]:
+        # Open dataset from Icechunk repository:
+        ds = open_icechunk_store(bucket=bucket, prefix="eorca12-era5v1-5d", branch="main", group=f"grid{prefix[0]}")
+        item = create_item_with_icechunk_asset(
+            ds=ds,
+            id=f"noc-npd-era5/{bucket}/{ds.attrs.get('variant', 'r1i1c1f1')}/{prefix}",
+            bucket=bucket,
+            prefix="eorca12-era5v1-5d",
+            title=f"NPD eORCA12 ERA5v1 {prefix}",
+            description=f"**5-day mean global ocean {'scalar' if prefix[0] == 'T' else 'vector'} outputs defined at {prefix[0]}-points.**",
+            start_date="1990-01-01",
+            end_date="2024-12-31",
+            collection=bucket,
+            group=f"grid{prefix[0]}"
+            )
+        # Add item to the eORCA12 ERA5v1 NPD global native model grid catalog:
+        r1i1c1f1_eorca12_era5v1.add_item(item)
+
+    logging.info(f"-> Completed: Added Items to STAC Catalog with ID: {r1i1c1f1_eorca12_era5v1.id}")
+
+    # -- Add Items to NOC Near-Present Day eORCA12 ERA5v1 {tn} Sub-Catalog -- #
+    # Define the store credentials for the eORCA12 ERA5v1 NPD data:
+    for prefix in ["M1m/MOVE_16N", "M1m/SAMBA_34_5S", "M1m/RAPID_26N", "M1m/OSNAP"]:
+        # Open dataset from Icechunk repository:
+        ds = open_icechunk_store(bucket=bucket, prefix=prefix, branch="main")
+
+        item = create_item_with_icechunk_asset(
+            ds=ds,
+            id=f"noc-npd-era5/{bucket}/{ds.attrs.get('variant', 'r1i1c1f1')}/{prefix}",
+            bucket=bucket,
+            prefix=prefix,
+            title=f"NPD eORCA12 ERA5v1 {prefix}",
+            description=description_from_prefix(prefix=prefix, ds=ds),
+            platform=ds.attrs.get('platform', 'tn'),
+            start_date="1976-01-01",
+            end_date="2026-05-15",
+            collection=bucket
+            )
+        # Add item to the eORCA12 ERA5v1 NPD transect catalog:
+        r1i1c1f1_eorca12_era5v1.add_item(item)
+
+    logging.info(f"-> Completed: Added Items to STAC Catalog with ID: {r1i1c1f1_eorca12_era5v1.id}")
+
+    # ==== Add Nested Catalogs to NOC Near-Present Day Collection ==== #
+
+    # Model Simulation Variant Catalogs -> Model Simulation Catalogs:
+    npd_eorca1_era5v1.add_child(r1i1c1f1_eorca1_era5v1)
+    npd_eorca025_era5v1.add_child(r1i1c1f1_eorca025_era5v1)
+    npd_eorca12_era5v1.add_child(r1i1c1f1_eorca12_era5v1)
+
+    # Model Simulation Catalogs -> Near-Present Day Collection:
+    npd_collection.add_child(npd_eorca1_era5v1)
+    npd_collection.add_child(npd_eorca025_era5v1)
+    npd_collection.add_child(npd_eorca12_era5v1)
+
+    return npd_collection