Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

Signal Editor

显示、创建、编辑和切换可互换方案。

  • 库:
  • Simulink / Sources

  • signal editor block

说明

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 NumberOfScenariosNumberOfSignals 属性。这些属性将值存为字符向量。要将这些值转换为双精度值,请使用 str2double 函数。

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

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

限制

Signal Editor 模块不支持:

  • 函数调用

  • 在 Rapid Accelerator 模式下使用总线

  • 接地信号

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

  • 非标量 MATLAB 字符串。

  • 包含缺失值的字符串数据。

  • 包含非 ASCII 字符的字符串数据。

端口

输出参数

全部展开

一个或多个信号,可以是:

  • MATLAB® timeseries 对象

  • MATLAB timeseries 对象的结构体

  • 二维矩阵

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

数据类型: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | string | Boolean | fixed point | enumerated | bus

参数

全部展开

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

依存关系

  • 如果当前文件夹中不存在 untitled.mat,下列参数将被禁用:

    • Active scenario

    • Signals

    • Output a bus signal

    • Unit

    • Sample time

    • Interpolate data

    • Enable zero-crossing detection

    • Form output after final data value by

  • 要创建 MAT 文件,请点击 。此按钮启动 Signal Editor 用户界面,该界面允许您创建和编辑方案 MAT 文件。

编程用法

模块参数Filename
类型:字符向量
:字符向量
默认值'untitled.mat'

活动方案,指定为字符向量。指定的 MAT 文件必须存在。

依存关系

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

  • 启用快速重启后,您可以:

    • 更改活动方案

    • 更改活动信号

    • 启动 Signal Editor 用户界面并编辑数据

    虽然您可以更改活动信号,但无法编辑模块中的信号属性。

编程用法

模块参数ActiveScenario
类型:字符向量 | 数值
:字符向量 | 索引值
默认值'Scenario'

要启动 Signal Editor 用户界面,请点击

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

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

提示

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

编程用法

模块参数ActiveSignal
类型:字符向量 | 数值
:字符向量 | 索引向量
默认值'Signal 1'

将信号配置为总线:

On

将信号配置为总线。

Off

不要将信号配置为总线。

指定的 MAT 文件必须存在。

提示

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

依存关系

  • 选中 Output a bus signal 复选框将启用 Select bus object 参数。

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

编程用法

模块参数IsBus
类型:字符向量
'off' | 'on'
默认值'off'

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

依存关系

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

编程用法

模块参数OutputBusObjectStr
类型:字符向量
:总线对象名称
默认值'Bus: BusObject'

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

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

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

  • 如果组件中存在 Unit System Configuration 模块,将打开其对话框。使用该对话框为组件指定允许和不允许使用的单位制。

  • 如果组件中不存在 Unit System Configuration 模块,将显示模型的 Configuration Parameters 对话框。使用该对话框为模型指定允许和不允许使用的单位制。

指定的 MAT 文件必须存在。

依存关系

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

编程用法

模块参数Unit
类型:字符向量
'inherit' | 支持的物理单位
默认值'inherit'

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

依存关系

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

编程用法

模块参数SampleTime
类型:字符向量
-1 | 采样时间(秒)
默认值'0'

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

Signal Editor 模块执行线性插值:

On

如果在不存在对应工作区数据的时间点进行线性插值,请选择此选项。

Off

当前输出等于存在数据的最近时间的输出。

Signal Editor 模块使用两个对应的工作区样本进行插值:

  • 对于 double 数据,使用两个对应样本进行线性插值

  • 对于 Boolean 数据,对两个时间值之间的前半部分时间使用 false,对后半部分时间使用 true

  • 对于除 doubleBoolean 之外的内置数据类型:

    • 将数据向上转换为 double

    • 执行线性内插(如针对 double 数据情形所述)

    • 将插入的值向下转换为原始数据类型

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

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

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

  • Interpolate data

  • Form output after final data value by

有关详细信息,请参阅 Form output after final data value by 参数。

依存关系

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

编程用法

模块参数Interpolate
类型:字符向量
'off' | 'on'
默认值'off'

如果您选择 Enable zero-crossing detection 参数,然后输入数组包含同一时间点的多个条目,则 Simulink® 进行过零检测。例如,假设输入数组具有以下数据:

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

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

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

指定的 MAT 文件必须存在。

依存关系

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

编程用法

模块参数ZeroCross
类型:字符向量
'off' | 'on'
默认值'off'

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

  • Interpolate data

  • Form output after final data value by

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

Form Output After Final Data Value By 的设置Interpolate Data 的设置最终数据之后的模块输出

Extrapolation

On

根据最终数据值外插

Off

Error

Setting to zero

On

Off

Holding final value

On

工作区中的最终值

Off

工作区中的最终值

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

  • 选择 Interpolate data

  • Form output after final data value by 设置为 “Extrapolation”。

指定的 MAT 文件必须存在。

依存关系

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

编程用法

模块参数OutputAfterFinalValue
类型:字符向量
'Setting to zero' | 'Extrapolation' | 'Holding final value'
默认值'Setting to zero'

模块特性

数据类型

Boolean | bus | double | enumerated | fixed point | half | integer | single | string

直接馈通

多维信号

可变大小信号

过零检测

扩展功能

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

在 R2017b 中推出