HALCON Website / HALCON Operator-Referenz / Segmentation / Flächenwachstum
KlassenKlassen | | Operatoren

regiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingN (Operator)

Name

regiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingN — Ausführen eines Flächenwachstumverfahrens für mehrkanalige Bilder.

Signatur

regiongrowing_n(MultiChannelImage : Regions : Metric, MinTolerance, MaxTolerance, MinSize : )

Herror regiongrowing_n(const Hobject MultiChannelImage, Hobject* Regions, const char* Metric, double MinTolerance, double MaxTolerance, const Hlong MinSize)

Herror T_regiongrowing_n(const Hobject MultiChannelImage, Hobject* Regions, const Htuple Metric, const Htuple MinTolerance, const Htuple MaxTolerance, const Htuple MinSize)

void RegiongrowingN(const HObject& MultiChannelImage, HObject* Regions, const HTuple& Metric, const HTuple& MinTolerance, const HTuple& MaxTolerance, const HTuple& MinSize)

HRegion HImage::RegiongrowingN(const HString& Metric, const HTuple& MinTolerance, const HTuple& MaxTolerance, Hlong MinSize) const

HRegion HImage::RegiongrowingN(const HString& Metric, double MinTolerance, double MaxTolerance, Hlong MinSize) const

HRegion HImage::RegiongrowingN(const char* Metric, double MinTolerance, double MaxTolerance, Hlong MinSize) const

HRegion HImage::RegiongrowingN(const wchar_t* Metric, double MinTolerance, double MaxTolerance, Hlong MinSize) const   (Nur Windows)

static void HOperatorSet.RegiongrowingN(HObject multiChannelImage, out HObject regions, HTuple metric, HTuple minTolerance, HTuple maxTolerance, HTuple minSize)

HRegion HImage.RegiongrowingN(string metric, HTuple minTolerance, HTuple maxTolerance, int minSize)

HRegion HImage.RegiongrowingN(string metric, double minTolerance, double maxTolerance, int minSize)

Beschreibung

regiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingNRegiongrowingN führt ein mehrkanaliges Flächenwachstum durch. Die n Kanäle liefern in jedem Bildpunkt einen n-dimensionalen Merkmalsvektor. Benachbarte Punkte werden zu einer Ausgaberegion zusammengefasst, wenn die Differenz ihrer Merkmalsvektoren bezüglich der vorgegebenen Metrik im Intervall [MinToleranceMinToleranceMinToleranceMinToleranceminTolerance, MaxToleranceMaxToleranceMaxToleranceMaxTolerancemaxTolerance] liegen. Untersucht werden direkte Nachbarn in der 4-er Nachbarschaft. Dabei stehen folgende Metriken zur Verfügung:

g_{A} bezeichne einen Grauwert im Vektor A, dem Merkmalsvektor in einem Punkt a, g_{B} die entsprechenden Grauwerte im Vektor B, dem Merkmalsvektor in einem Nachbarpunkt b. g(d) ist der Grauwert mit Index d. MinT steht für MinToleranceMinToleranceMinToleranceMinToleranceminTolerance, MaxT für MaxToleranceMaxToleranceMaxToleranceMaxTolerancemaxTolerance.

'1-norm':

Betragssumme

'2-norm':

Euklidischer Abstand

'3-norm':

p - Norm mit p = 3

'4-norm':

p - Norm mit p = 4

'n-norm':

Minkowski-Distanz

'max-diff':

Supremumsdistanz

'min-diff':

Infimumsdistanz

'variance':

Varianz der Grauwertdifferenzen

'dot-product':

Skalarprodukt

'correlation':

Korrelation

'mean-diff':

Differenz der arithmetischen Mittel

'mean-ratio':

Quotient der arithmetischen Mittel

'length-diff':

Differenz der Vektorlängen

'length-ratio':

Quotient der Vektorlängen

'n-norm-ratio':

Quotient der Vektorlängen bzgl. der p-Norm mit p = n

'gray-max-diff':

Differenz der Maxima

'gray-max-ratio':

Quotient der Maxima

'gray-min-diff':

Differenz der Minima

'gray-min-ratio':

Quotient der Minima

'variance-diff':

Differenz der Varianzen über allen Grauwerten (Kanälen)

'variance-ratio':

Quotient der Varianzen über allen Grauwerten (Kanälen)

'mean-abs-diff':

Differenz der Betragssummen über allen Grauwerten (Kanälen)

'mean-abs-ratio':

Quotient der Betragssummen über allen Grauwerten (Kanälen) (channels)

'max-abs-diff':

Differenz der maximalen Abstände der Komponenten

'max-abs-ratio':

Quotient der maximalen Abstände der Komponenten

'min-abs-diff':

Differenz der minimalen Abstände der Komponenten

'min-abs-ratio':

