description: sddsbreak reads pages from an SDDS file and writes a new SDDS file
containing the same data, but with each of the input pages potentially separated into several
output pages. The separation involves breaking each input page at one or more locations as
determined by one of several user-defined criteria.
files: inputFile is an SDDS file containing one or more pages of data to be broken up. outputFile is
an SDDS file in which the result is placed. Each page of outputFile contains the parameter and array
values from the page of inputFile that is its source.
switches:
-pipe=[input][,output] — The standard SDDS Toolkit pipe option.
-gapIn=columnName[,{amount=value | factor=value}] — Breaks the page when
the value in the named column has a gap. If the amount qualifier is given, then a
gap is defined as any occurrence of successive values different by more than value. If
this qualifier is not given, then the value is computed as follows: the mean absolute
difference (MAD) between successive values for the first page which has more than 1 row
is computed; if the factor qualifier is given, then the gap amount is the MAD times the
given value; otherwise, it is the MAD times two.
-increaseOf=columnName , -decreaseOf=columnName — These options cause a page
break whenever the value in the named column increases or decreases, respectively.
-changeOf=columnName[,amount=value[,base=value]] — Breaks the page when the
value in the named column changes. If the amount qualifier is not given, then any change
is sufficient to break the page. Otherwise, the page is broken whenever the quantity
⌊(V - B)∕A⌋ changes, where V is the value in the column, A is the value given for
amount, and B is the value given for base. If base is not given, then the value in first
row for the column is used.
-rowLimit=integer — Breaks the page after the specified number of rows.