Laying out agents

Grid layout

The grid layout creates a grid of agents.

Create an agent group, please make sure the attribute editor is visible and the agent group node is selected.

Click on the "Add" button and add a gridLayout module. Type the agent type name you entered previously in the "agentType" field (i.e. testRobot). 
Set the "size" field to (3,1,3). Click again on the "Add" button and add a stateMachine module. 

Click on Maya time slider rewind button and your 9 agents will appear in the viewport.
Hit the play button to run the simulation.

Points layout

With the points layout you can choose the exact location where the agents must be created.

Create an agent group, please make sure the attribute editor is visible and the agent group node is selected.

Click on the "Add" button and add a pointsLayout module.
Click again on the "Add" button and add a stateMachine module. 
Rewind.

Select the pointLayout module from the module list and open click on "Agent Layout Tool" button (alternatively you can open the layout tool from the menu Atoms->Tool->Agents Layout Tool). The tool layout widget will appear. Then press R or press the  icon, move the mouse over the viewport. A green circle with an arrow indicates where you are going to create an agent and its direction. Press the LMB to create an agent. To change direction press CTRL+LMB and move the cursor on the left or on the right. You can creates multiple agents at once by pressing the icon or RMB → Layout → Grid.

After creating some agents we can still edit their position, direction and change their agent type. Press the Q button or use the icon, select some agents. Then press the W button or the icon and use the move manipulator to move the agents in the scene. To rotate the use the E button or the icon.

From the tool UI or from the context menu (RMB button) you have access to more action for each different mode. For example, go back to the selection mode and from the UI (or from the context menu) press "delete agents" to delete them. An option for changing the agent type is also available.

Mesh scatter layout

The mesh scatter layout creates randomly agents on a input mesh.

Create a plane, and scale it to 2000,1,2000

Create an agent group, please make sure the attribute editor is visible and the agent group node is selected.

Click on the "Add" button and add a meshScatterLayout module. Type the agent type name you entered previously in the "agentType" field (i.e. testRobot). 
Set the "radius" field to 150. Set the mesh to "pPlane1". Click again on the "Add" button and add a stateMachine module. 

Click on Maya time slider rewind button and your agents will appear in the viewport.
Hit the play button to run the simulation.

Curve layout

The curve layout creates agents along an input curve.

Create a curve, so that it can fit several agents.

Create an agent group and add a curveLayout module and a stateMachine module.
Set the curve you created inside the "curve" attribute of the curveLayout module .

Click on time slider rewind button and your agents will appear in the viewport.
Hit the play button to run the simulation.