4.64 sddslorentzianfit

• description: Performs a Lorentzian fit to data in an SDDS file, using the model y = baseline + heightγ²∕(γ² + (x -center)²).
• examples:
  sddslorentzianfit beam.sdds fit.sdds -columns=Frequency,Signal,ySigma=Error -fitRange=1e3,2e3 -guesses=baseline=0,center=1.5e3,height=10,gamma=50  
  sddslorentzianfit -pipe=both -columns=x,y -fixValue=gamma=0.05 -verbosity=2 -fullOutput  
      

• synopsis:
  sddslorentzianfit [inputfile] [outputfile] [-pipe=[input][,output]]  
  -columns=<x-name>,<y-name>[,ySigma=<sy-name>]  
  [-fitRange=<lower>|@<parameter-name>,<upper>|@<parameter-name>]  
  [-fullOutput] [-verbosity=<integer>] [-stepSize=<factor>]  
  [-tolerance=<value>]  
  [-guesses=[baseline=<value>|@<parameter-name>][,center=<value>|@<parameter-name>]  
           [,height=<value>|@<parameter-name>][,gamma=<value>|@<parameter-name>]]  
  [-fixValue=[baseline=<value>|@<parameter-name>][,center=<value>|@<parameter-name>]  
            [,height=<value>|@<parameter-name>][,gamma=<value>|@<parameter-name>]]  
  [-limits=[evaluations=<number>][,passes=<number>]] [-majorOrder=<row|column>]  
      

• switches:
  • -pipe=[input][,output] — Read/write SDDS data using standard streams.
  • -columns=<x-name>,<y-name>[,ySigma=<sy-name>] — Specify data and optional error columns.
  • -fitRange=<lower>|@<parameter-name>,<upper>|@<parameter-name> — Restrict the fit to a data range.
  • -fullOutput — Include fit and residual columns in the output file.
  • -verbosity=<integer> — Set diagnostic output level.
  • -stepSize=<factor> — Specify step-size factor for derivative estimation.
  • -tolerance=<value> — Set convergence tolerance.
  • -guesses=[baseline=<value>|@<parameter-name>][,center=<value>|@<parameter-name>][,height=<value>|@<parameter-name>][,gamma=<value>|@<parameter-name>] — Provide starting parameter values.
  • -fixValue=[baseline=<value>|@<parameter-name>][,center=<value>|@<parameter-name>][,height=<value>|@<parameter-name>][,gamma=<value>|@<parameter-name>] — Fix selected parameters.
  • -limits=[evaluations=<number>][,passes=<number>] — Limit number of evaluations and passes.
  • -majorOrder=<row|column> — Choose output data ordering.
• author: M. Borland, ANL/APS.