信号标签传播

您可以为信号命名并配置信号在 Simulink^® 模型中传播信号名称，以跟踪通过一个或多个模块的信号。要查看支持的模块列表，请参阅支持信号标签传播的模块。

为信号命名并对允许的模块的输出信号启用信号标签传播显示时：

如果存在 Simulink 可以传播的用户指定的信号名称，则传播的信号标签会将该名称包括在尖括号中（例如 <sig1>）。
如果没有可传播的名称，Simulink 将为该标签显示一对空的尖括号 (<>)。

Simulink 不传播注释掉的模块的信号标签。

例如，在下面的模型中，为 Subsystem 模块的输出信号配置了信号标记传播。传播的信号标签 (<const>) 基于 Constant 模块的上游输出信号的名称 (const)。

Simulink propagates subsystem input signal label to the subsystem output signal

有关 Simulink 如何创建传播的信号标签的详细信息，请参阅 Simulink 如何传播信号标签。

支持信号标签传播的模块

您可以为几个连接模块（这种模块在模型中传输信号但不改变数据）的输出信号使用信号标记传播功能。连接模块不执行任何信号转换。

此外，Model 模块支持信号标签传播。

支持信号标记传播的连接模块包括：

Enable
From
Function-Call Split
Goto
Inport（仅子系统；非模型输入端口）
Signal Specification
Subsystem（通过子系统 Inport 和 Outport 模块）
Trigger

Bus Creator 和 Bus Selector 模块不支持信号标签传播。但是，要查看任何总线的层次结构，请使用View Bus Hierarchy。

信号的“信号属性”对话框会指示该信号是否支持信号标签传播。显示传播的信号参数仅对支持信号标签传播的模块可用。有关详细信息，请参阅显示传播的信号标签。

Simulink 如何传播信号标签

通常，Simulink 会针对以下目标或情形一致地执行信号标签传播：

不同的建模结构（例如，非总线和总线信号、虚拟和非虚拟总线、子系统和模型变体、模型引用以及库）
在包含或不包含隐藏模块的模型中（Simulink 会在某些情况下插入隐藏模块以实现仿真）
在执行模型加载、编辑、更新和仿真时

有关某些特殊情况的信息，请参阅：

一般信号标签传播的处理过程

通常，当您为模块（例如，BlockA）的输出信号启用信号标签传播后，Simulink 将完成以下处理过程，以查找要传播的源信号名称：

检查输出信号连接到 BlockA 的模块，如有必要，继续检查上游模块，从最近的模块向最远的模块依次执行。
在遇到符合以下任一条件的模块时停止：
- 支持信号标签传播并具有信号名称
- 不支持信号标签传播
获取 Simulink 停止时遇到的模块的输出信号的信号名称（如果有）。
使用该信号名称作为启用了信号标签传播的下游模块的任何输出信号的传播的信号标签。

例如，在下面的模型中，假设您为 Subsystem 模块的输出信号（即，连接 Out1 端口的信号）启用了信号标签传播。

Model showing signal label propagation for output signal of a subsystem which is at the root level of the model

Contents inside the subsystem which is at the root level of the model

Simulink 在该子系统内从 From 和 GoTo 模块（支持信号标签传播但没有名称）往上游检查，然后继续往上游检查到 Constant 模块（不支持信号标签传播）。

Simulink 使用 Constant 模块的输出信号的信号名称 const。Subsystem 模块输出信号的传播的信号标签是 <const>。

Simulink propagates subsystem input signal label to the subsystem output signal

如果 Constant 模块的输出信号没有信号名称，则传播的信号标签将是一对空的尖括号 (<>)。

Simulink does not assign any label to the subsystem output signal when you do not assign any label to subsystem input signal

假设您在 Subsystem 模块中为 In1 模块的输出信号启用了信号标签传播，并使用“信号属性”对话框为 From 模块的输出信号指定了信号名称 const-from，如下所示。

Assign signal name to the subsystem output signal using Signal Properties dialog box

为 Subsystem 模块输出信号传播的信号标签将更改为 <const-from>，因为这是 Simulink 在信号标签传播处理过程中遇到的第一个具有名称的信号。

Signal label from inside the subsystem propagates to the signal connected to the subsystem output port at the root level of the model

在下面的模型中，Subsystem 模块输出信号的信号标签传播使用信号名称 bus1，这是 Bus Creator 模块的输出总线的名称。传播的信号标签不包含总线元素信号（a 和 b）的名称。

Simulink propagates subsystem input bus label to the subsystem output bus

显示传播的信号标签

您可以显示模型中单个信号的传播信号标签，也可以显示模型中所有信号的传播信号标签。要显示所有信号的标签，请在 Simulink 编辑器中，在调试选项卡上，选择叠加信息 > 传播的信号标签。

要显示单个信号的传播信号标签，请执行下列操作：

右键点击要显示传播的信号标签的信号，然后选择属性。
在“信号属性”对话框中，选择显示传播的信号。
显示传播的信号参数仅对支持信号标签传播的模块的输出信号可用。

要以编程方式将信号配置为显示其传播的名称，请使用 set_param 函数为与生成信号的模块输出端口对应的端口句柄指定 ShowPropagatedSignals 属性的值。例如，为模型 MyModel 中 Subsystem 模块 Subsystem 的第一个输出端口上的输出信号启用信号标签传播：

使用 get_param 函数获取模块的端口句柄。

portHandles = get_param("MyModel/Subsystem","PortHandles");

通过索引访问第一个输出端口的句柄。模块端口句柄以结构体形式返回，该结构体包含模块可能具有的每种端口类型的字段。
```
outport1 = portHandles.Outport(1);
```
使用 set_param 函数将输出端口的 ShowPropagatedSignals 参数值指定为 on。
```
set_param(outport1,ShowPropagatedSignals="on")
```