---------------------------------------------------------------------------
timecon v0.11 (Sep 21, 2009)
http://www.cs.toronto.edu/~hasinoff/timecon/
---------------------------------------------------------------------------

Software distribution to accompany:
  [1] Samuel W. Hasinoff, Kiriakos N. Kutulakos, Frédo Durand, and 
      William T. Freeman, Time-Constrained Photography. Proc. 12th IEEE 
      International Conference on Computer Vision, ICCV 2009, 8 pp.
  [2] Samuel W. Hasinoff, Variable-Aperture Photography. PhD Thesis, 
      University of Toronto, Dept. of Computer Science, 2008.


CITATION INSTRUCTIONS
---------------------------------------------------------------------------

If you use this software, you should cite the paper [1]. 

This package includes MRF code developed by other people, from 
http://vision.middlebury.edu/MRF/, in slightly modified form. 
Please see the file timecon\mrf\zabih\README.txt for further 
citation instructions.


VERSION HISTORY
---------------------------------------------------------------------------

v0.1  (Sep 16, 2009) initial release
v0.11 (Sep 21, 2009)


INSTALLATION
---------------------------------------------------------------------------

1. Unzip, making sure to preserve the directory structure.
2. Open your MATLAB startup file:

edit startup.m

3. Add the following lines, to put the timecon package on your 
MATLAB path at startup:

timeconBase = 'c:\mymatlab\externalpkgs\';  % wherever you did the unzipping
addpath([timeconBase,'timecon']);
addpath([timeconBase,'timecon\camera']);
addpath([timeconBase,'timecon\common']);
addpath([timeconBase,'timecon\dof']);
addpath([timeconBase,'timecon\mrf']);


GUIDE TO THE CODE
---------------------------------------------------------------------------

- The code has been tested on MATLAB 7.3 and 7.6 for Windows, and requires 
  the signal processing and image processing toolboxes for minor things. 
  I've precompiled the MRF code for 32-bit Windows (zabih.exe), and also 
  for 64-bit x86 Linux (zabih).

- The individual MATLAB files in the package are documented to varying 
  levels of completeness. Best of luck!

- The driver files illustrate sample usage of all the functions in 
  the package, and reproduce some of the computations used to create the 
  graphs/images in the paper.

    driver_main          precomputes required OTFs, general testing
    driver_synImage      generates Fig.4 results
    driver_synImageDFD   generates Fig.5 results
    driver_SNR1D         generates Fig.6 results

  Some of the scripts need to be run from the directory where
  timecon was installed, ie. you should first execute the command
  "cd([timeconBase,'timecon'])".

- The core routines for deconvolution, model selection, and variance 
  estimation (ie. to estimate SNR) using a Gaussian observation and
  prior models are implemented in two different ways in 
  "estimateImgOverDepth" and "gaussDeconv", and related functions. 

  There's some overlap in the functionality of these implementations. 
  The former allows a more general noise covariance matrix to be specified, 
  and computes the evidence in the Fourier domain, but returns a single 
  log-evidence value for the whole image. The latter works exclusively for 
  diagonal noise covariance, and it uses a spatial-domain approach to 
  compute the log-evidence on a per-pixel basis.

- To analyze a new camera model, modify "defocusMTF" to generate the 
  corresponding OTF for the given set of frequencies, at the given 
  level of defocus.


MIT LICENSE
---------------------------------------------------------------------------

Copyright (c) 2009 Sam Hasinoff

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.