plotTrackLog

Plot log of tracks

Since R2023b

collapse all in page

Syntax

plotTrackLog(viewer,tracklog)
plotTrackLog(___,frame)
plotTrackLog(___,Name=Value)

Description

plotTrackLog(viewer,tracklog) plots a log of tracks on the tracking globe viewer.

example

plotTrackLog(___,frame) specifies the reference frame used to interpret the coordinates of the tracks.

plotTrackLog(___,Name=Value) specifies options using one or more name-value arguments. For example, plotTrackLog(viewer,tracklog,LineWidth=2) specifies the width of the track trajectory line as 2.

example

Examples

collapse all

Open Live Script

Create a trackingGlobeViewer object and set its reference location. Also, set the camera view.

viewer = trackingGlobeViewer(BaseMap="darkwater",ReferenceLocation=[42.366978 -71.022362 50]);
campos(viewer,[42.3670  -71.0220  110]);

Create a track log that contains five tracks.

tracklog1 = cell(1,5);
for t = 1:5
    tracklog1{t} = objectTrack(State=[0 0 t*10 0 0 0],UpdateTime=t);
end

Plot the track log on the globe viewer.

plotTrackLog(viewer,tracklog1,FontSize=12);

Take a snapshot and show the results.

drawnow
snapshot(viewer)

Figure contains an axes object. The hidden axes object contains an object of type image.

Create a second log of tracks.

tracklog2 = cell(1,5);
for t = 1:t
    tracklog2{t} = objectTrack(State=[10 0 t*10 0 0 0],UpdateTime=t,TrackID=2);
end

Plot the second log and only show the labels of the first and last tracks.

sampleTimes = [tracklog2{1}.UpdateTime tracklog2{end}.UpdateTime];
plotTrackLog(viewer,tracklog2,LabelSampling=sampleTimes,FontSize=14);

Take a snapshot and show the results.

drawnow
snapshot(viewer)

Figure contains an axes object. The hidden axes object contains an object of type image.

Plot the first and second logs together on the globe viewer.

tracklogs = [tracklog1{:} tracklog2{:}];
plotTrackLog(viewer,tracklogs,LabelSampling=sampleTimes,FontSize=14);

Take a snapshot and show the results.

drawnow
snapshot(viewer)

Figure contains an axes object. The hidden axes object contains an object of type image.

Input Arguments

collapse all

Tracking globe viewer, specified as a trackingGlobeViewer object.1

Log of tracks, specified as an array or cell array of objectTrack objects, or as an array or cell array of structures containing sufficient information to obtain the track position information. For a sample track structure, see toStruct.

Reference frame, specified as "NED" for north-east down, "ENU" for east-north-up, or "ECEF" for Earth-centered-Earth-fixed. When specified as "NED" or "ENU", the origin of the reference frame is at the location specified by the ReferenceLocation property of the viewer object.

Data Types: char | string

Name-Value Arguments

collapse all

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: plotTrackLog(viewer,tracklog,LineWidth=2)

Since R2026a

Color of detections, specified as:

  • "Auto" — Automatically select the color from a limited set of colors.

  • A 1-by-3 RGB triplet — Plot all track logs with the same color.

Since R2026a

Label sampling mode, specified as "Timestamp", "IndexSpacing", or"CustomIndices". LabelSamplingMode determines how plotTrackLog interpret the LabelSampling argument.

LabelSamplingModeHow to Specify LabelSamplingDescription
"Timestamp"Vector of nonnegative scalars of time valuesSamples at specified times. Each value must match the UpdateTime property of at least one track in the tracklog input.
"IndexSpacing"Positive integer, NSamples every Nth step.
"CustomIndices"Vector of positive integersSamples at the specified indices. The function samples at each index listed in the vector.

Label sampling, specified as a vector of nonnegative scalars, a positive integer, or a vector of positive integers. This argument depends on the LabelSamplingMode argument.

LabelSamplingModeHow to Specify LabelSamplingDescription
"Timestamp"Vector of nonnegative scalars of time valuesSamples at specified times. Each value must match the UpdateTime property of at least one track in the tracklog input.
"IndexSpacing"Positive integer, NSamples every Nth step.
"CustomIndices"Vector of positive integersSamples at the specified indices. The function samples at each index listed in the vector.

Position selector, specified as an M-by-N matrix of 0s and 1s, where M is the dimension of the position state and N is the dimension of the track state. The selector selects the position state from the track state by premultiplying the track state. The default value [1 0 0 0 0 0 ; 0 0 1 0 0 0; 0 0 0 0 1 0] selects [x; y; z] from a six-dimensional state [x; vx; y; vy; z; vz]. You can also specify the position selector as a character vector or string scalar of motion model name, such as "constvel", "constacc", "singer", "constturn", or "ctrv". See getTrackPositions for more details.

Data Types: single | double

Font size of the track labels, specified as a positive scalar in point units. One point equals 1/72 inch.

Example: 11

Data Types: single | double

Line width of the track trajectory line, specified as a nonnegative scalar in point units, where 1 point = 1/72 of an inch.

Tip

If you specify the line width as 0, then the plot does not show the trajectory line.

Example: 2

Version History

Introduced in R2023b

expand all

See Also

| |

1 Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks®.