VF_nonlinfit und VF_nonlinfitwW (OptiVec Matrix-Funktion)">VF_nonlinfit, VF_nonlinfitwW">
VF_nonlinfit_... VD_nonlinfit_... VE_nonlinfit_...
VF_nonlinfitwW_... VD_nonlinfitwW_... VE_nonlinfitwW_...
..._autoDeriv
..._getChi2
..._getBestValues
..._getTestRun
..._getTestPar
..._getTestDir
..._stop
FunktionHilfsfunktionen für VF_nonlinfit und VF_nonlinfitwW
Syntax C/C++#include <MFstd.h>
void VF_nonlinfit_autoDeriv( fVector dYdAi, fVector X, ui size, unsigned ipar, VF_NONLINFITWORKSPACE *ws );
float VF_nonlinfit_getChi2( VF_NONLINFITWORKSPACE *ws );
void VF_nonlinfit_getBestValues( fVector ABest, VF_NONLINFITWORKSPACE *ws );
int VF_nonlinfit_getTestDir( VF_NONLINFITWORKSPACE *ws );
unsigned VF_nonlinfit_getTestPar( VF_NONLINFITWORKSPACE *ws );
unsigned VF_nonlinfit_getTestRun( VF_NONLINFITWORKSPACE *ws );
void VF_nonlinfit_stop( VF_NONLINFITWORKSPACE *ws );

  (identische Syntax für die VF_nonlinfitwW_...-Funktionen)
C++ MatObj#include <OptiVec.h>
void vector<T>::nonlinfit_getChi2( VF_NONLINFITWORKSPACE *ws );
void vector<T>::nonlinfit_getBestValues( VF_NONLINFITWORKSPACE *ws );
unsigned vector<T>::nonlinfit_getTestPar( VF_NONLINFITWORKSPACE *ws );
unsigned vector<T>::nonlinfit_getTestRun( VF_NONLINFITWORKSPACE *ws );
void vector<T>::nonlinfit_stop( VF_NONLINFITWORKSPACE *ws );

  (identische Syntax für die nonlinfitwW_...-Funktionen)
Pascal/Delphiuses VFnlfit;
procedure VF_nonlinfit_autoDeriv( dYdAi, X: fVector; size:UIntSize; ipar:UInt; PVF_NONLINFITWORKSPACE ws );
function VF_nonlinfit_getChi2( PVF_NONLINFITWORKSPACE ws ): Single;
procedure VF_nonlinfit_getBestValues( BestValues: fVector; PVF_NONLINFITWORKSPACE ws );
function VF_nonlinfit_getTestDir( PVF_NONLINFITWORKSPACE ws ): Integer;
function VF_nonlinfit_getTestPar( PVF_NONLINFITWORKSPACE ws ): UInt;
function VF_nonlinfit_getTestRun( PVF_NONLINFITWORKSPACE ws ): UInt;
procedure VF_nonlinfit_stop( PVF_NONLINFITWORKSPACE ws );

  (identische Syntax für die VF_nonlinfitwW_...-Funktionen)
BeschreibungVF_nonlinfit_autoDeriv differenziert eine benutzerdefinierte Modell-Funktion y=f(x) nach deren Parametern aipar. Sämtliche von VF_nonlinfit_autoDeriv benötigten Informationen (Modell-Funktion, aktueller Parameter-Satz usw.) werden über den Zeiger auf den in der aktuellen VF_nonlinfit-Operation verwendeten VF_NONLINFITWORKSPACE mitgeteilt.

Die folgenden Funktionen gestatten es, den Fortgang nicht-linearer Anpassungs-Operationen zu verfolgen. Sie können entweder aus der benutzerdefinierten Modell-Funktion heraus oder - bei Multithread-Anwendungen - auch aus einem zweiten Thread heraus aufgerufen werden.
VF_nonlinfit_getChi2 gibt den besten bislang erzielten Anpassungstest-Wert (c2 oder, für robuste Fits, |c|) zurück. Ruft man diese Funktion auf, bevor VF_nonlinfit die Chance hatte, c2 erstmalig zu berechnen, so wird -1.0 zurückgegeben.

VF_nonlinfit_getBestValues speichert den besten bislang gefundenen Parametersatz A in dem als Argument angeforderten Vektor ABest.

VF_nonlinfit_getTestDir liefert die Test-Richtung (+1 für aufwärts, -1 für abwärts) während "Ausbruchsversuchen" aus eventuellen lokalen Optima, die andernfalls das Erreichen des globalen Optimums verhindern würden (LevelOfMethod > 3 in VF_setNonlinfitOptions spezifiziert).

VF_nonlinfit_getTestPar gibt den Index des gerade bezüglich "Ausbruchs" getesteten Parameters zurück.

VF_nonlinfit_getTestRun liefert den Index des aktuellen "Ausbruchstest"-Durchlaufes. Für jeden angepaßten Parameter wird ein Testdurchlauf durchgeführt. Die Reihenfolge, in der die Parameter geprüft werden, wird intern so festgelegt, daß die sensitivsten Parameter zuerst an die Reihe kommen.

VF_nonlinfit_stop sorgt dafür, daß VF_nonlinfit seinen aktuellen Levenberg-Marquardt- oder Downhill-Simplex-Zyklus beendet, die Ausgabe-Parameter auf den besten Stand bringt und zur aufrufenden Funktion zurückkehrt. Auf diese Weise können überlange Anpassungs-Sitzungen (insbesondere solche mit "Ausbruchs"-Versuchen) ohne Datenverluste abgebrochen werden.

QuerverweisKap. 13

MatrixLib Inhaltsverzeichnis  OptiVec Home