getAsDatastore

Get matlab.io.datastore.sdidatastore representation of signal in referenced Simulation Data Inspector run

Syntax

[element,name,idx] = getAsDatastore(dsr,searchIdx)

[element,name,idx] = getAsDatastore(dsr,searchName)

Description

[element,name,idx] = getAsDatastore(dsr,searchIdx) returns a matlab.io.datastore.sdidatastore object, along with the element name and index, for the signal specified by the index searchIdx in the Simulation Data Inspector run referenced by the Simulink.sdi.DatastoreRef object dsr.

[element,name,idx] = getAsDatastore(dsr,searchName) returns a matlab.io.datastore.sdidatastore representation for one or more signals specified by searchName.

Examples

Create sdidatastore Object for Signal in Simulink.sdi.DatasetRef Object

To create a run of logged signals, simulate the model sldemo_fuelsys.

sim("sldemo_fuelsys")

Use the Simulink.sdi.Run.getLatest function to get the latest run.

fuelRun = Simulink.sdi.Run.getLatest;

Create a Simulink.sdi.DatasetRef object that references fuelRun.

DSRef_fuelRun = getDatasetRef(fuelRun);

Get the names of the elements in the DatasetRef object.

DSRnames = getElementNames(DSRef_fuelRun)

DSRnames = 16x1 cell
    {'CheckRange'                   }
    {'air_fuel_ratio'               }
    {'speed'                        }
    {'map'                          }
    {'ego'                          }
    {'throttle'                     }
    {'fuel'                         }
    {'EGO Fault Switch:1'           }
    {'Engine Speed Fault Switch:1'  }
    {'MAP Fault Switch:1'           }
    {'Throttle Angle Fault Switch:1'}
    {'ego_sw'                       }
    {'engine_speed'                 }
    {'speed_sw'                     }
    {'map_sw'                       }
    {'throttle_sw'                  }

Get an sdidatastore object for the fuel signal. The sdidatastore object exists in the Values property of the returned Simulink.SimulationData.Signal object.

[fuel_ds,name,idx] = getAsDatastore(DSRef_fuelRun,"fuel")

fuel_ds = 
  Simulink.SimulationData.Signal
  Package: Simulink.SimulationData

  Properties:
              Name: 'fuel'
    PropagatedName: ''
         BlockPath: [1x1 Simulink.SimulationData.BlockPath]
          PortType: 'outport'
         PortIndex: 1
            Values: [1x1 matlab.io.datastore.sdidatastore]

name = 
'fuel'

idx = 
7

Input Arguments

dsr — Run from which to get signal data

Simulink.sdi.DatasetRef object

Run from which to get signal data, specified as a Simulink.sdi.DatasetRef object.

searchIdx — Index of signal

positive integer

Index of signal in the Simulation Data Inspector run referenced by dsr to get as sdidatastore representation, specified as a positive integer.

Example: 3

searchName — Name of signal

string | character vector

Name of signal to get as sdidatastore representation, specified as a string or character vector.

Example: "MySignal"

Output Arguments

element — sdidatastore representation of signal from Simulation Data Inspector run

object whose Values parameter contains matlab.io.datastore.sdidatastore object

sdidatastore representation of signal from Simulation Data Inspector run, returned as an object whose Values parameter contains a matlab.io.datastore.sdidatastore object, such as a Simulink.SimulationData.Dataset, Simulink.SimulationData.Signal, Simulink.SimulationData.State, or similar object.

name — Element name

character vector

Element name, returned as a character vector.

idx — Element index

positive integer

Element index in the Simulation Data Inspector run referenced by the Simulink.sdi.DatasetRef object, returned as a positive integer.

Alternatives

You can construct a sdidatastore object for a specified signal using a matlab.io.datastore.sdidatastore object.

Version History

Introduced in R2017b