# platformPlotter

Create platform plotter

## Syntax

``pPlotter = platformPlotter(tp)``
``pPlotter = platformPlotter(tp,Name,Value)``

## Description

````pPlotter = platformPlotter(tp)` creates a platform plotter for use with the theater plot, `tp`.```

example

````pPlotter = platformPlotter(tp,Name,Value)` creates a platform 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 platform plotter with the name `'Platforms'`.

`plotter = platformPlotter(tp,'DisplayName','Platforms');`

Update the theater plot with three platforms labeled, `'R1'`, `'R2'`, and `'R3'`. Position the three platforms, in units of meters, at $\left(30,\text{\hspace{0.17em}}5,\text{\hspace{0.17em}}4\right)$, $\left(30,\text{\hspace{0.17em}}-10,\text{\hspace{0.17em}}2\right)$, and $\left(30,\text{\hspace{0.17em}}15,\text{\hspace{0.17em}}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,\text{\hspace{0.17em}}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'}; plotPlatform(plotter, positions, velocities, labels);```

## 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.

Example: `'DisplayName','Radar Detections'`

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

ValueDescription
`'o'`Circle
`'+'`Plus sign
`'*'`Asterisk
`'.'`Point
`'x'`Cross
`'_'`Horizontal line
`'|'`Vertical line
`'square'` or `'s'`Square
`'diamond'` or `'d'`Diamond
`'^'`Upward-pointing triangle
`'v'`Downward-pointing triangle
`'>'`Right-pointing triangle
`'<'`Left-pointing triangle
`'pentagram'` or `'p'`Five-pointed star (pentagram)
`'hexagram'` or `'h'`Six-pointed star (hexagram)
`'none'`No markers

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 platforms, specified in font points size as the comma-separated pair consisting of `'FontSize'` and a positive integer.

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`.