Spec-Zone.ru › TensorFlow 2.4

tf.nn.pool

Просмотреть исходный код на GitHub

Выполняет операцию N-мерного пулинга.

tf.nn.pool(
    input, window_shape, pooling_type, strides=None, padding='VALID',
    data_format=None, dilations=None, name=None
)

В случае, если data_format не начинается с "NC", вычисляет для 0 <= b < batch_size, 0 <= x[i] < output_spatial_shape[i], 0 <= c < num_channels:

output[b, x[0], ..., x[N-1], c] =
  REDUCE_{z[0], ..., z[N-1]}
    input[b,
          x[0] * strides[0] - pad_before[0] + dilation_rate[0]*z[0],
          ...
          x[N-1]*strides[N-1] - pad_before[N-1] + dilation_rate[N-1]*z[N-1],
          c],

где функция сокращения REDUCE зависит от значения pooling_type, а pad_before определяется на основе значения padding, как описано в разделе "возвращает" в tf.nn.convolution для подробностей. Сокращение никогда не включает позиции вне границ.

В случае, если data_format начинается с "NC", input и выход просто транспонируются следующим образом:

pool(input, data_format, **kwargs) =
  tf.transpose(pool(tf.transpose(input, [0] + range(2,N+2) + [1]),
                    **kwargs),
               [0, N+1] + range(1, N+1))
Аргументы
input Tensor ранга N+2, формы [batch_size] + input_spatial_shape + [num_channels] если data_format не начинается с "NC" (по умолчанию), или [batch_size, num_channels] + input_spatial_shape если data_format начинается с "NC". Пулинг происходит только по пространственным измерениям.
window_shape Последовательность из N целых чисел >= 1.
pooling_type Указывает операцию пулинга, должна быть "AVG" или "MAX".
strides Необязательно. Последовательность из N целых чисел >= 1. По умолчанию [1]N. Если любое значение strides больше 1, то все значения dilation_rate должны быть 1.
padding Алгоритм заполнения, должен быть "SAME" или "VALID". По умолчанию "SAME". См. раздел "возвращает" в tf.nn.convolution для подробностей.
data_format Строка или None. Указывает, является ли размерность канала input и выходной размерностью последним измерением (по умолчанию, или если data_format не начинается с "NC"), или второй размерностью (если data_format начинается с "NC"). Для N=1 допустимые значения — "NWC" (по умолчанию) и "NCW". Для N=2 допустимые значения — "NHWC" (по умолчанию) и "NCHW". Для N=3 допустимые значения — "NDHWC" (по умолчанию) и "NCDHW".
dilations Необязательно. Скорость расширения. Список из N целых чисел >= 1. По умолчанию [1]N. Если любое значение dilation_rate больше 1, то все значения strides должны быть 1.
name Необязательно. Имя операции.
Возвращает
Tensor ранга N+2, формы [batch_size] + output_spatial_shape + [num_channels]

если data_format равно None или не начинается с "NC", или

[batch_size, num_channels] + output_spatial_shape

если data_format начинается с "NC", где output_spatial_shape зависит от значения padding:

Если padding = "SAME": output_spatial_shape[i] = ceil(input_spatial_shape[i] / strides[i])

Если padding = "VALID": output_spatial_shape[i] = ceil((input_spatial_shape[i] - (window_shape[i] - 1) * dilation_rate[i]) / strides[i]).

Исключения
ValueError если аргументы некорректны.

© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.4/api_docs/python/tf/nn/pool

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API