4.7 plaindata2sdds

• description: Converts plain data files with a simple format to SDDS.
• examples:
  plaindata2sdds data.input data.output -inputMode=ascii "-separator= " -parameter=time,long -column=x,double -column=y,double  
      

• synopsis:
  plaindata2sdds [Inputfile] [Outputfile] [-pipe[=in][,out]]  
  [-inputMode=<ascii|binary>]  
  [-outputMode=<ascii|binary>]  
  [-separator=character]  
  [-commentCharacters=characters]  
  [-noRowCount]  
  [-order=<rowMajor|columnMajor>]  
  [-parameter=name,type[,units=string][,desc=string][,symbol=string] ...]  
  [-column=name,type[,units=string][,desc=string][,symbol=string] ...]  
  [-skipcolumn=type]  
  [-nowarnings]  
  [-majorOrder=<row|column>]  
      

• switches:
  • -pipe[=in][,out] — The standard SDDS Toolkit pipe option.
  • -inputMode=<ascii|binary> — The plain data file can be read in ascii or binary format.
  • -outputMode=<ascii|binary> — The SDDS data file can be written in ascii or binary format.
  • -separator=character — In ascii mode the columns of the plain data file are separated by the given character.
  • -commentCharacters=characters — In ascii mode the rows beginning with any comment characters are ignored.
  • -noRowCount — The row count is not included prior to the beginning of the column data. If the plain data file is a binary file then the row count must be included.
  • -order=<rowMajor|columnMajor> — Row major order is the default. Here each row of the plain data file consists of one element from each column. In column major order each column is located entirely on one row.
  • -parameter=name,type[,units=string][,description=string][,symbol=string] — Add this option for each parameter in the plain data file.
  • -column=name,type[,units=string][,description=string][,symbol=string] — Add this option for each column in the plain data file.
  • -skipcolumn=type — Skip a column in the plain data file. It may be used multiple times.
  • -nowarnings — Do not print warning messages.
  • -majorOrder=<row|column> — Writes output file in row or column major order.
• files: Inputfile is a file that is similar to SDDS files in that it contains parameter and column data. However this file does not contain SDDS header information. The column data does not need to be preceded by a row count but it is recommended. Also the column data can be separated by a user supplied character. White space on either side of the separator is allowed. Binary plaindata files are also allowed.

  Outputfile is the SDDS output that is created.

• see also:
  • sdds2plaindata()
  • csv2sdds()
• author: R. Soliday, ANL/APS.