Implementation of the local and global unlinkability metrics for biometric template protection systems
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.md Update README.md Feb 9, 2018
evaluateUnlinkability.py Update evaluateUnlinkability.py Apr 11, 2018
hda-license.pdf first commit Dec 22, 2017
matedScores.hdf5 first commit Dec 22, 2017
nonMatedScores.hdf5 first commit Dec 22, 2017

README.md

Unlinkability Metrics

Implementation of the local and global unlinkability metrics for biometric template protection systems evaluation proposed in [TIFS18].

License

This work is licensed under license agreement provided by Hochschule Darmstadt (h_da-License).

Instructions

Dependencies

  • seaborn
  • numpy
  • pylab
  • matplotlib
  • argparse

Usage

  1. Run evaluateUnlinkability.py

    usage: evaluateUnlinkability.py [-h] [--omega [OMEGA]] [--nBins [NBINS]]
    								[--figureTitle [FIGURETITLE]]
    								[--legendLocation [LEGENDLOCATION]]
    								matedScoresFile nonMatedScoresFile figureFile
    
    Evaluate unlinkability for two given sets of mated and non-mated linkage
    scores.
    
    positional arguments:
      matedScoresFile       filename for the mated scores
      nonMatedScoresFile    filename for the non-mated scores
      figureFile            filename for the output figure
    
    optional arguments:
      -h, --help            show this help message and exit
      --omega [OMEGA]       omega value for the computations, if none provided,
    						omega = 1
      --nBins [NBINS]       number of bins for the computations, if none provided,
    						nBins = 100
      --figureTitle [FIGURETITLE]
    						title for the output figure
      --legendLocation [LEGENDLOCATION]
    						legend location
  2. Input: at least 3 score files (mated and non-mated score examples provided), and optionally other parameters of the computation and the formatting of the figure obtained as output.

    The score files are loaded with the built-in function numpy.fromfile(). An example in hdf5 format has been provided, but other formats, such as a txt file with all scores separated by blank spaces or one score per row, can be also used.

  3. Output: figure with score distributions, point-wise and global unlinkability metric results.

References

More details in:

  • [TIFS18] M. Gomez-Barrero, J. Galbally, C. Rathgeb, C. Busch, "General Framework to Evaluate Unlinkability in Biometric Template Protection Systems", in IEEE Trans. on Informations Forensics and Security, vol. 3, no. 6, pp. 1406-1420, June 2018.

Please remember to reference article [TIFS18] on any work made public, whatever the form, based directly or indirectly on these metrics.