PictureDrawingSearch is an experiment program for a study looking at the effects of different types of visual masking (central, peripheral, and none) on drawing from observation.
PictureDrawingSearch is programmed in Python 2.7 (3.3+ compatible) using the KLibs framework. It has been developed and tested on macOS (10.9 through 10.13), but should also work with minimal hassle on computers running Ubuntu or Debian Linux, as well as on computers running Windows 7 or newer with a bit more effort.
The experiment is designed to be run with an EyeLink eye tracker, but it can be downloaded and tested without one (using the mouse cursor as a stand-in for gaze position) by adding the flag -ELx to the klibs run command. In order to run PictureDrawingSearch with a hardware EyeLink eye tracker, you will need to install the EyeLink API (including the 'pylink' Python library).
First, you will need to install the KLibs framework by following the instructions here.
Then, you can then download and install the experiment program with the following commands (replacing ~/Downloads with the path to the folder where you would like to put the program folder):
cd ~/Downloads
git clone https://github.com/NSCAD-DrawingLab/PicutreDrawingSearch.git
PictureDrawingSearch is a KLibs experiment, meaning that it is run using the klibs command at the terminal (running the 'experiment.py' file using python directly will not work).
To run the experiment, navigate to the PictureDrawingSearch folder in Terminal and run klibs run [screensize],
replacing [screensize] with the diagonal size of your display in inches (e.g. klibs run 24 for a 24-inch monitor). If you just want to test the program out for yourself and skip demographics collection, you can add the -d flag to the end of the command to launch the experiment in development mode.
To export data from PictureDrawingSearch, simply run
klibs export
while in the PictureDrawingSearch directory. This will export the trial data for each participant into individual tab-separated text files in the project's ExpAssets/Data subfolder.