Use Scenarios and Insert Signals in Signal Editor

Use Scenarios to Group and Organize Inputs

Signal Editor uses scenarios to group and organize sets of inputs to be saved to a MAT-file for a single simulation. To create signal data using existing data sets from existing scenarios, or create an empty scenario into which to add signals, use the Signal Editor Scenario menu.

Action Option

Action	Option
To create a scenario from the root inports of a model	Select Scenario > Scenario from Model. (Available only when accessing Signal Editor from the Root Inport Mapper.) You can also use the `signaleditor` function with a model argument. Note When using this option, the resulting scenario contains signals with the data types and dimensions of the inport ports.
To create an empty scenario and create signals from scratch	Select Scenario > Blank Scenario.
To import scenarios from MATLAB^® workspace	Select Scenario > From Workspace.

To create a scenario from the root inports of a model

Select Scenario > Scenario from Model. (Available only when accessing Signal Editor from the Root Inport Mapper.)

You can also use the signaleditor function with a model argument.

Note

When using this option, the resulting scenario contains signals with the data types and dimensions of the inport ports.

To create an empty scenario and create signals from scratch

Select Scenario > Blank Scenario.

To import scenarios from MATLAB^® workspace

Select Scenario > From Workspace.

After you have your scenario:

To begin inserting signals, use the other options in the Insert section. For more information, see Create Signals and Signal Data.
To change the signal order in the hierarchy or change the name of a signal, see Change Signal Names and Hierarchy Orders.

Link in Signal Data from Signal Builder Block and Simulink Design Verifier Environment

You can use Signals > Edit MAT-File to link in MAT-file data from these sources for editing.

Signal Builder blocks.
Simulink^® Design Verifier™.

Link in Data from Signal Builder

You can link in and edit data exported from the Signal Builder block in a MAT-file or MATLAB. Use one of these methods to export the data:

Signal Builder block File > Export Data > To MAT-file option, then link in the MAT-file.
signalbuilder get function with data sets, then perform either of these steps:
- Import the data sets in the workspace and save to a MAT-file
- Save the data sets in the workspace to a MAT-file and import the MAT-file

For more information on exporting from a Signal Builder block, see Exporting Signal Group Data.

Link in Test Vectors from Simulink Design Verifier Environment

You can link in and edit Simulink Design Verifier test vectors. This workflow requires a Simulink Design Verifier license.

Before linking in, use the Simulink Design Verifier sldvsimdata (Simulink Design Verifier) function to convert a Simulink Design Verifier test structure to a set of Simulink.SimulationData.Dataset objects. This file contains a test vector structure sldvData. Save the output to a MAT-file and then import that file into Signal Editor.

Insert Signals

To insert signals into scenarios, select the scenario, then click a signal type from the Insert section.

Signal
Use the Signal split button to specify how you want to define the signal data:
- Blank Signal — Add signal data directly into a table (see Work with Basic Signal Data).
- Author Signal — Author signal data using signal notations and variables (Create Signals with MATLAB Expressions and Variables).
Bus
Ground
Function Call
If you need a function-call signal for a root inport with explicit periodic sample time, insert a ground signal instead. Simulink then executes the function-call automatically.

The new signals appear in the Scenarios and Signals section.

You can also insert multiple signals of the same type. For more information, see Create Signals with the Same Properties.

To change the signal order in the hierarchy or change the name of a signal, see Change Signal Names and Hierarchy Orders.

To edit the properties of a signal:

For tabular editing, see Work with Basic Signal Data with a Tabular Editor.
To replace the signal data or edit the signal notation using MATLAB expressions, see Replace Signal Data with MATLAB Expressions.

Add Signals to Scenarios

This example describes how to create a scenario to be linked to from the Root Inport Mapper tool. You can then start the Signal Editor to manipulate and add signals to this scenario.

In the MATLAB Command Window, create some data by typing:
```
ts = timeseries([0;20],[0;10]); 
```
In Simulink Editor, create a model that contains three Inport blocks, three Gain blocks, a Mux block, and a Scope block. Connect these blocks as shown:
Set the gain for the Gain blocks to 5, 10, and 15, respectively.
Click one of the Inport blocks, then click the Connect Input button.
The Root Inport Mapper tool displays.
In Root Inport Mapper Link section, select From Workspace.
In the From Workspace window, enter a name to store the MAT-file, then click OK.
In the Scenario section of the Signal Editor, click Signals > Edit MAT-File.
In the Edit Signal File window, select the new MAT-file and click OK.
The Signal Editor displays.
Add a signal, Signal, to the scenario. Right-click the scenario and select Insert > Blank Signal.
This action adds Signal with these default properties.
Alternatively, insert signals by clicking a signal type from the Insert section or using the Signal split button to author a signal using signal notations.
Change the default properties of signals you want to add. In the Insert section, select Defaults. In the Default Properties for Insertion dialog box, change the data type to boolean, then right-click the scenario and select Insert > Blank Signal.
This action adds Signal1 with the data type boolean.
To check that the data type is boolean, click the plot check box for Signal1.

Documentation