fit_surface_first_orderfit_surface_first_orderFitSurfaceFirstOrderFitSurfaceFirstOrder (Operator)
Name
fit_surface_first_orderfit_surface_first_orderFitSurfaceFirstOrderFitSurfaceFirstOrder — Berechnung der Grauwertmomente und der Approximation durch eine Fläche
erster Ordnung (Ebene).
Signatur
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)
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
double HImage::FitSurfaceFirstOrder(const HRegion& Regions, const wchar_t* Algorithm, Hlong Iterations, double ClippingFactor, double* Beta, double* Gamma) const
(Nur Windows)
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
double HRegion::FitSurfaceFirstOrder(const HImage& Image, const wchar_t* Algorithm, Hlong Iterations, double ClippingFactor, double* Beta, double* Gamma) const
(Nur Windows)
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_orderFitSurfaceFirstOrderFitSurfaceFirstOrderFitSurfaceFirstOrder 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:
ImageImageImageImageimage(r,c) = AlphaAlphaAlphaAlphaalpha(r - r_center) +
BetaBetaBetaBetabeta(c - c_center) +
GammaGammaGammaGammagamma
r_center und c_center sind die Koordinaten des Schwerpunkts des Schnitts
der Eingaberegion mit dem vollen Definitionsbereich des Bildes.
Bei der Minimierung des Abstands werden die Parameter AlphaAlphaAlphaAlphaalpha bis
GammaGammaGammaGammagamma berechnet.
Das gewünschete Approximationsverfahren wird über den Parameter
AlgorithmAlgorithmAlgorithmAlgorithmalgorithm 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 ClippingFactorClippingFactorClippingFactorClippingFactorclippingFactor (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 IterationsIterationsIterationsIterationsiterations enthält die Anzahl
durchzuführender Iterationen. Er wird im Modus 'regression'
ignoriert.
Achtung
Der Operator fit_surface_first_orderfit_surface_first_orderFitSurfaceFirstOrderFitSurfaceFirstOrderFitSurfaceFirstOrder berücksichtigt nur die mittels
RegionsRegionsRegionsRegionsregions übergebenen Regionen und ignoriert jede Domäne, die zuvor
für das Eingabebild ImageImageImageImageimage festgelegt wurde.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Automatisch parallelisiert auf Tupelebene.
- Automatisch parallelisiert auf interner Datenebene.
Parameter
RegionsRegionsRegionsRegionsregions (input_object) region(-array) → objectHRegionHRegionHobject
Zu untersuchende Regionen.
ImageImageImageImageimage (input_object) singlechannelimage → objectHImageHImageHobject (byte / uint2 / direction / cyclic / real)
Zugehörige Grauwerte.
AlgorithmAlgorithmAlgorithmAlgorithmalgorithm (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Algorithmus Anpassung.
Defaultwert:
'regression'
"regression"
"regression"
"regression"
"regression"
Werteliste: 'huber'"huber""huber""huber""huber", 'regression'"regression""regression""regression""regression", 'tukey'"tukey""tukey""tukey""tukey"
IterationsIterationsIterationsIterationsiterations (input_control) integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Maximale Anzahl von Iterationen (unbenutzt bei
'regression').
Defaultwert: 5
Restriktion: Iterations >= 0
ClippingFactorClippingFactorClippingFactorClippingFactorclippingFactor (input_control) real → HTupleHTupleHtuple (real) (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
AlphaAlphaAlphaAlphaalpha (output_control) real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)
Parameter Alpha der Fläche.
BetaBetaBetaBetabeta (output_control) real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)
Parameter Beta der Fläche.
GammaGammaGammaGammagamma (output_control) real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)
Parameter Gamma der Fläche.
Ergebnis
fit_surface_first_orderfit_surface_first_orderFitSurfaceFirstOrderFitSurfaceFirstOrderFitSurfaceFirstOrder liefert den Wert 2 (H_MSG_TRUE),
falls ein Bild mit
definierten Grauwerten ('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_orderGenImageSurfaceFirstOrderGenImageSurfaceFirstOrderGenImageSurfaceFirstOrder
Siehe auch
moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlaneMomentsGrayPlane,
fit_surface_second_orderfit_surface_second_orderFitSurfaceSecondOrderFitSurfaceSecondOrderFitSurfaceSecondOrder
Modul
Foundation