CustomTarget

Custom target specification

Since R2025a

Description

A CustomTarget object contains a custom target specification. You can modify this specification by defining its state transition model and survival model. Use this object as an input to the multiSensorTargetTracker function. The state transition model defines the state convention for trackers initialized with it.

Creation

To create a CustomTarget object, use the trackerTargetSpec function with the input argument "custom". For example:

spec = trackerTargetSpec("custom")

Properties

StateTransitionModel — State transition model for target

target state transition model object

State transition model for the target, specified as a target state transition model object. You can use the targetStateTransitionModel function to generate the object. This property defines how the target status changes over time and transitions between states. It also determines the state convention for trackers initialized with it.

State Transition Model	State Convention (1D)	State Convention (2D)	State Convention (3D)
ConstantVelocityModel	[x;vx]	[x;vx;y;vy]	[x;vx;y;vy;z;vz]
ConstantAccelerationModel	[x;vx;ax]	[x;vx;ax;y;vy;ay]	[x;vx;ax;y;vy;ay;z;vz;az]
ConstantTurnRateModel	N/A	[x;vx;y;vy;omega]	[x;vx;y;vy;omega;z;vz]
SingerAccelerationModel	[x;vx;ax]	[x;vx;ax;y;vy;ay]	[x;vx;ax;y;vy;ay;z;vz;az]
InteractingMultipleModel	The same as the state convention of the first motion model that the InteractingMultipleModel object is defined with.

• x, y, and z represent the x-, y-, and z-coordinates in meters.

• vx, vy, and vz represent the velocity components in different directions in meters per second.

• omega represents the turn-rate in degrees per second.

SurvivalModel — Survival model for target

target survival model object

Survival model for the target, specified as a target survival model object. You can use the targetSurvivalModel function to generate the object. The model defines the probability of target survival over time.

Object Functions

hasTrackerInput

Determine whether tracker needs additional input for target specification

Examples

Create and Configure Specification for Marine Targets Using CustomTarget Specification

Create a specification for marine targets.

marineSpec = trackerTargetSpec("custom")

marineSpec = 
  CustomTarget with properties:

    StateTransitionModel: []
           SurvivalModel: []

Define the state transition and survival model of the marine target specification. The targets of interest mostly follow a constant velocity motion. They also have a uniform survival rate survival model, which assumes a constant probability that a target survives from one time step to the next.

tstModel = targetStateTransitionModel('constant-velocity');
tstModel.VelocityMean = zeros(3,1);
tstModel.VelocityVariance = 100/3*eye(3);
tstModel.AccelerationVariance = 5*eye(3);

tsurvModel = targetSurvivalModel('uniform-survival-rate');

Configure the marine target specification using the state transition model and the survival model.

marineSpec.StateTransitionModel = tstModel;
marineSpec.SurvivalModel = tsurvModel;

Version History

Introduced in R2025a