argopy

argopy is a python library dedicated to Argo data access, visualisation and manipulation for regular users as well as Argo experts and operators

Documentation

The official documentation is hosted on ReadTheDocs.org: https://argopy.readthedocs.io

Install

Binary installers for the latest released version are available at the Python Package Index (PyPI) and on Conda.

# conda
conda install -c conda-forge argopy

# or PyPI
pip install argopy

argopy is continuously tested to work under most OS (Linux, Mac, Windows) and with python versions >= 3.8

Usage

# Import the main data fetcher:
from argopy import DataFetcher

# Define what you want to fetch... 
# a region:
ArgoSet = DataFetcher().region([-85,-45,10.,20.,0,10.])
# floats:
ArgoSet = DataFetcher().float([6902746, 6902747, 6902757, 6902766])
# or specific profiles:
ArgoSet = DataFetcher().profile(6902746, 34)

# then fetch and get data as xarray datasets:
ds = ArgoSet.load().data
# or
ds = ArgoSet.to_xarray()

# you can even plot some information:
ArgoSet.plot('trajectory')    

They are many more usages and fine-tuning to allow you to access and manipulate Argo data:

• filters at fetch time (standard vs expert users, automatically select QC flags or data mode, ...)
• select data sources (erddap, ftp, local, argovis, ...)
• manipulate data (points, profiles, interpolations, binning, ...)
• visualisation (trajectories, topography, histograms, ...)
• tools for Quality Control (OWC, figures, ...)
• access meta-data and other Argo-related datasets (reference tables, deployment plans, topography, DOIs, ...)
• improve performances (caching, parallel data fetching)

Just check out the documentation for more !

🌿 Energy impact of argopy development

The argopy team is concerned about the environmental impact of your favorite software development. Starting June 1st 2024, we're experimenting with the Green Metrics Tools from Green Coding to get an estimate of the energy used and CO2eq emitted by our development activities on Github infrastructure. Results:

Activity	Green Coding tool
CI tests running on each commit
Upstream CI tests, running daily

Development and contributions

See our software management dashboard here: https://github.com/orgs/euroargodev/projects/19

And if you want to get involved and help maintain or develop argopy, please checkout the contribution page.

Tutorials

Some tutorials, as jupyter notebooks, are available to get you started:

• https://github.com/euroargodev/argopy/blob/master/docs/tutorials/basic_features_core_01.ipynb