 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:
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. See here more for all details: https://argopy.readthedocs.io/en/latest/tutorials.html
2 maintainers
Metadata
2 maintainers
Release files for argopy 1.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| argopy-1.4.0.tar.gz | 1.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| argopy-1.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.1 MB
Release files / argopy-1.4.0.tar.gz
| Download URL | argopy-1.4.0.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ede418bfed0f17b9011cffe0e1828d99cdc98d850bfa790f68de7be10b6d252e
|
|
BLAKE2b-256 checksum How to use checksums |
2918e37edae2d9dc4215d5ffe195f54b790b29a9d52d6141fd1d9d84cd1b3cce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 5, 2026.
Transparency logRelease files / argopy-1.4.0-py3-none-any.whl
| Download URL | argopy-1.4.0-py3-none-any.whl |
|---|---|
| Size | 1.7 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3234b1dc8f8861093885c677645e069a56d1aa0239db3a0b47f1214b72564df5
|
|
BLAKE2b-256 checksum How to use checksums |
e9b061ef421a83b2c5eb7d939e6b44bff6a1787811b97765ba4dfdeb15436585
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 5, 2026.
Transparency log
