Operator Reference

HALCON Operator Reference / Regions / Transformations
ClassesClasses | | Operators

remove_noise_regionremove_noise_regionRemoveNoiseRegionRemoveNoiseRegionremove_noise_region (Operator)

remove_noise_regionremove_noise_regionRemoveNoiseRegionRemoveNoiseRegionremove_noise_region — Remove noise from a region.

Signature

remove_noise_region(InputRegion : OutputRegion : Type : )

Herror remove_noise_region(const Hobject InputRegion, Hobject* OutputRegion, const char* Type)

Herror T_remove_noise_region(const Hobject InputRegion, Hobject* OutputRegion, const Htuple Type)

void RemoveNoiseRegion(const HObject& InputRegion, HObject* OutputRegion, const HTuple& Type)

HRegion HRegion::RemoveNoiseRegion(const HString& Type) const

HRegion HRegion::RemoveNoiseRegion(const char* Type) const

HRegion HRegion::RemoveNoiseRegion(const wchar_t* Type) const   ( Windows only)

static void HOperatorSet.RemoveNoiseRegion(HObject inputRegion, out HObject outputRegion, HTuple type)

HRegion HRegion.RemoveNoiseRegion(string type)

def remove_noise_region(input_region: HObject, type: str) -> HObject

Description

remove_noise_regionremove_noise_regionRemoveNoiseRegionRemoveNoiseRegionremove_noise_region removes noise from a region. Depending on TypeTypeTypetypetype one of the following structuring elements will be used:

'n_4'"n_4""n_4""n_4""n_4"

A structuring element consisting of the four 4-neighbors of a point is being used: .X. X.X .X.

'n_8'"n_8""n_8""n_8""n_8"

A structuring element consisting of the four 8-neighbors of a point is being used: X.X ... X.X

'n_48'"n_48""n_48""n_48""n_48"

A structuring element consisting of the four 4-neighbors and the four 8-neighbors of a point is being used: XXX X.X XXX

A dilation with this structuring element is performed and the intersection of the result and the input region is calculated. Thus, all pixels having no according neighbors are removed.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Automatically parallelized on tuple level.

Parameters

InputRegionInputRegionInputRegioninputRegioninput_region (input_object)  region(-array) → objectHRegionHObjectHObjectHobject

Regions to be modified.

OutputRegionOutputRegionOutputRegionoutputRegionoutput_region (output_object)  region(-array) → objectHRegionHObjectHObjectHobject *

Less noisy regions.

TypeTypeTypetypetype (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Mode of noise removal.

Default: 'n_4' "n_4" "n_4" "n_4" "n_4"

List of values: 'n_4'"n_4""n_4""n_4""n_4", 'n_48'"n_48""n_48""n_48""n_48", 'n_8'"n_8""n_8""n_8""n_8"

Complexity

Let F be the area of the input region. Then the runtime complexity is

Result

remove_noise_regionremove_noise_regionRemoveNoiseRegionRemoveNoiseRegionremove_noise_region returns 2 ( H_MSG_TRUE) if all parameters are correct. 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>)set_system("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

connectionconnectionConnectionConnectionconnection, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing, pouringpouringPouringPouringpouring, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormclass_ndim_norm

Possible Successors

select_shapeselect_shapeSelectShapeSelectShapeselect_shape

See also

dilation1dilation1Dilation1Dilation1dilation1, intersectionintersectionIntersectionIntersectionintersection, gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsgen_region_points

Module

Foundation

ClassesClasses | | Operators