INTRODUCTION

RCVSIM is a human cardiovascular simulator intended to facilitate
cardiovascular research by complementing experimental data studies.
The data generated by RCVSIM may be conveniently analyzed with the
WFDB software package provided by PhysioNet.  The data generated by
RCVSIM may be viewed as they are being calculated (on-line viewing)
or after they have been calculated (off-line viewing) with the WAVE
display system (which is also provided by PhysioNet) and Gnuplot.
RCVSIM is open-source software that is extensively commented and may
be executed at the Linux and MATLAB prompts.  RCVSIM is capable of
generating reasonable human pulsatile hemodynamic waveforms, cardiac 
function and venous return curves, and beat-to-beat hemodynamic 
variability.

INSTALLATION

Read the file INSTALL in the same directory.

EXECUTION

Once installed, the RCVSIM software may be executed as follows.

At the Linux prompt (MATLAB need NOT be installed):

1) Copy file bin/parameters.def to your working directory.
2) Type rcvsim -h for help at Linux prompt. 

(NOTE 1: Prior to execution of rcvsim with on-line viewing option, set
         the time duration displayed by the WAVE window to the value that
	 you assigned to the window parameter in the parameters.def file
	 in your working directory.  This can be accomplished by
         resizing the WAVE window and/or adjusting the Time variable
	 (click VIEW option at the top of the WAVE menu bar)).

(NOTE 2: If rcvsim is executed with on-line viewing option and the WAVE
         window does not appear.  Control-C to exit execution, delete
         all .wave.uid.pid files in the /tmp directory, and re-run
         rcvsim.)

Or, at the MATLAB prompt:

1) Copy file bin/header_def.m to your working directory.
2) Launch MATLAB.
3) Type help simulate for help at MATLAB prompt.
   (Assign input parameter vector, by typing th=header_def.)

Note that parameters.def and header_def.m can be copied to
arbitrary file names.

COMPILATION

1) Acquire and install MATLAB and MATLAB compiler version 1.2
   and the libc5 development library 
   (see http://www.mathworks.com/support/solutions/data/11129.shtml).
2) Lauch MATLAB from this directory.
3) Type cd src at MATLAB prompt
4) Type make at MATLAB prompt to create new rcvsim executable.
5) Type makem at MATLAB prompt to create new simulate.mexlx executable.
 
(NOTE 1: If the source code is recompiled in Linux, no reinstallation is
         necessary after compiling.)

(NOTE 2: It is possible to compile the source code with  the MATLAB
         compiler (version 2.1).  However, the binaries generated 
	 from this compiler are on the order of three magnitudes slower
	 than those generated with the version 1.2 compiler.  Mathworks
	 is currently trying to improve the version 2.1 compiler, so
	 it may be possible, in the future, to use this compiler.)

DOCUMENTATION

See doc/manual.ps for the User's Manual and Software Guide.