Installation And Setup Guide

Installation

Extract the content of the file you have downloaded to a folder of your choice, usually firesim in the program folder of your rescue installation, which will be reference as fsim in the following. fsim should now contain:

• fsim.jar: simulator executable
• default.stp: setup file
• config.txt: a config.txt with additional lines wich can be used instead of the setup file. See Command Line Parameters section beneth for further information.
• *.rays: precalculated monte carlo data for some maps
• *.scn: stored initial data for setup sessions

Change the content of 5firesimulator.sh in the boot folder of your kernel directory to:

cd fsim
java -jar fsim.jar -h host -p port

Where host and port describe the kernel socket.

Creating Simulation Parameters

The parameters of the simulator can be adjusted within the Firesimulator Setup Environment in a interactive way, which means the resulting changes in the simulation behaviour can be seen instantly. The initial data for these sessions is stored in the .scn files representing a snapshot of a run taken at time step zero. If you want to create your own snapshot simply start the simulation with the desired property after adding the parameter -s filename to the firesimulator. A setup session is started by java -jar fsim.jar -v filename.

Command Line Parameters

-help		Prints all parameters and exits.
-p port		Tells the simulator to connect to port. The default value is 6000.
-h host		Tells the simulator to connect to host. The default value is localhost.
-cstp filename		The path of config.txt. By default . is used. Notice that the the values in the configt.txt will be overruled by the values from the .stp file if the are defined there.
-v filename		Start the setup environment and load initial data from filename.
-s filename		Store the initial data in filename.
-ray_rate rate		Number of emitted rays per mm while sampling. rate is a float value.