label_to_regionlabel_to_regionLabelToRegionLabelToRegionlabel_to_region (Operator)
Name
label_to_regionlabel_to_regionLabelToRegionLabelToRegionlabel_to_region — Suchen von Regionen mit gleichen Grauwerten.
Signatur
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
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Automatisch parallelisiert auf Tupelebene.
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