https://github.com/Lupphes/LatentFingerprintGrader
A system for identifying latent fingerprints. Note: This software is no longer being updated or maintained.
Created at Michigan State University by Anil K. Jain, Kai Cao, Dinh-Luan Nguyen, and Cori Tymoszek. This work is sponsored by IARPA.
This research software is provided as-is with no warranty, support, or maintenance. It is intended as a companion for our publications listed below, and as a reference point for other research groups pursuing similar work. The code authors are unable to provide assistance with troubleshooting.
| Date | Update |
|---|---|
| 2022-03-05 | Lupphes started modification for Python3.7 fork |
| 2019-04-24 | Template extraction and Matching code |
| 2019-04-28 | Added sample latent images |
Feature extraction code:
Please refer to environment.yml file
Please refer to requirements.txt
Matching code: Please install the required C++ dependencies:
Please download the models from Google Drive. These models are pretrained on a forensic (not synthetic) dataset.
The forensic datasets used in our experiments (including NIST SD27, MSP, etc.) are not available for public distribution. However, we have provided 3 latent fingerprint images from NIST SD27 in the /sample_data/ folder, along with their rolled mates. We have also provided the rank and similarity score computed by the system for these samples.
The latent fingerprint images in NIST SD27 are divided into three categories, "good", "bad", and "ugly", based on the quality of the fingerprint. The sample images contain one pair from each category.
Place the models folder in the root of the repository (same level as extraction and matching folders).
Further detailed older instructions for installation and use can be found in the User Guide PDF. Short instructions:
Use this command to create the environment and install the packages:
virtualenv --python=$(which python3.7) venv
source venv/bin/activate
pip3 install -r requirements.txt
Change afis.config file for your custom path.
There are two scripts to do this extraction - one for the latent images extraction/msu_latentafis/extraction_lat.py and one for the rolled reference images extraction/msu_latentafis/extraction_roll.py.
The general format of the usage is the same for both:
python scriptname.py --flag1=/path/to/a/folder/ --flag2=/path/to/another/folder/
Available flags for both extraction latent.py and extraction rolled.py are:
• --idir=/path/to/image/folder/: This flag points to a directory where all the images inside should be processed.
• --tdir=/path/to/template/folder/: This flag points to a directory where all the generated templates should be saved. Note that the software is configured to overwrite existing templates at this location in the case of name conflicts.
The C++ code to perform matching/identification is located in latentafis/matching/. First, the code must be compiled with the make command. Please ensure that the dependencies listed above are instaled. After that, the usage is as follows:
./match -flag /path/to/something
The flags available for the matcher are:
• -l: This flag is analogous to the --i flag in the feature extraction scripts. It specifies the path to a single .dat file for the latent query template.
• -ldir: This flag is analogous to the --idir flag in the feature extraction scripts. It specifies the path to a directory of latent .dat files for batch matching. The matcher will generate one score file for each latent in the directory.
• -g: This flag specifies the path to the directory containing the templates (as .dat files) for the rolled gallery.
• -s: This flag specifies the path to the directory where score files should be saved. Note that these will overwrite any existing score files at this location.
• -c: This flag specifies the path to a codebook file needed by the matcher. The codebook is provided, and should be located in the same folder as the matcher. The file name should be something like codebook EmbeddingSize 96 stride 16 subdim 6.dat.
Please cite following papers:
- K. Cao, D. Nguyen, C. Tymoszek, A. K. Jain, "End-to-end Latent Fingerprint Search", to appear in the IEEE transactions on Information Forensics and Security, 2019.
@article{cao2018end,
title={End-to-End Latent Fingerprint Search},
author={Cao, Kai and Nguyen, Dinh-Luan and Tymoszek, Cori and Jain, AK},
journal={arXiv preprint arXiv:1812.10213},
year={2018}
}
- D. Nguyen, K. Cao, A. K. Jain, "Automatic Latent Fingerprint Segmentation", in BTAS, 2018.
@inproceedings{nguyen2018automatic,
title={Automatic latent fingerprint segmentation},
author={Nguyen, Dinh-Luan and Cao, Kai and Jain, Anil K},
booktitle={IEEE International Conference on BTAS},
year={2018}
}
- K. Cao, A. K. Jain, "Latent Fingerprint Recognition: Role of Texture Template", in BTAS, 2018.
@article{cao2018latent,
title={Latent Fingerprint Recognition: Role of Texture Template},
author={Cao, Kai and Jain, Anil K},
journal={arXiv preprint arXiv:1804.10337},
year={2018}
}
- D. Nguyen, K.Cao, A. K. Jain, "Robust Minutiae Extractor: Integrating Deep Networks and Fingerprint Domain Knowledge", in ICB, 2018.
@inproceedings{Nguyen_MinutiaeNet,
author = {Dinh-Luan Nguyen and Kai Cao and Anil K. Jain},
title = {Robust Minutiae Extractor: Integrating Deep Networks and Fingerprint Domain Knowledge},
booktitle = {The 11th International Conference on Biometrics, 2018},
year = {2018},
}
- K. Cao and A. K. Jain, "Automated Latent Fingerprint Recognition", in the IEEE TPAMI, DOI 10.1109/TPAMI.2018.2818162, 2018.
@article{cao2019automated,
title={Automated latent fingerprint recognition},
author={Cao, Kai and Jain, Anil K},
journal={IEEE transactions on pattern analysis and machine intelligence},
volume={41},
number={4},
pages={788--800},
year={2019},
publisher={IEEE}
}