label_to_regionlabel_to_regionLabelToRegionLabelToRegion (Operator)

Name

label_to_regionlabel_to_regionLabelToRegionLabelToRegion — Suchen von Regionen mit gleichen Grauwerten.

Signatur

label_to_region(LabelImage : Regions : : )

Herror label_to_region(const Hobject LabelImage, Hobject* Regions)

Herror T_label_to_region(const Hobject LabelImage, Hobject* Regions)

void LabelToRegion(const HObject& LabelImage, HObject* Regions)

HRegion HImage::LabelToRegion() const

static void HOperatorSet.LabelToRegion(HObject labelImage, out HObject regions)

HRegion HImage.LabelToRegion()

Beschreibung

label_to_regionlabel_to_regionLabelToRegionLabelToRegionLabelToRegion segmentiert Bilder in Regionen gleichen Grauwerts. Dabei wird für jeden Grauwert im Bild genau eine Ausgaberegion erzeugt. Dies entspricht einem mehrfachen Aufruf des Operators thresholdthresholdThresholdThresholdThreshold, gefolgt von der Konkatenation der entstandenen Regionen (concat_objconcat_objConcatObjConcatObjConcatObj). Verwandt ist die Routine auch mit regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing. label_to_regionlabel_to_regionLabelToRegionLabelToRegionLabelToRegion führt allerdings kein connectionconnectionConnectionConnectionConnection durch, d.h. die Ausgaberegionen müssen nicht zusammenhängen. Eine typische Anwendung von label_to_regionlabel_to_regionLabelToRegionLabelToRegionLabelToRegion ist die Segmentation „gelabelter“ Bilder, daher auch der Name.

Die Anzahl der Ausgaberegionen wird durch den Systemparameter 'max_outp_obj_par' begrenzt, der mittels get_system(::'max_outp_obj_par':<Anzahl>) abgefragt werden kann.

Achtung

label_to_regionlabel_to_regionLabelToRegionLabelToRegionLabelToRegion ist nicht für Real-Bilder implementiert. Die Eingabebilder dürfen keine negativen Grauwerte enthalten.

Ausführungsinformationen

Parameter

LabelImageLabelImageLabelImageLabelImagelabelImage (input_object)  singlechannelimage(-array) objectHImageHImageHobject (byte / int2 / int4 / int8)

„Gelabeltes“ Bild.

RegionsRegionsRegionsRegionsregions (output_object)  region-array objectHRegionHRegionHobject *

Regionen mit konstantem Grauwert.

Komplexität

Sei x1 die minimale X-Koordinate, x2 die maximale X-Koordinate, y1 die minimale Y-Koordinate und y2 die maximale Y-Koordinate eines auftretenden Grauwertes und N die Anzahl der verschiedenen Grauwerte, dann ist die Laufzeitkomplexität O(N * (x2 - x1 + 1) * (y2 - y1 + 1))

Ergebnis

Sind die Grauwerte in einem zulässigen Bereich, dann liefert label_to_regionlabel_to_regionLabelToRegionLabelToRegionLabelToRegion den Wert 2 (H_MSG_TRUE). Für das Verhalten bzgl. der Eingabebilder und Ausgaberegionen sind die Flags 'no_object_result'"no_object_result""no_object_result""no_object_result""no_object_result", 'empty_region_result'"empty_region_result""empty_region_result""empty_region_result""empty_region_result" und 'store_empty_region'"store_empty_region""store_empty_region""store_empty_region""store_empty_region" einstellbar (siehe set_systemset_systemSetSystemSetSystemSetSystem). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray, sobel_ampsobel_ampSobelAmpSobelAmpSobelAmp, binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilter, gauss_filtergauss_filterGaussFilterGaussFilterGaussFilter, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, diff_of_gaussdiff_of_gaussDiffOfGaussDiffOfGaussDiffOfGauss

Nachfolger

connectionconnectionConnectionConnectionConnection, dilation1dilation1Dilation1Dilation1Dilation1, erosion1erosion1Erosion1Erosion1Erosion1, openingopeningOpeningOpeningOpening, closingclosingClosingClosingClosing, rank_regionrank_regionRankRegionRankRegionRankRegion, shape_transshape_transShapeTransShapeTransShapeTrans, skeletonskeletonSkeletonSkeletonSkeleton

Siehe auch

thresholdthresholdThresholdThresholdThreshold, concat_objconcat_objConcatObjConcatObjConcatObj, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, region_to_labelregion_to_labelRegionToLabelRegionToLabelRegionToLabel

Modul

Foundation