HALCON Website / HALCON Operator-Referenz / Tools / Funktion
KlassenKlassenKlassenKlassen | | | | Operatoren

match_funct_1d_transT_match_funct_1d_transMatchFunct1dTransmatch_funct_1d_transMatchFunct1dTransMatchFunct1dTrans (Operator)

Name

match_funct_1d_transT_match_funct_1d_transMatchFunct1dTransmatch_funct_1d_transMatchFunct1dTransMatchFunct1dTrans — Berechnung der Transformationsparameter zwischen zwei Funktionen.

Signatur

match_funct_1d_trans( : : Function1, Function2, Border, ParamsConst, UseParams : Params, ChiSquare, Covar)

Herror T_match_funct_1d_trans(const Htuple Function1, const Htuple Function2, const Htuple Border, const Htuple ParamsConst, const Htuple UseParams, Htuple* Params, Htuple* ChiSquare, Htuple* Covar)

Herror match_funct_1d_trans(const HTuple& Function1, const HTuple& Function2, const HTuple& Border, const HTuple& ParamsConst, const HTuple& UseParams, HTuple* Params, HTuple* ChiSquare, HTuple* Covar)

HTuple HFunction1D::MatchFunct1dTrans(const HTuple& Function2, const HTuple& Border, const HTuple& ParamsConst, const HTuple& UseParams, HTuple* ChiSquare, HTuple* Covar) const

void MatchFunct1dTrans(const HTuple& Function1, const HTuple& Function2, const HTuple& Border, const HTuple& ParamsConst, const HTuple& UseParams, HTuple* Params, HTuple* ChiSquare, HTuple* Covar)

HTuple HFunction1D::MatchFunct1dTrans(const HFunction1D& Function2, const HString& Border, const HTuple& ParamsConst, const HTuple& UseParams, double* ChiSquare, HTuple* Covar) const

HTuple HFunction1D::MatchFunct1dTrans(const HFunction1D& Function2, const char* Border, const HTuple& ParamsConst, const HTuple& UseParams, double* ChiSquare, HTuple* Covar) const

void HOperatorSetX.MatchFunct1dTrans(
[in] VARIANT Function1, [in] VARIANT Function2, [in] VARIANT Border, [in] VARIANT ParamsConst, [in] VARIANT UseParams, [out] VARIANT* Params, [out] VARIANT* ChiSquare, [out] VARIANT* Covar)

VARIANT HFunction1DX.MatchFunct1dTrans(
[in] IHFunction1DX* Function2, [in] BSTR Border, [in] VARIANT ParamsConst, [in] VARIANT UseParams, [out] double* ChiSquare, [out] VARIANT* Covar)

static void HOperatorSet.MatchFunct1dTrans(HTuple function1, HTuple function2, HTuple border, HTuple paramsConst, HTuple useParams, out HTuple paramsVal, out HTuple chiSquare, out HTuple covar)

HTuple HFunction1D.MatchFunct1dTrans(HFunction1D function2, string border, HTuple paramsConst, HTuple useParams, out double chiSquare, out HTuple covar)

Beschreibung

match_funct_1d_transmatch_funct_1d_transMatchFunct1dTransmatch_funct_1d_transMatchFunct1dTransMatchFunct1dTrans berechnet die Transformationsparameter zwischen zwei Funktionen, die als die Tupel Function1Function1Function1Function1Function1function1 und Function2Function2Function2Function2Function2function2 übergeben werden (siehe create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArray und create_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairs). Es wird folgendes Modell der Transformation zwischen den zwei Funktionen verwendet: 

    y1(x) = a1*y2(a3*x+a4)+a2 .

Die Transformationsparameter werden durch eine Ausgleichsrechnung berechnet, indem die folgende Funktion minimiert wird: 

    n-1
    ----
    \                                  2
    /   (y1(x[i])-a1*y2(a3*x[i]+a4)+a2)  .
    ----
    i=0

