orientationPlotter

R2026b

Orientation plotter for theater plot

expand all in page

Description

An OrientationPlotter object defines an orientation plotter belonging to a theaterPlot object. Use the plotOrientation function to plot orientations using the OrientationPlotter object.

Creation

Syntax

oPlotter = orientationPlotter(tp)
oPlotter = orientationPlotter(tp,Name,Value)

Description

oPlotter = orientationPlotter(tp) creates an OrientationPlotter object for use with the theater plot tp.

oPlotter = orientationPlotter(tp,Name,Value) creates an OrientationPlotter object with additional options specified by one or more name-value arguments. Specify optional properties using name-value arguments.

example

Input Arguments

expand all

Theater plot, specified as a theaterPlot object.

Properties

expand all

Plot name to display in legend, specified as a character vector or string scalar. If you do not specify this property, no entry is shown in the legend.

Number of previous track updates to display, specified as a nonnegative integer less than or equal to 100. If set to 0, then no previous updates are rendered.

Marker symbol, specified as 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

"square"Square

Sample of square marker

"diamond"Diamond

Sample of diamond 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

"pentagram"Pentagram

Sample of pentagram marker

"hexagram"Hexagram

Sample of hexagram marker

"none"No markersNot applicable

Size of marker in points, specified as a positive integer.

Marker outline color, specified as a character vector, a string scalar, an RGB triplet, or a hexadecimal color code.

Marker fill color, specified as a character vector, a string scalar, an RGB triplet, a hexadecimal color code, or 'none'.

Font size for labeling orientations, specified as a positive integer that represents font point size.

Gap between label and positional point it annotates, specified as 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 a positive scalar in meters.

Tag associated with the plotter, specified as 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. You can use the findPlotter function to identify plotters based on their tag.

Object Functions

plotOrientationPlot set of orientations in orientation plotter
clearDataClear data from specific plotter of theater plot
clearPlotterDataClear plotter data from theater plot

Examples

collapse all

Open Live Script

This example shows how to animate the orientation of an oscillating device.

Load rpy_9axis.mat. The data in rpy_9axis.mat is recorded accelerometer, gyroscope, and magnetometer sensor data from a device oscillating in pitch (around y-axis), then yaw (around z-axis), then roll (around x-axis). The device's x-axis was pointing southward when recorded.

ld = load('rpy_9axis.mat')
ld = struct with fields:
            Fs: 200
    sensorData: [1×1 struct]

Set the sampling frequency. Extract the accelerometer and gyroscope data. Set the decimation factor to 2. Use fuse to create an indirect Kalman sensor fusion filter from the data.

accel = ld.sensorData.Acceleration;
gyro = ld.sensorData.AngularVelocity;    
Fs  = ld.Fs;
decim = 2;
fuse = imufilter('SampleRate',Fs,'DecimationFactor',decim);

Obtain the pose information of the fused data.

pose = fuse(accel,gyro);

Create a theater plot. Add to the theater plot an orientation plotter with 'DisplayName' set to 'Fused Data' and 'LocalAxesLength' set to 2.

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

Loop through the pose information to animate the changing orientation.

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

Figure contains an axes object. The axes object with xlabel X (m), ylabel Y (m) contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent Fused Data, x-Fused Data, y-Fused Data, z-Fused Data.

Version History

Introduced in R2018b

See Also

| | |