信号编辑器

显示、创建、编辑和切换可互换场景。

库：
Simulink / Sources

描述

Signal Editor 模块显示、创建和编辑可互换场景。您也可以使用该模块切换模型的场景。

Signal Editor 模块支持包含一个或多个标量 Simulink.SimulationData.Dataset 对象的 MAT 文件。

您可以使用 signalBuilderToSignalEditor 函数将 Signal Builder 模块配置移到 Signal Editor 模块。有关详细信息，请参阅 Replace Signal Builder Block with Signal Editor Block。

要以编程方式获取 Signal Editor 模块中的场景和信号的总数，请使用 get_param NumberOfScenarios 和 NumberOfSignals 属性。这些属性将值存为字符向量。要将这些值转换为双精度值，请使用 str2double 函数。

要以编程方式启用 Signal Editor 模块来标记输出信号线，请将 set_param PreserveSignalName 设置为 'on'（默认值）。例如：

set_param(gcb,'PreserveSignalName','on')

快速重启

Signal Editor 模块支持快速重启。启用快速重启后，您仍可以：

更改激活场景。
更改活动信号。
虽然您可以更改活动信号，但无法编辑模块中的信号属性。
启动信号编辑器用户界面并编辑数据。

示例

Parallel Simulations Using Parsim: Test-Case Sweep

Run multiple Simulink® simulations corresponding to different test cases in the Signal Editor block using SimulationInput objects and the parsim command. The parsim command uses Parallel Computing Toolbox™, if it is available, to run simulations in parallel, otherwise the simulations are run in serial.

打开模型

Parallel Simulations Using Parsim: Parameter Sweep in Rapid Accelerator Mode

Run multiple simulations of a Monte Carlo study in parallel by using Parallel Computing Toolbox™. Parallel execution leverages the multiple cores of your host machine to run many simulations more quickly. These simulations could also be run in parallel on computer clusters using the MATLAB Parallel Server™. This example will work even if the Parallel Computing Toolbox™ or the MATLAB Parallel Server™ is not available, but the simulations will run in serial.

打开模型

限制

Signal Editor 模块不支持：

函数调用
接地信号

Signal Editor 模块支持动态字符串。它不支持具有最大长度的字符串。此外，Signal Editor 模块中的字符串无法输出：

非标量 MATLAB 字符串。
包含缺失值的字符串数据。
包含非 ASCII 字符的字符串数据。

端口

输出参数

全部展开

Signal1 — 场景中的信号
多维

一个或多个信号，可以是：

MATLAB^® timeseries 对象
MATLAB timeseries 对象的结构体
二维矩阵

端口标签取决于数据集 MAT 文件中相关联的变量。

参数

全部展开

文件名 — 数据集文件
`untitled.mat` （默认） | 字符向量

数据集文件，指定为字符向量，包含一个或多个标量 Simulink.SimulationData.Dataset 对象。不要将一个区域设置中的文件名用于其他区域设置。当在多个平台上使用该模块时，考虑只指定 MAT 文件名并使 MAT 文件位于 MATLAB 路径中。

依存关系

如果当前文件夹中不存在 untitled.mat，下列参数将被禁用：
- 激活场景
- 信号
- 输出总线信号
- 单位
- 采样时间
- 数据插值
- 启用过零检测
- 最终数据值之后的输出
要创建 MAT 文件，请点击。此按钮启动信号编辑器用户界面，该界面允许您创建和编辑场景 MAT 文件。

编程用法

模块参数：Filename

类型：字符向量

值：字符向量

默认值：'untitled.mat'

激活场景 — 激活场景
`Scenario` （默认） | 字符向量

激活场景，指定为字符向量。指定的 MAT 文件必须存在。您可以根据需要切换激活场景。

依存关系

要启用此参数，请确保指定的 MAT 文件存在。

编程用法

模块参数：ActiveScenario

类型：字符向量 | 数值

值：字符向量 | 索引值

默认值：'Scenario'

要创建和编辑场景，请启动信号编辑器用户界面 — 启动信号编辑器
按钮点击

要启动信号编辑器用户界面，请点击。

活动信号 — 要配置的信号
`Signal 1` （默认） | 字符向量

要配置的信号，指定为信号名称。此信号被视为活动信号。在配置信号之前，MAT 文件必须存在。

要启用此参数，请确保指定的 MAT 文件存在。

提示

不要使用 set_param 函数将活动信号属性名称-值参数 ('ActiveSignal') 与 Signal Editor 模块的另一个名称-值对组参数组合设置。

编程用法

模块参数：ActiveSignal

类型：字符向量 | 数值

值：字符向量 | 索引向量

默认值：'Signal 1'

输出总线信号 — 将信号配置为总线
off （默认） | on

