Gain

Gain
https://www.wendangku.net/doc/de12220528.html,/p/2025807216 按常量乘以输入
库
数学运算
描述
Gain 块的输入乘以一个恒定值（增益） 。输入和增益可以分别是一个标量，向量或矩阵。
您指定 Gain 参数值中的增益。Multiplication 参数可以指定分段元素或矩阵乘法。对于矩阵 乘法，这个参数也可以让你显示乘数的顺序。
增益转换从一倍到指定的数据， 块中的掩码脱机状态下使用舍入到最近的及饱和度。 输入和 再乘以增益，并且将结果转换到输出数据类型使用指定的舍入和溢出模式。
数据类型支持
Gain 块接受 Simulink 支持的任何数字数据类型，一个实数或复数标量，向量或矩阵。Gain
模块支持定点数据类型。如果 Gain 块的输入是实数，增益是复数，输出是复数。
见 Data Types Supported by Simulink
参数和对话框
Gain 块对话框中 Main 窗格显示如下：
Gain 块对话框中 Signal Attributes 窗格显示如下：
Gain 块对话框中 Parameter Attributes 窗格显示如下：
Gain
指定的值乘以输入
设置
默认: 1
Minimum:Parameter minimum 参数值
Maximum:Parameter maximum 参数值
增益可以是一个标量，向量或矩阵
命令行信息 见 Block-Specific Parameters .
Multiplication
指定的乘法模式。
设置 默认:Element-wise(K.*u)
Element-wise(K.*u)
每一个元素的输入被乘以由每个元素的增益。该块进行扩展，如果必要的话，在输 入和增益的具有相同的维。
Matrix(K*u)
输入和增益是矩阵，乘以作为第二个操作数的输入。
Matrix(u*K)
输入和增益是矩阵，乘以第一个操作数的输入。
Matrix(K*u)(u vector)
输入和增益是矩阵， 乘以作为第二个操作数的输入。 Matrix(K*u)此模式是相同的， 除了如何确定维度。
假设 K 是 m*n 矩阵。Matrix(K*u)(u vector)设置的输入的矢量长度为 n 和输出的 矢量长度为 m。与此相反，Matrix(K*u)使用传输的输入和输出，以确定维度。在
m*n 增益矩阵，输入可以传送到一个 n*q 矩阵，并输出成为一个 m*q 矩阵。
命令行信息 见 Block-Specific Parameters .
Sample time (-1 for inherited)
指定样本之间的时间间隔。
设置
默认: -1
要继承采样时间，此参数设置为-1。
见 Specify Sample Time
命令行信息 见 Block-Specific Parameters .
Output minimum
指定块输出的最小值。
设置 默认:[] (未指定)
这个数字必须是有限的实数的 double 标值。
注意：如果你指定一个的总线对象作为这个块的数据类型，总线上的数据块不设置最小值。Simulink 中忽略此设置。相反，总 线的总线对象的数据类型指定为元素的最小值。见 Simulink.BusElement.
Simulink 中使用最小值执行：
? ? ?
参数范围检查（见 Check Parameter Values)为一些块 模拟范围检查（见 Signal Ranges) 自动缩放的定点数据类型 命

令行信息 见 Block-Specific Parameters .
Output maximum
指定块输出的最大值。
设置 默认:[] (未指定)
这个数字必须是有限的实数的 double 标值。
注意：如果你指定一个的总线对象作为这个块的数据类型，总线上的数据块不设置最大值。Simulink 中忽略此设置。相反，总 线的总线对象的数据类型指定为元素的最大值。见 Simulink.BusElement
指定块输出的最大值。
? ? ?
参数范围检查（见 Check Parameter Values)为一些块 模拟范围检查（见 Signal Ranges) 自动缩放的定点数据类型 命令行信息 See Block-Specific Parameters .
Output data type
指定输出的数据类型。
设置 默认:Inherit:
Inherit via internal rule
Inherit: Inherit via internal rule
Simulink 的选择输出缩放和需要与收容在计算出的输出范围和保持块的输出精度， 并与目标硬件实现为模型指定的字长相一致的最小量的存储器的数据类型。如果
Device type 参数对 Hardware Implementation 配置参数窗格中设置为
ASIC/FPGA,Simulink 软件选择输出数据类型不考虑硬件的限制。否则，Simulink 软
件可用的硬件选择最小的数据类型能够满足的范围和精度的限制。例如，如果该块 类型 int8 输入乘以由 int16 和 ASIC/FPGA 的增益被指定为目标的硬件类型，输出 数据类型是 sfix24。如果未指定(assume 32-bit Generic),即，一个通用的 32 位
微处理器，被指定为目标硬件，输出数据类型为 int32。如果没有的字长度的目标 微处理器可容纳的输出范围，Simulink 软件模拟诊断浏览器中显示一条错误消息。
Inherit: Inherit via back propagation
使用的驱动块的数据类型。
Inherit: Same as input
使用输入信号数的据类型。
double
输出数据类型是 double.
single
输出数据类型是 single.
int8
输出数据类型是 int8.
uint8
输出数据类型是 uint8.
int16
输出数据类型是 int16.
uint16
输出数据类型是 uint16.
int32
输出数据类型是 int32.
uint32
输出数据类型是 uint32.
fixdt(1,16,0)
输出数据类型是固定点 fixdt(1,16,0).
fixdt(1,16,2^0,0)
输出数据类型是固定点 fixdt(1,16,2^0,0).

