groundTrajectory

R2026b

Create ground trajectory

Since R2026b

expand all in page

    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

    expand all

    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

    expand 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: groundTrajectory(waypoints,GroundSpeed=30) specifies the ground speed for all the waypoints as 30 meters per second.

    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

    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, 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

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

    expand all

    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

    interpInterpolate trajectory at specified time
    startTimeStart time of trajectory
    stopTimeStop time of trajectory

    Version History

    Introduced in R2026b

    See Also

    Functions

    Objects

    Topics