主要内容

获得

输入乘以常数

  • 库:
  • 金宝appSimulink /常用块

    金宝appSimulink /数学运算

    HDL编码器/常用模块

    HDL编码器/ HDL浮点运算

    HDL编码/数学运算

  • 获得块

描述

增益模块将输入乘以一个常量(增益)。输入和增益都可以是标量、矢量或矩阵。

中指定增益的值获得参数。的乘法参数允许您指定元素或矩阵乘法。对于矩阵乘法,该参数还允许您指示乘数的顺序。

增益从双精度转换为离线块掩码中指定的数据类型,使用逐近取整数和饱和度。然后将输入和增益相乘,并使用指定的舍入和溢出模式将结果转换为输出数据类型。

港口

输入

全部展开

增益模块接受实值或复值标量、矢量或矩阵输入。增益块支持定点数据类型。金宝app如果增益块的输入是实数并且增益是复数,则输出是复数。

数据类型:一半|||int8|int16|int32|int64|uint8|uint16|uint32|uint64|布尔|不动点

输出

全部展开

增益模块输出输入乘以恒定增益值。当增益块的输入是实数且增益是复数时,输出是复数的。

数据类型:一半|||int8|int16|int32|int64|uint8|uint16|uint32|uint64|布尔|不动点

参数

全部展开

主要

指定输入乘以的值。增益可以是实值或复值标量、矢量或矩阵。

编程使用

块参数:获得
类型:特征向量
价值观:'1' |实值或复值标量、向量或矩阵
默认值:' 1 '

指定下列乘法模式之一:

  • Element-wise (k . * u)-输入的每个元素乘以增益的每个元素。如果有必要,该块执行展开,使输入和增益具有相同的维数。

  • 矩阵(K * u)—输入和增益以输入作为第二个操作数进行矩阵相乘。

  • 矩阵(u * K)—输入和增益以输入作为第一个操作数进行矩阵相乘。

  • 矩阵(K*u) (u向量)—输入和增益是矩阵乘以输入作为第二个操作数。此模式与矩阵(K * u),除了尺寸是如何确定的。

    假设K是一个m×n的矩阵。矩阵(K * u) (u向量)将输入设置为一个长度的向量n它的输出是一个长度为。相比之下,矩阵(K * u)使用传播来确定输入和输出的维度。对于一个m×n的增益矩阵,输入可以传播到一个n-by-q矩阵,输出就变成了m-by-q矩阵。

编程使用

参数:乘法
类型:特征向量
值:“Element-wise (K . * u)”|“矩阵(K * u)”|“矩阵(u * K)”|“矩阵(K * u) (u向量)”
默认值:“Element-wise (k . * u)”

将采样时间指定为-1以外的值。有关更多信息,请参见指定采样时间

依赖关系

这个参数是不可见的,除非它被显式地设置为一个值1。要了解更多信息,请参见不推荐采样时间的块

编程使用

块参数:SampleTime
类型:特征向量
价值观:标量或向量
默认值:' 1 '

信号的属性

较低的输出范围值,Simulink金宝app®检查。

金宝appSimulink使用最小值来执行:

请注意

输出最小不饱和或剪辑实际输出信号。使用饱和块来代替。

编程使用

块参数OutMin
类型:字符向量
“[]”|标量
默认的“[]”

Simulink检测输出范围的最大值。金宝app

金宝appSimulink使用最大值来执行:

请注意

输出最大不饱和或剪辑实际输出信号。使用饱和块来代替。

编程使用

块参数OutMax
类型:字符向量
“[]”|标量
默认的“[]”

选择输出的数据类型。类型可以继承、直接指定或表示为数据类型对象,例如金宝app仿真软件。NumericType

当你选择一个继承的选项时,块显示这些行为:

  • 继承:通过内部规则继承- 金宝appSimulink选择一种数据类型来平衡数值精度、性能和生成的代码大小,同时考虑到嵌入式目标硬件的属性。如果更改嵌入式目标设置,则内部规则选择的数据类型可能会更改。例如,如果块乘以类型为的输入int8再一次int16ASIC / FPGA指定为目标硬件类型,则输出数据类型为sfix24。如果未指定(假设32位通用)换句话说,一个通用的32位微处理器,被指定为目标硬件,输出数据类型为int32。如果目标微处理器提供的字长都不能满足输出范围,则Simulink软件在诊断查看器中显示错误。金宝app

  • 继承:保留MSB- 金宝appSimulink选择一种数据类型,保持操作的全部范围,然后将输出精度降低到适合嵌入式目标硬件的大小。

    提示

    要生成更高效的代码,请取消选择使整数溢出饱和参数。

    此规则永远不会产生溢出。

  • 继承:匹配缩放—S金宝appimulink选择一个数据类型,该数据类型的缩放与输入类型的缩放相匹配。如果该类型的全部范围不适合嵌入式目标硬件,则减小该范围,产生适合嵌入式目标硬件的类型。该规则可能会产生溢出。

    软件并不总是能够同时优化代码效率和数值精度。如果这些内部规则不能满足您对数值精度或性能的特定需求,请使用以下选项之一:

    • 显式指定输出数据类型。

    • 使用简单的选择继承:与输入相同

    • 显式指定默认数据类型,例如fixdt(1, 32岁,16)然后使用定点工具为您的模型提出数据类型。有关更多信息,请参见fxptdlg(定点设计师)

    • 要指定您自己的继承规则,请使用继承:通过反向传播继承然后使用a数据类型传播块。如何使用此块的示例可在信号属性库中获得数据类型传播示例块。

  • 继承:通过反向传播继承—使用驱动块的数据类型。

  • 继承:与输入相同—使用数据类型的输入信号。

