
		The EyeExpBox package and example

1.  Introduction 

	This README file describes the EyeExpBox computational
tool for analyzing landmark location uncertainty experiments.
The tool is described in Chapter 6 and 7 of the book "Precision
Landmark Location for Machine Vision and Photogrammetry,"
published by Springer (London, 2008).

	The EyeExpBox computational tool makes a precision
measurement of the error with which landmark location is
determined.

	An experiment in the EyeExpBox computational tool
represented by a directory containing images and pose data.  This
distribution is provided with an example experimental data in
directory E_25Mar05_35mm_d, which runs three example points of
experiments described in chapters 7 of "Precision"


2.  Disclaimer

	This software has been developed as an analysis package
as part of a PhD study.  It has not received the attention that
is needed to make it a friendly, easy to use program.  As such,

			  USER BEWARE

the documentation is limited (description is a fairer term) and
the user interface is idiosyncratic.  This README is intended
only to enable the user to run the example case.  From that
point, adaptation of the system to other applications is entirely
up to the user

	This software is freely available and comes with no
warranty.  This program is distributed in the hope that it will
be useful, but WITHOUT ANY WARRANTY, to the extent permitted by
law; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.

3. Configuration of EyeExpBox 

  * An experiment corresponds to an Experiment Directory
     containing images and configuration information.  

  * The Experiment Directory (e.g.,  E_25Mar05_35mm_d) must be 
    a sub-directory of directory Transfer.

  * At the start of processing, routine EyeExpConfig.m will move
    the Experiment Directory up one level, to directory EyeExpBox

  * If the experiment is re-processed, the Experiment directory
    must be moved back into directory Transfer. 


4.  Experimental Artwork 

    An example of the Experimental artwork is included as file 

       ./ExperimentalArtwork/Artwork.ps


5.  To Run the EyeExpBox example 

	An example include 3 experimental images is included.  
To run the EyeExpBox example case:


  a) Unpack file EYESystem.zip

  b) Check that example experimental images and configuration
     directory E_25Mar05_35mm_d is a sub-directory of ./Transfer

  c) Launch matlab with EyeExpBox as the working directory

  d) In matlab, execute >> EyeExpBoxExample

	EyeExpBoxExample.m requires about 2 minutes to run on an
Intel Core 2 Duo.


6.   What is produced by EyeExpBoxExample.m

	Execution moves directory E_25Mar05_35mm_d to
./EyeExpBox and populates it with intermediate results in
directories

     ./E_25Mar05_35mm_d/Phase2
     ./E_25Mar05_35mm_d/Phase3
     ./E_25Mar05_35mm_d/Phase4

	Several graphics are drawn, showing the triangles
produced by the nano-triangles estimator, as well as the
estimator results for estimators A, B, D, E.  See chapter 7 and 8
of Precision.


Cheers, 

Jose Gutierrez,  joe.natacha@ieee.org
Brian Armstrong, bsra@uwm.edu

