GDAC snapshot DOI

GDAC snapshot DOI#

The Argo Data Management Team maintain an exemplary DOI system to support science reproducibility and FAIRness. On a monthly basis, the ADMT zip the entire Argo GDAC, archive it and assign it a specific DOI.

There is a major DOI 10.17882/42182 and each monthly snapshot has a minor DOI, with a hashtag.

argopy provides the ArgoDOI class to help you access, search and retrieve a DOI for Argo.

DOI discovery#

If you don’t know where to start, just load the major Argo DOI record, it will point toward the latest snapshots and list the most recent associated files:

In [1]: from argopy import ArgoDOI

In [2]: doi = ArgoDOI()

In [3]: doi
Out[3]: 
<argopy.DOI>
DOI: 10.17882/42182
Title: Argo float data and metadata from Global Data Assembly Centre (Argo GDAC)
Date: 2026-06-08
Network: core+BGC+deep
Link: https://dx.doi.org/10.17882/42182
File: 201 files in total
Files for core+BGC+deep:
     - #131306 Global GDAC Argo data files (2026-06-08 snapshot) https://www.seanoe.org/data/00311/42182/data/131306.tar.gz (83.1GiB, openAccess=True)
     - #128558 Global GDAC Argo data files (2026-05-12 snapshot) https://www.seanoe.org/data/00311/42182/data/128558.tar.gz (82.3GiB, openAccess=True)
     - #127853 Global GDAC Argo data files (2026-04-08 snapshot) https://www.seanoe.org/data/00311/42182/data/127853.tar.gz (81.2GiB, openAccess=True)
     - #126945 Global GDAC Argo data files (2026-03-08 snapshot) https://www.seanoe.org/data/00311/42182/data/126945.tar.gz (79.9GiB, openAccess=True)
     - #126151 Global GDAC Argo data files (2026-02-08 snapshot) https://www.seanoe.org/data/00311/42182/data/126151.tar.gz (78.9GiB, openAccess=True)
     - #125185 Global GDAC Argo data files (2026-01-08 snapshot) https://www.seanoe.org/data/00311/42182/data/125185.tar.gz (78.1GiB, openAccess=True)
     - #124450 Global GDAC Argo data files (2025-12-08 snapshot) https://www.seanoe.org/data/00311/42182/data/124450.tar.gz (76.0GiB, openAccess=True)
     - #123471 Global GDAC Argo data files (2025-11-08 snapshot) https://www.seanoe.org/data/00311/42182/data/123471.tar.gz (74.8GiB, openAccess=True)
     - #122846 Global GDAC Argo data files (2025-10-08 snapshot) https://www.seanoe.org/data/00311/42182/data/122846.tar.gz (73.9GiB, openAccess=True)
     - #121877 Global GDAC Argo data files (2025-09-08 snapshot) https://www.seanoe.org/data/00311/42182/data/121877.tar.gz (73.1GiB, openAccess=True)
Files for BGC only:
     - #131305 BGC Sprof data files (2026-06-08 snapshot) https://www.seanoe.org/data/00311/42182/data/131305.tar.gz (5.7GiB, openAccess=True)
     - #128554 BGC Sprof data files (2026-05-08 snapshot) https://www.seanoe.org/data/00311/42182/data/128554.tar.gz (5.6GiB, openAccess=True)
     - #127852 BGC Sprof data files (2026-04-08 snapshot) https://www.seanoe.org/data/00311/42182/data/127852.tar.gz (5.6GiB, openAccess=True)
     - #126921 BGC Sprof data files (2026-03-08 snapshot) https://www.seanoe.org/data/00311/42182/data/126921.tar.gz (5.5GiB, openAccess=True)
     - #126150 BGC Sprof data files (2026-02-08 snapshot) https://www.seanoe.org/data/00311/42182/data/126150.tar.gz (5.4GiB, openAccess=True)
     - #125184 BGC Sprof data files (2026-01-08 snapshot) https://www.seanoe.org/data/00311/42182/data/125184.tar.gz (5.3GiB, openAccess=True)
     - #124468 BGC Sprof data files (2025-12-08 snapshot) https://www.seanoe.org/data/00311/42182/data/124468.tar.gz (5.1GiB, openAccess=True)
     - #123470 BGC Sprof data files (2025-11-08 snapshot) https://www.seanoe.org/data/00311/42182/data/123470.tar.gz (5.1GiB, openAccess=True)
     - #122845 BGC Sprof data files (2025-10-08 snapshot) https://www.seanoe.org/data/00311/42182/data/122845.tar.gz (4.9GiB, openAccess=True)
     - #121885 BGC Sprof data files (2025-09-08 snapshot) https://www.seanoe.org/data/00311/42182/data/121885.tar.gz (4.8GiB, openAccess=True)

A typical use case will be for users to access the data on a specific date and then to conduct their analysis. At the time of writing a report or research publication, it is not trivial to get the most appropriate DOI for the dataset analysed. In this case, the ArgoDOI will get handy with its search method that will return the closest Argo DOI to a given date:

In [4]: doi.search('2020-02')
Out[4]: 
<argopy.DOI.record>
DOI: 10.17882/42182#70590
Title: Argo float data and metadata from Global Data Assembly Centre (Argo GDAC) - Snapshot of Argo GDAC of February 10st 2020
Date: 2020-02-10
Network: core+BGC+deep
Link: https://dx.doi.org/10.17882/42182#70590
File: https://www.seanoe.org/data/00311/42182/data/70590.tar.gz (34.4GiB, openAccess=True)

You can also specify the BGC network in order to select DOI with synthetic profiles only:

In [5]: doi.search('2020-02', network='BGC')
Out[5]: 
<argopy.DOI.record>
DOI: 10.17882/42182#95141
Title: Argo float data and metadata from Global Data Assembly Centre (Argo GDAC) - Snapshot of BGC Sprof data files of July 28st 2022
Date: 2022-07-28
Network: BGC
Link: https://dx.doi.org/10.17882/42182#95141
File: https://www.seanoe.org/data/00311/42182/data/95141.tgz (3.0GiB, openAccess=True)

DOI data#

Once you have identified a specific hashtag for you snapshot of interest, you can point directly to it:

In [6]: doi = ArgoDOI('109847')

In [7]: doi
Out[7]: 
<argopy.DOI>
DOI: 10.17882/42182#109847
Title: Argo float data and metadata from Global Data Assembly Centre (Argo GDAC) - Snapshot of BGC Sprof data files of April 09st 2024
Date: 2024-04-09
Network: BGC
Link: https://dx.doi.org/10.17882/42182#109847
File: https://www.seanoe.org/data/00311/42182/data/109847.tar.gz (3.9GiB, openAccess=True)

The later doi object holds attributes such as dx and file.

You can also trigger the tar.gz archive download with the ArgoDOI.download method.

GDAC snapshot DOI

Contents

GDAC snapshot DOI#

DOI discovery#

DOI data#