unpack

(Not recommended) Extract signal data from ModelDataLogs, SubsysDataLogs, or TSArray object into workspace variables

The ability to log and load data using the ModelDataLogs format has been removed. Use another supported format, such as Dataset format, instead. For more information, see Compatibility Considerations.

Syntax

unpack(logs)

unpack(logs,opt)

Description

unpack(logs) extracts the top-level contents of the data logging object logs into one or more workspace variables.

unpack(logs,opt) extracts the contents specified by opt from the data logging object logs into one or more workspace variables.

Input Arguments

logs — Object from which to extract logged data

Simulink.ModelDataLogs object | Simulink.TSArray object | Simulink.SubsysDataLogs object

Object from which to extract logged data, specified as a Simulink.ModelDataLogs object, a Simulink.SubsysDataLogs object, or a Simulink.TSArray object.

opt — Logged data to extract into workspace variables

'systems' | 'all'

Logged data to unpack into workspace, specified as 'systems' or 'all'.

• 'systems' — Extract Simulink.Timeseries and Simulink.TSArray objects from Simulink.ModelDataLogs or Simulink.SubsysDataLogs object. Simulink.Timeseries objects are not extracted from Simulink.TSArray objects, and intermediate Simulink.ModelDataLogs and Simulink.SubsysDataLogs objects are not extracted to the workspace.

• 'all' — Extract Simulink.Timeseries objects from all Simulink.ModelDataLogs, Simulink.SubsysDataLogs, and Simulink.TSArray objects.

Version History

Introduced before R2006a

R2022b: Loading data saved in the ModelDataLogs format no longer supported

Starting in R2022b, you can no longer load data stored in the ModelDataLogs format, including data stored in Simulink.Timeseries, Simulink.TSArray, and Simulink.SubsysDataLogs objects.

You can convert data stored in the ModelDataLogs format to the Dataset format. For more information, see Convert Data to Dataset Format.

R2021a: Loading data saved in the ModelDataLogs format will not be supported

When you load data that uses the ModelDataLogs format as input for simulation, the software issues a warning that support for loading data in the ModelDataLogs format will be removed in a future release.

R2020b: Loading data saved in the ModelDataLogs format will not be supported

In a future release, the ability to load data that uses the ModelDataLogs format as input for simulation will be removed.

R2016a: Logging data using ModelDataLogs format no longer supported

Starting in R2016a, you can no longer log data using the ModelDataLogs format, and signal logging always uses the Dataset format. When you open a model from a previous release that had logged data using ModelDataLogs format, the model configuration parameters are updated to log data using the Dataset format instead.

You can still use and access data logged using the ModelDataLogs format in previous releases, including data in Simulink.SubsysDataLogs, Simulink.TSArray, and Simulink.Timeseries objects. You can also convert data saved in the ModelDataLogs format to the Dataset format, which can simplify data processing. For more information, see Convert Data to Dataset Format.