Experimental Protocol Application

Summary: Open-source application within behavioural decision experiments of K.U.L academic research.

Authorization: The repository is allowed to be used and changed for research within the Euthority group.

Usage: The repository can be referenced via "Nicolas Lampach, Sarah Joseph and Timothy Yu-Cheong Yeung. Applications of Experimental Protocol, (2019), Repository, https://github.com/timothy2799/oTree-Decision-Experiments"

References:
1. Daniel L. Chen et al., (2016), oTree—An open-source platform for laboratory, online, and field experiments. Journal of Behavioral and Experimental Finance.
2. Felix Holzmeister, (2018), Repository, https://github.com/JBEF/oTree_MPL

1. Installation of Git SCM

1. Download Gitbash for giving the command line instructions and follow custom configurations within the Gitbash app terminal

https://gitforwindows.org/
git config --global user.email "email"
git config --global user.name "firstname"

2. Get remote branch to local directory:

git clone https://github.com/timothy2799/oTree-Decision-Experiments

3. Make the changes locally, and navigate to otree-decision-experiments in GitBash and give command

git init

(3.1) This command is only needed during the first setup, otherwise skip.

git remote add origin https://github.com/timothy2799/oTree-Decision-Experiments

4. Finally commit and push back all changes to the remote branch:

git add .
git commit . -m "change description"
git push origin master

5. If you are not up to date with the branch here then you can either pull the repository from here or:

git pull
git push -f origin master

2. Installation and Deployment of oTree

Install the Following

1. Python
2. pip
3. Microsoft Visual C++
4. oTree

## **A. For testing**

1. Navigate in the windows command prompt to the folder with the settings.py file
2. Deploy locally with:

otree devserver

3. go to localhost:8000 in the browser

B. For deploying in a local area network

• B.1 Configure firewall

1. Open the Windows Firewall
2. Go to “Inbound Rules”
3. Click “New Rule”
4. Select “Port” to make a port rule
5. Under “Specific local ports”, enter 80 and 8000
6. Select “Allow the connection”
7. Click “next” then choose a name for your rule (e.g. “oTree”).

• B.2 Get the machine IP by entering the following in the windows command terminal

ipconfig

The IPV4 address is the one you will need, it may will look something like 10.0.1.3, or could also start with 172 or 192.

• B.3 Deploy the server from a local network: In the browser you can start the server with your IP address and port 8000, e.g. otree devserver 10.0.1.3:8000

• B.4 Allocation of participant: The session wide link allocates participants, they cannot access via the IP and port URL address