Python PyTorch fractional_max_pool3d用法及代码示例

本文简要介绍python语言中 torch.nn.functional.fractional_max_pool3d 的用法。

用法:

torch.nn.functional.fractional_max_pool3d(*args, **kwargs)

参数：

• kernel_size-最大的窗口大小。可以是单个数字 k(对于 k \times k \times k 的方核)或元组 (kT, kH, kW)

• output_size-oT \times oH \times oW 形式的目标输出大小。可以是元组 (oT, oH, oW) 或单个数字 oH 用于三次输出 oH \times oH \times oH

• output_ratio-如果希望将输出大小作为输入大小的比率，则可以给出此选项。这必须是 (0, 1) 范围内的数字或元组

• return_indices-如果 True ，将返回索引以及输出。用于传递给 max_unpool3d() 。

在由多个输入平面组成的输入信号上应用 3D 分数最大池化。

分数 MaxPooling 在 Ben Graham 的论文 Fractional MaxPooling 中有详细说明

max-pooling 操作以由目标输出大小确定的随机步长大小应用于kT \times kH \times kW 区域。输出特征的数量等于输入平面的数量。

例子：：

>>> input = torch.randn(20, 16, 50, 32, 16)
>>> # pool of cubic window of size=3, and target output size 13x12x11
>>> F.fractional_max_pool3d(input, 3, output_size=(13, 12, 11))
>>> # pool of cubic window and target output size being half of input size
>>> F.fractional_max_pool3d(input, 3, output_ratio=(0.5, 0.5, 0.5))