setUserString

Class: Simulink.SimulationOutput
Package: Simulink

Store custom character vector in SimulationMetadata object that SimulationOutput object contains

Syntax

simoutNew = simout.setUserString(CustomString)


Description

simoutNew = simout.setUserString(CustomString) assigns a copy of the simout SimulationOutput object to simoutNew. The copy contains CustomString in its SimulationMetadata object.

Input Arguments

simout — Simulation object to get metadata from

object

Simulation object to get metadata from, specified as a SimulationOutput object.

CustomString — Character vector to store in a metadata object

character vector

Any custom character vector you want to store in the metadata object.

Output Arguments

simoutNew — Simulation object that stores metadata object with custom character vector

object

A copy of the simout SimulationOutput object that contains CustomString in its SimulationMetadata object, returned as an object.

Examples

Store a Character Vector in SimulationMetadata Object of vdp Simulation

Simulate the vdp model. Store a custom character vector in the SimulationMetadata object that the SimulationOutput object contains.

Simulate the vdp model. Save the results of the Simulink.SimulationOutput object in simout.

 open_system('vdp')
 simout=sim(bdroot,'ReturnWorkspaceOutputs','on');

Store a character vector to describe the simulation.

simout=simout.setUserString('First Simulation');

Use SimulationOutput.getSimulationMetadata to retrieve the information you stored.

mData=simout.getSimulationMetadata();
disp(mData.UserString)

First Simulation