README

CitizenSocialLab: urGENTestimar

Experiment designed and implemented to be performed in FiraTarrega 2017 during the performance urGENTestimar.

This participatory experiment consist on a set of dilemmas presented as behavioural games: Prisoner's Dilemma, Snowdrift Game and Dictator's Game designed to shed light on the concerns of citizens and collectives of Tàrrega. There are two Prisoner's Dilemma with sharing different basic resources (Bread and Water), one Snowdrift (doing the action of Kissing) and one Dictator's Game (sharing Fruit with others), all these games are played by 2 individuals.

Data

Vicens J, Cigarini A, Perelló J. Dataset urGENTestimar. 2018. doi:10.5281/zenodo.1308978

Derived Scientific Publications

Cite main publication: Vicens, J., Perelló, J., & Duch, J. (2018). Citizen Social Lab: A digital platform for human behaviour experimentation within a citizen science framework. arXiv preprint arXiv:1807.00037.

More publications currently in preparation.

Configuration

Steps are necessary to get urGENTestimar install, up and running in local network.

Creation of the project

Database MySQL
Create MySQL database: name_db
Create user database: user_db
Create password database: pass_db

Introduce this information about the database in: /urGENTestimar/settings.py

Environment
mkvirtualenv urgentestimar

Requirements
pip install -r requirements.txt

MongoDB
mongod --dbpath /.../urGENTestimar/ddbb

Load text
File with text and translations: /.../urGENTestimar/game/i18n/translations.xlsx

python excel_to_mongodb.py

Run Server
python manage.py runserver localhost:port

Migrations
python manage.py makemigrations
python manage.py migrate

Run project in Local

Step 1: Run MySQL server
Run MySQL: mysql.server start

Step 2: Open terminal tabs and work on the environment

in Tab 1: MongoDB
in Tab 2: MySQL
in Tab 3: Run Application

Work on environment (in each terminal tab): workon urgentestimar

Step 3: Run MongoDB (Tab 1)
Run mongodb: mongod --dbpath /.../urGENTestimar/ddbb

Step 4: MySQL actions (Tab 2)
Directory: cd /.../urGENTestimar/
Database: mysql -u user_db -p (pass_db)

Drop database: drop database urgentestimar;
Create database: create database urgentestimar;
Exit: exit;

Modificate fields of database: python manage.py makemigrations
Refresh database: python manage.py migrate

Step 5: Load texts (Tab 2)
Load translations: python excel_to_mongodb.py

Step 6: Run Server (Tab 3)
Directory: cd /.../urGENTestimar/
Runserver: python manage.py runserver localhost:port

Access client

Client application:
http://localhost:port/

Control and Administration:
http://localhost:port/admin

Versions

Version 1.0

License

CitizenSocialLab is licensed under a GNU Affero General Public License

All the contents of urGENTestimar repository are under the license CC BY-NC-SA license

Contributors

Julián Vicens

Contact

Julian Vicens: julianvicens@gmail.com