Dot Product

生成两个向量的点积

库:
Simulink / Math Operations
HDL Coder / Math Operations

描述

Dot Product 模块生成输入向量的点积。标量输出 y 等于 MATLAB^® 运算

y = sum(conj(u1) .* u2 )

其中 u1 和 u2 表示输入向量。输入可以是向量、列向量（单列矩阵）或标量。如果两个输入都是向量或者都是列向量，它们的长度必须相同。如果 u1 和 u2 都是列向量，模块将输出 MATLAB 表达式 u1'*u2 的等效项。

输入向量的元素可以是实数值或复数值信号。输出的信号类型（复信号或实信号）取决于输入的信号类型。

输入 1	输入 2	输出
实信号	实数	实数
实数	复数	复数
复信号	实信号	复数
复数	复数	复信号

示例

端口

输入

全部展开

Port_1 — 第一个操作数输入信号
标量 | 向量

表示点积计算的第一个操作数的信号。

Port_2 — 第二个操作数输入信号
标量 | 向量

代表点积计算的第二个操作数的信号。

输出

全部展开

Port_1 — 点积输出信号
标量 | 向量

由两个输入信号的点积计算得到的输出信号。

参数

全部展开

要求所有输入具有相同的数据类型 — 要求所有输入具有相同的数据类型
`on` (默认) | `off`

清除此复选框可使各个输入具有不同数据类型。

编程用法

模块参数：InputSameDT

类型：字符向量

值：'on' | 'off'

默认值：'on'

输出最小值 — 范围检查的最小输出值
`[]` (默认) | 标量

软件检查的输出范围的下限值。

软件使用最小值执行下列操作：

某些模块的参数范围检查（请参阅指定模块参数的最小值和最大值）。
仿真范围检查（请参阅指定信号范围和启用仿真范围检查）。
定点数据类型的自动定标。
从模型生成的代码的优化。此优化可删除算法代码，并影响某些仿真模式（如 SIL 或外部模式）的结果。有关详细信息，请参阅使用指定的最小值和值进行优化 (Embedded Coder)。

提示

输出最小值不会对实际输出信号进行饱和处理或截断。请改用 Saturation 模块。

编程用法

要以编程方式设置模块参数值，请使用 set_param 函数。

参数:	`OutMin`
值:	`'[]'` (默认) \| scalar in quotes

输出最大值 — 范围检查的最大输出值
`[]` (默认) | 标量

将 Simulink^® 检查的输出范围的上限值指定为有限的双精度实数标量值。

注意

如果您指定总线对象作为此模块的数据类型，请不要为模块的总线数据设置最大值。因为 Simulink 会忽略此设置。但请为指定作为数据类型的总线对象的总线元素设置最大值。有关总线元素的“最大值”参数的信息，请参阅 Simulink.BusElement。

Simulink 使用最大值执行下列操作：

某些模块的参数范围检查（请参阅指定模块参数的最小值和最大值）。
仿真范围检查（请参阅指定信号范围和启用仿真范围检查）。
定点数据类型的自动定标。
从模型生成的代码的优化。此优化可删除算法代码，并影响某些仿真模式（如 SIL 或外部模式）的结果。有关详细信息，请参阅使用指定的最小值和值进行优化 (Embedded Coder)。

注意

输出最大值不会对实际输出信号进行饱和处理或截断。请改用 Saturation 模块。

编程用法

模块参数：OutMax

类型：字符向量

值：标量

默认值：'[ ]'

输出数据类型 — 指定输出数据类型
继承: 从内部规则继承 (默认) | 继承: 通过反向传播继承 | 继承: 与第一个输入相同 | double | single | half | int8 | uint8 | int16 | uint16 | int32 | uint32 | int64 | uint64 | fixdt(1,16) | fixdt(1,16,0) | fixdt(1,16,2^0,0) | <数据类型表达式>

为输出选择数据类型。该类型可以继承、直接指定或表示为数据类型对象，如 Simulink.NumericType。有关详细信息，请参阅控制信号的数据类型。

当您选择继承的选项时，模块的行为如下所示：

