Home > Applications > Horace > @d4d > fit_sqw.m

iFit/fit_sqw

PURPOSE ^

Fit a model for S(Q,w) to an object, with an optional background function.

SYNOPSIS ^

function [wout, fitdata, ok, mess] = fit_sqw(win, varargin)

DESCRIPTION ^

 Fit a model for S(Q,w) to an object, with an optional background function.
 If passed an array of objects, then each object is fitted independently.

 For full help, read documentation for sqw object fit_sqw:
   >> help sqw/fit_sqw

 Differs from multifit_sqw, which fits all objects in the array simultaneously
 but with independent backgrounds.

 Fit several objects in succession to a given function:
   >> [wout, fitdata] = fit_sqw (w, func, pin)                 % all parameters free
   >> [wout, fitdata] = fit_sqw (w, func, pin, pfree)          % selected parameters free to fit
   >> [wout, fitdata] = fit_sqw (w, func, pin, pfree, pbind)   % binding of various parameters in fixed ratios

 With optional 'background' function added to the function
   >> [wout, fitdata] = fit_sqw (..., bkdfunc, bpin)
   >> [wout, fitdata] = fit_sqw (..., bkdfunc, bpin, bpfree)
   >> [wout, fitdata] = fit_sqw (..., bkdfunc, bpin, bpfree, bpbind)

 If unable to fit, then the program will halt and display an error message. 
 To return if unable to fit, call with additional arguments that return status and error message:

   >> [wout, fitdata, ok, mess] = fit_sqw (...)

 Additional keywords controlling which ranges to keep, remove from objects, control fitting algorithm etc.
   >> [wout, fitdata] = fit_sqw (..., keyword, value, ...)
   Keywords are:
       'keep'      range of x values to keep
       'remove'    range of x values to remove
       'mask'      logical mask array (true for those points to keep)
       'select'    if present, calculate output function only at the points retained for fitting
       'list'      indicates verbosity of output during fitting
       'fit'       alter convergence critera for the fit etc.
       'evaluate'  evaluate function at initial parameter values only, with argument check as well
       'chisqr'    evaluate chi-squared at the initial parameter values (ignored if 'evaluate' not set)

   Example:
   >> [wout, fitdata] = fit_sqw (..., 'keep', xkeep, 'list', 0)

CROSS-REFERENCE INFORMATION ^

This function calls: This function is called by:
Generated on Mon 26-Nov-2018 15:08:42 by m2html © 2005. iFit (c) E.Farhi/ILL EUPL 1.1