--------------------------------------------------------------------------------
Project Name:  Image Filter Arrays
Author: 	      J Peterson
Course:		   PSYCH 221	
Description:	README file for theoretical simulations.
--------------------------------------------------------------------------------

Folder Contents:
-----------------
   - CZPAnalysis.m
   - CreateAmplitudeSensor.m
   - CreateAmplitudeWidthSensor.m
   - CreateUniformSensor.m
   - DefineCZPScene.m
   - DefineMTFScene.m
   - DefineMacBethScene.m
   - DefineOptics.m
   - DefineRealWorldScene.m
   - DefineSensor.m

   - Images

   - InitializeProject.m
   - MTFAnalysis.m
   - MacBethAnalysis.m
   - ProcessImage.m
   - RealWorldAnalysis.m
   - Results.mat
   - Results_3.mat
   - Results_4.mat
   - Results_5.mat
   - Results_6.mat
   - Results_7.mat
   - RunProject.m
   - WavelengthToRGB.m
   - XYZ.mat
   - imgCzp.m
   - sceneCreate.m
   - sceneCreate.m~
   - sensorColorFilter.m


Program Structure
------------------
ISET allows us to simulate each aspect of the image pipeline. In order to
create a modular design, each of the main components in the processing
pipeline are given their own MATLAB script.

Scripts of particular importance:
* InitializeProject.m - This file contains all project-wide settings. This is
  the equivalent of a set of #defines, which allows specific parameters to be
  changed easily at a global level.

* RunProject.m - This file contains the main run-loop of the project. In order
  to run the simulations, this script should be executed. Each of the other 
  scripts in this folder are called from this main script.

* CreateUniformSensor.m - Defines the settings for a uniform sensor arrangement

* CreateAmplitudeSensor.m - Defines the settings for a Height-Scaled sensor design

* CreateAmplitudeWidthSensor.m - Defines the all-scaled sensor design

Loops:
The project has one main loop with an inner nested loop. The main loop iterates
over different analysis types: MTF, Macbeth, Real World, and CZP. The inner
loop iterates over a different number of color filters in the sensor configuration.
The default range is from 3 to 7 different colors. If you want to limit the
analysis done, or limit the number of sensors, these values are defined within
the RunProject.m script.


Data Output
------------
A Results.mat file is generated which contains the MTF-50 and Average Delta-E
arrays. At the end of the RunProject.m file, this mat file is opened and a
figure (./Images/Results.eps) is generated. This figure is the main summary
of the simulations run.

A number of images are generated in the './Images/' subfolder. These images
should be clearly named, and all should be in *.eps format.


<End of File>
