description:sddsregroup swaps the row indexing and page indexing of data
in an SDDS file. That is, the row of all data pages in the input file are collected
and made into the data page of the output file.
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.
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.
-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.