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],

ранг (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.