Main Content

orientationPlotter

Create orientation plotter

Description

oPlotter = orientationPlotter(tp) creates an orientation plotter for use with the theater plot tp.

example

oPlotter = orientationPlotter(tp,Name,Value) creates an orientation plotter with additional options specified by one or more Name,Value pair arguments.

Examples

collapse all

Create a theater plot object and a trajectory plotter.

tp = theaterPlot('XLimit',[-2 2],'YLimit',[-2 2],'ZLimit',[-2 2]);
op = orientationPlotter(tp,'DisplayName','Orientation',...
    'LocalAxesLength',2);

Create some random rotations.

pose = randrot(20,1);

Loop through the pose information to animate the orientations.

for i=1:numel(pose)
    plotOrientation(op,pose(i))
    drawnow
end

Figure contains an axes object. The axes object contains 4 objects of type line. These objects represent Orientation, x-Orientation, y-Orientation, z-Orientation.

Input Arguments

collapse all

Theater plot, specified as a theaterPlot object.

Name-Value 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: 'HistoryDepth',6

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'

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

MarkerDescriptionResulting Marker
'o'Circle

Sample of circle marker

'+'Plus sign

Sample of plus sign marker

'*'Asterisk

Sample of asterisk marker

'.'Point

Sample of point marker

'x'Cross

Sample of cross marker

'_'Horizontal line

Sample of horizontal line marker

'|'Vertical line

Sample of vertical line marker

's'Square

Sample of square marker

'd'Diamond

Sample of diamond line marker

'^'Upward-pointing triangle

Sample of upward-pointing triangle marker

'v'Downward-pointing triangle

Sample of downward-pointing triangle marker

'>'Right-pointing triangle

Sample of right-pointing triangle marker

'<'Left-pointing triangle

Sample of left-pointing triangle marker

'p'Pentagram

Sample of pentagram marker

'h'Hexagram

Sample of hexagram marker

'none'No markersNot applicable

Size of marker, specified in points as the comma-separated pair consisting of 'MarkerSize' and a positive integer.

Marker outline color, specified as the comma-separated pair consisting of 'MarkerEdgeColor' and a character vector, string scalar, an RGB triplet, or a hexadecimal color code. The default color is 'black'.

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

Length of line used to denote each of the local x-, y-, and z-axes of the given orientation, specified as the comma-separated pair consisting of 'LocalAxesLength' and a positive scalar. 'LocalAxesLength' is in meters.

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.

Introduced in R2021a