继承: 从内部规则继承 - Simulink 在考虑嵌入式目标硬件的属性的同时，会选择相应的数据类型来平衡数值准确性、性能和生成的代码大小。如果更改了嵌入式目标的设置，则依内部规则选择的数据类型可能会发生变化。例如，如果该模块将 int8 类型的输入乘以 int16 的增益，并且将 ASIC/FPGA 指定为目标硬件类型，则输出数据类型为 sfix24。如果指定未指定(假定通用 32 位)（即通用 32 位微处理器）为目标硬件，则输出数据类型为 int32。如果目标微处理器不能提供适应输出范围的字长，Simulink 软件将在诊断查看器中显示错误。
有时软件不能同时满足优化代码效率和保证数值准确性这两个需求。如果内部规则不能满足您对数值准确性或性能的特定需求，请使用下列选项之一：
- 显式指定输出数据类型。
- 使用简单的选项继承: 与输入相同。
- 显式指定默认数据类型（例如 fixdt(1,32,16)），然后使用定点工具为您的模型提供数据类型建议。有关详细信息，请参阅 fxptdlg (Fixed-Point Designer)。
- 要指定您自己的继承规则，请使用继承: 通过反向传播继承，然后使用 Data Type Propagation 模块。有关如何使用此模块的示例说明，请参阅 Signal Attributes 模块库中的 Data Type Propagation Examples 模块。
注意
当输入是小于单精度的浮点数据类型时，Inherit: Inherit via internal rule 取决于 Inherit floating-point output type smaller than single precision 配置参数的设置。当对数据类型进行编码所需的位数小于对单精度数据类型编码所需的 32 位时，数据类型小于单精度。例如，half 和 int16 小于单精度。
继承: 通过反向传播继承 - 使用驱动模块的数据类型。
继承: 与第一个输入相同 - 使用第一个输入信号的数据类型。

编程用法

模块参数：OutDataTypeStr

类型：字符向量

默认值：'Inherit: Inherit via internal rule'

锁定输出数据类型设置以防止被定点工具更改 — 防止定点工具覆盖数据类型
`off` (默认) | `on`

选中此选项将锁定此模块的输出数据类型设置，从而防止通过定点工具和定点顾问进行更改。有关详细信息，请参阅Use Lock Output Data Type Setting (Fixed-Point Designer)。

编程用法

模块参数：LockScale

类型：字符向量

值：'off' | 'on'

默认值：'off'

整数舍入模式 — 定点运算的舍入模式
向下 (默认) | 向上 | 收敛 | 最邻近值 | 舍入 | 最简 | 零

指定定点运算的舍入模式。有关详细信息，请参阅舍入模式 (Fixed-Point Designer)。

模块参数始终舍入到最邻近的可表示值。要控制模块参数的舍入方法，请在封装字段中使用 MATLAB 舍入函数输入表达式。

编程用法

要以编程方式设置模块参数值，请使用 set_param 函数。

参数:	`RndMeth`
值:	`'Floor'` (默认) \| `'Ceiling'` \| `'Convergent'` \| `'Nearest'` \| `'Round'` \| `'Simplest'` \| `'Zero'`

对整数溢出进行饱和处理 — 溢出操作的方法
`off` (默认) | `on`

指定对溢出是进行饱和处理还是绕回处理。

on - 将溢出饱和处理为数据类型能够表示的最小值或最大值。
off - 溢出将绕回到数据类型可以表示的合适值。

例如，有符号 8 位整数 int8 可以表示的最大值是 127。任何大于此最大值的模块运算结果都会导致 8 位整数溢出。

选择此参数后，模块输出将在达到 127 时饱和。类似地，模块输出将在达到最小输出值 -128 时饱和。
清除此参数后，软件会将导致溢出的值解释为 int8，这可能产生意外结果。例如，以 int8 表示的模块结果 130（二进制 1000 0010）为 -126。

提示

如果您的模型存在可能的溢出，而您希望在生成的代码中进行显式饱和保护，请考虑选中此参数。
如果您希望优化生成的代码的效率，请考虑清除此参数。清除此参数还可以帮助您避免过度地指定信号超出范围时模块的处理方式。有关详细信息，请参阅信号范围错误故障排除。
如果选中此参数，饱和将应用于模块中的每个内部操作，而不仅仅应用于输出或结果。
一般情况下，代码生成进程可以检测到何时不可能发生溢出。在这种情况下，代码生成器不会生成饱和代码。

编程用法

要以编程方式设置模块参数值，请使用 set_param 函数。

参数:	`SaturateOnIntegerOverflow`
值:	`'off'` (默认) \| `'on'`

模块特性

数据类型	`Boolean` \| `double` \| `fixed point` \| `half` \| `integer` \| `single`
直接馈通	`是`
多维信号	`是`
可变大小信号	`否`
过零检测	`否`

详细信息

全部展开

模型覆盖率

如果您有 Simulink Coverage™ 许可证，并且选择对整数溢出进行饱和处理 (Simulink Coverage)参数，则 Dot Product 模块将接收整数溢出饱和覆盖率。有关详细信息，请参阅整数溢出饱和处理覆盖率 (Simulink Coverage)。

扩展功能

全部展开

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

HDL Coder™ 提供影响 HDL 实现和综合逻辑的额外配置选项。

HDL 架构

架构	描述
线性（默认值）	生成线性加法器链来计算乘积之和。
树	生成加法器树形结构来计算乘积之和。

HDL 模块属性

