.TH DBPLOT 1 "15 April 1992" "MIT DB software 8.0" "DB applications"
.SH NAME
dbplot \- plot DB signals and annotations
.SH SYNOPSIS
\fBdbplot -t\fIrecord\fR [\fIoptions\fR] ...
.SH DESCRIPTION
This program draws DB signals and annotations.
The device-independent output of
\fIdbplot\fR may be piped through \fIplot\fR(1) to
any of a variety of output devices.
Alternatively, if the source is available, \fIdbplot\fR may be compiled
with any available device-specific \fIplot\fR(3) library.
.PP
A record name must be
supplied in the first argument on the command line.
Any legal command may be given on the command line, in a command file,
or interactively.  Multiple commands may be given on a single line,
separated by spaces.  The display is redrawn after each command line is
processed.  Legal commands are:
.PP
\fBSearch commands:\fR
.TP
\fBs\fIx\fR
The next frame begins with sample \fIx\fR (backward searches are
allowed unless the signals come from a pipe).
.TP
\fIn\fR
The next frame begins \fIn\fR seconds from the start of the record ...
.TP
\fIm:n\fR
or \fIm\fR minutes and \fIn\fR seconds from the start ...
.TP
\fIh:m:n\fR
or \fIh\fR hours, \fIm\fR minutes, and \fIn\fR seconds from the start.
.TP
[\fB+-\fR]\fIn\fR
Any of the commands above may include an optional '+' or '-'
to indicate a search relative to the beginning of the
current frame.
.TP
\fBN\fR (or \fBV, F, S, ...\fR)
Annotation mnemonics may be used as search commands.  The
next frame is centered on the next occurrence of the
specified annotation that is not visible in the current
frame.  Mnemonics are the same as the displayed labels.
(See the \fIECG Database Programmer's Guide\fR for a complete list.)
.TP
\fI<backspace>\fR
Go backward one frame.
.TP
\fI<return>\fR
Go forward one frame (or, if the last search command was
an annotation mnemonic, find the next occurrence of the
specified annotation)
.PP
\fBZoom commands\fR (VT-52/VT-100 arrow keys):
.TP
\fI<up>\fR
Zoom into the center of the current frame (\fI<esc>\fRA).
.TP
\fI<left>\fR
Zoom into the left half of the current frame (\fI<esc>\fRD).
.TP
\fI<right>\fR
Zoom into the right half of the current frame (\fI<esc>\fRC).
.TP
\fI<down>\fR
Zoom out, redrawing the current frame in the center of the
new frame (\fI<esc>\fRB).
.PP
\fBOptions\fR (defaults apply if no qualifier is used):
.TP
\fB-a\fIann\fR
Display annotations from annotator \fIann\fR.  Default:
display no annotations.
.TP
\fB-c\fIn\fR
Set compression ratio to \fIn\fR (or, if \fIn\fR is preceded by
an optional \fBh\fR, set it so that the output sampling rate
is approximately \fIn\fR Hz per channel).  Default: \fBh60\fR.
.TP
\fB-d\fR
Draw annotation alignment marks as dotted lines. (Invoke
again for no marks, and again to restore solid lines.)
.TP
\fB-f\fIfile\fR
Redirect the command input to the specified \fIfile\fR.  This
command is necessary when displaying a piped record (for
which the standard input is used as the sample data file);
in this case, \fB-f/dev/tty\fR allows normal interactive use.
Default: standard input.
.TP
\fB-l\fIn\fR
Draw \fIn\fR sets of traces in each frame.  Default: 1.
.TP
\fB-m\fIxxx\fR
Specify that the \fBaux\fR field of a searched-for annotation
must match \fIxxx\fR.  Default: no match needed.
.TP
\fB-p\fIn\fR
If \fIn\fR > 0, pause before erasing (useful if a command
file is specified via \fB-f\fR).  If \fIn\fR < 0, pause after
erasing (needed for Tektronix 4010 terminals).  Default: 0 (no pause).
.TP
\fB-r\fIn\fR
Set plot resolution such that \fIn\fR-bit signals will fill
the plot area.  Default: as given for the current record.
.TP
\fB-t\fItrecord\fR
Display data from the specified record.
.TP
\fB-w\fIn\fR
Set the frame width to \fIn\fR seconds (or, if \fIn\fR is preceded
by an optional \fBs\fR, \fIn\fR samples).  Default: 5 seconds.
.TP
\fB-S\fR
Display the \fBsubtyp\fR field of each annotation.
.TP
\fB-C\fR
Display the \fBchan\fR field of each annotation.
.TP
\fB-N\fR
Display the \fBnum\fR field of each annotation.
.TP
\fB-A\fR
Display the \fBaux\fR field of each annotation.
.IP
Annotation fields are shown in the order given above.
Invoke the \fB-S, -C, -N,\fR and \fB-A\fR options a second time to cancel.
.TP
\fB-F\fIn\fR
Redefine sampling frequency as \fIn\fR Hz.  Default: as given
for the current record.
.TP
\fB-R\fIh:m:s\fR
Set the reference time (the clock time in hours, minutes,
and seconds corresponding to the beginning of the record).
.TP
\fB-T\fIxxx\fR
Change the title drawn above each frame to \fIxxx\fR.
Default: restore the standard title.
.PP
The shell variable \fBDB\fR should be set and exported (see \fIsetdb\fR(1)).
.SH SEE ALSO
dbtool(1), pschart(1), rdann(1), rdsamp(1), setdb(1), view(1), wave(1)
.br
bin/plot (a shell script; examine it to see which devices are supported)