Assignment

为指定的信号元素赋值

库:
Simulink / Math Operations
HDL Coder / Math Operations

描述

Assignment 模块为指定的信号元素赋值。您可以通过在模块对话框中输入索引，或者通过将一个或多个外部索引源连接到模块，来指定要赋值的元素的索引。模块数据端口 U 处的信号指定要赋给 Y 的值。该模块将 Y 的指定元素替换为数据信号的元素。

基于您为输出维度的数量参数输入的值，将显示一个索引选项表。表中的每一行对应于输出维度的数量中的一个输出维度。对于每个维度，您可以定义要使用的信号元素。可将向量信号指定为一维信号，将矩阵信号指定为二维信号。要启用外部索引端口，请在表的对应行中将索引选项设置为索引向量(端口) 或起始索引(端口)。

例如，假设一个 5 维信号具有从 1 开始的索引模式。Assignment 模块对话框中的表将发生变化，使每个维度都有一个对应的行。如果您使用以下选项定义每个维度：

行	索引选项	索引
1	全部赋值
2	索引向量(对话框)	`[1 3 5]`
3	起始索引(对话框)	`4`
4	起始索引(端口)
5	索引向量(端口)

所赋的值为 Y(1:end,[1 3 5],4:3+size(U,3),Idx4:Idx4+size(U,4)-1,Idx5)=U，其中 Idx4 和 Idx5 是维度 4 和 5 的输入端口。

在普通模式下使用 Assignment 模块时，Simulink^® 将模块输出初始化为零，即使模型没有显式初始化它们也是如此。在加速模式下，Simulink 将模型转换成 S-Function。这涉及到代码生成。生成的代码可能不会隐式初始化模块输出。在这种情况下，您必须显式初始化模型输出。

您可以使用模块为向量、矩阵或多维信号赋值。

可使用总线数组作为 Assignment 模块的输入信号。

条件子系统中的 Assignment 模块

如果在条件子系统模块中放置一个 Assignment 模块，在许多情况下会插入一个隐藏的信号缓冲区（相当于 Signal Copy 模块），并且将来自 Assignment 模块的信号与部分写入合并会导致错误。

但是，如果选择条件子系统 Outport 模块的确保输出端口为虚拟端口参数，将对此类情况提供支持，并且可以使用 Assignment 模块部分写入数组。请参阅Ensure Output Port Is Virtual。

示例

使用 Assignment 模块的迭代赋值

此示例说明如何使用 Assignment 模块将在 For Iterator 或 While Iterator 循环中计算出的值赋给连续元素。

打开模型

Parallel Channel Power Allocation

A potential use of the Find Nonzero Elements block. This block outputs a variable-size signal containing the indices of the nonzero values of the input.

打开模型

总线数组建模

使用总线数组简洁地表示结构化数据。

打开模型

限制

索引参数在仿真期间不可调。如果维度的索引选项设置为索引向量(对话框) 或起始索引(对话框)，并且您在模块对话框中为对应的索引指定了符号值，包括 Simulink.Parameter 对象，则仿真开始时的瞬时值将在整个仿真中使用，并且该参数将在生成代码中作为内联值出现。请参阅使用模块参数值进行调优和试验。您可以使用索引端口动态调整赋值索引。

端口

输入

全部展开

Y0 — 输入初始化信号
标量 | 向量

输出信号的初始化信号。如果元素未被赋予另一个值，则输出元素的值与此输入信号值匹配。

U — 输入数据端口
标量 | 向量

赋给输出元素的值（当指定了该值时）。

IndxN — 第 N 个索引信号
标量 | 向量

外部端口，用于指定对应输出元素的赋值的索引。

您可以指定自定义宽度的整数（例如，15 位整数或 23 位整数）作为索引信号值。配置整数的宽度时，必须将模式指定为定点，其中字长小于或等于 128，斜率等于 1，偏置等于 0。有关指定定点数据类型的详细信息，请参阅使用数据类型助手指定数据类型。

依存关系

要启用外部索引端口，请在索引选项表的对应行中将索引选项设置为索引向量(端口) 或起始索引(端口)。

输出

全部展开

Y — 具有已赋值的输出信号
标量 | 向量

对指定元素赋值后的输出信号。

参数

全部展开

输出维度的数量 — 输出信号的维数
`1` (默认) | 整数

键入输出信号的维数。

编程用法

参数：NumberOfDimensions

类型：字符向量

值：integer

默认值：'1'

索引模式 — 索引模式
从 1 开始 (默认) | 从 0 开始

