Track objects
Track objects between frames.
Description
Track objects between frames. Tracks are produced as separate "parent" objects to the "child" spots. Track objects only serve to link different timepoint instances of objects together. As such, track objects store no coordinate information.
Uses the TrackMate implementation of the Jaqaman linear assignment problem solving algorithm (Jaqaman, et al., Nature Methods, 2008). The implementation utilises sparse matrices for calculating costs in order to minimise memory overhead.
Note: Leading point determination currently only works in 2D
Parameters
| Parameter | Description |
|---|---|
| Input objects | Objects present in individual timepoints which will be tracked across multiple frames. These objects will become children of their assigned "track" parent. |
| Output track objects | Output track objects to be stored in the workspace. These objects will contain no spatial information, rather they act as (parent) linking objects for the individual timepoint instances of the tracked object. |
| Linking method | The spatial cost for linking objects together:
|
| Minimum overlap | If "Linking method" is set to "Absolute overlap", this is the minimum absolute spatial overlap (number of coincident pixels/voxels) two objects must have for them to be considered as candidates for linking. |
| Maximum linking distance (px) | If "Linking method" is set to "Centroid", this is the minimum spatial separation (pixel units) two objects must have for them to be considered as candidates for linking. |
| Maximum number of missing frames | Maximum number of missing frames for an object to still be tracked. A single object undetected for longer than this would be identified as two separate tracks. |
| Frame gap weighting | When non-zero, an additional cost will be included that penalises linking objects with large temporal separations. The frame gap between candidate objects will be multiplied by this weight. For example, if calculating spatial costs using centroid spatial separation, a frame gap weight of 1 will equally weight 1 frame of temporal separation to 1 pixel of spatial separation. The larger the weight, the more this frame gap will contribute towards the total linking cost. |
| Favour established tracks | When selected, points will be preferentially linked to tracks containing more previous points. For example, in cases where an object was detected twice in one timepoint this will favour linking to the original track, rather than establishing the on-going track from the new point. |
| Track length weighting | If "Favour established tracks" is selected this is the weight assigned to the existing track duration. Track duration costs are calculated as 1 minus the ratio of frames in which the track was detected (up to the previous time-point). |
| Use volume (minimise volume change) | When enabled, the 3D volume of the objects being linked will contribute towards linking costs. |
| Volume weighting | If "Use volume (minimise volume change)" is enabled, this is the weight assigned to the difference in volume of the candidate objects for linking. The difference in volume between candidate objects is multiplied by this weight. The larger the weight, the more this difference in volume will contribute towards the total linking cost. |
| Maximum volume change (px^3) | If "Use volume (minimise volume change)" is enabled, the maximum difference in volume between candidate objects can be specified. This maximum volume change is specified in pixel units. |
| Direction weighting mode | Controls whether cost terms will be included based on the direction a tracked object is moving in:
|
| Orientation range mode | |
| Preferred direction | If "Direction weighting mode" is set to "Absolute orientation 2D", this is the preferred direction that a track should be moving in. Orientation is measured in degree units and is positive above the x-axis and negative below it. |
| Direction tolerance | If using directional weighting ("Direction weighting mode" not set to "None"), this is the maximum deviation in direction from the preferred direction that a candidate object can have. For absolute linking, this is relative to the preferred direction and for relative linking, this is relative to the previous frame. |
| Direction weighting | If using directional weighting ("Direction weighting mode" not set to "None"), the angular difference (in degrees) between the candidate track direction and the reference direction will be muliplied by this weight. The larger the weight, the more this angular difference will contribute towards the total linking cost. |
| Use measurement (minimise change) | When selected, an additional cost can be included based on a measurement assigned to each object. This allows for tracking to favour minimising variation in this measurement. |
| Measurement | If "Use measurement (minimise change)" is selected, this is the measurement (associated with the input objects) for which variation within a track will be minimised. |
| Measurement weighting | If "Use measurement (minimise change)" is selected, the difference in measurement associated with a candidate object and the previous instance in a target track will be multiplied by this value. The larger the weight, the more this difference in measurement will contribute towards the total linking cost. |
| Maximum measurement change | If "Use measurement (minimise change)" is selected, this is the maximum amount the measurement can change between consecutive instances in a track. Variations greater than this will result in the track being split into two. |