edoardore / mturktools

This tool permits the creation of multiple Tasks of multiple HITs (images or videos) in Amazon Mechanical Turk.

MTurkTools

This tool permits the creation of multiple Tasks of multiple HITs (images or videos) in Amazon Mechanical Turk.

SetUp MTurk:

1. Sign in as a Requester here and create an Amazon account.
2. Create New Project here selecting Other type for the template.
3. Follow this image:
4. Copy&Paste the content of layoutImages.html in DESIGN LAYOUT (pass 2 for the creation).
5. Save.
6. Copy HITTypeID and LayoutID from:
7. Paste HITTypeID and LayoutID in Key.py.

Repeat 2...7 with layoutVideo.html.

8. Create AWS account here.
9. Set up IAM console here.
10. Follow this and click on ADD USER:
11. Enter text like and press Next button.
12. Select AmazonMechanicalTurkFullAccess like:
13. Insert new key like:
14. Select Next, and Create User.
15. Copy the two keys and paste it in Key.py:

SetUp Amazon S3:

1. Sign in here with AWS UserID and password created earlier.
2. Create (in different times) two new buckets named: imagesformturk and videosformturk.
3. Deselect Block all public access here:
4. Press Create Bucket.
5. In imagesformturk open bucket -> go to authorization -> Policy Bucket and paste:

    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "PublicReadGetObject",
            "Effect": "Allow",
            "Principal": "*",
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::imagesformturk/*"
        }
    ]
}

6. In videosformturk open bucket -> go to authorization -> Policy Bucket and paste:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "PublicReadGetObject",
            "Effect": "Allow",
            "Principal": "*",
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::videosformturk/*"
        }
    ]
}

Initialize MySQL DataBase:

1. Download Xampp here
2. After having installed go to http://localhost/phpmyadmin/ and create DB with these specifics: User:"utente" Password: "pass123" DB Name:"dbmysql"

Initialize Python Code:

1. Uncomment in createImmHIT.py, resultsImm.py, createVideoHIT.py, resultsVid.py the line to connect to the live marketplace instead of the sandbox.

Now it's all setted up! The tool can work correctly. Use the requirement.txt to recreate the virtual env for the project.

Views:

1. Create a new Task, choosing from Image or Video Tasks.
2. Select files to upload on Amazon MTurk.
3. View of all Tasks precedently created.
4. It's possible to refresh the results of workers.
5. Each Task has a personalized dashboard with adaptive queries that shows the results.
6. It's possible to create other Tasks from the home view.

Dashboard:

1. Evaluation History of single file (of the selected Task). Type: Line Graph.
2. Evaluation History of single worker (that evaluates some HITs in the task selected). Type: Line Graph.
3. Comparison of the evaluation done by two different workers (that evaluates some HITs in the task selected). Type: Radar Graph.
4. Single file evaluation results. Type: Pie Graph.
5. Workers ordered by the number of submitted HITs. Type: Bar Graph.
6. Number of submitted HITs by workers and average of the evaluation vote that they have assigned. Type: Scatter Graph.
7. Liar workers ordered by the number of times that they assigned random value in age and sex field. Type: Bar Graph.
8. Results showed based on sex: male/female. Type: Pie Graph.
9. Percents of the screen resolution of the workers. Type: Bar Graph.
10. Percents of the age of the workers. Type: Bar Graph.
11. Average and standard deviation of each file evaluated in the task; and average of all the votes of the task. Type: Line Graph.
12. Modular multiple graph with 3 of the precedent views.

License

Edoardo Re, 2019