additionLayer

R2026b

加法层

全页展开

描述

加法层按元素将来自多个神经网络层的输入相加。

创建对象

语法

layer = additionLayer(numInputs)

layer = additionLayer(numInputs,Name=name)

描述

layer = additionLayer(numInputs) 创建一个加法层并设置 NumInputs 属性。

示例

layer = additionLayer(numInputs,Name=name) 还设置可选的 Name 属性。例如，additionLayer(3,Name="add") 创建一个包含三个输入的加法层，并将名称设置为 "add"。

示例

输入参量

全部展开

`numInputs` — 输入数目
正整数

层的输入数，指定为大于或等于 2 的正整数。

输入的名称为 'in1'、'in2' 和 'inN'，其中 N 是输入数。例如，如果输入数为 3，则输入的名称为 'in1'、'in2' 和 'in3'。使用 connectLayers 或 disconnectLayers 函数连接层或断开层时，请使用这些输入名称。

此参量设置 NumInputs 属性。

`name` — 层名称
`""` (默认) | 字符向量 | 字符串标量

层名称，指定为字符向量或字符串标量。对于 Layer 数组输入，trainnet 和 dlnetwork 函数会自动为未命名层指定名称。

此参量设置 Name 属性。

数据类型: char | string

属性

全部展开

`NumInputs` — 输入数目
正整数

此属性在创建对象后是只读的。要设置此属性，请在创建 AdditionLayer 对象时使用对应的位置输入参量。

层的输入数，表示为大于或等于 2 的正整数。

数据类型: double

`Name` — 层名称
`''` (默认) | 字符向量

层名称，指定为字符向量。对于 Layer 数组输入，trainnet 和 dlnetwork 函数会自动为未命名层指定名称。

数据类型: char

`InputNames` — 输入名称
只读: `{'in1','in2',…,'inN'}` (默认)

此属性为只读。

输入名称，表示为 {'in1','in2',...,'inN'}，其中 N 是层的输入数。

数据类型: cell

`NumOutputs` — 输出的数目
只读: `1` (默认)

此属性为只读。

层的输出数，表示为 1。此层只有一个输出。

数据类型: double

`OutputNames` — 输出名称
只读: `{'out'}` (默认)

此属性为只读。

输出名称，表示为 {'out'}。此层只有一个输出。

示例

全部折叠

创建并连接加法层

打开实时脚本

创建一个空的神经网络 dlnetwork 对象，并添加一个包含两个输入且名称为 'add' 的加法层。

net = dlnetwork;
layer = additionLayer(2,'Name','add');
net = addLayers(net,layer);

向神经网络添加两个 ReLU 层，并将它们连接到加法层。加法层输出 ReLU 层的输出总和。

layer = reluLayer('Name','relu1');
net = addLayers(net,layer);
net = connectLayers(net,'relu1','add/in1');

layer = reluLayer('Name','relu2');
net = addLayers(net,layer);
net = connectLayers(net,'relu2','add/in2');

在图中可视化更新后的网络。

plot(net)

Figure contains an axes object. The axes object contains an object of type graphplot.

算法

全部展开

层输入和输出格式

层数组或层图中的大多数层将数据作为格式化的 dlarray 对象传递给后续层。dlarray 对象的格式是字符串，其中每个字符描述数据的对应维度。格式由以下一个或多个字符组成：

"S" - 空间
"C" - 通道
"B" - 批量
"T" - 时间
"U" - 未指定

例如，您可以将以四维数组表示的二维图像数据（其中前两个维度对应于图像的空间维度，第三个维度对应于图像的通道，第四个维度对应于批量维度）的格式描述为 "SSCB"（空间、空间、通道、批量）。

您可以在自动微分工作流中与这些 dlarray 对象进行交互，例如以下工作流：

开发自定义层
使用 functionLayer 对象
对 dlnetwork 对象使用 forward 和 predict 函数

