home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / TIERRA40.ZIP / DOC / TIEOUT.DOC < prev    next >
Text File  |  1992-09-11  |  3KB  |  82 lines

  1.                         TIERRA Log File Filter
  2.                                - TIEOUT -
  3.                             by Daniel Pirone
  4.  
  5. PURPOSE:
  6.  
  7.    This document describes a software tool that aids in the analysis of 
  8.  log files from the Tierra Artificial Life Simulation (1).  Given a log file,
  9.  and 2 parameters, TIEOUT will produce an X,Y list from the log.
  10.  
  11. THE INTERFACE:
  12.  
  13.    The TIEOUT user interface is a simple command line driven system. 
  14.  All of the menu options are Case Sensative (Turn Caps Lock Off).
  15.  Running TIEOUT with no options will produce the following help message:
  16.    
  17. > syntax:  tieout infile xfield yfield 
  18.  
  19.  From this we see that you must provide at least 3 parameters:
  20.  
  21.    - infile , the first param, specifying an existing path and tierra log
  22.      filename ( eg tierra.log ).  A '-' in place of a filename, indicates
  23.      that TIEOUT should use the keyboard (stdin) as input.
  24.    - xfield , the second param, specifying the 2 character symbol to be
  25.      used as first (X) search field ( eg 'ie' ).
  26.    - yfield , the third param, specifying the 2 character symbol to be
  27.      used as second (Y) search field ( eg 'ex', 'as' ). Due to its chaotic
  28.      nature, the 'ex' field may ONLY be used as the seond param.
  29.  
  30.  Normally, the output list is printed to the screen (stdout).  Some examples 
  31.  of use are:
  32.  
  33. > tieout tierra.log ie ex > ex_out
  34.  
  35.    The example above will produce a list of all Tierra gene extractions,
  36.  a very useful measure of diversity.  This list is redirected to a file
  37.  called ex_out.
  38.  
  39. > tieout - ie as > as_out < tierra.log
  40.  
  41.    The example above will produce a list of the Average Size of the genomes,
  42.  as a function of time.  Note that we use the '-' as the filname here, only
  43.  as an example.  In general the '-' infile is best when using TIEOUT
  44.  in a complex stream piping situation.
  45.  
  46. > tieout tierra.log ie as 
  47. >
  48. > "ie_as
  49. > 0 80
  50. > 1 79
  51. > 2 79
  52. > 3 73
  53. > 4 67
  54. > 5 60
  55. > 6 59
  56.  
  57.    The example above will produce a list of the Average Size of the genes,
  58.  but this time, the X,Y data is simply printed to the screen.  The first
  59.  column (X) is the values of 'ie' ( millions of instructions executed),
  60.  and the second (Y) column is the next occurence of 'as' found after the 'ie'.
  61.  In the special case of 'ex' as the Y parameter, if another extraction is
  62.  found before the next X parameter is, the previous value of X is used in the
  63.  printing.  This allows for multiple extraction per million.  No other
  64.  parameter is recorded this frequently.
  65.  
  66.    Note the label is a concatenation of the X and Y parameters.  Also note
  67.  the blank line before the label.  This allows the output to be easily sent
  68.  to a graphing tool ( eg: xgraph ).
  69.  
  70.    Please send bug reports to : tierra-bug@life.slhs.udel.edu
  71.  
  72. -----------------------------------------------------------------------------
  73.  
  74. (1) Tierra is available by anonymous ftp from:
  75.  
  76. tierra.slhs.udel.edu ( 128.175.41.33 )
  77.  
  78. or on disk by mail from Virtual Life, P.O. Box 625, Newark, DE 19715.
  79. Make check for $65 payable to Virtual Life, and specify 3.5" or 5.25" disks.
  80.  
  81. -----------------------------------------------------------------------------
  82.