groundTrajectory

R2026b

Create ground trajectory

Since R2026b

Description

Add-On Required: This feature requires the 3D Scenarios add-on.

A ground trajectory represents the trajectory of an actor that moves along the ground surface. Use groundTrajectory objects to specify trajectories when creating Actor objects.

Creation

Syntax

traj = groundTrajectory(waypoints)

traj = groundTrajectory(waypoints,Name=Value)

Description

traj = groundTrajectory(waypoints) creates a ground trajectory from the specified waypoints.

traj = groundTrajectory(waypoints,Name=Value) specifies ground trajectory options using name-value arguments. For example, specify the time of arrival for each waypoint by using the TimeOfArrival argument.

Input Arguments

waypoints — Waypoints

geospatial table containing geopointshape objects

Waypoints, specified as a geospatial table containing geopointshape objects. The geopointshape objects must represent 2D points. The table must specify terrain as the height reference.

You can create a geospatial table from latitude and longitude coordinates by using the pointtable function.

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.

Example: groundTrajectory(waypoints,GroundSpeed=30) specifies the ground speed for all the waypoints as 30 meters per second.

TimeOfArrival — Time of arrival, in seconds

vector of nondecreasing values

Time of arrival, in seconds, specified as a vector of nondecreasing values. The first element of the vector must be 0. The number of elements in the vector must match the number of rows in waypoints.

Data Types: double | duration

GroundSpeed — Ground speed, in meters per second

13 (default) | nonnegative scalar | vector of nonnegative values

Ground speed, in meters per second, specified as one of these options:

• Nonnegative scalar — Use the same ground speed for each waypoint.

• Vector of nonnegative values — Specify the ground speed for each waypoint. The number of elements in the vector must match the number of rows in waypoints.

At least one element of GroundSpeed must be positive.

Data Types: double

Course — Course, in degrees

vector

Course, in degrees, specified as a vector. The number of elements in the vector must match the number of rows in waypoints.

To specify this argument, the value of PathType must be "clothoid".

Data Types: double

PathType — Shape of interpolated path through waypoints

"clothoid" (default) | "linear"

Shape of the interpolated path through the waypoints, specified as one of these options:

• "clothoid" — The path follows a clothoid curve, where the curvature changes linearly with distance.

• "linear" — The path follows straight-line segments between waypoints.

Height — Height offset from ground, in meters

0 (default) | nonnegative scalar

Height offset from the ground, in meters, specified as a nonnegative scalar. This value applies to all the waypoints. Use this argument to raise actors by a fixed offset from the ground.

Data Types: double

Properties

TimeOfArrival — Time of arrival, in seconds

Read-only: vector of nondecreasing values

This property is read-only.

Time of arrival, in seconds, represented as a vector of nondecreasing values. The number of elements in the vector matches the number of rows in waypoints.

Object Functions

interp	Interpolate trajectory at specified time
startTime	Start time of trajectory
stopTime	Stop time of trajectory

Version History

Introduced in R2026b