Why use pyeodh over pystac?¶

Description & purpose: This notebook introduces how pyeodh can simplify Python acccess to our EODH STAC catalogue. If you are normally a pystac user, this guide should help to familiarise you with our custom Python API client, pyeodh.

Set-up¶

In [ ]:

Copied!

%pip install pystac_client # install required package
%pip install pystac_client # install required package

In [ ]:

Copied!

# import both required packages
from pystac_client import Client
import pyeodh
# import both required packages
from pystac_client import Client
import pyeodh

pystac¶

Understand the EODH STAC catalogue structure¶

Start by accessing the main EODH catalog root.

In [5]:

Copied!

cat_tac_api_root_endpoint = "https://eodatahub.org.uk/api/catalogue/stac/" #root starting point
main_cat = Client.open(url=cat_tac_api_root_endpoint) # calls the selected url
main_cat
cat_tac_api_root_endpoint = "https://eodatahub.org.uk/api/catalogue/stac/" #root starting point
main_cat = Client.open(url=cat_tac_api_root_endpoint) # calls the selected url
main_cat

Out[5]:

type "Catalog"
id "stac-fastapi"
stac_version "1.1.0"
description "The Earth Observation Data Hub STAC Catalogue"
links[] 15 items
- 0
  - rel "self"
  - href "https://eodatahub.org.uk/api/catalogue/stac/"
  - type "application/json"
- 1
  - rel "root"
  - href "https://eodatahub.org.uk/api/catalogue/stac/"
  - type "application/json"
  - title "EO DataHub Catalogue"
- 2
  - rel "data"
  - href "https://eodatahub.org.uk/api/catalogue/stac/collections"
  - type "application/json"
- 3
  - rel "conformance"
  - href "https://eodatahub.org.uk/api/catalogue/stac/conformance"
  - type "application/json"
  - title "STAC/WFS3 conformance classes implemented by this server"
- 4
  - rel "search"
  - href "https://eodatahub.org.uk/api/catalogue/stac/search"
  - type "application/geo+json"
  - title "STAC search"
  - method "GET"
- 5
  - rel "search"
  - href "https://eodatahub.org.uk/api/catalogue/stac/search"
  - type "application/geo+json"
  - title "STAC search"
  - method "POST"
- 6
  - rel "queryables"
  - href "https://eodatahub.org.uk/api/catalogue/stac/queryables"
  - type "application/schema+json"
  - title "Queryables"
- 7
  - rel "aggregate"
  - href "https://eodatahub.org.uk/api/catalogue/stac/aggregate"
  - type "application/json"
  - title "Aggregate"
- 8
  - rel "aggregations"
  - href "https://eodatahub.org.uk/api/catalogue/stac/aggregations"
  - type "application/json"
  - title "Aggregations"
- 9
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/commercial"
  - type "application/json"
  - title "Commercial Datasets"
- 10
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public"
  - type "application/json"
  - title "Public Datasets"
- 11
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/supported-datasets"
  - type "application/json"
  - title "Supported Datasets"
- 12
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/user"
  - type "application/json"
  - title "User Datasets"
- 13
  - rel "service-desc"
  - href "https://eodatahub.org.uk/api/catalogue/stac/api"
  - type "application/vnd.oai.openapi+json;version=3.0"
  - title "OpenAPI service description"
- 14
  - rel "service-doc"
  - href "https://eodatahub.org.uk/api/catalogue/stac/api.html"
  - type "text/html"
  - title "OpenAPI service documentation"
conformsTo[] 23 items
- 0 "https://api.stacspec.org/v1.0.0/item-search#fields"
- 1 "https://api.stacspec.org/v1.0.0-rc.1/collection-search"
- 2 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30"
- 3 "https://api.stacspec.org/v1.0.0/collections"
- 4 "https://api.stacspec.org/v1.0.0-rc.1/item-search#free-text"
- 5 "https://api.stacspec.org/v1.0.0/item-search#sort"
- 6 "http://www.opengis.net/spec/cql2/1.0/conf/cql2-text"
- 7 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"
- 8 "https://api.stacspec.org/v1.0.0/core"
- 9 "https://api.stacspec.org/v1.0.0/item-search#query"
- 10 "http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/features-filter"
- 11 "https://api.stacspec.org/v1.0.0/item-search"
- 12 "http://www.opengis.net/spec/cql2/1.0/conf/advanced-comparison-operators"
- 13 "http://www.opengis.net/spec/cql2/1.0/conf/cql2-json"
- 14 "http://www.opengis.net/spec/cql2/1.0/conf/basic-cql2"
- 15 "http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/filter"
- 16 "https://api.stacspec.org/v1.0.0-rc.2/item-search#filter"
- 17 "https://api.stacspec.org/v0.3.0/aggregation"
- 18 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core"
- 19 "https://api.stacspec.org/v1.0.0-rc.1/ogcapi-features#free-text"
- 20 "https://api.stacspec.org/v1.0.0-rc.1/collection-search#free-text"
- 21 "http://www.opengis.net/spec/ogcapi-common-2/1.0/conf/simple-query"
- 22 "https://api.stacspec.org/v1.0.0/ogcapi-features"
title "EO DataHub Catalogue"

📂 Within the root catalog, search for sub catalogs at this level.

In [6]:

Copied!





# Check for Sub-Catalogs first
print("Searching for Sub-Catalogs...")
for link in main_cat.get_links():
    if link.rel == 'child':
        print(f"Found Sub-Catalog: {link.href}")
# Check for Sub-Catalogs first
print("Searching for Sub-Catalogs...")
for link in main_cat.get_links():
    if link.rel == 'child':
        print(f"Found Sub-Catalog: {link.href}")

Searching for Sub-Catalogs...
Found Sub-Catalog: https://eodatahub.org.uk/api/catalogue/stac/catalogs/commercial
Found Sub-Catalog: https://eodatahub.org.uk/api/catalogue/stac/catalogs/public
Found Sub-Catalog: https://eodatahub.org.uk/api/catalogue/stac/catalogs/supported-datasets
Found Sub-Catalog: https://eodatahub.org.uk/api/catalogue/stac/catalogs/user

We find a number of sub catalogs nested within the root catalog. To help us understand where our data collection can be found, lets first print out a visual diagram of the directory structure for the EODH STAC catalogue.

In [7]:

Copied!





# We see whats inside and get the STAC metadata collection IDs
def find_collections(catalog, depth=0):
    indent = "  " * depth
    # Try to get collections in this specific catalog
    try:
        cols = list(catalog.get_collections())
        for c in cols:
            print(f"{indent}✅ Collection Found: {c.id}")
    except Exception:
        pass

    # Look into children (Sub-Catalogs)
    for child_link in catalog.get_children():
        print(f"{indent}📂 Entering Sub-Catalog: {child_link.id}")
        find_collections(child_link, depth + 1)

find_collections(main_cat)
# We see whats inside and get the STAC metadata collection IDs
def find_collections(catalog, depth=0):
    indent = "  " * depth
    # Try to get collections in this specific catalog
    try:
        cols = list(catalog.get_collections())
        for c in cols:
            print(f"{indent}✅ Collection Found: {c.id}")
    except Exception:
        pass

    # Look into children (Sub-Catalogs)
    for child_link in catalog.get_children():
        print(f"{indent}📂 Entering Sub-Catalog: {child_link.id}")
        find_collections(child_link, depth + 1)