将信号配置为总线：

On: 将信号配置为总线。
Off: 不要将信号配置为总线。

指定的 MAT 文件必须存在。

提示

仅当活动信号是字段与现有总线对象相同的 MATLAB 结构体时，或在创建新的匹配总线对象时，才选中此复选框。如果对不是 MATLAB 结构体的活动信号选中此复选框，仿真将返回错误。

依存关系

选中输出总线信号复选框将启用选择总线对象参数。
要启用此参数，请确保指定的 MAT 文件存在。

编程用法

模块参数：IsBus

类型：字符向量

值：'off' | 'on'

默认值：'off'

选择总线对象 — 总线对象
`Bus: BusObject` （默认） | 总线对象名称

选择或输入总线对象名称。要使用数据类型助手编辑或创建总线对象，请点击 >>。活动信号必须为 MATLAB 结构体，其字段与此总线对象相同。指定的 MAT 文件必须存在。

依存关系

要启用此参数，请确保指定的 MAT 文件存在。

编程用法

模块参数：OutputBusObjectStr

类型：字符向量

值：总线对象名称

默认值：'Bus: BusObject'

模式 — 总线对象模式
`Bus Object` （默认） | 总线对象数据类型

选择总线对象名称。如果您没有总线对象，请点击编辑创建一个，这将启动类型编辑器。有关详细信息，请参阅创建并指定 Simulink.Bus 对象。

单位 — 物理单位
继承（默认） | 支持的物理单位

信号的物理单位，指定为允许的单位。要指定单位，请在文本框中键入需要的值。随着您的键入，参数将显示可能匹配的单位。有关详细信息，请参阅 Simulink 模型中的单位指定。有关支持的单位列表，请参阅允许使用的单位制。

要约束单位制，请点击参数右侧的链接：

如果组件中存在 Unit System Configuration 模块，将打开其对话框。使用该对话框为组件指定允许和不允许使用的单位制。
如果组件中不存在 Unit System Configuration 模块，将显示模型的“配置参数”对话框。使用该对话框为模型指定允许和不允许使用的单位制。

指定的 MAT 文件必须存在。

依存关系

要启用此参数，请确保指定的 MAT 文件存在。

编程用法

模块参数：Unit

类型：字符向量

值：'inherit' | 支持的物理单位

默认值：'inherit'

采样时间 — 采样时间间隔
`0` （默认） | `-1` | 采样时间（秒）

采样之间的时间间隔，以秒为单位指定。指定的 MAT 文件必须存在。

依存关系

要启用此参数，请确保指定的 MAT 文件存在。

编程用法

模块参数：SampleTime

类型：字符向量

值：-1 | 采样时间（秒）

默认值：'0'

数据插值 — 数据线性插值
off （默认） | on

在不存在对应工作区数据的时间点对数据进行线性插值。指定的 MAT 文件必须存在。

信号编辑器模块执行线性插值：

On: 如果在不存在对应工作区数据的时间点进行线性插值，请选择此选项。
Off: 当前输出等于存在数据的最近时间的输出。

信号编辑器模块使用两个对应的工作区样本进行插值：

对于 double 数据，使用两个对应样本进行线性插值
对于 Boolean 数据，对两个时间值之间的前半部分时间使用 false，对后半部分时间使用 true
对于除 double 或 Boolean 之外的内置数据类型：
- 将数据向上转换为 double
- 执行线性内插（如针对 double 数据情形所述）
- 将插入的值向下转换为原始数据类型

不能将线性插值与枚举 (enum) 数据结合使用。

该模块使用最后一个已知数据点的值作为最后一个已知数据点之后出现的时间点的值。

要确定有可用数据的最后一个时间点之后的模块输出，请结合使用以下参数设置：

数据插值
最终数据值之后的输出

有关详细信息，请参阅最终数据值之后的输出参数。

依存关系

要启用此参数，请确保指定的 MAT 文件存在。

编程用法

模块参数：Interpolate

类型：字符向量

值：'off' | 'on'

默认值：'off'

启用过零检测 — 检测过零点
off （默认） | on

如果您选择启用过零检测参数，然后输入数组包含同一时间点的多个条目，则 Simulink^® 进行过零检测。例如，假设输入数组具有以下数据：

time:     0 1 2 2 3
signal:   2 3 4 5 6

在时间 2 处，存在由于输入信号不连续而产生的一个过零点。有关详细信息，请参阅过零检测。

对于总线信号，Simulink 将跨所有叶节点总线元素进行过零检测。

指定的 MAT 文件必须存在。

依存关系

要启用此参数，请确保指定的 MAT 文件存在。

编程用法

模块参数：ZeroCross

类型：字符向量

值：'off' | 'on'

默认值：'off'

