pylops.signalprocessing.Patch2D

pylops.signalprocessing.Patch2D(Op, dims, dimsd, nwin, nover, nop, tapertype='hanning', scalings=None, name='P')[source]

2D Patch transform operator.

Apply a transform operator Op repeatedly to patches of the model vector in forward mode and patches of the data vector in adjoint mode. More specifically, in forward mode the model vector is divided into patches, each patch is transformed, and patches are then recombined together. Both model and data are internally reshaped and interpreted as 2-dimensional arrays: each patch contains a portion of the array in both the first and second dimension.

This operator can be used to perform local, overlapping transforms (e.g., pylops.signalprocessing.FFT2D or pylops.signalprocessing.Radon2D) on 2-dimensional arrays.

Note

The shape of the model has to be consistent with the number of windows for this operator not to return an error. As the number of windows depends directly on the choice of nwin and nover, it is recommended to first run patch2d_design to obtain the corresponding dims and number of windows.

Warning

Depending on the choice of nwin and nover as well as the size of the data, sliding windows may not cover the entire data. The start and end indices of each window will be displayed and returned with running patch2d_design.

Parameters:
Op : pylops.LinearOperator

Transform operator

dims : tuple

Shape of 2-dimensional model. Note that dims[0] and dims[1] should be multiple of the model size of the transform in their respective dimensions

dimsd : tuple

Shape of 2-dimensional data

nwin : tuple

Number of samples of window

nover : tuple

Number of samples of overlapping part of window

nop : tuple

Size of model in the transformed domain

tapertype : str, optional

Type of taper (hanning, cosine, cosinesquare or None)

scalings : tuple or list, optional

Set of scalings to apply to each patch. If None, no scale will be applied

name : str, optional

New in version 2.0.0.

Name of operator (to be used by pylops.utils.describe.describe)

Returns:
Sop : pylops.LinearOperator

Sliding operator

Raises:
ValueError

Identified number of windows is not consistent with provided model shape (dims).

See also

Sliding1D
1D Sliding transform operator.
Sliding2D
2D Sliding transform operator.
Sliding3D
3D Sliding transform operator.
Patch3D
3D Patching transform operator.

Examples using pylops.signalprocessing.Patch2D