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_regionLabelToRegionLabelToRegionlabel_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 thresholdthresholdThresholdThresholdthreshold, gefolgt von der Konkatenation der entstandenen Regionen (concat_objconcat_objConcatObjConcatObjconcat_obj). Verwandt ist die Routine auch mit regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing. label_to_regionlabel_to_regionLabelToRegionLabelToRegionlabel_to_region führt allerdings kein connectionconnectionConnectionConnectionconnection durch, d.h. die Ausgaberegionen müssen nicht zusammenhängen. Eine typische Anwendung von label_to_regionlabel_to_regionLabelToRegionLabelToRegionlabel_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" 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>)get_system("max_outp_obj_par",<Anzahl>) abgefragt werden kann.

Achtung

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

Ausführungsinformationen

Parameter

LabelImageLabelImageLabelImagelabelImagelabel_image (input_object)  singlechannelimage(-array) objectHImageHObjectHObjectHobject (byte / int2 / int4 / int8)

„Gelabeltes“ Bild.

RegionsRegionsRegionsregionsregions (output_object)  region-array objectHRegionHObjectHObjectHobject *

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_regionLabelToRegionLabelToRegionlabel_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", '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_systemSetSystemSetSystemset_system). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

min_max_graymin_max_grayMinMaxGrayMinMaxGraymin_max_gray, sobel_ampsobel_ampSobelAmpSobelAmpsobel_amp, binomial_filterbinomial_filterBinomialFilterBinomialFilterbinomial_filter, gauss_filtergauss_filterGaussFilterGaussFiltergauss_filter, reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, diff_of_gaussdiff_of_gaussDiffOfGaussDiffOfGaussdiff_of_gauss

Nachfolger

connectionconnectionConnectionConnectionconnection, dilation1dilation1Dilation1Dilation1dilation1, erosion1erosion1Erosion1Erosion1erosion1, openingopeningOpeningOpeningopening, closingclosingClosingClosingclosing, rank_regionrank_regionRankRegionRankRegionrank_region, shape_transshape_transShapeTransShapeTransshape_trans, skeletonskeletonSkeletonSkeletonskeleton

Siehe auch

thresholdthresholdThresholdThresholdthreshold, concat_objconcat_objConcatObjConcatObjconcat_obj, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing, region_to_labelregion_to_labelRegionToLabelRegionToLabelregion_to_label

Modul

Foundation