DBPLOT(1)

NAME
dbplot - plot DB signals and annotations

SYNOPSIS
dbplot -trecord [options] ...

DESCRIPTION
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)).

SEE ALSO
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)