4.102 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:
      sddssort APS.twi APS.twi.sorted -column=ElementName  
      sddssort APS.twi APS.twi.sorted -column=ElementName -unique  
      

• synopsis:
      sddssort [-pipe=[input][,output]] [SDDSinput] [SDDSoutput]  
        -column=name[, {increasing | decreasing}] [-column...]  
        [-parameter=name[, {increasing | decreasing}] ...]  
        [-numericHigh] [-nonDominateSort]  
        [-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.
  • -parameter=name[, {increasing | decreasing}] — Similar to column requests, but sort the data pages by parameters.
  • -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.
  • -nonDominateSort — Perform non-dominated-sort when multiply sorting columns supplied. Non-dominated-sort only works for numeric columns.
  • -numericHigh — Works for string sorting which rank the numeric characters higher than other characters in a string comparison. It also ranks numeric character sets with fewer characters below numeric character sets with more characters.
  • -noWarnings — Suppresses warning messages.
• see also: sddssortcolumn()
• author: M. Borland, ANL/APS.