KlassenKlassenKlassenKlassen | | | | Operatoren

fast_thresholdfast_thresholdFastThresholdfast_thresholdFastThresholdFastThreshold (Operator)

Name

fast_thresholdfast_thresholdFastThresholdfast_thresholdFastThresholdFastThreshold — Schnelles Segmentieren mit globalen Schwellenwerten.

Signatur

fast_threshold(Image : Region : MinGray, MaxGray, MinSize : )

Herror fast_threshold(const Hobject Image, Hobject* Region, double MinGray, double MaxGray, const Hlong MinSize)

Herror T_fast_threshold(const Hobject Image, Hobject* Region, const Htuple MinGray, const Htuple MaxGray, const Htuple MinSize)

Herror fast_threshold(Hobject Image, Hobject* Region, const HTuple& MinGray, const HTuple& MaxGray, const HTuple& MinSize)

HRegion HImage::FastThreshold(const HTuple& MinGray, const HTuple& MaxGray, const HTuple& MinSize) const

HRegionArray HImageArray::FastThreshold(const HTuple& MinGray, const HTuple& MaxGray, const HTuple& MinSize) const

void FastThreshold(const HObject& Image, HObject* Region, const HTuple& MinGray, const HTuple& MaxGray, const HTuple& MinSize)

HRegion HImage::FastThreshold(const HTuple& MinGray, const HTuple& MaxGray, Hlong MinSize) const

HRegion HImage::FastThreshold(double MinGray, double MaxGray, Hlong MinSize) const

void HOperatorSetX.FastThreshold(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*Region, [in] VARIANT MinGray, [in] VARIANT MaxGray, [in] VARIANT MinSize)

IHRegionX* HImageX.FastThreshold(
[in] VARIANT MinGray, [in] VARIANT MaxGray, [in] Hlong MinSize)

static void HOperatorSet.FastThreshold(HObject image, out HObject region, HTuple minGray, HTuple maxGray, HTuple minSize)

HRegion HImage.FastThreshold(HTuple minGray, HTuple maxGray, int minSize)

HRegion HImage.FastThreshold(double minGray, double maxGray, int minSize)

Beschreibung

fast_thresholdfast_thresholdFastThresholdfast_thresholdFastThresholdFastThreshold wählt aus den Eingabebildern die Bildpunkte aus, deren Grauwerte g der Schwellenwertbedingung

genügen. Für eine schnellere Bearbeitung erfolgt die Auswahl der Punkte in zwei Schritten: Zunächst werden alle Punkte bestimmter Zeilen, welche durch ihren Abstand festgelegt werden, untersucht. Danach wird in der Umgebung ((2*MinSize+1) x (2*MinSize+1)) aller so gefundenen Punkte eine genauere Segmentierung durchgeführt.

Achtung

Auf Mehrkernprozessoren, die den SSE2 Befehlssatz unterstützen, ist thresholdthresholdThresholdthresholdThresholdThreshold meist schneller als fast_thresholdfast_thresholdFastThresholdfast_thresholdFastThresholdFastThreshold. fast_thresholdfast_thresholdFastThresholdfast_thresholdFastThresholdFastThreshold sollte nur dann thresholdthresholdThresholdthresholdThresholdThreshold vorgezogen werden, wenn diese Features nicht verfügbar sind, zum Beispiel in eingebetteten Systemen.

Parallelisierung

Parameter

ImageImageImageImageImageimage (input_object)  singlechannelimage(-array) objectHImageHImageHImageHImageXHobject (byte / uint2 / direction / cyclic / real)

Eingabebild.

RegionRegionRegionRegionRegionregion (output_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject *

Segmentierte Region.

MinGrayMinGrayMinGrayMinGrayMinGrayminGray (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Untere Schwelle für die Grauwerte.

Defaultwert: 128

Wertevorschläge: 0.0, 10.0, 30.0, 64.0, 128.0, 200.0, 220.0, 255.0

Typischer Wertebereich: 0.0 ≤ MinGray MinGray MinGray MinGray MinGray minGray ≤ 255.0 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 5.0

MaxGrayMaxGrayMaxGrayMaxGrayMaxGraymaxGray (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Obere Schwelle für die Grauwerte.

Defaultwert: 255.0

Wertevorschläge: 0.0, 10.0, 30.0, 64.0, 128.0, 200.0, 220.0, 255.0

Typischer Wertebereich: 0.0 ≤ MaxGray MaxGray MaxGray MaxGray MaxGray maxGray ≤ 255.0 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 5.0

MinSizeMinSizeMinSizeMinSizeMinSizeminSize (input_control)  number HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Mindestgröße eines Objektes.

Defaultwert: 20

Wertevorschläge: 5, 10, 15, 20, 25, 30, 40, 50, 60, 70, 100

Typischer Wertebereich: 2 ≤ MinSize MinSize MinSize MinSize MinSize minSize ≤ 200 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 2

Komplexität

Sei A die Fläche der Ausgaberegion und height die Höhe von ImageImageImageImageImageimage, dann ist die Laufzeitkomplexität O(A + height / MinSizeMinSizeMinSizeMinSizeMinSizeminSize).

Ergebnis

Sind die Parameterwerte korrekt, dann liefert fast_thresholdfast_thresholdFastThresholdfast_thresholdFastThresholdFastThreshold den Wert 2 (H_MSG_TRUE). Für das Verhalten bzgl. der Ein- und Ausgabebilder sind die Flags 'no_object_result', 'empty_region_result' und 'store_empty_region' einstellbar (siehe set_systemset_systemSetSystemset_systemSetSystemSetSystem). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

histo_to_threshhisto_to_threshHistoToThreshhisto_to_threshHistoToThreshHistoToThresh, min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray, sobel_ampsobel_ampSobelAmpsobel_ampSobelAmpSobelAmp, binomial_filterbinomial_filterBinomialFilterbinomial_filterBinomialFilterBinomialFilter, gauss_filtergauss_filterGaussFiltergauss_filterGaussFilterGaussFilter, reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, fill_interlacefill_interlaceFillInterlacefill_interlaceFillInterlaceFillInterlace

Nachfolger

connectionconnectionConnectionconnectionConnectionConnection, dilation1dilation1Dilation1dilation1Dilation1Dilation1, erosion1erosion1Erosion1erosion1Erosion1Erosion1, openingopeningOpeningopeningOpeningOpening, closingclosingClosingclosingClosingClosing, rank_regionrank_regionRankRegionrank_regionRankRegionRankRegion, shape_transshape_transShapeTransshape_transShapeTransShapeTrans, skeletonskeletonSkeletonskeletonSkeletonSkeleton

Alternativen

thresholdthresholdThresholdthresholdThresholdThreshold, gen_grid_regiongen_grid_regionGenGridRegiongen_grid_regionGenGridRegionGenGridRegion, dilation_rectangle1dilation_rectangle1DilationRectangle1dilation_rectangle1DilationRectangle1DilationRectangle1, dyn_thresholddyn_thresholdDynThresholddyn_thresholdDynThresholdDynThreshold

Siehe auch

class_2dim_supclass_2dim_supClass2dimSupclass_2dim_supClass2dimSupClass2dimSup, hysteresis_thresholdhysteresis_thresholdHysteresisThresholdhysteresis_thresholdHysteresisThresholdHysteresisThreshold

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren