General Information

This is spatial_domain_toolbox, a collection of matlab functions
and scripts written by Gunnar Farnebäck. Originally this contained
implementations of some of the algorithms described in his Ph.D. thesis
"Polynomial Expansion for Orientation and Motion Estimation" but has
subsequently been extended with other algorithms. A common theme is
that the algorithms work on multidimensional signals and are designed
and used directly in the spatial (or spatiotemporal) domain, without
involving e.g. Fourier or wavelet transforms. Some functions even more
generally apply to  multidimensional arrays. 

Download instructions for the latest version should be available at
http://www.imt.liu.se/mi/tools/.

Author is Gunnar Farnebäck, gunnar@lysator.liu.se.


				 News

See the files NEWS and ChangeLog.


			       License

This is free software, published under the GNU General Public License
(GPL). What this basically means is that you are free to use, modify,
and redistribute the program under the same license. See the file
COPYING for details. If you want to use this code in a way that is not
covered by the license, contact the author to negotiate a different
license.


			    Prerequisites

In order for this toolbox to be useful, you need to have Matlab
installed. The toolbox has been tested with Matlab 7.


			     Installation

Clone the repository and add the directory to the Matlab search path.
You also need to compile the C mex files. This is most easily done by
running the following code in the toolbox directory:

files = dir();
for name = {files.name}
    file = name{1};
    if file(end) == 'c' && file(end-1) == '.'
        mex(file);
    end
end


			      References

The Ph.D. thesis, as well as a number of related papers, can be
found at either of these pages:

http://lmi.bwh.harvard.edu/papers/gunnar.html
https://www.researchgate.net/profile/Gunnar_Farnebaeck
http://www2.cvl.isy.liu.se/ScOut/Theses/PaperInfo/farneback02.html
http://www.diva-portal.org/smash/get/diva2:273847/FULLTEXT01.pdf


			 Further Development

At this point it is unlikely that more new algorithms or functions
will be added. Bugfixes may still appear.
Development versions are available at GitHub,
https://github.com/GunnarFarneback/spatial_domain_toolbox

The previously used subversion repository at
http://lsvn.lysator.liu.se/svnroot/spatial_domain_toolbox/trunk
has been closed.


			     Bug Reports

Please send bug reports, bug fixes, improvements, and success stories
to the author at gunnar@lysator.liu.se. The toolbox is of course
provided as is, no warranty, etc.


Linköping 2014-07-22
Gunnar Farnebäck