Author: Qi Zheng School of Rural Public Health Texas A&M Health Science Center College Station, Texas 77843 e-mail: qzheng@srph.tamhsc.edu Release Date: Version 1.0, November 9, 2001 Version 2.0, February 14, 2005 Version 2.1, February 6, 2007 SALVADOR 2.1, written in Mathematica and C, is a comprehensive computer package for analyzing data generated by Luria-Delbruck fluctuation experiments ************ For PC Users *********** The PC version of SALVADOR consists of the following three files: 1. salvadorV2.1.m, Mathematica code, it won't run properly without the executable file listed below. 2. salvadorV2.exe, compiled C program, it is identical to its version 2.0 counterpart, and is called by the Mathematica program salvadorV2-1.m. 3. manualV2.1.nb, a Mathematica notebook which demonstrates the various functionalities of SALVADOR V.2.1. SALVADOR 2.1 requires Mathematica version 5.0 or above. A computer with 256K RAM and a CPU of 500 MHz or faster is strongly recommended. You can install SALVADOR on a PC (assuming Mathematica is already install on that PC) by following 3 simple steps: 1. Change to the top of your working directory, e.g. C:\; 2. Make a directory for SALVADOR by executing mkdir salvador; 3. Change to the newly made directory and copy all three files to C:\salvador\. 4. Before starting to run manualV2.1.nb, add and execute (as the first command): SetDirectory["c:\\salvador"]. As described in manualV2-1.nb, each time you run SALVADOR, the executable program salvadorV2.exe must be activated from within Mathematica by executing the Mathematica command Install["c:\\salvador\\salvadorV2"]. A window will pop up indicating that the file salvadorV2.exe is activated. You can minimize this window for visual comfort. At any time you need only one active copy of salvadorV2.exe. If you accidentally activated more than one copy, you can eliminate the extra active copies by killing the windows or icons on the toolbar that represent the extra running programs. *********** For Unix Users ************ If you intend to run SALVADOR on a Unix system, make sure that Mathematica 5.0 or higher has been installed on your Unix computer. The installation of SALVADOR v2.1 consists of the following 3 steps: 1. Make a directory called salvador under your home directory by moving to the top of your home directory and then executing mkdir salvador 2. Copy the following 3 files into the new directory: a) salvadorV2.tm (this file is identical to its Version 2.0 counterpart.) b) salvadorV2.1.m c) manualV2.1.nb 3. If Mathematica is already properly installed on your Unix machine, you should be able to access a program called mmc, which is a standard component of your Mathematica software. Compile the C file salvador.tm by executing mcc salvadorV2.tm -o salvadorV2 As a result of step 3, you should see a new executable file named salvadorV2 residing in your new directory. As is demonstrated in the manual salvadorV2-1.nb, the executable file salvador you created at step 3 must be activated from within Mathematica by the command Install["salvadorV2"] or Install["yourHomeDirectory/salvadorV2"] If you accidentally activated more than one copy of salvadorV2, you should kill the extra processes. You can use Unix commands like ps or top to find whether you have activated more than one copy of salvador. You can then use the kill command to kill the extra processes.