find_collections(main_cat)

✅ Collection Found: ukcp
✅ Collection Found: sentinel2_ard
✅ Collection Found: sentinel1_ard
✅ Collection Found: sentinel1
✅ Collection Found: qa_radiometric
✅ Collection Found: qa_radiometric
✅ Collection Found: qa_radiometric
✅ Collection Found: qa_documentation
✅ Collection Found: qa_documentation
✅ Collection Found: qa_documentation
✅ Collection Found: land_cover
✅ Collection Found: era5_repack
✅ Collection Found: eocis-sst-cdrv3
✅ Collection Found: eocis-soil-moisture-africa
✅ Collection Found: eocis-lst-s3b-night
✅ Collection Found: eocis-lst-s3b-day
✅ Collection Found: eocis-lst-s3a-night
✅ Collection Found: eocis-lst-s3a-day
✅ Collection Found: eocis-chuk-land-vegetation-lai
✅ Collection Found: eocis-chuk-land-vegetation-fapar
✅ Collection Found: eocis-chuk-geospatial-landcover
✅ Collection Found: eocis-chuk-geospatial-landclass
✅ Collection Found: eocis-chuk-geospatial-elevation
✅ Collection Found: eocis-chuk-geospatial-builtarea
✅ Collection Found: eocis-chuk-geospatial
✅ Collection Found: eocis-arctic-sea-ice-thickness-monthly
✅ Collection Found: eocis-aerosol-slstr-monthly-s3b
✅ Collection Found: eocis-aerosol-slstr-monthly-s3a
✅ Collection Found: eocis-aerosol-slstr-daily-s3b
✅ Collection Found: eocis-aerosol-slstr-daily-s3a
✅ Collection Found: cordex
✅ Collection Found: col_d9a70328-35a4-11f0-987a-56fda0cd4f2f
✅ Collection Found: col_b450a80a-361b-11f0-b489-56fda0cd4f2f
✅ Collection Found: col_b2f5128e-3585-11f0-9dd8-56fda0cd4f2f
✅ Collection Found: col_b24c51c0-35ae-11f0-9d79-56fda0cd4f2f
✅ Collection Found: col_a57fd9e4-3617-11f0-b5ae-56fda0cd4f2f
✅ Collection Found: col_9e19775a-35ae-11f0-afca-56fda0cd4f2f
✅ Collection Found: col_98c2dbc0-35ae-11f0-8b31-56fda0cd4f2f
✅ Collection Found: col_94cebf98-35ae-11f0-804c-56fda0cd4f2f
✅ Collection Found: col_8dc36848-35ae-11f0-83cf-56fda0cd4f2f
✅ Collection Found: col_89a7ee64-35ae-11f0-95e4-56fda0cd4f2f
✅ Collection Found: col_7d6a51aa-35ae-11f0-b19f-56fda0cd4f2f
✅ Collection Found: col_7515fa40-35ae-11f0-bfbc-56fda0cd4f2f
✅ Collection Found: col_6f001b68-35ae-11f0-9b1b-56fda0cd4f2f
✅ Collection Found: col_63f132f2-35ae-11f0-a3ab-56fda0cd4f2f
✅ Collection Found: col_5d9e0ca4-35ae-11f0-939e-56fda0cd4f2f
✅ Collection Found: col_5d702cbe-3624-11f0-8158-56fda0cd4f2f
✅ Collection Found: col_5c8c1646-3615-11f0-88b3-56fda0cd4f2f
✅ Collection Found: col_2d9f3edc-35a5-11f0-b30b-56fda0cd4f2f
✅ Collection Found: col_286e4d36-35a5-11f0-bbdd-56fda0cd4f2f
✅ Collection Found: cmip6
✅ Collection Found: ceda_flights
✅ Collection Found: airbus_spot_data
✅ Collection Found: airbus_sar_data
✅ Collection Found: airbus_pneo_data
✅ Collection Found: airbus_phr_data
✅ Collection Found: SkySatCollect
✅ Collection Found: PSScene
📂 Entering Sub-Catalog: commercial
  ✅ Collection Found: airbus_spot_data
  ✅ Collection Found: airbus_sar_data
  ✅ Collection Found: airbus_pneo_data
  ✅ Collection Found: airbus_phr_data
  ✅ Collection Found: SkySatCollect
  ✅ Collection Found: PSScene
  📂 Entering Sub-Catalog: airbus
    ✅ Collection Found: airbus_spot_data
    ✅ Collection Found: airbus_sar_data
    ✅ Collection Found: airbus_pneo_data
    ✅ Collection Found: airbus_phr_data
    📂 Entering Sub-Catalog: airbus_phr_data
    📂 Entering Sub-Catalog: airbus_pneo_data
    📂 Entering Sub-Catalog: airbus_sar_data
    📂 Entering Sub-Catalog: airbus_spot_data
  📂 Entering Sub-Catalog: planet
    ✅ Collection Found: SkySatCollect
    ✅ Collection Found: PSScene
    📂 Entering Sub-Catalog: PSScene
    📂 Entering Sub-Catalog: SkySatCollect
