You can install the I-DAIR ABM by either downloading the pre-built binary package or manually build on Pharo 9 system from the source repositories. Unless you are a Pharo developer, pre-built binary package would be a handy approach.
You can download executable applications from our release page
- Download Pharo 9 from the Pharo project.
- Install Cormas v0.5 from The Cormas project following their instructions.
- The I-DAIR ABM requires Roassal3 v1.0 from The Roassal3 project. Cormas v0.8 also installs Roassal3, but the installation process sometimes fails to install the correct version. Please reload Roassal3 v1.0 if it's not cleanly installed.
- Add this repository to Iceberg and load the Cormas-Model-IDAIR package.
- Don't forget to save the image.
- Enjoy!
This ABM is designed to be used in a RPG (Role-Playing Game) developed in the I-DAIR project. Operations on UIs are described below.
-
Launch an ABM
If you open the ABM application, a desktop window, like the above, will appear. To launch an ABM, click at the I-DAIR menu (pointed by the red arrow in the fig).
-
Setup a game
Enter the names of citizen players in the RPG. If your citizen players are less than 6, leave the excessive fields blank. You can also change the numbers of initial mild/severe patients according to the RPG settings. Press the OK button if all is set.
-
Setup the gamemaster's view and the public view
An window with two tabs will occupy the ABM desktop. One tab, chosed by default, is labeled Game Master, and another is Public View. The public view can be spawned to another window outside the ABM desktop by clicking at the window button
at the right-bottom corner.
If you use a large screen or a projector to share the ABM with the players, spawning the public view and show it in the screen would be a good idea. -
Operate on the gamemaster's view
The gamemaster's view consists of four columns: the citizen's action, the hospital manager's action, the policymaker's action, and graphs. In the RPG, each citizen player has well-being points (wbp), which increase or decrease depending on the action card that the player drew and whether the player do the action or not. The gamemaster selects a player in the upper list and the player's action card in the lower list. If the player choose to do the action, the gamemaster presses the YES button. If the player does not, the gamemaster presses the NO button.
The second column shows the hospital manager's actions, and the third shows policymaker's action. The lower list of policymaker's column shows actions that the policymaker can take. Some actions are shown with hand icons, which means a poll is required. If a policymaker player choose an action that requires a poll, the action will be appended into the upper list. The gamemaster can enter the conformance rate for the policy at the next round.
The fourth and the right-most column visualises the current status of the disease and hospital beds. The gamemaster advises players and moves marbles refering to the visualised data.
-
Operate on the public view
The public view overviews the current status of the RPG, including how the disease is spreading and how the citizen is living in the situation. The large graph labeled Course of the situation shows the trends of populations for each medical condition: susceptible, infected, recovered, and dead, as well as the numbers of the occupied regular beds and the occupied ICUs. The three graphs in the lower row shows the player's status and responses to the implemented policy.
-
Operate on the simulation control bar
In order to simulate the spread of disease, the ABM assigns 100 citizen agents for each citizen players and have them do the same actions that the citizen player. As a result, the more the risky actions the citizen players take, the more the disease spread in the ABM.
The gamemaster can proceed the simulation with the citizen agents act as the citizen players' decisions by pressing the run button.