description: sddssplit breaks up an SDDS file into one or more separate files, each containing only a single
page of data. This may be useful in those instances where a tool or program only processes the first
page of a file.
examples:
Split a Twiss parameter file into separate files:
files:inputFile is an SDDS file to be split. By default, the output files are created by appending the page number
to a ``rootname'' and adding an extension. That is, the output files have names
rootnamePage.extension. The default rootname is the name of inputFile, while
the default extension is ``sdds''. By default, Page is printed using ``less the extension.
switches:
-pipe[=input][,output] -- The standard SDDS Toolkit pipe option.
-binary, -ascii -- Specifies binary or ASCII output, with binary being the default.
-digits=number -- Specifies the number of digits to be used in creating filenames.
Leading zeros are included.
-rootname=string -- Specifies the rootname to be used in creating filenames.
-extension=string -- Specifies the extension to be used in creating filenames.
-nameParameter=paramName -- Specifies that instead of composing names for the output
files, sddssplit take the names from the string parameter paramName in the input file.
This provides a limited capability to retrieve the original files from a file made with sddscombine.
Note that if the named parameter takes the same value on two pages, the file created for the first
of the pages will be overwritten.
-firstPage=number -- Specifies the first page of data to use.
-lastPage=number -- Specifies the last page of data to use.
-interval=number -- Specifies the interval between pages that are used.
