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.

example

Examples

collapse all

Generate Reference Signals for Trackline Trajectory

Open Live Script

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

Open Live Script

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

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

collapse all

`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

Aero.trajectory.tracklineTrajectory

Syntax

Description

Examples

Generate Reference Signals for Trackline Trajectory

Add Reference Signals for Trackline Trajectory to Another Trajectory

Name-Value Arguments

`InitialPosition` — Initial position
`[0,0]` (default) | 1-by-2 vector | 2-by-1 vector

`Speed` — Speed of trajectory
`10` (default) | finite real double scalar

`Altitude` — Altitude of trajectory
`100` (default) | finite real scalar double

`InitialHeading` — Initial heading of trajectory
`0` (default) | finite real double scalar between `0` and `2*pi`

`OutputFormat` — Output format
`timeseries` object (default) | `timetable` object

`Units` — Input and output units
`Metric (MKS)` (default) | `English (Velocity in ft/s)` | `English (Velocity in kts)`

`StartTime` — Initial time of trajectory operation
`datetime('now')` (default) | `datetime` object

`InitialAltitude` — Initial altitude of trajectory
0 (default) | scalar

`PriorTrajectory` — Prior trajectory tracking data
`timeseries` object (default) | `timetable` object

Dependencies

`TrackLineType` — Trackline search type
`Track Line Search, Not return (TSN)` (default) | `Track Line Search, Return (TSR)`

`TrackPoint1` — First track point
`[50 0]` (default) | 1-by-2 vector

`TrackPoint2` — Second track point
`[50 0]` (default) | 1-by-2 vector | 2-by-1 vector | finite real double

`TrackSpacing` — Spacing between tracks
5 (default) | scalar

Output Arguments

`refSignals` — Trajectory reference signals
`timeseries` `struct` | `timetable` object

Algorithms

Version History

See Also

Live Editor Tasks

Functions

Aero.trajectory.tracklineTrajectory

Syntax

Description

Examples

Generate Reference Signals for Trackline Trajectory

Add Reference Signals for Trackline Trajectory to Another Trajectory

Name-Value Arguments

InitialPosition — Initial position [0,0] (default) | 1-by-2 vector | 2-by-1 vector

Speed — Speed of trajectory 10 (default) | finite real double scalar

Altitude — Altitude of trajectory 100 (default) | finite real scalar double

InitialHeading — Initial heading of trajectory 0 (default) | finite real double scalar between 0 and 2*pi

OutputFormat — Output format timeseries object (default) | timetable object

Units — Input and output units Metric (MKS) (default) | English (Velocity in ft/s) | English (Velocity in kts)

StartTime — Initial time of trajectory operation datetime('now') (default) | datetime object

InitialAltitude — Initial altitude of trajectory 0 (default) | scalar

PriorTrajectory — Prior trajectory tracking data timeseries object (default) | timetable object

Dependencies

TrackLineType — Trackline search type Track Line Search, Not return (TSN) (default) | Track Line Search, Return (TSR)

TrackPoint1 — First track point [50 0] (default) | 1-by-2 vector

TrackPoint2 — Second track point [50 0] (default) | 1-by-2 vector | 2-by-1 vector | finite real double

TrackSpacing — Spacing between tracks 5 (default) | scalar

Output Arguments

refSignals — Trajectory reference signals timeseries struct | timetable object

Algorithms

Version History

See Also

Live Editor Tasks

Functions

`InitialPosition` — Initial position
`[0,0]` (default) | 1-by-2 vector | 2-by-1 vector

`Speed` — Speed of trajectory
`10` (default) | finite real double scalar

`Altitude` — Altitude of trajectory
`100` (default) | finite real scalar double

`InitialHeading` — Initial heading of trajectory
`0` (default) | finite real double scalar between `0` and `2*pi`

`OutputFormat` — Output format
`timeseries` object (default) | `timetable` object

`Units` — Input and output units
`Metric (MKS)` (default) | `English (Velocity in ft/s)` | `English (Velocity in kts)`

`StartTime` — Initial time of trajectory operation
`datetime('now')` (default) | `datetime` object

`InitialAltitude` — Initial altitude of trajectory
0 (default) | scalar

`PriorTrajectory` — Prior trajectory tracking data
`timeseries` object (default) | `timetable` object

`TrackLineType` — Trackline search type
`Track Line Search, Not return (TSN)` (default) | `Track Line Search, Return (TSR)`

`TrackPoint1` — First track point
`[50 0]` (default) | 1-by-2 vector

`TrackPoint2` — Second track point
`[50 0]` (default) | 1-by-2 vector | 2-by-1 vector | finite real double

`TrackSpacing` — Spacing between tracks
5 (default) | scalar

`refSignals` — Trajectory reference signals
`timeseries` `struct` | `timetable` object