confirmTrack

Confirm tentative track

Since R2022b

Syntax

confirmed = confirmTrack(tracker,trackID)

Description

confirmed = confirmTrack(tracker,trackID) confirms a tentative track with the specified track ID in the tracker.

Examples

Confirm Track

Create a multiObjectTracker System object.

tracker = multiObjectTracker;

Create one objectDetection object and use it to update the tracker.

detection1 = objectDetection(0,[1;1;1]);
[cofirmedTracks,tentativeTracks]=tracker(detection1,0)

cofirmedTracks = 

  0×1 objectTrack array with properties:

    TrackID
    BranchID
    SourceIndex
    UpdateTime
    Age
    State
    StateCovariance
    StateParameters
    ObjectClassID
    ObjectClassProbabilities
    TrackLogic
    TrackLogicState
    IsConfirmed
    IsCoasted
    IsSelfReported
    ObjectAttributes

tentativeTracks = 
  objectTrack with properties:

                     TrackID: 1
                    BranchID: 0
                 SourceIndex: 0
                  UpdateTime: 0
                         Age: 1
                       State: [6×1 double]
             StateCovariance: [6×6 double]
             StateParameters: [1×1 struct]
               ObjectClassID: 0
    ObjectClassProbabilities: 1
                  TrackLogic: 'History'
             TrackLogicState: [1 0 0 0 0]
                 IsConfirmed: 0
                   IsCoasted: 0
              IsSelfReported: 1
            ObjectAttributes: [1×1 struct]

From the results, the tracker does not maintain any confirmed tracks and only maintains one tentative track.

Confirm the tentative track using the confirmTrack object function.

confirmed = confirmTrack(tracker,1)

confirmed = logical
   1

Input Arguments

tracker — Multi-object tracker

multiObjectTracker System object™

Multi-object tracker, specified as a multiObjectTracker System object.

trackID — Track identifier

positive integer

Track identifier, specified as a positive integer.

Example: 21

Output Arguments

confirmed — Indicate if track is successfully confirmed

true or logical 1 | false or logical 0

Indicate if the track is successfully confirmed, returned as a logical 1 (true) or 0 (false). If the tentative track specified by the trackID input exists, the function confirms the track and returns 1. If the tentative track does not exist, the function issues a warning and returns 0.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Version History

Introduced in R2022b