4.16 sdds2stream

• description: sdds2stream provides stream output to the standard output of data values from a group of columns or parameters. Each line of the output contains a different row of the tabular data or a different parameter. Values from different columns are separated by the delimiter string. If -page is not employed, all data pages are output sequentially. If multiple filenames are given, the files are processed sequentially in the order given.
• examples:
  sdds2stream APS.twi -parameters=nux,nuy -delimiter=" "  
  sdds2stream APS.twi -column=ElementName,betax -page=1  
      

• synopsis:
  sdds2stream {inputFileList | -pipe[=input]} [-page=pageNumber] [-delimiter=delimitingString]  
              { -columns=columnName[,columnName...] |  
                -parameters=parameterName[,parameterName...] |  
                -arrays=arrayName[,arrayName...] }  
              [-filenames] [-rows[=bare]] [-npages[=bare]] [-noquotes]  
              [-ignoreFormats] [-description]  
      

• files: inputFileList is a space-separated list of SDDS filenames.
• switches:
  • -pipe[=input] — The standard SDDS Toolkit pipe option.
  • -page=pageNumber — Specifies the number of the data page for which output is desired. Recall that pages are numbered sequentially beginning with 1. More complete control of which pages are output may be obtained using sddsconvert or sddsprocess as a filter.
  • -delimiter=delimitingString — Specifies the delimiting string to be printed to separate row entries or parameters. The delimiter is printed with printf, so that any of the usual escape sequences may be employed.
  • -columns=columnName[,columnName...] — Specifies the names of the columns for which output is desired. For each row of each data page, the specified columns are printed on a single line, separated by the delimiting string. The default delimiting string is a single space.
  • -parameters=parameterName[,parameterName...] — Specifies the names of the parameters for which output is desired. For each row of each data page, the specified parameters are printed on a single line, separated by the delimiting string. However, since the default delimiting string is a newline, the parameters end up on separate lines.
  • -arrays=arrayName[,arrayName...] — Specifies the names of the arrays for which output is desired.
  • -filenames — Specifies that the filename will be printed out as each file is processed.
  • -rows[=bare] — Specifies that the number of rows per page for the tabular data section will be printed out. If the bare qualifier is given, only the numerical values are printed, without the word “rows.”
  • -npages[=bare] — Specifies that the number of pages will be printed out. If the bare qualifier is given, only the numerical values are printed, without the word “pages.”
  • -noquotes — Specifies that whitespace-containing string data will be printed without the default double-quotes.
  • -ignoreFormats — Specifies that the format data supplied in the file is to be ignored. Guarantees printing of floating point data to full precision.
  • -description — Specifies printing of the description data for the data set.
• see also:
  • Data for Examples
  • sddsprintout()
  • sddsconvert()
  • sddsprocess()
• author: M. Borland, ANL/APS.