ECG Database Applications Guide
Table of Contents
rdann - read a DB annotation file
rdann -r record -a annotator
[ options ... ]
rdann reads the annotation file specified by record
and annotator, and writes an ASCII translation of it on the standard output,
one annotation per line. The output contains (from left to right) the
time of the annotation in hours, minutes, seconds, and milliseconds; the
time of the annotation in samples; a mnemonic for the annotation type;
the annotation subtyp, chan, and num fields; and the auxiliary information
string, if any (assumed to be a null-terminated ASCII string).
Options include:
- -f time
- Begin at the specified time. By default, rdann starts at the beginning
of the record; if modification labels are present, they are not printed
unless -f 0 is given explicitly, however.
- -h
- Print a usage summary.
- -p type
[ type ... ]
- Print annotations of the specified types only. The type arguments
should be annotation mnemonics (e.g., N) as normally printed by rdann in
the third column. More than one -p option may be used in a single command,
and each -p option may have more than one type argument following it. If
type begins with ``-'', however, it must immediately follow -p (standard annotation
mnemonics do not begin with ``-'', but modification labels in an annotation
file may define such mnemonics).
- -t time
- Stop at the specified time.
- -x
- Use
an alternate time format for output (the first two columns are the elapsed
times in seconds and in minutes, replacing the hh:mm:ss and sample number
columns in the default output).
The -f and -t options may be used to select
a portion of an annotation file for printing. Their arguments are usually
given as times in hh:mm:ss format; see the description of strtim in the
ECG Database Programmer's Guide, as well as the comments below, for other
formats.
Beat numbers beginning with 0 are implicitly assigned by rdann
to each QRS annotation in an annotation file. If the argument of the -f
option begins with `#', it is taken to be the beat number of the first QRS
annotation to be printed (any non-QRS annotations that immediately precede
this annotation are also printed). If the argument of the -t option begins
with `#', it is taken as the number of QRS annotations to be processed;
note that not all of those processed will necessarily be printed, if
the -p option is used to select only a subset of annotation types to be
printed.
The shell variable DB should be set and exported (see setdb(1)
).
rdann -a atruth -r 200 -f 0 -t 5:0 -p V
This command prints on the standard
output all ``V'' (PVC) annotations in the first five minutes of the atruth
(reference annotation) file for record 200.
The first edition
of the MIT-BIH Arrhythmia Database CD-ROM, the first and second editions
of the European ST-T Database CD-ROM, and the first edition of the MIT-BIH
Polysomnographic Database CD-ROM contain versions of rdann that use an
older command syntax (still supported by the current version but not described
here). Refer to bin.doc in the CD-ROM directory that contains rdann for
further information.
setdb(1)
, wrann(1)
Table of Contents