4.109 sddsvslopes

• description: sddsvslopes makes straight line fits of vectorized data in the input file with respect to a selected parameter used as independent variable. The simplest example of vectorized data is a data set with one parameter and two columns, one string column of rootnames and one numerical column of data. The fitting is looped over rows across all the data sets in the input file using a selected parameter as the independent variable. The output file contains vectorized slope and intercept data for each column specified in the input file.
• examples:
  sddsvslopes corrector.sdds corrector.vslopes -independentVariable=CorrectorSetpoint -columns=x  
      

• synopsis:
  sddsvslopes [-pipe=[input][,output]] inputFile outputFile  
    -independentVariable=parameterName [-columns=listOfNames]  
    [-excludeColumns=listOfNames] [-sigma[=generate]] [-verbose]  
      

• files: The input file contains the tabular data for fitting. The column Rootname must be present. The output file contains one data set of vectorized slope and intercept data. The Rootname and Index columns from the input file are transferred to the output file. If column Index doesn’t exist in the input file, then it is created in the output file. The column names are nameSlope and nameIntercept where name is the name of the fitted data. If only one file is specified, then the input file is overwritten by the output. A string parameter called IndependentVariable is defined containing the name of the independent variable.
• switches:
  • -pipe[=input][,output] — The standard SDDS Toolkit pipe option.
  • -independentVariable=parametername — Name of independent variable (default is the first valid column).
  • -columns=listOfNames — Columns to be individually paired with independentVariable for straight line fitting.
  • -excludeColumns=listOfNames — Columns to exclude from fitting.
  • -sigma[=generate] — Calculates errors by interpreting column names nameSigma or Sigmaname as sigma of column name. If these columns don’t exist, then the program generates a common sigma from the residual of a first fit and refits with these sigmas. If option -sigma=generate is given, then sigmas are generated from the residual of a first fit for all columns, irrespective of the presence of columns nameSigma or Sigmaname.
  • -ascii — Make output file in ascii mode (binary is the default).
  • -verbose — Prints some output to stderr.
• see also:
  • sddsprocess()
  • sddsrowstats()
• author: L. Emery, ANL/APS.