sus2text

Purpose:

Part of the Sus Filter Tools: Converts sus file to a space delimited ASCII table.

Usage:

sus2text [<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 if there are records with the same numeric 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)

--nolabrc

do not read ~/.labrc and ./labrc

--help-expression

print 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 space-separated ASCII table.

Examples:

See Section .