ImageDev

RidgeDetection

Provides the local maxima of an image.

Access to parameter description

For an introduction: This algorithm provides the local maxima using an edge tracking process. On a two-dimensional image, it keeps the configuration of those kind of 3x3 neighborhoods: $$ \begin{array}{ccc} x & b & x\\ x & a & x\\ x & c & x\end{array} \qquad \begin{array}{ccc} x & x & x\\ b & a & c\\ x & x & x\end{array} \qquad \begin{array}{ccc} b & x & x\\ x & a & x\\ x & x & c\end{array} \qquad \begin{array}{ccc} x & x & b\\ x & a & x\\ c & x & x\end{array} \qquad where ~ b < a ~ and ~ c < a $$
See also

Function Syntax

This function returns outputBinaryImage. 
// Function prototype
std::shared_ptr< iolink::ImageView >
ridgeDetection( std::shared_ptr< iolink::ImageView > inputImage,
                RidgeDetection::Neighborhood neighborhood,
                std::shared_ptr< iolink::ImageView > outputBinaryImage = nullptr );
This function returns outputBinaryImage. 
// Function prototype.
ridge_detection(input_image: idt.ImageType,
                neighborhood: RidgeDetection.Neighborhood = RidgeDetection.Neighborhood.CONNECTIVITY_26,
                output_binary_image: idt.ImageType = None) -> idt.ImageType
This function returns outputBinaryImage. 
// Function prototype.
public static IOLink.ImageView
RidgeDetection( IOLink.ImageView inputImage,
                RidgeDetection.Neighborhood neighborhood = ImageDev.RidgeDetection.Neighborhood.CONNECTIVITY_26,
                IOLink.ImageView outputBinaryImage = 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
neighborhood
The 3D neighborhood configuration. This parameter is ignored with a 2D input image.
CONNECTIVITY_6 The structuring element is composed of voxels with a common face with the voxel of interest.
CONNECTIVITY_18 The structuring element is composed of voxels with at least one common edge.
CONNECTIVITY_26 The structuring element is a full cube.
Enumeration CONNECTIVITY_26
output
outputBinaryImage
The binary output image. Image nullptr
Parameter Name Description Type Supported Values Default Value
input
input_image
The input image. image Binary, Label, Grayscale or Multispectral None
input
neighborhood
The 3D neighborhood configuration. This parameter is ignored with a 2D input image.
CONNECTIVITY_6 The structuring element is composed of voxels with a common face with the voxel of interest.
CONNECTIVITY_18 The structuring element is composed of voxels with at least one common edge.
CONNECTIVITY_26 The structuring element is a full cube.
enumeration CONNECTIVITY_26
output
output_binary_image
The binary output image. image None
Parameter Name Description Type Supported Values Default Value
input
inputImage
The input image. Image Binary, Label, Grayscale or Multispectral null
input
neighborhood
The 3D neighborhood configuration. This parameter is ignored with a 2D input image.
CONNECTIVITY_6 The structuring element is composed of voxels with a common face with the voxel of interest.
CONNECTIVITY_18 The structuring element is composed of voxels with at least one common edge.
CONNECTIVITY_26 The structuring element is a full cube.
Enumeration CONNECTIVITY_26
output
outputBinaryImage
The binary output image. Image null

Object Examples

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

RidgeDetection ridgeDetectionAlgo;
ridgeDetectionAlgo.setInputImage( foam );
ridgeDetectionAlgo.setNeighborhood( RidgeDetection::Neighborhood::CONNECTIVITY_26 );
ridgeDetectionAlgo.execute();

std::cout << "outputBinaryImage:" << ridgeDetectionAlgo.outputBinaryImage()->toString();

foam = imagedev.read_vip_image(imagedev_data.get_image_path("foam.vip"))

ridge_detection_algo = imagedev.RidgeDetection()
ridge_detection_algo.input_image = foam
ridge_detection_algo.neighborhood = imagedev.RidgeDetection.CONNECTIVITY_26
ridge_detection_algo.execute()

print("output_binary_image:", str(ridge_detection_algo.output_binary_image))

ImageView foam = Data.ReadVipImage( @"Data/images/foam.vip" );

RidgeDetection ridgeDetectionAlgo = new RidgeDetection
{
    inputImage = foam,
    neighborhood = RidgeDetection.Neighborhood.CONNECTIVITY_26
};
ridgeDetectionAlgo.Execute();

Console.WriteLine( "outputBinaryImage:" + ridgeDetectionAlgo.outputBinaryImage.ToString() );

Function Examples

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

auto result = ridgeDetection( foam, RidgeDetection::Neighborhood::CONNECTIVITY_26 );

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

foam = imagedev.read_vip_image(imagedev_data.get_image_path("foam.vip"))

result = imagedev.ridge_detection(foam, imagedev.RidgeDetection.CONNECTIVITY_26)

print("output_binary_image:", str(result))

ImageView foam = Data.ReadVipImage( @"Data/images/foam.vip" );

IOLink.ImageView result = Processing.RidgeDetection( foam, RidgeDetection.Neighborhood.CONNECTIVITY_26 );

Console.WriteLine( "outputBinaryImage:" + result.ToString() );