ECG Database Applications Guide
Table of Contents
dbplot - plot DB signals and annotations
dbplot -trecord [options]
...
This program draws DB signals and annotations. The device-independent
output of dbplot may be piped through plot(1)
to any of a variety of output
devices. Alternatively, if the source is available, dbplot may be compiled
with any available device-specific plot(3)
library.
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:
Search
commands:
- sx
- The next frame begins with sample x (backward searches are
allowed unless the signals come from a pipe).
- n
- The next frame begins n
seconds from the start of the record ...
- m:n
- or m minutes and n seconds from
the start ...
- h:m:n
- or h hours, m minutes, and n seconds from the start.
- [+-]n
- Any of the commands above may include an optional '+' or '-' to indicate a
search relative to the beginning of the current frame.
- N (or V, F, S, ...)
- 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 ECG Database Programmer's Guide for a complete list.)
- <backspace>
- Go backward one frame.
- <return>
- Go forward one frame (or, if the last search
command was an annotation mnemonic, find the next occurrence of the specified
annotation)
Zoom commands (VT-52/VT-100 arrow keys):
- <up>
- Zoom into the center
of the current frame (<esc>A).
- <left>
- Zoom into the left half of the current
frame (<esc>D).
- <right>
- Zoom into the right half of the current frame (<esc>C).
- <down>
- Zoom out, redrawing the current frame in the center of the new frame
(<esc>B).
Options (defaults apply if no qualifier is used):
- -aann
- Display
annotations from annotator ann. Default: display no annotations.
- -cn
- Set
compression ratio to n (or, if n is preceded by an optional h, set it
so that the output sampling rate is approximately n Hz per channel). Default:
h60.
- -d
- Draw annotation alignment marks as dotted lines. (Invoke again for
no marks, and again to restore solid lines.)
- -ffile
- Redirect the command
input to the specified file. This command is necessary when displaying
a piped record (for which the standard input is used as the sample data
file); in this case, -f/dev/tty allows normal interactive use. Default:
standard input.
- -ln
- Draw n sets of traces in each frame. Default: 1.
- -mxxx
- Specify that the aux field of a searched-for annotation must match xxx.
Default: no match needed.
- -pn
- If n > 0, pause before erasing (useful if
a command file is specified via -f). If n < 0, pause after erasing (needed
for Tektronix 4010 terminals). Default: 0 (no pause).
- -rn
- Set plot resolution
such that n-bit signals will fill the plot area. Default: as given for
the current record.
- -ttrecord
- Display data from the specified record.
- -wn
- Set the frame width to n seconds (or, if n is preceded by an optional
s, n samples). Default: 5 seconds.
- -S
- Display the subtyp field of each annotation.
- -C
- Display the chan field of each annotation.
- -N
- Display the num field of
each annotation.
- -A
- Display the aux field of each annotation.
- Annotation
fields are shown in the order given above.
- Invoke the -S, -C, -N, and -A options
a second time to cancel.
- -Fn
- Redefine sampling frequency as n Hz. Default:
as given for the current record.
- -Rh:m:s
- Set the reference time (the clock
time in hours, minutes, and seconds corresponding to the beginning of
the record).
- -Txxx
- Change the title drawn above each frame to xxx. Default:
restore the standard title.
The shell variable DB should be set and exported
(see setdb(1)
).
dbtool(1)
, pschart(1)
, rdann(1)
, rdsamp(1)
, setdb(1)
,
view(1)
, wave(1)
bin/plot (a shell script; examine it to see which devices
are supported)
Table of Contents