install

ecg wave detection program for unix / linux

file: INSTALL		G. Moody		25 February 2006
      			Last revised:		  11 June 2008

Installing ecgpuwave under GNU/Linux, Mac OS/X, MS-Windows, or Unix

1. Choose and install a Fortran 77 compiler.

   You may already have a suitable Fortran 77 compiler;  to find out, look
   for a program named 'g77' or 'f77'.
   
   Unless you already have it, install the original GNU Fortran 77
   compiler, g77 (part of the GNU Compiler Collection, gcc).  The newer
   GNU Fortran 90 compiler, gfortran, is unable to compile ecgpuwave as of
   June 2008, although this may change.

   Most popular GNU/Linux distributions include g77, but distributions that
   use gcc 4.0 as the default C compiler often include gfortran only.  If you
   are using Fedora, and 'yum' is properly configured, you may install g77
   by typing (as root):
	yum install compat-gcc-34-g77

   If you are using Mac OS X, and 'fink' is properly configured, you may
   install g77 by typing:
	sudo fink install g77

   If you are using MS-Windows, follow the instructions at
	http://physionet.org/physiotools/cygwin/
   for installing the freely available Cygwin environment.  There are many
   optional packages that you may install at the same time;   be sure to
   install the gcc-g77 package (in the Devel group).  Run the commands below
   by typing them into a Cygwin (bash) window.

2. Install the WFDB Software Package (freely available from PhysioNet,
   see http://www.physionet.org/physiotools/wfdb.shtml), if you have not
   already done so.

3. Create a working directory for compiling ecgpuwave, copy the files
   from this directory into it, and enter that directory.

4. Compile and install ecgpuwave using the command:
	make install
   You may need root (admin) privileges to complete this step successfully.

   If you don't have root privileges, you can still compile ecgpuwave without
   installing it by typing 'make';  you will then need to move the executable
   file (ecgpuwave.exe on MS-Windows, ecgpuwave on all other platforms) into
   a directory in your PATH before running it.

5. Test ecgpuwave using the command:
	make check
   In this two-part test, ecgpuwave analyzes the one-minute WFDB sample
   record 100s, and its output is compared with the output expected for
   ecgpuwave when running on an x86 CPU.  Test 1 succeeds if there are no
   differences at all, and test 2 succeeds if all discrepancies are one
   sample interval or less.

   Since ecgpuwave makes heavy use of floating point arithmetic, the waveform
   boundaries it determines when running on another CPU type may occasionally
   vary by one sample interval from the expected output for an x86 CPU.  On the
   PPC-Mac OS X platform, it is normal for test 1 to fail, but test 2 should
   succeed.  If test 2 fails, this observation should be reported.

For additional information about using ecgpuwave, visit:
	http://www.physionet.org/physiotools/ecgpuwave/

This information is also included here as 'ecgpuwave.1' (in Unix 'man' format).