- Summary
- Brief description of the methods offered
- Citations
- Acknowledgments
- License
- Other open-source iris recognition repositories
The primary goal of this repository is to offer open-source academic iris recognition methods developed in the Computer Vision Research Laboratory at the Univesity of Notre Dame, IN, USA.
In addition to Python and/or Matlab codes of the offered methods, the repository also includes the C++ versions submitted to the Iris Exchange (IREX) 10 Identification Track administered by NIST’s Biometrics Research Laboratory. The C++ versions may serve as a model, from both organizational and software engineering points of view, that helps to bring more academic groups and their contributions to the IREX table.
There are a plethora of commercial and academic implementations of automated algorithms for iris identification, which differ in accuracy, time of execution, and generalization capabilities (to new sensors, subjects, ethnic groups, time between enrollment and verification, etc.). However, the many IREX evaluations have been populated largely by commercial (closed-source) algorithm submissions. It is desirable to use the capabilities of the IREX program to also incorporate open-source solutions, including those from academic institutions. There are at least three good reasons for this:
-
reproducible, trustworthy, and professionally-tested algorithms would serve as an important baseline and benchmark for academic efforts to design new iris recognition methods,
-
having an algorithm from an academic unit submitted to and vetted by IREX X may decrease the reluctance of the academic community to have their methods evaluated in the IREX program,
-
freely accessible, well-documented, and IREX-tested software packages may facilitate fast deployments of iris recognition in smaller-scale or pilot implementations before the adoption of professional solutions.
The authors made a significant effort to keep implementations of the same method methodologically equivalent. However, there may be slight differences in the performance among the C++/Python/Matlab implementations observed for the same method and the same data. This is related to differences in implementations of various computer vision and machine learning routines available in C++/Python/Matlab packages.
The HDBIF method leverages human perception capabilities in iris recognition. It utilizes N filtering kernels learned via Independent Component Analysis in a way to maximize the statistical independence of the filtered iris image patches identified, via eye tracking, as salient for humans:
The normalized iris image is then convolved with the human-driven filters and the results are binarized to calculate the iris template:
During matching, by utilizing the segmentation masks, the HDBIF method only considers overlapping iris regions between two iris templates and calculates the comparison score using fractional Hamming distance.
Related papers:
- A. Czajka, D. Moreira, K. Bowyer and P. Flynn, "Domain-Specific Human-Inspired Binarized Statistical Image Features for Iris Recognition," IEEE Winter Conference on Applications of Computer Vision (WACV), Waikoloa, HI, USA, pp. 959-967, 2019 [IEEEXplore]
- D. Moreira, M. Trokielewicz, A. Czajka, K. Bowyer and P. Flynn, "Performance of Humans in Iris Recognition: The Impact of Iris Condition and Annotation-Driven Verification," IEEE Winter Conference on Applications of Computer Vision (WACV), Waikoloa, HI, USA, pp. 941-949, 2019 [IEEEXplore]
This method considers Fuch's crypts as salient, localized, human-detectable features for iris matching. Crypts are extracted from images utilizing a strategy based on a sequence of morphological operations and connected component extractions as illustrated in the figure below:
The crypt masks found serve as the iris template in this method. The crypt masks are then matched using the Earth Mover's Distance.
Related paper: J. Chen, F. Shen, D. Z. Chen and P. J. Flynn, "Iris Recognition Based on Human-Interpretable Features," in IEEE Transactions on Information Forensics and Security, vol. 11, no. 7, pp. 1476-1485, 2016 [IEEEXplore]
Python and C++ versions
To train the pixel-wise segmentation model, we utilized a set of iris images with their corresponding ground truth masks, sampled from a large corpus of publicly-available datasets: i) BioSec, ii) BATH, iii) ND-Iris-0405, iv) CASIA-V4-Iris-Interval, v) UBIRIS v2, vi) Warsaw-BioBase-Disease-Iris v2.1, and vii) Warsaw-BioBase-Post-Mortem-Iris v2.0. The model architecture is illustrated below:
To train the model estimating the circular approximations of the iris boundaries, we utilize the Open Eye Dataset (OpenEDS). We filter the images from this dataset to exclude images where the iris is significantly off-center, carry out Hough transform to get the ground truth pupil and iris circle parameters, and utilize these images to train our circle parameter estimation model.
Here's an illustration of segmentations found by the given model on a few images from the public IREX X validation set:
Matlab version
The Matlab version of the segmenter uses the SegNet architecture. It was trained on the same set of iris images with their corresponding binary masks as the Python and C++ versions. Circular approximations are estimated by a Hough Transform applied to binary masks.
Related paper: M. Trokielewicz, A. Czajka, P. Maciejewicz, “Post-mortem iris recognition with deep learning-based image segmentation,” Image and Vision Computing, Vol. 94 (103866), Feb. 2020 [Elsevier] [ArXiv]
Research paper summarizing the IREX-X submissions of the HDBIF and CRYPTS methods:
@Article{ND_OpenSourceIrisRecognition_Paper,
author = {Siamul Karim Khan and Patrick J. Flynn and Adam Czajka},
journal = {...},
title = {{IREX X Open-Source Iris Recognition Methods}},
year = {2024},
issn = {...},
month = {...},
number = {...},
pages = {...},
volume = {...},
abstract = {...},
doi = {...},
keywords = {iris recognition;open source software},
publisher = {...},
}
This GitHub repository:
@Misc{ND_OpenSourceIrisRecognition_GitHub,
howpublished = {\url{https://github.com/CVRL/OpenSourceIrisRecognition/}},
note = {Accessed: April 18, 2024},
title = {{University of Notre Dame Open Source Iris Recognition Repository}},
authors = {Adam Czajka and Siamul Karim Khan and Mateusz Trokielewicz and Patrick J. Flynn},
}
-
The development of the C++ (IREX X-compliant) versions of the HDBIF and CRYPTS methods was supported by the U.S. Department of Commerce (grant No. 60NANB22D153). The views and conclusions contained in this document are those of the authors and should not be interpreted as representing the official policies, either expressed or implied, of the U.S. Department of Commerce or the U.S. Government.
-
The segmentation model used in the Matlab version of the HDBIF method was developed by Mateusz Trokielewicz at Warsaw University of Technology, Poland, and was part of his PhD dissertation advised by Adam Czajka.
This is a research open-source software. You are free to use it in your research projects upon citing the sources as indicated in the Citations section. Please discuss individual licensing options if you want to use this software for commercial purposes, or to create and distribute closed source versions.
This repository makes an attempt to list all available open source iris recognition algorithms offered by other teams. If you know a repository that should be included, but is not listed here, please open a pull request.
Source Codes: [official] [dockerized] [VMBOX: CiTER implementation]
Paper: N. Othman, B. Dorizzi, S. Garcia-Salicetti, „OSIRIS: An open source iris recognition software,” Pattern Recognition Letters, Volume 82, Part 2, pp. 124-131, 2016 [Elsevier]
Source Codes: [official]
Paper: C. Rathgeb, A. Uhl, P. Wild, and H. Hofbauer. “Design Decisions for an Iris Recognition SDK,” in K. Bowyer and M. J. Burge, editors, Handbook of iris recognition, Second edition, Advances in Computer Vision and Pattern Recognition, Springer, 2016 [Springer]
Source Codes: [official] (note: the weights were obtained directly from authors after requesting them)
Paper: S. Ahmad and B. Fuller, "ThirdEye: Triplet Based Iris Recognition without Normalization," IEEE International Conference on Biometrics Theory, Applications and Systems (BTAS), pp. 1-9, 2019 [IEEEXplore] [ArXiv]
Source Codes: [official]
Papers:
- Ren, M., Wang, Y., Sun, Z., & Tan, T. “Dynamic Graph Representation for Occlusion Handling in Biometrics,” Proceedings of the AAAI Conference on Artificial Intelligence, 34(07), pp. 11940-11947, 2020 [AAAI] [ArXiv]
- Ren, M., Wang, Y., Zhu, Y., Zhang, K., & Sun, Z. “Multiscale Dynamic Graph Representation for Biometric Recognition with Occlusions,” IEEE Transactions on Pattern Analysis and Machine Intelligence, 2023 [IEEEXplore] [ArXiv]
Source codes: [official]
Paper: A. Boyd, D. Moreira, A. Kuehlkamp, K. Bowyer, A. Czajka, „Human Saliency-Driven Patch-based Matching for Interpretable Post-mortem Iris Recognition,” IEEE Winter Conference on Applications of Computer Vision Workshops (WACVW), 2023 [IEEE/CVF]
Source codes: [official]
Blog post: [Worldcoin's Iris Recognition Inference System (IRIS)]