jax.scipy.signal.convolve2d

jax.scipy.signal.convolve2d(in1, in2, mode='full', boundary='fill', fillvalue=0, precision=None)

兩個 2 維陣列的卷積。

scipy.signal.convolve2d() 的 JAX 實作。

參數:

• in1 (Array) – 卷積的左手邊輸入。必須具有 in1.ndim == 2。

• in2 (Array) – 卷積的右手邊輸入。必須具有 in2.ndim == 2。

• mode (str) –

  控制輸出的尺寸。可用的操作為

  • "full": (預設) 輸出輸入的完整卷積。

  • "same": 傳回 "full" 輸出的置中部分，其尺寸與 in1 相同。

  • "valid": 傳回 "full" 輸出中不依賴陣列邊緣填充的部分。

• boundary (str) – 僅支援 "fill"。

• fillvalue (float) – 僅支援 0。

• method –

  控制計算方法。選項為

  • "auto": (預設) 總是使用 "direct" 方法。

  • "direct": 降低到 jax.lax.conv_general_dilated()。

  • "fft": 透過快速傅立葉轉換計算結果。

• precision (PrecisionLike | None) – 指定計算的精確度。請參閱 jax.lax.Precision 以取得可用值的說明。

傳回值:

包含卷積結果的陣列。

傳回類型:

Array

另請參閱

• jax.numpy.convolve()：1D 卷積

• jax.scipy.signal.convolve()：ND 卷積

• jax.scipy.signal.correlate()：ND 相關性

範例

一些 2D 卷積範例

>>> x = jnp.array([[1, 2],
...                [3, 4]])
>>> y = jnp.array([[2, 1, 1],
...                [4, 3, 4],
...                [1, 3, 2]])

完整 2D 卷積在邊緣使用隱含的零填充

>>> jax.scipy.signal.convolve2d(x, y, mode='full')
Array([[ 2.,  5.,  3.,  2.],
       [10., 22., 17., 12.],
       [13., 30., 32., 20.],
       [ 3., 13., 18.,  8.]], dtype=float32)

指定 mode = 'same' 傳回與第一個輸入尺寸相同的置中 2D 卷積

>>> jax.scipy.signal.convolve2d(x, y, mode='same')
Array([[22., 17.],
       [30., 32.]], dtype=float32)

指定 mode = 'valid' 僅傳回兩個陣列完全重疊的 2D 卷積部分

>>> jax.scipy.signal.convolve2d(x, y, mode='valid')
Array([[22., 17.],
       [30., 32.]], dtype=float32)