📂 Entering Sub-Catalog: public
  ✅ Collection Found: ukcp
  ✅ Collection Found: sentinel2_ard
  ✅ Collection Found: sentinel1_ard
  ✅ Collection Found: sentinel1
  ✅ Collection Found: land_cover
  ✅ Collection Found: era5_repack
  ✅ Collection Found: eocis-sst-cdrv3
  ✅ Collection Found: eocis-soil-moisture-africa
  ✅ Collection Found: eocis-lst-s3b-night
  ✅ Collection Found: eocis-lst-s3b-day
  ✅ Collection Found: eocis-lst-s3a-night
  ✅ Collection Found: eocis-lst-s3a-day
  ✅ Collection Found: eocis-chuk-land-vegetation-lai
  ✅ Collection Found: eocis-chuk-land-vegetation-fapar
  ✅ Collection Found: eocis-chuk-geospatial-landcover
  ✅ Collection Found: eocis-chuk-geospatial-landclass
  ✅ Collection Found: eocis-chuk-geospatial-elevation
  ✅ Collection Found: eocis-chuk-geospatial-builtarea
  ✅ Collection Found: eocis-chuk-geospatial
  ✅ Collection Found: eocis-arctic-sea-ice-thickness-monthly
  ✅ Collection Found: eocis-aerosol-slstr-monthly-s3b
  ✅ Collection Found: eocis-aerosol-slstr-monthly-s3a
  ✅ Collection Found: eocis-aerosol-slstr-daily-s3b
  ✅ Collection Found: eocis-aerosol-slstr-daily-s3a
  ✅ Collection Found: cordex
  ✅ Collection Found: cmip6
  ✅ Collection Found: ceda_flights
  📂 Entering Sub-Catalog: ceda-stac-catalogue
    ✅ Collection Found: ukcp
    ✅ Collection Found: sentinel2_ard
    ✅ Collection Found: sentinel1_ard
    ✅ Collection Found: sentinel1
    ✅ Collection Found: land_cover
    ✅ Collection Found: era5_repack
    ✅ Collection Found: eocis-sst-cdrv3
    ✅ Collection Found: eocis-soil-moisture-africa
    ✅ Collection Found: eocis-lst-s3b-night
    ✅ Collection Found: eocis-lst-s3b-day
    ✅ Collection Found: eocis-lst-s3a-night
    ✅ Collection Found: eocis-lst-s3a-day
    ✅ Collection Found: eocis-chuk-land-vegetation-lai
    ✅ Collection Found: eocis-chuk-land-vegetation-fapar
    ✅ Collection Found: eocis-chuk-geospatial-landcover
    ✅ Collection Found: eocis-chuk-geospatial-landclass
    ✅ Collection Found: eocis-chuk-geospatial-elevation
    ✅ Collection Found: eocis-chuk-geospatial-builtarea
    ✅ Collection Found: eocis-chuk-geospatial
    ✅ Collection Found: eocis-arctic-sea-ice-thickness-monthly
    ✅ Collection Found: eocis-aerosol-slstr-monthly-s3b
    ✅ Collection Found: eocis-aerosol-slstr-monthly-s3a
    ✅ Collection Found: eocis-aerosol-slstr-daily-s3b
    ✅ Collection Found: eocis-aerosol-slstr-daily-s3a
    ✅ Collection Found: cordex
    ✅ Collection Found: cmip6
    ✅ Collection Found: ceda_flights
    📂 Entering Sub-Catalog: ceda_flights
    📂 Entering Sub-Catalog: cmip6
    📂 Entering Sub-Catalog: cordex
    📂 Entering Sub-Catalog: eocis-aerosol-slstr-daily-s3a
    📂 Entering Sub-Catalog: eocis-aerosol-slstr-daily-s3b
    📂 Entering Sub-Catalog: eocis-aerosol-slstr-monthly-s3a
    📂 Entering Sub-Catalog: eocis-aerosol-slstr-monthly-s3b
    📂 Entering Sub-Catalog: eocis-arctic-sea-ice-thickness-monthly
    📂 Entering Sub-Catalog: eocis-chuk-geospatial
    📂 Entering Sub-Catalog: eocis-chuk-geospatial-builtarea
    📂 Entering Sub-Catalog: eocis-chuk-geospatial-elevation
    📂 Entering Sub-Catalog: eocis-chuk-geospatial-landclass
    📂 Entering Sub-Catalog: eocis-chuk-geospatial-landcover
    📂 Entering Sub-Catalog: eocis-chuk-land-vegetation-fapar
    📂 Entering Sub-Catalog: eocis-chuk-land-vegetation-lai
    📂 Entering Sub-Catalog: eocis-lst-s3a-day
    📂 Entering Sub-Catalog: eocis-lst-s3a-night
    📂 Entering Sub-Catalog: eocis-lst-s3b-day
    📂 Entering Sub-Catalog: eocis-lst-s3b-night
    📂 Entering Sub-Catalog: eocis-soil-moisture-africa
    📂 Entering Sub-Catalog: eocis-sst-cdrv3
    📂 Entering Sub-Catalog: era5_repack
    📂 Entering Sub-Catalog: land_cover
    📂 Entering Sub-Catalog: sentinel1
    📂 Entering Sub-Catalog: sentinel1_ard
    📂 Entering Sub-Catalog: sentinel2_ard
    📂 Entering Sub-Catalog: ukcp
