The results pages (study, component, batch or worker) present all the data that were collected during the study runs, including the result data and metadata (e.g. worker ID, start time etc.).
Edit me

Results Pages

Once you collected data for a study, you can see and manage the results by clicking on one of the Results buttons.

Results Link

The image below is an example of a study results page. There’s quite a lot of information here, so we’ll go through each piece.

Results View screenshot

Interacting With The Results Table

View Result Data

Each study result has an arrow on the left. If you click on it, the result data for this study run will be displayed underneath the row. Since a study can have several components and each component produces its own result data there can be several result data each in its own row (like in the screenshot below).

Results View screenshot

Selecting Results

Prior to JATOS version 3.3.1 you could select/deselect a specific result by clicking anywhere on the row. Selected results change color to dark blue.

From 3.3.1 on there is a checkbox on the left side of each row.

You can also use the buttons on the bar above to select/deselect all results in the table or select only all filtered ones.

Filter Results

The filter lets you search all all fields in the results table (the metadata) and from JATOS version 3.3.1 on also in the result data themselves.

If you type, for example, “Personal Single” in the Filter Results field, only the results ran by a Personal Single worker will appear on the table. You can then click on Select Filtered to select and then export only those results that you’re interested in.

Export Result Data

Once you selected the results you’re interested in, click Export Results and your browser will download a text file that contains your results in whatever format (text, csv, json) you stored them. Then read this text file with SPSS, Excel, Matlab, R or whatever program you use to analyze results.

Export Metadata (JATOS version >= 3.3.1)

Sometimes one is also interested in the metadata, that is what’s in the actual table fields (“Result ID”, “Start Time” , “Last Seen”, …). For this click on Export Metadata and the metadata of the selected results will be downloaded in CSV format.

Delete Results

You can click Delete to remove all or only some selected results (result data + metadata). Keep in mind there’s no undo function for this.

Table Columns

You can show and hide the columns displayed in the table with the drop-down menu under the Display Columns button.

Result ID

An identifier assigned by JATOS to each study result. A study result is actually a set of component results, each of them with their own (different) Component Result ID.

Start Time

Time (set at the server’s time zone) at which the first component of the study was started.

End Time

Time (set at the server’s time zone) at which the last component of the study was finished.

Last Seen

Each component running in a worker’s browser sends a “heartbeat” regularly back to JATOS. Last Seen is the time of the last heartbeat received. The heartbeat stops either when the study is finished or when the browser tab is closed. The default period of the heartbeat is 2 minutes but you can change it through a jatos.js function.

Duration

Simply the time difference between the start and end time.

Batch

Name of the batch the worker belongs to.

Worker ID

Assigned by JATOS. Each worker has its own Worker ID. JATOS’ admin user will always have Worker ID 1. You can click on a Worker ID to see all the worker’s results.

Worker Type

Displays the Worker type that ran the study.

MTurk Worker ID (Confirmation Code)

Only applies to studies run by MTurk workers. An identifier given by Amazon Mechanical Turk’s, not by JATOS. The Confirmation Code is generated by JATOS and given to the worker as proof of his work.

Group ID

Only available for group studies. It identifies the group.

State

Possible states for study results are:

  • PRE - Preview of study (exists only in PersonalSingleWorker and GeneralSingleWorker)
  • STARTED - Study was started
  • DATA_RETRIEVED - Study’s jsonData were retrieved
  • FINISHED - Study successfully finished
  • ABORTED - Study aborted by worker
  • FAIL - Something went wrong

Possible states for component results are:

  • STARTED - Component was started
  • DATA_RETRIEVED - Component’s jsonData were retrieved
  • RESULTDATA_POSTED - Result data were posted
  • FINISHED - Component was finished
  • RELOADED - Component was reloaded
  • ABORTED - Component aborted by worker
  • FAIL - Something went wrong

Messages

A message that can be set together with jatos.endStudy or jatos.abortStudy.