主要内容

avgpool

池数据在空间维度平均值

描述

平均池操作执行downsampling除以输入池区域和计算每个区域的平均值。

avgpool平均池操作适用于函数dlarray数据。使用dlarray更易于处理高维数据的对象允许您标签的尺寸。例如,您可以标签尺寸对应于空间,时间,频道,使用批处理维度“S”,“T”,“C”,“B”标签,分别。未指明的和其他维度,使用“U”标签。为dlarray对象的函数操作特定的尺寸,你可以指定尺寸标签的格式dlarray直接对象,或通过使用DataFormat选择。

例子

海底= avgpool (dlX,poolsize)平均池操作适用于格式化的dlarray对象dlX。函数downsamples输入除以区域定义为poolsize和计算数据的平均值在每一个地区。输出海底是一个格式化的dlarray同样的尺寸格式dlX

这个函数,默认情况下,在三维空间的池dlX标签“年代”(空间)。在尺寸标注池“T”(时间),指定一个池地区“T”维度使用“PoolFormat”选择。

例子

海底= avgpool (dlX,'全球')计算全球平均输入的空间维度dlX。这个语法相当于设置poolsize在前面的语法的大小“年代”的尺寸dlX

海底= avgpool (___、“DataFormat”FMT)平均池操作适用于非格式化dlarray对象dlX带格式的规定FMT使用任何以前的语法。输出海底是一个非格式化dlarray对象维度的顺序一样dlX。例如,“DataFormat”、“SSCB”指定数据的二维平均池格式“SSCB”(空间、空间、通道、批)。

例子

海底= avgpool (___,名称,值)使用一个或多个名称-值对参数指定选项。例如,“PoolFormat”、“T”指定一个池地区为一维池格式“T”(时间)。

例子

全部折叠

创建一个格式化的dlarray对象包含了一批128 28-by-28图像3通道。指定的格式“SSCB”(空间、空间、通道、批)。

miniBatchSize = 128;inputSize = 28 [28];numChannels = 3;X =兰特(inputSize (1) inputSize (2), numChannels, miniBatchSize);dlX = dlarray (X,“SSCB”);

视图的大小和格式输入数据。

大小(dlX)
ans =1×4128年28日28日3
dim (dlX)
ans = ' SSCB '

应用二维平均池与2×2池地区使用avgpool函数。

poolSize = (2 - 2);海底= avgpool (dlX poolSize);

视图的大小和格式输出。

大小(海底)
ans =1×4128年27日27日3
dim(海底)
ans = ' SSCB '

创建一个格式化的dlarray对象包含了一批128 28-by-28图像3通道。指定的格式“SSCB”(空间、空间、通道、批)。

miniBatchSize = 128;inputSize = 28 [28];numChannels = 3;X =兰特(inputSize (1) inputSize (2), numChannels, miniBatchSize);dlX = dlarray (X,“SSCB”);

视图的大小和格式输入数据。

大小(dlX)
ans =1×4128年28日28日3
dim (dlX)
ans = ' SSCB '

应用二维全球平均池使用avgpool通过指定函数“全球”选择。

海底= avgpool (dlX,“全球”);

视图的大小和格式输出。

大小(海底)
ans =1×41 1 3 128
dim(海底)
ans = ' SSCB '

创建一个格式化的dlarray对象包含一批128序列长度为100的12通道。指定的格式“认知行为治疗”(通道、批量、时间)。

miniBatchSize = 128;sequenceLength = 100;numChannels = 12;X =兰德(numChannels miniBatchSize sequenceLength);dlX = dlarray (X,“认知行为治疗”);

视图的大小和格式输入数据。

大小(dlX)
ans =1×312 128 100
dim (dlX)
ans =“认知行为治疗”

应用一维平均池,池区域的大小2步的使用avgpool通过指定函数“PoolFormat”“步”选项。

poolSize = 2;海底= avgpool (dlX poolSize,“PoolFormat”,“T”,“步”2);

视图的大小和格式输出。

大小(海底)
ans =1×312 128 50
dim(海底)
ans =“认知行为治疗”

