A library for rapid development of dynamic and interactive online experiments in the social sciences.
Project description
Welcome to alfred3 |zenodo|_
alfred3 - a library for rapid experiment development
Alfred3 is a package for Python 3 offering experimenters in the social sciences a fast and easy way to create truly dynamic computer experiments for a wide range of applications. See http://www.the-experimenter.com/framework for more information.
Installation
If you have Python 3.7 or newer installed, just install alfred3 via pip::
$ pip3 install alfred3
A detailed step-by-step guide is available here:
A "Hello, world" experiment
Creating a hello-world experiment is as easy as writing this script.py
file. You can even do it in a simple text editor. Note that the file
must be named script.py
::
# script.py
import alfred3 as al
exp = al.Experiment()
exp += al.Page("Hello, world!", name="hello_world")
To run the script, open a terminal and change the working directory to your experiment directory::
$ cd path/to/experiment
Next, simply execute the folling command in the terminal::
$ alfred3 run
If you have Google Chrome installed on your machine, a browser window
with the experiment opens automatically. Otherwise, open any webbrowser
and visit http://127.0.0.1:5000/start
to start the experiment.
Of course, this "Hello, world" experiment does not contain much content: Only a single page with a heading. To learn how to add content to an experiment, visit our tutorials: (to be filled)
Citation
.. important::
**If you are publishing research conducted using alfred3, the
following citation is required:**
Treffenstaedt, C., Wiemann, P. & Brachem, J. (2020). Alfred3 - A
library for rapid experiment development (Version 1.x.x). Göttingen,
Germany: https://doi.org/10.5281/zenodo.1437219
A note on the version number
Alfred3 is currently at version 1.x.x, because it is already in use for research. However, it does currently lack comprehensive documentation and automatic unit testing. Also, some of its most powerful extensions are not currently publicly available. Currently, we lack the resources to upgrade our documentation and testing capacities, focusing mainly on maintaining the current state of the library.
If you want to use alfred3, please contact us via alfred@psych.uni-goettingen.de.
alfred3 Mailing List
If you want to stay up to date with current developments, you can join
our mailing list
_.
We use this list to announce new releases and spread important
information concerning the use of Alfred. You can expect to receive at
most one mail per month.
.. |zenodo| image:: https://zenodo.org/badge/150700371.svg .. _zenodo: https://zenodo.org/badge/latestdoi/150700371 .. _mailing list: https://listserv.gwdg.de/mailman/listinfo/Alfred
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for alfred3-2.0.0b2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 21e3880a5f9ee75387b8b4c3eff959915de392fb7c863b8dd64d8b9ad5a12c47 |
|
MD5 | ebf817c56dd74d233e7c44f7398da9b2 |
|
BLAKE2b-256 | f19eb89d84452eb49f682f5043389009be25de10d576abda3fec31b7a8854dbe |