Compilation

If the researcher is running Linux and wishes to modify/extend the RCVSIM source code or if the researcher would like to run the RCVSIM software on another platform in which WAVE is fully supported, then compilation is necessary. The steps required to compile the source code are are as follows:

1. Acquire and install MATLAB with the MATLAB compiler (version 1.2), if they are not currently available.
2. Establish a libc5 development environment. See the following web page for detailed instructions:
   http://www.mathworks.com/support/solutions/data/11129.shtml
3. Launch MATLAB from the $DIR directory.
4. At the MATLAB prompt, execute the following commands:
   cd src
   make
   makem

By implementing these steps in the Linux environment, new rcvsim and simulate.mexlx binaries will be created in the $DIR/src directory. If the RCVSIM software has already been installed, then re-installation is unnecessary after compilation. On platforms other than Linux, the above steps must be carried out prior to software installation on platforms other than Linux. Additionally, the install and uninstall scripts in the $DIR directory need to be slightly modified in order to include the different MATLAB binary file extension name that results from compiling on a different platform. For example, if compilation is achieved on the Solaris platform, simulate.mexlx in the install and uninstall files must be replace with simulate.mexsol as the latter file will be created in the $DIR/src directory. Then, the newly compiled software may be installed according to the previous section.

Note that it is possible to compile the source code with the latest 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 MATLAB compiler (version 1.2). Mathworks is currently trying to improve the latest compiler, so it may be possible in the future to use this compiler.