HALCON Website / HALCON Operator-Referenz / 1D-Vermessung
KlassenKlassenKlassenKlassen | | | | Operatoren

fuzzy_measure_pairingT_fuzzy_measure_pairingFuzzyMeasurePairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairing (Operator)

Name

fuzzy_measure_pairingT_fuzzy_measure_pairingFuzzyMeasurePairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairing — Extraktion geradliniger Kantenpaare senkrecht zu einem Rechteck oder Kreisringsegment.

Signatur

fuzzy_measure_pairing(Image : : MeasureHandle, Sigma, AmpThresh, FuzzyThresh, Transition, Pairing, NumPairs : RowEdgeFirst, ColumnEdgeFirst, AmplitudeFirst, RowEdgeSecond, ColumnEdgeSecond, AmplitudeSecond, RowPairCenter, ColumnPairCenter, FuzzyScore, IntraDistance)

Herror T_fuzzy_measure_pairing(const Hobject Image, const Htuple MeasureHandle, const Htuple Sigma, const Htuple AmpThresh, const Htuple FuzzyThresh, const Htuple Transition, const Htuple Pairing, const Htuple NumPairs, Htuple* RowEdgeFirst, Htuple* ColumnEdgeFirst, Htuple* AmplitudeFirst, Htuple* RowEdgeSecond, Htuple* ColumnEdgeSecond, Htuple* AmplitudeSecond, Htuple* RowPairCenter, Htuple* ColumnPairCenter, Htuple* FuzzyScore, Htuple* IntraDistance)

Herror fuzzy_measure_pairing(Hobject Image, const HTuple& MeasureHandle, const HTuple& Sigma, const HTuple& AmpThresh, const HTuple& FuzzyThresh, const HTuple& Transition, const HTuple& Pairing, const HTuple& NumPairs, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowPairCenter, HTuple* ColumnPairCenter, HTuple* FuzzyScore, HTuple* IntraDistance)

HTuple HImage::FuzzyMeasurePairing(const HMeasure& MeasureHandle, const HTuple& Sigma, const HTuple& AmpThresh, const HTuple& FuzzyThresh, const HTuple& Transition, const HTuple& Pairing, const HTuple& NumPairs, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowPairCenter, HTuple* ColumnPairCenter, HTuple* FuzzyScore, HTuple* IntraDistance) const

HTuple HMeasure::FuzzyMeasurePairing(const HImage& Image, const HTuple& Sigma, const HTuple& AmpThresh, const HTuple& FuzzyThresh, const HTuple& Transition, const HTuple& Pairing, const HTuple& NumPairs, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowPairCenter, HTuple* ColumnPairCenter, HTuple* FuzzyScore, HTuple* IntraDistance) const

void FuzzyMeasurePairing(const HObject& Image, const HTuple& MeasureHandle, const HTuple& Sigma, const HTuple& AmpThresh, const HTuple& FuzzyThresh, const HTuple& Transition, const HTuple& Pairing, const HTuple& NumPairs, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowPairCenter, HTuple* ColumnPairCenter, HTuple* FuzzyScore, HTuple* IntraDistance)

void HMeasure::FuzzyMeasurePairing(const HImage& Image, double Sigma, double AmpThresh, double FuzzyThresh, const HString& Transition, const HString& Pairing, Hlong NumPairs, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowPairCenter, HTuple* ColumnPairCenter, HTuple* FuzzyScore, HTuple* IntraDistance) const

void HMeasure::FuzzyMeasurePairing(const HImage& Image, double Sigma, double AmpThresh, double FuzzyThresh, const char* Transition, const char* Pairing, Hlong NumPairs, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowPairCenter, HTuple* ColumnPairCenter, HTuple* FuzzyScore, HTuple* IntraDistance) const

void HImage::FuzzyMeasurePairing(const HMeasure& MeasureHandle, double Sigma, double AmpThresh, double FuzzyThresh, const HString& Transition, const HString& Pairing, Hlong NumPairs, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowPairCenter, HTuple* ColumnPairCenter, HTuple* FuzzyScore, HTuple* IntraDistance) const

void HImage::FuzzyMeasurePairing(const HMeasure& MeasureHandle, double Sigma, double AmpThresh, double FuzzyThresh, const char* Transition, const char* Pairing, Hlong NumPairs, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowPairCenter, HTuple* ColumnPairCenter, HTuple* FuzzyScore, HTuple* IntraDistance) const

