MTurkR (version 0.6.17)

Miscellaneous: Convenience Functions and RUI Interaction

Description

These functions provide lists (of QualificationTypes, Requester and Worker Statistics) useful when creating HITs and QualificationTypes, and other functions to open specific pages of the MTurk Requester User Interface (RUI), or in the case of ViewAvailableHITs, the MTurk worker site.

Usage

ListOperations(op = NULL)

ListQualificationTypes(qual = NULL)

ListStatistics(stat = NULL, value.type = NULL, type = NULL)

ViewAvailableHITs(query = NULL, requester = NULL, min.reward = NULL, qualified = NULL)

OpenWorkerPage(workerid = NULL)
OpenManageHITPage(hit = NULL)
OpenDownloadPage(hit, download = FALSE)
OpenQualificationPage()

Arguments

op

For ListOperations: a number indicating which of the operations to return. Probably not useful.

qual

For ListQualificationTypes: a character string containing the name of a built-in QualificationType. If specified, ListQualificationTypes returns only the QualificationTypeId of that QualificationType.

stat

For ListStatistics: an optional character string specifying the name of an MTurk statistic. If specified, only details of that statistic are returned.

value.type

For ListStatistics: an optional character string specifying whether Double-type or Long-type statistics should be returned. If NULL, both types are returned. Probably not useful.

type

For ListStatistics: an optional character string specifying whether GetRequesterStatistic-type or GetRequesterWorkerStatistic-type statistics should be returned. If NULL, both types are returned.

query

For ViewAvailableHITs: an optional character string containing a search query used to search through HITs available on the MTurk worker site.

requester

For ViewAvailableHITs: an optional character string containing a RequesterId whose HITs are to be searched, for example to see how one's own HITs appear to workers on the MTurk worker site.

min.reward

For ViewAvailableHITs: an optional character string containing a minimum reward (in U.S. Dollars) criterion to be used when searching available HITs on the worker site.

qualified

For ViewAvailableHITs: an optional logical specifying whether only HITs for which you are qualified should be searched.

workerid

For OpenWorkerPage: an optional character string containing the WorkerId of a worker whose Requester User Interface (RUI) management page is to be opened. If NULL, function opens the list of workers.

hit

For OpenManageHITPage: an optional character string containing the HITId of a HIT whose Requester User Interface (RUI) management page is to be opened. If NULL, function opens the list of all HITs. For OpenDownloadPage

download

For OpenDownloadPage: a logical indicating whether the HIT results should be downloaded directly or whether the Requester User Interface (RUI) ManageHIT page should be opened (the default).

Value

• Either a dataframe containing the requested information (in the case of ListOperations, ListQualificationTypes, ListStatistics) or nothing internal to R, but the specified webpage is opened in the user's default web browser (in the case of OpenWorkerPage, OpenManageHITPage, OpenDownloadPage, or OpenQualificationPage).

Details

A set of convenience functions to either display various information about MTurk semantics or open specified parts of the Requester User Interface (RUI).

Examples

ListOperations()
ListQualificationTypes()
ListStatistics()
ViewAvailableHITs(min.reward=".50")

OpenWorkerPage()
OpenWorkerPage("A1RO9UEXAMPLE")
OpenManageHITPage()
OpenDownloadPage("267SI2KYEPLS8QWZYPXWP3EXAMPLE",download=TRUE)
OpenQualificationPage()