Target.FileLog

R2026b

Target Computer file logger

Description

A Target.FileLog object represents the file logger that runs on a Speedgoat^® target computer and provides access to methods and properties related to the file logger.

The object provides access to methods and properties that:

• Import file log data.

• Check for available file log data.

• Discard unwanted file log data.

Function names are case-sensitive. Type the entire name. Property names are not case-sensitive. You do not need to type the entire name if the characters you type are unique for the property.

Creation

A Target.FileLog object is created when you create a Target object by using the slrealtime command. After you create and connect to the Target object, you can access the Target.FileLog object. This example creates and connects to Target object tg, and then starts the file logger on the target computer.

tg = slrealtime('TargetPC1');
connect(tg);
% tg.FileLog object is created

Properties

Importing — File log import status

0 (not importing) (default) | 1 (importing)

The Importing property indicates whether the file logger is importing a file log. The file logger imports file log data at the end of simulation runs. You can disable the import by setting the Disable automatic import of file logs option for the real-time application. For more information, see the start function.

Note

The Importing property will be removed in a future release.

Example: 0

LoggingService — File logging service status

STARTING (default) | RUNNING | STOPPING | STOPPED | ERROR

The LoggingService property indicates the file logging service status.

Example: 100

DataAvailable — File log data available status

0 (no data available) (default) | 1 (data available)

The DataAvailable property indicates whether file log data is available for import.

Example: 0

Object Functions

discard	Delete file log data from target computer
list	Get information about available file logs of signal data
import	Import file log data from target computer to the Simulation Data Inspector
openImportDialog	Get information about available file logs of signal data

Examples

Discard File Log Data for Applications

For target computer object tg with simulation run data available for real-time applications, delete file log data for applications.

1. Get table of available simulation run information. Delete file log data from applications in the available file logs table.

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

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

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

Version History

Introduced in R2020b

R2022b: Removed Importing property

The Importing property of the Target.FileLog object is removed. An error appears when you use this property.

R2021b: Synchronous Processing for File Log Import

The operation of the Target.FileLog object has changed. Now, the file log import process is synchronous in MATLAB, which means that while data import is occurring, the MATLAB status is busy. The abort function has been removed. The ImportProgress property has been removed.