Next: , Previous: , Up: Nonlinear Least-Squares Fitting   [Index]


39.9 High Level Driver

These routines provide a high level wrapper that combine the iteration and convergence testing for easy use.

Function: int gsl_multifit_fsolver_driver (gsl_multifit_fsolver * s, const size_t maxiter, const double epsabs, const double epsrel)

This function iterates the solver s for a maximum of maxiter iterations. After each iteration, the system is tested for convergence using gsl_multifit_test_delta with the error tolerances epsabs and epsrel.

Function: int gsl_multifit_fdfsolver_driver (gsl_multifit_fdfsolver * s, const size_t maxiter, const double xtol, const double gtol, const double ftol, int * info)
Function: int gsl_multifit_fdfridge_driver (gsl_multifit_fdfridge * s, const size_t maxiter, const double xtol, const double gtol, const double ftol, int * info)

These functions iterate the solver s for a maximum of maxiter iterations. After each iteration, the system is tested for convergence with the error tolerances xtol, gtol and ftol. Upon successful convergence, the function returns GSL_SUCCESS and sets info to the reason for convergence (see gsl_multifit_fdfsolver_test). Otherwise, the function returns GSL_EMAXITER indicating the system did not converge after maxiter iterations.