Installation

The installation steps that the researcher must carry out in order to execute the RCVSIM pre-compiled Linux binaries are as follows:

1. Download the file rcvsim.tar.gz from the following web page:
   http://www.physionet.org/physiotools/rcvsim
2. Type the following commands at the Linux prompt:
   tar xvzf rcvsim.tar.gz
   cd rcvsim

The contents of this directory - henceforth referred to as $DIR - are as follows:

• README. This text file includes a brief introduction, references to the INSTALL file and the doc sub-directory, and basic execution and compilation instructions.
• INSTALL. This text file explains how to install/uninstall the RCVSIM software on Linux or other platforms in which the WAVE display system is fully supported.
• install. This shell, executable script automates some, or all, of the installation process.
• uninstall. This shell, executable script is designed to undo what was done by the install script.
• src. This sub-directory includes all the source code described in Section 3.1 and Appendix A as well as two other C files (check_redhat.c and check_wfdb.c) which are required by the install and uninstall shell scripts. The Linux and MATLAB pre-compiled binaries (rcvsim and simulate.mexlx) are also stored here.
• bin. This sub-directory includes parameter files, parameters.def and header_def.m (see Section 5.2 and Appendix A), which are respectively required for execution at the Linux and MATLAB prompts, a wfdbcal file responsible for scaling the simulated waveforms displayed by WAVE, and the two binaries, check_redhat and check_wfdb.
• lib. This sub-directory consists of libraries which are required for executing the binaries. These libraries include the dynamic MATLAB libraries which permit software execution in the absence of MATLAB, two RPMs containing libc5 libraries and an old ld.so dynamic linker (part of the Redhat 6.2 distribution which are necessary for dynamically linking the MATLAB libraries), and a tar file consisting of the WFDB software package (version 10.1.6).
• doc. This sub-directory includes this very document in HTML, PDF (manual.pdf), PostScript (manual.ps) and LaTeX source (manual.tex) formats.

1. Login as root.
2. Download and install the WFDB software package and the WAVE display system, if this has not already been done. See the following web page for instructions:
   http://www.physionet.org/physiotools/wfdb-linux-quick-start.shtml

If the researcher is running Linux Redhat 6.2 or higher, then

1. Type the following command in the $DIR directory:
   ./install

The results of Step 5. are as follows:

• The WFDB Software Package (version 10.1.6) in the $DIR/lib directory will be installed, if an older version is currently installed.
• The libc5 libraries and old ld.so dynamic linker RPMs in the $DIR/lib directory will also be installed. (Note that recent Linux systems use libc and a new linker but will not be affected by the installation of the older libraries and linker.)
• An rcvsim executable shell script will be placed in the $DIR/bin directory. This script sets the library and WFDB paths for its subsequent execution of the binary $DIR/src/rcvsim and is linked to the directory /usr/local/bin which should already be in the researcher's path.
• The MATLAB binary executable simulate.mexlx will be linked to a directory in the MATLAB path, if MATLAB is present.

Or, if the researcher is running Linux Redhat 6.1 or lower or any other Linux distribution (e.g., Suse, Debian), then

1a.

Acquire and install the necessary libc5 libraries and old dynamic linker, if they are not currently present on the system.

1b.

Type the following command in the $DIR directory:
./install

For RPM-based distributions (e.g., Mandrake), the software required for Step 5a. may be found on rpmfind.net as was the case for the RPMs provided in the directory $DIR/lib. Please see the following web pages:
http://www.rpmfind.net/linux/rpm2html/search.php?query=ld.so
http://www.rpmfind.net/linux/rpm2html/search.php?query=libc
Note that the results of Step 5b. differ from those of Step 5. in that the RPMs of $DIR/lib will not be installed.

1. To undo the install script, type the following command in the $DIR directory:
   ./uninstall

This will undo everything done by install except the removal of the WFDB Software Package (version 10.1.6), if it were installed. This software can be removed manually (read INSTALL file in the tar file wfdb-10.1.6.tar.gz which is located in the $DIR/lib directory).