Installing IMMSIM: ------------------ 1. Download the latest public version available at http://www.cs.princeton.edu/immsim/immsim-c.html . 2. Unzip the archive in a directory of your choice (e.g. C:\Program Files\IMMSIM\). 3. Make sure JDK is installed (edition 1.3.1_02 or newer from http://java.sun.com/j2se/), and \bin is in PATH (follow installation instructions from the download site). Running IMMSIM: --------------- 1. Execute winrun.bat; you should see two windows: a system command window (check here for messages - errors, runs, death/cure) and the IMMSIM graphical user interface window (GUI). 2. In the GUI, select the number of concurrent runs (you can only set this value now, before activating any runs), then the number of steps to run. Click on "Go!" to start the runs. 3. Notice that whenever there are active runs, the GUI is not responding to any events (clicks, shortcut keys). 4. After running for the specified number of steps, you can reactivate the runs with the same or a different number of steps. 5. You can change parameter values before starting the runs or between runs, by choosing the "Parameters" entry in the "File" menu. 6. To visualize an entity, select it from the drop-down menu in the lower right part of the GUI, then click on "Show Me". 7. If you want to restart the simulation, first close the main GUI window (it will close any open graph windows) when there are no active runs, then restart IMMSIM (step 1). Graph windows: -------------- If the value for "Runs" in the main GUI window is greater than 1, you can select the run number from the "Runs" menu in the graph window. You can also select "Average", which averages each data point over all runs. Runs are numbered starting from 0 (e.g. n runs are 0, 1, ..., n-1). The four buttons in the graph area ("..." for icons) are: 1. print the current plot 2. reset the axis to original values 3. set the plot format (not working) 4. rescale the plot to fit the data (use this often) By clicking in the graph area and dragging the mouse you can zoom in or out. If you can't see all four buttons or the legend to the right of the graph, try resizing the window (click on window edge/corner and drag) a few times until all components are visible. Load/Save: ---------- This feature allows you to run the simulation on one computer, save your data, then restore it on another computer (or the same one) and analyze it using graphs. Use the "Load" and "Save" entries in the "File" menu. 1. You cannot save data before doing any runs. 2. You are not allowed to load in data after you started any runs. If you already ran the simulator and want to load in data, first restart IMMSIM (exit, then start), then load the data. 3. You can always continue saved runs, i.e. if you saved the data, you can still run the simulation more steps, even save the data again later if you want. 4. You can never run the simulation after loading in data. Since the data that is saved is only used to generate graphs, it doesn't contain the detailed information needed to run the simulation. 5. If death/cure occurs in a run before saving, this information is not saved explicitly in the data files, so please write it down if you think you'll need it when analyzing the data. Of course, you can deduct the occurrence of such events from the graphs, but the exact step number can only be guessed. 6. If you change any parameters from their default values during the run, write down the new parameter values when you save the data. If you restart IMMSIM to load in the saved data, the default parameter values are loaded again. --- Last modified: March 25, 2002.