void HOperatorSetX.FuzzyMeasurePairing(
[in] IHUntypedObjectX* Image, [in] VARIANT MeasureHandle, [in] VARIANT Sigma, [in] VARIANT AmpThresh, [in] VARIANT FuzzyThresh, [in] VARIANT Transition, [in] VARIANT Pairing, [in] VARIANT NumPairs, [out] VARIANT* RowEdgeFirst, [out] VARIANT* ColumnEdgeFirst, [out] VARIANT* AmplitudeFirst, [out] VARIANT* RowEdgeSecond, [out] VARIANT* ColumnEdgeSecond, [out] VARIANT* AmplitudeSecond, [out] VARIANT* RowPairCenter, [out] VARIANT* ColumnPairCenter, [out] VARIANT* FuzzyScore, [out] VARIANT* IntraDistance)

VARIANT HMeasureX.FuzzyMeasurePairing(
[in] IHImageX* Image, [in] double Sigma, [in] double AmpThresh, [in] double FuzzyThresh, [in] BSTR Transition, [in] BSTR Pairing, [in] Hlong NumPairs, [out] VARIANT* ColumnEdgeFirst, [out] VARIANT* AmplitudeFirst, [out] VARIANT* RowEdgeSecond, [out] VARIANT* ColumnEdgeSecond, [out] VARIANT* AmplitudeSecond, [out] VARIANT* RowPairCenter, [out] VARIANT* ColumnPairCenter, [out] VARIANT* FuzzyScore, [out] VARIANT* IntraDistance)

VARIANT HImageX.FuzzyMeasurePairing(
[in] IHMeasureX* MeasureHandle, [in] double Sigma, [in] double AmpThresh, [in] double FuzzyThresh, [in] BSTR Transition, [in] BSTR Pairing, [in] Hlong NumPairs, [out] VARIANT* ColumnEdgeFirst, [out] VARIANT* AmplitudeFirst, [out] VARIANT* RowEdgeSecond, [out] VARIANT* ColumnEdgeSecond, [out] VARIANT* AmplitudeSecond, [out] VARIANT* RowPairCenter, [out] VARIANT* ColumnPairCenter, [out] VARIANT* FuzzyScore, [out] VARIANT* IntraDistance)

static void HOperatorSet.FuzzyMeasurePairing(HObject image, HTuple measureHandle, HTuple sigma, HTuple ampThresh, HTuple fuzzyThresh, HTuple transition, HTuple pairing, HTuple numPairs, out HTuple rowEdgeFirst, out HTuple columnEdgeFirst, out HTuple amplitudeFirst, out HTuple rowEdgeSecond, out HTuple columnEdgeSecond, out HTuple amplitudeSecond, out HTuple rowPairCenter, out HTuple columnPairCenter, out HTuple fuzzyScore, out HTuple intraDistance)

void HMeasure.FuzzyMeasurePairing(HImage image, double sigma, double ampThresh, double fuzzyThresh, string transition, string pairing, int numPairs, out HTuple rowEdgeFirst, out HTuple columnEdgeFirst, out HTuple amplitudeFirst, out HTuple rowEdgeSecond, out HTuple columnEdgeSecond, out HTuple amplitudeSecond, out HTuple rowPairCenter, out HTuple columnPairCenter, out HTuple fuzzyScore, out HTuple intraDistance)

void HImage.FuzzyMeasurePairing(HMeasure measureHandle, double sigma, double ampThresh, double fuzzyThresh, string transition, string pairing, int numPairs, out HTuple rowEdgeFirst, out HTuple columnEdgeFirst, out HTuple amplitudeFirst, out HTuple rowEdgeSecond, out HTuple columnEdgeSecond, out HTuple amplitudeSecond, out HTuple rowPairCenter, out HTuple columnPairCenter, out HTuple fuzzyScore, out HTuple intraDistance)

Beschreibung

fuzzy_measure_pairingfuzzy_measure_pairingFuzzyMeasurePairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairing dient zur Extraktion von geradlinigen Kantenpaaren, die senkrecht zur Hauptachse eines Rechtecks oder zu einem Kreisbogensegment liegen.

Das Konzept der 1D-Vermessung ist bei der Einleitung zu Kapitel 1D-Vermessung beschrieben.

Der Algorithmus von fuzzy_measure_pairingfuzzy_measure_pairingFuzzyMeasurePairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairing arbeitet analog zu fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairs (siehe dort für Details) mit der Ausnahme, dass es über den Parameter PairingPairingPairingPairingPairingpairing zusätzlich möglich ist, sich überschneidende und ineinanderliegende Kantenpaare zu extrahieren. Derzeit steht nur der Wert 'no_restriction'"no_restriction""no_restriction""no_restriction""no_restriction""no_restriction" zu Verfügung, der alle möglichen Kantenpaare zurückliefert, die sich sowohl gegenseitig überlagern als auch einschließen können.

