4.31 sddsenvelope

• description: sddsenvelope analyzes column data across pages to find minima, maxima, averages, standard-deviations, etc., on a row-by-row basis. It produces a single-page output file containing one column for each analysis requested. It will also copy through data from the first page into the output file. It requires that each page of the input file have the same number of rows.
• examples: Find the minimum and maximum beta functions for a set of APS lattices:

  sddsenvelope APS.twi APS.twi.env -copy=s -minimum=beta? -maximum=beta?

• synopsis:

  sddsenvelope [-pipe=[input][,output]] [input] [output] [-copy=columnNames] [-maximum=columnNames] [-minimum=columnNames] [-mean=columnNames] [-sum=power,columnNames] [-standardDeviation=columnNames] [-rms=columnNames] [-slope=independentVariableName,columnNames] [-intercept=independentVariableName,columnNames] [-median=columnNames] [-decileRange=columnNames]

• files: inputFile is a multipage file containing the data for which row-by-row statistics are desired. outputFile is a single-page file containing the statistics. The column names in outputFile are created from those in the input file by appending the appropriate suffix from the following list: Max, Min, Mean, StDev, RMS, Sum, Slope, or Intercept.
• switches:
  • -pipe=[input][,output] — The standard SDDS Toolkit pipe option.
  • -copy=columnNames — Specifies that the named columns should be transferred to the output file without alteration. These data come from the first page of the input file. A comma-separated list of optionally wildcard-containing strings may be given.
  • -maximum=columnNames, -minimum=columnNames, -mean=columnNames, -rms=columnNames, -median=columnNames, -decileRange=columnNames — Specifies that the named columns should be analysed in the indicated fashion. A comma-separated list of optionally wildcard-containing strings may be given. Decile range is the spread between the 90% and 10% points on the distribution.
  • -sum=power,columnNames —Specifies that the named columns should be analysed in the indicated fashion, i.e., that each output row should be the sum of the values to the indicated power. A comma-separated list of optionally wildcard-containing strings may be given.
  • -slope=independentVariableName,columnNames, -intercept=independentVariableName,columnNames— Specifies that the named columns should be analysed to get the slope or intercept with respect to the parameter independentVariableName. A comma-separated list of optionally wildcard-containing strings may be given for the columnNames.
• see also:
  • Data for Examples
  • sddschanges
• author: M. Borland, ANL/APS.