5.3 sdds2mpl

• description: sdds2mpl extracts data columns or parameters from an SDDS data set and creates mpl data files. The program allows creation of mpl labels from SDDS parameters. This tool is primarily of interest to APS users, some of whom still use the older mpl Toolkit. It may be of interest to others who are interested in a simple format for use with programs that don’t need the full power of SDDS protocol. Such applications can use sdds2mpl and mpl2sdds to mediate between themselves and SDDS-compliant programs.
• example:

  sdds2mpl APS.twi -rootname=APS -output=column,z,betax -output=column,z,betay

• synopsis:

  sdds2mpl [SDDSfile] [-pipe[=input]] [-rootName=string] [-separatePages] -output={column | parameter},xName,yName[,{syName | sxName,syName}] [-announceOpenings] [-labelParameters=name[=format]][...]

• files: SDDSfile is the name of an SDDS file from which mpl-format files will be made. Each mpl file contains two to four columns of data.
• switches:
  • -pipe[=input] — The standard SDDS Toolkit pipe option.
  • -announceOpenings — Requests that an informational message be printed whenever a new output file is opened.
  • -rootName=string — Gives the rootname for constructing output filenames.
  • -separatePages — Requests that tabular-data column output from separate pages in the SDDS data set go to separate files.
  • -labelParameters=name[=format]][...] — Gives the names and optional printf format specifications for parameters that will be printed on the title line of the mpl files.
  • -output{column | parameter},xName,yName[,{syName | sxName,syName}] — Requests that the named columns or parameters be put into a mpl file or set of files. If -separate is not given or if the data is for parameters, the name of the file is rootname_xName_yName.out. For column output, if -separate is given, the names of the files are rootname_N_xName_yName.out, where N is the page number. This option may be given any number of times.
• see also:
  • Data for Examples
  • mpl2sdds
• author: M. Borland, ANL/APS.