libadapt

A generic framework to add adaptivity to game-based learning (GBL) applications

About

This library implements the following architecture:

              +-----------------------------+
              |                             |
              |                             v
              |                         Measured Variables
              |                             |
              |                             | Value                                  Algorithmical Optimisation
              |                             v                                      /
Player -> Interaction    Evaluation <-  Adaptation Function <- Reference Progress <- Author
              ^                             |                                      \     |
              |                             |                                        Mean Values from Test Series
              |                             v                                            |
              |                         Adaptation Threshold <---------------------------+
              |                             |
              |                             v
              |                         Evaluation and Decision-making
              |                             |
              |                             | Goal-oriented Changes
              |                             v
              |                         Manipulated Variables
              |                             |
              +-----------------------------+

Adaptor.adapt_to() should be called from the main loop of an interactive application with updated measurement to base the adaptation on.

The internal calling order is:

Adaptor.adapt_to()

    Adaptor.quantify()

    Adaptor.log()

    Adaptor.compare()

    Adaptor.check_threshold()

    Adaptor.intervene()

It is based on an architecture first published in:

Florian Berger. Evaluating an implementation of an adaptive game-based learning architecture. In Proceedings of UMAP 2012, 2012

Prerequisites

Python http://www.python.org

Installation

Unzip the file, then at the command line run

python setup.py install

Documentation

To read the API documentation, open a shell / DOS window, navigate to the libadapt directory, and run

pydoc libadapt

You can create a HTML version using

pydoc -w libadapt