📂 Entering Sub-Catalog: supported-datasets
📂 Entering Sub-Catalog: user
  ✅ Collection Found: qa_radiometric
  ✅ Collection Found: qa_radiometric
  ✅ Collection Found: qa_radiometric
  ✅ Collection Found: qa_documentation
  ✅ Collection Found: qa_documentation
  ✅ Collection Found: qa_documentation
  ✅ Collection Found: col_d9a70328-35a4-11f0-987a-56fda0cd4f2f
  ✅ Collection Found: col_b450a80a-361b-11f0-b489-56fda0cd4f2f
  ✅ Collection Found: col_b2f5128e-3585-11f0-9dd8-56fda0cd4f2f
  ✅ Collection Found: col_b24c51c0-35ae-11f0-9d79-56fda0cd4f2f
  ✅ Collection Found: col_a57fd9e4-3617-11f0-b5ae-56fda0cd4f2f
  ✅ Collection Found: col_9e19775a-35ae-11f0-afca-56fda0cd4f2f
  ✅ Collection Found: col_98c2dbc0-35ae-11f0-8b31-56fda0cd4f2f
  ✅ Collection Found: col_94cebf98-35ae-11f0-804c-56fda0cd4f2f
  ✅ Collection Found: col_8dc36848-35ae-11f0-83cf-56fda0cd4f2f
  ✅ Collection Found: col_89a7ee64-35ae-11f0-95e4-56fda0cd4f2f
  ✅ Collection Found: col_7d6a51aa-35ae-11f0-b19f-56fda0cd4f2f
  ✅ Collection Found: col_7515fa40-35ae-11f0-bfbc-56fda0cd4f2f
  ✅ Collection Found: col_6f001b68-35ae-11f0-9b1b-56fda0cd4f2f
  ✅ Collection Found: col_63f132f2-35ae-11f0-a3ab-56fda0cd4f2f
  ✅ Collection Found: col_5d9e0ca4-35ae-11f0-939e-56fda0cd4f2f
  ✅ Collection Found: col_5d702cbe-3624-11f0-8158-56fda0cd4f2f
  ✅ Collection Found: col_5c8c1646-3615-11f0-88b3-56fda0cd4f2f
  ✅ Collection Found: col_2d9f3edc-35a5-11f0-b30b-56fda0cd4f2f
  ✅ Collection Found: col_286e4d36-35a5-11f0-bbdd-56fda0cd4f2f
  📂 Entering Sub-Catalog: npl
    ✅ Collection Found: qa_radiometric
    ✅ Collection Found: qa_radiometric
    ✅ Collection Found: qa_radiometric
    ✅ Collection Found: qa_documentation
    ✅ Collection Found: qa_documentation
    ✅ Collection Found: qa_documentation
    📂 Entering Sub-Catalog: processing-results
      ✅ Collection Found: qa_radiometric
      ✅ Collection Found: qa_radiometric
      ✅ Collection Found: qa_radiometric
      ✅ Collection Found: qa_documentation
      ✅ Collection Found: qa_documentation
      ✅ Collection Found: qa_documentation
      📂 Entering Sub-Catalog: qa-workflow
        ✅ Collection Found: qa_radiometric
        ✅ Collection Found: qa_radiometric
        ✅ Collection Found: qa_radiometric
        ✅ Collection Found: qa_documentation
        ✅ Collection Found: qa_documentation
        ✅ Collection Found: qa_documentation
        📂 Entering Sub-Catalog: airbus_phr_qa
          ✅ Collection Found: qa_radiometric
          ✅ Collection Found: qa_documentation
          📂 Entering Sub-Catalog: qa_documentation
          📂 Entering Sub-Catalog: qa_radiometric
        📂 Entering Sub-Catalog: planet_psscene_qa
          ✅ Collection Found: qa_radiometric
          ✅ Collection Found: qa_documentation
          📂 Entering Sub-Catalog: qa_documentation
          📂 Entering Sub-Catalog: qa_radiometric
        📂 Entering Sub-Catalog: sentinel-2_l1c_qa
          ✅ Collection Found: qa_radiometric
          ✅ Collection Found: qa_documentation
          📂 Entering Sub-Catalog: qa_documentation
          📂 Entering Sub-Catalog: qa_radiometric
  📂 Entering Sub-Catalog: tjellicoetpzuk
    ✅ Collection Found: col_d9a70328-35a4-11f0-987a-56fda0cd4f2f
    ✅ Collection Found: col_b450a80a-361b-11f0-b489-56fda0cd4f2f
    ✅ Collection Found: col_b2f5128e-3585-11f0-9dd8-56fda0cd4f2f
    ✅ Collection Found: col_b24c51c0-35ae-11f0-9d79-56fda0cd4f2f
    ✅ Collection Found: col_a57fd9e4-3617-11f0-b5ae-56fda0cd4f2f
    ✅ Collection Found: col_9e19775a-35ae-11f0-afca-56fda0cd4f2f
    ✅ Collection Found: col_98c2dbc0-35ae-11f0-8b31-56fda0cd4f2f
    ✅ Collection Found: col_94cebf98-35ae-11f0-804c-56fda0cd4f2f
    ✅ Collection Found: col_8dc36848-35ae-11f0-83cf-56fda0cd4f2f
    ✅ Collection Found: col_89a7ee64-35ae-11f0-95e4-56fda0cd4f2f
    ✅ Collection Found: col_7d6a51aa-35ae-11f0-b19f-56fda0cd4f2f
    ✅ Collection Found: col_7515fa40-35ae-11f0-bfbc-56fda0cd4f2f
    ✅ Collection Found: col_6f001b68-35ae-11f0-9b1b-56fda0cd4f2f
    ✅ Collection Found: col_63f132f2-35ae-11f0-a3ab-56fda0cd4f2f
    ✅ Collection Found: col_5d9e0ca4-35ae-11f0-939e-56fda0cd4f2f
    ✅ Collection Found: col_5d702cbe-3624-11f0-8158-56fda0cd4f2f
    ✅ Collection Found: col_5c8c1646-3615-11f0-88b3-56fda0cd4f2f
    ✅ Collection Found: col_2d9f3edc-35a5-11f0-b30b-56fda0cd4f2f
    ✅ Collection Found: col_286e4d36-35a5-11f0-bbdd-56fda0cd4f2f
    📂 Entering Sub-Catalog: processing-results
      ✅ Collection Found: col_d9a70328-35a4-11f0-987a-56fda0cd4f2f
      ✅ Collection Found: col_b450a80a-361b-11f0-b489-56fda0cd4f2f
      ✅ Collection Found: col_b2f5128e-3585-11f0-9dd8-56fda0cd4f2f
      ✅ Collection Found: col_b24c51c0-35ae-11f0-9d79-56fda0cd4f2f
      ✅ Collection Found: col_a57fd9e4-3617-11f0-b5ae-56fda0cd4f2f
      ✅ Collection Found: col_9e19775a-35ae-11f0-afca-56fda0cd4f2f
      ✅ Collection Found: col_98c2dbc0-35ae-11f0-8b31-56fda0cd4f2f
      ✅ Collection Found: col_94cebf98-35ae-11f0-804c-56fda0cd4f2f
      ✅ Collection Found: col_8dc36848-35ae-11f0-83cf-56fda0cd4f2f
      ✅ Collection Found: col_89a7ee64-35ae-11f0-95e4-56fda0cd4f2f
      ✅ Collection Found: col_7d6a51aa-35ae-11f0-b19f-56fda0cd4f2f
      ✅ Collection Found: col_7515fa40-35ae-11f0-bfbc-56fda0cd4f2f
      ✅ Collection Found: col_6f001b68-35ae-11f0-9b1b-56fda0cd4f2f
      ✅ Collection Found: col_63f132f2-35ae-11f0-a3ab-56fda0cd4f2f
      ✅ Collection Found: col_5d9e0ca4-35ae-11f0-939e-56fda0cd4f2f
      ✅ Collection Found: col_5d702cbe-3624-11f0-8158-56fda0cd4f2f
      ✅ Collection Found: col_5c8c1646-3615-11f0-88b3-56fda0cd4f2f
      ✅ Collection Found: col_2d9f3edc-35a5-11f0-b30b-56fda0cd4f2f
      ✅ Collection Found: col_286e4d36-35a5-11f0-bbdd-56fda0cd4f2f
      📂 Entering Sub-Catalog: snuggs
        ✅ Collection Found: col_d9a70328-35a4-11f0-987a-56fda0cd4f2f
        ✅ Collection Found: col_b450a80a-361b-11f0-b489-56fda0cd4f2f
        ✅ Collection Found: col_b2f5128e-3585-11f0-9dd8-56fda0cd4f2f
        ✅ Collection Found: col_b24c51c0-35ae-11f0-9d79-56fda0cd4f2f
        ✅ Collection Found: col_a57fd9e4-3617-11f0-b5ae-56fda0cd4f2f
        ✅ Collection Found: col_9e19775a-35ae-11f0-afca-56fda0cd4f2f
        ✅ Collection Found: col_98c2dbc0-35ae-11f0-8b31-56fda0cd4f2f
        ✅ Collection Found: col_94cebf98-35ae-11f0-804c-56fda0cd4f2f
        ✅ Collection Found: col_8dc36848-35ae-11f0-83cf-56fda0cd4f2f
        ✅ Collection Found: col_89a7ee64-35ae-11f0-95e4-56fda0cd4f2f
        ✅ Collection Found: col_7d6a51aa-35ae-11f0-b19f-56fda0cd4f2f
        ✅ Collection Found: col_7515fa40-35ae-11f0-bfbc-56fda0cd4f2f
        ✅ Collection Found: col_6f001b68-35ae-11f0-9b1b-56fda0cd4f2f
        ✅ Collection Found: col_63f132f2-35ae-11f0-a3ab-56fda0cd4f2f
        ✅ Collection Found: col_5d9e0ca4-35ae-11f0-939e-56fda0cd4f2f
        ✅ Collection Found: col_5d702cbe-3624-11f0-8158-56fda0cd4f2f
        ✅ Collection Found: col_5c8c1646-3615-11f0-88b3-56fda0cd4f2f
        ✅ Collection Found: col_2d9f3edc-35a5-11f0-b30b-56fda0cd4f2f
        ✅ Collection Found: col_286e4d36-35a5-11f0-bbdd-56fda0cd4f2f
        📂 Entering Sub-Catalog: catalog
          ✅ Collection Found: col_d9a70328-35a4-11f0-987a-56fda0cd4f2f
          ✅ Collection Found: col_b450a80a-361b-11f0-b489-56fda0cd4f2f
          ✅ Collection Found: col_b2f5128e-3585-11f0-9dd8-56fda0cd4f2f
          ✅ Collection Found: col_b24c51c0-35ae-11f0-9d79-56fda0cd4f2f
          ✅ Collection Found: col_a57fd9e4-3617-11f0-b5ae-56fda0cd4f2f
          ✅ Collection Found: col_9e19775a-35ae-11f0-afca-56fda0cd4f2f
          ✅ Collection Found: col_98c2dbc0-35ae-11f0-8b31-56fda0cd4f2f
          ✅ Collection Found: col_94cebf98-35ae-11f0-804c-56fda0cd4f2f
          ✅ Collection Found: col_8dc36848-35ae-11f0-83cf-56fda0cd4f2f
          ✅ Collection Found: col_89a7ee64-35ae-11f0-95e4-56fda0cd4f2f
          ✅ Collection Found: col_7d6a51aa-35ae-11f0-b19f-56fda0cd4f2f
          ✅ Collection Found: col_7515fa40-35ae-11f0-bfbc-56fda0cd4f2f
          ✅ Collection Found: col_6f001b68-35ae-11f0-9b1b-56fda0cd4f2f
          ✅ Collection Found: col_63f132f2-35ae-11f0-a3ab-56fda0cd4f2f
          ✅ Collection Found: col_5d9e0ca4-35ae-11f0-939e-56fda0cd4f2f
          ✅ Collection Found: col_5d702cbe-3624-11f0-8158-56fda0cd4f2f
          ✅ Collection Found: col_5c8c1646-3615-11f0-88b3-56fda0cd4f2f
          ✅ Collection Found: col_2d9f3edc-35a5-11f0-b30b-56fda0cd4f2f
          ✅ Collection Found: col_286e4d36-35a5-11f0-bbdd-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_286e4d36-35a5-11f0-bbdd-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_2d9f3edc-35a5-11f0-b30b-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_5c8c1646-3615-11f0-88b3-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_5d702cbe-3624-11f0-8158-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_5d9e0ca4-35ae-11f0-939e-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_63f132f2-35ae-11f0-a3ab-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_6f001b68-35ae-11f0-9b1b-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_7515fa40-35ae-11f0-bfbc-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_7d6a51aa-35ae-11f0-b19f-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_89a7ee64-35ae-11f0-95e4-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_8dc36848-35ae-11f0-83cf-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_94cebf98-35ae-11f0-804c-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_98c2dbc0-35ae-11f0-8b31-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_9e19775a-35ae-11f0-afca-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_a57fd9e4-3617-11f0-b5ae-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_b24c51c0-35ae-11f0-9d79-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_b2f5128e-3585-11f0-9dd8-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_b450a80a-361b-11f0-b489-56fda0cd4f2f
          📂 Entering Sub-Catalog: col_d9a70328-35a4-11f0-987a-56fda0cd4f2f

Access a data collection with pystac¶

To find the sentinel2_ard data collection, we should look inside the sub catalogs. Sentinel 2 ARD can be found within the sub catalog called public, according to our directory structure.

In [13]:

Copied!

cat_pub_root_endpoint = "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/" #root starting point
public_cat = Client.open(url=cat_pub_root_endpoint) # calls the selected url
public_cat
cat_pub_root_endpoint = "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/" #root starting point
public_cat = Client.open(url=cat_pub_root_endpoint) # calls the selected url
public_cat

Out[13]:

type "Catalog"
id "public"
stac_version "1.1.0"
description "A catalog of EODHP public catalogs"
links[] 13 items
- 0
  - rel "self"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/"
  - type "application/json"
- 1
  - rel "aggregate"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/aggregate"
  - type "application/json"
- 2
  - rel "aggregations"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/aggregations"
  - type "application/json"
- 3
  - rel "catalogs"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs"
  - type "application/geo+json"
- 4
  - rel "collections"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/collections"
  - type "application/geo+json"
- 5
  - rel "conformance"
  - href "https://eodatahub.org.uk/api/catalogue/stac/conformance"
  - type "application/json"
  - title "STAC/WFS3 conformance classes implemented by this server"
- 6
  - rel "data"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/collections"
  - type "application/geo+json"
- 7
  - rel "search"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/search"
  - type "application/geo+json"
  - title "STAC search"
  - method "GET"
- 8
  - rel "parent"
  - href "https://eodatahub.org.uk/api/catalogue/stac/"
  - type "application/json"
- 9
  - rel "search"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/search"
  - type "application/geo+json"
  - title "STAC search"
  - method "POST"
- 10
  - rel "queryables"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/queryables"
  - type "application/json"
- 11
  - rel "root"
  - href "https://eodatahub.org.uk/api/catalogue/stac/"
  - type "application/json"
- 12
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue"
  - type "application/json"
  - title "CEDA STAC API"
conformsTo[] 23 items
- 0 "https://api.stacspec.org/v1.0.0/core"
- 1 "https://api.stacspec.org/v1.0.0/ogcapi-features"
- 2 "http://www.opengis.net/spec/cql2/1.0/conf/cql2-text"
- 3 "http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/filter"
- 4 "https://api.stacspec.org/v1.0.0/item-search#sort"
- 5 "http://www.opengis.net/spec/ogcapi-common-2/1.0/conf/simple-query"
- 6 "https://api.stacspec.org/v1.0.0-rc.1/item-search#free-text"
- 7 "https://api.stacspec.org/v1.0.0-rc.1/ogcapi-features#free-text"
- 8 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core"
- 9 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30"
- 10 "https://api.stacspec.org/v1.0.0/item-search#query"
- 11 "https://api.stacspec.org/v1.0.0-rc.2/item-search#filter"
- 12 "https://api.stacspec.org/v0.3.0/aggregation"
- 13 "https://api.stacspec.org/v1.0.0/collections"
- 14 "http://www.opengis.net/spec/cql2/1.0/conf/advanced-comparison-operators"
- 15 "http://www.opengis.net/spec/cql2/1.0/conf/basic-cql2"
- 16 "https://api.stacspec.org/v1.0.0/item-search#fields"
- 17 "https://api.stacspec.org/v1.0.0-rc.1/collection-search#free-text"
- 18 "http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/features-filter"
- 19 "http://www.opengis.net/spec/cql2/1.0/conf/cql2-json"
- 20 "https://api.stacspec.org/v1.0.0/item-search"
- 21 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"
- 22 "https://api.stacspec.org/v1.0.0-rc.1/collection-search"
title "Public Datasets"

Similar to entering a folder, we use get_child to look inside that public catalog.

In [14]:

Copied!

sub2 = main_cat.get_child('public')
sub2
sub2 = main_cat.get_child('public')
sub2

Out[14]:

type "Catalog"
id "public"
stac_version "1.1.0"
description "A catalog of EODHP public catalogs"
links[] 13 items
- 0
  - rel "aggregate"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/aggregate"
  - type "application/json"
- 1
  - rel "aggregations"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/aggregations"
  - type "application/json"
- 2
  - rel "catalogs"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs"
  - type "application/geo+json"
- 3
  - rel "collections"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/collections"
  - type "application/geo+json"
- 4
  - rel "conformance"
  - href "https://eodatahub.org.uk/api/catalogue/stac/conformance"
  - type "application/json"
  - title "STAC/WFS3 conformance classes implemented by this server"
- 5
  - rel "data"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/collections"
  - type "application/geo+json"
- 6
  - rel "search"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/search"
  - type "application/geo+json"
  - title "STAC search"
  - method "GET"
- 7
  - rel "search"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/search"
  - type "application/geo+json"
  - title "STAC search"
  - method "POST"
- 8
  - rel "queryables"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/queryables"
  - type "application/json"
- 9
  - rel "root"
  - href "https://eodatahub.org.uk/api/catalogue/stac/"
  - type "application/json"
  - title "EO DataHub Catalogue"
- 10
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue"
  - type "application/json"
  - title "CEDA STAC API"
- 11
  - rel "self"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public"
  - type "application/json"
- 12
  - rel "parent"
  - href "https://eodatahub.org.uk/api/catalogue/stac/"
  - type "application/json"
  - title "EO DataHub Catalogue"
