A framework for creating phonology experiments.
Who is it for? How can I get help?
who know some of the basics of putting a webpage up, and who know a little bit of R – or for linguists who want to learn these things, or for linguists who have someone like this on their team. It's not for linguists who are ''not good with computers''.
The code is provided as is. Turn to your local web expert for help with setting up your experiment.
If you fixed anything or added functionality to Experigen, we invite you to contribute your code back to the project.
URLs may not contain hyphens/dashes. You'll have to use a different URL.
Experigen requires participants to be online and using an active internet connection. There is no offline mode at the moment (it's in the works, though).
Experigen does not measure reaction times. You can only get a very rough idea of how fast participants are working by examining the server timestamps. There is a forked version that has RT measurement functionality at https://github.com/cpill0789/experigen.
web folder (or just its contents) to your server.
Put your materials in the
- Make a tab-delimited file called
items.txt, where each line specifies one item (stimulus or filler). You will probably make this file in a spreadsheet program (Excel or some such) and save it as a text file. The first column in this file is special: it uniquely identifies your items. It may not contain blank cells or repeated entries.
- If your experiment contains stuff that will get randomly paired with your items, such as frame sentences or pictures, make tab-delimited text files for those, again with the first column uniquely identifying the frames or pictures.
- Put audio files in mp3 format in the sounds folder, and pictures in the pictures folder.
- Make a tab-delimited file called
Design your experiment in the
design.jsto specify the information that the participants will see in each screen.
settings.jsto specify the experiment name and the database server. We will maintain the database server http://db.phonologist.org/ for the foreseeable future.
styles.cssif you want to change colors, font sizes, alignments, and the such.
Customize the display of the information in the
- Use the templates in this folder to control how the participants see individual screens.
_libfolder contains helper files; you don't need to go there.
You don't need to edit
Your results will accumulate on the database server you specified.
Currently, there is only one database server available at http://db.phonologist.org/. You are welcome to use it if you want to, so long as you don't hold us responsible for anything that might happen to your data. We offer this service for free and as is.
To download the results, use the
getresults.Rfile (you'll want to install
Rif you don't have it already).
getresults.Rfile, specify where your experiment is hosted (line 5). For example, if your experiment is at http://www.awesomeuniversity.edu/~iamawesome/questionnaire/, you will write www.awesomeuniversity.edu.iamawesome.questionnaire (turning slashes into periods, etc.)
Specify your experimentName (line 7). That's the string you entered in your
getresults.Rfile, which will download the data and save it to your computer.
The default names for the created files are
meta.csv. You can open them in Excel or OpenOffice if you want to. They are saved to whatever
R's current working directory is.
If you want to set up your own database server, email Michael Becker.
Please cite Experigen whenever used in academic work:
Becker, Michael and Jonathan Levine (2014) Experigen – an online experiment platform. Available at http://becker.phonologist.org/experigen.