alfred3-interact 0.1.6

Components for interactive experiments in the alfred3 framework.

alfred3-interact: Interactive web-experiments in alfred3

Alfred3-interact is a plugin for alfred3. It allows for the creation of interactive web experiments, predominantly in the social sciences. As prerequisites, you need to have Python 3.7 or newer and alfred3 v2.0 or newer installed.

Installation

$ pip3 install alfred3_interact

Documentation

Documentation for alfred3_interact is avaialable here: Link to docs

Quick example

Below is an example script.py for creating an experiment with an asynchronous exchange of data between participants via stepwise matching:

1. Initialize the MatchMaker during experiment setup
2. Find a group via MatchMaker.match_stepwise and bind it to the experiment plugins object.
3. Now the group object is available in sections, pages, and elements through the experiment session object. You can use it to access data from other participants in the same group.

# script.py
import alfred3 as al
import alfred3_interact as ali

exp = al.Experiment()

@exp.setup
def setup(exp):
    mm = ali.MatchMaker("role1", "role2", exp=exp)
    exp.plugins.group = mm.match_stepwise()


@exp.member
class Success(al.Page):
    title = "Match successful"

    def on_exp_access(self):
        group = self.exp.plugins.group

        txt = f"You have successfully matched to role: {group.me.role}"
        self += al.Text(txt, align="center")

if __name__ == "__main__":
    exp.run()

The demo experiment can be started by executing the following command from the experiment directory (i.e. the directory in which you placed the script.py):

$ alfred3 run

Citation

Alfred3-interact was developed for research at the department for economic and social psychology, Georg-August-University Göttingen. If you are publishing research conducted using alfred3, the following citation is required:

Brachem, J. & Treffenstädt, C. (2021). Alfred3-interact - Interactive web experiments in alfred3. (Version x.x.x). Göttingen, Germany: https://doi.org/10.5281/zenodo.1437219