下表显示 AdditionLayer 对象支持的输入格式以及对应的输出格式。如果软件将层的输出传递给不从 nnet.layer.Formattable 类继承的自定义层，或传递给 Formattable 属性设置为 0 (false) 的 FunctionLayer 对象，则该层会接收到未格式化的 dlarray 对象，其维度顺序对应于下表中的格式。此处列出的格式只是该层所支持格式的一部分。该层可能支持其他格式，例如具有附加 "S"（空间）或 "U"（未指定）维度的格式。

输入格式	输出格式
`"CB"`（通道、批量）	`"CB"`（通道、批量）
`"SCB"`（空间、通道、批量）	`"SCB"`（空间、通道、批量）
`"SSCB"`（空间、空间、通道、批量）	`"SSCB"`（空间、空间、通道、批量）
`"SSSCB"`（空间、空间、空间、通道、批量）	`"SSSCB"`（空间、空间、空间、通道、批量）
`"CBT"`（通道、批量、时间）	`"CBT"`（通道、批量、时间）
`"SCBT"`（空间、通道、批量、时间）	`"SCBT"`（空间、通道、批量、时间）
`"SSCBT"`（空间、空间、通道、批量、时间）	`"SSCBT"`（空间、空间、通道、批量、时间）
`"SSSCBT"`（空间、空间、空间、通道、批量、时间）	`"SSSCBT"`（空间、空间、空间、通道、批量、时间）
`"CU"`（通道、未指定）	`"CU"`（通道、未指定）
`"SC"`（空间、通道）	`"SC"`（空间、通道）
`"SSC"`（空间、空间、通道）	`"SSC"`（空间、空间、通道）
`"SSSC"`（空间、空间、空间、通道）	`"SSSC"`（空间、空间、空间、通道）
`"BU"`（批量、未指定）	`"BU"`（批量、未指定）

如果多个输入格式包含相同的标签，则每个输入的相应数据必须是单一数据，或者与其他输入的非单一数据的大小相同。如果一个输入格式包含多个 U 或 S 标签，则 additionLayer 会按标签出现顺序将每个标签与其他输入格式中的标签进行匹配。

在 dlnetwork 对象中，AdditionLayer 对象还支持以下输入和输出格式组合。

输入格式	输出格式
`"CT"`（通道、时间）	`"CT"`（通道、时间）
`"SCT"`（空间、通道、时间）	`"SCT"`（空间、通道、时间）
`"SSCT"`（空间、空间、通道、时间）	`"SSCT"`（空间、空间、通道、时间）
`"SSSCT"`（空间、空间、空间、通道、时间）	`"SSSCT"`（空间、空间、空间、通道、时间）

复数

AdditionLayer 对象支持复数值输入和输出 (自 R2024a 起)。该层对复数值输入应用与对实数值输入相同的底层运算，并在适用的情况下输出复数值数据。

扩展功能

全部展开

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

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

版本历史记录

在 R2017b 中推出

全部展开

R2024a: 支持复数值输入和输出

AdditionLayer 对象支持复数值输入和输出。该层对复数值输入应用与对实数值输入相同的底层运算，并在适用的情况下输出复数值数据。

另请参阅

additionLayer

描述

创建对象

语法

描述

输入参量

numInputs — 输入数目 正整数

name — 层名称 "" (默认) | 字符向量 | 字符串标量

属性

NumInputs — 输入数目 正整数

Name — 层名称 '' (默认) | 字符向量

InputNames — 输入名称 只读: {'in1','in2',…,'inN'} (默认)

NumOutputs — 输出的数目 只读: 1 (默认)

OutputNames — 输出名称 只读: {'out'} (默认)

示例

创建并连接加法层

算法

层输入和输出格式

复数

扩展功能

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

GPU 代码生成 使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

版本历史记录

R2024a: 支持复数值输入和输出

另请参阅

主题

`numInputs` — 输入数目
正整数

`name` — 层名称
`""` (默认) | 字符向量 | 字符串标量

`NumInputs` — 输入数目
正整数

`Name` — 层名称
`''` (默认) | 字符向量

`InputNames` — 输入名称
只读: `{'in1','in2',…,'inN'}` (默认)

`NumOutputs` — 输出的数目
只读: `1` (默认)

`OutputNames` — 输出名称
只读: `{'out'}` (默认)

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

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。