clouddrift.datasets.gdp6h

Contents

clouddrift.datasets.gdp6h#

clouddrift.datasets.gdp6h(decode_times: bool = True) Dataset[source]#

Returns the NOAA Global Drifter Program (GDP) 6-hourly dataset as a ragged array Xarray dataset.

The data is accessed from a public HTTPS server at NOAA’s Atlantic Oceanographic and Meteorological Laboratory (AOML) accessible at https://www.aoml.noaa.gov/phod/gdp/index.php. It should be noted that the data loading method is platform dependent. Linux and Darwin (macOS) machines lazy load the datasets leveraging the byte-range feature of the netCDF-c library (dataset loading engine used by xarray). Windows machines download the entire dataset into a memory buffer which is then passed to xarray.

Parameters#

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

6-hourly GDP dataset as a ragged array

Examples#

>>> from clouddrift.datasets import gdp6h
>>> ds = gdp6h()
>>> ds
<xarray.Dataset> Size: 2GB
Dimensions:                (traj: 27647, obs: 46535470)
Coordinates:
id                     (traj) int64 221kB ...
time                   (obs) datetime64[ns] 372MB ...
Dimensions without coordinates: traj, obs
Data variables: (12/49)
BuoyTypeManufacturer   (traj) |S20 553kB ...
BuoyTypeSensorArray    (traj) |S20 553kB ...
CurrentProgram         (traj) float64 221kB ...
DeployingCountry       (traj) |S20 553kB ...
DeployingShip          (traj) |S20 553kB ...
DeploymentComments     (traj) |S20 553kB ...
...                     ...
start_lon              (traj) float32 111kB ...
temp                   (obs) float32 186MB ...
typebuoy               (traj) |S10 276kB ...
typedeath              (traj) int8 28kB ...
ve                     (obs) float32 186MB ...
vn                     (obs) float32 186MB ...
Attributes: (12/18)
Conventions:          CF-1.6
acknowledgement:      Lumpkin, Rick; Centurioni, Luca (2019). NOAA Global...
contributor_name:     NOAA Global Drifter Program
contributor_role:     Data Acquisition Center
date_created:         2024-04-04T13:44:01.176967
doi:                  10.25921/7ntx-z961
...                   ...
publisher_name:       GDP Drifter DAC
publisher_url:        https://www.aoml.noaa.gov/phod/gdp
summary:              Global Drifter Program six-hourly data
time_coverage_end:    2023-10-18:18:00:00Z
time_coverage_start:  1979-02-15:00:00:00Z
title:                Global Drifter Program drifting buoy collection

See Also#

gdp1h()