There are two main ways for you to create agents in your model. The traditional way is during setup, usually by generating a group, possibly loading data in from other sources. The second is via spawing which allows you to spawn an agent as the result of an action.
\nTypically you would simply need to register your agent class that is extended from an Agent and then generate via a group.
Simple Agent Creation (Java)
\npublic class MyModel extends AgentBasedModel<GlobalState> {\n @Variable int nbAgents = 100;\n\n @Override\n public void init() {\n registerAgentTypes(AgentA.class);\n }\n\n @Override\n public void setup() {\n Group<AgentA> group = generateGroup(AgentA.class, nbAgents);\n }\n}You can also via a lambda function specify parameters to an agent during it's creation
\nSimple Agent Creation (Java)
\npublic class MyModel extends AgentBasedModel<GlobalState> {\n @Variable int nbAgents = 100;\n @Input double infectionPerc = 0.3567;\n\n @Override\n public void init() {\n registerAgentTypes(AgentA.class);\n }\n\n @Override\n public void setup() {\n Group<AgentA> group = generateGroup(AgentA.class, nbAgents, agent -> {\n\t\tif (getContext().getPrng().getNextDouble() < infectionPerc) {\n\t\t\tagent.infected = true;\n\t\t}\n\t});\n }\n}This section deals with the spawning of individual agents from within other agents during the model run. For creating groups of agents with specific connections between them read the section on connection.
\nDuring the execution of an action, an agent can spawn a new agent. When spawning an new agent, a SpawnedVertex is returned, which is a reference that can be used for setting up links or sending messages to the new agent.
\nSpawning a new agent
\n SpawnedVertex spawnedAgent = agent.spawn(NewAgent.class);This method can only be called from within an action see Actions and Sequences. This example shows what this looks like from inside an action. The rest of the examples will not include the action, and assume all code is running from inside an action.
\nSpawning a new agent inside an action
\nclass Cell extends Agent<GlobalState> {\n public Action<Cell> spawnNewAgent() {\n return Action.create(\n Cell.class,\n agent -> {\n SpawnedVertex spawnedAgent = agent.spawn(NewAgent.class));\n }\n );\n }\n }When spawning agents, the dataInjector Consumer can be used to set up the agent with initial values. The dataInjector can also be used to create links from the agent.
\nSpawning a new agent with a data injector
\n //Create an agent with a link back to the agent that created it. \n SpawnedVertex spawnedAgent = agent.spawn(NewAgent.class, agent -> agent.addLink(agent.getID(), MyLink.class));When an agent spawns a new agent, it can also create a link to this spawned agent.
\nLinking to a newly spawned agent
\n SpawnedVertex spawnedAgent = agent.spawn(NewAgent.class);\n agent.addLink(spawnedAgent, MyLink.class);This link can be treated like regular links, except that you will not be able to get Link#getTo() for this link until the next timestep.
You will however be able to do treat it like your other links if you want to send a message along this link.
\nSending a message along a link to a spawned agent
\n SpawnedVertex spawnedAgent = agent.spawn(NewAgent.class);\n agent.addLink(spawnedAgent, MyLink.class);\n agent.getLinks(MyLink.class).send(MyMessage.class);This will create a new agent create a link to the new agent, and send MyMessage to the agent to be processed in the next timestep.
\nMessages can also be sent directly to a spawned agent.
\nSending a message to a spawned agent
\n SpawnedVertex spawnedAgent = agent.spawn(NewAgent.class);\n agent.send(MyMessage.class).to(spawnedAgent);