Altimetry Search

Search and select satellite altimetry passes (SWOT science and cal/val phases) by date and geographic area.

This package exposes the API only (orbit/pass search). The interactive map-based GUI (ipyleaflet/ipywidgets) lives in the separate altimetry.search.gui module and is not installed with this package — see Looking for Swot passes using the GUI below if you need it.

Installation

pip

pip install altimetry-search

conda

conda install -c conda-forge altimetry-search

Quickstart

import numpy
import pyinterp.geometry.geographic as py_geo
from altimetry.search import Mission, get_selected_passes, get_pass_passage_time, get_passes_crossing_polygon

mission = Mission.SWOT_SWATH_SCIENCE

# Search all passes starting within one cycle of a given date
selected_passes = get_selected_passes(
    mission,
    date=numpy.datetime64("2024-01-01"),
)

# Get the list of passes numbers intersecting a polygon
bbox = py_geo.algorithms.from_wkt(
    'POLYGON((-6 36,-6 60,36 60,36 36,-6 36))')

passes = numpy.array(sorted(set(selected_passes['pass_number'])))

passes_list = get_passes_crossing_polygon(
    mission=mission,
    polygon=bbox,
    passes=passes
)

# Restrict passes to those crossing a given area, and get the passage time
# window for each of them

passage_time = get_pass_passage_time(
    mission,
    selected_passes,
    polygon=bbox
)

Available missions are :

• SWOT_SWATH_SCIENCE
• SWOT_NADIR_SCIENCE
• SWOT_SWATH_CALVAL
• SWOT_NADIR_CALVAL

Looking for Swot passes using the GUI

To launch the application, click on the link below:

• https://mybinder.org/v2/gh/CNES/altimetry-search/HEAD?urlpath=voila%2Frender%2Fmain.ipynb

To launch jupyterlab in binder, clink on the link below:

• https://mybinder.org/v2/gh/CNES/altimetry-search/HEAD?labpath=main.ipynb

Changelog

See the CHANGELOG for versions details.

License

BSD-3-Clause — see LICENSE.