Tracking Data Importer
Description
The Tracking Data Importer app enables you to import tracking data, convert the tracking data to a standardized format supported by Sensor Fusion and Tracking Toolbox™, visualize the tracking data on a globe, and export your converted data to the MATLAB® workspace. You can also create an importer object for batch conversion of tracking data belonging to the same format.
Open the Tracking Data Importer App
MATLAB Toolstrip: On the Apps tab, under Signal processing and communications, click the app icon .
MATLAB command prompt: Enter
trackingDataImporter
.
Examples
Related Examples
Parameters
Toolstrip Buttons
Import tracking data using one of these options:
Import from file — Use this option to import truth data directly from a XLSX, XLS, TXT, or CSV file.
Import from workspace — Use this option to import truth data from a
table
ortimetable
.Import from file using MATLAB Import tool — Use the Import Tool to import custom data.
Create new converter using one of these options:
Flight Log — Create a converter to interpret a common flight log.
GPS Log — Create a converter to interpret a common GPS log.
Driving Log — Create a converter to interpret a driving log recorded from an ego vehicle.
Custom — Customize a converter by specifying the reference frame information of the imported truth data.
For more information on the converter options, see Converter Options.
Switch between saved converters or manage all converters. Manage converters using one of these options:
Edit — Edit the Name, Model Option, or Time Option of an saved converter.
Duplicate — Duplicate a saved converter.
Delete — Delete a saved converter.
Display or close the Mapping pane.
Convert imported data using the current converter.
Visualize truth data on a globe. The default view displays all trajectories. You can highlight specific data in three ways:
Clicking on any row in the Imported or Converted table highlights the corresponding data point by displaying a triangle or a mesh box for its position and its Platform ID on the trajectory.
Right-click any cell in the Date Time column of the converted table and choose
Highlight all platform poses at this time
. This action highlights all platforms at this time by displaying their positions and Platform IDs.Right-click any cell in the Platform ID column of the converted table and choose
Highlight trajectory for this platform
. This action highlights the data points of this platform at all times by displaying its position and Platform ID.
Note
To visualize truth data, the data must be Earth referenced. For more information, see Reference frame.
Clear highlights in the visualization by removing the position-indicating triangles or mesh boxes and the platform ID from the globe.
Restore the default view that displays all trajectories on the globe.
Export converted data or a TrackingTruthDataImporter
object using one of these options:
trackingScenarioRecording: Export the truth data as a
trackingScenarioRecording
object. You can use the object for metric evaluation, or use theplay
function to visualize the recordings.Tuning Data: Export the truth data as a tuning data structure for tuning tracking filters.
Truth Log: Export the truth data as a truth log structure array for metric evaluation.
Converted Table: Export the converted table.
TrackingTruthDataImporter: Export a
TrackingTruthDataImporter
object.
For more information on the export options, see Export Options.
Converter Options
Import data that follows a flight log format. You can customize the name of the converter and define the Model Option and Time Option parameters by specifying the Frame Type and Time Type options.
Set Frame Type to one of these values:
Local NED
(North-East-Down)Local ENU
(East-North-Up)
For more information, see Reference frame.
Set Time Type to one of these values:
Date Time
Duration
For more information, see Time Format.
Import data that follows a GPS log format. You can customize the name of the converter and define the Model Option and Time Option parameters by specifying the Frame Type and Time Type options.
Set Frame Type to one of these values:
Local NED
(North-East-Down)Local ENU
(East-North-Up)
For more information, see Reference frame.
Set Time Type to one of these values:
Date Time
Duration
For more information, see Time Format.
Import data that follows a driving log format. You can customize the name of the converter and define the Model Option and Time Option parameters by specifying the Frame Type and Time Type options.
Set Frame Type to:
Ego — Ego is currently the only supported frame type for driving log. The truth data, including position, velocity, acceleration, orientation, angular velocity, and angular acceleration of all platforms, are recorded with respect to the ego vehicle.
Tip
When exporting data from a driving log, the export Reference Frame can only be
ego
.
Set Time Type to one of these values:
Date Time
Duration
For more information, see Time Format.
Import data that follows a custom format. You can customize the name of the converter and define the Model Option and Time Option parameters by specifying the Coordinate Type, Frame Type, Target Extent, and Time Type options.
Set Coordinate Type to one of these values:
Cartesian
— Represents positions in a three-dimensional space using a set of three numerical values, denoted as (x, y, z).Geodetic
— Represents positions on the Earth's surface using a set of values that include latitude, longitude, and optionally altitude.
For more information, see Coordinate system.
Set Frame Type to one of these values when you set
Coordinate Type to Cartesian
:
ECEF
(Earth-Centered, Earth-Fixed)Fixed NED
(North-East-Down)Fixed ENU
(East-North-Up)Non-Earth Referenced
Set Frame Type to one of these values when you set
Coordinate Type to Geodetic
:
Local NED
(North-East-Down)Local ENU
(East-North-Up)
For more information, see Reference frame.
Set Target Extent to one of these values:
Point
— Represent target as a single point in space.Box
— Represent target as a finite-size bounding box.
Set Time Type to one of these values:
Date Time
Duration
For more information, see Time Format.
Export Options
Export the truth data as a trackingScenarioRecording
object. You can use the object for metric
evaluation, or use the play
function to visualize the recordings. You can customize the name of the export object
and define the Coordinate Frame Options by specifying the
Coordinate Type and Frame Type.
Set Coordinate Type to one of these values:
Cartesian
— Represents positions in a three-dimensional space using a set of three numerical values, denoted as (x, y, z).Geodetic
— Represents positions on the Earth's surface using a set of values that include latitude, longitude, and optionally altitude.
For more information, see Coordinate system.
Set Frame Type to one of these values when you set
Coordinate Type to Cartesian
:
Frame Type | Comment |
---|---|
ECEF (Earth-Centered, Earth-Fixed) | Applies when the converter is earth referenced. |
Fixed NED (North-East-Down) | Applies when the converter is earth referenced. |
Fixed ENU (East-North-Up) | Applies when the converter is earth referenced. |
Non-Earth Referenced | Applies when the converter is a non-earth referenced custom converter. |
Ego | Applies when the converter is a driving converter. |
Set Frame Type to one of these values when you set
Coordinate Type to Geodetic
:
Local NED
(North-East-Down)Local ENU
(East-North-Up)
For more information, see Reference frame.
Export the truth data as a tuning data structure for tuning tracking filters. The
tuning data consists of a cell array of timetables. Each timetable saves the time,
position, velocity, acceleration, orientation, angular velocity, and angular
acceleration for a specific platform. You can use the truth tables as inputs for the
tune
function. You can customize the name of the export tuning data and define the
Coordinate Frame Options by specifying the Coordinate
Type and Frame Type.
Set Coordinate Type to one of these values:
Cartesian
— Represents positions in a three-dimensional space using a set of three numerical values, denoted as (x, y, z).Geodetic
— Represents positions on the Earth's surface using a set of values that include latitude, longitude, and optionally altitude.
For more information, see Coordinate system.
Set Frame Type to one of these values when you set
Coordinate Type to Cartesian
:
Frame Type | Comment |
---|---|
ECEF (Earth-Centered, Earth-Fixed) | Applies when the converter is earth referenced. |
Fixed NED (North-East-Down) | Applies when the converter is earth referenced. |
Fixed ENU (East-North-Up) | Applies when the converter is earth referenced. |
Non-Earth Referenced | Applies when the converter is a non-earth referenced custom converter. |
Ego | Applies when the converter is a driving converter. |
Set Frame Type to one of these values when you set
Coordinate Type to Geodetic
:
Local NED
(North-East-Down)Local ENU
(East-North-Up)
For more information, see Reference frame.
Export the truth data as a truth log structure array for metric evaluation. You
can use the truth log as input for the trackOSPAMetric
and trackGOSPAMetric
System
objects. You can customize the name of the export truth log and define the
Coordinate Frame Options by specifying the Coordinate
Type and Frame Type.
Set Coordinate Type to one of these values:
Cartesian
— Represents positions in a three-dimensional space using a set of three numerical values, denoted as (x, y, z).Geodetic
— Represents positions on the Earth's surface using a set of values that include latitude, longitude, and optionally altitude.
For more information, see Coordinate system.
Set Frame Type to one of these values when you set
Coordinate Type to Cartesian
:
Frame Type | Comment |
---|---|
ECEF (Earth-Centered, Earth-Fixed) | Applies when the converter is earth referenced. |
Fixed NED (North-East-Down) | Applies when the converter is earth referenced. |
Fixed ENU (East-North-Up) | Applies when the converter is earth referenced. |
Non-Earth Referenced | Applies when the converter is a non-earth referenced custom converter. |
Ego | Applies when the converter is a driving converter. |
Set Frame Type to one of these values when you set
Coordinate Type to Geodetic
:
Local NED
(North-East-Down)Local ENU
(East-North-Up)
For more information, see Reference frame.
Export the converted table. You can customize the name of the export table.
Export a TrackingTruthDataImporter
object. You can use the object for batch
converting tracking data belonging to the same format. You can customize the name of
the export object and define the Coordinate Frame Options by
specifying the Coordinate Type and Frame
Type.
Set Coordinate Type to one of these values:
Cartesian
— Represents positions in a three-dimensional space using a set of three numerical values, denoted as (x, y, z).Geodetic
— Represents positions on the Earth's surface using a set of values that include latitude, longitude, and optionally altitude.
For more information, see Coordinate system.
Set Frame Type to one of these values when you set
Coordinate Type to Cartesian
:
Frame Type | Comment |
---|---|
ECEF (Earth-Centered, Earth-Fixed) | Applies when the converter is earth referenced. |
Fixed NED (North-East-Down) | Applies when the converter is earth referenced. |
Fixed ENU (East-North-Up) | Applies when the converter is earth referenced. |
Non-Earth Referenced | Applies when the converter is a non-earth referenced custom converter. |
Ego | Applies when the converter is a driving converter. |
Set Frame Type to one of these values when you set
Coordinate Type to Geodetic
:
Local NED
(North-East-Down)Local ENU
(East-North-Up)
For more information, see Reference frame.
Programmatic Use
More About
Version History
Introduced in R2025a