输入参数

全部折叠

输入数据,指定为一个格式化的或未格式化dlarray对象。

如果dlX是一个非格式化dlarray,那么你必须指定使用的格式“DataFormat”选择。

这个函数,默认情况下,在三维空间的池dlX标签“年代”(空间)。在尺寸标注池“T”(时间),指定一个池地区“T”维度使用“PoolFormat”选择。

池区域的大小,指定为一个数值标量或数值向量。

使用池池与相同大小的边缘区域,指定poolsize作为一个标量。池区域沿着指定的所有维度有相同的大小“PoolFormat”

使用池地区池大小不一的边缘,指定poolsize作为一个向量,poolsize(我)相应尺寸的大小吗“PoolFormat”

名称-值参数

指定可选的逗号分隔条名称,值参数。的名字参数名称和吗价值相应的价值。的名字必须出现在引号。您可以指定几个名称和值对参数在任何顺序Name1, Value1,…,的家

例子:“步”,2指定池地区的步伐2

维度的非格式化输入数据,指定为一个特征向量或字符串标量FMT为每个维度的数据提供一个标签。

当你指定的格式dlarray对象,每个字符为每个维度的数据和提供一个标签必须是下列之一:

  • “S”——空间

  • “C”——频道

  • “B”批处理(例如,样品和观察)

  • “T”时间(例如,时间序列的步骤)

  • “U”——未指明的

您可以指定多个维度标签“S”“U”。您可以使用标签“C”,“B”,“T”最多一次。

您必须指定DataFormat当输入数据不是一个格式化的dlarray

数据类型:字符|字符串

维度的顺序池地区指定为逗号分隔组成的“PoolFormat”和一个特征向量或字符串标量,它提供了一个标签为每个维度的集中地区。

的默认值“PoolFormat”取决于任务:

任务 默认的
一维池 “年代”(空间)
二维池 “党卫军”(空间、空间)
3 d池 “SSS”(空间、空间、空间)

格式必须要么没有“年代”(空间)维度,或尽可能多的“年代”(空间)维度作为输入数据。

这个函数,默认情况下,在三维空间的池dlX标签“年代”(空间)。在尺寸标注池“T”(时间),指定一个池地区“T”维度使用“PoolFormat”选择。

例子:“PoolFormat”、“T”

步长为遍历输入数据,指定为逗号分隔组成的“步”和一个数字标量或数值向量。如果您指定“步”作为一个标量,相同的值是用于所有空间维度。如果您指定“步”作为一个相同大小的矢量空间维度的数量的输入数据,矢量值用于相应的空间维度。

的默认值“步”1。如果“步”小于poolsize在任何一个维度,那么池区域重叠。

参数不支持全球池使用金宝app“全球”选择。

例子:“步”,3

数据类型:|

大小的填充应用于边缘的数据,指定为逗号分隔组成的“填充”和下列之一:

  • “相同”——填充大小设置,输出尺寸是一样的跨越时输入的大小1。更普遍的是,输出每个空间维度的大小装天花板(inputSize /步),在那里inputSize是输入的大小在一个空间维度。

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

  • 数值向量,应用不同的填充量在每一个空间维度。使用一个向量的大小d,在那里d是空间维度的数量的输入数据。的向量的th元素指定大小的填充应用到开始和结束空间维度。

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

“填充”参数不支持全球池使用金宝app“全球”选择。

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

数据类型:|

用来垫输入值,指定为0“的意思是”

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

  • 0——输入与零填充在指定的位置填充财产。填充区域是包含在计算平均值的池沿边缘地区。

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

输出参数

全部折叠

汇集数据,作为一个返回dlarray基础数据类型一样dlX

如果输入数据dlX是一个格式化的dlarray,然后海底有相同的格式吗dlX。如果没有一个格式化的输入数据dlarray,然后海底是一个非格式化dlarray相同的尺寸订单作为输入数据。

更多关于

全部折叠

平均分担

avgpool功能池输入数据平均值。有关更多信息,请参见的定义平均池层averagePooling2dLayer参考页面。

扩展功能

介绍了R2019b