clouddrift.datasets.quicche

Contents

clouddrift.datasets.quicche#

clouddrift.datasets.quicche(version: Literal['raw', 'qc1', 'qc2', 'qc3'] = 'qc3', decode_times: bool = True) → Dataset[source]#

Returns the QUICCHE CARTHE surface drifter trajectories as a ragged array Xarray dataset.

The function will first look for the ragged-array dataset on the local filesystem. If it is not found, the dataset will be downloaded using the corresponding adapter function and stored for later access.

The upstream data is available at https://zenodo.org/records/14902851.

Parameters#

versionLiteral[“raw”, “qc1”, “qc2”, “qc3”], optional

Specify the version to retrieve. “raw” = original raw messages, “qc1” = raw data with pre-deployment GPS tests flagged, “qc2” = bad records removed, “qc3” = QC2 interpolated on a regular 30 minute time grid. Default is “qc3”.

decode_timesbool, optional

If True, decode the time coordinate into a datetime object. If False, the time coordinate will be an int64 or float64 array of increments since the origin time indicated in the units attribute. Default is True.

Returns#

xarray.Dataset

QUICCHE CARTHE drifter trajectories as a ragged array

Examples#

>>> from clouddrift.datasets import quicche
>>> ds = quicche()
>>> ds
<xarray.Dataset>
Dimensions:    (traj: ..., obs: ...)
Coordinates:
    id         (traj) object ...
    time       (obs) datetime64[ns] ...
Dimensions without coordinates: traj, obs
Data variables:
    latitude   (obs) float32 ...
    longitude  (obs) float32 ...
    rowsize    (traj) int64 ...
Attributes:
    title:           QUICCHE CARTHE Surface Drifter Trajectories (QC3)
    summary:         CARTHE surface drifter trajectories from the Cape Basin...
    date_created:    2026-04-17T...
    publisher_name:  Zenodo
    publisher_url:   https://zenodo.org/records/14902851

To retrieve RAW or QC1 data instead:

>>> ds = quicche(version="raw")
>>> ds = quicche(version="qc1")

Reference#

Novelli, G., & Beal, L. (2025). POSITION - GEOGRAPHIC collected from CARTHE surface drifter in South Atlantic Ocean from 20230306 to 20230727 (NCEI Accession 0301712). (Version 1) [Data set]. National Centers for Environmental Information. https://doi.org/10.25921/9m27-m532

Contents