API

API#

class altimetry_downloader_aviso.AvisoCatalog(products)#

Bases: object

Catalog of the AVISO/ODATIS service.

Contains a list of available products parsed from the metadata catalog.

Parameters:

products (list[AvisoProduct]) – List of available products in the catalog.

products: list[AvisoProduct]#
class altimetry_downloader_aviso.AvisoProduct(id, title=None, short_name=None, keywords=None, abstract=None, processing_level=None, tds_catalog_url=None, doi=None, last_update=None, last_version=None, credit=None, organisation=None, contact=None, resolution=None, temporal_extent=(None, None), geographic_extent=(None, None, None, None))#

Bases: object

Product of the catalog.

Contains the product metadata.

Parameters:

  • id (str) – Product ID.

  • title (str) – Full title of the product.

  • short_name (str) – Short name (used as identifier).

  • keywords (str) – Comma-separated list of keywords.

  • abstract (str) – Description or summary of the product.

  • processing_level (str) – Processing level (e.g., L2, L3).

  • tds_catalog_url (str) – URL to the THREDDS catalog.

  • doi (str) – Digital Object Identifier of the product.

  • last_update (datetime) – Last update of the product.

  • last_version (str) – Version identifier of the product.

  • credit (str) – Data provider or credit information.

  • organisation (str) – Responsible organisation.

  • contact (str) – Contact email or name.

  • resolution (str) – Spatial resolution of the dataset.

  • temporal_extent (tuple[datetime, datetime]) – Start and end dates of the data coverage.

  • geographic_extent (tuple[float, float, float, float]) – Bounding box as (west, east, south, north).

abstract: str | None = None#
contact: str | None = None#
credit: str | None = None#
doi: str | None = None#
geographic_extent: tuple[float, float, float, float] | None = (None, None, None, None)#
id: str#
keywords: str | None = None#
last_update: datetime | None = None#
last_version: str | None = None#
organisation: str | None = None#
processing_level: str | None = None#
resolution: str | None = None#
short_name: str | None = None#
tds_catalog_url: str | None = None#
temporal_extent: tuple[datetime, datetime] | None = (None, None)#
title: str | None = None#
altimetry_downloader_aviso.details(product_short_name)#

Details a product information from AVISO’s catalog.

Parameters:

product_short_name (str) – the short name of the product

Return type:

AvisoProduct

Returns:

The description of product

altimetry_downloader_aviso.get(product_short_name, output_dir, cycle_number=None, pass_number=None, time=None, version=None, overwrite=False)#

Downloads a product from Aviso’s Thredds Data Server.

Parameters:

  • product_short_name (str) – the short name of the product

  • output_dir (str | Path) – directory to store downloaded product files

  • cycle_number (int | list[int] | None) – the cycle number for files/folders selection

  • pass_number (int | list[int] | None) – the pass number for files/folders selection

  • time (tuple[datetime64, datetime64] | None) – the period for files/folders selection

  • version (str | None) – the version for files/folders selection

  • overwrite (bool) – whether to overwrite files if they already exist

Return type:

list[str]

Returns:

The list of downloaded local file paths

altimetry_downloader_aviso.summary()#

Summarizes CDS-AVISO and SWOT products from AVISO’s catalog.

Return type:

AvisoCatalog

Returns:

The AVISO catalog object containing all the CDS-AVISO and SWOT products

Contents