ImageDev

GradientMagnitude3d

Provides different algorithms to perform an edge detection based on the first derivative of a two-dimensional image.

Access to parameter description

For an introduction: GradientMagnitude3d computes a first order derivative in each image axis direction and then computes the magnitude of the gradient vectors by selecting its maximum component or its Euclidean norm.

The following algorithms are proposed to extract the edges of an image:

Function Syntax

This function returns outputImage. 
// Function prototype
std::shared_ptr< iolink::ImageView >
gradientMagnitude3d( std::shared_ptr< iolink::ImageView > inputImage,
                     GradientMagnitude3d::GradientOperator gradientOperator,
                     iolink::Vector3d standardDeviation,
                     GradientMagnitude3d::FilterMode filterMode,
                     GradientMagnitude3d::OutputType outputType,
                     GradientMagnitude3d::GradientMode gradientMode,
                     std::shared_ptr< iolink::ImageView > outputImage = NULL );

Class Syntax

Parameters

Parameter Name Description Type Supported Values Default Value
input
inputImage
The input image. Image Binary, Label, Grayscale or Multispectral nullptr
input
gradientOperator
The gradient operator to apply.
GAUSSIAN The gradient is computed by convolution with the derivative of a Gaussian filter.
SOBEL The gradient is computed using the Sobel algorithm.
PREWITT The gradient is computed using the Prewitt algorithm.
Enumeration GAUSSIAN
input
standardDeviation
The standard deviation of the gaussian operator defines the gradient sharpness. Low values provide sharp gradient.
This parameter is ignored with the Sobel and Prewitt gradient operators. 		Vector3d >=0.1 {1.f, 1.f, 1.f}
input
filterMode
The gradient operator to apply.
FINITE This mode uses a Finite Impulse Response algorithm on the X, Y and Z directions. This mode is faster for small standard deviation values. The kernel size value is four times the standard deviation and cannot be smaller than 5.
RECURSIVE This mode uses an Infinite Impulse Response algorithm on the X, Y and Z directions. The computation time is constant with this implementation. This mode is more precise for computing the Gaussian filter.
Enumeration RECURSIVE
input
outputType
The output image type to provide.
SAME_AS_INPUT The output image has same type as the input image. In the case of integer images, this mode can lead to a loss of precision.
FLOAT_32_BIT The output image type is forced to floating point.
Enumeration SAME_AS_INPUT
input
gradientMode
The output image to compute.
AMPLITUDE_MAXIMUM This option computes the amplitude as the maximum between the X and Y components.
AMPLITUDE_EUCLIDEAN This option computes the Euclidean norm of the vector.
Enumeration AMPLITUDE_EUCLIDEAN
output
outputImage
The gradient amplitude output image.
Dimensions, calibration, and interpretation of the output image are forced to the same values as the input. 		Image nullptr

Object Examples

auto foam = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "foam.vip" );

GradientMagnitude3d gradientMagnitude3dAlgo;
gradientMagnitude3dAlgo.setInputImage( foam );
gradientMagnitude3dAlgo.setGradientOperator( GradientMagnitude3d::GradientOperator::GAUSSIAN );
gradientMagnitude3dAlgo.setStandardDeviation( {1, 1, 1} );
gradientMagnitude3dAlgo.setFilterMode( GradientMagnitude3d::FilterMode::RECURSIVE );
gradientMagnitude3dAlgo.setOutputType( GradientMagnitude3d::OutputType::SAME_AS_INPUT );
gradientMagnitude3dAlgo.setGradientMode( GradientMagnitude3d::GradientMode::AMPLITUDE_EUCLIDEAN );
gradientMagnitude3dAlgo.execute();

std::cout << "outputImage:" << gradientMagnitude3dAlgo.outputImage()->toString();

Function Examples

auto foam = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "foam.vip" );

auto result = gradientMagnitude3d( foam, GradientMagnitude3d::GradientOperator::GAUSSIAN, {1, 1, 1}, GradientMagnitude3d::FilterMode::RECURSIVE, GradientMagnitude3d::OutputType::SAME_AS_INPUT, GradientMagnitude3d::GradientMode::AMPLITUDE_EUCLIDEAN );

std::cout << "outputImage:" << result->toString();