Engee 文档

Gain

将输入信号与一个常数相乘。

类型: Gain

图书馆中的路径:

/Basic/Math Operations/Gain

说明

Gain 单元将输入信号的值乘以一个常数(增益)。输入信号和增益可以是标量、矢量或矩阵。

增益由参数 Gain 指定。参数 Multiplication 可以指定逐元素乘法或矩阵乘法。对于矩阵乘法,该参数还可以指定乘法器的顺序。

计算输出信号时, Gain 模块使用以下规则:

  • 如果输入信号为实型,增益为复数,则输出信号为复数。

  • 如果输入信号类型与增益类型不同,Engee 会尝试将增益类型转换为输入信号类型。如果无法进行转换,计算将停止并显示错误信息。例如,如果输入信号是无符号整数 (Uint8),而参数 Gain 设置为负数,就可能出现这种情况。

端口

输入

# IN_1 — 输入信号
标量 | 向量 | 矩阵

Details

Gain 支持实数和复数标量、矢量或矩阵输入信号。 如果块输入信号 Gain 为实数,增益为复数,则输出信号将为复数。

数据类型

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

复数支持

输出

# OUT_1 — 输入信号乘以放大系数
标量 | 向量 | 矩阵

Details

输入信号乘以增益。如果块输入信号 Gain 为实数,增益为复数,则输出信号为复数。

数据类型

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

复数支持

参数

主要

# Gain — 将输入信号乘以的系数
Scalar / array of real and/or complex numbers

Details

设置输入信号应乘以的系数。 增益可以是任何类型的实数或复数标量、矢量或矩阵,逻辑除外。

默认值

1.0

程序使用名称

Gain

可调谐

可计算

# Multiplication — 乘法模式
Element-wise(K.*u) | Matrix(K*u) | Matrix(u*K)

Details

指定这些乘法模式之一。:

  • Element-wise(K.*u) -输入信号的每个元素乘以增益的每个元素。 如果需要,该块执行扩展,以便输入数据和增益具有相同的维度。

  • Matrix(K*u) —将所述输入数据和所述增益乘以使用所述输入数据作为所述第二操作数的矩阵。

  • Matrix(u*K) —将输入数据和增益乘以使用输入数据作为第一操作数的矩阵。

Element-wise(K.*u) | Matrix(K*u) | Matrix(u*K)

默认值

Element-wise(K.*u)

程序使用名称

Multiplication

可调谐

可计算

信号属性

# Output data type — 输出数据的类型
Inherit: auto | Same as input | Float64 | Float32 | Float16 | Int8 | UInt8 | Int16 | UInt16 | Int32 | UInt32 | Int64 | UInt64 | Int128 | UInt128 | Fixed-point

Details

设置输出数据的类型。

Inherit: auto | Same as input | Float64 | Float32 | Float16 | Int8 | UInt8 | Int16 | UInt16 | Int32 | UInt32 | Int64 | UInt64 | Int128 | UInt128 | Fixed-point

默认值

Inherit: auto

程序使用名称

OutDataTypeStr

可调谐

可计算

# Output fixed-point type — 定点输出的类型
Data type

Details

指定定点输出的类型。

依赖关系

若要使用此参数,请为参数设置 Output data type 意义 Fixed-point.

默认值

fixdt(1, 16, 0)

程序使用名称

OutDataTypeStrFixed

可调谐

可计算

# Integer rounding mode — 定点运算的舍入模式
Ceiling | Convergent | Floor | Nearest | Round | Zero

Details

选择定点运算的舍入模式。 你可以选择:

  • Ceiling -向下舍入正数和负数(朝向负无穷大)。

  • Floor -舍入正数和负数(朝向正无穷大)。

  • Convergent -将数字舍入到最接近的可表示值。 如果数字的小数部分以5结尾,则该数字将四舍五入为最接近的偶数整数。

  • Nearest -将数字舍入到最接近的可表示值。 如果数字的小数部分以5结尾,则将该数字向上取整(朝向正无穷大)。

  • Round -将数字舍入到最接近的整数。

  • Zero -四舍五入数向零。

Ceiling | Convergent | Floor | Nearest | Round | Zero

默认值

Floor

程序使用名称

RndMeth

可调谐

可计算

# Saturate on integer overflow — 溢出情况下的作用方法
Logical

Details

当选择此选项时,饱和度应用于所有内部块操作,而不仅仅是输出或结果。

开始! 做出此决定的原因 当有溢出时会发生什么 例子:

选中此框。

溢出在您的模型中是可能的,并且您需要显式保护以防止生成的代码中的饱和。

溢出饱和到给定数据类型可以表示的最小值或最大值。

与有符号8位整数相关联的溢出可能饱和到'-128’或'127'。

不要选中此框。

您希望优化生成代码的效率。通行证:q[<br>] 您希望避免过度澄清块如何处理超出范围的信号。

溢出被包装成一个适当的值,该值可以用数据类型表示。

数字`130’不适合有符号的8位整数,并折叠成'-126`

默认值

false (关掉)

程序使用名称

SaturateOnIntegerOverflow

可调谐

可计算

参数属性

# Parameter data type — 参数数据类型
Inherit: auto | Same as input | Float64 | Float32 | Float16 | Int8 | UInt8 | Int16 | UInt16 | Int32 | UInt32 | Int64 | UInt64 | Int128 | UInt128 | Fixed-point

Details

设置参数的数据类型。

Inherit: auto | Same as input | Float64 | Float32 | Float16 | Int8 | UInt8 | Int16 | UInt16 | Int32 | UInt32 | Int64 | UInt64 | Int128 | UInt128 | Fixed-point

默认值

Inherit: auto

程序使用名称

ParamDataTypeStr

可调谐

可计算

# Parameter fixed-point type — 定点参数数据类型
Data type

Details

指定定点参数的数据类型。

依赖关系

若要使用此参数,请为参数设置 Parameter data type 意义 Fixed-point.

默认值

fixdt(1, 16, 0)

程序使用名称

ParamDataTypeStrFixed

可调谐

可计算

附加选项

C 代码生成: 是

Verilog生成:是