torch.nn.functional.conv3d

torch.nn.functional.conv3d(input, weight, bias=None, stride=1, padding=0, dilation=1, groups=1) → Tensor [source]

Применяет трёхмерную свёртку к входному изображению, состоящему из нескольких входных плоскостей.

Этот оператор поддерживает TensorFloat32.

Подробную информацию и форму выходных данных см. в описании Conv3d.

Примечание

В некоторых случаях при передаче тензоров на устройстве CUDA и использовании CuDNN этот оператор может выбирать недетерминированный алгоритм для повышения производительности. Если это нежелательно, можно попробовать сделать операцию детерминированной (возможно, за счёт снижения производительности), установив torch.backends.cudnn.deterministic = True. Дополнительную информацию см. в разделе Воспроизводимость.

Примечание

Этот оператор поддерживает комплексные типы данных, то есть complex32, complex64, complex128.

Параметры:

• input – входной тензор формы $(\text{minibatch} , \text{in\_channels} , iT , iH , iW)$
• weight – фильтры формы $(\text{out\_channels} , \frac{\text{in\_channels}}{\text{groups}} , kT , kH , kW)$
• bias – необязательный тензор смещения формы $(\text{out\_channels})$. Значение по умолчанию: None
• stride – шаг свёрточного ядра. Может быть одним числом или кортежем (sT, sH, sW). Значение по умолчанию: 1

• padding –

  неявное дополнение с обеих сторон входных данных. Может быть строкой {‘valid’, ‘same’}, одним числом или кортежем (padT, padH, padW). Значение по умолчанию: 0 padding='valid' означает отсутствие дополнения. padding='same' дополняет входные данные так, чтобы выходные данные имели ту же форму, что и входные. Однако этот режим не поддерживает значения шага, отличные от 1.

  Предупреждение

  Для padding='same', если weight имеет чётную длину, а dilation — нечётную в любом измерении, может потребоваться выполнить внутри полную операцию pad(). Это снижает производительность.

• dilation – расстояние между элементами ядра. Может быть одним числом или кортежем (dT, dH, dW). Значение по умолчанию: 1
• groups – разделение входных данных на группы; $\text{in\_channels}$ должно делиться на число групп. Значение по умолчанию: 1

Примеры:

>>> filters = torch.randn(33, 16, 3, 3, 3)
>>> inputs = torch.randn(20, 16, 50, 10, 20)
>>> F.conv3d(inputs, filters)