使用数据类型的对象，例如，Simulink.NumericType.
命令行信息 见 Block-Specific Parameters .
参考 见 Specify Block Output Data Types.
Mode
选择类别到指定的数据。
设置 默认:Inherit
Inherit
继承规则的数据类型。选择 Inherit 使第二个菜单/文本框的右侧。选择以下选项之一：
? ? ?
Inherit via internal rule (默认) Inherit via back propagation Same as input
Built in
内置的数据类型。选择 Built
in 使第二个菜单/文本框的右侧。选择以下选项之一：
?
double (默认)
? ? ? ? ? ? ?
single int8 uint8 int16 uint16 int32 uint32
Fixed point
定点数据类型。
Expression
计算的数据

类型的表达式。选择 Expression 启用第二个菜单/文本框的右边，在那里你可以输 入表达式。
依赖 点击 Show data type assistant 按钮启用这个参数。
命令行信息 见 Block-Specific Parameters .
参考 见 Specify Data Types Using Data Type Assistant.
Data type override
指定此信号数据类型覆盖模式，。
设置 默认:Inherit
Inherit
继承设置的情况下，也就是块的数据类型覆盖，Simulink.Signal 对象或 Stateflow 的图表在 Simulink 中的正在使用的信号。
Off
忽略其上下文的数据类型重载的设置，并使用指定的定点数据类型的信号。
提示 关闭数据类型覆盖为单个数据类型的能力，提供更大的控制权在模型中的数据类型时，可以应用数据类型 覆盖。例如，您可以使用此选项，以确保数据类型覆盖设置符合下游块的数据类型的要求。
依赖 此参数出现只当 Mode 是 Built in 或 Fixed point.
Signedness
指定是否要固定点数据作为符号或无符号。
设置 默认:Signed
Signed
指定固定点数据为符号.
Unsigned
指定固定点数据为无符号.
依存关系 选择 Mode>Fixed
point 启用此参数。
命令行信息 见 Block-Specific Parameters .
参考 见 Specifying a Fixed-Point Data Type.
Word length
指定字的位大小，保存量化整数。
设置 默认:16
Minimum:0
Maximum:32
依存关系 选择 Mode>Fixed
point 启用此参数。
命令行信息 见 Block-Specific Parameters .
参考 见 Specifying a Fixed-Point Data Type.
Scaling
指定调整您的固定点数据，以避免溢出条件，尽量减少量化误差的方法。
设置 默认:Binary
point
Binary point
指定二进制点的位置。
Slope and bias
输入 slope 和 bias.
依存关系 选择 Mode>Fixed
point 启用此参数。
选择 Binary
point 启用:
? ?
Fraction length Calculate Best-Precision Scaling 选择 Slope
and bias 启用:
? ? ?
Slope Bias Calculate Best-Precision Scaling 命令行信息 见 Block-Specific Parameters .
参考 见 Specifying a Fixed-Point Data Type.
Fraction length
指定分数长度为定点数据类型。
设置 默认:0
二进制点可以是正的或负的整数。
依存关系 选择 Scaling >Binary
point 启用此参数。
命令行信息 见 Block-Specific Parameters .
参考 见 Specifying a Fixed-Point Data Type.
Slope
指定定点数据类型的斜率。
设置 默认:2^0
指定任何正实数。
依存关系 选择 Scaling >Slope
and bias 启用此参数。
命令行信息 见 Block-Specific Parameters .
参考 见 Specifying a Fixed-Point Data Type.
Bias
指定定点数据类型的偏置。
设置 默认:0
指定任意实数。
依存关系
选择 Scaling >Slope
and bias 启用此参数。
命令行信息 见 Block-Specific Parameters .
参考 见 Specifying a Fixed-Point Data Type.
Lock output data type setting against changes by the fixed-point tools
选择锁定此块对

