trackPlotter
Create track plotter
Description
creates a track plotter for use with the theater plot tPlotter
= trackPlotter(tp
)tp
.
creates a track plotter with additional options specified by one or more
tPlotter
= trackPlotter(tp
,Name,Value
)Name,Value
pair arguments.
Examples
Plot Tracks in Theater Plot
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
tp
— Theater plot
theaterPlot
object
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
DisplayName
— Plot name to display in legend
character vector | string scalar
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'
HistoryDepth
— Number of previous track updates to display
0
(default) | nonnegative integer less than or equal to 10,000
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.
ConnectHistory
— Connect tracks flag
'off'
(default) | 'on'
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.
ColorizeHistory
— Colorize track history
'off'
(default) | 'on'
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
— Marker symbol
's'
(default) | character vector | string scalar
Marker symbol, specified as the comma-separated pair consisting of
'Marker'
and one of these symbols.
Marker | Description | Resulting Marker |
---|---|---|
"o" | Circle |
|
"+" | Plus sign |
|
"*" | Asterisk |
|
"." | Point |
|
"x" | Cross |
|
"_" | Horizontal line |
|
"|" | Vertical line |
|
"square" | Square |
|
"diamond" | Diamond |
|
"^" | Upward-pointing triangle |
|
"v" | Downward-pointing triangle |
|
">" | Right-pointing triangle |
|
"<" | Left-pointing triangle |
|
"pentagram" | Pentagram |
|
"hexagram" | Hexagram |
|
"none" | No markers | Not applicable |
MarkerSize
— Size of marker
10
(default) | positive integer
Size of marker, specified as the comma-separated pair consisting of
'MarkerSize'
and a positive integer in points.
MarkerEdgeColor
— Marker outline color
'black'
(default) | character vector | string scalar | RGB triplet | hexadecimal color code
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.
MarkerFaceColor
— Marker fill color
'none'
(default) | character vector | string scalar | RGB triplet | 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'
.
FontSize
— Font size for labeling tracks
10
(default) | positive integer
Font size for labeling tracks, specified as the comma-separated pair consisting of
'FontSize'
and a positive integer that represents font point
size.
LabelOffset
— Gap between label and positional point
[0 0 0]
(default) | three-element row vector
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.
VelocityScaling
— Scale factor for magnitude length of velocity vectors
1
(default) | positive scalar
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
— Tag to associate with the plotter
'PlotterN'
(default) | character vector | string scalar
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
See Also
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)