deleteTrack

Delete existing track

Since R2021a

collapse all in page

    Syntax

    deleted = deleteTrack(tracker,trackID)

    Description

    deleted = deleteTrack(tracker,trackID) deletes the track specified by trackID in the tracker.

    example

    Examples

    collapse all

    Open Live Script

    Create a track using detections in a radarTracker.

    tracker = radarTracker 
    tracker = 
  radarTracker with properties:

                  TrackerIndex: 0
       FilterInitializationFcn: 'initcvekf'
           AssignmentThreshold: [30 Inf]
                  MaxNumTracks: 100
              MaxNumDetections: Inf
                 MaxNumSensors: 20

                  OOSMHandling: 'Terminate'

         ConfirmationThreshold: [2 3]
             DeletionThreshold: [5 5]

            HasCostMatrixInput: false
    HasDetectableTrackIDsInput: false
               StateParameters: [1×1 struct]

                     NumTracks: 0
            NumConfirmedTracks: 0


    detection1 = objectDetection(0,[1;1;1]);
detection2 = objectDetection(1,[1.1;1.2;1.1]);
tracker(detection1,0);
tracker(detection2,1)
    ans = 
  objectTrack with properties:

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

    Delete the first track.

    deleted1 = deleteTrack(tracker,1)
    deleted1 = logical
   1

    Uncomment the following to delete a nonexistent track. A warning will be issued.

    % deleted2 = deleteTrack(tracker,2)

    Input Arguments

    collapse all

    Radar tracker, specified as a radarTracker object.

    Track identifier, specified as a positive integer.

    Example: 21

    Output Arguments

    collapse all

    Indicate if the track was successfully deleted or not, returned as 1 or 0. If the track specified by the trackID input existed and was successfully deleted, it returns as 1. If the track did not exist, a warning is issued and it returns as 0.

    Extended Capabilities

    expand all

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

    Version History

    Introduced in R2021a

    See Also

    |