依赖关系

当输入是小于单精度的浮点数据类型时继承:通过内部规则继承控件的设置决定了输出数据类型继承小于单精度的浮点输出类型配置参数。当编码数据类型所需的位数少于编码单精度数据类型所需的32位时,数据类型小于单精度数据类型。例如,一半int16都小于单精度。

编程使用

块参数OutDataTypeStr
类型:字符向量
“继承:通过内部规则继承”|“继承:保留MSB”|“继承:匹配缩放”|“继承:与输入相同”|“继承:通过反向传播继承”|“单一”|“一半”|“int8”|“uint8”|“int16”|“uint16”|“int32”|“uint32”|“int64”|“uint64”|“fixdt(16)”|“fixdt(0) 1, 16日”|“fixdt(1, 16日2 ^ 0,0)”|'<数据类型表达式>'
默认的“继承:通过内部规则继承”

选择此参数可防止定点工具覆盖输出在块上指定的数据类型。有关更多信息,请参见使用锁输出数据类型设置(定点设计师)

编程使用

块参数:LockScale
类型:特征向量
价值观:'off' b| 'on'
默认值:“关闭”

指定定点操作的舍入模式。有关更多信息,请参见舍入(定点设计师)

块参数总是四舍五入到最接近的可表示值。要控制块参数的舍入,请使用MATLAB输入表达式®舍入函数到掩码字段。

编程使用

块参数:RndMeth
类型:特征向量
价值观:'Ceiling' | 'Convergent' | 'Floor' | 'Nearest' | 'Round' | ' most ' | 'Zero'
默认值:“地板”

指定溢出是饱和溢出还是自动溢出。

行动 基本原理 对溢出的影响 例子

选择此复选框().

您的模型可能存在溢出,并且您希望在生成的代码中显式地进行饱和保护。

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

最大值int8(有符号,8位整数)数据类型可以表示为127。任何大于这个最大值的块操作结果都会导致8位整数溢出。选中复选框后,块输出饱和值为127。同样,块输出在最小输出值-128时达到饱和。

不要选择此复选框().

您希望优化生成代码的效率。

您希望避免过度指定块如何处理超出范围的信号。有关更多信息,请参见排除信号范围误差

溢出将自动换行到可由数据类型表示的适当值。

最大值int8(有符号,8位整数)数据类型可以表示为127。任何大于这个最大值的块操作结果都会导致8位整数溢出。清除复选框后,软件将导致溢出的值解释为int8,这可能会产生意想不到的结果。例如,块结果130(二进制10000010)表示为int8等于-126。

当您选择此复选框时,饱和度适用于块上的每个内部操作,而不仅仅是输出或结果。通常,代码生成进程可以检测到何时不可能发生溢出。在这种情况下,代码生成器不会生成饱和代码。

编程使用

块参数:SaturateOnIntegerOverflow
类型:特征向量
价值观:'off' b| 'on'
默认值:“关闭”

参数属性

指定增益的最小值。默认值为[](不明)。金宝appSimulink使用这个值来执行:

编程使用

块参数ParamMin
类型:字符向量
价值:标量
默认的“[]”

指定增益的最大值。默认值为[](不明)。金宝appSimulink使用这个值来执行:

编程使用

块参数ParamMax
类型:字符向量
价值:标量
默认的“[]”

的数据类型获得参数。

编程使用

块参数ParamDataTypeStr
类型:字符向量
继承:通过内部规则继承|“继承:与输入相同”|“继承:通过反向传播继承”|“单一”|“一半”|“int8”|“uint8”|“int16”|“uint16”“int32”|“uint32”|“int64”|“uint64”|“fixdt(16)”|“fixdt(0) 1, 16日”|“fixdt(1, 16日2 ^ 0,0)”|'<数据类型表达式>'
默认的“继承:通过内部规则继承”

块特征

数据类型

布尔||不动点|一半|整数|

直接引线

是的

多维信号

是的

适应信号

是的

讨论二阶导数过零检测

没有

扩展功能

C/ c++代码生成
使用Simulink®Coder™生成C和c++代码。金宝app

PLC代码生成
生成结构化文本代码使用Simulink®PLC编码器™。金宝app

定点转换
使用定点设计器™设计和模拟定点系统。

另请参阅

|

R2006a之前引入