LPSIG(1ICD)

NAME
lpsig - post processor for plotting signals

SYNOPSIS
lpsig [-Abhpxrn] [-l length] [-s scale]
      [-tb t_begin] [-te t_end] [-w s_width] signals

OPTIONS
The following options can be specified:

-A  When this option is specified the width of the output will always be small enough to fit on an A4 page.

-b  Default the logical signals from a ".res" file will plotted. When the option -b is given, bounding waveforms from a ".plt" will plotted.

-h  When this option is specified the time axis will be in a horizontal direction (not available when making a plot file for an hp2934 printer).

-p  When this option is specified the plot file generated will be according to the PIC language, so that it can be included in an PIC/TROFF source text. Default, a plot file for an hp2934 printer will be generated.

-x  When this option is specified the plot file be according the format as described by plotfile(3ICD).

-r  A right time axis is printed.

-n  The left time axis is not printed.

-l length
    Specifies the length of the time axis in cm.

-s scale
    Specifies how much time is represented by 1 cm on the time axis.

-tb t_begin
    Specifies the begin time of the plot (default: 0).

-te t_end
    Specifies the end time of the plot (default: the time of the last signal change).

-w s_width
    Specifies the width of the signals in cm. (default: 0.4 cm for logical signals and 2.0 cm for bounding waveforms).

The time values (scale, t_begin, t_end) are in seconds, and may be specified as floating point or integer. The following trailing time units may be added to this values: 'm' (1e-3), 'u' (1e-6), 'n' (1e-9), or 'p' (1e-12).

DESCRIPTION
Lpsig is a program which can be used to plot signals as a function of time. The signals for example are the simulation results of the switch-level simulator sls. The output file generated by lpsig must be send to an hp2934 line printer (file "signals.lp"), can be included in a PIC/TROFF source text (file "signals.pic"), or can be used with hpnew or qplot (file "plotfile"). The scaling of the plot can be controlled by either the scale option or the length option. When none of these options is specified the plot will be scaled in such a way that it fits on one page.

The following program argument is required:

- signals.
    This name must be the basename of a file with the extension ".res" or the basename of a file with the extension ".plt". The file respectively contains descriptions of logical signals or waveform signals, and is for example generated by sls.

EXAMPLES
$ lpsig -s 1e-10 rand_cnt

$ lpsig -bph -te 50n rand_cnt

AUTHOR
A.J. van Genderen et al.

FILES
signals.res    (default) inputfile
signals.plt    (opt.) inputfile
signals.lp    (default) outputfile
signals.pic    (opt.) outputfile
plotfile    (opt.) outputfile

SEE ALSO
sls(1ICD).
B.W. Kernighan, "PIC - A Graphics Language for Typesetting: User Manual".