expand_gray_refexpand_gray_refExpandGrayRefExpandGrayRefexpand_gray_ref (算子名称)

名称

expand_gray_refexpand_gray_refExpandGrayRefExpandGrayRefexpand_gray_ref — Fill gaps between regions (depending on gray value or color) or split overlapping regions.

参数签名

expand_gray_ref(区域, Image, ForbiddenArea : RegionExpand : Iterations, Mode, RefGray, Threshold : )

描述

expand_gray_refexpand_gray_refExpandGrayRefExpandGrayRefExpandGrayRefexpand_gray_ref closes gaps between the input regions, which resulted from the suppression of small regions in a segmentation operator, (mode 'image'"image""image""image""image""image"), for example, or separates overlapping regions 'region'"region""region""region""region""region"). Both uses result from the expansion of regions. 该算子 works by adding a one pixel wide “strip” to a region, in which the gray values or color are different from a reference gray value or color by at most ThresholdThresholdThresholdThresholdthresholdthreshold (in each channel). For images of type 'cyclic'"cyclic""cyclic""cyclic""cyclic""cyclic" (e.g., direction images), also points with a gray value difference of at least 255 - ThresholdThresholdThresholdThresholdthresholdthreshold are added to the output region.

The expansion takes place only in regions, which are designated as not “forbidden” (parameter ForbiddenAreaForbiddenAreaForbiddenAreaForbiddenAreaforbiddenAreaforbidden_area). The number of iterations is determined by the parameter IterationsIterationsIterationsIterationsiterationsiterations. By passing 'maximal'"maximal""maximal""maximal""maximal""maximal", expand_gray_refexpand_gray_refExpandGrayRefExpandGrayRefExpandGrayRefexpand_gray_ref iterates until convergence, i.e., until no more changes occur. By passing 0 for this parameter, all non-overlapping regions are returned. The two modes of operation ('image'"image""image""image""image""image" and 'region'"region""region""region""region""region") are different in the following ways:

'image': The input regions are expanded iteratively until they touch another region or the image border, or the expansion stops because of too high gray value differences. Because expand_gray_refexpand_gray_refExpandGrayRefExpandGrayRefExpandGrayRefexpand_gray_ref processes all regions simultaneously, gaps between regions are distributed evenly to all regions with a similar gray value. Overlapping regions are split by distributing the area of overlap evenly to both regions.
'region': No expansion of the input regions is performed. Instead, only overlapping regions are split by distributing the area of overlap evenly to regions having a matching gray value or color.

注意

Because regions are only expanded into areas having a matching gray value or color, usually gaps will remain between the output regions, i.e., the segmentation is not complete.

运行信息

多线程类型:可重入(与非独占操作符并行运行)。
多线程作用域:全局(可以从任何线程调用)。
未经并行化处理。

参数表

区域区域区域区域区域区域 (input_object) region(-array) → object

Regions for which the gaps are to be closed, or which are to be separated.

ImageImageImageImageimageimage (input_object) (multichannel-)image → object (byte / cyclic)

Image (possibly multi-channel) for gray value or color comparison.

ForbiddenAreaForbiddenAreaForbiddenAreaForbiddenAreaforbiddenAreaforbidden_area (input_object) region → object

Regions in which no expansion takes place.

RegionExpandRegionExpandRegionExpandRegionExpandregionExpandregion_expand (output_object) region(-array) → object

Expanded or separated regions.

IterationsIterationsIterationsIterationsiterationsiterations (input_control) string → (string / integer)

Number of iterations.

Default: 'maximal' "maximal" "maximal" "maximal" "maximal" "maximal"

Suggested values: 'maximal'"maximal""maximal""maximal""maximal""maximal", 1, 2, 3, 4, 5, 7, 10, 15, 20, 30, 50, 70, 100, 150, 200, 300, 500

Value range: 1 ≤ Iterations Iterations Iterations Iterations iterations iterations ≤ 500 (lin)

Minimum increment: 1

Recommended increment: 1

ModeModeModeModemodemode (input_control) string → (string)

Expansion mode.

Default: 'image' "image" "image" "image" "image" "image"

List of values: 'image'"image""image""image""image""image", 'region'"region""region""region""region""region"

RefGrayRefGrayRefGrayRefGrayrefGrayref_gray (input_control) integer(-array) → (integer)

Reference gray value or color for comparison.

Default: 128

Suggested values: 1, 10, 20, 50, 100, 128, 200, 255

Value range: 1 ≤ RefGray RefGray RefGray RefGray refGray ref_gray ≤ 255 (lin)

Minimum increment: 1

