argopy

A global network of nearly 4000 autonomous probes measuring pressure, temperature and salinity from the surface to 2000m depth every 10 days.
https://github.com/euroargodev/argopy

Category: Hydrosphere
Sub Category: Ocean and Hydrology Data Access

Keywords

argo argo-data argo-floats oceanography python

Keywords from Contributors

geoscience climate-science measur transforms archiving climate-model earth-science projection finite-volume geospatial-data

Last synced: about 18 hours ago
JSON representation

Repository metadata

A python library for Argo data beginners and experts

Host: GitHub
URL: https://github.com/euroargodev/argopy
Owner: euroargodev
License: eupl-1.2
Created: 2020-03-17T16:14:32.000Z (about 5 years ago)
Default Branch: master
Last Pushed: 2025-04-21T05:22:05.000Z (6 days ago)
Last Synced: 2025-04-22T07:20:27.670Z (5 days ago)
Topics: argo, argo-data, argo-floats, oceanography, python
Language: Python
Homepage: https://argopy.readthedocs.io
Size: 1.46 GB
Stars: 202
Watchers: 11
Forks: 42
Open Issues: 35
Releases: 23
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff

README.md

`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 (index, reference tables, deployment plans, topography, ...)
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
All	Dashboard
CI tests running on each commit
Upstream CI tests, running daily

Development and contributions

See our development roadmap here: https://github.com/euroargodev/argopy/milestone/3

Checkout the contribution page if you want to get involved and help maintain or develop argopy.

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Maze"
  given-names: "Guillaume"
  orcid: "https://orcid.org/0000-0001-7231-2095"
- family-names: "Balem"
  given-names: "Kevin"
  orcid: "https://orcid.org/0000-0002-4956-8698"
title: "argopy"
doi: 10.5281/zenodo.4010160
url: "https://github.com/euroargodev/argopy"
preferred-citation:
  type: article
  authors:
    - family-names: "Maze"
      given-names: "Guillaume"
      orcid: "https://orcid.org/0000-0001-7231-2095"
    - family-names: "Balem"
      given-names: "Kevin"
      orcid: "https://orcid.org/0000-0002-4956-8698"
  doi: "10.21105/joss.02425"
  journal: "Journal of Open Source Software"
  title: "argopy: A Python library for Argo ocean data analysis"
  year: 2020
  volume: 5
  issue: 53
  page: 2425

Owner metadata

Name: Euro-Argo ERIC
Login: euroargodev
Email: [email protected]
Kind: organization
Description: Euro-Argo is the European infrastructure for the Argo programme that aims at sustaining 1/4 of the global network and enhance coverage in European seas.
Website: https://www.euro-argo.eu
Location:
Twitter: EuroArgoERIC
Company:
Icon url: https://avatars.githubusercontent.com/u/57987739?v=4
Repositories: 24
Last ynced at: 2023-03-04T11:59:39.730Z
Profile URL: https://github.com/euroargodev

GitHub Events

Total

Create event: 56
Issues event: 22
Release event: 2
Watch event: 19
Delete event: 47
Issue comment event: 84
Push event: 308
Pull request review event: 7
Pull request review comment event: 4
Pull request event: 95

Last Year

Create event: 56
Issues event: 22
Release event: 2
Watch event: 19
Delete event: 47
Issue comment event: 84
Push event: 308
Pull request review event: 7
Pull request review comment event: 4
Pull request event: 95

Committers metadata

Last synced: 6 days ago

Total Commits: 2,840
Total Committers: 12
Avg Commits per committer: 236.667
Development Distribution Score (DDS): 0.057

Commits in past year: 825
Committers in past year: 4
Avg Commits per committer in past year: 206.25
Development Distribution Score (DDS) in past year: 0.033

Name	Email	Commits
Guillaume Maze	g**e@i**r	2679
dependabot[bot]	4****]	81
quai20	k**m@g**m	54
Filipe Fernandes	o**f@g**m	7
bkatiemills	y**u@e**m	4
Andrew Barna	a**a@g**m	4
Arne Tarara	a**e@d**e	3
tylertucker202	t**2@g**m	2
Dhruv Balwada	d**a@g**m	2
Damien Irving	i**n@g**m	2
Ryan Abernathey	r**y@g**m	1
Kurt Schwehr	s**r@g**m	1

Committer domains:

Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 152
Total pull requests: 316
Average time to close issues: 5 months
Average time to close pull requests: 20 days
Total issue authors: 49
Total pull request authors: 18
Average comments per issue: 4.18
Average comments per pull request: 1.08
Merged pull request: 216
Bot issues: 3
Bot pull requests: 162

Past year issues: 31
Past year pull requests: 99
Past year average time to close issues: 19 days
Past year average time to close pull requests: 11 days
Past year issue authors: 10
Past year pull request authors: 4
Past year average comments per issue: 2.81
Past year average comments per pull request: 0.82
Past year merged pull request: 60
Past year bot issues: 0
Past year bot pull requests: 50

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/euroargodev/argopy

Top Issue Authors

gmaze (74)
cywhale (4)
cgrdn (4)
iuryt (4)
github-actions[bot] (3)
jpivarski (3)
ctroupin (3)
PedroVelez (3)
dcherian (2)
mayursapkal (2)
andrewfagerheim (2)
apatlpo (2)
kamwal (2)
ElenaTerzic (2)
dhruvbalwada (2)

Top Pull Request Authors

dependabot[bot] (162)
gmaze (129)
ocefpaf (6)
quai20 (4)
DocOtak (2)
luzpaz (1)
tylertucker202 (1)
codacy-badger (1)
gitter-badger (1)
dhruvbalwada (1)
ArneTR (1)
xeulha (1)
schwehr (1)
pyup-bot (1)
bkatiemills (1)

Top Issue Labels

invalid (33)
internals (33)
stale (33)
enhancement (33)
bug (19)
good first issue (13)
help wanted (13)
performance (12)
argo-BGC (11)
documentation (10)
argo-core (10)
question (10)
backends (10)
CI (8)
argo-traj (5)
forQCexpert (4)
breaking-change (4)
python-environment (4)
wontfix (3)
argo-deep (3)
plot (2)
design (2)
dependencies (1)

Top Pull Request Labels

dependencies (166)
ignore-for-release (136)
github_actions (60)
enhancement (47)
internals (31)
release (16)
performance (15)
documentation (14)
bug (13)
backends (13)
argo-BGC (9)
stale (6)
CI (6)
argo-core (5)
forQCexpert (3)
plot (3)
argo-traj (1)
argo-deep (1)
invalid (1)
python-environment (1)
design (1)

Package metadata

Total packages: 2
Total downloads:
- pypi: 1,420 last-month
Total docker downloads: 211
Total dependent packages: 1 (may contain duplicates)
Total dependent repositories: 14 (may contain duplicates)
Total versions: 30
Total maintainers: 2

pypi.org: argopy

A python library for Argo data beginners and experts

Homepage: https://github.com/euroargodev/argopy
Documentation: https://argopy.readthedocs.io/
Licenses: eupl-1.2
Latest release: 1.1.0 (published about 1 month ago)
Last Synced: 2025-04-25T12:33:12.600Z (2 days ago)
Versions: 21
Dependent Packages: 1
Dependent Repositories: 5
Downloads: 1,420 Last month
Docker Downloads: 211
Rankings:
- Docker downloads count: 2.823%
- Dependent packages count: 3.24%
- Stargazers count: 5.599%
- Average: 5.699%
- Forks count: 6.555%
- Dependent repos count: 6.736%
- Downloads: 9.239%
Maintainers (2)
- balemkevin
- euroargodev

conda-forge.org: argopy

Homepage: https://github.com/euroargodev/argopy
Licenses: Apache-2.0
Latest release: 0.1.12 (published almost 3 years ago)
Last Synced: 2025-04-01T02:08:57.563Z (26 days ago)
Versions: 9
Dependent Packages: 0
Dependent Repositories: 9
Rankings:
- Dependent repos count: 11.54%
- Forks count: 28.695%
- Stargazers count: 29.214%
- Average: 30.247%
- Dependent packages count: 51.54%

Dependencies

.github/workflows/codeql-analysis.yml actions

actions/checkout v3 composite
github/codeql-action/analyze v2 composite
github/codeql-action/autobuild v2 composite
github/codeql-action/init v2 composite

.github/workflows/pytests-upstream.yml actions

actions/checkout v3 composite
mamba-org/provision-with-micromamba v15 composite
xarray-contrib/ci-trigger v1 composite
xarray-contrib/issue-from-pytest-log v1 composite

.github/workflows/pytests.yml actions

actions/checkout v3 composite
codecov/codecov-action v3.1.1 composite
mamba-org/provision-with-micromamba v15 composite
xarray-contrib/ci-trigger v1.2 composite

.github/workflows/pythonpublish.yml actions

actions/checkout v3 composite
actions/setup-python v4 composite

.github/workflows/stale.yml actions

actions/stale v7 composite

.github/workflows/pytests-upstream-windows.yml actions

actions/checkout v4 composite
mamba-org/setup-micromamba v1 composite
xarray-contrib/ci-trigger v1 composite
xarray-contrib/ci-trigger v1.2 composite

Score: 15.36210323484326

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology