Aero.trajectory.tracklineTrajectory

Generate reference signals for trackline search trajectory

Since R2026a

Syntax

refSignals = Aero.trajectory.tracklineTrajectory(Name=Value)

Description

refSignals = Aero.trajectory.tracklineTrajectory(Name=Value) generates reference signals for trackline search patterns. Use name-value arguments to define the trackline trajectory. For more information, see Algorithms.

Examples

Generate Reference Signals for Trackline Trajectory

This example shows how to generate reference signals for a trackline trajectory.

refTrackline = Aero.trajectory.tracklineTrajectory(InitialPosition = [0,0], ...
Speed = 100,TrackLineType = "Trackline Search, Return (TSR)", ...
TrackPoint1 = [10,10],TrackPoint2 = [20,20], ...
TrackSpacing = 1000,Altitude = 5000, ...
OutputFormat = "timetable")

refTrackline=5×6 timetable
    09-Jan-2026 08:20:51    1            0            0    100       0         0
    09-Jan-2026 08:21:42    2     716.3997    -697.8139    100    5000    5.5109
    09-Jan-2026 08:21:42    3     727.8139    -686.3997    100    5000    0.7854
    09-Jan-2026 08:22:02    4    -686.3997     727.8139    100    5000    2.3562
    09-Jan-2026 08:22:02    5    -697.8139     716.3997    100    5000    3.9270

Add Reference Signals for Trackline Trajectory to Another Trajectory

This example shows how to add reference signals for a trackline trajectory, refTrackline, to existing reference signals for another trajectory, refSector.

Create reference signals for a sector search trajectory.

sectorSignals = Aero.trajectory.sectorTrajectory(Altitude = 20, ...
Bearing = pi/2,DatumPoint = [-8,0], ...
InitialAltitude = 0,Radius = 5, ...
OutputFormat = "timetable",InitialHeading = 0)

sectorSignals=9×6 timetable
    09-Jan-2026 09:11:18    1           0          0    90     0         0
    09-Jan-2026 09:11:18    2          -8          0    90    20    3.1416
    09-Jan-2026 09:11:18    3          -8          5    90    20    1.5708
    09-Jan-2026 09:11:18    4     -3.6699     2.5000    90    20    5.7596
    09-Jan-2026 09:11:19    5    -12.3301    -2.5000    90    20    3.6652
    09-Jan-2026 09:11:19    6    -12.3301     2.5000    90    20    1.5708
    09-Jan-2026 09:11:19    7     -3.6699    -2.5000    90    20    5.7596
    09-Jan-2026 09:11:19    8     -8.0000         -5    90    20    3.6652
    09-Jan-2026 09:11:19    9          -8          0    90    20    1.5708

Add reference signals for a trackline trajectory, tracklineSignals, to sectorSignals.

tracklineSignals = Aero.trajectory.tracklineTrajectory(PriorTrajectory = sectorSignals, ...
TrackLineType = "Trackline Search, Return (TSR)", ...
TrackPoint1 = [10,10],TrackPoint2 = [20,20], ...
TrackSpacing = 1000,Altitude = 5000)

tracklineSignals=13×6 timetable
    09-Jan-2026 09:11:18     1            0            0    90       0         0
    09-Jan-2026 09:11:18     2           -8            0    90      20    3.1416
    09-Jan-2026 09:11:18     3           -8            5    90      20    1.5708
    09-Jan-2026 09:11:18     4      -3.6699       2.5000    90      20    5.7596
    09-Jan-2026 09:11:19     5     -12.3301      -2.5000    90      20    3.6652
    09-Jan-2026 09:11:19     6     -12.3301       2.5000    90      20    1.5708
    09-Jan-2026 09:11:19     7      -3.6699      -2.5000    90      20    5.7596
    09-Jan-2026 09:11:19     8      -8.0000           -5    90      20    3.6652
    09-Jan-2026 09:11:19     9           -8            0    90      20    1.5708
    09-Jan-2026 09:12:15    10     716.3997    -697.8139    90    5000    5.5165
    09-Jan-2026 09:12:15    11     727.8139    -686.3997    90    5000    0.7854
    09-Jan-2026 09:12:38    12    -686.3997     727.8139    90    5000    2.3562
    09-Jan-2026 09:12:38    13    -697.8139     716.3997    90    5000    3.9270

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: InitialPosition = [0,0]

InitialPosition — Initial position

[0,0] (default) | 1-by-2 vector | 2-by-1 vector

Initial position of trajectory, specified as a 1-by-2 or 2-by-1 vector in the units specified in Units.

Example: InitialPosition = [0,0]

Data Types: double

Speed — Speed of trajectory

10 (default) | finite real double scalar

Speed of trajectory, specified as a finite real double scalar in the units specified in Units.

Example: Speed = 10

Data Types: double

Altitude — Altitude of trajectory

100 (default) | finite real scalar double

Altitude of the vehicle trajectory, specified as a finite real scalar double in the units specified in Units. This value is constant throughout the vehicle path.

Example: Altitude = 10

Data Types: double

InitialHeading — Initial heading of trajectory

0 (default) | finite real double scalar between 0 and 2*pi

Initial heading of trajectory, specified as a finite real double scalar between 0 and 2*pi, in radians. Specify one each of InitialHeading and FinalHeading.

Example: InitialHeading = pi

Data Types: double

OutputFormat — Output format

timeseries object (default) | timetable object

Output format of reference signals data, specified as timeseries or timetable.

Example: OutputFormat = timeseries

Units — Input and output units

Metric (MKS) (default) | English (Velocity in ft/s) | English (Velocity in kts)

Input and output units, specified as one of these values:

Units	Position	Altitude	Speed
Metric (MKS)	Meters	Meters	Meters per second
English (Velocity in ft/s)	Feet	Feet	Feet per second
English (Velocity in kts)	Nautical miles	Feet	Knots

Example: Units = 'Metric (MKS)'

Data Types: double

StartTime — Initial time of trajectory operation

datetime('now') (default) | datetime object

Initial time of trajectory operation, specified as a datetime object.

Example: StartTime=datetime('now')

InitialAltitude — Initial altitude of trajectory

0 (default) | scalar

Initial altitude of trajectory, specified as a scalar in the units specified in Units.

Example: InitialAltitude = 10

Data Types: double

PriorTrajectory — Prior trajectory tracking data

timeseries object (default) | timetable object

Prior trajectory tracking data, specified as a timeseries or timetable object. These objects must contain the fields:

• Altitude(m)

• Heading(rad)

• Speed(m/s)

• WaypointIndex

• xNorth(m)

• yEast(m)

Dependencies

When specifying this name-value argument, also specify Trackspacing, TrackPoint1, and, TrackPoint2. Do not specify the name-value arguments InitialPosition, InitialHeading, or InitialAltitude.

TrackLineType — Trackline search type

Track Line Search, Not return (TSN) (default) | Track Line Search, Return (TSR)

Trackline search type, specified as Track Line Search, Not return (TSN) or Track Line Search, Return (TSR).

Example: TrackLineType = Track Line Search, Not return (TSN)

Data Types: char | string

TrackPoint1 — First track point

[50 0] (default) | 1-by-2 vector

First track point, specified as a 1-by-2 vector in the units specified in Units.

Example: TrackPoint1 = [10,10]

Data Types: double

TrackPoint2 — Second track point

[50 0] (default) | 1-by-2 vector | 2-by-1 vector | finite real double

Second track point, specified as a 1-by-2 or 2-by-1 vector as finite real doubles in the units specified in Units.

Example: TrackPoint2 = [2,10]

Data Types: double

TrackSpacing — Spacing between tracks

5 (default) | scalar

Spacing between tracks, specified as a scalar.

Example: TrackSpacing = 10

Data Types: double

Output Arguments

refSignals — Trajectory reference signals

timeseries struct | timetable object

Trajectory reference signals, returned as a timeseries struct or timetable object.

Algorithms

Use Aero.trajectory.tracklineTrajectory to define the parameters of a trackline trajectory.

Use Aero.trajectory.tracklineTrajectory with no return.

Version History

Introduced in R2026a