- 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:
- author: R. Soliday, ANL/APS.
