4.82 sddssplit

• 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:

  sddssplit APS.twi

• synopsis:
  

  sddssplit {-pipe[=input] | inputFile} [{-binary | -ascii}] [-digits=number] [-rootname=string] [-extension=string] [-nameParameter=paramName] [-firstPage=number] [-lastPage=number] [-interval=number]

• 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.
• see also:
  • sddsbreak
  • sddscombine
• author: M. Borland, ANL/APS.