Dabei werden die Funktionswerte von y2 linear interpoliert. Der Parameter BorderBorderBorderBorderBorderborder entscheidet, welchen Wert die Funktion Function2Function2Function2Function2Function2function2 außerhalb des gültigen Bereichs hat. Für BorderBorderBorderBorderBorderborder='zero'"zero""zero""zero""zero""zero" wird der Wert auf 0 gesetzt, für BorderBorderBorderBorderBorderborder='constant'"constant""constant""constant""constant""constant" auf den jeweiligen Randwert, für BorderBorderBorderBorderBorderborder='mirror'"mirror""mirror""mirror""mirror""mirror" werden die Funktionswerte am Rand gespiegelt und für BorderBorderBorderBorderBorderborder='cyclic'"cyclic""cyclic""cyclic""cyclic""cyclic" werden sie zyklisch fortgesetzt. Die berechneten Transformationsparameter werden als Tupel [a1, a2, a3, a4] in ParamsParamsParamsParamsParamsparamsVal zurückgeliefert. Falls einige der Parameter bekannte Werte besitzen, so kann der jeweilige Parameter von der Ausgleichsrechnung ausgeschlossen werden, indem an der entsprechenden Stelle im Tupel UseParamsUseParamsUseParamsUseParamsUseParamsuseParams der Wert 'false'"false""false""false""false""false" eingetragen wird. In diesem Fall muss im Tupel ParamsConstParamsConstParamsConstParamsConstParamsConstparamsConst der bekannte Wert des Parameters eingetragen werden. Wenn der Parameter für die Ausgleichung verwendet wird (UseParamsUseParamsUseParamsUseParamsUseParamsuseParams = 'true'"true""true""true""true""true"), wird der entsprechende Parameter in ParamsConstParamsConstParamsConstParamsConstParamsConstparamsConst ignoriert. Als Ausgabe liefert match_funct_1d_transmatch_funct_1d_transMatchFunct1dTransmatch_funct_1d_transMatchFunct1dTransMatchFunct1dTrans weiterhin die Summe der quadratischen Fehler ChiSquareChiSquareChiSquareChiSquareChiSquarechiSquare der Ergebnisfunktion, also der mit den Transformationsparametern transformierten Funktion, sowie die Kovariazmatrix CovarCovarCovarCovarCovarcovar der Transformationsparameter ParamsParamsParamsParamsParamsparamsVal zurück. Diese Werte können verwendet werden, um festzustellen, ob ein erfolgreiches Matching der Funktionen möglich war.

Für den Fall, dass es keine eindeutige Lösung für die Transformationsparameter gibt, liefert match_funct_1d_transmatch_funct_1d_transMatchFunct1dTransmatch_funct_1d_transMatchFunct1dTransMatchFunct1dTrans entweder eine einzelne ausgewählte Lösung oder den Fehler 9205 (Matrix ist singulär) zurück.

Parallelisierung

Parameter

Function1Function1Function1Function1Function1function1 (input_control)  function_1d → HFunction1D, HTupleHTupleHFunction1D, HTupleHFunction1DX, VARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Funktion 1.

Function2Function2Function2Function2Function2function2 (input_control)  function_1d → HFunction1D, HTupleHTupleHFunction1D, HTupleHFunction1DX, VARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Funktion 2.

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

Randbehandlung für Funktion 2.

Defaultwert: 'constant' "constant" "constant" "constant" "constant" "constant"

Werteliste: 'constant'"constant""constant""constant""constant""constant", 'cyclic'"cyclic""cyclic""cyclic""cyclic""cyclic", 'mirror'"mirror""mirror""mirror""mirror""mirror", 'zero'"zero""zero""zero""zero""zero"

ParamsConstParamsConstParamsConstParamsConstParamsConstparamsConst (input_control)  number-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Werte der Parameter, die konstant gehalten werden.

Parameteranzahl: 4

Defaultwert: [1.0,0.0,1.0,0.0]

UseParamsUseParamsUseParamsUseParamsUseParamsuseParams (input_control)  string-array → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Soll ein Parameter angepasst werden?

Parameteranzahl: 4

Defaultwert: ['true','true','true','true'] ["true","true","true","true"] ["true","true","true","true"] ["true","true","true","true"] ["true","true","true","true"] ["true","true","true","true"]

Werteliste: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"

ParamsParamsParamsParamsParamsparamsVal (output_control)  number-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Transformationsparameter zwischen den Funktionen.

Parameteranzahl: 4

ChiSquareChiSquareChiSquareChiSquareChiSquarechiSquare (output_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Quadratischer Fehler der Ausgabefunktion.

CovarCovarCovarCovarCovarcovar (output_control)  number-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Kovarianzmatrix der Transformationsparameter

Parameteranzahl: 16

Vorgänger

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArray, create_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairs

Siehe auch

gray_projectionsgray_projectionsGrayProjectionsgray_projectionsGrayProjectionsGrayProjections

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 11.0.5 Copyright © 1996-2015 MVTec Software GmbH