This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

Log Signal Data That Uses Units

To have logged data include the units specified for signals, use the Dataset or Timeseries logging format, which stores logging information in MATLAB® timeseries objects.

Signal logging uses Dataset format. Output logging (Configuration Parameters > Data Import/Export > Output) uses Dataset as the default format. The default save format for the To File and To Workspace blocks is Timeseries.

If you use Dataset or Timeseries format for signal logging or for To File block or To Workspace block logging, the logged data includes units information.

To capture units information for output logging:

  1. Set the Format configuration parameter to Dataset.

  2. In the Block Parameters dialog box for Outport blocks for which you want to capture units information, set the Unit parameter to match the units of the input signal.

For example, in this model the In1 block has its Unit parameter set to newton and In2 block uses m (meters). Open the model. After you simulate the model, you can see the units for the logged data.

  • You can view the units in the signal logging data for signal1 of the bus signal b.

    logsout.get('a').Values.signal1.DataInfo
    tsdata.datametadata
      Package: tsdata
    
      Common Properties:
                   Units: newton (Simulink.SimulationData.Unit)
           Interpolation: linear (tsdata.interpolation)
    
  • You can view the units in the data logged in the To Workspace block.

     simout1.signal2.DataInfo.Units
    
    ans = 
    
      Units with properties:
    
        Name: 'm'

This example model shows how to view the data logged in a Time Scope block. Open the model.

To use the Time Scope block to log data, in the scope select Configuration Properties > Logging > Log data to workspace and specify a variable (ScopeData in this example). The In3 block uses m (meters). Simulate the model and then at the MATLAB command line, enter:

ScopeData.get(1).Values.DataInfo.Units
ans = 

  Units with properties:

    Name: 'm'

Related Examples

More About