Engee 文档

Variable Selector

从输入数据中选择行或列的子集。

类型: Variable Selector

图书馆中的路径:

/Signal Operations/Signal Management/Indexing/Variable Selector

说明

Variable Selector 从大小为 M 乘 N 的输入矩阵 u 的每个输入端口上提取行或列的子集。输入和输出端口的数量在*输入信号数*参数中指定。

如果索引向量中的某个元素引用了输入信号中不存在的行或列,程序块将执行*无效索引*参数中指定的操作。

如果索引向量元素的数据类型为 Bool,程序块将执行逻辑索引。选中 Fill empty spaces in outputs (for logical indexing) 参数以使用 Fill values 参数。这些值将添加到输出信号中,使其长度等于输入元素的长度。

端口

输入

# InN — 第 N 个输入信号
标量 | 向量 | 矩阵

Details

第 N 个输入信号,其中 N 是输入信号个数参数中指定的输入个数。

数据类型

Float16 | Float32 | Float64 | Int8 | Int16 | Int32 | Int64 | Int128 | Uint8 | Uint16 | Uint32 | Uint64 | Uint128 | Bool | `定点

复数支持

# 同上 — 指数向量
scalar | vector

Details

指定标量值或向量,其中包含输出矩阵中出现的输入行或列的索引。

数据类型

Float16 | Float32 | Float64 | Int8 | Int16 | Int32 | Int64 | Int128 | Uint8 | Uint16 | Uint32 | Uint64 | Uint128 | Bool.

复数支持

输出

# OutN — 第 N 个输出信号
标量 | 向量 | 矩阵

Details

第 N 个输出信号对应第 N 个输入信号,其中 N 是 Number of input signals 参数中指定的输入个数。输出信号以标量、矢量或矩阵的形式返回,其类型、大小和复杂程度与相应的输入信号相同。

数据类型

Float16 | Float32 | Float64 | Int8 | Int16 | Int32 | Int64 | Int128 | Uint8 | Uint16 | Uint32 | Uint64 | Uint128 | Bool | `定点

复数支持

参数

主页

# Number of input signals — 输入端口数
Real number

Details

输入信号的正整数。区块中的每个输入信号都会创建一个输入端口。

默认值

1

程序使用名称

NumInputs

可调谐

可计算

# Select — 输入尺寸
Rows | Columns

Details

选择输入的尺寸:

  • 行数" - 从每个输入矩阵中提取行数;

  • 列"- 从每个输入矩阵中提取列。

选定的输入行或列可以在任意输出中出现任意次数,或者根本不出现。

Rows | Columns

默认值

Rows

程序使用名称

rowsOrCols

可调谐

可计算

# Selector mode — 索引模式
Fixed | Variable

Details

要执行的索引操作类型。定义为

  • Variable - 长度为 的矢量,馈送至端口 Idx 的输入端,从每个输入端选择 行或列发送至输出端。您可以在每个采样周期更新索引向量的元素,但向量的长度必须在整个模拟周期内保持不变。

  • 固定"--Idx*端口被禁用。长度为 的矢量(在 *Elements 参数中指定)选择 行或列的每个输入发送到输出。Elements 参数是可配置的,因此您可以在仿真过程中随时更改索引矢量的元素值,但矢量的长度必须保持不变。

Fixed | Variable

默认值

Variable

程序使用名称

IdxMode

可调谐

可计算

# Elements — 输出矩阵元素的指数
Scalar / array of real numbers

Details

一个向量,包含输出矩阵中出现的输入行或列的索引。

依赖关系

要使用此参数,请将*选择器模式*参数设置为 "固定"。

默认值

[1 3]

程序使用名称

Elements

可调谐

可计算

# Index mode — 索引模式
Zero-based | One-based

Details

索引模式。定义为

  • 基于一"- 索引值 "1 "指输入的第一行或第一列。

  • 基于零"- 索引值 "0 "指输入的第一行或第一列。

Zero-based | One-based

默认值

One-based

程序使用名称

ZerOneIdxMode

可调谐

可计算

# Invalid index — 错误处理
Clip Index | Generate Error

Details

指定程序块如何处理无效索引值。指定为

  • Clip index - 将索引修剪为最接近的有效值,不产生警告。

    例如,如果向程序块输入 `[64, 4] 信号,且 Select 参数设置为:

    • 行"--程序块将索引从 "72 "切到 "64"。

    • 列` - 程序块将索引从`72`截断到`4`。

      在这两种情况下,块将索引从`2`截断到`1`。

  • 生成错误` - 输出错误对话框并终止模拟。

Clip Index | Generate Error

默认值

Clip index

程序使用名称

errmode

可调谐

可计算

# Fill empty spaces in outputs (for logical indexing) — 选项来填充输出数据中的空格
Logical

Details

当索引向量的元素具有 Bool 数据类型时,程序块将执行逻辑索引。逻辑索引可能会导致输出数据中出现空位。

选择此复选框可在 Fill values 参数中指定要添加到输出数据中的值。

默认值

true (已开启)

程序使用名称

FillMode

可调谐

可计算

# Fill values — 填充值

Details

区块执行逻辑索引时的填充值。

依赖关系

要使用该参数,请选择 Fill empty spaces in outputs (for logical indexing) 复选框。

默认值

0

程序使用名称

FillValues

可调谐

可计算