Metadata-Version: 2.4
Name: altimetry-io
Version: 0.0.0
Summary: Provide a unified way to read a data collection, independent of the underlying data representation.
Author-email: Thomas Zilio <tzilio@groupcls.com>, Anne-Sophie Tonneau <atonneau@groupcls.com>
Maintainer-email: Thomas Zilio <tzilio@groupcls.com>, Anne-Sophie Tonneau <atonneau@groupcls.com>
Project-URL: repository, https://github.com/robin-cls/altimetry_io
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Oceanography
Classifier: Development Status :: 4 - Beta
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fsspec
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: xarray
Requires-Dist: files-collections
Provides-Extra: polygon
Requires-Dist: geopandas; extra == "polygon"
Requires-Dist: pyinterp; extra == "polygon"
Requires-Dist: shapely; extra == "polygon"
Provides-Extra: sources
Requires-Dist: cls_tables; extra == "sources"
Requires-Dist: swot_calval; extra == "sources"
Provides-Extra: tests
Requires-Dist: pytest; extra == "tests"
Requires-Dist: cls_tables; extra == "tests"
Requires-Dist: geopandas; extra == "tests"
Requires-Dist: pyinterp; extra == "tests"
Requires-Dist: shapely; extra == "tests"
Provides-Extra: coverage
Requires-Dist: pytest-cov; extra == "coverage"
Provides-Extra: documentation
Provides-Extra: dev-tools
Requires-Dist: ruff; extra == "dev-tools"
Requires-Dist: pre-commit; extra == "dev-tools"
Dynamic: license-file

# Altimetry_io

Provide a unified way to read a data collection, independent of the underlying data representation.

- Relies on [FCollections](https://robin-cls.github.io/fcollections/index.html#) for netcdf files collections reading
- Can also read Zcollections or CLS tables


## Quick start

```bash
conda install altimetry-io
```

```python
from altimetry.io import AltimetryData, FileCollectionSource

alti_data = AltimetryData(
    source=FileCollectionSource(
        path=output_dir,
        ftype="SWOT_L3_LR_SSH",
        subset="Unsmoothed"
    ),
)

ds = alti_data.query_orbit(
    cycle_number=13,
    pass_number= [153, 155, 157, 181, 183, 209, 211, 237],
    variables=["time", "latitude", "longitude", "quality_flag", "ssha_unedited"],
    polygon=(-151, -109, 71, 78)
)
```

## Documentation

📘 **Full documentation:**
https://robin-cls.github.io/altimetry_io/index.html#

## 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](LICENSE)
