Spec-Zone.ru › TensorFlow

tf.nn.conv2d

Вычисляет 2-мерную свёртку, учитывая input и 4-мерные filters тензоры.

tf.nn.conv2d(
    input,
    filters,
    strides,
    padding,
    data_format='NHWC',
    dilations=None,
    name=None
)

Тензор input может иметь ранг 4 или выше, где размерности формы [:-3] считаются размерностями пакета (batch_shape).

Учитывая входной тензор формы batch_shape + [in_height, in_width, in_channels] и тензор фильтра/ядра формы [filter_height, filter_width, in_channels, out_channels], этот оператор выполняет следующее:

  1. Сжимает фильтр в 2-мерную матрицу с формой [filter_height * filter_width * in_channels, output_channels].
  2. Извлекает фрагменты изображения из входного тензора, чтобы сформировать виртуальный тензор формы [batch, out_height, out_width, filter_height * filter_width * in_channels].
  3. Для каждого фрагмента выполняет правое умножение матрицы фильтра и вектора фрагмента изображения.

Подробно, с форматом NHWC по умолчанию,

output[b, i, j, k] =
    sum_{di, dj, q} input[b, strides[1] * i + di, strides[2] * j + dj, q] *
                    filter[di, dj, q, k]

Должно выполняться strides[0] = strides[3] = 1. Для наиболее распространённого случая одинаковых горизонтальных и вертикальных шагов, strides = [1, stride, stride, 1].

Пример использования:

x_in = np.array([[
  [[2], [1], [2], [0], [1]],
  [[1], [3], [2], [2], [3]],
  [[1], [1], [3], [3], [0]],
  [[2], [2], [0], [1], [1]],
  [[0], [0], [3], [1], [2]], ]])
kernel_in = np.array([
 [ [[2, 0.1]], [[3, 0.2]] ],
 [ [[0, 0.3]], [[1, 0.4]] ], ])
x = tf.constant(x_in, dtype=tf.float32)
kernel = tf.constant(kernel_in, dtype=tf.float32)
tf.nn.conv2d(x, kernel, strides=[1, 1, 1, 1], padding='VALID')
<tf.Tensor: shape=(1, 4, 4, 2), dtype=float32, numpy=..., dtype=float32)>
Аргументы
input A Tensor. Должен быть одним из следующих типов: half, bfloat16, float32, float64. Тензор с рангом как минимум 4. Порядок измерений интерпретируется в соответствии со значением data_format; все измерения, кроме внутренних 3, действуют как пакетные измерения. Подробности см. ниже.
filters A Tensor. Должен иметь тот же тип, что и input. 4-мерный тензор формы [filter_height, filter_width, in_channels, out_channels]
strides Целое число или список ints, длина которого составляет 1, 2 или 4. Шаг скользящего окна для каждого измерения input. Если задано единственное значение, оно дублируется в измерениях H и W. По умолчанию измерения N и C устанавливаются в 1. Порядок измерений определяется значением data_format, подробности см. ниже.
padding Либо string "SAME" или "VALID", указывающее тип алгоритма заполнения, или список, указывающий явные заполнения в начале и в конце каждого измерения. Подробнее см. здесь. При использовании явного заполнения и data_format "NHWC", это должно быть в формате [[0, 0], [pad_top, pad_bottom], [pad_left, pad_right], [0, 0]]. При использовании явного заполнения и data_format "NCHW", это должно быть в формате [[0, 0], [0, 0], [pad_top, pad_bottom], [pad_left, pad_right]].
data_format Необязательный string из: "NHWC", "NCHW". По умолчанию "NHWC". Указывает формат данных входных и выходных данных. При формате "NHWC" по умолчанию данные хранятся в порядке: batch_shape + [height, width, channels]. В качестве альтернативы, формат может быть "NCHW", порядок хранения данных: batch_shape + [channels, height, width].
dilations Целое число или список ints, длина которого составляет 1, 2 или 4, по умолчанию 1. Коэффициент расширения для каждого измерения input. Если задано единственное значение, оно дублируется в измерениях H и W. По умолчанию измерения N и C устанавливаются в 1. Если установлено k > 1, между каждым элементом фильтра по этому измерению будет k-1 пропущенных ячеек. Порядок измерений определяется значением data_format, см. выше для подробностей. Расширения по измерениям пакета и глубины, если тензор 4-мерный, должны быть 1.
name Имя операции (необязательно).
Возвращаемые значения
A Tensor. Имеет тот же тип, что и input, и ту же внешнюю форму пакета.

© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/api_docs/python/tf/nn/conv2d

Spec-Zone.ru

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