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>
Dimensions:                (traj: 27647, obs: 46535470)
Coordinates:
    ids                    (obs) int64 7702204 7702204 ... 300234061198840
    time                   (obs) float64 2.879e+08 2.879e+08 ... 1.697e+09
Dimensions without coordinates: traj, obs
Data variables: (12/50)
    ID                     (traj) int64 7702204 7702201 ... 300234061198840
    rowsize                (traj) int32 92 1747 1943 1385 1819 ... 54 53 51 28
    WMO                    (traj) int32 0 0 0 0 ... 6203890 6203888 4101885
    expno                  (traj) int32 40 40 40 40 ... 31412 21421 21421 31412
    deploy_date            (traj) float32 2.878e+08 2.878e+08 ... 1.696e+09 nan
    deploy_lat             (traj) float32 -7.798 -4.9 -3.18 ... 9.9 11.9 nan
    ...                     ...
    vn                     (obs) float32 nan 0.1056 0.04974 ... 0.7384 nan
    temp                   (obs) float32 28.35 28.3 nan ... 29.08 28.97 28.92
    err_lat                (obs) float32 0.009737 0.007097 ... 0.001659 0.001687
    err_lon                (obs) float32 0.00614 0.004583 ... 0.002471 0.002545
    err_temp               (obs) float32 0.08666 0.08757 ... 0.03665 0.03665
    drogue_status          (obs) bool False False False False ... True True True
Attributes: (12/18)
    title:                Global Drifter Program drifting buoy collection
    history:              version September 2023. Metadata from dirall.dat an...
    Conventions:          CF-1.6
    time_coverage_start:  1979-02-15:00:00:00Z
    time_coverage_end:    2023-10-18:18:00:00Z
    date_created:         2023-12-22T17:50:22.242943
    ...                   ...
    contributor_name:     NOAA Global Drifter Program
    contributor_role:     Data Acquisition Center
    institution:          NOAA Atlantic Oceanographic and Meteorological Labo...
    acknowledgement:      Lumpkin, Rick; Centurioni, Luca (2019). NOAA Global...
    summary:              Global Drifter Program six-hourly data
    doi:                  10.25921/7ntx-z961

See Also#

gdp1h()