sddsbreak

**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.**examples:**Limit the length of pages to 500 rows so that data may be viewed more easily:`sddsbreak par.bpm par.bpm1 -rowlimit=500``sddsbreak par.bpm par.bpm1 -gapin=Time,amount=15`**synopsis:**`sddsbreak [-pipe=[input][,output]] [`*inputFile*] [*outputFile*]

{ -gapIn=*columnName*[,{amount=*value*| factor=*value*}] |

-increaseOf=*columnName*| -decreaseOf=*columnName*

-changeOf=*columnName*[,amount=*value*[,base=*value*]]

-rowLimit=*integer*}**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=`-- Breaks the page when the value in the named column has a gap. If the*columnName*[,{amount=*value*| factor=*value*}]`amount`

qualifier is given, then a gap is defined as any occurence 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=`-- These options cause a page break whenever the value in the named column increases or decreases, respectively.*columnName*`-changeOf=`-- Breaks the page when the value in the named column changes. If the*columnName*[,amount=*value*[,base=*value*]]`amount`qualifier is not given, then any change is sufficient to break the page. Otherwise, the page is broken whenever the quantity 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=`-- Breaks the page after the specified number of rows.*integer*

**see also:**- Data for ExamplesData for Examples (see )exampleData
- sddscombine
`sddscombine`()sddscombine

**author:**M. Borland, ANL/APS.