detectionPlotter
R2026bDetection plotter for theater plot
Description
A DetectionPlotter object defines a detection plotter belonging
to a theaterPlot object. Use the
plotDetection function to
plot detections using the DetectionPlotter object.
Creation
Description
detPlotter = detectionPlotter(tp)DetectionPlotter object for use with the theater plot
tp.
detPlotter = detectionPlotter(tp,Name,Value)DetectionPlotter object with additional options specified by
one or more name-value arguments. Specify optional properties using
name-value arguments.
Input Arguments
Properties
Plot name to display in legend, specified as a character vector or string scalar. If you do not specify this property, no entry is shown in the legend.
Number of previous track updates to display, specified as a nonnegative integer less than or equal to 10,000. If set to 0, then no previous updates are rendered.
Marker symbol, specified as 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 |
Size of marker in points, specified as a positive integer.
Marker outline color, specified as a character vector, a string scalar, an RGB triplet, or a hexadecimal color code.
Marker fill color, specified as a character vector, a string scalar, an RGB
triplet, a hexadecimal color code, or 'none'.
Font size for labeling detections, specified as a positive integer that represents font point size.
Gap between label and positional point it annotates, specified as a three-element row vector. Specify the [x y z] offset in meters.
Scale factor for magnitude length of velocity vectors, specified as 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 associated with the plotter, specified as 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. You can
use the findPlotter
function to identify plotters based on their tag.
Since R2026a
Covariance patch outline color, specified as a character vector, a string scalar, or an RGB triplet.
Since R2026a
Covariance patch fill color, specified as a character vector, a string scalar, or an RGB triplet.
Since R2026a
Face alpha value for covariance patch, specified as a scalar in the range
[0 1].
Object Functions
plotDetection | Plot set of detections in theater detection plotter |
clearData | Clear data from specific plotter of theater plot |
clearPlotterData | Clear plotter data from theater plot |
Examples
Create a theater plot.
tp = theaterPlot('XLim',[0,90],'YLim',[-35,35],'ZLim',[1,10]);
Create a detection plotter with the name Radar Detections.
radarPlotter = detectionPlotter(tp,'DisplayName','Radar Detections');
Update the detection plotter with three detections labeled 'R1', 'R2', and 'R3' positioned in units of meters at , , and with corresponding velocities (in m/s) of , , and , respectively.
positions = [30, 5, 4; 30, -10, 2; 30, 15, 1];
velocities = [-10, 0, 2; -10, 3, 1; -10, -4, 1];
labels = {'R1','R2','R3'};
plotDetection(radarPlotter, positions, velocities, labels)
