主要内容

avgpool

将数据集合到空间维度上的平均值

描述

平均池化操作通过将输入划分为池化区域并计算每个区域的平均值来执行向下采样。

请注意

该函数将平均池操作应用于dlarray数据。如果你想应用平均池layerGraph对象或数组,使用以下层之一:

例子

海底= avgpool (dlX池化通过除以输入执行下采样dlX成长方形或长方体的区域池化并计算各区域数据的平均值。输入dlX是一个格式化的dlarray与尺寸标签。池作用于标记的空间维度“年代”.输出海底是一个格式化的dlarray尺寸标签与dlX

例子

海底= avgpool (dlX池化名称,值使用一个或多个名称值对参数指定选项。例如,“步”,3设置池操作的步长。

例子

海底= avgpool (dlX, '全球')计算输入的空间维度的全局平均值dlX.这个语法等价于setting池化在前面的语法中“年代”的尺寸dlX

例子

海底= avgpool (___、“DataFormat”FMT)指定维度格式FMTdlX不是格式化的dlarray,除了前面语法中的输入参数。输出海底是一个非格式化dlarray尺寸顺序和dlX

例子

全部折叠

将数据集合到两个空间维度上的平均值。

将输入数据创建为dlarray.该数据包含高度和宽度为6的随机值的单个观测值和单个通道。

身高= 6;宽度= 6;渠道= 1;观察= 1;X =兰德(高度、宽度、通道观测);dlX = dlarray (X,“SSCB”
dlX = 6(S) × 6(S) × 1(C) × 1(B)美元0.1781 0.8819 0.1564 0.4820 0.2518 0.7302 0.1280 0.6692 0.8555 0.1206 0.2904 0.3439 0.9991 0.1904 0.6448 0.5895 0.6171 0.5841 0.1711 0.3689 0.3763 0.2262 0.2653 0.1078 0.0326 0.4607 0.1909 0.3846 0.8244 0.9063 0.5612 0.9816 0.4283 0.5830 0.9827 0.8797

将数据池为大小相同的池区域的平均值2用一大步2

海底= avgpool (dlX 2“步”, 2)
dlY = 3(S) × 3(S) × 1(C) × 1(B)美元0.4643 0.4036 0.4041

集合数据到其全球平均值。

将输入数据创建为未格式化的dlarray.该数据包含一个高度为4、宽度为6和单个通道的随机值的单个观测值。

身高= 4;宽度= 6;渠道= 1;观察= 1;X =兰德(高度、宽度、通道观测);dlX = dlarray (X)
dlX = 4×6美元0.8147 0.6324 0.9575 0.9572 0.4218 0.6557 0.9058 0.0975 0.9649 0.4854 0.9157 0.0357 0.1270 0.2785 0.1576 0.8003 0.7922 0.8491 0.9134 0.5469 0.9706 0.1419 0.9595 0.9340

将数据集中到全局平均值中。指定输入数据的维度格式。

海底= avgpool (dlX,“全球”“DataFormat”“SSCB”
= 1×1 dlarray 0.6381

输入参数

全部折叠

输入数据,指定为dlarray有或没有尺寸标签。当dlX不是格式化的dlarray,则必须使用'dataformat',fmt

属性指定为空间维度时,池作用于维度“年代”尺寸标签。dlX必须至少有一个“年代”维度。您可以指定最多三个维度dlX作为“年代”方面。的avgpool操作将数据沿着每一个进行分割“年代”定义的区域的维度池化.每个池区域内的值平均。

数据类型:|

池区域的大小,指定为数字标量或数字向量。如果您指定池化作为一个标量,池区域在所有空间维度上具有相同的大小。若要使用沿每个空间维度具有不同大小的矩形或长方体池区域,请指定池化作为一个长度与空间维度数相同的向量dlX

例子:3.

数据类型:|

名称-值对的观点

指定可选的逗号分隔的对名称,值参数。的名字参数名和价值为对应值。的名字必须出现在引号内。可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:“步”,2指定池区域的步长为2

未格式化的输入数据的维度顺序,指定为逗号分隔对组成“DataFormat”和一个字符数组或字符串FMT为数据的每个维度提供一个标签。每个字符在FMT必须是下列情况之一:

  • “年代”——空间

  • “C”——频道

  • “B”-批次(例如,样品和观察)

  • “T”-时间(例如,序列)

  • “U”——未指明的

您可以指定多个标注的维度“年代”要么“U”.你可以使用标签“C”“B”,“T”最多一次。

您必须指定“DataFormat”当输入数据dlX不是格式化的dlarray

例子:“DataFormat”、“SSCB”

数据类型:字符|字符串

遍历输入数据的步长,指定为逗号分隔的对,由“步”和数字标量或数字向量。如果您指定“步”作为标量,所有空间维度都使用相同的值。如果您指定“步”作为与输入数据的空间尺寸的数量相同的尺寸的矢量,矢量值用于相应的空间尺寸。

的默认值“步”1.如果“步”小于池化在任何维度中,池区域都是重叠的。

的全局池不支持金宝app“全球”选择。

例子:“步”,3

数据类型:|

应用于数据边缘的填充大小,指定为逗号分隔对,由“填充”以及以下其中之一:

  • “相同”-设置填充大小,以便当步幅为时输出大小与输入大小相同1.更一般地说,每个空间维度的输出大小为装天花板(inputSize /步),在那里inputSize是沿空间维度输入的大小。

  • 数字标量 - 将相同量的填充应用于所有空间尺寸的两端。

  • 数值矢量 - 沿每个空间尺寸施加不同量的填充。使用大小的矢量d,在那里d是输入数据的空间维数。的载体的元素指定填充到开始的填充大小和沿着空间维度。

  • 数字矩阵-对每个空间维度的开始和结束应用不同数量的填充。使用大小为2 × -的矩阵d,在那里d是输入数据的空间维数。的元素(d)指定应用于空间维度开始的填充的大小d.的元素(2 d)指定应用于空间维度末尾的填充的大小d.例如,在2d中,格式为[左上方;底部,右]

“填充”的全局池不支持金宝app“全球”选择。

例子:'填充','同样'

数据类型:|

用于填充输入的值,指定为0要么“的意思是”

当你使用“填充”选项添加填充到输入,应用的填充值可以是下列之一:

  • 0—输入在指定的位置用零填充“填充”选择。填充区域包含在沿边缘的池化区域平均值的计算中。

  • “的意思是”属性指定位置的池区域的平均值填充输入“填充”选择。在计算每个池化区域的平均值时,有效地将填充区域排除在外。

例子:“PaddingValue”,“的意思是”

输出参数

全部折叠

集合的数据,作为dlarray.输出海底具有与输入相同的底层数据类型dlX

如果输入数据dlX是一个格式化的dlarray海底有相同的尺寸标签dlX.如果输入数据没有格式化dlarray海底是一个非格式化dlarray与输入数据的维度顺序相同。

更多关于

全部折叠

平均分担

avgpool函数将输入数据池为空间维度上的平均值。有关更多信息,请参见平均池层averagePooling2dLayer参考页面。

扩展功能

介绍了R2019b