Main Content


Container for units for simulation data


Simulink.SimulationData.Unit objects store unit information for signals.


For signals with specified units, the software creates Simulink.SimulationData.Unit objects creates when you:

  • Log data in Dataset format.

  • Log data using a To Workspace block or To File block in Timeseries format.

The Simulink.SimulationData.Unit object is stored in the Units property of the timeseries, Simulink.SimulationData.Signal, or similar object used to store logging information. For example, to access the stored unit information for a Signal object named mySig, use dot notation.

ans = 

  Unit with properties:

    Name: 'm'


unitsObj = Simulink.SimulationData.Unit creates an empty Simulink.SimulationData.Unit object.


unitsObj = Simulink.SimulationData.Unit(unitName) creates a Simulink.SimulationData.Unit object with the unit specified by unitName.

Input Arguments

expand all

Name of logging data units, specified as a character vector.

Example: 'inches'


expand all

This property is read-only.

Units name, specified as a character vector.

Object Functions

setNameSpecify name of logging data units


collapse all

Create a Simulink.SimulationData.Unit object representing inches.

inchesUnit = Simulink.SimulationData.Unit('inches');

Create a MATLAB® timeseries object and set its Units property to the Simulink.SimulationData.Unit object.

ts = timeseries(1:10);
ts.DataInfo.Units = inchesUnit
ans = 

  Units with properties:

    Name: 'inches'

Version History

Introduced in R2016a