4.103 sddssplit

• description: sddssplit breaks up an SDDS file into one or more separate files, each containing a single page of data. This is useful when a program only processes the first page of an SDDS file.
• examples:
  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 “%03ld” format.
• 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 used in creating filenames. Leading zeros are included.
  • -rootname=string — Specifies the rootname used in creating filenames.
  • -extension=string — Specifies the extension used in creating filenames.
  • -nameParameter=paramName — Specifies that, instead of composing names for the output files, sddssplit takes 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.