label_to_regionlabel_to_regionLabelToRegionLabelToRegionlabel_to_region (Operator)

Name

label_to_regionlabel_to_regionLabelToRegionLabelToRegionlabel_to_region — 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()

def label_to_region(label_image: HObject) -> HObject

Beschreibung

label_to_regionlabel_to_regionLabelToRegionLabelToRegionLabelToRegionlabel_to_region 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 thresholdthresholdThresholdThresholdThresholdthreshold, gefolgt von der Konkatenation der entstandenen Regionen (concat_objconcat_objConcatObjConcatObjConcatObjconcat_obj). Verwandt ist die Routine auch mit regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing. label_to_regionlabel_to_regionLabelToRegionLabelToRegionLabelToRegionlabel_to_region führt allerdings kein connectionconnectionConnectionConnectionConnectionconnection durch, d.h. die Ausgaberegionen müssen nicht zusammenhängen. Eine typische Anwendung von label_to_regionlabel_to_regionLabelToRegionLabelToRegionLabelToRegionlabel_to_region ist die Segmentierung „gelabelter“ Bilder, daher auch der Name.

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

Achtung

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

Ausführungsinformationen

Parameter

LabelImageLabelImageLabelImageLabelImagelabelImagelabel_image (input_object)  singlechannelimage(-array) objectHImageHObjectHImageHobject (byte / int2 / int4 / int8)

„Gelabeltes“ Bild.

RegionsRegionsRegionsRegionsregionsregions (output_object)  region-array objectHRegionHObjectHRegionHobject *

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_regionLabelToRegionLabelToRegionLabelToRegionlabel_to_region 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""no_object_result", 'empty_region_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""store_empty_region" einstellbar (siehe set_systemset_systemSetSystemSetSystemSetSystemset_system). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGraymin_max_gray, sobel_ampsobel_ampSobelAmpSobelAmpSobelAmpsobel_amp, binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilterbinomial_filter, gauss_filtergauss_filterGaussFilterGaussFilterGaussFiltergauss_filter, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain, diff_of_gaussdiff_of_gaussDiffOfGaussDiffOfGaussDiffOfGaussdiff_of_gauss

Nachfolger

connectionconnectionConnectionConnectionConnectionconnection, dilation1dilation1Dilation1Dilation1Dilation1dilation1, erosion1erosion1Erosion1Erosion1Erosion1erosion1, openingopeningOpeningOpeningOpeningopening, closingclosingClosingClosingClosingclosing, rank_regionrank_regionRankRegionRankRegionRankRegionrank_region, shape_transshape_transShapeTransShapeTransShapeTransshape_trans, skeletonskeletonSkeletonSkeletonSkeletonskeleton

Siehe auch

thresholdthresholdThresholdThresholdThresholdthreshold, concat_objconcat_objConcatObjConcatObjConcatObjconcat_obj, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, region_to_labelregion_to_labelRegionToLabelRegionToLabelRegionToLabelregion_to_label

Modul

Foundation