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

regiongrowing_nregiongrowing_nRegiongrowingNregiongrowing_nRegiongrowingNRegiongrowingN (Operator)

Name

regiongrowing_nregiongrowing_nRegiongrowingNregiongrowing_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)

Herror regiongrowing_n(Hobject MultiChannelImage, Hobject* Regions, const HTuple& Metric, const HTuple& MinTolerance, const HTuple& MaxTolerance, const HTuple& MinSize)

HRegionArray HImage::RegiongrowingN(const HTuple& Metric, const HTuple& MinTolerance, const HTuple& MaxTolerance, const HTuple& MinSize) const

HRegionArray HImageArray::RegiongrowingN(const HTuple& Metric, const HTuple& MinTolerance, const HTuple& MaxTolerance, const HTuple& MinSize) const

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

void HOperatorSetX.RegiongrowingN(
[in] IHUntypedObjectX* MultiChannelImage, [out] IHUntypedObjectX** Regions, [in] VARIANT Metric, [in] VARIANT MinTolerance, [in] VARIANT MaxTolerance, [in] VARIANT MinSize)

IHRegionX* HImageX.RegiongrowingN(
[in] BSTR Metric, [in] VARIANT MinTolerance, [in] VARIANT MaxTolerance, [in] Hlong MinSize)

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_nRegiongrowingNregiongrowing_nRegiongrowingNRegiongrowingN 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 [MinToleranceMinToleranceMinToleranceMinToleranceMinToleranceminTolerance, MaxToleranceMaxToleranceMaxToleranceMaxToleranceMaxTolerancemaxTolerance] 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 MinToleranceMinToleranceMinToleranceMinToleranceMinToleranceminTolerance, MaxT für MaxToleranceMaxToleranceMaxToleranceMaxToleranceMaxTolerancemaxTolerance.

'1-norm':

Betragssumme

'2-norm':

Euklidischer Abstand

'3-norm':

p - Norm mit p = 3

'4-norm':

p - Norm mit p = 4

'n-norm':

Minkowsky-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 MinSizeMinSizeMinSizeMinSizeMinSizeminSize werden unterdrückt.

Parallelisierung

Parameter

MultiChannelImageMultiChannelImageMultiChannelImageMultiChannelImageMultiChannelImagemultiChannelImage (input_object)  (multichannel-)image(-array) → objectHImageHImageHImageHImageXHobject (byte)

Eingabebild.

RegionsRegionsRegionsRegionsRegionsregions (output_object)  region-array → objectHRegionHRegionHRegionArrayHRegionXHobject *

Segmentierte Regionen.

MetricMetricMetricMetricMetricmetric (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Metrik für Distanz der Merkmalsvektoren.

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

Werteliste: '1-norm'"1-norm""1-norm""1-norm""1-norm""1-norm", '2-norm'"2-norm""2-norm""2-norm""2-norm""2-norm", '3-norm'"3-norm""3-norm""3-norm""3-norm""3-norm", '4-norm'"4-norm""4-norm""4-norm""4-norm""4-norm", 'correlation'"correlation""correlation""correlation""correlation""correlation", 'dot-product'"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-diff", 'gray-max-ratio'"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-diff", 'gray-min-ratio'"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-diff", 'length-ratio'"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-diff", 'max-abs-ratio'"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""max-diff", 'mean-abs-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-abs-ratio", 'mean-diff'"mean-diff""mean-diff""mean-diff""mean-diff""mean-diff", 'mean-ratio'"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-diff", 'min-abs-ratio'"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""min-diff", 'n-norm'"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""n-norm-ratio", 'plane'"plane""plane""plane""plane""plane", 'variance'"variance""variance""variance""variance""variance", 'variance-diff'"variance-diff""variance-diff""variance-diff""variance-diff""variance-diff", 'variance-ratio'"variance-ratio""variance-ratio""variance-ratio""variance-ratio""variance-ratio"

MinToleranceMinToleranceMinToleranceMinToleranceMinToleranceminTolerance (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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

MaxToleranceMaxToleranceMaxToleranceMaxToleranceMaxTolerancemaxTolerance (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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

MinSizeMinSizeMinSizeMinSizeMinSizeminSize (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (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 minSize

Minimale Schrittweite: 1

Empfohlene Schrittweite: 5

Ergebnis

regiongrowing_nregiongrowing_nRegiongrowingNregiongrowing_nRegiongrowingNRegiongrowingN 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""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_systemSetSystemset_systemSetSystemSetSystem). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

compose2compose2Compose2compose2Compose2Compose2, compose3compose3Compose3compose3Compose3Compose3

Alternativen

class_2dim_supclass_2dim_supClass2dimSupclass_2dim_supClass2dimSupClass2dimSup, class_ndim_normclass_ndim_normClassNdimNormclass_ndim_normClassNdimNormClassNdimNorm

Siehe auch

regiongrowing_meanregiongrowing_meanRegiongrowingMeanregiongrowing_meanRegiongrowingMeanRegiongrowingMean

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 13.0.4 Copyright © 1996-2019 MVTec Software GmbH