Argo data python library
========================

**argopy** is a python library dedicated to :ref:`Argo <what_is_argo>` data access, manipulation and visualisation
for standard users as well as Argo experts.

|JOSS| |lifecycle| |Gitter|

|License| |Python version| |Anaconda-Server Badge|

Documentation
-------------

**Getting Started**

* :doc:`install`
* :doc:`usage`
* :doc:`why`
* :doc:`what_is_argo`

.. toctree::
    :maxdepth: 2
    :hidden:
    :caption: Getting Started

    install
    usage
    why
    what_is_argo

**User Guide**

* :doc:`data_fetching`
* :doc:`data_sources`
* :doc:`data_manipulation`
* :doc:`visualisation`
* :doc:`user_mode`
* :doc:`metadata_fetching`
* :doc:`performances`
* :doc:`data_quality_control`

.. toctree::
    :maxdepth: 2
    :hidden:
    :caption: User Guide

    data_fetching
    data_sources
    data_manipulation
    visualisation
    data_quality_control
    user_mode
    metadata_fetching
    performances

**Help & reference**

* :doc:`whats-new`
* :doc:`contributing`
* :doc:`api`

.. toctree::
    :maxdepth: 2
    :hidden:
    :caption: Help & reference

    whats-new
    contributing
    api


.. |JOSS| image:: https://img.shields.io/badge/DOI-10.21105%2Fjoss.02425-brightgreen
   :target: //dx.doi.org/10.21105/joss.02425
.. |Documentation| image:: https://img.shields.io/static/v1?label=&message=Read%20the%20documentation&color=blue&logo=read-the-docs&logoColor=white
   :target: https://argopy.readthedocs.io
.. |Gitter| image:: https://badges.gitter.im/Argo-floats/argopy.svg
   :target: https://gitter.im/Argo-floats/argopy?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge
.. |License| image:: https://img.shields.io/github/license/euroargodev/argopy
.. |Python version| image:: https://img.shields.io/pypi/pyversions/argopy
   :target: //pypi.org/project/argopy/
.. |Anaconda-Server Badge| image:: https://anaconda.org/conda-forge/argopy/badges/platforms.svg
   :target: https://anaconda.org/conda-forge/argopy
.. |pypi dwn| image:: https://img.shields.io/pypi/dm/argopy?label=Pypi%20downloads
   :target: //pypi.org/project/argopy/
.. |conda dwn| image:: https://img.shields.io/conda/dn/conda-forge/argopy?label=Conda%20downloads
   :target: //anaconda.org/conda-forge/argopy
.. |image8| image:: https://img.shields.io/github/release-date/euroargodev/argopy
   :target: //github.com/euroargodev/argopy/releases
.. |PyPI| image:: https://img.shields.io/pypi/v/argopy
   :target: //pypi.org/project/argopy/
.. |Conda| image:: https://anaconda.org/conda-forge/argopy/badges/version.svg
   :target: //anaconda.org/conda-forge/argopy
.. |tests in FREE env| image:: https://github.com/euroargodev/argopy/actions/workflows/pytests-free.yml/badge.svg
.. |tests in DEV env| image:: https://github.com/euroargodev/argopy/actions/workflows/pytests-dev.yml/badge.svg
.. |Documentation Status| image:: https://img.shields.io/readthedocs/argopy?logo=readthedocs
   :target: https://argopy.readthedocs.io/en/latest/?badge=latest
.. |codecov| image:: https://codecov.io/gh/euroargodev/argopy/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/euroargodev/argopy
.. |lifecycle| image:: https://img.shields.io/badge/lifecycle-stable-green.svg
   :target: https://www.tidyverse.org/lifecycle/#stable
.. |Erddap status| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/euroargodev/argopy-status/master/argopy_api_status_erddap.json
.. |Argovis status| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/euroargodev/argopy-status/master/argopy_api_status_argovis.json
.. |Profile count| image:: https://img.shields.io/endpoint?label=Number%20of%20Argo%20profiles%3A&style=social&url=https%3A%2F%2Fapi.ifremer.fr%2Fargopy%2Fdata%2FARGO-FULL.json
.. |Statuspage| image:: https://img.shields.io/static/v1?label=&message=Check%20all%20Argo%20monitors&color=blue&logo=statuspage&logoColor=white
   :target: https://argopy.statuspage.io
.. |image20| image:: https://img.shields.io/github/release-date/euroargodev/argopy
   :target: //github.com/euroargodev/argopy/releases
.. |image21| image:: https://img.shields.io/github/release-date/euroargodev/argopy
   :target: //github.com/euroargodev/argopy/releases
.. |badge| image:: https://img.shields.io/static/v1.svg?logo=Jupyter&label=Binder&message=Click+here+to+try+argopy+online+!&color=blue&style=for-the-badge
   :target: https://mybinder.org/v2/gh/euroargodev/binder-sandbox/main?urlpath=git-pull%3Frepo%3Dhttps%253A%252F%252Fgithub.com%252Feuroargodev%252Fargopy%26urlpath%3Dlab%252Ftree%252Fargopy%252Fdocs%252Ftryit.ipynb%26branch%3Dmaster
.. |index_traj| image:: https://github.com/euroargodev/argopy/raw/master/docs/_static/trajectory_sample.png