conformsTo[] 23 items
- 0 "https://api.stacspec.org/v1.0.0/item-search#fields"
- 1 "https://api.stacspec.org/v1.0.0-rc.1/collection-search"
- 2 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30"
- 3 "https://api.stacspec.org/v1.0.0/collections"
- 4 "https://api.stacspec.org/v1.0.0-rc.1/item-search#free-text"
- 5 "https://api.stacspec.org/v1.0.0/item-search#sort"
- 6 "http://www.opengis.net/spec/cql2/1.0/conf/cql2-text"
- 7 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"
- 8 "https://api.stacspec.org/v1.0.0/core"
- 9 "https://api.stacspec.org/v1.0.0/item-search#query"
- 10 "http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/features-filter"
- 11 "https://api.stacspec.org/v1.0.0/item-search"
- 12 "http://www.opengis.net/spec/cql2/1.0/conf/advanced-comparison-operators"
- 13 "http://www.opengis.net/spec/cql2/1.0/conf/cql2-json"
- 14 "http://www.opengis.net/spec/cql2/1.0/conf/basic-cql2"
- 15 "http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/filter"
- 16 "https://api.stacspec.org/v1.0.0-rc.2/item-search#filter"
- 17 "https://api.stacspec.org/v0.3.0/aggregation"
- 18 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core"
- 19 "https://api.stacspec.org/v1.0.0-rc.1/ogcapi-features#free-text"
- 20 "https://api.stacspec.org/v1.0.0-rc.1/collection-search#free-text"
- 21 "http://www.opengis.net/spec/ogcapi-common-2/1.0/conf/simple-query"
- 22 "https://api.stacspec.org/v1.0.0/ogcapi-features"
title "Public Datasets"

🔎 Going one level deeper into the directory structure, we find...

In [10]:

Copied!

sub3 = sub2.get_child('ceda-stac-catalogue')
sub3
sub3 = sub2.get_child('ceda-stac-catalogue')
sub3

Out[10]:

type "Catalog"
id "ceda-stac-catalogue"
stac_version "1.1.0"
description "This is an experimental STAC API server. The content is subject to change the and there is no guarantee surrounding its uptime. "
links[] 39 items
- 0
  - rel "aggregate"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/aggregate"
  - type "application/json"
- 1
  - rel "aggregations"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/aggregations"
  - type "application/json"
- 2
  - rel "catalogs"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/catalogs"
  - type "application/geo+json"
- 3
  - rel "collections"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections"
  - type "application/geo+json"
- 4
  - rel "conformance"
  - href "https://eodatahub.org.uk/api/catalogue/stac/conformance"
  - type "application/json"
  - title "STAC/WFS3 conformance classes implemented by this server"
- 5
  - rel "data"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections"
  - type "application/geo+json"
- 6
  - rel "search"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/search"
  - type "application/geo+json"
  - title "STAC search"
  - method "GET"
- 7
  - rel "search"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/search"
  - type "application/geo+json"
  - title "STAC search"
  - method "POST"
- 8
  - rel "queryables"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/queryables"
  - type "application/json"
- 9
  - rel "root"
  - href "https://eodatahub.org.uk/api/catalogue/stac/"
  - type "application/json"
  - title "EO DataHub Catalogue"
- 10
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/ceda_flights"
  - type "application/json"
  - title "CEDA Flights"
- 11
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/cmip6"
  - type "application/json"
  - title "CMIP6"
- 12
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/cordex"
  - type "application/json"
  - title "CORDEX"
- 13
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-aerosol-slstr-daily-s3a"
  - type "application/json"
  - title "EOCIS AEROSOL from Sentinel 3A daily"
- 14
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-aerosol-slstr-daily-s3b"
  - type "application/json"
  - title "EOCIS AEROSOL from Sentinel 3B daily"
- 15
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-aerosol-slstr-monthly-s3a"
  - type "application/json"
  - title "EOCIS AEROSOL from Sentinel 3A monthly"
- 16
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-aerosol-slstr-monthly-s3b"
  - type "application/json"
  - title "EOCIS AEROSOL from Sentinel 3B monthly"
- 17
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-arctic-sea-ice-thickness-monthly"
  - type "application/json"
  - title "EOCIS Arctic Monthly Gridded Sea Ice Thickness Product from CryoSat-2"
- 18
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-chuk-geospatial"
  - type "application/json"
  - title "EOCIS Geospatial Information"
- 19
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-chuk-geospatial-builtarea"
  - type "application/json"
  - title "EOCIS CHUK Geospatial Information - Built Area"
- 20
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-chuk-geospatial-elevation"
  - type "application/json"
  - title "EOCIS CHUK Geospatial Information - Elevation"
- 21
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-chuk-geospatial-landclass"
  - type "application/json"
  - title "EOCIS CHUK Geospatial Information - Land Class"
- 22
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-chuk-geospatial-landcover"
  - type "application/json"
  - title "EOCIS CHUK Geospatial Information - Land Cover"
- 23
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-chuk-land-vegetation-fapar"
  - type "application/json"
  - title "EOCIS CHUK Fraction of Absorbed Photosynthetically Active Radiation"
- 24
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-chuk-land-vegetation-lai"
  - type "application/json"
  - title "EOCIS CHUK Leaf Area Index (LAI)"
- 25
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-lst-s3a-day"
  - type "application/json"
  - title "EOCIS Land Surface Temperature from Sentinel 3A daily (day)"
- 26
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-lst-s3a-night"
  - type "application/json"
  - title "EOCIS Land Surface Temperature from Sentinel 3A daily (night)"
- 27
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-lst-s3b-day"
  - type "application/json"
  - title "EOCIS Land Surface Temperature from Sentinel 3B daily (day)"
- 28
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-lst-s3b-night"
  - type "application/json"
  - title "EOCIS Land Surface Temperature from Sentinel 3B daily (night)"
- 29
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-soil-moisture-africa"
  - type "application/json"
  - title "EOCIS Soil Moisture Africa v2.3.1"
- 30
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/eocis-sst-cdrv3"
  - type "application/json"
  - title "EOCIS Sea-Surface Temperatures V3"
- 31
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/era5_repack"
  - type "application/json"
  - title "ERA5 Re-analysis (Repacked)"
- 32
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/land_cover"
  - type "application/json"
  - title "ESA Land Cover Climate Change Initiative (CCI): Global Land Cover Maps"
- 33
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/sentinel1"
  - type "application/json"
  - title "Sentinel-1 Single Look Complex (SLC)"
- 34
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/sentinel1_ard"
  - type "application/json"
  - title "Sentinel 1 ARD"
- 35
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/sentinel2_ard"
  - type "application/json"
  - title "Sentinel 2 ARD"
- 36
  - rel "child"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/ukcp"
  - type "application/json"
  - title "UK Climate Projections (UKCP18)"
- 37
  - rel "self"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue"
  - type "application/json"
- 38
  - rel "parent"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public"
  - type "application/json"
  - title "Public Datasets"
