The Model is the main abstraction in the Simudyne SDK. It incorporates all the elements required to build and run a simulation from setup to teardown.
The Model Interface below outlines three stages. Let's describe them as well as the model flow in more detail.
\n
One iteration in your simulation involves a set of steps. At this stage, you need to specify calculations in your model to form a step. These are then run in order to complete one iteration of your simulation.
Defining a step (Java)
\npublic class MyModel implements Model {\n @Variable int myVariable = 1;\n\n @Override\n public void step() {\n myVariable *= 1.1;\n }\n}Each model requires a setup phase. In the Model Interface diagram this occurs at setup() between the console and the model.
Nothing happens in this setup phase by default but you can trigger a specific setup by defining calculations and operations at Model#setup().
Specifying a setup (Java)
\npublic class MyModel implements Model {\n @Variable int myVariable;\n\n @Override\n public void setup() {\n SeededRandom ran = new SeededRandom();\n myVariable = ran.uniform(-1,1).sample();\n }\n\n @Override\n public void step() {\n myVariable *= 1.1;\n }\n}On completion of your simulation, you may want to save results as a file or to perform specific tear-down operations. This can be done by defining dispose() in your model.
From the model, you can get access to the ModelConfig. This ModelConfig contains the set of values for the parameters of the model. These specific settings within your simulation are important especially when it comes to distributing your model.
To create Agent Based Models, extend AgentBasedModel.
AgentBasedModels (Java)
\npublic class MyModel extends AgentBasedModel<GlobalState> {\n @Variable int myVariable;\n\n @Override\n public void setup() {\n SeededRandom ran = new SeededRandom();\n myVariable = ran.uniform(-1,1).sample();\n }\n\n @Override\n public void step() {\n myVariable += 1;\n }\n}Several setup operations are required for AgentBasedModel at the first stage of building the simulation model. These have to be defined at setup().