通用
InputPipeline	要在生成的代码中插入的输入流水线阶段数。分布式流水线和受限输出流水线可以移动这些寄存器。默认值为 `0`。有关详细信息，请参阅InputPipeline (HDL Coder)。
OutputPipeline	要在生成的代码中插入的输出流水线阶段数。分布式流水线和受限输出流水线可以移动这些寄存器。默认值为 `0`。有关详细信息，请参阅OutputPipeline (HDL Coder)。
ConstrainedOutputPipeline	通过移动设计中现有延迟的方式来放置在输出端的寄存器的数量。分布式流水线不会重新分发这些寄存器。默认值为 `0`。有关详细信息，请参阅ConstrainedOutputPipeline (HDL Coder)。

原生浮点
HandleDenormals	指定是否希望 HDL Coder 在设计中插入额外的逻辑来处理非正规数字。非正规数是大小非常小、必须使用包含前导零的尾数才能表示的浮点数。默认值为 inherit。另请参阅HandleDenormals (HDL Coder)。
LatencyStrategy	指定对于浮点运算符是否将设计中的模块映射到 `inherit`、`Max`、`Min` 或 `Zero`。默认值为 inherit。另请参阅LatencyStrategy (HDL Coder)。
MantissaMultiplyStrategy	指定在代码生成期间如何实现尾数乘法运算。通过使用不同设置，您可以控制目标 FPGA 设备上 DSP 的使用。默认值为 inherit。另请参阅MantissaMultiplyStrategy (HDL Coder)。

Dot Product

描述

示例

可变大小信号长度自适应

多模可变大小信号

端口

输入

Port_1 — 第一个操作数输入信号
标量 | 向量

Port_2 — 第二个操作数输入信号
标量 | 向量

输出

Port_1 — 点积输出信号
标量 | 向量

参数

要求所有输入具有相同的数据类型 — 要求所有输入具有相同的数据类型
`on` (默认) | `off`

编程用法

输出最小值 — 范围检查的最小输出值
`[]` (默认) | 标量

提示

编程用法

输出最大值 — 范围检查的最大输出值
`[]` (默认) | 标量

编程用法

编程用法

锁定输出数据类型设置以防止被定点工具更改 — 防止定点工具覆盖数据类型
`off` (默认) | `on`

编程用法

整数舍入模式 — 定点运算的舍入模式
向下 (默认) | 向上 | 收敛 | 最邻近值 | 舍入 | 最简 | 零

编程用法

对整数溢出进行饱和处理 — 溢出操作的方法
`off` (默认) | `on`

提示

编程用法

模块特性

详细信息

模型覆盖率

扩展功能

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

PLC 代码生成
使用 Simulink® PLC Coder™ 生成结构化文本代码。

定点转换
使用 Fixed-Point Designer™ 设计和仿真定点系统。

版本历史记录

另请参阅

Dot Product

描述

示例

可变大小信号长度自适应

多模可变大小信号

端口

输入

Port_1 — 第一个操作数输入信号 标量 | 向量

Port_2 — 第二个操作数输入信号 标量 | 向量

输出

Port_1 — 点积输出信号 标量 | 向量

参数

要求所有输入具有相同的数据类型 — 要求所有输入具有相同的数据类型 on (默认) | off

编程用法

输出最小值 — 范围检查的最小输出值 [] (默认) | 标量

提示

编程用法

输出最大值 — 范围检查的最大输出值 [] (默认) | 标量

编程用法

编程用法

锁定输出数据类型设置以防止被定点工具更改 — 防止定点工具覆盖数据类型 off (默认) | on

编程用法

整数舍入模式 — 定点运算的舍入模式 向下 (默认) | 向上 | 收敛 | 最邻近值 | 舍入 | 最简 | 零

编程用法

对整数溢出进行饱和处理 — 溢出操作的方法 off (默认) | on

提示

编程用法

模块特性

详细信息

模型覆盖率

扩展功能

C/C++ 代码生成 使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

HDL 代码生成 使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

PLC 代码生成 使用 Simulink® PLC Coder™ 生成结构化文本代码。

定点转换 使用 Fixed-Point Designer™ 设计和仿真定点系统。

版本历史记录

另请参阅

Port_1 — 第一个操作数输入信号
标量 | 向量

Port_2 — 第二个操作数输入信号
标量 | 向量

Port_1 — 点积输出信号
标量 | 向量

要求所有输入具有相同的数据类型 — 要求所有输入具有相同的数据类型
`on` (默认) | `off`

输出最小值 — 范围检查的最小输出值
`[]` (默认) | 标量

输出最大值 — 范围检查的最大输出值
`[]` (默认) | 标量

锁定输出数据类型设置以防止被定点工具更改 — 防止定点工具覆盖数据类型
`off` (默认) | `on`

整数舍入模式 — 定点运算的舍入模式
向下 (默认) | 向上 | 收敛 | 最邻近值 | 舍入 | 最简 | 零

对整数溢出进行饱和处理 — 溢出操作的方法
`off` (默认) | `on`

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

PLC 代码生成
使用 Simulink® PLC Coder™ 生成结构化文本代码。

定点转换
使用 Fixed-Point Designer™ 设计和仿真定点系统。