Keras 3 API 文件 / 層 API / 池化層 / AveragePooling2D 層

AveragePooling2D 層

[原始碼]

AveragePooling2D 類別

keras.layers.AveragePooling2D(
    pool_size, strides=None, padding="valid", data_format=None, name=None, **kwargs
)

用於 2D 空間資料的平均池化運算。

透過在輸入視窗(大小由 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

引數

  • pool_size:整數或 2 個整數的元組,用於縮減比例的因子 (dim1, dim2)。如果僅指定一個整數,則所有維度都將使用相同的視窗長度。
  • strides:整數或 2 個整數的元組,或 None。步長值。如果為 None,則預設為 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 設定檔 ~/.keras/keras.json 中找到的 image_data_format 值。如果您從未設定它,則它將為 "channels_last"

輸入形狀

  • 如果 data_format="channels_last":4D 張量,形狀為 (batch_size, height, width, channels)
  • 如果 data_format="channels_first":4D 張量,形狀為 (batch_size, channels, height, width)

輸出形狀

  • 如果 data_format="channels_last":4D 張量,形狀為 (batch_size, pooled_height, pooled_width, channels)
  • 如果 data_format="channels_first":4D 張量,形狀為 (batch_size, channels, pooled_height, pooled_width)

範例

strides=(1, 1)padding="valid"

>>> x = np.array([[1., 2., 3.],
...               [4., 5., 6.],
...               [7., 8., 9.]])
>>> x = np.reshape(x, [1, 3, 3, 1])
>>> avg_pool_2d = keras.layers.AveragePooling2D(pool_size=(2, 2),
...    strides=(1, 1), padding="valid")
>>> avg_pool_2d(x)

strides=(2, 2)padding="valid"

>>> x = np.array([[1., 2., 3., 4.],
...              [5., 6., 7., 8.],
...              [9., 10., 11., 12.]])
>>> x = np.reshape(x, [1, 3, 4, 1])
>>> avg_pool_2d = keras.layers.AveragePooling2D(pool_size=(2, 2),
...    strides=(2, 2), padding="valid")
>>> avg_pool_2d(x)

stride=(1, 1)padding="same"

>>> x = np.array([[1., 2., 3.],
...                  [4., 5., 6.],
...                  [7., 8., 9.]])
>>> x = np.reshape(x, [1, 3, 3, 1])
>>> avg_pool_2d = keras.layers.AveragePooling2D(pool_size=(2, 2),
...    strides=(1, 1), padding="same")
>>> avg_pool_2d(x)