trackPlotter

Track plotter for bird's-eye plot

Syntax

tPlotter = trackPlotter(bep)

tPlotter = trackPlotter(bep,Name,Value)

Description

tPlotter = trackPlotter(bep) creates a TrackPlotter object that configures the display of tracks on a bird's-eye plot. The TrackPlotter object is stored in the Plotters property of the input birdsEyePlot object, bep. To display the tracks, use the plotTrack function.

tPlotter = trackPlotter(bep,Name,Value) sets properties using one or more Name,Value pair arguments. For example, trackPlotter(bep,'DisplayName','Tracks') sets the display name that appears in the bird's-eye-plot legend.

Examples

Create and Display Labeled Tracks on Bird's-Eye Plot

Create a bird's-eye plot with an x-axis range from 0 to 90 meters and a y-axis range from –35 to 35 meters. Create a track plotter that displays up to seven history values for each track and offsets labels by 3 meters in front of the tracks.

bep = birdsEyePlot('XLim',[0 90],'YLim',[-35 35]);
tPlotter = trackPlotter(bep,'DisplayName','Tracks','HistoryDepth',7,'LabelOffset',[3 0]);

Set the positions and velocities of three labeled tracks.

positions = [30, 5; 30, 5; 30, 5];
velocities = [3, 0; 3, 2; 3, -3];
labels = {'T1','T2','T3'};

Display the tracks for 10 trials. The bird's-eye plot shows the seven history values specified previously.

for i=1:10
   plotTrack(tPlotter,positions,velocities,labels);
   positions = positions + velocities;
end

Input Arguments

bep — Bird’s-eye plot

birdsEyePlot object

Bird’s-eye plot, specified as a birdsEyePlot 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: trackPlotter('Marker','*') sets the marker symbol for tracks to an asterisk.

DisplayName — Plotter name to display in legend

'' (default) | character vector | string scalar

Plotter name to display in legend, specified as the comma-separated pair consisting of 'DisplayName' and character vector or string scalar. If you do not specify a name, the bird's-eye plot does not display a legend entry for the plotter.

HistoryDepth — Number of previous track updates to display

0 (default) | integer in the range [0, 100]

Number of previous track updates to display, specified as the comma-separated pair consisting of 'HistoryDepth' and an integer in the range [0, 100]. When you set this value to 0, the bird's-eye plot displays no previous updates.

Marker — Marker symbol for tracks

'square' (default) | '+' | '*' | '.' | 'x' | ...

Marker symbol for tracks, specified as the comma-separated pair consisting of 'Marker' and one of the markers in this table.

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 for tracks

10 (default) | positive integer

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

MarkerEdgeColor — Marker outline color for tracks

[0 0 0] (black) (default) | RGB triplet | hexadecimal color code | color name | short color name

Marker outline color for tracks, specified as the comma-separated pair consisting of 'MarkerEdgeColor' and an RGB triplet, a hexadecimal color code, a color name, or a short color name.

For a custom color, specify an RGB triplet or a hexadecimal color code.

• An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1], for example, [0.4 0.6 0.7].

• A hexadecimal color code is a string scalar or character vector that starts with a hash symbol (#) followed by three or six hexadecimal digits, which can range from 0 to F. The values are not case sensitive. Therefore, the color codes "#FF8800", "#ff8800", "#F80", and "#f80" are equivalent.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.

Color Name	Short Name	RGB Triplet	Hexadecimal Color Code	Appearance
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"
"none"	Not applicable	Not applicable	Not applicable	No color

Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB^® uses in many types of plots.

RGB Triplet	Hexadecimal Color Code	Appearance
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

MarkerFaceColor — Marker fill color for tracks

'none' (default) | RGB triplet | hexadecimal color code | color name | short color name

Marker fill color for tracks, specified as the comma-separated pair consisting of 'MarkerFaceColor' and an RGB triplet, a hexadecimal color code, a color name, or a short color name.

For a custom color, specify an RGB triplet or a hexadecimal color code.

• An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1], for example, [0.4 0.6 0.7].

• A hexadecimal color code is a string scalar or character vector that starts with a hash symbol (#) followed by three or six hexadecimal digits, which can range from 0 to F. The values are not case sensitive. Therefore, the color codes "#FF8800", "#ff8800", "#F80", and "#f80" are equivalent.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.

Color Name	Short Name	RGB Triplet	Hexadecimal Color Code	Appearance
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"
"none"	Not applicable	Not applicable	Not applicable	No color

Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB uses in many types of plots.

RGB Triplet	Hexadecimal Color Code	Appearance
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

FontSize — Font size for labeling tracks

10 points (default) | positive integer

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

LabelOffset — Gap between label and positional point

[0 0] (default) | real-valued vector of the form [x y]

Gap between label and positional point, specified as the comma-separated pair consisting of 'LabelOffset' and a real-valued vector of the form [x y]. Units are in meters.

VelocityScaling — Scale factor for magnitude length of velocity vectors

1 (default) | positive real scalar

Scale factor for magnitude length of velocity vectors, specified as the comma-separated pair consisting of 'VelocityScaling' and a positive real scalar. The bird's-eye plot renders the magnitude vector value as M × VelocityScaling, where M is the magnitude of velocity.

Tag — Tag associated with plotter object

'PlotterN' (default) | character vector | string scalar

Tag associated with the plotter object, 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 input birdsEyePlot object.

Output Arguments

tPlotter — Track plotter

TrackPlotter object

Track plotter, returned as a TrackPlotter object. You can modify this object by changing its property values. The property names correspond to the name-value pair arguments of the trackPlotter function.

tPlotter is stored in the Plotters property of the input birdsEyePlot object, bep. To plot the tracks, use the plotTrack function.

Version History

Introduced in R2017a