Simulink.TimeInfo

Provide information about time data in Simulink.Timeseries object

Description

Simulink® software creates instances of these objects to describe the time data that it includes in Simulink.Timeseries objects.

Note

The Simulink.Timeseries class is supported for backwards compatibility. The ModelDataLogs format created Simulink.Timeseries objects for signal logging data. Starting in R2016a, you cannot log data in the ModelDataLogs format. Signal logging uses the Dataset format. In R2016a or later, when you open a model from an earlier release that had used ModelDataLogs format, the model simulated in use Dataset format.

You can convert signal logging data from ModelDataLogs to Dataset format. Converting to Dataset format makes it easier to post-process with other logged data (for example, logged states), which can also use Dataset format. For more information, see Convert Logged Data to Dataset Format.

If you have legacy code that uses the ModelDataLogs API, you can encounter situations that require updates to your code or model. See Migrate Scripts That Use Legacy ModelDataLogs API.

Properties

Name

Access

Description

Units

RW

The units, e.g., 'seconds', in which the time series data are expressed in the associated Simulink.Timeseries object.

Start

RW

If the associated signal is not in a conditionally executed subsystem, this field contains the simulation time of the first signal value recorded in the associated Simulink.Timeseries object. If the signal is in a conditionally executed subsystem, this field contains an array of times when the system became active.

end

RW

If the associated signal is not in a conditionally executed subsystem, this field contains the simulation time of the last signal value recorded in the associated Simulink.Timeseries object. If the signal is in a conditionally executed subsystem, this field contains an array of times when the system became inactive.

Increment

RW

The interval between simulation times at which signal data is logged in the associated Simulink.Timeseries object. If the signal is aperiodic (continuous signal with variable-step solver), this property has a value of NaN. A signal is periodic if it has a discrete sample time (not continuous or constant) or is continuous with a fixed-step solver.

Length

W

The number of signal samples recorded in the associated Simulink.Timeseries object, i.e., the length of the arrays referenced by the object's Time and Data properties.

Introduced before R2006a