--------------------------------------------------------------------------------
Project Name:  Image Filter Arrays
Author: 	      J Peterson
Course:		   PSYCH 221	
Description:	README file for brute force simulations to 
		         design optimal sensor patterns.
--------------------------------------------------------------------------------

Folder Contents:
-----------------
MATLAB
   - 5_Color.eps
   
   - 5_Pattern
      - PatternSolver.m
      - PatternSolverData.mat
      - PatternSolverIndex.mat
      - PatternSolverVariables.mat

   - 6_Color.eps
   
   - 6_Pattern
      - PatternSolver.m
      - PatternSolverData.mat
      - PatternSolverIndex.mat
      - PatternSolverVariables.mat

   - 7_Color.eps
   
   - 7_Pattern
      - PatternSolver.m
      - PatternSolverData.mat
      - PatternSolverIndex.mat
      - PatternSolverVariables.mat
   
   - PatternProcessor.m
   
   - PatternVarying.eps
   
   - WavelengthToRGB.m


5-Color Pattern:
-----------------
In order to run the code to analyze the 5-color pattern, first change to the
5_Pattern directory.  The *.mat files contained within this folder are the
RESULTS of a previous test. If you plan to run the test from scratch, it is
acceptable to delete these files. Simply run the PatternSolver.m script. The 
default number of execution cycles is 5000. If you want to choose a different
number of execution cycles, this value is defined within the PatternSolver.m
script. The primary output will be contained within the PatternSolverData.mat
file. The other two *.mat files are just used to backup system variables between
loop iterations. We found that the ISET data structures grew with each loop iteration
so it was necessary to start fresh to avoid running out of memory.


6-Color Pattern:
-----------------
Same as the 5-Color Pattern case, except execute the script contained within
the 6_Pattern folder.


7-Color Pattern:
-----------------
Same as the 5-Color Pattern case, except execute the script contained within
the 7_Pattern folder.


Viewing the Results:
---------------------
Run the PatternProcessor.m script in the root of the MATLAB folder. Four *.eps 
files are generated as a result of the script:
   - 5_Color.eps: The "best" pattern for the 5-Color sensor array
   - 6_Color.eps: The "best" pattern for the 6-Color sensor array
   - 7_Color.eps: The "best" pattern for the 7-Color sensor array
   - PatternVarying.eps: A figure showing the distribution of each of the tests.


<End of File>
