4.67 sddsregroup

• description: sddsregroup swaps the row indexing and page indexing of data in an SDDS file. That is, the ith row of all data pages in the input file are collected and made into the ith data page of the output file.
• examples: The file bpm.sdds contain the beam position monitor (bpm) readback as a function of time for a series of consecutive bpms in a beamline. The defined columns are Time and x. The parameters are bpmIndex. The file bpm.sdds is regrouped to produce data sets of x vs bpmIndex for each time value. The output is suitable to plot as a movie with sddsplot.

  sddsregroup bpm.sdds bpm.movie -newParameters=Time -newColumns=bpmIndex

• synopsis:

  sddsregroup [-pipe=[input][,output]] inputFile outputFile [-newParameters=oldColumnName,...] [-newColumns=oldParameterName,...] [-warning] [-verbose]

• files: The input file contains the data sets to be regrouped. The output file contains the regrouped data. If only one file is specified, then the input file is overwritten by the output.
• switches:
  • -pipe[=input][,output] — The standard SDDS Toolkit pipe option.
  • -newParameters — specifies which columns of the input file will become parameters in the output file. By default no new parameters are created, and all columns of the input file are transfered to the output file.
  • -newColumns — specifies which parameters of the input file will become columns in the output file. The columns will necessarily be duplicated in all pages. By default all parameters values are lost.
• author: L. Emery ANL