quicksta

地球模拟器

4)  QUICK START 

     The steps required to run the system on DOS and UNIX are slightly
different, so there are two sets of instructions listed below.

  4.1) DOS QUICK START

     If you obtained the Tierra software on disk, the installation program
will take care of steps 1 - 3, so you can skip to step 4.  If you
obtaind the software over the net, start with step 1. 

      step 1)  You should have a directory containing the executables and
source code and two subdirectories: td and gb.  The td directory is where a
record of births and deaths will be written.  The gb directory contains the
initial genomes used to innoculate the soup and the opcode map, and the
genebanker will save new genomes to this directory.

      step 2)  You must compile the assember/disassembler, arg, and the
simulator, tierra.  We include the two Turbo C V 2.0 project files:
tierrav2.prj and argv2.prj and the Borland C++ project files: tierrapp.prj
and argpp.prj.  Rename the relevant versions to: arg.prj and tierra.prj.

for Borland C++:

ren argpp.prj arg.prj
ren tierrapp.prj tierra.prj

or for Turbo C V 2.0:

ren argv2.prj arg.prj
ren tierrav2.prj tierra.prj

     Compile these projects using the large memory 
model.  Put the executables in the path.

      step 3)  You must assemble the initial genomes, as binaries are not
portable.  To do this, go into the gb directory and type:

arg c 0080.gen 80 0080aaa.tie
arg c 0045.gen 45 0045aaa.tie

This will create the two binary files 0080.gen and 0045.gen which contain two
creatures that you can use to innoculate the soup, the ancestor 0080aaa
and a parasite that evolved from the ancestor, 0045aaa.  You can check to
see if this worked by disassembling the two genomes, by typing:

arg x 0080.gen aaa
arg x 0045.gen aaa

This will create the two ascii files 0080aaa and 0045aaa.  Compare them to
the originals, 0080aaa.tie and 0045aaa.tie {they will not be exactly the
same}.  Before you start a run, copy 0080.gen to 0080gen.vir and copy
0045.gen to 0045gen.vir, in order to have virgin copies for use later when
you start another run.

copy 0045.gen 0045gen.vir
copy 0080.gen 0080gen.vir

      step 4)  Go back to the source code directory and examine the file
soup_in.  This file contains all of the parameters that control the run.  It
is currently set up to innoculate the soup with one cell of genotype 0080aaa,
and to run for 500 million instructions in a soup of 50,000 instructions.  You
will need a text editor if you want to modify this file.  If you use a regular
word processor, be sure that you write the file back out as a plain ASCII text
file.

      step 5)  Run the simulator by typing: tierra

      step 6)  When the run is over, if you want to start a new run, you
should clean up the genebank, because the simulator will read in all genomes
in the genebank at startup.  The best way to do this is to go into the gb
directory and remove all .gen, and .tmp files, and then copy the backup
version of the 0080.gen file:

cd gb
del *.gen
del *.tmp
copy 0080gen.vir 0080.gen

     A DOS batch file has been provided to perform this cleanup automatically.
It is named clearrun.bat, and has the following contents:

del td\break.*
del gb\*.gen
del gb\*.tmp
copy gb\0080gen.vir gb\0080.gen
del core_out
del soup_out
del tierra.log

     All you have to do is type ``clearrun'' to the DOS prompt, and the
batch file will take care of the cleanup.

  4.2) UNIX QUICK START

      step 1)  You should have a directory containing the source code and two
subdirectories: td and gb.  The td {tiedat} directory is where a record of
births and deaths will be written.  The gb {genebank} directory contains the
initial genomes used to innoculate the soup and the opcode map, and the
genebanker will save new genomes to this directory.

      step 2)  You must compile the assember/disassembler, arg, and the
simulator, tierra.  Two executable files, ccarg and cctierra are included
which perform the compilation.  You may have to alter the flags for your
system.  You must change the protection on these files to make them
executable: chmod +x ccarg, chmod +x cctierra.  Then just type ccarg, then
type cctierra to get the programs compiled.

     There is also a Makefile included which is preferable, if it works on
your system.  This Makefile needs to be edited to comment in the lines for
your particular hardware.  It has been tested on Sun 3, Sun 4, IBM RS6000,
Silicon Graphics Personal Iris and Indigo, DEC DS5000, and NeXT.
If you can use the Makefile, type: make, and follow instructions.

      step 3)  You must assemble the initial genomes, as binaries are not
portable.  To do this, go into the gb directory and type:

../arg c 0080.gen 80 0080aaa.tie
../arg c 0045.gen 45 0045aaa.tie

This will create the two binary files 0080.gen and 0045.gen which contain
two creatures that you can use to innoculate the soup, the ancestor 0080aaa
and a parasite that evolved from the ancestor, 0045aaa.  You can check to
see if this worked by disassembling the two genomes, by typing:

../arg x 0080.gen aaa
../arg x 0045.gen aaa

This will create the two ascii files 0080aaa and 0045aaa.  Compare them to
the originals, 0080aaa.tie and 0045aaa.tie {they will not be exactly the
same}.  Before you start a run, copy 0080.gen to 0080gen.vir and copy
0045.gen to 0045gen.vir, in order to have virgin copies for use later when
you start another run.

cp 0045.gen 0045gen.vir
cp 0080.gen 0080gen.vir

      step 4)  Go back to the source code directory and examine the file
soup_in.  This file contains all of the parameters that control the run.  It
is currently set up to innoculate the soup with one cell of genotype 0080aaa,
and to run for 500 million instructions in a soup of 50,000 instructions.

      step 5)  Run the simulator by typing:
           tierra
       or: tierra > /dev/null &  {to run it in the background
			         a Log file can be created by setting
			         the soup_in variable Log = 1}

     In order to run tierra in the background, you must compile it with:

#define FRONTEND STDIO

     If you will run Tierra in the foreground, we recommend that you use:

#define FRONTEND BASIC

     These definitions are made in the configur.h file.

      step 6)  When the run is over, if you want to start a new run, you
should clean up the genebank.  The best way to do this is to go into the gb
directory and remove all .gen, and .tmp files, and then copy the backup
version of the 0080.gen file:

cd gb
rm *.gen
rm *.tmp
cp 0080gen.vir 0080.gen

     A Unix shell script has been provided to perform this cleanup
automatically.  It is named clearrun, and has the following contents:

rm td/break.*
rm gb/*.gen
rm gb/*.tmp
cp gb/0080gen.vir gb/0080.gen
rm core_out
rm soup_out
rm tierra.log

     You must make the clearrun file executable by changing its protection:

chmod +x clearrun

     Then all you have to do is type ``clearrun'' to the prompt, and the
shell script will take care of the cleanup.