ImageDev

DistanceMean2d

Gives the mean distance, edge to edge, between direct neighbor objects of a two-dimensional binary image.

Access to parameter description

For an introduction: section Image Analysis.
This algorithm calculates the distance map of the negative input image and then extracts the ridges separating the image objects.
The measured mean distance is computed as the average of twice the distance map values along this path.

See also

Function Syntax

This function returns outputMeasurement. 
// Function prototype
DistanceMeanMsr::Ptr
distanceMean2d( std::shared_ptr< iolink::ImageView > inputBinaryImage, DistanceMeanMsr::Ptr outputMeasurement = NULL );
This function returns outputMeasurement. 
// Function prototype.
distance_mean_2d( input_binary_image, output_measurement = None )
This function returns outputMeasurement. 
// Function prototype.
public static DistanceMeanMsr
DistanceMean2d( IOLink.ImageView inputBinaryImage, DistanceMeanMsr outputMeasurement = null );

Class Syntax

Parameters

Parameter Name Description Type Supported Values Default Value
input
inputBinaryImage
The input binary image. Image Binary nullptr
output
outputMeasurement
The output measurement result. DistanceMeanMsr nullptr
Parameter Name Description Type Supported Values Default Value
input
input_binary_image
The input binary image. image Binary None
output
output_measurement
The output measurement result. DistanceMeanMsr None
Parameter Name Description Type Supported Values Default Value
input
inputBinaryImage
The input binary image. Image Binary null
output
outputMeasurement
The output measurement result. DistanceMeanMsr null

Object Examples

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

DistanceMean2d distanceMean2dAlgo;
distanceMean2dAlgo.setInputBinaryImage( polystyrene_sep );
distanceMean2dAlgo.execute();

std::cout << "distance: " << distanceMean2dAlgo.outputMeasurement()->distance( 0 ) ;

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

distance_mean_2d_algo = imagedev.DistanceMean2d()
distance_mean_2d_algo.input_binary_image = polystyrene_sep
distance_mean_2d_algo.execute()

print( "distance: ", str( distance_mean_2d_algo.output_measurement.distance( 0 ) ) )

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

DistanceMean2d distanceMean2dAlgo = new DistanceMean2d
{
    inputBinaryImage = polystyrene_sep
};
distanceMean2dAlgo.Execute();

Console.WriteLine( "distance: " + distanceMean2dAlgo.outputMeasurement.distance( 0 ) );

Function Examples

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

auto result = distanceMean2d( polystyrene_sep );

std::cout << "distance: " << result->distance( 0 ) ;

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

result = imagedev.distance_mean_2d( polystyrene_sep )

print( "distance: ", str( result.distance( 0 ) )  )

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

DistanceMeanMsr result = Processing.DistanceMean2d( polystyrene_sep );

Console.WriteLine(  "distance: " + result.distance( 0 )  );