remove_noise_regionremove_noise_regionRemoveNoiseRegionRemoveNoiseRegionremove_noise_region (Operator)

Name

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'

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

'n_8'

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

'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

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