HALCON Website / HALCON Operator-Referenz / Bild / Merkmale
KlassenKlassenKlassenKlassen | | | | Operatoren

fit_surface_first_orderfit_surface_first_orderFitSurfaceFirstOrderfit_surface_first_orderFitSurfaceFirstOrderFitSurfaceFirstOrder (Operator)

Name

fit_surface_first_orderfit_surface_first_orderFitSurfaceFirstOrderfit_surface_first_orderFitSurfaceFirstOrderFitSurfaceFirstOrder — Berechnung der Grauwertmomente und der Approximation durch eine Fläche erster Ordnung (Ebene).

Signatur

fit_surface_first_order(Regions, Image : : Algorithm, Iterations, ClippingFactor : Alpha, Beta, Gamma)

Herror fit_surface_first_order(const Hobject Regions, const Hobject Image, const char* Algorithm, const Hlong Iterations, double ClippingFactor, double* Alpha, double* Beta, double* Gamma)

Herror T_fit_surface_first_order(const Hobject Regions, const Hobject Image, const Htuple Algorithm, const Htuple Iterations, const Htuple ClippingFactor, Htuple* Alpha, Htuple* Beta, Htuple* Gamma)

Herror fit_surface_first_order(Hobject Regions, Hobject Image, const HTuple& Algorithm, const HTuple& Iterations, const HTuple& ClippingFactor, double* Alpha, double* Beta, double* Gamma)

Herror fit_surface_first_order(Hobject Regions, Hobject Image, const HTuple& Algorithm, const HTuple& Iterations, const HTuple& ClippingFactor, HTuple* Alpha, HTuple* Beta, HTuple* Gamma)

double HRegion::FitSurfaceFirstOrder(const HImage& Image, const HTuple& Algorithm, const HTuple& Iterations, const HTuple& ClippingFactor, double* Beta, double* Gamma) const

HTuple HRegionArray::FitSurfaceFirstOrder(const HImage& Image, const HTuple& Algorithm, const HTuple& Iterations, const HTuple& ClippingFactor, HTuple* Beta, HTuple* Gamma) const

void FitSurfaceFirstOrder(const HObject& Regions, const HObject& Image, const HTuple& Algorithm, const HTuple& Iterations, const HTuple& ClippingFactor, HTuple* Alpha, HTuple* Beta, HTuple* Gamma)

HTuple HImage::FitSurfaceFirstOrder(const HRegion& Regions, const HString& Algorithm, Hlong Iterations, double ClippingFactor, HTuple* Beta, HTuple* Gamma) const

double HImage::FitSurfaceFirstOrder(const HRegion& Regions, const HString& Algorithm, Hlong Iterations, double ClippingFactor, double* Beta, double* Gamma) const

double HImage::FitSurfaceFirstOrder(const HRegion& Regions, const char* Algorithm, Hlong Iterations, double ClippingFactor, double* Beta, double* Gamma) const

HTuple HRegion::FitSurfaceFirstOrder(const HImage& Image, const HString& Algorithm, Hlong Iterations, double ClippingFactor, HTuple* Beta, HTuple* Gamma) const

double HRegion::FitSurfaceFirstOrder(const HImage& Image, const HString& Algorithm, Hlong Iterations, double ClippingFactor, double* Beta, double* Gamma) const

double HRegion::FitSurfaceFirstOrder(const HImage& Image, const char* Algorithm, Hlong Iterations, double ClippingFactor, double* Beta, double* Gamma) const

void HOperatorSetX.FitSurfaceFirstOrder(
[in] IHUntypedObjectX* Regions, [in] IHUntypedObjectX* Image, [in] VARIANT Algorithm, [in] VARIANT Iterations, [in] VARIANT ClippingFactor, [out] VARIANT* Alpha, [out] VARIANT* Beta, [out] VARIANT* Gamma)

VARIANT HImageX.FitSurfaceFirstOrder(
[in] IHRegionX* Regions, [in] BSTR Algorithm, [in] Hlong Iterations, [in] double ClippingFactor, [out] VARIANT* Beta, [out] VARIANT* Gamma)

VARIANT HRegionX.FitSurfaceFirstOrder(
[in] IHImageX* Image, [in] BSTR Algorithm, [in] Hlong Iterations, [in] double ClippingFactor, [out] VARIANT* Beta, [out] VARIANT* Gamma)

static void HOperatorSet.FitSurfaceFirstOrder(HObject regions, HObject image, HTuple algorithm, HTuple iterations, HTuple clippingFactor, out HTuple alpha, out HTuple beta, out HTuple gamma)

HTuple HImage.FitSurfaceFirstOrder(HRegion regions, string algorithm, int iterations, double clippingFactor, out HTuple beta, out HTuple gamma)

double HImage.FitSurfaceFirstOrder(HRegion regions, string algorithm, int iterations, double clippingFactor, out double beta, out double gamma)

