PsyExTool Files

PsyExTool is a Psychophysical Experiment Toolbox in Matlab/Octave environment with a graphical 
interface. It was developed to control psychophysical experiment, collect data and visualize it. The 
toolbox provides functionalities to:
*	Perform experiments using adjustment, constant stimulus and adaptive Psi (Palamedes toolbox)  
methods
*	Visualize state of ongoing experiment
*	Store, manage and export the data
*	visualize and analyze the results
*	Interface your own stimulus function to the experiment control module
*	Change and develop the toolbox.
The main window of the PsyExTool:
 
Left part of the window:
Load - load the experiment parameters together with data or parameters alone.
Start experiment - starts the experiment
Empty panel of green color - ready to start, red - ongoing experiment, yellow - finished unsaved 
experiment. You can keep a cursor on this panel in case you are using a mouse as input device. 
Subject id input panel is for to enter id of the subject that performs experiment.
Save as - to save the performed experiment in a new file or to save or export a loaded experiment/ 
experiments or part of it to a new file.
Add & save - to add newly performed experiment to a loaded dataset in case you repeate the 
experiment with the same subject.
Graph other - to plot saved experiment results without loading experiment parameters.
Panel with checkboxes
New figure - every time the data is plotted in a new figure.
Hold - the graph is plotted without erasing the previous.
Split files - the experiment repeats are plotted or saved (it also works with a "save" bottom) 
separately.
Convert - convert and put labels in a plot of experiment results, it also applies for exporting.
Raw - plot or export every response.
Mean - plot or export the means of the responses.
STD - plot or export the standard deviation of the responses.
CI - plot or export the 0.95 confidence intervals of the responses mean.
Smooth - plot or export the smoothed data.
Refresh - plot after every change in this or file info check box panels.
Plot - plot the data
File Info - info about loaded repeats of the experiment (name, number of repeats or responses, saved 
time, comments). You can comment. You can check or uncheck certain repeats in order to plot (button 
Plot) them or to save/export in a separate file through a bottom Save as.

Right part of the window
Experiment settings
Experiment methods: Adjustment | constant stimulus | PAL_AMP (Palamedes toolbox Adaptive Method 
Psi)
IndepVar1Name - Independent Variable 1 Name of the stimulus presentation function.
IndepVar1Range - Independent Variable 1 Range of the stimulus presentation function.
Input - keyboard | mouse


FAQ
How to start?
Run petGUI. Load any example. Push start experiment...

How to interface my own stimulus generation (presentation) function?
Use file petExperimentEmulator.m as an example.

What extra files or toolboxes do I need?
For Adaptive Method Psi a Palamedes toolbox from www.palamedestoolbox.org  is needed.

What is PET?
PET is the main toolbox variable with a structure:
StimPar - Stimulus Parameters;
ExPar - Experiment Parameters;
ExPar.StimFun: Stimulus Function;
ExPar.PsychoMethod - Psychophysical Method;
ExPar.DepVar1Name: Dependant Variable Name;
ExPar. DepVar1Val: Dependant Variable Value;
ExPar. IndepVar1Name: Independant Variable Name;
ExPar. IndepVar1Val: Independant Variable Value;
Data - Records made during experiment;
Data.RawData is array of experiment records;
Data.Subject: Subject Identification string;
Saved: the time of saved file;
SysPar - System parameters;
Name - Name of the session;
Comments - text information.

This is not a stable release. You have to check everything if you are going to apply it for scientific 
purposes. On the other hand, I hope that you will find it helpful. Feel free to use it. Any kind of feedback 
or questions are welcome very much.

Tadas Surkys
tadas.surkys@lsmuni.lt