home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / gfx / megajitter-1.3.lha / MegaJitter-1.3 / README < prev    next >
Text File  |  1994-05-30  |  19KB  |  559 lines
  1. *****************************************************************************
  2. *                                                                           *
  3. *                    PUBLIC DOMAIN SOFTWARE LICENSE                         *
  4. *                                                                           *
  5. *                    ++++++++++++++++++++++++++++++                         *
  6. *                                                                           *
  7. *                                                                           *
  8. * The following program(s) and/or data file(s) are declared Public Domain.  *
  9. *                                                                           *
  10. * Conditions of use:                                                        *
  11. * ------------------                                                        *
  12. *                                                                           *
  13. * 1) No part of this distribution will be omitted (incl. this README file)  *
  14. * 2) None of the Copyright texts will be modified or deleted.               *
  15. * 3) None of the files should be stored and/or converted onto environment-  *
  16. *    ally damaging media. (paper listings, faxes, etc...)                   *
  17. *                                                                           *
  18. * Provided the end user sticks to the above mentioned author's wishes, he   *
  19. * or she is authorized to use, copy, analyze and improve the items.         *
  20. *                                                                           *
  21. *                                                                           *
  22. * The Author,                                                               *
  23. *                                                                           *
  24. * Laurence Vanhelsuwé                                                       *
  25. *                                                                           *
  26. * Auroville 19/MAY/94 (India)                                               *
  27. *                                                                           *
  28. *                                                                           *
  29. *****************************************************************************
  30.  
  31.                       -------------------------------
  32.                       Program Title: MegaJitter  V1.3
  33.                       -------------------------------
  34.  
  35.                         Author: Laurence Vanhelsuwé
  36.  
  37.  
  38.  
  39.  
  40.  
  41.             0. Short description
  42.  
  43.             1. Requirements/Installation
  44.  
  45.             2. How to use it
  46.  
  47.             3. Internals
  48.  
  49.               3.1 Command Line Options
  50.  
  51.               3.2 Creature Genes
  52.  
  53.               3.3 AREXX Support
  54.  
  55.               3.4 Speed Optimizations
  56.  
  57.             4. Limitations/Warnings
  58.  
  59.             5. History
  60.  
  61.             6. Future
  62.  
  63.             7. Bibliography
  64.  
  65.             8. Credits
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. 0. Short description:
  73.    ------------------
  74.  
  75. MegaJitter (from now on: MJ) is a biological Evolution simulator.
  76. It tries to simulate a simple ecosystem with creatures which eat, get born,
  77. procreate and die.
  78.  
  79. Believe it or not, but without ANY pressure on the program's part, these
  80. creatures often EVOLVE into new species which are optimally adapted to their
  81. environment !
  82.  
  83. Many different environment scenarios can be configured for MJ, with totally
  84. different species emerging.
  85.  
  86. The main "Laws of Nature" the program codifies are as follows:
  87.  
  88. - if you eat food, you get X energy points
  89. - moving costs energy
  90. - if you run out of energy, you die.
  91. - if you reach a fitness threshold, you're allowed to procreate.
  92. - any offspring get copies of your genes, but in slightly mutated form.
  93.  
  94. MJ Doesn't have miracles, the Fittest Survive, that's the bottom line.
  95.  
  96. On the Amiga, MegaJitter's dual-screen approach offers a full screen of
  97. graphical statistics plus the actual ecosystem with pixels representing food
  98. and creatures.
  99. For research purposes, the animated ecosystem can be disabled for faster
  100. simulations (overnight runs for example).
  101.  
  102.  
  103. 1. Requirements/Installation:
  104.    --------------------------
  105.  
  106. This Release (V1.3) contains the following directories/files which should
  107. be copied into an empty directory called "MegaJitter" (or something like it).
  108.  
  109. ==================================================
  110.      SCENARIOS (dir)
  111.        CHAINREAC                        Clusters
  112.        Hedges                           Oasis
  113.      REXX (dir)
  114.        GOD                              MSC
  115.   .Product-Info                    ja.s
  116.   makefile                         mj
  117.   mj.c                             mj.wth
  118.   README                           SCOPTIONS
  119. ==================================================
  120.  
  121. Required:
  122. ---------
  123.  - V39 of the Amiga OS.
  124.  - a 68020-based Amiga or better.
  125.  - at least 1.5 Mb of RAM to run.
  126.  
  127. Optionally:
  128. -----------
  129.  - AREXX for external program control.
  130.  
  131.  
  132.  
  133.  
  134. 2. How to use it:
  135.    --------------
  136.  
  137. This distribution actually contains 3 programs: MegaJitter (MJ) proper and
  138. two supporting REXX utilities.
  139.  
  140. For MegaJitter itself, 
  141.  
  142. Just type:    "MJ"
  143.  
  144. Or        "RUN MJ"
  145.  
  146. or MJ followed by any of the command line options.
  147. (type "MJ ?" for a list or see below for details)
  148.  
  149.  
  150. The two REXX programs are GOD and MSC and control or configure MJ, respectively.
  151.  
  152. - MSC Stands for "MJ Set Scenario" and takes one argument: a MegaJitter scenario
  153.   file.
  154.  
  155. For example, to configure the "Oasis" scenario you would type:
  156.  
  157.     RX MSC SCENARIOS/OASIS
  158.  
  159. 'RX' Is of course the REXX program dispatcher. You can omit this if you are
  160. using a Shell which allows direct execution of REXX programs.
  161.  
  162. - GOD Is a MegaJitter scenario finder. It generates random sets of starting
  163. parameters and configures MJ to use them.
  164. Then, for about 15 minutes it monitors the running, simulated environment
  165. to see if the parameters result in a stable ecosystem.
  166. If so, it dumps the settings to the screen, otherwise it kills off the failing
  167. ecosystem and generates a new set of parameters, ad infinitum.
  168.  
  169. Use as follows:
  170.  
  171.     RUN RX GOD >godlog        ;capture all output in file 'godlog'
  172.  
  173.  
  174.  
  175. 3. Internals:
  176.    ----------
  177.  
  178. 3.1 Command Line Options
  179.     --------------------
  180.  
  181. The CLI command template for MegaJitter is :
  182.  
  183. AUDIT/S,DATALOG/S,NOANIM/S,VISION/S,SEX/S,SHOWDEFAULTS/S,MAX_BUGS/K,
  184. INIT_BUGS/K,INIT_FOOD/K,INIT_ENERGY/K,INIT_VARIANCE/K,MUTATE_RANGE/K,
  185. FOOD_RATE/K,FOOD_ENERGY/K,X_AND/K,Y_AND/K,OASIS_SIZE/K,NTSC/S
  186.  
  187. For those not yet 100% familiar with the 2.0 DOS template syntax, here's
  188. a quick guide:
  189.  
  190. labels followed by:
  191.  
  192. /S mean that they are used on their own to enable some feature (a |S|witch)
  193. /K mean that they should be followed by a value (a |K|eyword)
  194.  
  195. Note: numerical parameters have lower and upper limits. See section 3.3 for
  196. figures.
  197. -----------------------------------------------------------------------------
  198. AUDIT        Enable full internal audit of creature processing.
  199.         This will show you (in the CLI window) what each particular
  200.         bug is doing, and sometimes, why.
  201.  
  202.         Example: MJ AUDIT NOANIM INIT_BUGS 1
  203.  
  204.         Default: AUDIT is OFF
  205.  
  206. -----------------------------------------------------------------------------
  207. DATALOG        Dumps the statistics in numerical form to STDOUT.
  208.         This is useful if you want to capture the statistics for
  209.         further analysis, like correlation of variables, etc...
  210.  
  211.         Example: MJ DATALOG NOANIM INIT_FOOD 1000 > MJ_RUN043.DAT
  212.  
  213.         Default: DATALOG is OFF
  214.  
  215. -----------------------------------------------------------------------------
  216. NOANIM        Inhibits the opening of the animation screen and lets the
  217.         program use a much more efficient representation for the
  218.         ecosystem, allowing faster simulations.
  219.  
  220.         Example: MJ NOANIM
  221.  
  222.         Default: NOANIM is OFF
  223.  
  224. -----------------------------------------------------------------------------
  225. VISION        Enables the VISION capability (gene) for all creatures.
  226.         With VISION on, creatures can SEE food and override their
  227.         genetic movement pattern somewhat so that they can home in
  228.         on food directly.
  229.  
  230.         Normally creatures are completely blind and rely on bumping
  231.         into food frequently enough to survive.
  232.         Vision gets modulated by the DAY/NIGHT oscillator.
  233.  
  234.         Example: MJ VISION AUDIT INIT_BUGS 35 OASIS_SIZE 20
  235.  
  236.         Default: VISION is OFF
  237.  
  238. -----------------------------------------------------------------------------
  239. SEX        Enables the SEXUAL reproduction gene for all creatures.
  240.