5.3.4.133. Function tracking_perform

5.3.4.133.1. Function Documentation

void tracking_perform(tracking_data_t *tracking_data, const RoIs_t *RoIs, size_t frame, const motion_t *motion_est, const size_t r_extrapol, const float angle_max, const float diff_dev, const int track_all, const size_t fra_star_min, const size_t fra_meteor_min, const size_t fra_meteor_max, const uint8_t save_RoIs_id, const uint8_t extrapol_order_max, const float min_extrapol_ratio_S, const float min_ellipse_ratio, const uint8_t enable_angle, const uint8_t enable_direction)

Create, update and finalize tracks. This function also performs the classification of the tracks.

Parameters

  • tracking_data – Inner data.

  • RoIs – RoIs features (at \(t\)).

  • frame – Current frame number.

  • motion_est – Motion estimation at \(t\).

  • r_extrapol – Accepted range for extrapolation.

  • angle_max – Maximum angle that the 3 last positions of a same track can form (if the angle is higher than angle_max then the track is classified as noise).

  • diff_dev – Multiplication factor in the motion detection criterion. Motion criterion is: \( |e_k - \bar{e_t}| > \texttt{diff\_dev} * \sigma_t, \) where \(e_k\) is the compensation error of the CC/RoI number \(k\), \(\bar{e_t}\) the average error of compensation of all CCs of image \(I_t\), and \(\sigma_t\) the standard deviation of the error.

  • track_all – Boolean that defines if the tracking should track other objects than only meteors.

  • fra_star_min – Minimum number of CC/RoI associations before creating a star track.

  • fra_meteor_min – Minimum number of CC/RoI associations before creating a meteor track.

  • fra_meteor_max – Maximum number of CC/RoI associations after which a meteor track is transformed in a noise track.

  • save_RoIs_id – Boolean to save the list of the RoI ids for each tracks.

  • extrapol_order_max – Maximum number of frames where a lost track is extrapolated (0 means no extrapolation).

  • min_extrapol_ratio_S – Minimum ratio between two RoIs. \( r_S = RoI_{S}^j / RoI_{S}^i\), if \(r_S < r_S^{min}\) then the association for the extrapolation is not made.

  • min_ellipse_ratio – Minimum ellipse ratio of a meteor (for classification). If 0 then this parameter is ignored. RoIs->misc->a and RoIs->misc->b can’t be NULL.

  • enable_angle – Enable to use the angle criterion to classify meteor objects as noise if the angle is too big.

  • enable_direction – Enable to use the direction criterion to classify meteor objects as noise if the direction changes.