Metadata-Version: 2.4
Name: ecco_access
Version: 0.3.1
Summary: Access utilities for ECCO state estimate output hosted on PO.DAAC and in the AWS cloud
Author-email: ecco_access Developers <andrewdelman@ucla.edu>
Project-URL: Homepage, https://github.com/ECCO-GROUP/ECCO-ACCESS
Project-URL: Tracker, https://github.com/ECCO-GROUP/ECCO-ACCESS/issues
Keywords: ecco,climate,mitgcm,estimate,circulation,climate
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: future
Requires-Dist: dask[complete]
Requires-Dist: fsspec>=2024.12.0
Requires-Dist: netCDF4
Requires-Dist: pandas
Requires-Dist: python-dateutil
Requires-Dist: requests
Requires-Dist: s3fs>=2024.12.0
Requires-Dist: tqdm
Requires-Dist: xarray
Requires-Dist: zarr>=3.0.7
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: coverage; extra == "dev"
Dynamic: license-file

## Description

`ecco_access` is a Python package with utilities for accessing output from the Estimating the Circulation and Climate of the Ocean (ECCO) state estimate. These tools enable the user to query and download ECCO output to their local machine, or directly access the ECCO output when working in the AWS Cloud.

Currently access to ECCO version 4, releases 4 and 5 are supported. Additional versions will be made available as they are released through the Physical Oceanography Distributed Active Archive Center (PO.DAAC), or made available on the ECCO S3 bucket in the AWS Cloud (s3://ecco-model-granules).

There is some overlap in functionality with the [earthaccess](https://earthaccess.readthedocs.io/en/stable/) Python package for accessing NASA Earth science data, and datasets on PO.DAAC/NASA Earthdata can be accessed with both packages. However, `ecco_access` has some ECCO-specific features that enable:

- querying of the variables in ECCO datasets
- spatial subsetting of ECCO output in the 13-tile Lat-Lon-Cap (LLC) native grid
- access on the AWS Cloud to ECCO release(s) not yet available through NASA Earthdata

## Documentation

Documentation on how to use `ecco_access`, including installation/setup requirements and instructions, can be found on ReadtheDocs: https://ecco-access.readthedocs.io

## Support

If you have questions or notice a bug, please reach out to andrewdelman@ucla.edu.

## Contributors

If you have Python code that would be helpful for accessing ECCO data or adding new features, we'd love to include your contributions! Feel free to [create a fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo) of this repository and after including your changes, submit a pull request to the `main` branch of the original repository. Or contact andrewdelman@ucla.edu to discuss.
