Given a grouping distance, objects are assigned to a same label if their boundaries are separated by this
distance or less.
(a)
(b)
(c)
Figure 1. Particle grouping: (a) binary image of particles,@Br
(b) label image with a different label for each particle, (c) grouped label image with a same label for each
cluster of particles
The figure above compares the results of the classical connected component and cluster based
labeling algorithms on a binary image representing some particles.
The Labeling2d algorithm gives a different label to each particle.
The GroupCloseLabelsl2d algorithm associates the
same label to each particle of a cluster, a cluster being defined by the distance between the separated
particles.
On the example above, the chosen distance is 20 pixels, therefore particles separated by 20 pixels
or less are recognized as belonging to a same cluster and are set to the same label.
// Function prototype.publicstaticIOLink.ImageViewGroupCloseLabelsl2d(IOLink.ImageView inputObjectImage,double maxDistance =3,IOLink.ImageView outputLabelImage =null);
Class Syntax
// Command constructor.GroupCloseLabelsl2d();/// Gets the inputObjectImage parameter./// The input binary or label image.
std::shared_ptr< iolink::ImageView> inputObjectImage()const;/// Sets the inputObjectImage parameter./// The input binary or label image.void setInputObjectImage( std::shared_ptr< iolink::ImageView> inputObjectImage );/// Gets the maxDistance parameter./// The maximum distance beteween two objects for grouping them.double maxDistance()const;/// Sets the maxDistance parameter./// The maximum distance beteween two objects for grouping them.void setMaxDistance(constdouble& maxDistance );/// Gets the outputLabelImage parameter./// The output label image. Its dimensions are forced to the same values as the input.
std::shared_ptr< iolink::ImageView> outputLabelImage()const;/// Sets the outputLabelImage parameter./// The output label image. Its dimensions are forced to the same values as the input.void setOutputLabelImage( std::shared_ptr< iolink::ImageView> outputLabelImage );// Method to launch the command.void execute();
# Property of the inputObjectImage parameter.GroupCloseLabelsl2d.input_object_image
# Property of the maxDistance parameter.GroupCloseLabelsl2d.max_distance
# Property of the outputLabelImage parameter.GroupCloseLabelsl2d.output_label_image
// Method to launch the command.
execute()
// Command constructor.GroupCloseLabelsl2d()// Property of the inputObjectImage parameter.GroupCloseLabelsl2d.inputObjectImage
// Property of the maxDistance parameter.GroupCloseLabelsl2d.maxDistance
// Property of the outputLabelImage parameter.GroupCloseLabelsl2d.outputLabelImage
// Method to launch the command.Execute()
Parameters
Class Name
GroupCloseLabelsl2d
Parameter Name
Description
Type
Supported Values
Default Value
inputObjectImage
The input binary or label image.
Image
Binary or Label
nullptr
maxDistance
The maximum distance beteween two objects for grouping them.
Float64
>0
3
outputLabelImage
The output label image. Its dimensions are forced to the same values as the input.
auto polystyrene_sep = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER )+"polystyrene_sep.vip");auto result = groupCloseLabelsl2d( polystyrene_sep,3.0);
std::cout <<"outputLabelImage:"<< result->toString();
polystyrene_sep = imagedev.read_vip_image(imagedev_data.get_image_path("polystyrene_sep.vip"))
result = imagedev.group_close_labelsl_2d( polystyrene_sep,3.0)print("output_label_image:", str( result ))
ImageView polystyrene_sep =Data.ReadVipImage(@"Data/images/polystyrene_sep.vip");IOLink.ImageView result =Processing.GroupCloseLabelsl2d( polystyrene_sep,3.0);Console.WriteLine("outputLabelImage:"+ result.ToString());