HTuple HRegion.FitSurfaceFirstOrder(HImage image, string algorithm, int iterations, double clippingFactor, out HTuple beta, out HTuple gamma)

double HRegion.FitSurfaceFirstOrder(HImage image, string algorithm, int iterations, double clippingFactor, out double beta, out double gamma)

Beschreibung

fit_surface_first_orderfit_surface_first_orderFitSurfaceFirstOrderfit_surface_first_orderFitSurfaceFirstOrderFitSurfaceFirstOrder berechnet die Grauwertmomente und die Approximation der Grauwerte durch eine Fläche erster Ordnung. Dazu wird der Abstand zwischen der Fläche und den Grauwerten minimiert. Eine Fläche erster Ordnung wird durch folgende Gleichung beschrieben: 

ImageImageImageImageImageimage(r,c) =  AlphaAlphaAlphaAlphaAlphaalpha(r - r_center) +
                        BetaBetaBetaBetaBetabeta(c - c_center) +
                        GammaGammaGammaGammaGammagamma
r_center und c_center sind die Koordinaten des Schwerpunkts des Schnitts der Eingaberegion mit dem vollen Definitionsberaich des Bildes. Bei der Minimierung des Abstands werden die Parameter AlphaAlphaAlphaAlphaAlphaalpha bis GammaGammaGammaGammaGammagamma berechnet.

Das gewünschete Approximationsverfahren wird über den Parameter AlgorithmAlgorithmAlgorithmAlgorithmAlgorithmalgorithm ausgewählt:

'regression'

Standard 'least squares' Anpassung.

'huber'

Gewichtete least squares Anpassung, bei der Ausreißer nach dem Ansatz von Huber gedämpft werden.

'tukey'

Gewichtete least squares Anpassung, bei der Ausreißer nach dem Ansatz von Tukey ignoriert werden.

Der Parameter ClippingFactorClippingFactorClippingFactorClippingFactorClippingFactorclippingFactor (ein Skalierungsfaktor für diese Standardabweichung) steuert in diesen Modi den Grad der Ausreißerdämpfung: Je kleiner der Wert gewählt wird, desto stärker ist die Dämpfung. Die Ausreißerdetektion wird iteriert. Der Parameter IterationsIterationsIterationsIterationsIterationsiterations enthält die Anzahl durchzuführender Iterationen. Er wird im Modus 'regression' ignoriert.

Achtung

Der Operator fit_surface_first_orderfit_surface_first_orderFitSurfaceFirstOrderfit_surface_first_orderFitSurfaceFirstOrderFitSurfaceFirstOrder berücksichtigt nur die mittels RegionsRegionsRegionsRegionsRegionsregions übergebenen Regionen und ignoriert jede Domäne, die zuvor für das Eingabebild ImageImageImageImageImageimage festgelegt wurde.

Parallelisierung

Parameter

RegionsRegionsRegionsRegionsRegionsregions (input_object)  region(-array) → objectHRegionHRegionHRegionHRegionXHobject

Zu untersuchende Regionen.

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

Zugehörige Grauwerte.

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

Algorithmus Anpassung.

Defaultwert: 'regression' "regression" "regression" "regression" "regression" "regression"

Werteliste: 'huber'"huber""huber""huber""huber""huber", 'regression'"regression""regression""regression""regression""regression", 'tukey'"tukey""tukey""tukey""tukey""tukey"

IterationsIterationsIterationsIterationsIterationsiterations (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Maximale Anzahl von Iterationen (unbenutzt bei 'regression').

Defaultwert: 5

Restriktion: Iterations >= 0

ClippingFactorClippingFactorClippingFactorClippingFactorClippingFactorclippingFactor (input_control)  real → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Clipping Faktor für die Ausreißerdämpfung.

Defaultwert: 2.0

Werteliste: 1.0, 1.5, 2.0, 2.5, 3.0

Restriktion: ClippingFactor > 0

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

Parameter Alpha der Fläche.

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

Parameter Beta der Fläche.

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

Parameter Gamma der Fläche.

Ergebnis

fit_surface_first_orderfit_surface_first_orderFitSurfaceFirstOrderfit_surface_first_orderFitSurfaceFirstOrderFitSurfaceFirstOrder liefert den Wert 2 (H_MSG_TRUE), falls ein Bild mit definierten Grauwerten ('byte'"byte""byte""byte""byte""byte") eingegeben wird und die Parameter korrekt sind. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

gen_image_surface_first_ordergen_image_surface_first_orderGenImageSurfaceFirstOrdergen_image_surface_first_orderGenImageSurfaceFirstOrderGenImageSurfaceFirstOrder

Siehe auch

moments_gray_planemoments_gray_planeMomentsGrayPlanemoments_gray_planeMomentsGrayPlaneMomentsGrayPlane, fit_surface_second_orderfit_surface_second_orderFitSurfaceSecondOrderfit_surface_second_orderFitSurfaceSecondOrderFitSurfaceSecondOrder

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH