import

R2026b

Import file log data from target computer to the Simulation Data Inspector

Syntax

import(target_object.FileLog,'app_name')

import(target_object.FileLog,run_info)

import(target_object.FileLog,run_ids)

Description

import(target_object.FileLog,'app_name') imports file log signal data from available simulation runs for the selected real-time application to the Simulation Data Inspector. You can import file log data from the Speedgoat^® target computer when the real-time application is stopped or recording is stopped.

For information about the availability of file logging data, see list.

import(target_object.FileLog,run_info) imports file log signal data for the selected table of available simulation runs. To create the table, use the list function.

import(target_object.FileLog,run_ids) imports file log signal data for the selected simulation runs.

For more information about the file logging workflow, see Real-Time Signal Logging and Streaming Basics.

Examples

Import File Log Data for Application to the Simulation Data Inspector

For target computer object tg with simulation run data available for real-time application my_app, import file log data to the Simulation Data Inspector for the application.

import(tg.FileLog,'app_name')

Import File Log Data for Applications Runs to the Simulation Data Inspector

For target computer object tg with simulation run data available for real-time applications, get available simulation run information, and then import file log data.

1. Get table of available simulation run information. Import file log data from applications runs to the Simulation Data Inspector.

   my_run_info = list(tg.FileLog);
   import(tg.FileLog,my_run_info);

2. Alternatively, you can get the available file log information and import the file log data in one step.

   import(tg.FileLog,tg.FileLog.list);

Import File Log Data for Selected Application Runs to the Simulation Data Inspector

For target computer object tg with simulation run data available for real-time applications slrt_ex_osc_rt_t and slrt_ex_osc, import file log data to the Simulation Data Inspector for selected simulation runs. For more information, see list.

1. Get table of available simulation run information.

   my_run_info = list(tg.FileLog)

   my_run_info = 
   
     3×3 table 
   
                Application             StartDate          Size  
             __________________    ____________________    _____ 
   
       1.    "slrt_ex_osc_rt_t"    12-Dec-2019 21:59:31    94944 
       2.    "slrt_ex_osc_rt_t"    12-Dec-2019 21:59:45    84736 
       3.    "slrt_ex_osc"         12-Dec-2019 21:59:57    82176

2. Import file log data from application runs 1 and 2 in the available file logs table.

   import(tg.FileLog,1:2);

Input Arguments

target_object — Object that represents target computer

Target object

Object that represents target computer, specified as a Target object. The object provides access to methods that manipulate the target computer properties.

Example: tg

app_name — Real-time application MLDATX file name

character vector | string scalar

Real-time application MLDATX file name that you build from the model, specified as a character vector or string scalar.

Example: "slrt_ex_osc"

run_info — Structure of information about file log runs

struct

The run_info structure is a MATLAB table that is structured by Application and RowNames. For information about available log runs, see list.

run_ids — Simulation run ID numbers

vector of rows in available runs table

Identifies the simulation runs to import from the target computer into the Simulation Data Inspector. The run_ids are rows in the available file logging data table. For information about available log runs, see list.

Version History

Introduced in R2020b

R2023b: Import previous file log while recording

In R2023b, you can import a previously stored file log while recording file log data. The change to Simulink Real-Time Explorer is that the Import File Log button remains enabled while recording is active. You also can use the file log import function while recording file log data.

R2022b: Backward Compatibility and Log Retention

The import function imports a file log that was created by the same release of MATLAB as the function.

The import function does not delete the data from the target computer after importing the data.