选择索引模式。如果选择从 1 开始，则索引 1 指定输入向量的第一个元素。如果选择从 0 开始，则索引 0 指定输入向量的第一个元素。

编程用法

参数：IndexMode

类型：字符向量

值：'Zero-based' | 'One-based'

默认值：'One-based'

索引选项 — 元素的索引方法
索引向量(对话框) (默认) | 全部赋值 | 索引向量(端口) | 起始索引(对话框) | 起始索引(端口)

按维度定义信号元素的索引方式。从列表中，选择：

菜单项	操作
全部赋值	所有元素都被分配。
索引向量(对话框)	启用索引列。输入元素的索引。
索引向量(端口)	索引端口定义元素的索引。
起始索引(对话框)	启用索引列。输入要赋值的元素范围的起始索引。
起始索引(端口)	索引端口定义要赋值的元素范围的起始索引。

如果您为表中的任何维度选择索引向量(端口) 或起始索引(端口)，则可以为初始化输出(Y) 参数指定下列值之一：

使用输入端口 <Y0> 初始化
指定表中每个维度的大小

否则，Y0 始终初始化输出端口 Y。

索引和输出大小列显示为具有相关性。

编程用法

参数：IndexOptionArray

类型：字符向量

值： 'Assign all' | 'Index vector (dialog)' | 'Index option (port)' | 'Starting index (dialog)' | 'Starting index (port)'

默认值：'Index vector (dialog)'

索引 — 元素的索引
`1` (默认) | 整数

如果索引选项设置为索引向量(对话框)，则输入所需的每个元素的索引。

如果索引选项设置为起始索引(对话框)，则输入要选择的元素范围的起始索引。从起点开始的元素数量由此维度在 U 处的大小决定。

编程用法

参数：IndexParamArray

类型：字符向量

值：元胞数组

默认值：'{ }'

输出大小 — 模块输出信号的宽度
`1` (默认) | 整数

输入模块输出信号的宽度。

依存关系

要启用此列，请为初始化输出(Y) 参数选择指定表中每个维度的大小。

编程用法

参数：OutputSizeArray

类型：字符向量

值：元胞数组

默认值：'{ }'

初始化输出(Y) — 如何初始化输出信号
使用输入端口 <Y0> 初始化 (默认) | 指定表中每个维度的大小

指定如何初始化输出信号。

使用输入端口 <Y0> 初始化 - 位于输入端口 Y0 的信号初始化输出。
指定表中每个维度的大小 - 要求您在输出大小参数中指定模块输出信号的宽度。如果输出具有未分配的元素，则这些元素的值未定义。

依存关系

当您为一个或多个维度将索引选项设置为索引向量(端口) 或起始索引(端口) 时启用。

编程用法

参数：OutputInitialize

类型：字符向量

值：'Initialize using input port <Y0>' | 'Specify size for each dimension in table'

默认值：'Initialize using input port <Y0>'

未分配任何输出元素时的动作 — 产生警告或错误的选项
警告 (默认) | 错误 | 无

指定当您还有未分配的输出元素时是否生成警告或错误。选项包括：

警告 - Simulink 显示警告并继续进行仿真。
错误 - Simulink 终止仿真并显示错误。
无 - Simulink 不执行任何操作。

依存关系

要启用此参数，请将一个或多个维度的索引选项设置为索引向量(端口) 或起始索引(端口)，然后将初始化输出(Y) 设置为指定表中每个维度的大小。

编程用法

参数：DiagnosticForDimensions

类型：字符向量

值：'Error' | 'Warning' | 'None'

默认值：'Warning'

采样时间(-1 表示继承) — 采样之间的时间间隔
`-1` (默认) | 标量 | 向量

指定采样时间间隔。要继承采样时间，请将此参数设置为 -1。有关详细信息，请参阅指定采样时间。

依存关系

仅当您将此参数设置为 -1 以外的值时才可见。要了解详细信息，请参阅不建议设置采样时间的模块。

编程用法

模块参数：SampleTime

类型：字符串标量或字符向量

默认值："-1"

在加速仿真中检查超范围索引 — 在加速和快速加速仿真模式下检查超范围索引值的选项
`off` (默认) | `on`

选中此复选框可让 Simulink 在加速或快速加速模式下进行仿真时检查是否有任何索引值超出输入信号的相关维度的有效索引范围。如果索引超出范围，Simulink 将停止仿真并显示错误消息。

注意

如果不选中此复选框，超出范围的索引值可能导致在加速或快速加速模式下仿真期间出现未定义的行为。

