union1union1Union1Union1union1 (Operator)

Name

union1union1Union1Union1union1 — Return the union of all input regions.

Signature

union1(Region : RegionUnion : : )

Herror union1(const Hobject Region, Hobject* RegionUnion)

Herror T_union1(const Hobject Region, Hobject* RegionUnion)

void Union1(const HObject& Region, HObject* RegionUnion)

HRegion HRegion::Union1() const

static void HOperatorSet.Union1(HObject region, out HObject regionUnion)

HRegion HRegion.Union1()

def union1(region: HObject) -> HObject

Description

union1union1Union1Union1Union1union1 computes the union of all input regions and returns the result in RegionUnionRegionUnionRegionUnionRegionUnionregionUnionregion_union.

Execution Information

Parameters

RegionRegionRegionRegionregionregion (input_object)  region-array objectHRegionHObjectHRegionHobject

Regions of which the union is to be computed.

RegionUnionRegionUnionRegionUnionRegionUnionregionUnionregion_union (output_object)  region objectHRegionHObjectHRegionHobject *

Union of all input regions.

Number of elements: RegionUnion <= Region

Example (HDevelop)

* Union of segmentation results:
threshold(Image,Region1,128,255)
dyn_threshold(Image,Mean,Region2,5,'light')
concat_obj(Region1,Region2,Regions)
union1(Regions,RegionUnion)

Example (C)

/* Union of segmentation results: */
threshold(Image,&Region1,128.0,255.0);
dyn_threshold(Image,Mean,&Region2,5.0,"light");
concat_obj(Region1,Region2,&Regions);
union1(Regions,&RegionUnion);

Example (HDevelop)

* Union of segmentation results:
threshold(Image,Region1,128,255)
dyn_threshold(Image,Mean,Region2,5,'light')
concat_obj(Region1,Region2,Regions)
union1(Regions,RegionUnion)

Example (HDevelop)

* Union of segmentation results:
threshold(Image,Region1,128,255)
dyn_threshold(Image,Mean,Region2,5,'light')
concat_obj(Region1,Region2,Regions)
union1(Regions,RegionUnion)

Example (HDevelop)

* Union of segmentation results:
threshold(Image,Region1,128,255)
dyn_threshold(Image,Mean,Region2,5,'light')
concat_obj(Region1,Region2,Regions)
union1(Regions,RegionUnion)

Complexity

Let F be the sum of all areas of the input regions. Then the runtime complexity is O(log(sqrt(F)) * sqrt(F)).

Result

union1union1Union1Union1Union1union1 always returns 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>) and 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>). If necessary, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdThresholdThresholdthreshold, connectionconnectionConnectionConnectionConnectionconnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, pouringpouringPouringPouringPouringpouring

Possible Successors

select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region

Alternatives

union2union2Union2Union2Union2union2

See also

intersectionintersectionIntersectionIntersectionIntersectionintersection, complementcomplementComplementComplementComplementcomplement

Module

Foundation