🎓Tutorials and training
========================

Contributions are highly welcomed and appreciated. So, if you are interested in contributing, please consult the
:doc:`contributing` guide.

.. important::

    If some links get broken in the table above, please refer to **all possible Argopy tutorials available on the dedicated repository at:** https://github.com/euroargodev/argopy-training

Tutorials
---------

Click the `MyBinder <https://euroargodev.github.io/binder-links-creator>`_ button below to open a jupyter notebook ready to play with Argopy tutorials:

|Binder|

.. |Binder| image:: https://img.shields.io/static/v1.svg?logo=Jupyter&label=Argopy&message=Start%20online%20tutorial%20notebooks&color=blue
    :target: https://2i2c.mybinder.org/v2/gh/euroargodev/binder-sandbox/main?urlpath=git-pull%3Frepo%3Dhttps%253A%252F%252Fgithub.com%252Feuroargodev%252Fargopy-training%26urlpath%3Dlab%252Ftree%252Fargopy-training%252Fcontent%26branch%3Dmain

.. list-table:: List of **Argopy** tutorial notebooks
    :header-rows: 0
    :stub-columns: 1

    * - 📊 Argo data fetching
      - `Select and fetch data <https://github.com/euroargodev/argopy-training/blob/main/content/argo-data-fetching/select-and-fetch-data.ipynb>`_
    * -
      - `Source and user mode <https://github.com/euroargodev/argopy-training/blob/main/content/argo-data-fetching/fetching-options.ipynb>`_
    * -
      - `BGC data specifics <https://github.com/euroargodev/argopy-training/blob/main/content/argo-data-fetching/bgc-specifics.ipynb>`_
    * -
      - `Direct access to one float dataset <https://github.com/euroargodev/argopy-training/blob/main/content/argo-data-fetching/direct-access-to-float-dataset.ipynb>`_
    * -
      - `How to handle large data selection <https://github.com/euroargodev/argopy-training/blob/main/content/argo-data-fetching/large-data-selection.ipynb>`_
    * - 🛠️ Argo data manipulation
      - `Filtering (QC flags, data mode) <https://github.com/euroargodev/argopy-training/blob/main/content/argo-data-manipulation/filtering-qc-mode.ipynb>`_
    * -
      - `Vertical interpolation & binning <https://github.com/euroargodev/argopy-training/blob/main/content/argo-data-manipulation/vertical-interpolation-and-binning.ipynb>`_
    * -
      - `Compute (TEOS, Optic,Nutrients/Carbonates) <https://github.com/euroargodev/argopy-training/blob/main/content/argo-data-manipulation/compute.ipynb>`_
    * -
      - `Compute your own per-profile diagnostic <https://github.com/euroargodev/argopy-training/blob/main/content/argo-data-manipulation/compute-custom.ipynb>`_
    * - 🗃️ Argo index and meta-data
      - `Working with Argo index files <https://github.com/euroargodev/argopy-training/blob/main/content/argo-index-meta-data/working-with-argo-index.ipynb>`_
    * -
      - `Argo Reference tables lookup <https://github.com/euroargodev/argopy-training/blob/main/content/argo-index-meta-data/argo-reference-tables.ipynb>`_
    * -
      - `Deployment plan <https://github.com/euroargodev/argopy-training/blob/main/content/argo-index-meta-data/deployment-table.ipynb>`_
    * - 🧐 Quality control
      - `CTD data for core DMQC <https://github.com/euroargodev/argopy-training/blob/main/content/argo-data-dmqc/reference-dabase-shipCTD.ipynb>`_
    * - 🎯 Low-level tools
      - `Generic GDAC file system <https://github.com/euroargodev/argopy-training/blob/main/content/low-level-tools/GDAC-file-system.ipynb>`_
    * -
      - `web-API requests <https://github.com/euroargodev/argopy-training/blob/main/content/low-level-tools/web-API.ipynb>`_


Training sessions
-----------------

.. grid:: 1 1 2 2
    :gutter: 4

    .. grid-item-card:: LOV/IMEV
        :img-top: _static/Training_20260603.jpg

        Spring 2026

        **In person** training on Wednesday June 3rd 2026, room Tregouboff, `LOV/IMEV <https://lov.imev-mer.fr/web>`_ (14 participants).

    .. grid-item-card:: Local Brest community
        :img-top: _static/Training_20251125.jpg

        Fall 2025

        **In person** training: 4 sessions held on `2025/11/25 (7 participants) <https://bsky.app/profile/euro-argo.eu/post/3m6h4ud36mc2r>`_, 2025/11/27 (3 participants), 2025/12/9 (11 participants) and 2025/12/10 (10 participants).

    .. grid-item-card:: Euro-Argo Science Meeting #8
        :img-top: _static/Training_20250922.jpg

        Sept. 2025

        **In person** training as a side event of the `Euro-Argo Science Meeting <https://www.euro-argo.eu/News-Meetings/News/News-archives/2025/8th-Euro-Argo-Science-Meeting>`_. `(25 participants) <https://bsky.app/profile/euro-argo.eu/post/3lzlgsalewk2z>`_.

    .. grid-item-card:: JAMSTEC Headquarters
        :img-top: _static/Training_20250625.jpg

        June 2025

        **In person** training on Wednesday June 25th 10am, room 304, `JAMSTEC Headquarters <https://www.jamstec.go.jp/e/about/access/yokosuka.html>`_ `GOORC <https://www.jamstec.go.jp/goorc/e/>`_, Yokosuka, Japan. (~10 participants).

    .. grid-item-card:: Tohoku University
        :img-top: _static/Training_20250618.jpg

        June 2025

        **In person** training on Wednesday June 18th 10am, room 425, `Tohoku University <https://www.gp.tohoku.ac.jp/pol/index-e.html>`_ `WPI-AIMEC <https://wpi-aimec.jp/en/>`_, Sendai, Japan. `(~10 participants) <https://wpi-aimec.jp/en/activities/2369/>`_.