4.54 sddsimageconvert

• description: Converts a single-column SDDS image file into a multi-column SDDS image file and vice versa.
• example:

  sddsimageconvert image.input image.output

• synopsis:

  sddsimageconvert [Inputfile] [Outputfile] [-pipe[=in][,out]] [-ascii] [-binary] [-multicolumn=[indexName=name][,prefix=name]] [-singlecolumn=[imageColumn=name][,xVariableName=name][,yVariableName=name]] [-nowarnings]

• files:

  Inputfile is the SDDS input image file. This file can be either a single-column image file or a multi-column image file.

  Outputfile is a single-column SDDS image file if the Inputfile is a multi-column SDDS image file, or it is a multi-column SDDS image file if the Inputfile is a single-column SDDS image file.

• switches:
  • -pipe[=in][,out] — The standard SDDS Toolkit pipe option.
  • -ascii — The Outputfile is written in ascii format.
  • -binary — The Outputfile is written in binary format.
  • -multicolumn=[indexName=name][,prefix=name] — The multi-column SDDS image file will have or does have an index column with the name given by indexName=name. The default name is Index. It also will have or does have multiple columns with the prefix given by prefix=name. For an input file this defaults to the prefix of the first column found that is not the index column and that ends with a number. For an output file this defaults to the same name as the image column name in the single-column SDDS image file.
  • -singlecolumn=[imageColumn=name][,xVariableName=name][,yVariableName=name] — The single-column SDDS image file will have or does have an image column with the name given by imageColumn=name. The default is the name of only column that exists in the single-column input file or the image prefix in the multi-column input file. If the output file is a single-column image file the xVariableName=name and yVariableName=name options will be used to define the x and y variable names. These default to x and y.
  • -nowarnings — No warnings will be issued when the input file is overwritten.
• see also:
  • sddscongen
  • sddscontour
  • sddsimageprofiles
  • sddsspotanalysis
• author: R. Soliday, ANL/APS.