{"data":{"markdownRemark":{"html":"

Actions and Sequences are used to define a sequence of actions for the agents to follow at every step, or at setup.

\n

A Sequence is a list of actions that are executed consecutively. Sequences are composable, which means a sequence can be a list of other sequences as well as actions. Multiple sequences can be run in a single setup() or step().

\n

Every sequence needs to be run in order for the sequence to be executed.

\n

Creating and running an empty Sequence (Java)

\n
public class MyClass extends AgentBasedModel<GlobalState> {\n  ...\n\n  run (Sequence.create())\n\n  ...\n}
\n

Actions have to be created for a specific class. It is best practice to create actions inside the class of the Agent the action is being defined for.

\n

When creating an action, two parameters need to defined.

\n
    \n
  1. The agent that will execute this action
    2. \n
  2. The function to be executed by the agent
    3. \n
\n

Creating actions and adding them to a sequence (Java)

\n
public static Action<AgentA> sendMessageToAgentB =\n  Action.create(\n    AgentA.class, agentA -> { /** send message */ });\n\npublic static Action<AgentB> recieveMessage =\n  Action.create(\n    AgentB.class, agentB -> { /** recieve message */ });\n\nrun (\n\tSequence.create(\n  \tsendMessageToAgentB,\n  \trecieveMessage\n));
\n

The 'run' method can also take a list of actions which it will execute as though its a sequence, so the above code could also be written like this.

\n

(Java)

\n
public static Action<AgentA> sendMessageToAgentB =\n  Action.create(\n    AgentA.class, agentA -> { /** send message */ });\n\npublic static Action<AgentB> recieveMessage =\n  Action.create(\n    AgentB.class, agentB -> { /** recieve message */ });\n\nrun (\n  \tsendMessageToAgentB,\n  \trecieveMessage\n);
\n
\n

On the type of data supported

\nAn action will only be executed by an agent if that agent has received a message. If an action needs to be executed by all agents of a type, even if some of those agents have not received a message, this action needs to be at the beginning of a new sequence.\n
\n

Message passing(Java)

\n
//If AgentB isnt sent message, it will not do other processing\nrun (\n  Sequence.create(\n    AgentA.conditionallySendMessage(),\n    AgentB.recieveMessageActionAndDoOtherProcessing())\n  ),\n\n  //Split other processing into another sequence to ensure all AgentB do processing\n  Sequence.create(\n    AgentA.conditionallySendMessage()),\n    AgentB.recieveMessageAction())\n  ),\n\n  Sequence.create(\n    AgentB.doOtherProcessing())\n  )\n);
\n
\n

Messages cannot be passed between sequence runs

\nAll message passing and receiving needs to be done within a single sequence run. (This does not apply to sequences that are composed of other sequences, messages will be passed between sequences called from inside another sequence.)\n
\n

Message passing (Java)

\n
//Message will be passed from AgentA to AgentB\nrun (\n  Sequence.create(\n    Sequence.create(AgentA.sendMessageAction()),\n    Sequence.create(AgentB.recieveMessageAction())\n  ),\n\n  //Message will NOT be passed from AgentA to AgentB\n  Sequence.create(\n    AgentA.sendMessageAction())\n  ),\n\n  Sequence.create(\n    AgentB.recieveMessageAction())\n  )\n);
\n

Executing Action in Parallel

\n

In all the sequences we have shown until now, the actions happen one after the next, like in the following diagram.

\n

\n \n \n \n \n \n \n \n \n \n \n \n \n \n

\n

It is also possible to have two actions happening at the same time, as in the diagram below. Here, AgentA can send a message that both AgentB and AgentC receive and process at the same time. They can then both send a message to AgentA to process.

\n

\n \n \n \n \n \n \n \n \n \n \n \n \n \n

\n

Put the actions that need to happen in parallel in a split.

\n

Split (Java)

\n
run (\n    AgentA.doAction1(),\n    Split.create(\n      AgentB.doAction1(),\n      AgentC.doAction1()\n    ),\n    AgentA.doAction2())\n);
\n

It is also possible to want to do several actions in parallel, or sequences of their own in parallel.

\n

\n \n \n \n \n \n \n \n \n \n \n \n \n \n

\n

Multi-Split(Java)

\n
run (\n    AgentA.doAction1(),\n    Split.create(\n      AgentB.doAction1(),\n      Sequence.create(\n        AgentC.doAction1(),\n        AgentB.doAction2()\n      )\n    ),\n    AgentA.doAction2())\n);
\n

The sequence on which actions will be processed in this case is

\n
    \n
  1. AgentA process action1,
    2. \n
  2. AgentB and AgentC process action1
    3. \n
  3. AgentB process action2
    4. \n
  4. AgentA process action2 (having received messages from both AgentB and AgentC)
    5. \n
\n
\nIn all the examples above, doAction includes sending a message to the next agent in the sequence\n
\n
\n

Best Practice

\nIn cases where there are sequences inside splits, or splits inside splits, the model will be a lot easier to work with if sequences and splits were created as variables\n
\n

(Java)

\n
// nested sequence removed and created as a variable\nprivate Sequence agentCActions =\n  Sequence.create(\n    \tAgentC.doAction1(),\n      AgentB.doAction2()\n    )\n\n// main sequence is now easier to read\nrun (\n  Sequence.create(\n    AgentA.doAction1(),\n    Split.create(\n      AgentB.doAction1(),\n      agentCActions\n    ),\n    AgentA.doAction2())\n  )\n);
\n

It is possible to compose sequence's and actions to create the complex sequences as needed. Example of more complex sequence - with a sequence inside a sequence.

\n

\n \n \n \n \n

Registering messages

\n

(Java)

\n
public class MyClass extends AgentBasedModel<GlobalState> {\n  ...\n  registerMessageTypes(Boolean.class, Messages.Vacancy.class);\n  ...\n}
\n

Sending Messages

\n

All message sending is done by the agents, and so can only be done from inside an agent class.

\n

Sending messages to links

\n

broadcastMessage is used to send messages to an agent's links, with the first parameter being the message body.

\n

In the examples below, the message being sent is always of type Boolean, because the only information to be sent is if the Cell is alive or not.

\n

(Java)

\n
public class Cell extends Agent<GlobalState> {\n  public boolean alive = false;\n\n  public Action<Cell> sendAliveMessage() {\n    return Action.create(Cell.class, cell -> {\n      // send message to all links\n      cell.broadcastMessage(cell.alive);\n\n      // send message only to links of specific type\n      cell.broadcastMessage(cell.alive, OtherAgent.class);\n    });                        \n  }\n}
\n

An example of sending a message with a more complex body might be a case where there is more than one piece of data to send in a message.

\n

(Java)

\n
public class Cell extends Agent<GlobalState> {\n  public boolean alive = false;\n  public int age = 0;\n\n  public Action<Cell> sendAliveMessage() {\n    return Action.create(\n      Cell.class,\n      cell -> {\n        cell.broadcastMessage(new CellStatus(cell.alive, cell.age));\n      }\n    );\n  }\n}\n\npublic class CellStatus {\n  public CellStatus(boolean alive, int age) {}\n}
\n

Sending messages to agent without a link

\n

If an agent has the id of another agent (even if it is not directly connected/linked to this agent in any way), it can send it a message using sendMessage.

\n

To get the id of an agentB that isn't connected to agentA via a link, send the id of agentB to agentA via a message.

\n

(Java)

\n
public class Cell extends Agent<GlobalState> {\n  public boolean alive = false;\n  public Action<Cell> sendAliveMessage() {\n    return Action.create(\n      Cell.class,\n      cell -> {\n        cell.sendMessage(cell.alive, someId);\n      }\n    );\n  }\n}
\n

Receiving Messages

\n

Receiving messages is driven by message type. An agent has to specify what type of message they are expecting, in order to get those messages.

\n

For getting a single message. If there are multiple messages of this type, it will return one of them (at random).

\n

Receiving Messages (Java)

\n
class Cell extends Agent<GlobalState> {\n  public Action<Cell> getAliveMessage() {\n    return Action.create(\n      Cell.class,\n      cell -> {\n        Message<Boolean> isAliveMessage = cell.getMessageOfType(Boolean.class);\n        boolean isAlive = isAliveMessage.getBody();\n      }\n    );\n  }\n}
\n

If expecting multiple message of a particular type use getMessagesOfType. This will return the messages in a List.

\n

Receiving a List of Messages (Java)

\n
class Cell extends Agent<GlobalState> {\n  public Action<Cell> getAliveMessage() {\n    return Action.create(\n      Cell.class,\n      cell -> {\n        List<Message<Boolean>> aliveMessages = cell.getMessagesOfType(Boolean.class);\n        long count = aliveMessages.stream().filter(Message::getBody).count();\n      }\n    );\n  }\n}
\n

hasMessage can be used to check if a message of a particular type has been received.

\n

Checking for messages of given type (Java)

\n
class Cell extends Agent<GlobalState> {\n  public Action<Cell> getAliveMessage() {\n    return Action.create(\n      Cell.class,\n      cell -> {\n        Boolean hasAliveMessage = cell.hasMessageOfType(Boolean.class);\n      }\n    );\n  }\n}
\n
\n

Replying to a message

\nUse getSender on a message to get the id of the agent who sent the message, and use that id with sendMessage to send a message back to sender.\n
","headings":[{"value":"Executing Action in Parallel","depth":3},{"value":"Messaging Semantics","depth":3},{"value":"Message Types","depth":3},{"value":"Sending Messages","depth":3},{"value":"Sending messages to links","depth":4},{"value":"Sending messages to agent without a link","depth":4},{"value":"Receiving Messages","depth":3}],"frontmatter":{"title":"Actions and Sequencing","toc":null,"experimental":null}},"site":{"siteMetadata":{"title":"Simudyne Docs","latestVersion":"2.6"}}},"pageContext":{"absolutePath":"/home/vsts/work/1/s/content/2.0/reference/agents/actions-and-sequencing.md","versioned":true,"version":"2.0","kind":"reference","pagePath":"/reference/agents/actions-and-sequencing","chronology":{"prev":{"name":"Topologies","path":"/reference/agents/topologies"},"next":{"name":"Reporting","path":"/reference/agents/reporting"}},"lastUpdated":"2026-04-21T13:56:54.826Z"}}