The Java (TM) 2 Platform
Entomo (Or, How I Came To Love the Ant)
Copyright (C) 2001 Adrian Mummey, Brian Curry, Sachin Shah, Valerie Goulart


	Description
===============================================================================
Entomo, Greek for "insect", is a graphical simulation of swarming intelligence.
For further details please refer to:

http://counties.csc.calpoly.edu/~team_5fk/.

	Distribution
===============================================================================
A number of files should be supplied you in this compressed archive:

Entomo.sh, a UNIX shell executable.
Entomo.bat, a DOS batch executable.
Entomo.jar, a Java JAR distribution.
*.area, each an environment definition.
README.txt, this brief introduction.

	Requirements
===============================================================================
The Java VM, version 1.2.2 or greater, as provided in either the Java
Development Kit (JDK) or the Java Runtime Environment (JRE) is required for
execution of the simulation; this is available online at http://java.sun.com.

	Execution
===============================================================================
For UNIX platforms, simply execute the ".sh" script from a user shell prompt.
For Windows platforms, simply execute the ".bat" script from a command prompt.
Having done so, select the "File->Open..." menu item, choose any of the above
environment definitions (that is, a *.area file distributed in this package),
and click the "Play" button in the toolbar.  Please refer to the evaluation
criteria available online in the above URL for more specific functionality.

	History
===============================================================================
v0.03 (11/25/11):
1. Increased compatability with Java for UNIX.  Moreso unbeknownst to the
   author, it is not permissible to call the setVisible() method of a modal
   JDialog more than once in the lifetime of that dialog for some platforms.
   Dialogs are now created when requested (that is, when an appropriate menu
   item is chosen) and thereupon their memory promptly dropped on the floor.
2. Allowed resizability of dialogs.  Should the likelihood of 1. above failing
   on some platform for which the JDK is poorly implemented, this allows a
   marginal recovery--barring any segmentation faults from the JVM itself...
3. Made the Ant icon visible in its Legend label.  Previously, this label was
   curiously vacuous.

v0.02 (11/10/01):
1. Increased compatability with JDK 1.2.2.  Unbeknownst to the author, the code
   as implemented for the pack and resize of the "Tools->Define Rules..." and
   "Tools->Select Options..." modal dialogs failed to function properly under
   this all too decrepit runtime environment.  It stems, for the curious, from
   the JDialog superclass and all subclasses thereof not being registered as
   ComponentListener's with the event thread.  Gruesome.
2. Updated display of decaying pheromone each cycle.  Previously, pheromone did
   not appear to decay but simply "grow".
3. Optimized decay of pheromone each cycle.  Previously, every tile needed to
   be examined to find those whose pheromone needed to be decayed; now, only
   those tiles with pheromone present are operated upon.
4. Updated display of status panel after resting.  Immediately upon pausing,
   stepping, stopping or otherwise finishing a running simulation, labels in
   the the status panel are now updated.
5. Corrected spawning of ant agents after stopping.  Having stopped and then
   restarted, the size of the ant population no longer adds to what it was
   prior to stopping.
6. Added an edit field to the "Tools->Options..." menu allowing modification
   of the square dimension of the tiles as viewed in the playground.
   
v0.01 (11/07/01):
1. Initial release candidate.