Regularization (`simpeg.regularization`)#

Regularization classes are used to impose constraints on models recovered through geophysical inversion. Constraints may be straight forward, such as: requiring the recovered model be spatially smooth, or using a reference model to add a-priori information. Constraints may also be more sophisticated; e.g. cross-validation and petrophysically-guided regularization. In SimPEG, constraints on the recovered model can be defined using a single Regularization object, or defined as a weighted sum of Regularization objects.

Basic Theory#

Most geophysical inverse problems suffer from non-uniqueness; i.e. there is an infinite number of models ( $m$ ) capable of reproducing the observed data to within a specified degree of uncertainty. The challenge is recovering a model which 1) reproduces the observed data, and 2) reasonably approximates the subsurface structures responsible for the observed geophysical response. To accomplish this, regularization is used to ensure the solution to the inverse problem is unique and is geologically plausible. The regularization applied to solve the inverse problem depends on user assumptions and a priori information.

SimPEG uses a deterministic inversion approach to recover an appropriate model. The algorithm does this by finding the model ( $m$ ) which minimizes a global objective function (or penalty function) of the form:

ϕ (m) = ϕ_{d} (m) + β ϕ_{m} (m)

The global objective function contains two terms: a data misfit term $ϕ_{d}$ which ensures data predicted by the recovered model adequately reproduces the observed data, and the model objective function $ϕ_{m}$ which is comprised of one or more regularization functions (objective functions) $ϕ_{i} (m)$ . I.e.:

ϕ_{m} (m) = \sum_{i} α_{i} ϕ_{i} (m)

The model objective function imposes all the desired constraints on the recovered model. Constants $α_{i}$ weight the relative contributions of the regularization functions comprising the model objective function. The trade-off parameter $β$ balances the relative contribution of the data misfit and regularization functions on the global objective function.

Regularization classes within SimPEG correspond to different regularization (objective) functions that can be used individually or combined to define the model objective function $ϕ_{m} (m)$ . For example, a combination of regularization functions that ensures the values in the recovered model are not too large and are spatially smooth in the x and y-directions can be expressed as:

ϕ_{m} (m) = α_{s} \int_{Ω} [w_{s} (r) m (r)^{2}] d v + α_{x} \int_{Ω} [w_{x} (r) (\frac{\partial m}{\partial x})^{2}] d v + α_{y} \int_{Ω} [w_{y} (r) (\frac{\partial m}{\partial y})^{2}] d v

where $w_{s} (r), w_{x} (r), w_{y} (r)$ are user-defined weighting functions. For practical implementation within SimPEG, the regularization function and all its dependent variables are discretized to a numerical grid (or mesh). The model is therefore defined as a discrete set of model parameters $m$ . And the regularization is implemented using a weighted sum of objective functions:

ϕ_{m} (m) \approx α_{s} ‖ W_{s} m ‖^{2} + α_{x} ‖ W_{x} G_{x} m ‖^{2} + α_{y} ‖ W_{y} G_{y} m ‖^{2}

where $G_{x}$ and $G_{y}$ are partial gradient operators along the x and y-directions, respectively. $W_{s}$ , $W_{x}$ and $W_{y}$ are weighting matrices that apply user-defined weights and account for cell dimensions in the inversion mesh.

The API#

Weighted Least Squares Regularization#

Weighted least squares regularization functions are defined as weighted L2-norms on the model, its first-order directional derivative(s), or its second-order directional derivative(s).

`WeightedLeastSquares`(mesh[, active_cells, ...])	Weighted least-squares regularization using smallness and smoothness.
`Smallness`(mesh, **kwargs)	Smallness regularization for least-squares inversion.
`SmoothnessFirstOrder`(mesh[, orientation, ...])	First-order smoothness least-squares regularization.
`SmoothnessSecondOrder`(mesh[, orientation, ...])	Second-order smoothness (flatness) least-squares regularization.
`SmoothnessFullGradient`(mesh[, alphas, ...])	Measures the gradient of a model using optionally anisotropic weighting.

Sparse Norm Regularization#

Sparse norm regularization allows for the recovery of compact and/or blocky structures. An iteratively re-weighted least-squares approach allows smallness and smoothness regularization functions to be defined using norms between 0 and 2.

`Sparse`(mesh[, active_cells, norms, ...])	Sparse norm weighted least squares regularization.
`SparseSmallness`(mesh[, norm, irls_scaled, ...])	Sparse smallness (compactness) regularization.
`SparseSmoothness`(mesh[, orientation, ...])	Sparse smoothness (blockiness) regularization.

Vector Regularizations#

Vector regularization allows for the recovery of vector models; that is, a model where the parameters for each cell define directional components of a vector quantity.

`CrossReferenceRegularization`(mesh, ref_dir)	Cross reference regularization for models representing vector quantities.
`VectorAmplitude`(mesh[, mapping, active_cells])	Sparse vector amplitude regularization.
`AmplitudeSmallness`(mesh[, norm, ...])	Sparse smallness regularization on vector amplitudes.
`AmplitudeSmoothnessFirstOrder`(mesh[, ...])	Sparse amplitude smoothness (blockiness) regularization.

Joint Regularizations#

Regularization functions for joint inversion involving one or more physical properties.

`CrossGradient`(mesh, wire_map[, approx_hessian])	Cross-gradient regularization for joint inversion.
`JointTotalVariation`(mesh, wire_map[, eps])	Joint total variation regularization for joint inversion.
`PGI`(mesh, gmmref[, alpha_x, alpha_y, ...])	Regularization function for petrophysically guided inversion (PGI).
`PGIsmallness`(gmmref[, gmm, wiresmap, ...])	Smallness regularization function for petrophysically guided inversion (PGI).
`LinearCorrespondence`(mesh, wire_map[, ...])	Linear correspondence regularization for joint inversion with two physical properties.

Base Regularization Classes#

Base regularization classes. Inherited by other classes and not used directly to constrain inversions.

`RegularizationMesh`(mesh[, active_cells])	Regularization Mesh
`BaseRegularization`(mesh[, active_cells, ...])	Base regularization class.
`BaseSimilarityMeasure`(mesh, wire_map, **kwargs)	Base regularization class for joint inversion.
`BaseSparse`(mesh[, norm, irls_scaled, ...])	Base class for sparse-norm regularization.
`BaseVectorRegularization`(mesh[, ...])	Base regularization class for models defined by vector quantities.
`BaseAmplitude`(mesh[, active_cells, mapping, ...])	Base amplitude regularization class for models defined by vector quantities.