Adaptations to allow vulnerability analysis

bob/bio/vein/configurations/verafinger.py

@@ -43,4 +43,10 @@ protocol = 'Nom'
 You may modify this at runtime by specifying the option ``--protocol`` on the
 command-line of ``verify.py`` or using the keyword ``protocol`` on a
 configuration file that is loaded **after** this configuration resource.
+
+We accept any biometric recognition protocol implemented by bob.db.verafinger.
+Variants of the biometric recognition protocol ending in ``-va`` can be used to
+test for vulnerability analysis. For example, use the protocol ``Nom-va`` to
+test the vulnerability of a biometric recognition pipeline using the ``Nom``
+protocol for enrollment and probe samples from presentation attacks.
 """

bob/bio/vein/database/verafinger.py

@@ -2,6 +2,7 @@
 # vim: set fileencoding=utf-8 :
 # Tue 27 Sep 2016 16:48:57 CEST
 
+import os
 
 from bob.bio.base.database import BioFile, BioDatabase
 
@@ -22,8 +23,9 @@ class File(BioFile):
 
     def __init__(self, f):
 
-        super(File, self).__init__(client_id=f.unique_finger_name, path=f.path,
-            file_id=f.id)
+        id_ = f.finger.unique_name
+        if f.source == 'pa': id_ = 'attack/%s' % id_
+        super(File, self).__init__(client_id=id_, path=f.path, file_id=f.id)
         self.__f = f
 
 
@@ -31,8 +33,14 @@ class File(BioFile):
         """(Overrides base method) Loads both image and mask"""
 
         image = super(File, self).load(*args, **kwargs)
-        roi = self.__f.roi()
-        return AnnotatedArray(image, metadata=dict(roi=roi))
+        basedir = args[0] if args else kwargs['directory']
+        annotdir = os.path.join(basedir, 'annotations', 'roi')
+        if os.path.exists(annotdir):
+          print('loading annotations')
+          roi = self.__f.roi(args[0])
+          return AnnotatedArray(image, metadata=dict(roi=roi))
+        print('NOT loading annotations')
+        return image
 
 
 class Database(BioDatabase):
@@ -72,9 +80,16 @@ class Database(BioDatabase):
 
         groups = self.convert_names_to_lowlevel(groups,
             self.low_level_group_names, self.high_level_group_names)
-        retval = self._db.objects(groups=groups, protocol=protocol,
-                                  purposes=purposes, model_ids=model_ids,
-                                  **kwargs)
+
+        if (protocol.endswith('-va') or protocol.endswith('-VA')) and \
+            purposes=='probe': #the user actually means 'attack'
+          retval = self._db.objects(groups=groups, protocol=protocol[:-3],
+                                purposes='attack', model_ids=model_ids,
+                                **kwargs)
+        else:
+          retval = self._db.objects(groups=groups, protocol=protocol,
+                                    purposes=purposes, model_ids=model_ids,
+                                    **kwargs)
 
         return [File(f) for f in retval]
 

doc/baselines.rst

@@ -105,7 +105,8 @@ protocol, do the following:
 
    If you have more processing cores on your local machine and don't want to
    submit your job for SGE execution, you can run it in parallel (using 4
-   parallel tasks) by adding the options ``--parallel=4 --nice=10``.
+   parallel tasks) by adding the options ``--parallel=4 --nice=10``. **Before**
+   doing so, make sure the package gridtk_ is properly installed.
 
    Optionally, you may use the ``parallel`` resource configuration which
    already sets the number of parallel jobs to the number of hardware cores you

doc/links.rst

@@ -22,3 +22,4 @@
 .. _bob.bio.base: https://pypi.python.org/pypi/bob.bio.base
 .. _jaccard index: https://en.wikipedia.org/wiki/Jaccard_index
 .. _watershed: https://en.wikipedia.org/wiki/Watershed_(image_processing)
+.. _gridtk: https://pypi.python.org/pypi/gridtk