clouddrift.adapters.hurdat2

This module defines functions used to adapt the HURDAT2 cyclone track data as a ragged-array dataset.

Functions

to_raggedarray([basin, tmp_path, convert, ...])

Convert the HURDAT2 dataset to a RaggedArray instance.

Classes

DataLine(time, record_identifier, ...)
HeaderLine(id, basin, year, rowsize)
RecordIdentifier(value[, names, module, ...])	C – Closest approach to a coast, not followed by a landfall G – Genesis I – An intensity peak in terms of both pressure and wind L – Landfall (center of system crossing a coastline) P – Minimum in central pressure R – Provides additional detail on the intensity of the cyclone when rapid changes are underway S – Change of status of the system T – Provides additional detail on the track (position) of the cyclone W – Maximum sustained wind speed
SystemStatus(value[, names, module, ...])	TD – Tropical cyclone of tropical depression intensity (< 34 knots) TS – Tropical cyclone of tropical storm intensity (34-63 knots) HU – Tropical cyclone of hurricane intensity (> 64 knots) EX – Extratropical cyclone (of any intensity) SD – Subtropical cyclone of subtropical depression intensity (< 34 knots) SS – Subtropical cyclone of subtropical storm intensity (> 34 knots) LO – A low that is neither a tropical cyclone, a subtropical cyclone, nor an extratropical cyclone (of any intensity) WV – Tropical Wave (of any intensity) DB – Disturbance (of any intensity) ET - UNKNOWN found in Northeast Pacific Basin PT - UNKNOWN found in Northeast Pacific Basin ST - UNKNOWN found in Northeast Pacific Basin TY - UNKNOWN found in Northeast Pacific Basin
TrackData(header, data)

class clouddrift.adapters.hurdat2.DataLine(time: datetime.datetime, record_identifier: clouddrift.adapters.hurdat2.RecordIdentifier, system_status: clouddrift.adapters.hurdat2.SystemStatus, lat: float, lon: float, wind_speed: float, pressure: float, max_low_wind_radius_ne: float, max_low_wind_radius_se: float, max_low_wind_radius_sw: float, max_low_wind_radius_nw: float, max_med_wind_radius_ne: float, max_med_wind_radius_se: float, max_med_wind_radius_sw: float, max_med_wind_radius_nw: float, max_high_wind_radius_ne: float, max_high_wind_radius_se: float, max_high_wind_radius_sw: float, max_high_wind_radius_nw: float, max_sustained_wind_speed_radius: float)

class clouddrift.adapters.hurdat2.HeaderLine(id: str, basin: str, year: int, rowsize: int)

class clouddrift.adapters.hurdat2.RecordIdentifier(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

C – Closest approach to a coast, not followed by a landfall G – Genesis I – An intensity peak in terms of both pressure and wind L – Landfall (center of system crossing a coastline) P – Minimum in central pressure R – Provides additional detail on the intensity of the cyclone when rapid changes are underway S – Change of status of the system T – Provides additional detail on the track (position) of the cyclone W – Maximum sustained wind speed

class clouddrift.adapters.hurdat2.SystemStatus(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

TD – Tropical cyclone of tropical depression intensity (< 34 knots) TS – Tropical cyclone of tropical storm intensity (34-63 knots) HU – Tropical cyclone of hurricane intensity (> 64 knots) EX – Extratropical cyclone (of any intensity) SD – Subtropical cyclone of subtropical depression intensity (< 34 knots) SS – Subtropical cyclone of subtropical storm intensity (> 34 knots) LO – A low that is neither a tropical cyclone, a subtropical cyclone, nor an extratropical cyclone (of any intensity) WV – Tropical Wave (of any intensity) DB – Disturbance (of any intensity) ET - UNKNOWN found in Northeast Pacific Basin PT - UNKNOWN found in Northeast Pacific Basin ST - UNKNOWN found in Northeast Pacific Basin TY - UNKNOWN found in Northeast Pacific Basin

class clouddrift.adapters.hurdat2.TrackData(header: clouddrift.adapters.hurdat2.HeaderLine, data: list[clouddrift.adapters.hurdat2.DataLine])

clouddrift.adapters.hurdat2.to_raggedarray(basin: Literal['atlantic', 'pacific', 'both'] = 'both', tmp_path: str = '/tmp/clouddrift/hurdat2', convert: bool = True, skip_download: bool = False) → RaggedArray

Convert the HURDAT2 dataset to a RaggedArray instance.

Parameters

basinstr, optional

Basin selection: "atlantic", "pacific", or "both" (default).

tmp_pathstr, optional

Path where dataset files are cached.

convertbool, optional

If True, convert wind speed and pressure to SI units. Default is True.

skip_downloadbool, optional

If True, skip re-downloading files that already exist in tmp_path. Default is False.

Returns

RaggedArray

HURDAT2 dataset as a RaggedArray instance.