Gain
将输入信号与一个常数相乘。
类型: Gain
|
图书馆中的路径: |
说明
Gain 单元将输入信号的值乘以一个常数（增益）。输入信号和增益可以是标量、矢量或矩阵。
增益由参数 Gain 指定。参数 Multiplication 可以指定逐元素乘法或矩阵乘法。对于矩阵乘法，该参数还可以指定乘法器的顺序。
计算输出信号时， Gain 模块使用以下规则：
-
如果输入信号为实型，增益为复数，则输出信号为复数。
-
如果输入信号类型与增益类型不同，Engee 会尝试将增益类型转换为输入信号类型。如果无法进行转换，计算将停止并显示错误信息。例如，如果输入信号是无符号整数 (
Uint8)，而参数 Gain 设置为负数，就可能出现这种情况。
端口
输入
#
IN_1
—
输入信号
标量 | 向量 | 矩阵
Details
块 Gain 支持实数和复数标量、矢量或矩阵输入信号。 如果块输入信号 Gain 为实数，增益为复数，则输出信号将为复数。
| 数据类型 |
|
| 复数支持 |
是 |
输出
#
OUT_1
—
输入信号乘以放大系数
标量 | 向量 | 矩阵
Details
输入信号乘以增益。如果块输入信号 Gain 为实数，增益为复数，则输出信号为复数。
| 数据类型 |
|
| 复数支持 |
是 |
参数
主要
#
Gain —
输入信号的乘法系数
Scalar / array of real and/or complex numbers
Details
指定输入信号的乘法系数。增益可以是实数或复数标量、矢量或矩阵，逻辑类型除外。
| 默认值 |
|
| 程序使用名称 |
|
| 可调谐 |
是 |
| 可计算 |
是 |
#
Multiplication —
乘法模式
Element-wise(K.*u) | Matrix(K*u) | Matrix(u*K)
Details
指定其中一种乘法模式：
-
Element-wise(K.*u)- 输入信号的每个元素与增益的每个元素相乘。必要时，设备会进行扩展，使输入数据和增益具有相同的大小。 -
Matrix(K*u)- 输入数据和增益乘以矩阵，矩阵使用输入数据作为第二个操作数。 -
Matrix(u*K)- 以输入数据为第一操作数，将输入数据和增益乘以矩阵。
| 值 |
|
| 默认值 |
|
| 程序使用名称 |
|
| 可调谐 |
无 |
| 可计算 |
无 |
信号属性
#
Output data type —
输出数据类型
Inherit: auto | Same as input | Float64 | Float32 | Float16 | Int8 | UInt8 | Int16 | UInt16 | Int32 | UInt32 | Int64 | UInt64 | Int128 | UInt128 | Fixed-point
Details
设置输出数据类型。
| 值 |
|
| 默认值 |
|
| 程序使用名称 |
|
| 可调谐 |
无 |
| 可计算 |
无 |
#
Output fixed-point type —
定点输出数据类型
Data type
Details
指定定点输出类型。
依赖关系
要使用此参数，请将参数设置为 Output data type 值 Fixed-point.
| 默认值 |
|
| 程序使用名称 |
|
| 可调谐 |
无 |
| 可计算 |
是 |
#
Integer rounding mode —
定点操作的四舍五入模式
Ceiling | Convergent | Floor | Nearest | Round | Zero
Details
选择定点运算的舍入模式。您可以选择
-
Ceiling- 将正数和负数向下舍入（向负无穷）。 -
Floor- 将正数和负数向上舍入（向正无穷舍入）。 -
Convergent- 将数字四舍五入到最接近的可表示值。如果数字的小数部分以 5 结尾，则该数字四舍五入为最接近的偶数整数。 -
Nearest- 将数字舍入到最接近的可表示值。如果数字的小数部分以 5 结尾，则数字向上舍入（向正无穷）。 -
Round- 将数字四舍五入到最接近的可表示值。如果数字的小数部分以 5 结尾，正数向上舍入（向正无穷），负数向下舍入（向负无穷）。 -
Zero- 将数字向零舍入。
| 值 |
|
| 默认值 |
|
| 程序使用名称 |
|
| 可调谐 |
无 |
| 可计算 |
无 |
#
Saturate on integer overflow —
溢出动作方法
Logical
Details
选中时，饱和将应用于所有内部块操作，而不仅仅是输出或结果。
| 操作a | 执行此操作的原因a | 溢出时会发生什么情况 示例 | |
|---|---|---|---|
选中此复选框。a |
模型中可能存在溢出，需要在生成的代码中提供显式饱和保护。 |
溢出将饱和到该数据类型可表示的最小值或最大值。a |
与有符号 8 位整数相关的溢出可能饱和到 |
请勿选择此复选框。 |
您希望优化生成代码的效率。 |
溢出会被包裹在一个可以用数据类型表示的适当值中。a |
数字 |
| 默认值 |
|
| 程序使用名称 |
|
| 可调谐 |
无 |
| 可计算 |
无 |
参数属性
#
Parameter data type —
参数数据类型
Inherit: auto | Same as input | Float64 | Float32 | Float16 | Int8 | UInt8 | Int16 | UInt16 | Int32 | UInt32 | Int64 | UInt64 | Int128 | UInt128 | Fixed-point
Details
设置参数的数据类型。
| 值 |
|
| 默认值 |
|
| 程序使用名称 |
|
| 可调谐 |
无 |
| 可计算 |
无 |
#
Parameter fixed-point type —
定点参数数据类型
Data type
Details
指定定点参数的数据类型。
依赖关系
要使用此参数，请将参数设置为 Parameter data type 值 Fixed-point.
| 默认值 |
|
| 程序使用名称 |
|
| 可调谐 |
无 |
| 可计算 |
是 |