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.

pPlotter = platformPlotter(tp,Name,Value) creates a platform plotter with additional options specified by one or more Name,Value pair arguments.

example

Examples

collapse all

Create and Update Theater Plot Platforms

Open Live Script

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 $(30, 5, 4)$ , $(30, - 10, 2)$ , and $(30, 15, 1)$ , with corresponding velocities (in m/s) of $(- 10, 0, 2)$ , $(- 10, 3, 1)$ , and $(- 10, - 4, 1)$ , 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);

Change the view angles to view in 3-D.

view([-57.7 -25.9]);

Figure contains an axes object. The axes object with xlabel X (m), ylabel Y (m) contains 4 objects of type line, text. One or more of the lines displays its values using only markers This object represents Platforms.

Input Arguments

collapse all

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

`Marker` — Marker symbol
`'^'` (default) | character vector | string scalar

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

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
`6` | 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 platforms
`10` (default) | positive integer

Font size for labeling platforms, specified in font points size as the comma-separated pair consisting of 'FontSize' and a positive integer.

`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

platformPlotter

Syntax

Description

Examples

Create and Update Theater Plot Platforms

Input Arguments

tp — Theater plot theaterPlot object

Name-Value Arguments

DisplayName — Plot name to display in legend character vector | string scalar

Marker — Marker symbol '^' (default) | character vector | string scalar

MarkerSize — Size of marker 6 | positive integer

MarkerEdgeColor — Marker outline color 'black' (default) | character vector | string scalar | RGB triplet | hexadecimal color code

MarkerFaceColor — Marker fill color 'none' (default) | character vector | string scalar | RGB triplet | hexadecimal color code

FontSize — Font size for labeling platforms 10 (default) | positive integer

LabelOffset — Gap between label and positional point [0 0 0] (default) | three-element row vector

VelocityScaling — Scale factor for magnitude length of velocity vectors 1 (default) | positive scalar

Tag — Tag to associate with the plotter 'PlotterN' (default) | character vector | string scalar