Visuaural v0.1.2 Alpha Tested on: - Puredata Extended 0.42.5 - Macintosh OS 10.8.5 January 28, 2014 =================================================================== Visuaural is an easy-to-use software to perform several procedures that allow empirical research in music psychology and related fields. It runs on Puredata Extended. Once opened, the steps displayed in the user interface should be followed. Visuaural will perform a procedure as stated in a "program", which should be written in a plain text file. The commands and usage to build a Visuaural program are given hereinbelow. Visuaural is a by-product of my master's thesis for the Music, Mind and Technology master's degree programme at the University of Jyväskylä in Finland. Visuaural is copyrighted, free to use and free to distribute under the GNU license version 3. ------------------------------------------------------------------- Program Format -------------- 1 [first command] [parameter]; 2 [second command] [parameter]; 3 [third command] [parameter]; . . . N [ending command] [parameter]; ------------------------------------------------------------------- Program Commands ---------------- prog_ready [name]; Sets the program to be ready to start. Displays name, date and participant number. a_repinst [audiofilename.wav]; Plays back a wav audio file. Waits 5 seconds for wiimote button A or space bar to playback the file again. a_inst_nxt [audiofilename.wav]; Plays back a wav audio file. Waits wiimote button A or space bar to advance to next step. a_simpleplay [audiofilename.wav]; Plays back a wav audio file. Waits 3 seconds to advance to next step. a_randomplay [list.txt]; Plays back a wav audio file randomly chosen from a list containing audio files names (with extensions). The same list can be used several times and a_randomplay will play the files in the list without repeating unless all the files have been played. If another list is used in between, then the shuffle property will be reset (i.e. a file previously played might be played again) After each play it will output a .rpl text file containing the name of the audio file played. Waits 3 seconds to advance to next step. a_restartopt [audiofilename.wav]; Plays back a wav audio file. Waits 5 seconds for wiimote button A or space bar to restart the program. a_datacap_rt_nom [audiofilename.wav]; Plays back a wav audio file. Records nominal response (100 or 0, wiimote button A or space bar) as the audio file plays. Waits 3 seconds to advance to next step. a_datacap_rt_wii_y [audiofilename.wav]; Plays back a wav audio file. Records continuous response (-100 to 100 at 10Hz, wiimote pitch) as the audio file plays. Waits 3 seconds to advance to next step. a_rec_qstn [audiofilename.wav]; Plays back a wav audio file. Records audio to a .wav file. Waits for wiimote button A or space bar to advance to next step. a_datacap_qstn [audiofilename.wav]; Plays back a wav audio file. Records one of the preset wiimote button or keyboard keys and advances to next step. Outputs a plain text file with extension .qst. v_disptxt [parameter]; Displays text on a black background full screen without mouse cursor. Parameters: on Displays a black full screen. off Close the black full screen. [textfilename.txt] Will display the content of a v_disptxt formatted text file. v_disptxt textfilename.txt format: [font size]; [colour]; [text line 1]; [text line 2]; ... [text line N]; font size range: 1 - 100? colours: r y g b p w v_disptxt_count [parameter]; Displays a counter on a black background full screen without mouse cursor. Parameters: [textfilename.txt] Will set the parameters of the counter. v_disptxt_count textfilename.txt format: [font size]; [colour]; [text]; [start number]; [end number]; init Sets counter to start number. show Displays the counter and adds one. First display will be start number. font size and colours are the same as v_disptxt Screen needs to be turned off with "v_disptxt off" wait [seconds]; Waits a number of seconds and advances to next step. v_datacap_stroop [textfilename.txt]; Performs a Stroop test randomizing words and colours. Outputs a plain text file with extension .str containing a list wuith the following data cycles: numbers for displayed colour, displayed word, answered colour and response time in milliseconds. v_datacap_stroop textfilename.txt format: [font size]; [colours to use]; [word 1]; [word 2]; ... [word N]; font size range: 1 - 100? colours to use: r y g b p w v_txt_qst [textfilename.txt]; Displays a questionnaire that can have text, likert scales, nominal checkboxes and free text entries. It can also be used to display simple text. Outputs a plain text file with extension .qst. v_txt_qst textfilename.txt format: q_fontsize; [font size]; q_instetxt; [text to display]; q_emptyline; q_likert; [lowest_number highest_number (displays a Likert scale)] q_nominal; [label_1 label_2]; q_inputext; [size of the text input box]; q_img; [horizontal_position image.gif (displays a .gif image)] q_linefreeze; [on or off, default is off] q_contbutton; [text to display (continues to next step)]; q_flushbutton; [text to display (flushes questionnaire and continue to next step)]; q_contaspace; (no parameter, enables wiimote button A and space bar to advance to next step, default is disabled) Note: likert output is natural numbers, independent of the displayed range. prog_end [parameters]; Ends the current program. parameters: end: ends program restart: Wait 5 seconds and restart program from stage 3 ("input number of participant") ------------------------------------------------------------------- Preset Keys ----------- Notes: - Preset keys are valid for a_datacap_qstn. - v_txt_qst accepts all keys and numbers. - v_datacap_stroop has preassigned keys for colours. - wiimote A or space bar will record 1 or 0. - Tested on Apple Macintosh operating system 10.8 code: wii//keyboard1/keyboard2 (100,0): A/spacebar 1: -//1 2: home//2 3: +//3 4: 1//y/Y 5: 2//n/N 6: a/A 7: s/S 8: d/D 9: j/J 10: k/K 11: l/L ------------------------------------------------------------------- Stroop Test Colours Codes and Keys ---------------------------------- code: key = colour 1: A = red 2: S = yellow 3: D = green 4: J = blue 5: K = purple 6: L = white ------------------------------------------------------------------- Files Handling ---------------- All the files required and produced by a Visuaural program should be in the same folder where the program is (meaning the Visuaural procedure program as described in this document, not Visuaural itself). =================================================================== Version log ----------- 0.1.1 - a_datacap_rt_nom now records 100 or 0. Previously was 1 or 0. - a_datacap_rt_wii_y now continually records wii pitch position. Previously recorded zeros when wii was not moving in pitch direction. 0.1.2 - a_simpleplay has replaced a_play - a_randomplay command added - Data capture rate option has been added to the set-adjust-test window. Available rates are 4 Hz, 10 Hz and 100 Hz. - q_endbutton removed from v_txt_qst - q_nominal, q_img, q_linefreeze, q_contbutton, q_flushbutton and q_contaspace added to v_txt_qst - parameter "on" added to v_disptxt - v_disptxt_count command added ------------------------------------------------------------------- Copyright 2013-2014 Juan Ignacio Mendoza