无论是否选中此复选框，在普通模式仿真期间 Simulink 都会执行此检查。

编程用法

参数：RuntimeRangeChecks

类型：字符向量

值：'Off' | 'On'

默认值：'Off'

模块特性

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

扩展功能

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

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

HDL Coder™ 提供影响 HDL 实现和综合逻辑的额外配置选项。

HDL 架构

此模块具有一个默认 HDL 架构。

HDL 模块属性

ConstrainedOutputPipeline	通过移动设计中现有延迟的方式来放置在输出端的寄存器的数量。分布式流水线不会重新分发这些寄存器。默认值为 `0`。有关详细信息，请参阅ConstrainedOutputPipeline (HDL Coder)。
InputPipeline	要在生成的代码中插入的输入流水线阶段数。分布式流水线和受限输出流水线可以移动这些寄存器。默认值为 `0`。有关详细信息，请参阅InputPipeline (HDL Coder)。
OutputPipeline	要在生成的代码中插入的输出流水线阶段数。分布式流水线和受限输出流水线可以移动这些寄存器。默认值为 `0`。有关详细信息，请参阅OutputPipeline (HDL Coder)。

复数数据支持

此模块支持复信号的代码生成。

限制

代码生成不支持可变大小信号。

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

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

版本历史记录

在 R2006a 之前推出

全部展开

R2023a: 索引信号支持自定义宽度的整数

从 R2023a 开始，您可以自定义用于指定 Assignment 模块的索引信号值的整数宽度。

另请参阅

Bus Assignment | Selector

主题

使用总线数组组合非虚拟总线

Assignment

描述

条件子系统中的 Assignment 模块

示例

使用 Assignment 模块的迭代赋值

Parallel Channel Power Allocation

总线数组建模

限制

端口

输入

Y0 — 输入初始化信号 标量 | 向量

U — 输入数据端口 标量 | 向量

IndxN — 第 N 个索引信号 标量 | 向量

依存关系

输出

Y — 具有已赋值的输出信号 标量 | 向量

参数

输出维度的数量 — 输出信号的维数 1 (默认) | 整数

编程用法

索引模式 — 索引模式 从 1 开始 (默认) | 从 0 开始

编程用法

索引选项 — 元素的索引方法 索引向量(对话框) (默认) | 全部赋值 | 索引向量(端口) | 起始索引(对话框) | 起始索引(端口)

编程用法

索引 — 元素的索引 1 (默认) | 整数

编程用法

输出大小 — 模块输出信号的宽度 1 (默认) | 整数

依存关系

编程用法

初始化输出(Y) — 如何初始化输出信号 使用输入端口 <Y0> 初始化 (默认) | 指定表中每个维度的大小

依存关系

编程用法

未分配任何输出元素时的动作 — 产生警告或错误的选项 警告 (默认) | 错误 | 无

依存关系

编程用法

采样时间(-1 表示继承) — 采样之间的时间间隔 -1 (默认) | 标量 | 向量

依存关系

编程用法

在加速仿真中检查超范围索引 — 在加速和快速加速仿真模式下检查超范围索引值的选项 off (默认) | on

编程用法

模块特性

扩展功能

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

HDL 代码生成 使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

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

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

版本历史记录

R2023a: 索引信号支持自定义宽度的整数

另请参阅

主题

WeChat

Y0 — 输入初始化信号
标量 | 向量

U — 输入数据端口
标量 | 向量

IndxN — 第 N 个索引信号
标量 | 向量

Y — 具有已赋值的输出信号
标量 | 向量

输出维度的数量 — 输出信号的维数
`1` (默认) | 整数

索引模式 — 索引模式
从 1 开始 (默认) | 从 0 开始

索引选项 — 元素的索引方法
索引向量(对话框) (默认) | 全部赋值 | 索引向量(端口) | 起始索引(对话框) | 起始索引(端口)

索引 — 元素的索引
`1` (默认) | 整数

输出大小 — 模块输出信号的宽度
`1` (默认) | 整数

初始化输出(Y) — 如何初始化输出信号
使用输入端口 <Y0> 初始化 (默认) | 指定表中每个维度的大小

未分配任何输出元素时的动作 — 产生警告或错误的选项
警告 (默认) | 错误 | 无

采样时间(-1 表示继承) — 采样之间的时间间隔
`-1` (默认) | 标量 | 向量

在加速仿真中检查超范围索引 — 在加速和快速加速仿真模式下检查超范围索引值的选项
`off` (默认) | `on`

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

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

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

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