Navigation Bar AgentSheets Education R&D Support About Us Manuals Tutorial Movies FAQ Books Classes

Worksheet

Description: AgentSheets worksheets come equipped with a toolbar along the left side of the window, a set of buttons at the bottom, and a message area right above the buttons. The tools are described below.
The Arrow Tool

The Arrow Tool drags agents around within a worksheet and selects agents. To move an agent, click and hold on the agent and move the mouse to the desired location. Once you release, the agent is in the designated place in the worksheet. Also, use the Arrow Tool to select agents in the worksheet by single-clicking them.

    Power User Shortcut

    When permissible, you can right-click on an agent in the worksheet using the Arrow Tool to change its depiction, assuming the agent has more than one depictions defined in the gallery. A pop-up menu with the list of available depictions appears as shown below for the Person agent. You can then choose the depiction you wish to change to.

The Pencil Tool

The Pencil Tool adds agents to a worksheet. To use the Pencil Tool, select an agent's depiction in the gallery and, in the worksheet, click where you would like the selected agent to be placed.

The Eraser Tool

The Eraser Tool erases instances of an agent in the worksheet. Click on an agent with the Eraser Tool to make the agent disappear.

The Hand Tool

The Hand Tool is user-defined. Agents can be programmed to respond to the Hand Tool using the Tool trigger found in the Tools | Triggers Palette. If the Hand Tool is not specifically programmed for an agent, applying that tool on that agent just gives a warning in the worksheet's message area: 'I don't know how to respond to the "operate_on" message'.

The Hammer Tool

The Hammer Tool is user-defined. Agents can be programmed to respond to the Hammer Tool using the Tool trigger found in the Tools | Triggers Palette. If the Hammer Tool is not specifically programmed for an agent, applying that tool on that agent just gives a warning in the worksheet's message area: 'I don't know how to respond to the "whack" message'.

The Draw Rectangle Tool

The Draw Rectangle Tool places multiple agents in a worksheet. Like the Pencil Tool, the Draw Rectangle Tool requires that an agent in the current gallery be selected. The Draw Rectangle Tool creates a box that expands as a user clicks and drags within a worksheet. Once the mouse is released, the designated rectangular area is filled with instances of the selected agent.

The Erase Rectangle Tool

The Erase Rectangle Tool erases multiple agents in a worksheet. It creates a box that expands as a user clicks and drags within a worksheet. Once the mouse is released, the top-layer agents in the designated rectangular area are erased.

The Question Mark Tool

The Question Mark Tool provides the position and name of the agent on which it is applied. To use the tool, click an agent in the worksheet. You will see the following message appear on the worksheet's message area.

The example is the result of clicking a Digit agent in the Benchmark simulation using the Question Mark Tool and shows the current position of the Digit.

The Stop Button

The Stop button stops the simulation, if it is running in the worksheet.

The Run Button

The Run button starts the simulation, if it is not already running in the worksheet. When the simulation is running, all agents with a While Running method execute the behavior defined in that method.

The Step Button

The Step button executes one simulation cycle each time it is clicked.

The Reset Button

The Reset button resets the worksheet to the last saved version.

The Clear Button

The Clear button clears the worksheet. If the worksheet contains a background, it does not get removed. Use File | Remove Background to remove a background.

Simulation Speed Control Slider

The Simulation Speed Control Slider, shown below, enables you to control the speed with which your simulation is running. Set the slider to "Fast" for running your simulation in full-speed, to "Slow" for the slowest possible execution of your simulation, or to any value in between as you see fit for your simulation.

Worksheet Message Area

The worksheet Message Area, shown below, prints text message from the system (e.g. when a worksheet is loading), from the running simulation (e.g. from the Say action), or from user interactions (e.g. from applying some worksheet tools on agents in the worksheet).


reference manual | ©2010 AgentSheets, Inc. | contact us