pylops.signalprocessing.Patch3D#
- pylops.signalprocessing.Patch3D(Op, dims, dimsd, nwin, nover, nop, tapertype='hanning', scalings=None, name='P')[source]#
3D 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 3-dimensional arrays: each patch contains a portion of the array in every axis.This operator can be used to perform local, overlapping transforms (e.g.,
pylops.signalprocessing.FFTND
orpylops.signalprocessing.Radon3D
) on 3-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
andnover
, it is recommended to first runpatch3d_design
to obtain the correspondingdims
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
patch3d_design
.- Parameters
- Op
pylops.LinearOperator
Transform operator
- dims
tuple
Shape of 3-dimensional model. Note that
dims[0]
,dims[1]
anddims[2]
should be multiple of the model size of the transform in their respective dimensions- dimsd
tuple
Shape of 3-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
orNone
)- scalings
tuple
orlist
, optional Set of scalings to apply to each patch. If
None
, no scale will be applied- name
str
, optional Name of operator (to be used by
pylops.utils.describe.describe
)
- Op
- Returns
- Sop
pylops.LinearOperator
Sliding operator
- Sop
- Raises
- ValueError
Identified number of windows is not consistent with provided model shape (
dims
).