pylops.signalprocessing.Convolve2D(N, h, dims, offset=(0, 0), nodir=None, dtype='float64', method='fft')[source]

2D convolution operator.

Apply two-dimensional convolution with a compact filter to model (and data) along a pair of specific directions of a two or three-dimensional array depending on the choice of nodir.

N : int

Number of samples in model

h : numpy.ndarray

2d compact filter to be convolved to input signal

dims : list

Number of samples for each dimension

offset : tuple, optional

Indeces of the center of the compact filter

nodir : int, optional

Direction along which convolution is NOT applied (set to None for 2d arrays)

dtype : str, optional

Type of elements in input array.

method : str, optional

Method used to calculate the convolution (direct or fft).

cop : pylops.LinearOperator

Convolve2D linear operator


The Convolve2D operator applies two-dimensional convolution between the input signal \(d(t,x)\) and a compact filter kernel \(h(t,x)\) in forward model:

\[y(t,x) = \iint\limits_{-\infty}^{\infty} h(t-\tau,x-\chi) d(\tau,\chi) \,\mathrm{d}\tau \,\mathrm{d}\chi\]

This operation can be discretized as follows

\[y[i,n] = \sum_{j=-\infty}^{\infty} \sum_{m=-\infty}^{\infty} h[i-j,n-m] d[j,m]\]

as well as performed in the frequency domain.

\[Y(f, k_x) = \mathscr{F} (h(t,x)) * \mathscr{F} (d(t,x))\]

Convolve2D operator uses scipy.signal.convolve2d that automatically chooses the best domain for the operation to be carried out.

As the adjoint of convolution is correlation, Convolve2D operator applies correlation in the adjoint mode.

In time domain:

\[y(t,x) = \iint\limits_{-\infty}^{\infty} h(t+\tau,x+\chi) d(\tau,\chi) \,\mathrm{d}\tau \,\mathrm{d}\chi\]

or in frequency domain:

\[y(t, x) = \mathscr{F}^{-1} (H(f, k_x)^* * X(f, k_x))\]

Examples using pylops.signalprocessing.Convolve2D