tuningData

Create truth table for tuning from truth data

Since R2025a

Syntax

tData = tuningData(importer,source)

[tData,info] = tuningData(importer,source)

Description

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

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

Examples

Export Truth Data as tuningData

Loads a saved truth TrackingTruthDataImporter object and displays 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:

Converter Name: FlightLog1
Input File Format: spreadsheet
Input Data Information: 
        Category:  Flight Log
      Frame Type:  Local NED

Elements and Mapping: 
     State Element     Unit       Original Column     Unit(Format)                         
     -------------     ------     ---------------     -------------------------------------     
     Date Time         sec        time                datetime string(dd-MMM-yyyy HH:mm:ss)
     Latitude          degree     latitude            degree                               
     Longitude         degree     longitude           degree                               
     Altitude          m          altitude            ft                                   
     Speed             m/s        speed               mi/h                                 
     Course            degree     course              degree                               
     Climb Rate        m/s        climbrate           ft/m                                 

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")

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

    0 sec      -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     -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     -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     -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     -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       -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     -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    -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    -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    -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     -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    -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    -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    -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    -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    -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

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.

source — Data source to read

table | timetable | string scalar | character vector

Data source to read, specified as a string scalar representing the path to a data file, or as a MATLAB table or timetable from workspace.

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

Example: "./flight_log.csv"

Output Arguments

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