Skip to main content

Altimetry-io

A library providing a unified way to read an altimetry data collection, independent of the underlying data representation.

  • Relies on Files Collections for NetCDF files collections reading
  • Can also read ZCollections format

Installation

conda install altimetry-io -c conda-forge

Use

from altimetry.io import AltimetryData, FileCollectionSource

alti_data = AltimetryData(
    source=FileCollectionSource(
        # Path to a local directory containing NetCDF data
        path="data_dir",
        # Available ftype: SWOT_L2_LR_SSH, SWOT_L3_LR_SSH, SWOT_L3_LR_WIND_WAVE, NADIR_L2, NADIR_L3
        ftype="SWOT_L3_LR_SSH",
        # Available ftype for SWOT_L3_LR_SSH: Basic, Expert, Unsmoothed, Technical
        subset="Unsmoothed"
    ),
)

ds = alti_data.query_orbit(
    cycle_number=13,
    pass_number= [153, 155],
    variables=["time", "latitude", "longitude", "quality_flag", "ssha_unedited"],
    polygon=(-151, -109, 71, 78)
)
print(ds.sizes)

Output:

Frozen({'num_lines': 15893, 'num_pixels': 519})
print(list(ds.data_vars))

Output:

['quality_flag', 'ssha_unedited', 'cycle_number', 'pass_number']

Project status

⚠️ This project is still subject to breaking changes. Versioning will reflects the breaking changes using SemVer convention

License

Apache 2.0 — see LICENSE

Metadata

Release files for altimetry-io 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for altimetry-io 0.3.0
File Size Uploaded
altimetry_io-0.3.0.tar.gz 43.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for altimetry-io 0.3.0
File Interpreter ABI Platform
altimetry_io-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 67.0 kB

Release files / altimetry_io-0.3.0.tar.gz

Download URL altimetry_io-0.3.0.tar.gz
Size 43.2 kB
Tags Source
SHA-256 checksum
How to use checksums
644f55df388a7fcaab9229a253d0f10c942fc2bef7347a2a1e8306497811b827
BLAKE2b-256 checksum
How to use checksums
b2d18ca84233f118367c1fa267ba6a97ff5a8a18417ed940c06796a9e1e9b753
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / altimetry_io-0.3.0-py3-none-any.whl

Download URL altimetry_io-0.3.0-py3-none-any.whl
Size 23.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7df68d5b2c8a9bc5aa293d74f720a20cf133a561d55f39c191cb22ba1ba8de09
BLAKE2b-256 checksum
How to use checksums
28af1256b96f7303c8d7a2abd9951be2aebe0d1a2233b0ac067ec09560bc6bda
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page