home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / misc / a154_1 / !Tierra / !Help next >
Text File  |  1992-09-14  |  8KB  |  194 lines
  1. Tierra Simulator V3.13: Copyright (c) 1990, 1991, 1992 Thomas S. Ray
  2.  
  3. by Tom Ray, ray@brahms.udel.edu ray@santafe.edu (the bulk of the code)
  4.    Dan Pirone, cocteau@life.slhs.udel.edu (frontend, overhaul, sex)
  5.    Tom Uffner, tom@genie.slhs.udel.edu (rework of genebanker & assembler)
  6.  
  7. Conversion to RISC OS (including WIMP interface)
  8. by Paul Field (paulf@dcs.qmw.ac.uk)
  9.  
  10. Please read the license agreement for tierra ('licence.h' in the source -
  11. also included in tierra_doc)
  12. Note especially that the executables may NOT be distibuted (Nothing to do
  13. with me !).
  14.  
  15. Please note :
  16.   The files Dir.h, Stat.h, Time.h, Dir.c, Stat.c and Time.c are NOT
  17.   part of Tierra. They are PD routines written by
  18.   Gustav (pmoore@cix.compulink.co.uk).
  19.  
  20.  
  21. For full details of how to run tierra in general see 'tierra_doc'. For RISC OS
  22. specific stuff see this file.
  23.  
  24. ------------------------------------------------------------------------------
  25. Running Tierra on a RISC OS machine
  26. -----------------------------------
  27.  
  28. Firstly you will have to compile the sources. You need Acorn C Release 4 and
  29. all you have to do is edit 'source.Makefile' so that the references to
  30. the libraries 'Stubs' and 'RiscOS_Lib' point to the relevent place on
  31. your system. Load up !Make and double-click on the Makefile so that
  32. the Tierra project window opens up. Then select 'Tool Options -> CC'
  33. from the menu and the CC options window will open. Open the menu and
  34. move over 'Predefine' so that a writable 'menu box' appears.
  35. Type in 'RISC_OS' (don't type the single quotes :-) ) and press RETURN.
  36. Next click on 'OK' in the CC options window.
  37. You can then use !Make to compile '!Runimage' and 'arg'.
  38. The tierra sources generate a lot of warnings and errors - just ignore them.
  39. You'll probably find it easiest to set the 'continue after errors' option
  40. of make. Just keep 'making' until you end up with a linked file.
  41. If you have any problems with this contact me and I'll try to help.
  42. Once you have done this :
  43.  
  44. Double click on the application and it will install itself on the icon bar.
  45. If you have previously saved a run it will load this and continue otherwise
  46. it will start a new run.
  47.  
  48. The application icon has a menu attached with the following options :
  49.  
  50. Info ->                  Displays information about the program
  51.  
  52. Histograms -> Log        If ticked will output any histograms (or size queries)
  53.                          to the 'tierra_log' file
  54. Histograms -> Size     } 
  55. Histograms -> Genotype } Opens a window with the appopriate histogram in it
  56. Histograms -> Memory   } (See tierra_doc for details)
  57.  
  58. Size Query -> _____      Fill in the size class you would like to examine in
  59.                          the writable icon and press RETURN.
  60.  
  61. Var -> _____             Change a 'Soup in' variable by entering something
  62.                          like 'alive = 500' in the writable icon.
  63.  
  64.                          (see tierra_doc for details of variables)
  65. Misc->Inject Gene->____  Fill in the name of the genotype to be added to the
  66.                          soup.
  67. Misc->Micro->Off    }    One of these three options will be ticked and determine
  68. Misc->Micro->Delay  }    the state of the micro debugger. In 'click' mode
  69. Misc->Micro->Click  }    each click in the debugger window will execute one
  70.                          instruction of the current organism.
  71.  
  72. Save                     Saves the run to disc.
  73.  
  74. Quit                     Quits the application (but gives you the opportunity
  75.                          to save first).
  76.  
  77.  
  78. Other notes
  79. -----------
  80.  
  81. The message window can be closed - it will pop up if a new message occurs.
  82.  
  83. Clicking on iconbar opens the statistics window.
  84.  
  85.  
  86. Changes to files in the RISC OS version of Tierra
  87. -------------------------------------------------
  88.  
  89. '*.gen' files are now '*' in directory 'gen'
  90. '*.tie' files are now '*' in directory 'tie'
  91. '*.tmp' files are now '*' in directory 'tmp'
  92.  
  93. File 'opcode.map' is now 'opcode_map'
  94. File 'tierra.run' is now 'tierra_run'
  95. File 'tierra.log' is now 'tierra_log'
  96. File 'break.#' is now 'break_#'
  97.  
  98.  
  99. Technical changes to Tierra under RISC OS
  100. -----------------------------------------
  101.  
  102. FEStats is called every 'multi_inst' instructions as well as on cell division
  103. so that the desktop is still reasonably responsive.
  104.  
  105. Since Tierra is not run from the command line, 'tierra soup_out' cannot be
  106. used to continue a run. Currently, if 'soup_out' is found then it is assumed
  107. that the user wishes to continue the run, otherwise a new run is started.
  108. If anyone finds this offensive or can suggest something better then please
  109. let me know.
  110.  
  111. The histogram structure has a 'genotype' field under RISC OS because the
  112. histogram window may need to be redrawn and so we need to keep track of the
  113. number of genotypes in each size class when the histogram was created.
  114.  
  115. Under RISC OS there is no restriction on the number of items in the histogram
  116. since the data appears in a window which is resized to fit the histogram.
  117.  
  118.  
  119. Known problems
  120. --------------
  121.  
  122. Error messages may sometimes complain using non-RISC OS filenames.
  123. It seems a bit pedantic to change them since the filename changes
  124. are fairly trivial.
  125.  
  126. You might have trouble with non-default inst maps -
  127. if so see line 336 of 'tsetup.c'
  128.  
  129. Tierra's files are looked for in the current directory. This is highly
  130. naughty and problems may occur if the current directory is changed while
  131. Tierra is running. In a later version I will probably change this.
  132.  
  133. Some bits of redundant code have been left in. Noticeably the histogram
  134. printing code (for text terminals) still runs - it just calls dummy print
  135. routines that do nothing. This is not really a problem but might slow things
  136. down very slightly.
  137.  
  138. Histograms have no limit on the number of items in them. I don't think this will
  139. cause any problems - but I've mentioned it just in case.
  140.  
  141. The mutitasking is a bit dodgy. The application polls every 500 virtual
  142. instructions but this can take a long time especially when the Tierra
  143. 'watch' routines are in action. I will probabily sort this out in a later
  144. release. Possibilities include :
  145.  1) Poll every x vitual instructions (x is user-defined from the menu).
  146.  2) Poll every x centiseconds (x is user-defined)
  147. The latter is preferable for the user but may be more difficult to acheive
  148. reliably.
  149.  
  150.  
  151. Other programs
  152. --------------
  153.  
  154. In the 'results' directory are the files :
  155.  'clearrun' - clears away all the files from a run
  156.  'cumclear' - clears away all the files from a run but leaves the
  157.               genebank intact
  158.  
  159. In the 'results.gb' directory :
  160.  'arg'      - allows you to assemble/disassemble genotypes (see tierra_doc)
  161.               (N.B. because of the filename changes a command such as :
  162.                     arg c 0080.gen 80 0080aaa.tie
  163.                should be
  164.                     arg c gen.0080 80 tie.0080aaa
  165.                under RISC OS)              
  166.                (For this to work 'results.gb' should be the current directory)
  167.  
  168.  
  169. ------------------------------------------------------------------------------
  170. Note:
  171.   This is the first release of the RISC OS version of Tierra. There is still
  172. a lot I could do. For example, a dynamic graphical display of the soup (with
  173. colour coding for different types of organisms), porting various utilities
  174. that are available for examining the genebank amongst others.
  175.   Hopefully, I'll get round to doing some of this eventually.
  176.  
  177.   If you like the program then let me know. It is terribly demoralising to
  178. spend days working on a program, release it and then watch it apparently
  179. vanish into obscurity. Naturally, any suggestions and bug reports will be
  180. gladly received.
  181.  
  182. Paul Field
  183. (paulf@dcs.qmw.ac.uk)
  184.  
  185. also (long term address)
  186. 3, Little Heath
  187. Chadwell Heath
  188. Romford
  189. Essex
  190. RM6 4XX
  191. England
  192.  
  193. ------------------------------------------------------------------------------
  194.