Es werden nur die NumPairsNumPairsNumPairsNumPairsNumPairsnumPairs am besten bewerteten Kantenpaare zurückgeliefert, wobei der Wert 0 bedeutet, dass alle gefundenen Kantenkombinationen zurückgeliefert werden.

Die extrahierten Kanten werden als einzelne Punkte, die auf der Hauptachse des Rechtecks oder dem mittleren Bogen des Kreisringsegments liegen, zurückgegeben. Die zugehörigen Kantenamplituden werden in AmplitudeFirstAmplitudeFirstAmplitudeFirstAmplitudeFirstAmplitudeFirstamplitudeFirst und AmplitudeSecondAmplitudeSecondAmplitudeSecondAmplitudeSecondAmplitudeSecondamplitudeSecond, die Fuzzy-Bewertungen in FuzzyScoreFuzzyScoreFuzzyScoreFuzzyScoreFuzzyScorefuzzyScore zurückgeliefert. Zusätzlich wird noch der Abstand innerhalb eines Kantenpaares in IntraDistanceIntraDistanceIntraDistanceIntraDistanceIntraDistanceintraDistance zurückgeliefert.

Achtung

fuzzy_measure_pairingfuzzy_measure_pairingFuzzyMeasurePairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairing liefert nur dann brauchbare Ergebnisse, falls die Annahme, dass die Kanten gerade und senkrecht zur Hauptachse des Rechtecks oder zum Kreisringsegment sind, erfüllt ist. fuzzy_measure_pairingfuzzy_measure_pairingFuzzyMeasurePairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairing sollte daher z.B. nicht dazu verwendet werden, Kanten von gekrümmten Objekten zu extrahieren. Weiterhin sollte der Benutzer darauf achten, dass das Rechteck / das Kreisringsegment möglichst senkrecht zu den Bildkanten liegt. Außerdem darf SigmaSigmaSigmaSigmaSigmasigma nicht größer als ca. 0.5 * Length1 (siehe gen_measure_rectangle2gen_measure_rectangle2GenMeasureRectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2 für Length1) sein.

Es ist zu beachten, dass fuzzy_measure_pairingfuzzy_measure_pairingFuzzyMeasurePairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairing den Definitionsbereich von ImageImageImageImageImageimage aus Geschwindigkeitsgründen ignoriert. Falls bestimmte Bildbereiche von der Messung ausgeschlossen werden sollen, sollte ein neues Messobjekt mit entsprechend angepassten Parametern erzeugt werden.

Parallelisierung

Parameter

ImageImageImageImageImageimage (input_object)  singlechannelimage → objectHImageHImageHImageHImageXHobject (byte / uint2 / real)

Eingabebild.

MeasureHandleMeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandle (input_control)  measure_id → HMeasure, HTupleHTupleHMeasure, HTupleHMeasureX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle des Messobjekts.

