file: README		G. Moody	30 July 2010

Software for identifying acute hypotensive episodes (AHEs)

To build and install the software in this directory, install the 'wfdbmap'
package first, then return to this directory and type 'make'.

This directory contains two AHE detectors (findahe and ahelabel).  They
identify AHEs as defined for the PhysioNet/CinC Challenge 2009 (see
	 http://physionet.org/challenge/2009/
for details).  Both detectors use the same algorithm, but 'findahe' reads
text-format input and produces text-format output, and 'ahelabel' reads
a WFDB-format record and produces a WFDB-format annotation file as output.

Also in this directory are two shell scripts (printahe and ahemap), which
provide simple command-line interfaces for 'findahe' and 'ahelabel'
respectively with inputs from the MIMIC II database.

'printahe' uses 'rdsamp' (from the WFDB software package) to extract 'ABP mean'
measurements from a MIMIC II record and to convert them to the text form needed
by 'findahe', which then processes them to produce its output.  To find
AHEs in mimic2db/a44001/a44001, for example, run the command:
    printahe a44001
The output is written to the standard output;  to capture it in a file, run:
    printahe a44001 >a44001-AHEs.txt
(for example).

'ahemap' uses 'ahelabel' to create an annotation file containing the locations
of any AHEs in the input record, then uses 'map-record' (from the 'wfdbmap'
package) to create PostScript and PNG maps of the input record.  To map
AHEs in mimic2db/a44001/a44001, for example, run the command:
    ahemap a44001
The output is written to four files;  in this case, they are a44001.ps,
a44001.png, a44001n.ps, and a44001.png.
