tuningData

R2026b

Create truth table for tuning from truth data

Since R2025a

collapse all in page

Syntax

tData = tuningData(importer,source1)

tData = tuningData(importer,source1,converterName1,...,sourceN,converterNameN)

[tData,info] = tuningData(___)

Description

tData = tuningData(importer,source1) returns tuning data based on the source input.

example

tData = tuningData(importer,source1,converterName1,...,sourceN,converterNameN) imports multiple sources, each with its specified converter.

[tData,info] = tuningData(___) also returns info, which contains the platform IDs and class IDs mapping tables.

Examples

collapse all

Export Truth Data as `tuningData`

Open Live Script

Load a saved truth TrackingTruthDataImporter object and display the object properties. For more information on the creation of the TrackingTruthDataImporter object, see the Import Data Using Tracking Data Importer App example.

load truthImporterFile.mat;
truthImporter

truthImporter = 
TrackingTruthDataImporter with configurations:

Contained Converters:
     Converter Link     Source Type     Required Columns         
     --------------     -----------     -------------------------     
     FlightLog1         spreadsheet     time, latitude, longitude

Output Data Information: 
      Coordinate Type:  Cartesian
           Frame Type:  ECEF

Usage: 
      trackingScenarioRecording:  Export as a trackingScenarioRecording object for playing and metric evaluation
                       truthlog:  Export as a truth log structure for metric evaluation
                     tuningData:  Export as a tuning data structure for tracking filter turning
                 convertedTable:  Export converted table

Apply the truthImporter object to a flight log named LAToBostonFlightLog.xlsx, to get tuningData.

tuningData(truthImporter,"LAToBostonFlightLog.xlsx")

[07-Aug-2026 01:30:42]: Start importing 'LAToBostonFlightLog.xlsx' with converter 'FlightLog1'.
[07-Aug-2026 01:30:43]: Finish importing 'LAToBostonFlightLog.xlsx' with converter 'FlightLog1'.

ans = 592×7 timetable
     Time      PlatformID                    Position                               Velocity               Acceleration     Orientation      AngularVelocity    AngularAcceleration
    _______    __________    _________________________________________    _____________________________    ____________    ______________    _______________    ___________________

    0 sec          1         -2.5218e+06    -4.6577e+06     3.5416e+06    -77.713     28.953    -7.9217    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    16 sec         1         -2.5231e+06    -4.6572e+06     3.5415e+06    -82.176     34.499    -7.7281    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    32 sec         1         -2.5245e+06    -4.6566e+06     3.5414e+06    -96.133     43.037    -6.7114    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    48 sec         1         -2.5263e+06    -4.6558e+06     3.5413e+06    -105.19     50.628    -1.2789    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    65 sec         1         -2.5282e+06    -4.6549e+06     3.5412e+06    -117.73     46.527    -15.043    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    81 sec         1           -2.53e+06    -4.6544e+06     3.5407e+06    -117.85     12.691    -58.024    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    99 sec         1         -2.5319e+06    -4.6548e+06      3.539e+06    -72.435    -48.246    -105.09    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    116 sec        1         -2.5327e+06    -4.6558e+06     3.5373e+06     -34.67    -75.455    -114.39    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    143 sec        1         -2.5334e+06     -4.658e+06     3.5342e+06    -21.839    -85.468    -117.26    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    173 sec        1         -2.5342e+06    -4.6607e+06     3.5304e+06    -25.746    -83.519    -118.95    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    203 sec        1          -2.535e+06    -4.6631e+06      3.527e+06    -31.983    -81.359    -125.45    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    233 sec        1         -2.5359e+06    -4.6657e+06     3.5229e+06    -19.871    -99.914    -141.51    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    249 sec        1         -2.5359e+06    -4.6677e+06     3.5205e+06     33.803     -126.8     -136.2    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    267 sec        1         -2.5346e+06    -4.6699e+06     3.5185e+06      108.5    -138.29    -97.007    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    288 sec        1         -2.5319e+06    -4.6727e+06      3.517e+06     150.58    -131.16    -57.892    0    0    0     1×1 quaternion      0    0    0          0    0    0    
    323 sec        1         -2.5261e+06    -4.6773e+06     3.5153e+06     172.24     -124.7    -35.015    0    0    0     1×1 quaternion      0    0    0          0    0    0    
      ⋮

Input Arguments

collapse all

`importer` — Tracking truth data importer
`TrackingTruthDataImporter` object

Tracking truth data importer, specified as a TrackingTruthDataImporter object. You can use the Tracking Data Importer app to create these objects.

`source1` — Data source to read
table | timetable | string scalar | character vector | string array | cell array

Data source to read, specified as one of the following:

A string scalar or character vector representing the path to a data file.
A MATLAB^® table or timetable from workspace.
A string array or cell array of character vectors representing paths to multiple data files of the same format.
A cell array of tables or timetables.

For details on the exact format requirements for the file or table, see the display of the importer object.

Example: "./flight_log.csv"

`converterName1` — Name of converter for source
string scalar | character vector

Name of the converter to use for the preceding source, specified as a string scalar or character vector. The converter name must match one of the converters defined in the importer object.

Output Arguments

collapse all

`tData` — Truth tables for tuning purpose
timetable | K-element cell array of timetables

Truth tables, returned as a K-element cell array of time tables. K is the total number of platforms. 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.

`info` — Platform IDs and class IDs mapping information
structure

Platform IDs and class IDs mapping information, returned as a structure that contains two fields:

PlatformIDMapping — Mapping relationship between platform IDs in the source and exported platform IDs, returned as a dictionary object.
ClassIDMapping — Mapping relationship between class IDs in the source and exported class IDs, returned as a dictionary object.

Version History

Introduced in R2025a

expand all

R2026b: Support for multiple source inputs

You can now specify multiple sources with different converters in a single call.

tuningData

Syntax

Description

Examples

Export Truth Data as `tuningData`

Input Arguments

`importer` — Tracking truth data importer
`TrackingTruthDataImporter` object

`source1` — Data source to read
table | timetable | string scalar | character vector | string array | cell array

`converterName1` — Name of converter for source
string scalar | character vector

Output Arguments

`tData` — Truth tables for tuning purpose
timetable | K-element cell array of timetables

`info` — Platform IDs and class IDs mapping information
structure

Version History

R2026b: Support for multiple source inputs

See Also

Apps

Objects

Functions

tuningData

Syntax

Description

Examples

Export Truth Data as tuningData

Input Arguments

importer — Tracking truth data importer TrackingTruthDataImporter object

source1 — Data source to read table | timetable | string scalar | character vector | string array | cell array

converterName1 — Name of converter for source string scalar | character vector

Output Arguments

tData — Truth tables for tuning purpose timetable | K-element cell array of timetables

info — Platform IDs and class IDs mapping information structure

Version History

R2026b: Support for multiple source inputs

See Also

Apps

Objects

Functions

Export Truth Data as `tuningData`

`importer` — Tracking truth data importer
`TrackingTruthDataImporter` object

`source1` — Data source to read
table | timetable | string scalar | character vector | string array | cell array

`converterName1` — Name of converter for source
string scalar | character vector

`tData` — Truth tables for tuning purpose
timetable | K-element cell array of timetables

`info` — Platform IDs and class IDs mapping information
structure