					README

version
-------
23 Oct. 2007

contact
-------
Minho Kim (mhkim@cise.ufl.edu)
SurfLab research group (http://www.cise.ufl.edu/research/SurfLab)
C.I.S.E. Department (http://www.cise.ufl.edu)
University of Florida

required packages
-----------------

1. Kobbelt's box spline evaluation package (included in `box_eval' subdirectory)

	http://www.netlib.org/numeralgo
	(Download http://www.netlib.org/numeralgo/na11 and execute it to extract MATLAB scripts.)

	or

	http://www.graphics.rwth-aachen.de/index.php?id=21

	* Note that we need to include 'r' option for the 'null' function call in 'box_norm.m' routine.

2. de Boor's box spline evaluation package (included in `deboor' subdirectory)

	http://pages.cs.wisc.edu/~deboor/deboorreadme.html

	* contained in the paper `On the evaluation of box splines'

3. `reparray' MATLAB utility (included in `common' subdirectory)

	http://home.online.no/~pjacklam/matlab/software/util/fullindex.html
	http://home.online.no/~pjacklam/matlab/software/util/matutil/reparray.m

4. `subset' MATLAB package (included in `subset' subdirectory)

	http://people.scs.fsu.edu/~burkardt/m_src/subset/subset.html

5. `mri_toolbox' MATLAB package (included in `mri_toolbox_v1.5' subdirectory)

	http://eeg.sourceforge.net/

demo list
---------

* common/demo_lobb.m

	- Generates the test data samples from the following paper and renders its isosurface.
		``An Evaluation of Reconstruction Filters for Volume Rendering'' (Stephen R. Marschner and Richard J. Lobb)
		http://www.cs.cornell.edu/~srm/publications/Vis94-filters-abstract.html

* common/demo_normals.m

	- Lists all the normal vectors of the knot planes defined by a direction matrix.

* common/demo_quasi_interpolant.m

	- Shows the coefficients of the quasi-interpolant for the given (tri-variate) box-spline.

* common/demo_rho.m

	- Computes `rho' for the given box-spline direction matrix.
	- For the definition of `rho', refer to
		`` Box-spline based CSG blends'' (Jorg Peters and Michael Wittman)
		http://www.cise.ufl.edu/research/SurfLab/pre99-papers/jorgs_papers.html

* common/demo_support.m

	- Computes and visualizes the support of the given tri-variate box-spline.

* common/demo_support_mesh.m

	- Lists the mesh points (points on Z^s) where the given box-spline value is non-zero.

* 6dir/d6_demo_eval_plot_bez_basis.m

	- Evaluates and visualizes several level sets of the 6-direction box-spline.

* 6dir/d6_demo_export_povray_bez_basis.m

	- Exports the 6-direction box-spline in POV-Ray script format.

* 6dir/d6_demo_export_povray.m

	- Exports the quasi-interpolated input data in POV-Ray script format.

* 6dir/d6_demo_reconstruct.m

	- Reconstructs and renders its isosurface of the input data. (no quasi-interpolation)

* 7dir/d7_demo_eval_plot_bez_basis

	- Evaluates and visualizes several level sets of the 7-direction box-spline.

* 7dir/d7_demo_export_povray_bez_basis.m

	- Exports the 7-direction box-spline in POV-Ray script format.

* 7dir/d7_demo_reconstruct.m

	- Reconstructs and renders its isosurface of the input data. (no quasi-interpolation)


