ImageDev

GeodesicMaxima

Extracts the geodesic diameter of the particles from a geodesic propagation image.

Access to parameter description

For an introduction: This algorithm is dedicated to be applied on the GeodesicPropagation2d output. It performs geodesic propagation in one direction only, and extracts the maximum value. It extracts the geodesic length of the particles.

See also

Function Syntax

This function returns outputImage. 
// Function prototype
std::shared_ptr< iolink::ImageView >
geodesicMaxima( std::shared_ptr< iolink::ImageView > inputImage,
                GeodesicMaxima::Neighborhood neighborhood,
                std::shared_ptr< iolink::ImageView > outputImage = nullptr );
This function returns outputImage. 
// Function prototype.
geodesic_maxima(input_image: idt.ImageType,
                neighborhood: GeodesicMaxima.Neighborhood = GeodesicMaxima.Neighborhood.CONNECTIVITY_26,
                output_image: idt.ImageType = None) -> idt.ImageType
This function returns outputImage. 
// Function prototype.
public static IOLink.ImageView
GeodesicMaxima( IOLink.ImageView inputImage,
                GeodesicMaxima.Neighborhood neighborhood = ImageDev.GeodesicMaxima.Neighborhood.CONNECTIVITY_26,
                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
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
outputImage
The output image. Its dimensions and type are forced to the same values as the input. 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_image
The output image. Its dimensions and type are forced to the same values as the input. 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
outputImage
The output image. Its dimensions and type are forced to the same values as the input. Image null

Object Examples

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

GeodesicMaxima geodesicMaximaAlgo;
geodesicMaximaAlgo.setInputImage( foam );
geodesicMaximaAlgo.setNeighborhood( GeodesicMaxima::Neighborhood::CONNECTIVITY_26 );
geodesicMaximaAlgo.execute();

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

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

geodesic_maxima_algo = imagedev.GeodesicMaxima()
geodesic_maxima_algo.input_image = foam
geodesic_maxima_algo.neighborhood = imagedev.GeodesicMaxima.CONNECTIVITY_26
geodesic_maxima_algo.execute()

print("output_image:", str(geodesic_maxima_algo.output_image))

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

GeodesicMaxima geodesicMaximaAlgo = new GeodesicMaxima
{
    inputImage = foam,
    neighborhood = GeodesicMaxima.Neighborhood.CONNECTIVITY_26
};
geodesicMaximaAlgo.Execute();

Console.WriteLine( "outputImage:" + geodesicMaximaAlgo.outputImage.ToString() );

Function Examples

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

auto result = geodesicMaxima( foam, GeodesicMaxima::Neighborhood::CONNECTIVITY_26 );

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

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

result = imagedev.geodesic_maxima(foam, imagedev.GeodesicMaxima.CONNECTIVITY_26)

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

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

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

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