Agent group

An Agent Group handles a group of Agents and their behaviours.

Each Agent has a dependency graph which builds the pose of the agent at each frame and a variable set of custom data that we call Metadata. Metadata can be attached to almost every Atoms entity. Agents are just one of them. For a full list of metadatas, please check this section.
Users can assing Behaviour modules to each Agent Group to customize their simulation. During the simulation Behaviour modules will edit the Agents dependency graph or their metadata, this will make them behave differently. The modules are evaluated in order. So if you place a "follow curve" curve module before an "agent avoidance module", Atoms evaluates the "follow curve" first. For a full list of Behaviour modules and their parameters, please check this section.

Add a behaviour module

Maya

From the Behaviour module list press the "Add button" to add one form the list of available modules.

Houdini

From the Behaviour module list choose a module

Is it possible to disable a module without removing it from the list using the checkbox next to the module name. You can remove or move a module up or down in the list using the 3 buttons on the bottom

The first module to add must be a layout module. Atoms has several layout module ("gridLayout","pointsLayout","cacheReader",etc...). These modules creates agents inside the agent group during the simulation. After a layout module you can add an animation module ("clipReader", "stateMachine", etc...). These modules add animation to the agents creating the network of nodes to rean animation clips inside the agent dg network. After them you can add all the other modules to drive the agents or set metadata.

Edit Behaviour module attributes

Maya

Select a module from the Behaviour module list and in the "Behaviour module Options" panel you can edit its attributes. These attributes are normal maya attributes so they can be animated and connected to other nodes

Houdini

Select a module from the Behaviour module list and in the "Behaviour Modules" tab you can edit its attributes. These attributes are normal houdini parameters so they can be animated and connected

Some attributes can be edited per agent usign the "Agent Override dialog". You can open the dialog using button on the right of the attributes that can edited.