Edit me

So, now you’ve installed JATOS and tried out all the examples studies. What now?

Create a new study

There are two ways to create a new study:

  1. from scratch by pressing the New Study button in the header of each JATOS page. Then edit the study properties and add new components manually.

  2. take an existing study (e.g. from Example Studies) as a prototype and modify it bit by bit. We recommend you start with this to get a quick idea of how JATOS works. Just import an existing study (e.g. one from the study examples) and clone it by clicking on More –> Clone in the study bar.

Write your own studies in JavaScript

The most difficult part - though it’s still easy! - is to learn to write your own study component scripts, using HTML, CSS and JavaScripts. Or, instead of reinventing the wheel, you could use a framework like jsPsych that helps you with this (see jsPsych and JATOS).

Check out the Mandatory lines in your components’ HTML page to know what you absolutely must include in your scripts in order to let JATOS see them. Also check out the jatos.js Reference, that contains a set of very useful functions that you have to use to communicate with jatos (to e.g. submit and receive data).

If you are a newbie to HTML/JavaScript programming, there are LOADS of free and excellent tutorials online. Like this one from the Kahn Academy or more searchable tutorials like the simple ones from the w3 schools. In addition, StackOverflow is the best place to solve the problems that hundreds of others have encountered before.

Import / Export of studies

Usually you conveniently develop your study on your local computer where you have a local installation of JATOS. Then just use the export and import buttons in your installations to transfer the study to your JATOS server.

  1. In the GUI of your local installation press Export in the Study Toolbar. JATOS saves your study asset folder and some data about your study and it’s components (mostly the properties) into a ZIP file and lets you download it. Leave the ZIP file as it is.
  2. In the GUI of your server installations press Import in the header. Select the ZIP you saved in step 1. JATOS will upload and unpack your study.

If you have trouble with the export and you are using a Safari browser have a look into this issue in our Troubleshooting section.

Once you have your study running and have it on a server instance, you’ll need to get your workers to access your study. Different types of workers might be allowed to run your study. You could, but you don’t have to, recruit your workers using MTurk. You could also generate direct links in the Worker Setup to send to different workers.

Export your result data

After you let workers run your study and you gathered result data you probably want to export them to your local computer for further analysis. Go to one of the Results views and select the results you want to export (select them by just clicking somewhere in the row). Then click ‘Export Selected’. This will download all your results in one text file.

Analyse your data

Once you have collected all your data, export it to text files. If you used the JSON format (which is handy - but any other text is fine too) you can analyse your data using this nice JSON parser for Matlab and Octave or the JSON parser for R.