TrackDataset.analogs_from_point

TrackDataset.analogs_from_point(point, radius, units='km', thresh={}, non_tropical=False, year_range=None, date_range=None)[source]

Retrieve historical TC tracks surrounding a point.

Parameters

  • point (tuple) – Tuple ordered by (latitude, longitude).

  • radius (int or float) – Radius in kilometers surrounding the point to search for storms.

  • units (str, optional) – Units of distance for radius. Can be “miles” or “km”. Default is “km”.

  • thresh (dict) –

    Dict for threshold(s) that storms within the requested radius must meet. The following options are available:

    • v_min - Search for sustained wind (kt) above this threshold

    • v_max - Search for sustained wind (kt) below this threshold

    • p_min - Search for MSLP (hPa) below this threshold

    • p_max - Search for MSLP (hPa) above this threshold

  • non_tropical (bool) – If True, non-tropical (e.g., tropical disturbance, extra-tropical cyclone) points are included in the search. Default is False.

  • year_range (tuple) – Year range over which to search. If None, defaults to entire dataset.

  • date_range (tuple) – Start and end dates, formatted as a “month/day” string. If None, defaults to year round.

Returns

dict – Dict of tropical cyclones that meet the criteria, with storm ID as the key and its closest distance to point as the value.

Notes

This function automatically interpolates all storm data within this TrackDataset instance to hourly, if this hasn’t already been done previously.