conformsTo[] 23 items
- 0 "https://api.stacspec.org/v1.0.0/item-search#sort"
- 1 "https://api.stacspec.org/v1.0.0/collections"
- 2 "https://api.stacspec.org/v1.0.0-rc.2/item-search#filter"
- 3 "https://api.stacspec.org/v1.0.0/core"
- 4 "https://api.stacspec.org/v1.0.0-rc.1/collection-search#free-text"
- 5 "https://api.stacspec.org/v1.0.0/item-search"
- 6 "http://www.opengis.net/spec/cql2/1.0/conf/cql2-json"
- 7 "https://api.stacspec.org/v1.0.0-rc.1/ogcapi-features#free-text"
- 8 "https://api.stacspec.org/v1.0.0/item-search#fields"
- 9 "https://api.stacspec.org/v1.0.0/item-search#query"
- 10 "http://www.opengis.net/spec/ogcapi-common-2/1.0/conf/simple-query"
- 11 "http://www.opengis.net/spec/cql2/1.0/conf/cql2-text"
- 12 "http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/filter"
- 13 "https://api.stacspec.org/v1.0.0-rc.1/item-search#free-text"
- 14 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"
- 15 "https://api.stacspec.org/v1.0.0/ogcapi-features"
- 16 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core"
- 17 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30"
- 18 "http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/features-filter"
- 19 "http://www.opengis.net/spec/cql2/1.0/conf/basic-cql2"
- 20 "https://api.stacspec.org/v1.0.0-rc.1/collection-search"
- 21 "http://www.opengis.net/spec/cql2/1.0/conf/advanced-comparison-operators"
- 22 "https://api.stacspec.org/v0.3.0/aggregation"
title "CEDA STAC API"

We try looking for our collection here, inside the ceda-stac-catalogue

In [11]:

Copied!

sentinel_coll = sub3.get_collection('sentinel2_ard')
sentinel_coll
sentinel_coll = sub3.get_collection('sentinel2_ard')
sentinel_coll

Out[11]:

type "Collection"
id "sentinel2_ard"
stac_version "1.1.0"
description "These data have been created by the Department for Environment, Food and Rural Affairs (Defra) and Joint Nature Conservation Committee (JNCC) in order to cost-effectively provide high quality, Analysis Ready Data (ARD) for a wide range of applications. The dataset contains modified Copernicus Sentinel-2 (Level 1C data processed into a surface reflectance product using ARCSI software (Level 2))."
links[] 10 items
- 0
  - rel "aggregate"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/sentinel2_ard/aggregate"
  - type "application/json"
- 1
  - rel "aggregations"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/sentinel2_ard/aggregations"
  - type "application/json"
- 2
  - rel "items"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/sentinel2_ard/items"
  - type "application/geo+json"
- 3
  - rel "parent"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue"
  - type "application/json"
- 4
  - rel "queryables"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/sentinel2_ard/queryables"
  - type "application/json"
- 5
  - rel "root"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue"
  - type "application/json"
  - title "CEDA STAC API"
- 6
  - rel "self"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/sentinel2_ard"
  - type "application/json"
- 7
  - rel "ceda_catalogue"
  - href "https://catalogue.ceda.ac.uk/uuid/bf9568b558204b81803eeebcc7f529ef"
  - type "text/html"
- 8
  - rel "license"
  - href "https://eodatahub.org.uk/api/catalogue/stac/licences/spdx/text/OGL-UK-3.0.txt"
  - type "text/plain"
- 9
  - rel "license"
  - href "https://eodatahub.org.uk/api/catalogue/stac/licences/spdx/html/OGL-UK-3.0.html"
  - type "text/html"
stac_extensions[] 1 items
- 0 "https://stac-extensions.github.io/render/v1.0.0/schema.json"
renders
- rgb
  - title "RGB"
  - assets[] 1 items
    
    0 "cog"
  - bidx[] 3 items
    
    0 1
    
    1 2
    
    2 3
  - rescale[] 3 items
    
    0[] 2 items
    
    0 0
    
    1 100
    
    1[] 2 items
    
    0 0
    
    1 100
    
    2[] 2 items
    
    0 0
    
    1 100
  - resampling "nearest"
  - tilematrixsets
    
    WebMercatorQuad[] 2 items
    
    0 0
    
    1 30
title "Sentinel 2 ARD"
extent
- spatial
  - bbox[] 1 items
    
    0[] 4 items
    
    0 -9.00034454651177
    
    1 49.48562028352171
    
    2 3.1494256015866995
    
    3 61.33444247301668
- temporal
  - interval[] 1 items
    
    0[] 2 items
    
    0 "2015-07-08T00:00:00Z"
    
    1 None
license "OGL-UK-3.0"
keywords[] 9 items
- 0 "Analysis Ready Data"
- 1 "Sentinel"
- 2 "Surface Reflectance"
- 3 "ARD"
- 4 "Level2"
- 5 "ARCSI"
- 6 "JNCC"
- 7 "Defra"
- 8 "ESA"
providers[] 3 items
- 0
  - name "Department for Environment, Food and Rural Affairs (Defra)"
  - roles[] 1 items
    
    0 "producer"
  - url "https://www.gov.uk/government/organisations/department-for-environment-food-rural-affairs"
- 1
  - name "Joint Nature Conservation Committee (JNCC)"
  - roles[] 1 items
    
    0 "producer"
  - url "https://jncc.gov.uk"
- 2
  - name "Centre for Environmental Data Analysis (CEDA)"
  - roles[] 1 items
    
    0 "host"
  - url "https://ceda.ac.uk"
summaries
- Instrument Family Name Abbreviation[] 1 items
  - 0 "MSI"
- NSSDC Identifier[] 1 items
  - 0 "2015-000A"
- Instrument Family Name[] 1 items
  - 0 "Multi-Spectral Instrument"
- Platform Number[] 2 items
  - 0 "2A"
  - 1 "2B"
- Start Relative Orbit Number[] 7 items
  - 0 "023"
  - 1 "037"
  - 2 "066"
  - 3 "080"
  - 4 "094"
  - 5 "123"
  - 6 "137"
- Ground Tracking Direction[] 2 items
  - 0 "ascending"
  - 1 "descending"
assets
- thumbnail
  - href "https://dap.ceda.ac.uk/neodc/sentinel_ard/data/sentinel_2/2025/11/15/S2C_20251115_latn572lonw0054_T30VUJ_ORB123_20251115121213_utm30n_osgb_vmsk_sharp_rad_srefdem_stdsref_thumbnail.jpg"
  - type "image/jpg"
  - roles[] 1 items
    
    0 "thumbnail"

We have found the sentinel2_ard collection! We can also reach the data collection using the get_child arguement too.

In [12]:

Copied!

sub4 = sub3.get_child('sentinel2_ard')
sub4
sub4 = sub3.get_child('sentinel2_ard')
sub4

Out[12]:

type "Collection"
id "sentinel2_ard"
stac_version "1.1.0"
description "These data have been created by the Department for Environment, Food and Rural Affairs (Defra) and Joint Nature Conservation Committee (JNCC) in order to cost-effectively provide high quality, Analysis Ready Data (ARD) for a wide range of applications. The dataset contains modified Copernicus Sentinel-2 (Level 1C data processed into a surface reflectance product using ARCSI software (Level 2))."
links[] 7 items
- 0
  - rel "items"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/sentinel2_ard/items"
  - type "application/geo+json"
- 1
  - rel "root"
  - href "https://eodatahub.org.uk/api/catalogue/stac/"
  - type "application/json"
  - title "EO DataHub Catalogue"
- 2
  - rel "self"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue/collections/sentinel2_ard"
  - type "application/json"
