Parallel Implementation - VQ Algo on CBE Files

%% README.txt -- VQ Algorithm Parallel Implementation 
%% * Version 0.1
%% * Copyright (C) 2008 International Institute of Information Technology(IIITB), Bangalore, INDIA
%% *
%% * This software is provided 'as-is', without any express or implied
%% * warranty.  In no event will the authors be held liable for any damages
%% * arising from the use of this software.
%% *
%% * This program is free software: you can redistribute it and/or modify
%% * it under the terms of the GNU General Public License as published by
%% * the Free Software Foundation, either version 3 of the License, or
%% * (at your option) any later version.
%% *
%% * This program is distributed in the hope that it will be useful,
%% * but WITHOUT ANY WARRANTY; without even the implied warranty of
%% * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
%% * GNU General Public License for more details.
%% *
%% * You should have received a copy of the GNU General Public License
%% * along with this program.  If not, see <http://www.gnu.org/licenses/>.
%% *
%% *
%%  @authors
%%  Sivaramakrishna			sivarama.krishna@iiitb.ac.in 
%%  Rakesh Kasibhatla		 	rakesh.kasibhatla@iiitb.ac.in	
%%  Manish Thaper				manish.thaper@iiitb.ac.in	
%%  Sangram Mohanty			sangram.mohanty@iiitb.ac.in
%%  Manoj Mudakavi			mm.manoj@iiitb.ac.in
%%

	Image Compression - Vector Quantization Algorithm(Parallel Implementation)

Target:
	CBE-Linux PPE and SPE (HW or simulator)

Description:
	This directory contains an implementation of image compression
	technique using vector quantization. 

	    SPE library   		    lib_vquantize_spu.a
	    -------------------		    -------------------
	    PPE	executable                       vquantize

	All the executables containing SPE code are built such that the SPE
	programs are embedded into the PPE executable.

Installing the Code : 
In the example directory
1. Specify path to 'make.footer'
-> export MAKE_FOOTER = <path to make.footer>

2. make

How to run:
	Invoke the executable at the Linux command prompt. 

	vquantize <datafile> <codebook size> <delta> <threshold value>

	COMMAND ARGUMENTS:
	
	datafile	- image input file(containing data in text format)
	codebook size	- Number of codebook vectors required
	delta		- variation values need to be done for each codevector
	threshold 	- Maximum distortion that can occur.

	For Example:
	
	vquantize testdata2.txt 512 0.1 0.001

	- For profiling use the -DPROFILING flag (Makefile in spu directory).
Notes:
	Additional information can be found within the source code.