Assignment

为指定的信号元素分配新值。

类型: Assignment

$assignment$

图书馆中的路径:

/Basic/Math Operations/Assignment

说明

Assignment 功能块将输入信号值分配给选定的信号元素。通过在程序块参数窗口中输入索引参数，或将一个或多个外部索引源连接到程序块，可以设置要为其赋值的元素的索引。程序块 U 端口上的信号指定了要分配给 Y 的值。程序块将用数据信号中的元素替换指定的 Y0 元素。

根据为 Number of output dimensions 输入的值，将显示所需指数数量的参数设置。对于每次测量，您都可以定义要使用的信号元素。将矢量信号指定为一维信号，将矩阵信号指定为二维信号。要启用外部分度端口，请将相应分度的参数 Index option 设置为 Index vector (port)`或 `Starting index (port).

例如，二维信号的索引模式为一。 Assignment 设备的参数设置将改变为每个测量包含一组参数。如果使用以下条目定义每个维度：

第一个索引： Index option 值 Assign all;
第二个索引
- Index option 值 Index vector (dialog);
- Index value`[1 3 5]`。

那么赋值的形式为 Y[1:end,[1 3 5]]=U。

在正常模式下使用 Assignment 程序块时，Engee 会将程序块的输出初始化为零，即使模型中没有明确初始化它们。

该块可用于为矢量或矩阵信号赋值。

港口

输出

# Y — 带有指定值的输出信号
矩阵

Details

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

数据类型	`Float16`, `Float32`, `Float64`, `Int8`, `Int16`, `Int32`, `Int64`, `UInt8`, `UInt16`, `UInt32`, `UInt64`, `Bool`。
复数支持	是

输入

# Y0 — 初始化输入信号
vector | matrix

Details

输出信号的初始化信号。如果没有为元素分配其他值，输出元素的值与此输入信号的值相同。

数据类型	`Float16`, `Float32`, `Float64`, `Int8`, `Int16`, `Int32`, `Int64`, `UInt8`, `UInt16`, `UInt32`, `UInt64`, `Bool`。
复数支持	是

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

Details

如果指定，输出元素的赋值。

数据类型	`Float16`, `Float32`, `Float64`, `Int8`, `Int16`, `Int32`, `Int64`, `UInt8`, `UInt16`, `UInt32`, `UInt64`, `Bool`。
复数支持	是

参数

主页

# Number of output dimensions — 要处理的尺寸数
Integer

Details

用户指定的处理尺寸数 ( ) 必须与实际输入尺寸数一致。

默认值	`1`
程序使用名称	`NumberOfDimensions`
可调谐	无
可计算	是

# Index mode — 指定初始索引编号
One-based | Zero-based

Details

将索引模式指定为 Zero-based`或 `One-based.

对于 Zero-based`索引 `0 指定输入向量的第一个元素。索引 1 定义第二个元素，以此类推。

对于 One-based`索引 `1 指定输入向量的第一个元素。索引 2 指定第二个元素，以此类推。

值	`One-based` \| `Zero-based`
默认值	`One-based`
程序使用名称	`IndexMode`
可调谐	无
可计算	无

# Initialize output (Y) — 输入信号采集方法
Initialize using input port <Y0> | Specify size for each dimension in table

Details

指定输出信号的初始化方式。

Initialize using input port <Y0>- 输入端口 Y0 上的信号初始化输出信号。

Specify size for each dimension in table- 需要在参数 Output size .如果输出端有未指定的元素，则这些元素的值是未定义的。

依赖关系

要使用此参数，请将参数 Index option 值 `Index vector (port)`或 `Starting index (port)`进行一次或多次测量。

值	`Initialize using input port <Y0>` \| `Specify size for each dimension in table`
默认值	`Initialize using input port`
程序使用名称	`OutputInitialize`
可调谐	无
可计算	无

# Action if any output element is not assigned — 如果所有输出元素都未分配，则
Error | None

Details

指定在未分配所有输出元素时是否产生错误。选项包括

None- 无操作。
Error- Engee* 终止模拟并显示错误。

依赖关系

要使用该参数，请将参数 Index option 值 Index vector (port)`或 `Starting index (port)`进行一次或多次测量，然后将参数设置为 Initialize output (Y) 值 `Specify size for each dimension in table.

值	`Error` \| `None`
默认值	`None`
程序使用名称	`DiagnosticForDimensions`
可调谐	无
可计算	无

Index 1

# Index option — 项目索引法
Assign all | Index vector (dialog) | Index vector (port) | Starting index (dialog) | Starting index (port)

Details

根据输入信号的维数确定信号元素的索引方式。从列表中选择：

Assign all- 无需进一步设置。所有项目均被选中。
Index vector (dialog)- 启用参数 Index .输入元素索引矢量。如果输入信号大小可变，请勿选择此选项。
Index vector (port)- 无需进一步调整。
Starting index (dialog)- 包括参数 Index 和 Output size .在参数和中输入要选择的项目范围的初始索引，并在参数 Index 中要选择的元素个数。 Output size .如果输入信号大小可变，请勿选择此选项。
Starting index (port)- 包括参数 Output size .输入参数中要选择的项目数。 Output size .

选择选项 `Index vector (port)`或 `Starting index (port)`时，程序块有相应的端口，参数 Initialize output (Y) 可以指定其中一个值：

Initialize using input port <Y0>
Specify size for each dimension in table

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

参数 Index 和 Output size 如果不用于所选模式 Index option 将被忽略。

值	`Assign all` \| `Index vector (dialog)` \| `Index vector (port)` \| `Starting index (dialog)` \| `Starting index (port)`
默认值	`Index vector (dialog)`
程序使用名称	`IndexOptionArray1`
可调谐	无
可计算	无

# Index — 元素索引
Scalar / array of integers

Details

如果参数 Index option 等于 Index vector (dialog)，则输入每个相关项目的索引。

如果参数 Index option 等于 Starting index (dialog)，则输入要选择的项目范围的起始索引。从起点开始的条目数由 U 中该维度的大小决定。

依赖关系

要使用此参数，请将参数设置为 Index option 值 Index vector (dialog)`或 `Starting index (dialog).

默认值	`1`
程序使用名称	`IndexParamArray1`
可调谐	无
可计算	是

# Output size — 块输出宽度
Integer

Details

设置块输出信号的宽度。

依赖关系

要使用该参数，请将参数 Initialize output (Y) 值 Specify size for each dimension in table.

默认值	`1`
程序使用名称	`OutputSizeArray1`
可调谐	无
可计算	是