laplace_of_gausslaplace_of_gaussLaplaceOfGaussLaplaceOfGausslaplace_of_gausslaplace_of_gauss
Short description
laplace_of_gausslaplace_of_gaussLaplaceOfGaussLaplaceOfGausslaplace_of_gausslaplace_of_gauss — LoG-Operator (Laplace of Gaussian).
Signature
laplace_of_gauss( image Image, out image ImageLaplace, number Sigma )laplace_of_gauss( Image : ImageLaplace : Sigma : )void LaplaceOfGauss( const HObject& Image, HObject* ImageLaplace, const HTuple& Sigma )static void HOperatorSet.LaplaceOfGauss( HObject image, out HObject imageLaplace, HTuple sigma )def laplace_of_gauss( image: HObject, sigma: Union[float, int] ) -> HObject
Herror laplace_of_gauss( const Hobject Image, Hobject* ImageLaplace, double Sigma )
Herror T_laplace_of_gauss( const Hobject Image, Hobject* ImageLaplace, const Htuple Sigma )
HImage HImage::LaplaceOfGauss( const HTuple& Sigma ) const
HImage HImage::LaplaceOfGauss( double Sigma ) const
HImage HImage.LaplaceOfGauss( HTuple sigma )
HImage HImage.LaplaceOfGauss( double sigma )
Description
laplace_of_gaussLaplaceOfGauss calculates the Laplace-of-Gaussian
operator, i.e., the Laplace operator on a Gaussian smoothed image,
for arbitrary smoothing parameters Sigmasigmasigma. The Laplace
operator is given by:
\[\begin{eqnarray*}
\Delta g(x,y) =
\frac{\partial^2 g(x,y)}{\partial x^2} +
\frac{\partial^2 g(x,y)}{\partial y^2}
\end{eqnarray*}\]
The derivatives in laplace_of_gaussLaplaceOfGauss are calculated by
appropriate derivatives of the Gaussian, resulting in the following
formula for the convolution mask:
\[\begin{eqnarray*}
\Delta G_{\sigma}(x,y) =
\end{eqnarray*}\]
\[\begin{eqnarray*}
\frac{1}{2\pi \sigma^4} \left( \frac{x^2+y^2}{2 \sigma^2} -1 \right)
\left[ \exp \left( -\frac{x^2 + y^2}{2 \sigma ^2} \right) \right]
\end{eqnarray*}\]
Attention
Note that filter operators may return may return unexpected results if
an image with a reduced domain is used as input. Please refer to the
chapter Filters.
Execution information
-
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
-
Multithreading scope: global (may be called from any thread).
-
Automatically parallelized on tuple level.
-
Automatically parallelized on channel level.
-
Automatically parallelized on domain level.
Parameters
Imageimageimage (input_object) (multichannel-)image(-array) → object (byte / int1 / int2 / uint2 / int4 / real)object (byte / int1 / int2 / uint2 / int4 / real)HObject (byte / int1 / int2 / uint2 / int4 / real)HImage (byte / int1 / int2 / uint2 / int4 / real)HObject (byte / int1 / int2 / uint2 / int4 / real)Hobject (byte / int1 / int2 / uint2 / int4 / real)
Input image.
ImageLaplaceimageLaplaceimage_laplace (output_object) (multichannel-)image(-array) → object (int2)object (int2)HObject (int2)HImage (int2)HObject (int2)Hobject * (int2)
Laplace filtered image.
Sigmasigmasigma (input_control) number → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[float, int]Htuple (double / Hlong)
Smoothing parameter of the Gaussian.
Default: 2.02.0
Suggested values: 0.5, 1.0, 1.5, 2.0, 2.5, 3.0, 4.0, 5.0, 7.00.5, 1.0, 1.5, 2.0, 2.5, 3.0, 4.0, 5.0, 7.0
Value range: 0.01 ≤ Sigma ≤ 25.0
Minimum increment: 0.01
Recommended increment: 0.1
Example
(C)
read_image(&Image,"mreut")\;
laplace_of_gauss(Image,&Laplace,2.0)\;
zero_crossing(Laplace,&ZeroCrossings)\;
Combinations with other operators
Combinations
Possible successors
zero_crossingZeroCrossing, dual_thresholdDualThreshold
Alternatives
laplaceLaplace, diff_of_gaussDiffOfGauss, derivate_gaussDerivateGauss
See also
derivate_gaussDerivateGauss
Module
Foundation