home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / TIERRA40.ZIP / DOC / QUICKSTA < prev    next >
Text File  |  1992-05-28  |  7KB  |  188 lines

  1.  
  2. 4)  QUICK START 
  3.  
  4.      The steps required to run the system on DOS and UNIX are slightly
  5. different, so there are two sets of instructions listed below.
  6.  
  7.   4.1) DOS QUICK START
  8.  
  9.      If you obtained the Tierra software on disk, the installation program
  10. will take care of steps 1 - 3, so you can skip to step 4.  If you
  11. obtaind the software over the net, start with step 1. 
  12.  
  13.       step 1)  You should have a directory containing the executables and
  14. source code and two subdirectories: td and gb.  The td directory is where a
  15. record of births and deaths will be written.  The gb directory contains the
  16. initial genomes used to innoculate the soup and the opcode map, and the
  17. genebanker will save new genomes to this directory.
  18.  
  19.       step 2)  You must compile the assember/disassembler, arg, and the
  20. simulator, tierra.  We include the two Turbo C V 2.0 project files:
  21. tierrav2.prj and argv2.prj and the Borland C++ project files: tierrapp.prj
  22. and argpp.prj.  Rename the relevant versions to: arg.prj and tierra.prj.
  23.  
  24. for Borland C++:
  25.  
  26. ren argpp.prj arg.prj
  27. ren tierrapp.prj tierra.prj
  28.  
  29. or for Turbo C V 2.0:
  30.  
  31. ren argv2.prj arg.prj
  32. ren tierrav2.prj tierra.prj
  33.  
  34.      Compile these projects using the large memory 
  35. model.  Put the executables in the path.
  36.  
  37.       step 3)  You must assemble the initial genomes, as binaries are not
  38. portable.  To do this, go into the gb directory and type:
  39.  
  40. arg c 0080.gen 80 0080aaa.tie
  41. arg c 0045.gen 45 0045aaa.tie
  42.  
  43. This will create the two binary files 0080.gen and 0045.gen which contain two
  44. creatures that you can use to innoculate the soup, the ancestor 0080aaa
  45. and a parasite that evolved from the ancestor, 0045aaa.  You can check to
  46. see if this worked by disassembling the two genomes, by typing:
  47.  
  48. arg x 0080.gen aaa
  49. arg x 0045.gen aaa
  50.  
  51. This will create the two ascii files 0080aaa and 0045aaa.  Compare them to
  52. the originals, 0080aaa.tie and 0045aaa.tie {they will not be exactly the
  53. same}.  Before you start a run, copy 0080.gen to 0080gen.vir and copy
  54. 0045.gen to 0045gen.vir, in order to have virgin copies for use later when
  55. you start another run.
  56.  
  57. copy 0045.gen 0045gen.vir
  58. copy 0080.gen 0080gen.vir
  59.  
  60.       step 4)  Go back to the source code directory and examine the file
  61. soup_in.  This file contains all of the parameters that control the run.  It
  62. is currently set up to innoculate the soup with one cell of genotype 0080aaa,
  63. and to run for 500 million instructions in a soup of 50,000 instructions.  You
  64. will need a text editor if you want to modify this file.  If you use a regular
  65. word processor, be sure that you write the file back out as a plain ASCII text
  66. file.
  67.  
  68.       step 5)  Run the simulator by typing: tierra
  69.  
  70.       step 6)  When the run is over, if you want to start a new run, you
  71. should clean up the genebank, because the simulator will read in all genomes
  72. in the genebank at startup.  The best way to do this is to go into the gb
  73. directory and remove all .gen, and .tmp files, and then copy the backup
  74. version of the 0080.gen file:
  75.  
  76. cd gb
  77. del *.gen
  78. del *.tmp
  79. copy 0080gen.vir 0080.gen
  80.  
  81.      A DOS batch file has been provided to perform this cleanup automatically.
  82. It is named clearrun.bat, and has the following contents:
  83.  
  84. del td\break.*
  85. del gb\*.gen
  86. del gb\*.tmp
  87. copy gb\0080gen.vir gb\0080.gen
  88. del core_out
  89. del soup_out
  90. del tierra.log
  91.  
  92.      All you have to do is type ``clearrun'' to the DOS prompt, and the
  93. batch file will take care of the cleanup.
  94.  
  95.   4.2) UNIX QUICK START
  96.  
  97.       step 1)  You should have a directory containing the source code and two
  98. subdirectories: td and gb.  The td {tiedat} directory is where a record of
  99. births and deaths will be written.  The gb {genebank} directory contains the
  100. initial genomes used to innoculate the soup and the opcode map, and the
  101. genebanker will save new genomes to this directory.
  102.  
  103.       step 2)  You must compile the assember/disassembler, arg, and the
  104. simulator, tierra.  Two executable files, ccarg and cctierra are included
  105. which perform the compilation.  You may have to alter the flags for your
  106. system.  You must change the protection on these files to make them
  107. executable: chmod +x ccarg, chmod +x cctierra.  Then just type ccarg, then
  108. type cctierra to get the programs compiled.
  109.  
  110.      There is also a Makefile included which is preferable, if it works on
  111. your system.  This Makefile needs to be edited to comment in the lines for
  112. your particular hardware.  It has been tested on Sun 3, Sun 4, IBM RS6000,
  113. Silicon Graphics Personal Iris and Indigo, DEC DS5000, and NeXT.
  114. If you can use the Makefile, type: make, and follow instructions.
  115.  
  116.       step 3)  You must assemble the initial genomes, as binaries are not
  117. portable.  To do this, go into the gb directory and type:
  118.  
  119. ../arg c 0080.gen 80 0080aaa.tie
  120. ../arg c 0045.gen 45 0045aaa.tie
  121.  
  122. This will create the two binary files 0080.gen and 0045.gen which contain
  123. two creatures that you can use to innoculate the soup, the ancestor 0080aaa
  124. and a parasite that evolved from the ancestor, 0045aaa.  You can check to
  125. see if this worked by disassembling the two genomes, by typing:
  126.  
  127. ../arg x 0080.gen aaa
  128. ../arg x 0045.gen aaa
  129.  
  130. This will create the two ascii files 0080aaa and 0045aaa.  Compare them to
  131. the originals, 0080aaa.tie and 0045aaa.tie {they will not be exactly the
  132. same}.  Before you start a run, copy 0080.gen to 0080gen.vir and copy
  133. 0045.gen to 0045gen.vir, in order to have virgin copies for use later when
  134. you start another run.
  135.  
  136. cp 0045.gen 0045gen.vir
  137. cp 0080.gen 0080gen.vir
  138.  
  139.       step 4)  Go back to the source code directory and examine the file
  140. soup_in.  This file contains all of the parameters that control the run.  It
  141. is currently set up to innoculate the soup with one cell of genotype 0080aaa,
  142. and to run for 500 million instructions in a soup of 50,000 instructions.
  143.  
  144.       step 5)  Run the simulator by typing:
  145.            tierra
  146.        or: tierra > /dev/null &  {to run it in the background
  147.                      a Log file can be created by setting
  148.                      the soup_in variable Log = 1}
  149.  
  150.      In order to run tierra in the background, you must compile it with:
  151.  
  152. #define FRONTEND STDIO
  153.  
  154.      If you will run Tierra in the foreground, we recommend that you use:
  155.  
  156. #define FRONTEND BASIC
  157.  
  158.      These definitions are made in the configur.h file.
  159.  
  160.       step 6)  When the run is over, if you want to start a new run, you
  161. should clean up the genebank.  The best way to do this is to go into the gb
  162. directory and remove all .gen, and .tmp files, and then copy the backup
  163. version of the 0080.gen file:
  164.  
  165. cd gb
  166. rm *.gen
  167. rm *.tmp
  168. cp 0080gen.vir 0080.gen
  169.  
  170.      A Unix shell script has been provided to perform this cleanup
  171. automatically.  It is named clearrun, and has the following contents:
  172.  
  173. rm td/break.*
  174. rm gb/*.gen
  175. rm gb/*.tmp
  176. cp gb/0080gen.vir gb/0080.gen
  177. rm core_out
  178. rm soup_out
  179. rm tierra.log
  180.  
  181.      You must make the clearrun file executable by changing its protection:
  182.  
  183. chmod +x clearrun
  184.  
  185.      Then all you have to do is type ``clearrun'' to the prompt, and the
  186. shell script will take care of the cleanup.
  187.  
  188.