airTrajectory

R2026b

Create air trajectory

Since R2026b

expand all in page

    Description

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

    An air trajectory represents the trajectory of an actor in 3D flight. Use airTrajectory objects to specify trajectories when creating Actor objects.

    Creation

    Syntax

    traj = airTrajectory(waypoints)
    traj = airTrajectory(waypoints,Name=Value)

    Description

    traj = airTrajectory(waypoints) creates an air trajectory from the specified waypoints.

    traj = airTrajectory(waypoints,Name=Value) specifies air 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 3D points with height values that are referenced to the WGS84 ellipsoid.

    You can create a geospatial table from latitude, longitude, and height coordinates by using the pointtable function. Indicate that heights are referenced to the ellipsoid by using the HeightReference name-value argument.

    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: airTrajectory(waypoints,GroundSpeed=300) specifies the ground speed for all the waypoints as 300 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.

    Data Types: double

    Climb rate, in meters per second, specified as one of these options:

    • Scalar — Use the same climb rate for each waypoint.

    • Vector — Specify the climb rate for each waypoint. The number of elements in the vector must match the number of rows in waypoints.

    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