This is a reduced version of the manual page for this program

      CELLULAR AUTOMATA SIMULATOR ( Version 1.9A MAY 1993)
      ----------------------------------------------------

INTRODUCTION
------------
   This is another example of a  reasonably  serious  application
   written using the "Simple User Interface Toolkit" (SUIT).

   It follows on from my petri-net simulator which  was  released
   Nov 1992.

ABOUT
-----
   The program will not run very well (if at all) on a monochrome
   system.  it was designed for colour.

   The program has been compiled  and  tested  on  the  following
   architectures:
      486SX 25 PC 4MB RAM  TVGA8900C video  card,  running  Linux
      (99-9), Xfree86(1.2)

      Sun Micro-systems SPARCstation IPC, SunOS 4.1.1, X11R5.

FTPing
------
   The program sources and Sparc binaries can be obtained by  ftp
   from export.lcs.mit.edu in the directory  contrib/suit.

   This directory also contains other SUIT related  work  by  the
   author.

                     ** CELLULAR AUTOMATA **

INTERFACE
---------
    +-------------------------------------------------------------
    | ********************* TITLE BAR BUTTON ******************* |
    |ANALYSIS        +-------------------------------------------+
    |----------------|         |                                 |
    |                |  STEP   |                                 |
    |      CORE      |  GRID   |                                 |
    |                |         |                                 |
    |                |  CLEAR  |                                 |
    |----------------|  FILE   |                                 |
    |                |         |                                 |
    |     ACTIVE     |+-------+|                                 |
    |                ||       ||        G R A P H I C S          |
    |                ||       ||                                 |
    |----------------|| RULES ||                                 |
    |                || LIST  ||                                 |
    |     FIRED      ||       ||                                 |
    |                ||       ||                                 |
    |                ||       ||                                 |
    |----------------|+-------++---------------------------------+
    |  EXIT    STOP  |        rows  cols  states  **COLOUR_BAR** |
    +------------------------------------------------------------+

   The graphics area contains rectangular cells  which  can  have
   various  states. The state is incremented by clicking with the
   mouse, and decremented by pressing a key  when  the  mouse  is
   over the cell.

   To operate this program all you have to do is  draw  something
   in the graphics area, click on a rule, and see what happens.

   ...


RULES
-----
   The notation used relies upon the neighbours  of  the  current
   cell.

                      +------+--------+------+
                      |      |        |      |
                      |  NW  | North  |  NE  |
                      |      |        |      |
                      +------+--------+------+
                      |      |        |      |
                      | West | Centre | East |
                      |      |        |      |
                      +------+--------+------+
                      |      |        |      |
                      |  SW  | South  |  SE  |
                      |      |        |      |
                      +------+--------+------+

   The following rules have been implemented in this  release  of
   the simulator. (details in main man page)

   ANNEAL
   BRIANS_BRAIN
   CODD
   DIAMONDS
   4 WAY FILL
   8 WAY FILL
   GRAVITY
   GROWTH
   HGLASS
   LICHENS
   LIFE
   MAJORITY
   PARITY
   SQUARES
   TRIANGLES
   TUBE_WORM
   TUBE_WORM_2

BUGS
----
   I expect there are a few lurking  bugs  in  the  program.  Ive
   tried  to  remove  as  many  as  possible  and have had little
   problems using the software. But then every  author  says  the
   same.

   I've tried as much as possible to use ANSI C, I am unlikely to
   be  able  to solve any compilation problems that you may have.
   If you have a  problem  compiling  SUIT  then  please  get  in
   contact with SUIT support.

   Similarly I can't guarantee to fix  any  bug-reports  I  might
   get.  Although  as  a  budding software engineer (so I've been
   told) I guess I should make sure my software is as  free  from
   bugs as possible.

TODO
----
   If I had the time I would do the following things:


        Allow importing/exporting of cells, into the automata.

        Set/clear/move an area of the automata,

        Allow user defined automata rules,

        Give some online help.

        Provide a playback facility.

        Provide a "print" facility.

DISCLAIMER
----------

   The software is distributed  in  the  hope  that  it  will  be
   useful,  but  WITHOUT  ANY  WARRANTY; without even the implied
   warranty  of  MERCHANTABILITY  or  FITNESS  FOR  A  PARTICULAR
   PURPOSE.  See the GNU General Public License for more details.

   You should have received a copy  of  the  GNU  General  Public
   License  along  with this program (LICENSE) ; if not, write to
   the Free Software Foundation, Inc., 675 Mass  Ave,  Cambridge,
   MA 02139, USA.

SUIT
----
             SUIT -- The Simple User Interface Toolkit

   SUIT  is  a  library  of  interface  tools  developed  at  the
   University   of   Virginia   to   help  C  programmers  create
   sophisticated  mouse  based  interfaces  without  the  lengthy
   learning  period  associated  with  traditional user interface
   toolkits. Ease of learning and fast ramp up time is central to
   SUIT's design.

   Also central to SUIT  design  is  portability.  SUIT  programs
   currently  run  without  changes  to  the  source  code on the
   following platforms:

           IBM PC,  Macintosh, Sun3, Sun4 (SparcStation),
     SGI (Silicon Graphics IRIS workstations), DECstation, HP.

   SUIT    is    available    through    anonymous    ftp    from
   uvacs.cs.virginia.edu  (128.143.8.100). Each SUIT distribution
   package comes with full source code and documentation.

   SUIT, including all its  source  code,  is  available  without
   charge  to  Universities  and  other  non-profit institutions.
   For-profit   organizations,   and   people   requiring    more
   information can send email to

                    suit@uvacs.cs.virginia.edu


   SUIT (c) 1990, 1991 , 1992
   Copyright Rector and Visitors of the University of Virginia

THANKS
------
   Thanks go to the people  who  created  SUIT.  Without  them  I
   probably wouldn't have bothered writing this SUIT application.

   Thanks also go to the Joint Network  Team  at  the  Rutherford
   Appleton Laboratory for teaching me C.

   I must thank  Laser  Scan  Ltd,  for  giving  me  2  excellent
   placements and giving me a taste of the real world.

   How can I not mention the people at  Robert  Fleming  Ltd  for
   unknowingly starting me out on the computing trail.

THE AUTHOR
----------
   My  current  email  address  is   cs89ssg@uk.ac.brunel.   This
   certainly will not be the case after July 1993. I am likely to
   have an account on at least a public access  unix  site  so  I
   should be contactable via newsgroups after this date.

