马克斯普尔

将数据池设置为最大值

描述

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

请注意

该函数将最大池操作应用于dlarray数据。如果要在分层图对象或数组,使用以下层之一:

例子

海底=maxpool(dlXpoolsize通过除以输入执行下采样dlX进入由定义的矩形或长方体区域poolsize计算每个区域中数据的最大值dlX是一个格式化的dlarray使用标注标签。池作用于标注的空间标注“年代”.输出海底是一个格式化的dlarray尺寸标签与dlX

海底indxinputSize) = maxpool (dlXpoolsize还返回每个合并区域内最大值的线性索引和输入要素映射的大小dlXmaxunpool操作。

例子

___=maxpool(___名称,值使用一个或多个名称-值对参数指定选项。例如,“步”,3设置池操作的步幅。

例子

海底=maxpool(dlX, '全球')计算输入的空间维度上的全局最大值dlX。此语法等同于设置poolsize在前面的语法中以大小为准“年代”的尺寸dlX

例子

___=maxpool(___、“DataFormat”FMT)还指定标注格式FMT什么时候dlX不是格式化的dlarray,除了前面语法中的输入参数之外。输出海底是一个无格式的dlarray尺寸顺序和dlX

例子

全部折叠

在两个空间维度上池数据到最大值。

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

高度=6;宽度=6;通道=1;观测值=1;X=rand(高度、宽度、通道、观测值);dlX=dlarray(X,“SSCB”
dlX=6(S)×6(S)×1(C)×1(B)dlX阵列0.17810.8819 0.1564 0.4820 0.2518 0.7302 0.1280.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.9016 0.980.870.980.87

在池大小区域上将数据池为最大值2大步2

海底= maxpool (dlX 2“步”, 2)
dlY=3(S)×3(S)×1(C)×1(B)dlarray 0.8819 0.8555 0.7302 0.9991 0.6448 0.6171 0.9816 0.5830 0.9827

池数据到其全局最大值。

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

高度=4;宽度=6;通道=1;观测值=1;X=rand(高度、宽度、通道、观测值);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

将数据池为全局最大值。指定输入数据的维度格式。

海底= maxpool (dlX,“全球”“DataFormat”“SSCB”
dlY=1×1 DL0.9706阵列

输入参数

全部折叠

输入数据,指定为dlarray有或没有尺寸标签。当dlX不是格式化的dlarray,必须使用指定标注标签格式FMT, DataFormat”

属性指定为空间维度时,池作用于维度“年代”尺寸标签。dlX必须至少有一个“年代”维度。您可以指定最多三个维度dlX作为“年代”尺寸马克斯普尔操作将数据沿每个方向分割“年代”将尺寸标注到由定义的区域中poolsize。该函数计算每个池区域内所有值的最大值。

数据类型:单一的|

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

例子:3.

数据类型:单一的|

名称-值对的观点

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

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

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

  • “年代”-空间的

  • “C”-渠道

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

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

  • “U”-未指明

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

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

例子:“DataFormat”、“SSCB”

数据类型:字符|一串

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

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

跨步使用的全局池不支持参数万博1manbetx“全球”选择。

例子:“步”,3

数据类型:单一的|

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

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

  • 数字标量-对所有空间维度的两端应用相同的填充值。

  • 数值向量-沿每个空间维度应用不同的填充值。使用大小向量d,在那里d是输入数据的空间维度数向量的第Th元素指定沿空间维度。

  • 数字矩阵——对每个空间维度的开始和结束应用不同的填充值。使用大小为2 × -的矩阵d,在那里d是输入数据的空间维度数。元素(d)指定应用于空间维度开始部分的填充d.的元素(2,d)指定应用于空间维度末端的填充d。例如,在二维中,格式为(前、左;下,右)

的默认值“填充”0

“填充”使用的全局池不支持参数万博1manbetx“全球”选择。

例子:“填充”,“相同”

数据类型:单一的|

输出参数

全部折叠

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

如果输入数据dlX是一个格式化的dlarray海底有相同的尺寸标签dlX.如果the input data is not a formatteddlarray海底是一个无格式的dlarray与输入数据的维度顺序相同。

在每个池区域中最大值的索引,返回为dlarray.每个值在indx中对应最大值的位置海底的值的线性索引dlX

如果dlX是一个格式化的dlarray,indx是否与输出的大小和格式相同海底

如果dlX不是格式化的dlarray,indx是一个无格式的dlarray.那样的话,indx以下列维度顺序返回:all“年代”维度,然后是“C”“B”,“T”尺寸,然后是所有尺寸“U”尺寸.尺寸indx匹配的大小海底什么时候海底排列以匹配前面说明的维度顺序。

使用indx输出的maxunpool函数以取消对马克斯普尔

indx属性时不支持输出万博1manbetx“全球”选择。

输入特征图的大小,作为数字向量返回。

使用inputSize输出的maxunpool函数以取消对马克斯普尔

inputSize属性时不支持输出万博1manbetx“全球”选择。

更多关于

全部折叠

最大池

马克斯普尔函数将输入数据池为空间维度上的最大值。有关更多信息,请参见最大池层maxPooling2dLayer参考页面。

兼容性考虑

全部展开

R2020a中的行为发生了变化

扩展能力

介绍了R2019b