Quotient der minimalen Abstände der Komponenten

'plane':

Für alle muss gelten:

Regionen mit einer Fläche geringer als MinSizeMinSizeMinSizeMinSizeminSize werden unterdrückt.

Ausführungsinformationen

Parameter

MultiChannelImageMultiChannelImageMultiChannelImageMultiChannelImagemultiChannelImage (input_object)  (multichannel-)image(-array) → objectHImageHImageHobject (byte)

Eingabebild.

RegionsRegionsRegionsRegionsregions (output_object)  region-array → objectHRegionHRegionHobject *

Segmentierte Regionen.

MetricMetricMetricMetricmetric (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Metrik für Distanz der Merkmalsvektoren.

Defaultwert: '2-norm' "2-norm" "2-norm" "2-norm" "2-norm"

Werteliste: '1-norm'"1-norm""1-norm""1-norm""1-norm", '2-norm'"2-norm""2-norm""2-norm""2-norm", '3-norm'"3-norm""3-norm""3-norm""3-norm", '4-norm'"4-norm""4-norm""4-norm""4-norm", 'correlation'"correlation""correlation""correlation""correlation", 'dot-product'"dot-product""dot-product""dot-product""dot-product", 'gray-max-diff'"gray-max-diff""gray-max-diff""gray-max-diff""gray-max-diff", 'gray-max-ratio'"gray-max-ratio""gray-max-ratio""gray-max-ratio""gray-max-ratio", 'gray-min-diff'"gray-min-diff""gray-min-diff""gray-min-diff""gray-min-diff", 'gray-min-ratio'"gray-min-ratio""gray-min-ratio""gray-min-ratio""gray-min-ratio", 'length-diff'"length-diff""length-diff""length-diff""length-diff", 'length-ratio'"length-ratio""length-ratio""length-ratio""length-ratio", 'max-abs-diff'"max-abs-diff""max-abs-diff""max-abs-diff""max-abs-diff", 'max-abs-ratio'"max-abs-ratio""max-abs-ratio""max-abs-ratio""max-abs-ratio", 'max-diff'"max-diff""max-diff""max-diff""max-diff", 'mean-abs-diff'"mean-abs-diff""mean-abs-diff""mean-abs-diff""mean-abs-diff", 'mean-abs-ratio'"mean-abs-ratio""mean-abs-ratio""mean-abs-ratio""mean-abs-ratio", 'mean-diff'"mean-diff""mean-diff""mean-diff""mean-diff", 'mean-ratio'"mean-ratio""mean-ratio""mean-ratio""mean-ratio", 'min-abs-diff'"min-abs-diff""min-abs-diff""min-abs-diff""min-abs-diff", 'min-abs-ratio'"min-abs-ratio""min-abs-ratio""min-abs-ratio""min-abs-ratio", 'min-diff'"min-diff""min-diff""min-diff""min-diff", 'n-norm'"n-norm""n-norm""n-norm""n-norm", 'n-norm-ratio'"n-norm-ratio""n-norm-ratio""n-norm-ratio""n-norm-ratio", 'plane'"plane""plane""plane""plane", 'variance'"variance""variance""variance""variance", 'variance-diff'"variance-diff""variance-diff""variance-diff""variance-diff", 'variance-ratio'"variance-ratio""variance-ratio""variance-ratio""variance-ratio"

MinToleranceMinToleranceMinToleranceMinToleranceminTolerance (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Untere Schwelle für den Merkmalsabstand.

Defaultwert: 0.0

Wertevorschläge: 0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 12.0, 14.0, 16.0, 18.0, 20.0, 25.0, 30.0

MaxToleranceMaxToleranceMaxToleranceMaxTolerancemaxTolerance (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Obere Schwelle für den Merkmalsabstand.

Defaultwert: 20.0

Wertevorschläge: 0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 12.0, 14.0, 16.0, 18.0, 20.0, 25.0, 30.0

MinSizeMinSizeMinSizeMinSizeminSize (input_control)  integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Mindestgröße der Ausgaberegionen.

Defaultwert: 30

Wertevorschläge: 1, 10, 25, 50, 100, 200, 500, 1000

Typischer Wertebereich: 1 ≤ MinSize MinSize MinSize MinSize minSize

Minimale Schrittweite: 1

Empfohlene Schrittweite: 5

Ergebnis

regiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingNRegiongrowingN liefert den Wert 2 (H_MSG_TRUE), falls die Parameter korrekt sind. 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

compose2compose2Compose2Compose2Compose2, compose3compose3Compose3Compose3Compose3

Alternativen

class_2dim_supclass_2dim_supClass2dimSupClass2dimSupClass2dimSup, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormClassNdimNorm

Siehe auch

regiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMeanRegiongrowingMean

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 19.11.0.0 Copyright © 1996-2019 MVTec Software GmbH