Skip to content

CNES/altimetry-downloader-aviso

 
 

Repository files navigation

Altimetry Downloader Aviso

A tool to easily search and download altimetry products from the Aviso catalog.

  • List products available and retrieve their metadata information
  • Apply filters to download files in their original NetCDF format, via Aviso's Thredds Data Server using HTTPS connection.
  • Both a command line interface and a Python interface

Installation

conda install altimetry-downloader-aviso -c conda-forge

Use

List products available in Aviso's catalog

For now, the tool only allows users to browse and download SWOT products.

>>> altimetry-downloader-aviso summary

┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Short NameTitle                                                                                              ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ L4_exp_with_SWOTExperimental Products: Multimission Gridded (with SWOT) Level-4 Sea Surface Heights and Velocities │
│ SWOT_L2_LR_SSH_BasicAltimetry product SWOT Level-2 KaRIn Low Rate SSH - Basic                                          │
│ SWOT_L2_LR_SSH_ExpertAltimetry product SWOT Level-2 KaRIn Low Rate SSH - Expert                                         │
│ SWOT_L2_LR_SSH_UnsmoothedAltimetry product SWOT Level-2 KaRIn Low Rate SSH - Unsmoothed                                     │
│ SWOT_L2_LR_SSH_WindWaveAltimetry product SWOT Level-2 KaRIn Low Rate SSH - WindWave                                       │
│ SWOT_L3_LR_SSH_BasicAltimetry product SWOT Level-3 Low Rate SSH - Basic                                                │
│ SWOT_L3_LR_SSH_ExpertAltimetry product SWOT Level-3 Low Rate SSH - Expert                                               │
│ SWOT_L3_LR_SSH_UnsmoothedAltimetry product SWOT Level-3 Low Rate SSH - Unsmoothed                                           │
│ SWOT_L3_LR_WIND_WAVE_ExtendedWind & Wave product SWOT Level-3 WindWave - Extended                                               │
│ SWOT_L3_LR_WIND_WAVE_LightWind & Wave product SWOT Level-3 WindWave - Light                                                  │
└───────────────────────────────┴────────────────────────────────────────────────────────────────────────────────────────────────────┘

Get a product details

>>> altimetry-downloader-aviso details SWOT_L3_LR_SSH_Basic

╭───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── Product: SWOT_L3_LR_SSH_Basic ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ │
│ ┃ FieldValue                                                                                                                                                                                                                                                                            ┃ │
│ ┡━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩ │
│ │ Idaa2927ad-d1d6-4867-89d3-1311bc11e6bb                                                                                                                                                                                                                                             │ │
│ │ TitleAltimetry product SWOT Level-3 Low Rate SSH - Basic                                                                                                                                                                                                                              │ │
│ │ Short NameSWOT_L3_LR_SSH_Basic                                                                                                                                                                                                                                                             │ │
│ │ KeywordsPlatform(s): SWOT, SWOT                                                                                                                                                                                                                                                          │ │
│ │                           │ Instrument(s): POSEIDON-3C, KaRIn                                                                                                                                                                                                                                                │ │
│ │                           │ Parameters(s): Sea Surface Topography                                                                                                                                                                                                                                            │ │
│ │                           │ Spatial resolution: 2 km                                                                                                                                                                                                                                                         │ │
│ │                           │                                                                                                                                                                                                                                                                                  │ │
│ │ AbstractThe SWOT L3_LR_SSH product provides ocean topography measurements obtained from the SWOT KaRIn and nadir altimeter instruments, merged into a single variable. The dataset includes measurements from KaRIn swaths on both sides of the image, while the measurements from the   │ │
│ │                           │ nadir altimeter are located in the central columns. In the areas between the nadir track and the two KaRIn swaths, as well as on the outer edges of each swath (restricted to cross-track distances ranging from 10 to 60 km), default values are expected.                      │ │
│ │                           │                                                                                                                                                                                                                                                                                  │ │
│ │                           │ SWOT L3_LR_SSH is a cross-calibrated product from multiple missions that contains only the ocean topography content necessary for thematic research (e.g., oceanography, geodesy) and related applications. This product is designed to be simple and ready-to-use, and can be   │ │
│ │                           │ combined with other altimetry missions.  The SWOT L3_LR_SSH product is a research-orientated extension of the L2_LR_SSH product, distributed by the SWOT project (NASA/JPL and CNES) and managed by the SWOT Science Team project DESMOS.                                        │ │
│ │                           │                                                                                                                                                                                                                                                                                  │ │
│ │                           │ The "Basic" version of SWOT L3_LR_SSH (the "Expert" version is the subject of a separate metadata sheet) includes only the SSH anomalies and mean dynamic topography.                                                                                                            │ │
│ │ LevelL3                                                                                                                                                                                                                                                                               │ │
│ │ URLhttps://tds%40odatis-ocean.fr:odatis@tds-odatis.aviso.altimetry.fr/thredds/catalog/L3/SWOT_KARIN-L3_LR_SSH.html                                                                                                                                                                  │ │
│ │ DOIhttps://doi.org/10.24400/527896/A01-2023.017                                                                                                                                                                                                                                     │ │
│ │ Last Update2025-03-14 23:00:00+00:00                                                                                                                                                                                                                                                        │ │
│ │ Last Versionv3.0                                                                                                                                                                                                                                                                           │ │
│ │ CreditCDS-AVISO                                                                                                                                                                                                                                                                        │ │
│ │ OrganisationAVISO                                                                                                                                                                                                                                                                            │ │
│ │ Contactaviso@altimetry.fr                                                                                                                                                                                                                                                               │ │
│ │ Resolution2 km                                                                                                                                                                                                                                                                             │ │
│ │ Temporal extent2023-03-29 00:00:00, None                                                                                                                                                                                                                                                        │ │
│ │ Geographic extent-180.0, 180.0, -80.0, 80.0                                                                                                                                                                                                                                                       │ │
│ └───────────────────────────┴──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

Download a product

>>> altimetry-downloader-aviso get SWOT_L3_LR_SSH_Basic --output aviso_dir --cycle 7 --pass 12,13

Downloaded files (2) :
- aviso_dir/SWOT_L3_LR_SSH_Basic_007_012_20231123T193011_20231123T202137_v3.0.nc
- aviso_dir/SWOT_L3_LR_SSH_Basic_007_013_20231123T202138_20231123T211304_v3.0.nc

Documentation

📘 Full documentation: https://cnes.github.io/altimetry-downloader-aviso/index.html

Key pages:

License

Apache 2.0 — see LICENSE

Packages

 
 
 

Contributors

Languages

  • Python 100.0%