================================= Todd's Agent-Based Simulator v0.6 ================================= Table of contents: 1. Current list of simulations 2. Current list of pre-configured simulations 3. How to run a simulation 4. List of commands and other controls 5. How to analysis a simulation run 6. Simulation descriptions 7. About+contact info 8. Version history -------------------------------------------------- 1. Current list of simulations: farm fish swarm smartfarm* hull* *= incomplete -------------------------------------------------- 2. Current list of pre-configured simulations: farm1 farm2 farm3 farm4 farm5 farm6 fish1 fish2 swarm1 swarm2 swarm3 smartfarm1 hull1 hull2 hull3 hull4 -------------------------------------------------- 3. How to run a simulation: To run a simulation type in the simulation name or the name of a pre-configured simulation and press enter. While the simulation is running you can pause the run by typing 'pause' then enter. To display the name and basic information of an agent click on the agent. See the list of commands below for other actions during a simulation. -------------------------------------------------- 4. List of commands agentcount Prints out the total number of active agents agentlist Prints out the entire list of active agents agenttotal Print out a total of each agent type autostop on Terminates simulation if agentcount > 10k autostop off Disables autostop background on Enables background display background off Disables background display clear Clears the console text debugmode on Turns debug text on debugmode off Turns debug text off help Prints out help information pause Pauses the simulation repaint Re-renders the screen sound on Enables all music and sound sound off Disables all music and sound soundeffects on Enables sound effects soundeffects offDisables sound effects stop Terminates the simulation run time Prints the current simulation time tracking clear Stops tracking the current selected agent trackingbox on Turns on the agent tracking box graphic trackingbox off Turns off the agent tracking box graphic log on Enables simulation logging log off Disables simulation logging (Fast) log clear Clears simulation log log print Prints the simulation log version Prints TABS version number Advanced commands: hidegui, showgui, hideconsole, showconsole, docbase Other controls: Click on an agent to display basic information, if more than one agent is at that location they will all be displayed. -------------------------------------------------- 5. How to analysis a simulation run To analysis a simulation run type 'log on' in the console before starting. When the simulation has ended, or after typing 'stop' in the console the simulation log can be displayed by typing 'printlog'. It may be helpful to clear the console window by typing 'clear' before displaying the log. -------------------------------------------------- 6. Simulation Descriptions farm : Simulates a predator-prey relationship between grass and cows. Cows eat grass to gain weight, and lose weight over time. Grass grows and multiplies at a certain rate, and is eaten by cows. fish : Fish eat smaller fish in their way. swarm : Simulates a gossip/social network and the spread of information. A set number of nodes start with "the data" and share it to other nodes that do not have "the data" within range. hull : Simulates the actions of soldiers trying to meet their individual demands of food, water, and shelter. Based on Hull's drive theory of variables affecting behavior. -------------------------------------------------- 7. About+contact info This agent-based simulator was created for educational purposes for the George Washington University Science and Engineering Apprenticeship Program (SEAP) during the summer of 2008. Created by Todd Watson email: todd@toadywonders.com or tmwatson@umd.edu -------------------------------------------------- 8. Version history Version 0.0 -includes three test simulations: fish, farm, and swarm Version 0.1 -added ability to pass parameters into a simulation through the console -added simulation log feature -added autostop feature -added help menu Version 0.2 (28 July 2008) -fixed start and pause can only be used during a simulation -added several preconfigured simulations -added Swarm_MobileAgent_Cow2 which eats based on its desired weight -added smartfarm1 simulation which uses Cow2 -added Swarm_MobileAgent_Hull based on Hull's theory -added Swarm_MobileAgent_Shelter for use with the Hull simulation -added Swarm_MobileAgent_Water for use with the Hull simulation -added hull preconfigured simulations -added sight range to hull agent -added feature to Swarm_MobileAgent_Grass to prevent reproduction -added a debug text mode -added GUI display when mouse is on simulation window -changed Swarm_MobileAgent_Node -added a max size option for Swarm_MobileAgent_Grass -change hidegui/showgui to hideconsole/showconsole -added hidegui and showgui -added two GUI modes -added side panel to track a specific agent, and other simulation info -added walking sprites -added tracking box around selected agent -added agenttotal command version 0.3 (29 July 2008) -added more AGENT_DISPLAY types -added background display modes with toggle on off console commands -fixed a few sprite glitches version 0.4 (30 July 2008) -added help text above open simulation list -changed font on buttons -changed button colors -added a drive level calculation for Swarm_MobileAgent_Hull -added a dynamic move speed for Swarm_MobileAgent_Hull from drive level -added more preconfig sims -added Tip of the Day! version 0.5 (31 July 2008) -fixed graphical glitches when paused -changed a few things for performance version 0.6 (12 August 2008) -comment cleaning and deleting -added music and sound effects to hull simulation with toggle commands -added sound effect to swarm simulation -added directory for image and sound files -changed most of the preconfigured simulations -added "simulation terminated" and "simulation initiated" sound effects -added "network complete" sound effect for swarm simulation