TrackDataset.filter_storms

TrackDataset.filter_storms(storm=None, year_range=None, date_range=None, thresh={}, domain=None, interpolate_data=False, return_keys=True)[source]

Filters all storms by various thresholds.

Parameters
  • storm (list or str) – Single storm ID or list of storm IDs (e.g., 'AL012022', ['AL012022','AL022022']) to search through. If None, defaults to searching through the entire dataset.

  • year_range (list or tuple) – List or tuple representing the start and end years (e.g., (1950,2018)). Default is start and end years of dataset.

  • date_range (list or tuple) – List or tuple representing the start and end dates as a string in ‘month/day’ format (e.g., ('6/1','8/15')). Default is ('1/1','12/31') or full year.

  • thresh (dict) –

    Keywords include:

    • sample_min - minimum number of storms in a grid box for “request” to be applied. For the functions ‘percentile’ and ‘average’, ‘sample_min’ defaults to 5 and will override any value less than 5.

    • v_min - minimum wind for a given point to be included in “request”.

    • p_max - maximum pressure for a given point to be included in “request”.

    • dv_min - minimum change in wind over dt_window for a given point to be included in “request”.

    • dp_max - maximum change in pressure over dt_window for a given point to be included in “request”.

    • dt_window - time window over which change variables are calculated (hours). Default is 24.

    • dt_align - alignment of dt_window for change variables – ‘start’,’middle’,’end’ – e.g. ‘end’ for dt_window=24 associates a TC point with change over the past 24 hours. Default is middle.

    Units of all wind variables = kt, and pressure variables = hPa. These are added to the subtitle.

  • domain (str) – Geographic domain. Default is entire basin. Please refer to Map Domain Options for available domain options.

  • interpolate_data (bool) – Whether to interpolate track data to hourly. Default is False.

  • return_keys (bool) – If True, returns a list of storm IDs that match the specified criteria. Otherwise returns a pandas.DataFrame object with all matching data points. Default is True.

Returns

list or pandas.DataFrame – Check return_keys for more information.