====================================================
Circular Fast Fuzzy Iris Segmentation Demo Program:
====================================================

Address: http://fmi.spiruharet.ro/bodorin/arch/cffis.zip
File:   		cffisdemo.p
Application Type: 	Matlab R13 p-coded script 
Requirements: 	Image Processing Toolbox 

HOW TO RUN THE DEMO:
- unzip the archive in a new and empty directory;
- change the Matlab Current Directory to that new directory;
- at Matlab prompt type: cffisdemo
- new images (from Bath University Iris Database) can be added in "testimages" directory;
- the current demo version will work only with 1280x960 bmp or jpg or pgm images (from Bath University Iris Database);

COPYRIGHT ON PROGRAM FILES: 
N. Popescu-Bodorin, 2008-2009, All rights reserved.
I.   For commercial use of these resources (cffisdemo.p, fkmq.p, ibfkmq.p) prior written consent of the author is required.
II.  Academic/Educational use of these resources (cffisdemo.p, fkmq.p, ibfkmq.p) is welcomed and must be accompanied by the current copyright note or by the following citations:
	1. N. Popescu-Bodorin, Fast K-Means Image Quantization Algorithm and Its Application to Iris Segmentation, Scientific Bulletin, No.14/2008, University of Pitesti, ISSN 1453-116x, 
	2. N. Popescu-Bodorin, Circular Fast Fuzzy Iris Segmentation Demo Program, Artificial Intelligence & Computational Logic Laboratory, Spiru Haret University, http://fmi.spiruharet.ro/bodorin/archs/cffis.zip, 2009.
III. For distribution of these resources (cffisdemo.p, fkmq.p, ibfkmq.p) on any media, prior written consent of the author is required.
Program Files: cffisdemo.p, fkmq.p, ibfkmq.p, Copyright Nicolaie Popescu-Bodorin, 2008-2009, All rights reserved.
Email: bodorin@ieee.org
Mail: CP 77, OP 19, Bucharest 3, ROMANIA
Web: 
  http://fmi.spiruharet.ro/bodorin/
  http://www.limbistraine.com/ro/software/popescu-bodorin-nicolaie-en.html
  http://fmi.spiruharet.ro/bodorin/arch/cffis.zip
  http://fmi.spiruharet.ro/bodorin/arch/fkmq.zip

COPYRIGHT ON TEST IMAGES:
Bath University & Smart Sensors Ltd, All rights reserved.
All images used in the demo program ("testimages" directory) are owned by Bath University and Smart Sensors Ltd - UK. 
Individual application requesting acces to Bath University Iris Image Database can be made free of charge here:
http://www.bath.ac.uk/elec-eng/research/sipg/irisweb/
====================================================


====================================================
Fast k-Means (Image) Quantization / Incomplete Black FKMQ (enhancing pupil cluster / darker area):
====================================================
Address: http://fmi.spiruharet.ro/bodorin/archs/fkmq.zip
Files:   		fkmq.p, ibfkmq.p
Application Type: 	Matlab R13 p-coded script 

Funcion Call:
	OUT = fkmq(IN,n)
	where:	
		n is the desired number of clusters;
		IN is an uint8 Gray image or a uint8 RGB layer;
		OUT is of the same type as IN;
	
Matlab Code Examples:

	n = 8;
	IN = imread('yourgrayuint8image.jpg');
	ECM = fkmq(IN,n);
	figure;
	subplot(1,2,1); imshow(IN);  title('Original image');
	subplot(1,2,2); imshow(ECM); title(strcat( num2str(n), '-Means quantization' ));

	n = 8;
	IN = imread('youreyeimage.jpg');
	OUT = ibfkmq(IN,n);
	figure;
	subplot(1,3,1); imshow(IN);  title('Original Image');
	subplot(1,3,2); imshow(OUT); title(strcat( num2str(n), '-Means Black Enhacement' ));
	subplot(1,3,3); imshow(OUT==min(OUT(:))); title('Pupil Cluster');

COPYRIGHT ON PROGRAM FILES: 
N. Popescu-Bodorin, 2008-2009, All rights reserved.
I.   For commercial use of these resources (fkmq.p, ibfkmq.p) prior written consent of the author is required.
II.  Academic/Educational use of these resources (fkmq.p, ibfkmq.p) is welcomed and must be accompanied by the current copyright note or by the following citation:
	N. Popescu-Bodorin, Fast K-Means Image Quantization Algorithm and Its Application to Iris Segmentation, Scientific Bulletin, No.14/2008, University of Pitesti, ISSN 1453-116x, 
III. For distribution of these resources (fkmq.p, ibfkmq.p) on any media, prior written consent of the author is required.
Program Files: fkmq.p, ibfkmq.p, Copyright Nicolaie Popescu-Bodorin, 2008-2009, All rights reserved.
Email: bodorin@ieee.org
Mail: CP 77, OP 19, Bucharest 3, ROMANIA
Web: 
  http://fmi.spiruharet.ro/bodorin/
  http://www.limbistraine.com/ro/software/popescu-bodorin-nicolaie-en.html
===================================================