GIMMECore 1.6.5

GIMME (Group Interactions Management for Multiplayer sErious games) is a research tool which focuses on the management of interactions in groups so that the collective ability improves.

Welcome to the GIMME project repository

GIMME (Group Interactions Management for Multiplayer sErious games) is a research tool which focuses on the management of interactions in groups so that the collective ability improves. More specifically, what distinguishes the method is that the interactions between players are explicity considered when forming group configurations (also commonly named coalition structures). This repository contains the core of the application (written in Python), as well as some examples. Over time, we aim to improve the core functionalities as well as to provide more examples for the GIMME API.

Information about the API internals and examples can be observed in our wiki.

Requirements

GIMME requires Python 3 in order to be executed (Tested in Python 3.7.0). GIMME was tested on Windows and Linux. The tool may also work in MacOS, but remains untested in this platform.

Setup

GIMME setup is straightforward. You just got to install the python package via the repository:

pip install GIMMECore

Note: If some errors about libraries are prompted (for ex. numpy or matplotlib package not found), please install those packages as well, we are currently reimplementing some code parts, by which we do not ensure the requirements are updated to the last code version...

Then you can start to write programs with our library. When importing the package, it is recommended to use the following command:

from GIMMECore import *

This will automatically import all of the associated GIMME classes. Besides importing the core, the user has to also implement the functionalities to store data used by the algorithm. This is done by extending two abstract data bridges: the PlayerModelBridge and TaskModelBridge.

Execute an example

Some examples are provided as use cases of our package. To execute the provided examples, you just have to call python as usual, for instance:

python examples/simpleExample/simpleExample.py
python examples/simulations/simulations.py

Note: For just testing the code, it is advised to change the numRuns variable of simulations.py to a low value such as 10. For tendencies to be clearly observed when executing them, it is adviseable to set numRuns to 200.

This will output the data to a csv file examples/simulationResults/latestResults/GIMMESims/results.csv, summing the results of applying our simulations. Several plots summarizing the results can be built using the r code provided in examples/simulationResults/latestResults/plotGenerator.r.

Report on Latest Features

We have been writing a report about our latest features, currently available here in pre-print format.

Future Improvements

As of the current version, there are still some on-going exploration pathways. They include:

• The integration of more refined coalition structure generators (ConfigGenAlg);
• The integration of the tool in a multiplayer serious scenario (example/use case);
• The improvement of task selection.

Any help to improve this idea is welcome.

License

The current and previous versions of the code are licensed according to Attribution 4.0 International (CC BY 4.0).