Overture — browse the catalog (no network)¶

The bundled Catalog maps four friendly themes to their Overture feature types. This notebook explores it without touching the network — handy before you pick a theme + bbox to download.

Setup¶

Import the bundled Overture Catalog. It ships with the package, so nothing here touches the network.

In [ ]:

from earthlens.overture import Catalog

from earthlens.overture import Catalog

The themes¶

Construct the Catalog and list its themes. Each theme is a friendly name that maps to one or more Overture feature types.

In [ ]:

cat = Catalog()
cat.themes()

cat = Catalog() cat.themes()

For each theme, print its feature types, the default_type used when you do not name one, and the geometry kind its rows carry.

In [ ]:

for name in cat.themes():
    theme = cat.get_theme(name)
    print(
        f"{name:16s} types={theme.types} default={theme.default_type!r} "
        f"geometry={theme.geometry}"
    )

for name in cat.themes(): theme = cat.get_theme(name) print( f"{name:16s} types={theme.types} default={theme.default_type!r} " f"geometry={theme.geometry}" )

Each theme records the licenses its rows typically carry — note that every theme can contain ODbL-1.0 (OpenStreetMap-derived) rows, which the backend surfaces per row.

In [ ]:

cat.get_theme('buildings').licenses

cat.get_theme('buildings').licenses

All six Overture themes are curated. The available_datasets index lists every queryable feature type, and each curated theme's types are a subset of it:

In [ ]:

curated = {t for theme in cat.datasets.values() for t in theme.types}
available = set(cat.available_types())
print('all types    :', cat.available_types())
print('curated types:', sorted(curated))
print('every type curated?', curated == available)

curated = {t for theme in cat.datasets.values() for t in theme.types} available = set(cat.available_types()) print('all types :', cat.available_types()) print('curated types:', sorted(curated)) print('every type curated?', curated == available)

The informational release index (newest first). The SDK auto-targets the newest when you do not pin a release.

In [ ]:

cat.available_releases, cat.latest_release()

cat.available_releases, cat.latest_release()

An unknown theme raises with a did-you-mean hint:

In [ ]:

try:
    cat.get_theme('building')
except ValueError as exc:
    print(exc)

try: cat.get_theme('building') except ValueError as exc: print(exc)