aquaview 0.4.0

Python SDK for the AQUAVIEW oceanographic and environmental data catalog

AQUAVIEW Python SDK

Python SDK for the AQUAVIEW oceanographic and environmental data catalog.

Other ways to access AQUAVIEW

AI agents: https://mcp.aquaview.org/mcp (learn more)

Interactive discovery map: https://aquaview.org/explore

Read more on our blog: https://aquaview.org/blog

Installation

pip install aquaview

Quick Start

import aquaview

client = aquaview.connect()

# List data sources
for col in client.get_collections():
    print(f"{col.id}: {col.title}")

# Search for datasets
search = client.search(
    collections=["IOOS"],
    bbox=[-71, 42, -70, 43],
    datetime="2023-01-01/2023-12-31",
    limit=10,
)

for item in search.items():
    print(item.id, item.properties.get("title"))

More Examples

# Multiple collections, bounding box, time range
search = client.search(
    collections=["NDBC", "IOOS"],
    bbox=[-75, 35, -70, 40],
    datetime="2024-01-01/2024-12-31",
)

# CQL2 property filters
search = client.search(
    filter={
        "op": "like",
        "args": [{"property": "aquaview:variables"}, "%temperature%"],
    },
    filter_lang="cql2-json",
)

# As GeoJSON
fc = client.search(collections=["IOOS"], limit=5).item_collection_as_dict()

API

aquaview.connect() returns a pystac_client.Client. The full pystac-client API works: search, collections, queryables, pagination, etc.

License

MIT