sus2plot

Purpose:

Part of the Sus Filter Tools: Passes a sus file to Gnuplot.

Usage:

sus2plot [<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 stdin and prints stdout).

Options:

-f, --filter=<EXPRESSION>

just output records that match the filter

-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). In the plot, this also defines the $x$ axis. Use float(<EXPRESSION>) to sort acording 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 --help-expression for details

-p, --plotcommand=<COMMAND>

insert some gnuplot commands before plotting

-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>

instead of displaying the plot, store it as <FILENAME> in one of the following formats: postscipt, eps, png or pbm (depending on the suffix of <FILENAME>).

--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:

Either a plot (in which you can navigate and zoom), or file with the plot.

Figure: sus2plot Navigation Buttons

Examples:

See Section .