Tutorial |
:: |
Linguistic Experiments with WebExp2 |
|||||||
---|---|---|---|---|---|---|---|---|---|
|
|||||||||
Setting up your Stanford WE2 accountThere are three steps involved in setting up your own WebExp2 account:
[TOP]
Getting an accountThe local WE2 server is running on symsys.stanford.edu. In order to run experiments using this server, you must have a symsys account. You can get such an account by emailing to action@csli.stanford.edu. You also have to cc two more people: whoever is in charge of the WE2 server (currently this is Florian) and whoever is in charge of the webserver on symsys (currently this is Ian Ward Comfort). They will need two pieces of information from you:
Also tell them that you need your public html directory (WWW) to be mapped to http://symsys.stanford.edu:8081/experiment/YOUR-SUNET-ID/ (this is only necessary of you want your html pages to be located on symsys as well; if you want only the experimental data on symsys (with all the html pages on some other account), then you don't need a public html directory on symsys). Once your account has been set up, log in and change your password. NB: Symsys currently does not accept connections from outside of the Stanford network. If you're outside of Stanford's network, log into any of the campus machines first (e.g. Elaine, Vine, Firebird, Cardinal, etc.). From there you can log into symsys using ssh:
The first time you log in, you may be asked whether you want to add the host ID to your trusted IPs. Answer "Yes". You can transport files from symsys or to symsys by using sftp to any of the campus machines or by mounting symsys to AFS:
[TOP]
Creating directoriesIn order to run WE2 experiments you need two directories in your WE2 account. One directory will contain all the html pages (with instructions, consent forms, etc., as well as the applet that your subjects will use to communicate with the WE2 server). If you want your html pages to be located outside of symsys, you don't have to bother about this directory. This directory may already exist (it should be called WWW). You can test at any time whether your WWW directory is served to the web by putting a file into it (let's call it FILENAME.html) and then pointing your browser to http://symsys.stanford.edu:8081/experiment/WE2/YOUR-SUNET-ID/FILENAME.html. The second directory is a must. It should be located (directly) under your symsys account and it should be named WE2data. Here is how you create these two directories and set the right permissions.
mkdir ~/WE2data chmod a+rx ~/WWW chmod ug+rx ~/WE2data The WE2data directory must be writable for the WE2 server (this is necessary since this is the directory to which the WE2 server writes the results of your experiments. For that you need to set some permissions:
chmod -R g+rwx ~/WE2data/ Next you should copy some files from the WE2 server that will allow you learn and play with WE2:
This should copy example experiments into your directory. If you look at the list of those files, it should be something like the following (this may change in the future):
attractiveness demotest experiments.xml layouttest magest stroop template
[TOP]
Make sure that all directories are readable and writable to the group we2. Repeat the command from above:
chmod -R g+rwx ~/WE2data/
Linking directories to the WE2 serverAlmost finished. You need to inform the person responsible for the WE2 server to add your account to the server. For that, the WE2 server will need to be reset and it's possible that this will be done overnight (while fewer people are likely to take experiments). Once (1) your WE2data directory has been linked to the WE2 server, (2) your name has been added to the list of experimenters, and (3) the WE2 server has been reset, then you can start working on your experiments. Note that every time you add an experiment, the WE2 server may have to be reset before any changes actually take place. Changes in the stimuli files of an existing experiment do not require a WE2 server reset. Testing your WE2 accountAfter your account has been linked to the WE2, any of the default experiments should work. So let's give it a try. First let's copy an example html page with an experiment into your public html directory. Then let's open it in emacs and edit it:
emacs ~/WWW/demotest.html We have to modify the following lines to make the embedded experimental applet point to your experiment:
should be changed to also contain the information given below in blue:
<PARAM name="experiment" value="demotest"> <PARAM name="port" value="6785"> <PARAM name="LANG" value="UTF-8"> All of your experiments will be called through such websites with (almost) the same parameters. The only difference between the websites for each experiment will be the "experiment" parameter, which tells the server which of your experiments you want the user to be referred to. We will get back to this later. Now if you point your browser to http://symsys.stanford.edu:8081/experiment/YOUR-SUNET-ID/demotest.html, you should see a WE2 demo experiment. Try and go through it. The results will be written to your WE2data/demotest/results/ directory. Subject identification information is stored separately under your WE2data/demotest/subjects/ directory. Have a look (but first finishe the experiment). You can run similar tests for the other sample experiments that you copied into your WE2data directory by editing/creating according html files in your WWW directory. NB: After you're done learning from the sample experiments, please consider deleting them (you can always get them again), since they will unnecessarily increase the work load for the WE2 server. All demos are available at the WE2 info page or locally on symsys at e.g. http://symsys.stanford.edu:8081/experiment/WE2/demotest.html. The next part of this tutorial contains information on WE2 support and links to both the user manual and the email archives with frequently asked questions. [TOP]
|
|||||||||
|