%--------------------------------------------------------------------------
%  Version 1.0 March 2005
%  Copyright (c) 2005-2010 by Center for Unified Biometrics and Sensors
%  www.cubs.buffalo.edu
%
%cubs_demo
%demonstrates the capabilities of the CUBS fingerprint toolbox
%Contact:
%   ssc5@cubs.buffalo.edu, sharat@mit.edu
%   http://www.sharat.org
%Reference:
%1. S. Chikkerur, C.Wu and V. Govindaraju, "Systematic approach for feature
%extraction in Fingerprint Images", ICBA 2004
%2. S. Chikkerur and V. Govindaraju, "Fingerprint Image Enhancement using 
%STFT Analysis", International Workshop on Pattern Recognition for Crime 
%Prevention, Security and Surveillance, ICAPR 2005
%3. S. Chikkeur, "Online Fingerprint Verification", M. S. Thesis,
%University at Buffalo, 2005
%4. T. Jea and V. Govindaraju, "A Minutia-Based Partial Fingerprint Recognition System", 
%to appear in Pattern Recognition 2005
%5. S. Chikkerur, "K-plet and CBFS: A Graph based Fingerprint
%   Representation and Matching Algorithm", submitted, ICB 2006
%
% See also: cubs_visualize_template, cubs_match, cubs_enroll
%--------------------------------------------------------------------------
function cubs_demo
    %------------------------
    %blurb
    %------------------------
    clc;
    disp('---------------');
    disp('CUBS FP Toolbox')
    disp('---------------');
    disp('The toolbox contains matlab interfaces to fingerprint feature extraction and matching algorithm developed at the');
    disp('Center for Unified Biometrics and Sensors (http://www.cubs.buffalo.edu). The details of the algorithm');
    disp('are outlined in the following references.');
    disp('References:');
    disp('-----------');
    disp('1. S. Chikkerur,C. Wu and Govindaraju, A Systematic approach for feature extraction in fingerprint images",ICBA 2004');
    disp('2. T. Jea and V. Govindaraju, A Minutia-Based Partial Fingerprint Recognition System, to appear in Pattern Recognition, 2005');
    disp('3. T. Jea , V. Chavan, V. Govindaraju and J. K. Schneider, Security and matching of partial fingerprint recognition systems, Proceeding of SPIE,no. 5404, 2004 ');
    disp('4. S. Chikkerur and V. Govindaraju,Fingerprint Image Enhancement using STFT Analysis, International Workshop on Pattern Recognition for Crime Prevention, Security and Surveillance, ICAPR 2005');
    disp('5. S. Chikkeur, "Online Fingerprint Verification", M. S. Thesis,University at Buffalo, 2005');
    disp('6. S. Chikkerur, "K-plet and CBFS: A Graph based Fingerprint Representation and Matching Algorithm');
    disp('Press any key to continue..');
    fprintf('\n\n');
    %------------------------
    %feature extraction
    %------------------------
    disp('It is extremely simple to extract features using the CUBS toolbox');
    disp('The features can be extracted by simply calling cubs_enroll');
    disp('Let us extract features of this image..');
    figure,imshow('1_1.tif'),title('Original Image');
    disp('Press any key to continue..');
    pause;
    
    %------------------------
    %enhancement
    %------------------------
    cubs_enroll('1_1.tif','1_1.fp');
    disp('The feature extraction process is carried out in four steps');
    disp('1.Enhancement - CUBSEnhanced.bmp');
    figure,imshow('CUBSEnhanced.bmp'),title('Enhanced Image');
    disp('Press any key to continue..');
    fprintf('\n\n');
    pause;
    %------------------------
    %enhancement
    %------------------------
    disp('2.Binarization - CUBSBinary.bmp');
    figure,imshow('CUBSBinary.bmp'),title('Binarized Image');
    disp('Press any key to continue..');
    fprintf('\n\n');
    pause;

    %------------------------
    %feature extraction
    %------------------------
    disp('2.Feature Extraction - CUBSBinary.bmp');
    figure,imshow('CUBSContour.bmp'),title('Features using chain code contour');
    disp('Press any key to continue..');
    fprintf('\n\n');
    pause;
    
    %------------------------
    %feature extraction
    %------------------------
    disp('The features can best be visualized using cubs_visualize_template');
    figure,cubs_visualize_template('1_1.fp');
    title('Minutiae Features');
    disp('Press any key to continue..');
    fprintf('\n\n');
    pause;

    %------------------------
    %matching
    %------------------------
    close all;
    disp('Now let us consider the matching process');
    disp('The features extracted can be matched using cubs_match. The algorithm matches even upside down templates');
    disp('Case I: Genuine pair');
    figure,subplot(1,2,1),cubs_visualize_template('1_1.fp');
    subplot(1,2,2),cubs_visualize_template('1_2.fp');
    drawnow;
    score = cubs_match('1_1.fp','1_2.fp');
    disp('Press any key to match');
    fprintf('------------------------\n');
    fprintf('Matching score is %d\n',score);
    fprintf('------------------------\n');
    msgbox(sprintf('Score is %d',score));
    disp('Press any key to continue..');
    fprintf('\n\n');
    pause;

    disp('Case II: Impostor pair');
    figure,subplot(1,2,1),cubs_visualize_template('1_1.fp');
    subplot(1,2,2),cubs_visualize_template('2_1.fp');
    drawnow;
    score = cubs_match('1_1.fp','2_1.fp');
    disp('Press any key to match');
    fprintf('------------------------\n');
    fprintf('Matching score is %d\n',score);
    fprintf('------------------------\n');
    msgbox(sprintf('Score is %d',score));

    disp('Press any key to continue..');
    fprintf('\n\n');
    pause;

    %------------------------
    %Thanks
    %------------------------
    disp('Thanks for evaluating CUBS(www.cubs.buffalo.edu) FPToolbox');
    disp('Please send comments and bug reports to: ssc5@cubs.buffalo.edu,sharat@mit.edu');
%end function cubs_demo