---------------------------------------------------------------------------
diffuse_reflect v0.01 (Oct 21, 2012)
http://people.csail.mit.edu/hasinoff/diffuse/
---------------------------------------------------------------------------

Software distribution to accompany:
  [1] Samuel W. Hasinoff, Anat Levin, Philip R. Goode, and 
      William T. Freeman, Diffuse Reflectance Imaging with Astronomical 
      Applications. Proc. 13th IEEE International Conference on Computer 
      Vision, ICCV 2011, pp. 185-192

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

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


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 diffuse_reflect package on your 
MATLAB path at startup:

diffuseBase = 'c:\mymatlab\externalpkgs\';  % wherever you did the unzipping
addpath([diffuseBase,'diffuse_reflect']);
addpath([diffuseBase,'diffuse_reflect\utils']);
addpath([diffuseBase,'diffuse_reflect\ephemerides']);
addpath([diffuseBase,'diffuse_reflect\geometry']);
addpath([diffuseBase,'diffuse_reflect\brdf']);
addpath([diffuseBase,'diffuse_reflect\reconstruct']);


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

- The code has been tested on MATLAB 7.10 for Windows, and requires 
  the signal processing and image processing toolboxes for minor things. 

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

- Calculation of emphemerides follows the treatment in "Astronomy on the 
  Personal Computer" (2000) by Oliver Montenbruck and Thomas Pfleger.
  http://www.springer.com/book/978-3-540-67221-0

- Atmospheric data were obtained from the NASA Langley Research Center 
  Atmospheric Science Data Center.  
  http://eosweb.larc.nasa.gov

- The core function is astronomical.m, which builds the transfer matrices
  based on reflectance models and the astronomical geometry.
  
- 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_moon     simulations reconstructing Earth from its
                    reflection in the moon
    driver_clouds     ... while modeling time-varying clouds
    driver_mars     simulations and real reconstructions of Mars
                    from single-pixel photometry

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

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

Copyright (c) 2012 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.