clouddrift.adapters.gdp.gdp1h.download

Contents

clouddrift.adapters.gdp.gdp1h.download#

clouddrift.adapters.gdp.gdp1h.download(url: str = 'https://www.aoml.noaa.gov/ftp/pub/phod/buoydata/hourly_product/v2.01', tmp_path: str = '/tmp/clouddrift/gdp', drifter_ids: list[int] | None = None, n_random_id: int | None = None, skip_download: bool = False)[source]#

Download individual NetCDF files from the AOML server.

Parameters#

urlstr

URL from which to download the data.

tmp_pathstr

Path to the directory where the individual NetCDF files are stored.

drifter_idslist, optional

List of drifter to retrieve (Default: all)

n_random_idint, optional

Randomly select n_random_id drifter IDs to download (Default: None)

skip_downloadbool, optional

If True, make no network requests: discover drifter IDs by scanning tmp_path for existing drifter_hourly_*.nc files (when drifter_ids is None) and use locally cached dirfl_*.dat metadata files. Default is False.

Returns#

outlist

List of retrieved drifters

Raises#

ValueError

If no matching drifter files are found for the requested selection.

Contents