Main Content

trackPlotter

Create track plotter

Description

tPlotter = trackPlotter(tp) creates a track plotter for use with the theater plot tp.

example

tPlotter = trackPlotter(tp,Name,Value) creates a track plotter with additional options specified by one or more Name,Value pair arguments.

Examples

collapse all

Create a theater plot. Create a track plotter with DisplayName set to 'Tracks' and with HistoryDepth set to 5.

tp = theaterPlot('XLim',[0,90],'YLim',[-35,35]);
tPlotter = trackPlotter(tp,'DisplayName','Tracks','HistoryDepth',5);

Update the track plotter with three tracks labeled 'T1', 'T2', and 'T3' with start positions in units of meters all starting at (30, 5, 1) with corresponding velocities (in m/s) of (3, 0, 1), (3, 2, 2) and (3, -3, 5), respectively. Update the tracks with the velocities for ten iterations.

positions = [30, 5, 1; 30, 5, 1; 30, 5, 1];
velocities = [3, 0, 1; 3, 2, 2; 3, -3, 5];
labels = {'T1','T2','T3'};
for i=1:10
    plotTrack(tPlotter, positions, velocities, labels)
    positions = positions + velocities;
end

This animation loops through all the generated plots.

Input Arguments

collapse all

Theater plot, specified as a theaterPlot object.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'MarkerSize',10

Plot name to display in legend, specified as the comma-separated pair consisting of 'DisplayName' and a character vector or string scalar. If no name is specified, no entry is shown.

Example: 'DisplayName','Radar Detections'

Number of previous track updates to display, specified as the comma-separated pair consisting of 'HistoryDepth' and a nonnegative integer less than or equal to 10,000. If set to 0, then no previous updates are rendered.

Connect tracks flag, specified as either 'on' or 'off'. When set to 'on', tracks with the same label or track identifier between consecutive updates are connected with a line. This property can only be specified when creating the trackPlotter. The default is 'off'.

To use the trackIDs input argument of plotTrack, 'ConnectHistory' must be 'on'. If trackIDs is omitted when 'ConnectHistory' is 'on', then the track identifiers are derived from the labels input instead.

Colorize track history, specified as either 'on' or 'off'. When set to 'on', tracks with the same label or track identifier between consecutive updates are connected with a line of a different color. This property can only be specified when creating the trackPlotter.The default is 'off'.

ColorizedHistory is applicable only when ConnectHistory is 'on'.

Marker symbol, specified as the comma-separated pair consisting of 'Marker' and one of these symbols.

MarkerDescriptionResulting Marker
"o"Circle

Sample of circle marker

"+"Plus sign

Sample of plus sign marker

"*"Asterisk

Sample of asterisk marker

"."Point

Sample of point marker

"x"Cross

Sample of cross marker

"_"Horizontal line

Sample of horizontal line marker

"|"Vertical line

Sample of vertical line marker

"square"Square

Sample of square marker

"diamond"Diamond

Sample of diamond marker

"^"Upward-pointing triangle

Sample of upward-pointing triangle marker

"v"Downward-pointing triangle

Sample of downward-pointing triangle marker

">"Right-pointing triangle

Sample of right-pointing triangle marker

"<"Left-pointing triangle

Sample of left-pointing triangle marker

"pentagram"Pentagram

Sample of pentagram marker

"hexagram"Hexagram

Sample of hexagram marker

"none"No markersNot applicable

Size of marker, specified as the comma-separated pair consisting of 'MarkerSize' and a positive integer in points.

Marker outline color, specified as the comma-separated pair consisting of 'MarkerEdgeColor' and a character vector, a string scalar, an RGB triplet, or a hexadecimal color code.

Marker outline color, specified as the comma-separated pair consisting of 'MarkerFaceColor' and a character vector, a string scalar, an RGB triplet, a hexadecimal color code, or 'none'. The default is 'none'.

Font size for labeling tracks, specified as the comma-separated pair consisting of 'FontSize' and a positive integer that represents font point size.

Gap between label and positional point it annotates, specified as the comma-separated pair consisting of 'LabelOffset' and a three-element row vector. Specify the [x y z] offset in meters.

Scale factor for magnitude length of velocity vectors, specified as the comma-separated pair consisting of 'VelocityScaling' and a positive scalar. The plot renders the magnitude vector value as VK, where V is the magnitude of the velocity in meters per second, and K is the value of VelocityScaling.

Tag to associate with the plotter, specified as the comma-separated pair consisting of 'Tag' and a character vector or string scalar. The default value is 'PlotterN', where N is an integer that corresponds to the Nth plotter associated with the theaterPlot.

Tags provide a way to identify plotter objects, for example when searching using findPlotter.

Version History

Introduced in R2018b