最终数据值之后的输出 — 数据可用的最后一个时间点后的模块输出
`Setting to zero` （默认） | `Extrapolation` | `Holding final value`

要确定有可用工作区数据的最后一个时间点之后的模块输出，请结合使用以下参数设置：

数据插值
最终数据值之后的输出

下表列出了基于两个选项的值的模块输出。

最终数据值之后的输出的设置	数据插值的设置	最终数据之后的模块输出
外插	On	根据最终数据值外插
外插	关闭	错误
设置为零	On	零
设置为零	关闭	零
保持最终值	On	工作区中的最终值
保持最终值	关闭	工作区中的最终值

例如，如果您执行下列操作，模块将使用最后两个已知数据点对出现在最后一个已知点后的数据点进行外插：

选择数据插值。
将最终数据值之后的输出设置为“外插”。

指定的 MAT 文件必须存在。

依存关系

要启用此参数，请确保指定的 MAT 文件存在。

编程用法

模块参数：OutputAfterFinalValue

类型：字符向量

值：'Setting to zero' | 'Extrapolation' | 'Holding final value'

默认值：'Setting to zero'

模块特性

数据类型	`Boolean` \| `bus` \| `double` \| `enumerated` \| `fixed point` \| `half` \| `integer` \| `single` \| `string`
直接馈通	`否`
多维信号	`是`
可变大小信号	`否`
过零检测	`是`

扩展功能

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

不建议用于生产代码。

PLC 代码生成
使用 Simulink® PLC Coder™ 生成结构化文本代码。

定点转换
使用 Fixed-Point Designer™ 设计和仿真定点系统。

版本历史记录

在 R2017b 中推出

另请参阅

Signal Builder | signalEditor | signalBuilderToSignalEditor | str2double

信号编辑器

描述

快速重启

示例

Parallel Simulations Using Parsim: Test-Case Sweep

Parallel Simulations Using Parsim: Parameter Sweep in Rapid Accelerator Mode

限制

端口

输出参数

Signal1 — 场景中的信号 多维

参数

文件名 — 数据集文件 untitled.mat （默认） | 字符向量

依存关系

编程用法

激活场景 — 激活场景 Scenario （默认） | 字符向量

依存关系

编程用法

要创建和编辑场景，请启动信号编辑器用户界面 — 启动信号编辑器 按钮点击

活动信号 — 要配置的信号 Signal 1 （默认） | 字符向量

编程用法

输出总线信号 — 将信号配置为总线 off （默认） | on

依存关系

编程用法

选择总线对象 — 总线对象 Bus: BusObject （默认） | 总线对象名称

依存关系

编程用法

模式 — 总线对象模式 Bus Object （默认） | 总线对象数据类型

单位 — 物理单位 继承 （默认） | 支持的物理单位

依存关系

编程用法

采样时间 — 采样时间间隔 0 （默认） | -1 | 采样时间（秒）

依存关系

编程用法

数据插值 — 数据线性插值 off （默认） | on

依存关系

编程用法

启用过零检测 — 检测过零点 off （默认） | on

依存关系

编程用法

最终数据值之后的输出 — 数据可用的最后一个时间点后的模块输出 Setting to zero （默认） | Extrapolation | Holding final value

依存关系

编程用法

模块特性

扩展功能

C/C++ 代码生成 使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

PLC 代码生成 使用 Simulink® PLC Coder™ 生成结构化文本代码。

定点转换 使用 Fixed-Point Designer™ 设计和仿真定点系统。

版本历史记录

另请参阅

主题

WeChat

Signal1 — 场景中的信号
多维

文件名 — 数据集文件
`untitled.mat` （默认） | 字符向量

激活场景 — 激活场景
`Scenario` （默认） | 字符向量

要创建和编辑场景，请启动信号编辑器用户界面 — 启动信号编辑器
按钮点击

活动信号 — 要配置的信号
`Signal 1` （默认） | 字符向量

输出总线信号 — 将信号配置为总线
off （默认） | on

选择总线对象 — 总线对象
`Bus: BusObject` （默认） | 总线对象名称

模式 — 总线对象模式
`Bus Object` （默认） | 总线对象数据类型

单位 — 物理单位
继承（默认） | 支持的物理单位

采样时间 — 采样时间间隔
`0` （默认） | `-1` | 采样时间（秒）

数据插值 — 数据线性插值
off （默认） | on

启用过零检测 — 检测过零点
off （默认） | on

最终数据值之后的输出 — 数据可用的最后一个时间点后的模块输出
`Setting to zero` （默认） | `Extrapolation` | `Holding final value`

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

PLC 代码生成
使用 Simulink® PLC Coder™ 生成结构化文本代码。

定点转换
使用 Fixed-Point Designer™ 设计和仿真定点系统。