4.87 sddsregroup

• description: sddsregroup swaps the row indexing and page indexing of data in an SDDS file. That is, the i^th row of all data pages in the input file are collected and made into the i^th data page of the output file.
• examples: The file bpm.sdds contains 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 parameter is bpmIndex. The file 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]  
    

• switches:
  • -pipe[=input][,output] — The standard SDDS Toolkit pipe option.
  • -newParameters=oldColumnName,... — Specifies columns of the input file that become parameters in the output file. By default no new parameters are created.
  • -newColumns=oldParameterName,... — Specifies parameters of the input file that become columns in the output file. These columns are duplicated in all pages. By default parameter values are discarded.
  • -warning — Report non-fatal warnings.
  • -verbose — Print processing information.
• files:
  • inputFile — SDDS file containing the data sets to be regrouped.
  • outputFile — SDDS file containing the regrouped data. If only one file is specified, the input file is overwritten.
• see also: sddsplot()
• author: L. Emery, ANL/APS.