SigmaSigmaSigmaSigmaSigmasigma (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Sigma der Gaußglättung.

Defaultwert: 1.0

Wertevorschläge: 0.4, 0.6, 0.8, 1.0, 1.5, 2.0, 3.0, 4.0, 5.0, 7.0, 10.0

Typischer Wertebereich: 0.4 ≤ Sigma Sigma Sigma Sigma Sigma sigma ≤ 100 (lin)

Minimale Schrittweite: 0.01

Empfohlene Schrittweite: 0.1

Restriktion: Sigma >= 0.4

AmpThreshAmpThreshAmpThreshAmpThreshAmpThreshampThresh (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Minimale Amplitude einer Kante.

Defaultwert: 30.0

Wertevorschläge: 5.0, 10.0, 20.0, 30.0, 40.0, 50.0, 60.0, 70.0, 90.0, 110.0

Typischer Wertebereich: 1 ≤ AmpThresh AmpThresh AmpThresh AmpThresh AmpThresh ampThresh ≤ 255 (lin)

Minimale Schrittweite: 0.5

Empfohlene Schrittweite: 2

FuzzyThreshFuzzyThreshFuzzyThreshFuzzyThreshFuzzyThreshfuzzyThresh (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Minimale Fuzzy-Bewertung.

Defaultwert: 0.5

Wertevorschläge: 0.1, 0.3, 0.5, 0.7, 0.9

Typischer Wertebereich: 0.0 ≤ FuzzyThresh FuzzyThresh FuzzyThresh FuzzyThresh FuzzyThresh fuzzyThresh ≤ 1.0 (lin)

Empfohlene Schrittweite: 0.1

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

Auswahl des ersten Grauwertüberganges der Kantenpaare.

Defaultwert: 'all' "all" "all" "all" "all" "all"

Werteliste: 'all'"all""all""all""all""all", 'negative'"negative""negative""negative""negative""negative", 'positive'"positive""positive""positive""positive""positive"

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

Beschränkung der Paarbildung.

Defaultwert: 'no_restriction' "no_restriction" "no_restriction" "no_restriction" "no_restriction" "no_restriction"

Werteliste: 'no_restriction'"no_restriction""no_restriction""no_restriction""no_restriction""no_restriction"

NumPairsNumPairsNumPairsNumPairsNumPairsnumPairs (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Maximale Anzahl der Kantenpaare.

Defaultwert: 10

Wertevorschläge: 0, 1, 10, 20, 50

Typischer Wertebereich: 0 ≤ NumPairs NumPairs NumPairs NumPairs NumPairs numPairs

Empfohlene Schrittweite: 1

RowEdgeFirstRowEdgeFirstRowEdgeFirstRowEdgeFirstRowEdgeFirstrowEdgeFirst (output_control)  point.y-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Zeilenkoordinate der ersten Kante.

ColumnEdgeFirstColumnEdgeFirstColumnEdgeFirstColumnEdgeFirstColumnEdgeFirstcolumnEdgeFirst (output_control)  point.x-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Spaltenkoordinate der ersten Kante.

AmplitudeFirstAmplitudeFirstAmplitudeFirstAmplitudeFirstAmplitudeFirstamplitudeFirst (output_control)  real-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Kantenamplitude der ersten Kante (mit Vorzeichen).

RowEdgeSecondRowEdgeSecondRowEdgeSecondRowEdgeSecondRowEdgeSecondrowEdgeSecond (output_control)  point.y-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Zeilenkoordinate der zweiten Kante.

ColumnEdgeSecondColumnEdgeSecondColumnEdgeSecondColumnEdgeSecondColumnEdgeSecondcolumnEdgeSecond (output_control)  point.x-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Spaltenkoordinate der zweiten Kante.

AmplitudeSecondAmplitudeSecondAmplitudeSecondAmplitudeSecondAmplitudeSecondamplitudeSecond (output_control)  real-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Kantenamplitude der zweiten Kante (mit Vorzeichen).

RowPairCenterRowPairCenterRowPairCenterRowPairCenterRowPairCenterrowPairCenter (output_control)  point.y-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Zeilenkoordinate des Mittelpunktes des Kantenpaares.

ColumnPairCenterColumnPairCenterColumnPairCenterColumnPairCenterColumnPairCentercolumnPairCenter (output_control)  point.x-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Spaltenkoordinate des Mittelpunktes des Kantenpaares.

FuzzyScoreFuzzyScoreFuzzyScoreFuzzyScoreFuzzyScorefuzzyScore (output_control)  real-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Fuzzy-Bewertung des Kantenpaares.

IntraDistanceIntraDistanceIntraDistanceIntraDistanceIntraDistanceintraDistance (output_control)  real-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Abstand zwischen Kanten eines Kantenpaars.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert fuzzy_measure_pairingfuzzy_measure_pairingFuzzyMeasurePairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairing den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

gen_measure_rectangle2gen_measure_rectangle2GenMeasureRectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2, gen_measure_arcgen_measure_arcGenMeasureArcgen_measure_arcGenMeasureArcGenMeasureArc, set_fuzzy_measureset_fuzzy_measureSetFuzzyMeasureset_fuzzy_measureSetFuzzyMeasureSetFuzzyMeasure

Nachfolger

close_measureclose_measureCloseMeasureclose_measureCloseMeasureCloseMeasure

Alternativen

edges_sub_pixedges_sub_pixEdgesSubPixedges_sub_pixEdgesSubPixEdgesSubPix, fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairs, measure_pairsmeasure_pairsMeasurePairsmeasure_pairsMeasurePairsMeasurePairs

Siehe auch

fuzzy_measure_posfuzzy_measure_posFuzzyMeasurePosfuzzy_measure_posFuzzyMeasurePosFuzzyMeasurePos, measure_posmeasure_posMeasurePosmeasure_posMeasurePosMeasurePos

Modul

1D Metrology

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