sus2sus

Purpose:

Part of the Sus Filter Tools: Reformats a sus file.

Usage:

sus2sus [<option> ... ] [<label> | <label>=<expression> ...]

If <label>s are given, only those <label>s will be processed. Otherwise all labels will be taken. By default, the command acts as a filter (reads from stdin and writes to stdout).

Options:

-f, --filter=<EXPRESSION>

just output records where EXPRESSION is nonzero

-s, --sort=<EXPRESSION>

sort records according to <EXPRESSION> (by default, take the average of numeric values if there are records with the same value for <EXPRESSION>; string values are always concatenated). Use float(<EXPRESSION>) to sort according to a numeric expression. Multiple --sort switches are possible.

-a, --add=<LABEL=EXPRESSION>

add a new field in each record with label <LABEL>

-c, --combine=[min|max|average|mean|sum|prod|no]

how to merge multiple entries of the same label from different records with the same --sort <EXPRESSION>

-e, --eval=<[strict,warn,debug,invalid]>

see section for details

-i, --input=<SUSFILENAME>

read <SUSFILENAME> (default: '-' for stdin) Multiple input files are possible. The files are merged by effectively catenating them one after another. See Section )

-o, --output=<FILENAME>

write to <FILENAME> (default: '-' for stdout)

-b, --binary

store sus file in binary format (default: plain ascii format)

--nolabrc

do not read ~/.labrc and ./labrc

--help-expression

prints help for expressions (see section )

The switches --add, --sort, and --filter are processed in the same order as in the command line.

With @FILE or @ FILE (some) command-line options are read from FILE (see section ).

Result:

A sus file.

Examples:

See Section .