Python tf.keras.layers.AveragePooling2D用法及代碼示例

空間數據的平均池化操作。

繼承自：Layer，Module

用法

tf.keras.layers.AveragePooling2D(
    pool_size=(2, 2), strides=None, padding='valid', data_format=None,
    **kwargs
)

參數

pool_size 整數或 2 個整數的元組，縮小比例的因子(垂直，水平)。 (2, 2) 將兩個空間維度的輸入減半。如果隻指定一個整數，則兩個維度將使用相同的窗口長度。
strides 整數，2 個整數的元組，或無。跨步值。如果沒有，它將默認為 pool_size 。
padding "valid" 或 "same" 之一(不區分大小寫)。 "valid" 表示沒有填充。 "same" 導致在輸入的左/右或上/下均勻填充，以使輸出具有與輸入相同的高度/寬度尺寸。
data_format 一個字符串，是 channels_last (默認)或 channels_first 之一。輸入中維度的排序。 channels_last 對應於形狀為 (batch, height, width, channels) 的輸入，而 channels_first 對應於形狀為 (batch, channels, height, width) 的輸入。它默認為您的 Keras 配置文件中的 image_data_format 值 ~/.keras/keras.json 。如果您從未設置它，那麽它將是"channels_last"。

通過對輸入的每個通道在輸入窗口(大小由 pool_size 定義)上取平均值，沿其空間維度(高度和寬度)對輸入進行下采樣。窗口沿每個維度移動strides。

使用 "valid" 填充選項時生成的輸出具有以下形狀(行數或列數)：output_shape = math.floor((input_shape - pool_size) / strides) + 1(當 input_shape >= pool_size 時)

使用 "same" 填充選項時產生的輸出形狀是：output_shape = math.floor((input_shape - 1) / strides) + 1

例如，對於 strides=(1, 1) 和 padding="valid" ：

x = tf.constant([[1., 2., 3.],
                 [4., 5., 6.],
                 [7., 8., 9.]])
x = tf.reshape(x, [1, 3, 3, 1])
avg_pool_2d = tf.keras.layers.AveragePooling2D(pool_size=(2, 2),
   strides=(1, 1), padding='valid')
avg_pool_2d(x)
<tf.Tensor:shape=(1, 2, 2, 1), dtype=float32, numpy=
  array([[[[3.],
           [4.]],
          [[6.],
           [7.]]]], dtype=float32)>

例如，對於 stride=(2, 2) 和 padding="valid" ：

x = tf.constant([[1., 2., 3., 4.],
                 [5., 6., 7., 8.],
                 [9., 10., 11., 12.]])
x = tf.reshape(x, [1, 3, 4, 1])
avg_pool_2d = tf.keras.layers.AveragePooling2D(pool_size=(2, 2),
   strides=(2, 2), padding='valid')
avg_pool_2d(x)
<tf.Tensor:shape=(1, 1, 2, 1), dtype=float32, numpy=
  array([[[[3.5],
           [5.5]]]], dtype=float32)>

例如，對於 strides=(1, 1) 和 padding="same" ：

x = tf.constant([[1., 2., 3.],
                 [4., 5., 6.],
                 [7., 8., 9.]])
x = tf.reshape(x, [1, 3, 3, 1])
avg_pool_2d = tf.keras.layers.AveragePooling2D(pool_size=(2, 2),
   strides=(1, 1), padding='same')
avg_pool_2d(x)
<tf.Tensor:shape=(1, 3, 3, 1), dtype=float32, numpy=
  array([[[[3.],
           [4.],
           [4.5]],
          [[6.],
           [7.],
           [7.5]],
          [[7.5],
           [8.5],
           [9.]]]], dtype=float32)>

輸入形狀：

如果 data_format='channels_last' ：形狀為 (batch_size, rows, cols, channels) 的 4D 張量。
如果 data_format='channels_first' ：形狀為 (batch_size, channels, rows, cols) 的 4D 張量。

輸出形狀：

如果 data_format='channels_last' ：形狀為 (batch_size, pooled_rows, pooled_cols, channels) 的 4D 張量。
如果 data_format='channels_first' ：形狀為 (batch_size, channels, pooled_rows, pooled_cols) 的 4D 張量。

相關用法

注：本文由純淨天空篩選整理自tensorflow.org大神的英文原創作品 tf.keras.layers.AveragePooling2D。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。