m@0: AUTHOR
m@0: 
m@0: Marcus Pearce <m.pearce@gold.ac.uk>
m@0: 
m@0: 
m@0: USAGE 
m@0: 
m@7:   java Experiment <show clock?> <multiple> <n> <midi device> <scale length> <low anchor> <high anchor> <midi file directory> <instructions file>
m@0: 
m@3: where <show clock?> specifies whether to show the clock (0 = no; 1 =
m@3: yes) and <multiple> and <n> are integers: the clock runs for <n> time
m@0: units before a probed event where the time unit is a multiple of the
m@3: tatum as specified by <multiple>.
m@1: 
m@1: <midi device> is an integer specifying the midi device to use (usually 0).
m@1: 
m@1: <scale length> is the number of levels of the rating scale and <low
m@1: anchor> and <high anchor> are its high and low anchors respectively
m@1: (e.g., "highly unexpected", "highly expected" with a scale length of
m@1: 7). 
m@1: 
m@4: <midi file directory> is the directory where the midi files are stored
m@4: 
m@7: <instructions file> is an html file containing the instructions for
m@7: the participant which will be displayed at the beginning of the
m@7: experiment.
m@7: 
m@1: See runExperiment.bat for an example.
m@0: 
m@0: To use in a study:
m@0: 
m@4: 1. put the relevant midi files in the directory specified by <midi
m@4: file directory> (e.g., Data/Midi/)
m@0: 
m@7: 2. edit pfilelist.txt and filelist.txt (also in <midi file directory>)
m@7: to contain the midi files played in the practice and main blocks
m@4: respectively: put one file on each line followed by a list of note
m@7: numbers to probe with the visual clock. NB: that the last line of
m@7: these files must terminate with a newline.
m@0: 
m@7: 3. edit Data/instructions.html if necessary or create a new set of
m@7: instructions.
m@0: 
m@0: The results are written to files in the Results/ directory.
m@0: 
m@6: 4. responses can be given either using the mouse or using the numeric
m@6: keys (except in the case of a scalelength of 2 where the keys 'q' and
m@6: 'p' are used).
m@0: 
m@0: FILES AND DIRECTORIES: 
m@0: 
m@0: Data/: 
m@7:   - instructions.html: the default instructions file 
m@0:   - pfilelist.txt: the list of midi filenames in the practice block 
m@0:   - filelist.txt: the list of midi filenames in the main block 
m@0:   - Midi/: the location of the midi files specified above
m@0: 
m@0: Results/: 
m@0:   - the results are written to files in this directory 
m@0: 
m@0: Icons/: 
m@0:   - contains icons used for the GUI
m@0: 
m@0: 
m@0: DEVELOPMENT 
m@0: 
m@0: The code is organised according to a MVC structure: 
m@0: 
m@0: Model:      Experiment.java 
m@0:              - FileList.java           
m@0:              - ProbeID.java
m@0:              - MidiPlayer.java
m@0:              - MelodyResults.java   
m@0:              - SubjectResults.java
m@0:              - Block.java 
m@0: 
m@0: View:       ExperimentGui.java 
m@0:              - Clock.java
m@0:              - InstructionsPanel.java
m@0:              - StimulusPanel.java
m@0:              - SubjectDataPanel.java
m@0:              - InterBlockPanel.java
m@0: 
m@0: Controller: ExperimentController.java