Recommended increment: 10

ThresholdThresholdThresholdThresholdthresholdthreshold (input_control) integer(-array) → (integer)

Maximum difference between the reference gray value or color and a candidate for expansion.

Default: 32

Suggested values: 4, 10, 15, 20, 25, 30, 40

Value range: 1 ≤ Threshold Threshold Threshold Threshold threshold threshold ≤ 255 (lin)

Minimum increment: 1

Recommended increment: 5

Example (C++ (HALCON 5.0-10.0))

#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;

int main (int argc, char *argv[])
{
  HImage   image (argv[1]);
  HRegion  empty_region;
  HWindow  win;

  win.SetDraw ("margin");
  win.SetColored (12);

  image.Display (win);

  HRegionArray seg = (image >= 100).Connection ();
  seg.Display (win);

  Tuple iter = "maximal";
  Tuple mode = "image";
  Tuple refg = 128;
  Tuple thrs = 32;

  HRegionArray exp = seg.ExpandGrayRef (image, empty_region,
                                        iter, mode, refg, thrs);
  exp.Display (win);
  win.Click ();

  return (0);
}

例程 (C)

read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
regiongrowing(Image,&RawSegments,3,3,6.0,100);
set_colored(WindowHandle,12);
disp_region(RawSegments,WindowHandle);
T_intensity(RawSegments,Image,&Mean,NULL);
set_i(Thresh,24,0);
set_s(Iter,"maximal",0);
set_s(Mode,"image",0);
T_expand_gray_ref(RawSegments,Image,EMPTY_REGION,&Segments,Iter,Mode,
               Mean,Thresh);
disp_region(Segments,WindowHandle);

Example (C++ (HALCON 5.0-10.0))

#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;

int main (int argc, char *argv[])
{
  HImage   image (argv[1]);
  HRegion  empty_region;
  HWindow  win;

  win.SetDraw ("margin");
  win.SetColored (12);

  image.Display (win);

  HRegionArray seg = (image >= 100).Connection ();
  seg.Display (win);

  Tuple iter = "maximal";
  Tuple mode = "image";
  Tuple refg = 128;
  Tuple thrs = 32;

  HRegionArray exp = seg.ExpandGrayRef (image, empty_region,
                                        iter, mode, refg, thrs);
  exp.Display (win);
  win.Click ();

  return (0);
}

Example (C++ (HALCON 5.0-10.0))

#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;

int main (int argc, char *argv[])
{
  HImage   image (argv[1]);
  HRegion  empty_region;
  HWindow  win;

  win.SetDraw ("margin");
  win.SetColored (12);

  image.Display (win);

  HRegionArray seg = (image >= 100).Connection ();
  seg.Display (win);

  Tuple iter = "maximal";
  Tuple mode = "image";
  Tuple refg = 128;
  Tuple thrs = 32;

  HRegionArray exp = seg.ExpandGrayRef (image, empty_region,
                                        iter, mode, refg, thrs);
  exp.Display (win);
  win.Click ();

  return (0);
}

Example (C++ (HALCON 5.0-10.0))

#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;

int main (int argc, char *argv[])
{
  HImage   image (argv[1]);
  HRegion  empty_region;
  HWindow  win;

  win.SetDraw ("margin");
  win.SetColored (12);

  image.Display (win);

  HRegionArray seg = (image >= 100).Connection ();
  seg.Display (win);

  Tuple iter = "maximal";
  Tuple mode = "image";
  Tuple refg = 128;
  Tuple thrs = 32;

  HRegionArray exp = seg.ExpandGrayRef (image, empty_region,
                                        iter, mode, refg, thrs);
  exp.Display (win);
  win.Click ();

  return (0);
}

结果

expand_gray_refexpand_gray_refExpandGrayRefExpandGrayRefExpandGrayRefexpand_gray_ref always 返回值 2 ( H_MSG_TRUE) . The behavior in case of empty input (no regions given) can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>), the behavior in case of an empty input region via set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>), and the behavior in case of an empty result region via set_system('store_empty_region',<'true'/'false'>)set_system("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)set_system("store_empty_region",<"true"/"false">). 如有必要，将引发异常。

可能的前置算子

connectionconnectionConnectionConnectionConnectionconnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, pouringpouringPouringPouringPouringpouring, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormClassNdimNormclass_ndim_norm

可能的后置算子

select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape

参考其它

expand_grayexpand_grayExpandGrayExpandGrayExpandGrayexpand_gray, expand_regionexpand_regionExpandRegionExpandRegionExpandRegionexpand_region

模块

Foundation

算子列表