# detectionPlotter

Create detection plotter

## Description

detPlotter = detectionPlotter(tp) creates a detection plotter for use with the theater plot tp.

example

detPlotter = detectionPlotter(tp,Name,Value) creates a detection plotter with additional options specified by one or more Name,Value pair arguments.

## Examples

collapse all

Create a theater plot.

tp = theaterPlot('XLim',[0,90],'YLim',[-35,35],'ZLim',[1,10]);

Create a detection plotter with the name Radar Detections.

Update the detection plotter with three detections labeled 'R1', 'R2', and 'R3' positioned in units of meters at $\left(30,5,4\right)$, $\left(30,-10,2\right)$, and $\left(30,15,1\right)$ with corresponding velocities (in m/s) of $\left(-10,\text{\hspace{0.17em}}0,\text{\hspace{0.17em}}2\right)$, $\left(-10,\text{\hspace{0.17em}}3,\text{\hspace{0.17em}}1\right)$, and $\left(-10,\text{\hspace{0.17em}}-4,1\right)$, 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'};

## Input Arguments

collapse all

Theater plot, specified as a theaterPlot object.

### Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

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.

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.

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

ValueDescription
'+'

Plus sign

'o'

Circle (default)

'*'

Asterisk

'.'

Point

'x'

Cross

's' or 'square'

Square

'd' or 'diamond'

Diamond

'v'

Downward-pointing triangle

'^'

Upward-pointing triangle

'>'

Right-pointing triangle

'<'

Left-pointing triangle

'p' or 'pentagram'

Five-pointed star (pentagram)

'h' or 'hexagram'

Six-pointed star (hexagram)

'none'

No marker symbol

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 detections, 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.