m@0: AUTHOR
m@0: 
m@0: Marcus Pearce <m.pearce@gold.ac.uk>
m@0: 
m@0: 
m@0: USAGE 
m@0: 
m@0:   java Experiment <multiple> <n> <scale length> <low anchor> <high anchor>
m@0: 
m@0: where <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@0: tatum as specified by <multiple>. <scale length> is the number of
m@0: levels of the rating scale and <low anchor> and <high anchor> are its
m@0: high and low anchors respectively (e.g., "highly unexpected", "highly
m@0: expected" with a scale length of 7). See runExperiment.bat for an example.
m@0: 
m@0: To use in a study:
m@0: 
m@0: 1. put the relevant midi files in Data/Midi;
m@0: 
m@0: 2. edit pfilelist.txt and filelist.txt to contain the midi files
m@0: played in the practice and main blocks respectively: put one file on
m@0: each line followed by a list of note numbers to probe with the visual
m@0: clock.
m@0: 
m@0: 3. edit Data/instructions.html if necessary.
m@0: 
m@0: The results are written to files in the Results/ directory.
m@0: 
m@0: 
m@0: FILES AND DIRECTORIES: 
m@0: 
m@0: Data/: 
m@0:   - instructions.html: the 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