SH ROTATION CODE TESTBED
========================

(C) Christian Lessig & Tyler de Witt, University of Toronto, 2011.

REQUIREMENTS:
=============

- Boost
- GSL 

For MacOS if problems occur with Fortran install gfortran binaries from: http://gcc.gnu.org/wiki/GFortranBinaries

We provide pre-compiled libraries for some of the algorithms from the literature where code was available by the original authors, sometimes with slight modifications by us to either integrate it in our test framework or to optimize it for fair performance comparisons. The source code is available in the legacy directory and depending on the architecture it might be necessary to re-compile the libraries.

COMMAND LINE PARAMETERS:
========================

max-band            Maximum band. 
num-iterations      For performance test, the number of iterations used to average 
		                over to time rotation algorithms.

accuracy	          Set '--accuracy=1' to perform an accuracy test
num-rotations       Number of (random) rotations per band for accuracy test

GRAPHS
======

The C++ executable generates a data file that can be viusalized with the scripts in the Matlab directory.

EXTERNAL CODE
=============

Please see the legacy directory.

Halton sequence code is from http://people.sc.fsu.edu/~burkardt/cpp_src/halton/halton.html (downloaded on 18/08/2009).

Software License for MTL

Copyright (c) 2007 The Trustees of Indiana University. 
              2008 Dresden University of Technology and the Trustees of Indiana University. 
All rights reserved.
Authors: Peter Gottschling and Andrew Lumsdaine

This file is part of the Matrix Template Library

Dresden University of Technology -- short TUD -- and Indiana University -- short IU --
have the exclusive rights to license this product under the following license.

Redistribution and use in source and binary forms, with or without modification, are permitted 
provided that the following conditions are met:
	1.  	All redistributions of source code must retain the above  copyright notice, 
		the list of authors in the original source code,  this list of conditions and 
		the disclaimer listed in this license;
	2.  	All redistributions in binary form must reproduce the above  copyright notice, 
		this list of conditions and the disclaimer listed  in this license in the 
		documentation and/or other materials  provided with the distribution;
	3.  	Any documentation included with all redistributions must include  the 
		following acknowledgement:
		"This product includes software developed at the University of Notre Dame,  
		 the Pervasive Technology Labs at Indiana University, and Dresden University of
		 Technology. For technical information  
		 contact Andrew Lumsdaine at the Pervasive Technology Labs at Indiana University. 
		 For administrative and license questions contact the  Advanced Research and 
		 Technology Institute at 1100 Waterway  Blvd. Indianapolis, Indiana 46202, 
		 phone 317-274-5905, fax  317-274-5902."
 		Alternatively, this acknowledgement may appear in the software itself, and 
		wherever such third-party acknowledgments normally appear.
	4.  	The name "MTL" shall not be used to endorse or promote  products derived from 
		this software without prior written  permission from IU or TUD. For 
		written permission, please  contact Indiana University Advanced Research 
		& Technology  Institute.
	5.  	Products derived from this software may not be called "MTL", nor may "MTL" 
		appear in their name, without  prior written permission of Indiana University 
		Advanced Research & Technology Institute.

TUD and IU provide no reassurances that the source code provided does not infringe the 
patent or any other intellectual property rights of any other entity. TUD and IU disclaim 
any liability to any recipient for claims brought by any other entity based on infringement of 
intellectual property rights or otherwise.

LICENSEE UNDERSTANDS THAT SOFTWARE IS PROVIDED "AS IS" FOR WHICH NO WARRANTIES AS TO CAPABILITIES 
OR ACCURACY ARE MADE. DRESDEN UNIVERSITY OF TECHNOLOGY AND INDIANA UNIVERSITY GIVE NO WARRANTIES 
AND MAKE NO REPRESENTATION THAT SOFTWARE IS FREE OF INFRINGEMENT OF THIRD PARTY PATENT, COPYRIGHT, 
OR OTHER PROPRIETARY RIGHTS.  DRESDEN UNIVERSITY OF TECHNOLOGY AND INDIANA UNIVERSITY MAKE NO 
WARRANTIES THAT SOFTWARE IS FREE FROM "BUGS", "VIRUSES", "TROJAN HORSES", "TRAP DOORS", "WORMS",
OR OTHER HARMFUL CODE. LICENSEE ASSUMES THE ENTIRE RISK AS TO THE PERFORMANCE OF SOFTWARE AND/OR 
ASSOCIATED MATERIALS, AND TO THE PERFORMANCE AND VALIDITY OF INFORMATION GENERATED USING SOFTWARE.

