Simulink.TsArray (Simulink Reference)

Log composite virtual signals

Description

Simulink creates instances of this class to contain the data that it logs for a composite virtual signal, e.g., the output of a Mux or of a virtual Bus Creator block (see Logging Signals in the "Working with Signals" chapter of Using Simulink). Objects of the Simulink.TsArray class have a variable number of properties. The first property, called Name, specifies the log name of the composite signal. The remaining properties reference logs (i.e., Simulink.Timeseries objects) for the elements of the composite signal. The name of each property is the log name of the corresponding signal.

Consider, for example, the following model.

This model specifies that Simulink should log the values of the composite signal m2 during simulation. After simulation of this model, the MATLAB workspace contains a Simulink.ModelDataLogs object, named logsout, that contains a Simulink.TsArray object, named m2, that contains the logs for the elements of m2, i.e., for the elementary signals x1, x2, and x3. Entering the fully qualified name of the Simulink.TsArray object, i.e., logsout.m2, at the MATLAB command line reveals the structure of the signal log for this model.

>> logsout.m2
Simulink.TsArray:
  Name               Simulink Class

  x1                 Timeseries
  x2                 Timeseries
  x3                 Timeseries

You can use either fully qualified log names or the unpack command to access the signal logs contained by a Simulink.TsArray object. For example, to access the amplitudes logged for signal x1 in the preceding example, you could enter the following at the MATLAB command line:

```
>> data = logsout.m2.x1.Data;
```

>> logsout.unpack('all');
data = x1.Data;

See Also
Simulink.ModelDataLogs, Simulink.Timeseries, unpack

Simulink.Timeseries Model and Block Parameters