plotPlatform

Plot platforms or targets in trackingGlobeViewer

Since R2021b

collapse all in page

Syntax

plotPlatform(viewer,platforms)
plotPlatform(viewer,platStructs)
plotPlatform(viewer,platStructs,frame)
plotPlatform(___,Name=Value)

Description

plotPlatform(viewer,platforms) plots tracking scenario platforms, specified as objects, on the tracking globe viewer.

example

plotPlatform(viewer,platStructs) plots tracking scenario platforms, specified as structures, on the tracking globe viewer.

plotPlatform(viewer,platStructs,frame) specifies the reference frame used to interpret the Position field of the platform structures platStructs.

plotPlatform(___,Name=Value) specifies options using one or more name-value arguments. For example, plotplatform(viewer,platforms,TrajectoryMode="History") specifies the trajectory plotting mode as "History".

Examples

collapse all

Open Live Script

Create a trackingGlobeViewer with a specified reference location.

refloc = [42.366978 -71.022362 50];
viewer = trackingGlobeViewer(ReferenceLocation=refloc);

Adjust the camera position and orientation for visualization.

campos(viewer,refloc + [.02 .02 820]);
camorient(viewer,[210 -9 0]);

Create a tracking scenario and add two platforms. The first platform has an associated waypoint trajectory.

s = trackingScenario;
p1 = platform(s,'Trajectory',waypointTrajectory([0 0 0; 0 100 -100; 0 200 -500],[0 60 120]));
p2 = platform(s,'Position',[100 100 0]);

Plot the two platforms on the virtual globe.

plotPlatform(viewer,p1,TrajectoryMode="Full");
hold on
plotPlatform(viewer,p2,Marker="d",Color=[1 0 0]);

Show the snapshot of the globe.

drawnow
snapshot(viewer)

Input Arguments

collapse all

Tracking globe viewer, specified as a trackingGlobeViewer object.1

Tracking scenario platforms, specified as an array of Platform objects. You can create a platform in a tracking scenario using the platform object function.

Platform structures, specified as an array of structures. Each structure must contain at least these fields:

Field NameDescription
Position

Position of the platform, specified as a three-element real-valued vector. Specify the position in the form [x, y, z], in meters, in your specified reference frame.

PlatformIDUnique platform identifier, specified as a positive integer.
DimensionsPlatform dimensions and origin offset, specified as a structure. It must follow the same convention as the Dimensions property of the scenario platform object.
OrientationOrientation of the platform, specified as a 3-element vector of scalars in degrees. It must follow the same convention as the Orientation property of the scenario platform object.

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.

Example: plotPlatform(viewer,platforms,TrajectoryMode="History")

Display mode for platform trajectories, specified as "History", "Full", or "None".

  • "History" — The viewer displays the past platform positions from the previous calls to the plotPlatform function. The maximum number of displayed history positions is specified by the PlatformHistoryDepth property of the viewer.

  • "Full" — Displays the entire platform trajectory, including the future platform positions.

  • "None" — Does not display any platform trajectory information.

Data Types: char | string

Marker symbol, specified as "^" for a triangle marker, "d" for a diamond marker, or "s" for a square marker.

Data Types: char | string

Since R2025a

Marker size, specified as a nonnegative real integer.

Data Types: single | double

Width of the trajectory line, specified as a positive value in points, where 1 point = 1/72 of an inch. The line width cannot be thinner than the width of a pixel. If you set the line width to a value that is less than the width of a pixel on your system, the line displays as one pixel wide.

Color of trajectory line, specified as

  • A triplet — Plot all the trajectories with the same color.

  • An N-by-3 matrix of RGB triplets — Plot each trajectory line with a different color. N is the number of platforms plotted.

Platform label style, specified as one of these options:

  • "ID" — The function displays the platform label as platform ID and source index (if any).

  • "None" — The function does not display any platform label.

Data Types: char | string

Since R2025a

Enable the display of the platform mesh, specified as false or true. Set this argument to true if you want to display the dimensions and orientation of the platform as a mesh on the globe.

If the input platform is a structure array or a cell array of structures, you must include the fields Dimensions and Orientation in the platStructs argument in order to display the platform mesh.

Since R2025a

Scaling factor for the platform mesh, specified as a positive real scalar.

To enable this argument, set the ShowMesh argument to true.

Since R2025a

Transparency value for the platform mesh, specified as a scalar in the range [0,1]. A value of 0 means transparent. A value of 1 means opaque. Values between 0 and 1 are partially transparent.

To enable this argument, set the ShowMesh argument to true.

Version History

Introduced in R2021b

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