A biological system simulator that investigates how life develops in a toroidal planet populated by sharks and fish.
Based on the article "Sharks and fish wage an ecological war on the toroidal planet Wator" by A. K. Dewdney (Scientific American, Vol. 251, No. 6 (December 1984), pp. 14-26)
To generate executable files, open the terminal and run:
cd src
make
To adjust the settings of the simulation, modify the files 'wator.conf' (which contains the parameters of the simulation) and 'planet.dat' (which contains the planet's configuration) contained in the 'DATA' directory. The 'DATA' directory also contains additional files such as 'wator.conf.1', 'wator.conf.2', 'planet1.dat', 'planet2.dat' and 'planet3.dat', whose purpose is to exemplify the correct formatting of the files 'wator.conf' and 'planet.dat' so that the program works properly.
With the terminal opened in the directory 'src', you can run the program using the following command:
./wator planet_file [-n nwork] [-v chronon] [-f dumpfile]
'planet_file' is any file having the same formatting as 'planet1.dat', 'planet2.dat' and 'planet3.dat'. The option '-n' is used to specify the number of threads used to perform the simulation. The option '-v' is used to specify the length (in terms of chronons, which are nothing but time ticks) of the simulation. Finally, the option '-f' is used to specify the file where you want to print the aspect of the planet after each chronon.
To run the script, execute:
./watorscript planet_file [-f] [-s] [--help]
Additional informations on how to use the script can be obtained using the option '--help'
Per generare gli eseguibili dei programmi, eseguire:
cd src
make
Per cambiare le impostazioni della simulazione, modificare i file 'wator.conf' (che contiene i parametri della simulazione) e 'planet.dat' (che contiene la configurazione del pianeta) contenuti nella directory 'DATA'. Quest'ultima contiene anche i file 'wator.conf.1', 'wator.conf.2', 'planet1.dat', 'planet2.dat' e 'planet3.dat', che danno un'idea di come devono essere formattati i file 'wator.conf' e 'planet.dat' affinché il programma funzioni correttamente.
Per eseguire il programma lanciare, sempre dalla directory 'src', il comando:
./wator planet_file [-n nwork] [-v chronon] [-f dumpfile]
'planet_file' è un qualunque file avente lo stesso formato di 'planet1.dat', 'planet2.dat' e 'planet3.dat'. L'opzione '-n' serve a specificare il numero di thread da usare per la simulazione. L'opzione '-v' specifica la durata (in chronon, ossia istanti di tempo) della simulazione. Infine, l'opzione '-f' è usata per specificare il file in cui si vuole stampare l'aspetto del pianeta dopo ciascun chronon.
Per lanciare lo script, eseguire:
./watorscript planet_file [-f] [-s] [--help]
Ulteriori informazioni sull'utilizzo dello script si possono avere specificando l'opzione '--help'