tf.compat.v1.nn.convolution

Вычисляет суммы N-мерных свёртки (на самом деле взаимной корреляции).

tf.compat.v1.nn.convolution(
    input, filter, padding, strides=None, dilation_rate=None, name=None,
    data_format=None, filters=None, dilations=None
)

Это также поддерживает либо шаги вывода через необязательный strides параметр, либо атроусную свёртку (также известную как свёртка с отверстиями или расширенная свёртка, основанная на французском слове "trous", означающем отверстия на английском языке) через необязательный dilation_rate параметр. Однако в настоящее время шаги вывода не поддерживаются для атроусных свёрток.

В частности, в случае, когда data_format не начинается с "NC", учитывая ранг (N+2) input тензор формы

[num_batches, input_spatial_shape[0], ..., input_spatial_shape[N-1], num_input_channels],

a rank (N+2) filter тензор формы

[spatial_filter_shape[0], ..., spatial_filter_shape[N-1], num_input_channels, num_output_channels],

необязательный dilation_rate тензор формы N, задающий скорость увеличения фильтра/уменьшения входных данных, и необязательный список из N strides (по умолчанию [1]*N), это вычисляет для каждой N-мерной пространственной позиции вывода (x[0], ..., x[N-1]):

output[b, x[0], ..., x[N-1], k] =
    sum_{z[0], ..., z[N-1], q}
        filter[z[0], ..., z[N-1], q, k] *
        padded_input[b,
                     x[0]*strides[0] + dilation_rate[0]*z[0],
                     ...,
                     x[N-1]*strides[N-1] + dilation_rate[N-1]*z[N-1],
                     q]

где b — индекс в пакет, k — номер выходного канала, q — номер входного канала, а z — N-мерный пространственный сдвиг внутри фильтра. Здесь padded_input получается путём нулевого заполнения входа с использованием эффективной пространственной формы фильтра (spatial_filter_shape-1) * dilation_rate + 1 и шага вывода strides, как описано в комментарии здесь.

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

convolution(input, data_format, **kwargs) = tf.transpose(convolution(tf.transpose(input, [0] + range(2,N+2) + [1]), **kwargs), [0, N+1] + range(1, N+1))

Требуется, чтобы 1 <= N <= 3.