API Overview#

Processing levels#

CryoSwath is organized around data processing levels:

  1. cryoswath.l1b Load and preprocess ESA CryoSat-2 SARIn L1b tracks, including waveform filtering and ambiguity handling.

  2. cryoswath.l2 Convert processed tracks to geolocated point elevations (swath/POCA) and optionally cache/export.

  3. cryoswath.l3 Aggregate L2 point observations into regular spatio-temporal grids.

  4. cryoswath.l4 Gap-fill gridded products and derive trend/time-series products.

Supporting modules#

  • cryoswath.misc Shared utilities (paths, I/O, interpolation helpers, patches, data access, and CLI helpers).

  • cryoswath.gis Geospatial helper functions for CRS handling and geometry operations.

  • cryoswath.provenance CF-style history helpers and richer provenance serialization for output stores.

  • cryoswath.test_plots Plotting utilities for quick validation and diagnostics.

Typical workflow#

  1. Discover/select tracks for a region/time range.

  2. Process L1b to L2 with cryoswath.l2.from_id().

  3. Build gridded products with cryoswath.l3.build_dataset().

  4. Produce higher-level products with cryoswath.l4.