sddssort

• description:
  sddssort sorts the tabular data section of a data set by the values in named columns. Any number of columns may be involved in the sort, and sorting order may be individually specified.
• examples:
  Sort the APS Twiss file into alphabetical order by element name:
  sddssort APS.twi APS.twi.sorted -column=ElementName
  Same, but keep only one instance of each row with the same element name:
  sddssort APS.twi APS.twi.sorted -column=ElementName -unique
• synopsis:
  
  sddssort [-pipe=[input][,output]] [SDDSinput] [SDDSoutput] -column=name[,{increasing | decreasing}] [-column...] [-unique[=count]] [-noWarnings]
• files:
  SDDSinput is an SDDS file to be sorted. If it contains multiple data pages, they are treated separately. Warning: if SDDSoutput is not given and -pipe=output is not specified, then SDDSinput will be replaced.
• switches:
  • -pipe=[input][,output] -- The standard SDDS pipe option.
  • -column=name[,{increasing | decreasing}] -- Requests that the column name be used to order the rows of each tabular data section. Each subsequent column request specifies a subsort of the ordering produced by the previous requests. The increasing and decreasing keywords may be given to specify the desired ordering of the (sub)sort, with increasing order being the default.
  • -unique[=count] -- Specifies that for any rows that are identical in the sort column values, only the first should be included in the output file. If the count qualifier is given, then a count of the number of identical rows is supplied in a column called IdenticalCount.
  • -noWarnings -- Suppresses warning messages.
• author: M. Borland, ANL/APS.