- 3
  - rel "ceda_catalogue"
  - href "https://catalogue.ceda.ac.uk/uuid/bf9568b558204b81803eeebcc7f529ef"
  - type "text/html"
- 4
  - rel "license"
  - href "https://eodatahub.org.uk/api/catalogue/stac/licences/spdx/text/OGL-UK-3.0.txt"
  - type "text/plain"
- 5
  - rel "license"
  - href "https://eodatahub.org.uk/api/catalogue/stac/licences/spdx/html/OGL-UK-3.0.html"
  - type "text/html"
- 6
  - rel "parent"
  - href "https://eodatahub.org.uk/api/catalogue/stac/catalogs/public/catalogs/ceda-stac-catalogue"
  - type "application/json"
  - title "CEDA STAC API"
stac_extensions[] 1 items
- 0 "https://stac-extensions.github.io/render/v1.0.0/schema.json"
renders
- rgb
  - title "RGB"
  - assets[] 1 items
    
    0 "cog"
  - bidx[] 3 items
    
    0 1
    
    1 2
    
    2 3
  - rescale[] 3 items
    
    0[] 2 items
    
    0 0
    
    1 100
    
    1[] 2 items
    
    0 0
    
    1 100
    
    2[] 2 items
    
    0 0
    
    1 100
  - resampling "nearest"
  - tilematrixsets
    
    WebMercatorQuad[] 2 items
    
    0 0
    
    1 30
title "Sentinel 2 ARD"
extent
- spatial
  - bbox[] 1 items
    
    0[] 4 items
    
    0 -9.00034454651177
    
    1 49.48562028352171
    
    2 3.1494256015866995
    
    3 61.33444247301668
- temporal
  - interval[] 1 items
    
    0[] 2 items
    
    0 "2015-07-08T00:00:00Z"
    
    1 None
license "OGL-UK-3.0"
keywords[] 9 items
- 0 "Analysis Ready Data"
- 1 "Sentinel"
- 2 "Surface Reflectance"
- 3 "ARD"
- 4 "Level2"
- 5 "ARCSI"
- 6 "JNCC"
- 7 "Defra"
- 8 "ESA"
providers[] 3 items
- 0
  - name "Department for Environment, Food and Rural Affairs (Defra)"
  - roles[] 1 items
    
    0 "producer"
  - url "https://www.gov.uk/government/organisations/department-for-environment-food-rural-affairs"
- 1
  - name "Joint Nature Conservation Committee (JNCC)"
  - roles[] 1 items
    
    0 "producer"
  - url "https://jncc.gov.uk"
- 2
  - name "Centre for Environmental Data Analysis (CEDA)"
  - roles[] 1 items
    
    0 "host"
  - url "https://ceda.ac.uk"
summaries
- Instrument Family Name Abbreviation[] 1 items
  - 0 "MSI"
- NSSDC Identifier[] 1 items
  - 0 "2015-000A"
- Instrument Family Name[] 1 items
  - 0 "Multi-Spectral Instrument"
- Platform Number[] 2 items
  - 0 "2A"
  - 1 "2B"
- Start Relative Orbit Number[] 7 items
  - 0 "023"
  - 1 "037"
  - 2 "066"
  - 3 "080"
  - 4 "094"
  - 5 "123"
  - 6 "137"
- Ground Tracking Direction[] 2 items
  - 0 "ascending"
  - 1 "descending"
assets
- thumbnail
  - href "https://dap.ceda.ac.uk/neodc/sentinel_ard/data/sentinel_2/2025/11/15/S2C_20251115_latn572lonw0054_T30VUJ_ORB123_20251115121213_utm30n_osgb_vmsk_sharp_rad_srefdem_stdsref_thumbnail.jpg"
  - type "image/jpg"
  - roles[] 1 items
    
    0 "thumbnail"

💭 Reflections
- Using pystac to access the EODH STAC catalogue was quite difficult, and required many lines of code!
- Now, let's understand why using pyeodh is a better choice that makes accessing the data collection much simpler

pyeodh¶

🔌 First, we reach the data Hub by connecting via the Python client.

In [18]:

Copied!

client = pyeodh.Client(
    base_url="https://eodatahub.org.uk"
).get_catalog_service()
client = pyeodh.Client(
    base_url="https://eodatahub.org.uk"
).get_catalog_service()

Access a data collection with pyeodh¶

Using inbuild functions of the pyeodh package, we can quickly fetch the catalog and the collection we are looking for. Based on our printed directory structure, we already know the filepath.

In [22]:

Copied!

s2ard = client.get_catalog("public/catalogs/ceda-stac-catalogue").get_collection('sentinel2_ard')
s2ard
s2ard = client.get_catalog("public/catalogs/ceda-stac-catalogue").get_collection('sentinel2_ard')
s2ard

Out[22]:

<pyeodh.resource_catalog.Collection at 0x7f5a1b07bb90>

Immediately we can print some items, so we know that we have successfully found our data collection!

In [23]:

Copied!

items = s2ard.get_items()

# Warning: without the limit to 10 items this will take a long time for large catalogues such as s2ard
for item in items[:10]:
    print(item.id)
items = s2ard.get_items()

# Warning: without the limit to 10 items this will take a long time for large catalogues such as s2ard
for item in items[:10]:
    print(item.id)

neodc.sentinel_ard.data.sentinel_2.2026.02.12.S2A_20260212_latn608lonw0002_T30VXN_ORB037_20260212145709_utm30n_osgb
neodc.sentinel_ard.data.sentinel_2.2026.02.12.S2B_20260212_latn608lonw0002_T30VXN_ORB037_20260212145332_utm30n_osgb
neodc.sentinel_ard.data.sentinel_2.2026.02.12.S2B_20260212_latn599lonw0020_T30VWM_ORB037_20260212145332_utm30n_osgb
neodc.sentinel_ard.data.sentinel_2.2026.02.12.S2B_20260212_latn599lonw0002_T30VXM_ORB037_20260212145332_utm30n_osgb
neodc.sentinel_ard.data.sentinel_2.2026.02.12.S2B_20260212_latn590lonw0020_T30VWL_ORB037_20260212145332_utm30n_osgb
neodc.sentinel_ard.data.sentinel_2.2026.02.12.S2B_20260212_latn572lonw0037_T30VVJ_ORB037_20260212145332_utm30n_osgb
neodc.sentinel_ard.data.sentinel_2.2026.02.12.S2B_20260212_latn510lonw0036_T30UVB_ORB037_20260212145332_utm30n_osgb
neodc.sentinel_ard.data.sentinel_2.2026.02.11.S2C_20260211_latn509lonw0008_T30UXB_ORB094_20260211125907_utm30n_osgb
neodc.sentinel_ard.data.sentinel_2.2026.02.11.S2C_20260211_latn509lone0009_T31UCS_ORB094_20260211125907_utm31n_osgb
neodc.sentinel_ard.data.sentinel_2.2026.02.11.S2C_20260211_latn509lone0006_T30UYB_ORB094_20260211125907_utm30n_osgb

Author(s): Gemma Newbold, Gisela Romero Candanedo, Alastair Graham

Date created: 2026-02-18

Date last modified: 2026-03-16

Licence: This notebook is licensed under Creative Commons Attribution-ShareAlike 4.0 International. The code is released using the BSD-2-Clause license.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.