Author: Qi Zheng Department of Epidemiology and Biostatistics School of Rural Public Health Texas A&M Health Science Center College Station, Texas 77843 e-mail: qzheng@srph.tamhsc.edu Release Dates: Version 1.0, November 9, 2001 Version 2.0, February 14, 2005 Version 2.1, August 9, 2005 Version 2.2, January 28, 2008 Version 2.3, September 10, 2008 SALVADOR 2.3, 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-3.m, a package in Mathematica, it won't run properly without the executable file listed below. 2. salvadorV2-3.sal, compiled C program, which is called by the Mathematica package salvadorV2-3.m. 3. manualV2-3.nb, a Mathematica notebook that demonstrates the various functions of SALVADOR V2.3. SALVADOR 2.3 requires Mathematica version 6.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; where "salvador" stands for your preferred directory name, e.g., C:\sal2-3. 3. Change to the newly made directory and copy all three files to C:\salvador\. 4. Before starting to run manualV2-3.nb, add and execute (as the first command): SetDirectory["c:\\salvador"]. As described in manualV2-3.nb, each time you run SALVADOR, the executable program salvadorV2-3.sal must be activated from within Mathematica by executing the Mathematica command Install["c:\\salvador\\salvadorV2-3.sal"]. A window will pop up indicating that the file salvadorV2-3.sal is activated. You can minimize this window for visual comfort. At any time you need only one active copy of salvadorV2-3.sal. 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 6.0 or higher has been installed on your Unix computer. The installation of SALVADOR v2.3 consists of the following 3 steps: 1. Make a directory called salvador by executing mkdir salvador where "salvador" stands for your preferred directory name, e.g., ~/sal2-3. 2. Copy the following 3 files into the new directory: a) salvadorV2-3.tm b) salvadorV2-3.m c) manualV2-3.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-3.tm -o salvadorV2-3.sal As a result of step 3, you should see a new executable file named salvadorV2-3.sal residing in your new directory. As is demonstrated in the manual salvadorV2-3.nb, the executable file salvadorV2-3.sal you created at step 3 must be activated from within Mathematica by the command Install["salvadorV2-3.sal"] or Install["~/salvador/salvadorV2-3.sal"] If you accidentally activated more than one copy of salvadorV2-3.sal, 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.