theaterPlot

Plot objects, detections, and tracks in trackingScenario

Description

The theaterPlot object is used to display a plot of a trackingScenario. This type of plot can be used with sensors capable of detecting objects.

Creation

Syntax

tp = theaterPlot

tp = theaterPlot(Name,Value)

Description

tp = theaterPlot creates a theater plot in a new figure.

tp = theaterPlot(Name,Value) creates a theater plot in a new figure with optional input Properties specified by one or more Name,Value pair arguments. Properties can be specified in any order as Name1,Value1,...,NameN,ValueN. Enclose each property name in quotes.

Properties

Parent — Parent axes

theaterPlot handle

Parent axes, specified as a theaterPlot handle. If you do not specify Parent, then theaterPlot creates axes in a new figure.

Plotters — Plotters created for theater plot

array of plotter objects

Plotters created for the theater plot, specified as an array of plotter objects.

XLimits — Limits of x-axis

two-element row vector

Limits of the x-axis, specified as a two-element row vector, [x1,x2]. The values x1 and x2 are the lower and upper limits, respectively, for the theater plot display. If you do not specify the limits, then the default values for the Parent property are used. See Orientation, Position, and Coordinate Systems for coordinate system definitions.

Data Types: double

YLimits — Limits of y-axis

two-element row vector

Limits of the y-axis, specified as a two-element row vector, [y1,y2]. The values y1 and y2 are the lower and upper limits, respectively, for the theater plot display. If you do not specify the limits, then the default values for the Parent property are used. See Orientation, Position, and Coordinate Systems for coordinate system definitions.

Data Types: double

ZLimits — Limits of z-axis

two-element row vector

Limits of the z-axis, specified as a two-element row vector, [z1,z2]. The values z1 and z2 are the lower and upper limits, respectively, for the theater plot display. If you do not specify the limits, then the default values for the Parent property are used. See Orientation, Position, and Coordinate Systems for coordinate system definitions.

Data Types: double

Object Functions

Plotter Objects

clearData	Clear data from specific plotter of theater plot
clearPlotterData	Clear plotter data from theater plot
detectionPlotter	Create detection plotter
findPlotter	Return array of plotters associated with theater plot
orientationPlotter	Create orientation plotter
platformPlotter	Create platform plotter
trackPlotter	Create track plotter
trajectoryPlotter	Create trajectory plotter

Plotting Functions

plotDetection	Plot set of detections in theater detection plotter
plotOrientation	Plot set of orientations in orientation plotter
plotPlatform	Plot set of platforms in platform plotter
plotTrack	Plot set of tracks in theater track plotter
plotTrajectory	Plot set of trajectories in trajectory plotter

Examples

Create and Display Theater Plot

Create a theater plot.

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

Display radar detections with coordinates at $\left(30,-5,5\right)$, $\left(50,-10,10\right)$, and $\left(40,7,40\right)$. Set the view so that you are looking on the yz-plane. Confirm the y- and z-coordinates of the radar detections are correct.

radarPlotter = detectionPlotter(tp,'DisplayName','Radar Detections');
plotDetection(radarPlotter, [30 -5 5; 50 -10 10; 40 7 40])
grid on
view(90,0)

The view can be changed by opening the plot in a figure window and selecting Tools > Rotate 3D in the figure menu.

Limitations

You cannot use the rectangle-zoom feature in the theaterPlot figure.