4.86 sddstranspose

• description: sddstranspose views the numerical tabular data of the input file as though it formed a matrix, and produces an output file with data corresponding to the transpose of the input file matrix. In other words, the columns of tabular data of the input file become rows in the output file. String column data are not transposed but are stored as string parameters in the output file. Operating on the output file with a second sddstranpose command essentially recovers the original input file.

  The column names for the output file are generated either from the data in a selected string column in the input file, from the value of the command line option -root, or from an internal default.

  The column names of the input file are collected and made into a string column in the output file.

• examples: The data in file LTP.R12 (matrix of R₁₂’s in a beamline called LTP, say) is transposed to give file LTP.R12.trans:

  sddstranspose LTP.R12 LTP.R12.trans

• synopsis:

  sddstranspose [-pipe=[input][,output]] inputFile outputFile [-oldColumnNames=string] [{-root=string [-digits=integer] | -newColumnNames=column}] [-symbol=string] [-ascii] [-verbose]

• files: The input file contains the data for the matrix to be transposed. The output file contains the data for the transposed matrix. If only one file is specified, then the input file is overwritten by the output.
• switches:
  • -pipe[=input][,output] — The standard SDDS Toolkit pipe option.
  • -oldColumnNames=string — A string column of name string is created in the output file, containing the column names of the input files as string data. If this option is not present, then the default name of “OldColumnNames” is used for the string column.
  • -root=string — A string used to generate columns names for the output file data. The first data column is named “string000”, the second, “string001”, etc. If the input file has only one row, the the root name alone (with no digits following) is used for the column name.
  • -digits=integer — minimum number of digits used in the number appended to root of the output file column names. (Default value is 3).
  • -newColumnNames=string — Specifies a string column of the input file which will be used to define column names of the output file.
  • -symbol=string — The string for the symbol field of data column definitions.
  • -ascii — Produces an output in ascii mode. Default is binary.
  • -verbose — Prints out incidental information to stderr.
• author: L. Emery ANL