clouddrift.adapters.quicche

clouddrift.adapters.quicche#

This module defines functions used to adapt the QUICCHE CARTHE dataset as a ragged-arrays dataset.

The dataset contains CARTHE surface drifter trajectories from the Cape Basin (South Atlantic) in March 2023. The data is hosted at Zenodo in record 14902851.

Example#

>>> from clouddrift.adapters import quicche
>>> ra = quicche.to_raggedarray()
>>> ra = quicche.to_raggedarray(version="qc1")
>>> ra = quicche.to_raggedarray(version="raw")

Reference#

Zenodo record 14902851: CARTHE surface drifter trajectories, Cape Basin, South Atlantic, March 2023.

Functions

to_raggedarray([version, tmp_path, ...])

Parse and convert QUICCHE CARTHE drifter data to a RaggedArray instance.
clouddrift.adapters.quicche.to_raggedarray(version: Literal['raw', 'qc1', 'qc2', 'qc3'] = 'qc3', tmp_path: str | None = None, skip_download: bool = False) → RaggedArray[source]#

Parse and convert QUICCHE CARTHE drifter data to a RaggedArray instance.

Parameters#

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

Which quality control level to return. “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”.

tmp_pathstr, optional

Temporary path where intermediary files are stored. If None, uses the default temp path defined in this module.

skip_downloadbool, optional

If True, skip re-downloading the ZIP file if it already exists in tmp_path. Default is False.

Returns#

RaggedArray

QUICCHE CARTHE drifter trajectories as a ragged array with dimensions (traj, obs) and coordinates (id, time).