Main Content

deleteTrack

Delete existing track

Since R2021a

    Description

    example

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

    Examples

    collapse all

    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: [1x1 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: [6x1 double]
                 StateCovariance: [6x6 double]
                 StateParameters: [1x1 struct]
                   ObjectClassID: 0
        ObjectClassProbabilities: 1
                      TrackLogic: 'History'
                 TrackLogicState: [1 1 0 0 0]
                     IsConfirmed: 1
                       IsCoasted: 0
                  IsSelfReported: 1
                ObjectAttributes: [1x1 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

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

    Version History

    Introduced in R2021a