输出的数据类型设置定点工具和定点顾问。
设置 默认: Off
On
锁定此设置块的输出数据类型。
Off
设置此块允许定点工具和定点顾问来改变输出数据类型。
命令行信息 见 Block-Specific Parameters .
参考 见 Use Lock Output Data Type Setting.
Integer rounding mode
指定定点运算的舍入模式
设置 默认:Floor
Ceiling
舍入正数和负数向正无穷大。相当于 MATLAB 的 ceil 函数。
Convergent
舍入数最接近的可表示值。如果出现平局，则四舍五入到最接近的偶数整数。等效 的定点工具箱 convergent 函数。
Floor
舍入正数和负数向负无穷大。相当于 MATLAB 的 floor 函数。
Nearest
舍入数最接近的可表示值。如果出现平局，向正无穷大。等效的定点工具箱的
nearest 函数。
Round
舍入数最接近的可表示值。如果出现平局，向正数向正无穷大和负数向负无穷大。 等效的定点工具箱的 round 函数。
Simplest
自动产生舍入代码是尽可能高效的。
Zero
舍入数到零。相当于 MATLAB 的 fix 函数。
命令行信息 见 Block-Specific Parameters .
参考 见 Rounding
Saturate on integer overflow
指定是否溢出饱和。
设置 默认: Off
On 溢出饱和到任何的数据类型可以表示的最小或最大值。
例如，有符号的 8 位整数溢出饱和到-128 或 127。
Off
溢出换到数据类型表示的适当的值。
例如，130 不适合在有符号的 8 位整数，换到-126。
提示
? ?
考虑选择此复选框，当你的模型有可能溢出，并在生成的代码，你要明确的饱和保护。 当你想优化生成的代码的效率，考虑清除此复选框。 清除此复选框，还可以帮助您避免过度指定块如何处理范围的信号。见 Checking for Signal
Range Errors.
? ?
当您选择此复选框，饱和度适用于每一个块的内部运作，而不仅仅是输出或结果。 在一般情况下，代码生成过程中可以检测到溢出是不可能的。在这种情况下，代码生成器不 产生饱和的代码。
命令行信息 见 Block-Specific Parameters .
Parameter minimum
指定最小的增益值
设置
默认:[]
默认值是[]（未指定）。Simulink 软件使用这个值来执行：
? ?
参数范围检查（见 Check Parameter Values) 自动缩放的定点数据类型 命令行信息 见 Block-Specific Parameters .
Parameter maximum
指定最大的增益值
设置
默认:[]
默认值是[]（未指定）。Simulink 软件使用这个值来执行：
? ?
参数范围检查（见 Check Parameter Values) 自动缩放的定点数据类型 命令行信息 见 Block-Specific Parameters .
Parameter data type
指定 Gain 参数的数据类型。
设置 默认:Inherit:
Inherit via internal rule
Inherit: Inherit via internal rule
使用内部规则继承的数据类型。
Inherit: Same as input
使用唯一输入信号的数据类型
Inheri

t: Inherit from 'Gain'
使用 Gain 值的数据类型。例如：
如果你设置 Gain...
参数的数据类型继承...
2
double
single(2)
single
int8(2)
int8
double
数据类型是 double.
single
数据类型是 single.
int8
数据类型是 int8.
uint8
数据类型是 uint8.
int16
数据类型是 int16.
uint16
数据类型是 uint16.
int32
数据类型是 int32.
uint32
数据类型是 uint32.
fixdt(1,16)
数据类型是 fixdt(1,16).
fixdt(1,16,0)
数据类型是 fixdt(1,16,0).
fixdt(1,16,2^0,0)
数据类型是 fixdt(1,16,2^0,0).

使用数据类型的对象，例如，Simulink.NumericType.
命令行信息 见 Block-Specific Parameters .
Mode
选择类别到指定的数据。
设置 默认:Inherit
Inherit
继承规则的数据类型。选择 Inherit 使第二个菜单/文本框的右侧。选择以下选项之一：
?
Inherit via internal rule (默认)
? ?
Same as input Inherit from 'Gain'
Built in
内置的数据类型。选择 Built
in 使第二个菜单/文本框的右侧。选择以下选项之一：
? ? ? ? ? ? ? ?
double (默认) single int8 uint8 int16 uint16 int32 uint32
Fixed point
定点数据类型。
Expression
计算的数据类型的表达式。选择 Expression 启用第二个菜单/文本框的右边，在那里你可以输 入表达式。
依赖 点击 Show data type assistant 按钮启用这个参数。
命令行信息 见 Block-Specific Parameters .
参考 见 Specify Data Types Using Data Type Assistant
Scaling
指定调整您的固定点数据，以避免溢出条件，尽量减少量化误差的方法。
设置 默认:Best
precision
Binary point
指定二进制点的位置。
Slope and bias
输入 slope 和 bias.
Best precision
Specify best-precision values.
依存关系 选择 Mode>Fixed
point 启用此参数。
选择 Binary
point 启用:
? ?
Fraction length Calculate Best-Precision Scaling 选择 Slope
and bias 启用:
? ? ?
Slope Bias Calculate Best-Precision Scaling 命令行信息 See Block-Specific Parameters .
参考 见 Specifying a Fixed-Point Data Type.
实例
以下 Simulink 的示例显示了如何使用 Gain 模块：
? ? ? ?
sldemo_bounce sldemo_tonegen_fixpt sldemo_hardstop sldemo_enginewc 特征
直接馈通
是
采样时间
在 Sample time 参数里指定
标量扩展
是，输入和 Gain 参数为 Element-wise(K.*u)乘法
量纲
是
多量纲
是,
仅当 Multiplication 参数指定 Element-wise(K.*u)
过零检测
丌