Mechanical Turk tutorial

Pratical part

1. Set up MTurk account

Follow Steps 1-3 on the following website:

https://docs.aws.amazon.com/AWSMechTurk/latest/AWSMechanicalTurkGettingStartedGuide/SetUp.html

2. Install Submiterator

(instructions vary on Windows and may slightly vary on Linux.)

Install the boto3 and the xmltodict packages by running the following commands on the console:
```
pip3 install boto3
pip3 install xmltodict
```

git clone https://github.com/sebschu/Submiterator

Edit your bash profile file

Open the bash profile file:

open -e ~/.bash_profile

Add the following lines to your bash profile file:

export MTURK_ACCESS_KEY=<YOUR MTURK ACCESS KEY>
export MTURK_SECRET=<YOUR MTURK SECRET>

PATH=$PATH:~/bin

Create a symbolic link to submiterator

cd ~
mkdir bin
cd bin
chmod u+x [PATH_TO_SUBMITERATOR_DIRECTORY]/supersubmiterator.py
ln -s [PATH_TO_SUBMITERATOR_DIRECTORY]/supersubmiterator.py submiterator

Close and re-open the console
Test submiterator:
```
submiterator -h
```

3. Fork this repsitory

Click on the "Fork" button in the top-right corner of this page.

4. Activate GitHub pages

Go to "Settings".
Scroll down to the section "GitHub Pages".
Under "Source" select "master branch".
Test the experiment at https://<YOUR_GITHUB_USERNAME>.github.io/mturk-tutorial/experiment/experiment.html .
Once you reach the end of the experiment, you should see a grey box at the bottom with your responses.

5. Clone the forked repository

git clone https://github.com/[YOUR_GITHUB_USERNAME]/mturk-tutorial

6. Configure the MTurk experiment

In your repository, create a directory called mturk.
In the mturk repository, create a file my_experiment.config.
Copy the contents of the example config file into your config file.
Edit the config file. Make sure that liveHIT is set to "no"! Together with your neighbor, try to figure out what all the options mean.

7. Add the `mturk` directory to `.gitignore`

You don't want to upload the raw data, which contains the MTurk worker IDs, to GitHub. One way to achieve this is to add the mturk directory to .gitignoe. Entries in .gitignore are not tracked as part of the repository.

In the console, go to the root directory of your repository
Open the .gitignore file
```
open -e .gitignore
```
Add mturk in a separate line to the file and save and close it.
Commit the file.
```
git commit -m 'Update .gitignore'
```

8. Post the HIT to the MTurk sandbox

From the directory with the my_experiment.config file, run:

submiterator posthit my_experiment

9. Test the experiment on MTurk

Copy the URL that submiterator outputs and open it in your browser.
Complete the experiment.

10. Download the results