PEBL: The Psychology Experiment Building Language


About

Community and Support

Download

Documentation

Experiments

Test Battery

Screenshots

Developers

Wiki
Sourceforge Project Site

SourceForge.net Logo

Documentation

The latest version of the PEBL manual is available below, in html and as a 120-page pdf document. We also have a simple beginners tutorial, and some other documents of interest.

DocumentHTMLPDFPrinted
HowtoSee Below  
PEBL ManualHTML ManualPDF Manual
Printed Version
Introductory TutorialHTML TutorialPDF Tutorial 
Slides from SCiP Talk (2004) PDF Slides 

Instructions for using PEBL on OSX are available as well. Have any tips or tricks? Post them to the PEBL Wiki.

Introductory Howto

This howto assumes you are running PEBL on Windows using the launcher. To begin, you must install PEBL with the PEBL installer. This provides a number of easy ways to launch the program and experiment scripts. It will create a folder called "pebl-exp" in your "My Documents" folder. Inside that folder, there is a shortcut that will start the launcher, allowing you to run any script in that folder. To run an experiment not in that folder, you can navigate to the script within the launcher. Alternately, you can just copy the new script into the My Documents\pebl-exp folder.

To run the test battery, download the battery archive and unzip it. The best place to unzip it is in your "My Documents" folder. Avoid putting scripts that you run in the c:\Program Files\ directory, as that is sometimes hard to find and write-protected.

All scripts will produce two output files, one is called "standard output" and one called "standard error". In PEBL launcher, the standard error stream is displayed in the "Errors and Messages" dialog after you script is complete. This includes parsing/compilation messages, and any error messages if the script finished early. If the script contains any "Print" commands for debugging or instrumentation, these will appear in the "User Output" message box in the launcher. If no output is provided by the script, the message "failed to load [C:\Program Files\PEBL\bin\stdout.txt]." will be displayed. This is not an error, but simply means that no output was produced by the script. The easiest way to run PEBL is to navigate to the experiment directory and start the launcher from a shortcut in that directory. The initial parameters of the launcher can (and must) be controlled with a file called pebl-init.txt which must be present in the directory the launcher shortcut starts the launcher in.

This can allow you to have different initial parameters fed into different experiments. To make a new launcher shortcut, first copy the shortcut in the MY Documents\pebl-exp directory, then paste it into the place you want the new launcher to start from. Next, copy and paste the pebl-init.txt file to the new directory. Edit the pebl-init.txt file if you want--you can control the starting directory, the initial command-line parameters, the initial highlighted experiment, etc (check the manual for more details). When your experiment is complete, the data file (if any are produced) should be in the same directory as the script you ran.



http://pebl.sourceforge.net/documentation.html
Last Modified 09-2007