SC_experiment

Project Description:

This repository contains the source code necessary to run the Donut Delivery (discussed in this paper) experiment on Amazon Mechanical Turk. The task set and images needed for running the experiment come from this code.

Software Requirements

• python 2.7 : needed python to run the psiturk experiment
• $ pip install psiturk : after having python 2.7, you can simply run the command in your terminal.
• find the desired directory, then paste the following in you terminal: $ git clone https://github.com/COHRINT/SC_experiment.git in your terminal
• $ cd SC_experiment and then $ psiturk : will start the psiturk environment
• A majority of the code in this repository comes straight from psiturk, see that website for information on how the code is organized other things of that nature.

The following links may be useful

• Amazon Mechanical turk
• psiturk

Key files

• static
  • js folder contains task.js which is the main file that runs the experiment
• templates contains all of the html files used in this project.
  • files in the instructions folder are used for the instructions and training of participants
  • images folder which used to store images the task set (road network) images (these images are produced by this code)
  • json/v2_support---file containing information about the network image location, delivery outcome, problem properties, and the FaMSeC metric values (values for "xQ" and "xP" (now called "xO") were implemented in this expeirment) (produced by this code)
  • json/experiment_trial_set---file containing a list of the tasks that are to be used in the experiment. This list is produced by this code(this is a list of network numbers that are found in v2_support.json)