torch.nn.functional.fractional_max_pool3d

torch.nn.functional.fractional_max_pool3d(input, kernel_size, output_size=None, output_ratio=None, return_indices=False, _random_samples=None)

对输入信号进行3D分数最大池化，该信号由多个输入平面组成。

分数最大池化在论文 Fractional MaxPooling (作者: Ben Graham) 中有详细描述

最大池化操作在 $kT \times kH \times kW$ 区域内进行，步长由目标输出大小随机决定。输出特征的数量等于输入平面的数量。

参数

• 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() 很有用。

形状

• 输入： $(N, C, T_{in}, H_{in}, W_{in})$ 或 $(C, T_{in}, H_{in}, W_{in})$。

• 输出： $(N, C, T_{out}, H_{out}, W_{out})$ 或 $(C, T_{out}, H_{out}, W_{out})$，其中 $(T_{out}, H_{out}, W_{out})=\text{output\_size}$ 或 $(T_{out}, H_{out}, W_{out})=\text{output\_ratio} \times (T_{in}, H_{in}, W_{in})$

示例：

>>> 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))