Source code for bob.bio.vein.database.verafinger_contactless

#!/usr/bin/env python
# vim: set fileencoding=utf-8 :
# Victor <vbros@idiap.ch>

"""
  VERA-Fingervein-Contactless database implementation
"""

from clapper.rc import UserDefaults

import bob.io.base

from bob.bio.base.database import CSVDatabase, FileSampleLoader

rc = UserDefaults("bobrc.toml")


class VerafingerContactless(CSVDatabase):
    """
    The VERA Fingervein Contactless database contains 1330 finger vein images of 133 persons,
    with id ranging from 1 to 137 (with 4 defects).
    Both hands of the subjects have been imaged over 5 different sessions, with a total of 10 images per person.
    The sensor is described in `this paper <https://ieeexplore.ieee.org/abstract/document/7314596>`_.

    .. warning::

      To use this dataset protocol, you need to have the original files of the VERA Fingervein Contactless dataset.
      Once you have it downloaded, please run the following command to set the path for Bob

        .. code-block:: sh

            bob config set bob.bio.vein.verafinger_contactless.directory [DATABASE PATH]


    **Metadata**

    Associated to each sample, you may find the metadata configuration for each capture :

    * EXPOSURE : exposure time (in ms)
    * ORTHOLED : Power of the ORTHOLED (in % of the max power)
    * CENTERLED : Power of the CENTERLED (in % of the max power)
    * CROSSLED : Power of the CROSSLED (in % of the max power)


    **Protocols**

    **NOM (Normal Operation Mode) protocol**

    * Development set : Even subject ids
    * Evaluation set : Odd subject ids
    * Models : session 1 & 2
    * Probes : session 3, 4 &5

    """

    name = "verafinger_contactless"
    category = "vein"
    dataset_protocols_name = "verafinger_contactless.tar.gz"
    dataset_protocols_urls = [
        "https://www.idiap.ch/software/bob/databases/latest/vein/verafinger_contactless-656ef935.tar.gz",
        "http://www.idiap.ch/software/bob/databases/latest/vein/verafinger_contactless-656ef935.tar.gz",
    ]
    dataset_protocols_hash = "656ef935"

    def __init__(self, protocol):
        super().__init__(
            name=self.name,
            protocol=protocol,
            transformer=FileSampleLoader(
                data_loader=bob.io.base.load,
                dataset_original_directory=rc.get(
                    "bob.bio.vein.verafinger_contactless.directory", ""
                ),
                extension="",
            ),
            score_all_vs_all=True,
        )