shoot.eddies.track.Associate

shoot.eddies.track.Associate#

class shoot.eddies.track.Associate(track_eddies, parent_eddies, new_eddies, Dt, Tc, C=0.07523148148148148)[source]#

Associate eddies between time steps for tracking

Uses the Chelton et al. (2011) tracking algorithm with cost function based on distance, Rossby number, and radius similarity.

Parameters:
  • track_eddies (list) – List of Track objects containing eddy trajectories.

  • parent_eddies (list) – Eddies from the previous time step.

  • new_eddies (list) – Eddies from the current time step to associate.

  • Dt (float) – Time step (days) between parent and new eddies.

  • Tc (float) – Characteristic time scale for tracking.

  • C (float, default 6.5*1e3/86400) – Characteristic velocity scale (m/s).

cost#

Cost matrix for eddy association (cached property).

Type:

ndarray

__init__(track_eddies, parent_eddies, new_eddies, Dt, Tc, C=0.07523148148148148)[source]#

Initialize eddy tracking association

Parameters:
  • track_eddies (list) – List of Track objects containing eddy trajectories.

  • parent_eddies (list) – Eddies from the previous time step.

  • new_eddies (list) – Eddies from the current time step to associate.

  • Dt (float) – Time step (days) between parent and new eddies.

  • Tc (float) – Characteristic time scale for tracking.

  • C (float, default 6.5*1e3/86400) – Characteristic velocity scale (m/s).

Methods

order()

rad_avg(eddyj)

Average radius over last 5 time steps

ro_avg(eddyj)

Average Rossby number over last 5 time steps

search_dist(eddyj, eddyi)

Compute search distance for eddy association

Attributes

cost

Cost function between each eddy pair