Skip to content
Snippets Groups Projects
README.rst 3.17 KiB
Newer Older
Ketan Kotwal's avatar
Ketan Kotwal committed
.. vim: set fileencoding=utf-8 :

.. image:: http://img.shields.io/badge/docs-stable-yellow.svg
Ketan Kotwal's avatar
Ketan Kotwal committed
   :target: https://www.idiap.ch/software/bob/docs/bob/bob.paper.xcsmad_facepad/master/index.html
Ketan Kotwal's avatar
Ketan Kotwal committed
.. image:: http://img.shields.io/badge/docs-latest-orange.svg
Ketan Kotwal's avatar
Ketan Kotwal committed
   :target: https://www.idiap.ch/software/bob/docs/bob/bob.paper.xcsmad_facepad/master/index.html
.. image:: https://gitlab.idiap.ch/bob/bob.paper.xcsmad_facepad/badges/master/build.svg
   :target: https://gitlab.idiap.ch/bob/bob.paper.xcsmad_facepad/commits/master
.. image:: https://gitlab.idiap.ch/bob/bob.paper.xcsmad_facepad/badges/master/coverage.svg
   :target: https://gitlab.idiap.ch/bob/bob.paper.xcsmad_facepad/commits/master
Ketan Kotwal's avatar
Ketan Kotwal committed
.. image:: https://img.shields.io/badge/gitlab-project-0000c0.svg
Ketan Kotwal's avatar
Ketan Kotwal committed
   :target: https://gitlab.idiap.ch/bob/bob.paper.xcsmad_facepad
.. image:: http://img.shields.io/pypi/v/bob.paper.xcsmad_facepad.svg
   :target: https://pypi.python.org/pypi/bob.paper.xcsmad_facepad
========================================================================================
Ketan Kotwal's avatar
Ketan Kotwal committed
Face PAD for Silicone mask-based attack detection
========================================================================================
Ketan Kotwal's avatar
Ketan Kotwal committed

Ketan Kotwal's avatar
Ketan Kotwal committed
This package is part of the Bob_ toolkit and it allows to reproduce the experimental results in the following paper ::
Ketan Kotwal's avatar
Ketan Kotwal committed

    @article{XCSMAD-TBIOM-2019,
        title = {{Multispectral Deep Embeddings As a Countermeasure To Custom Silicone Mask Presentation Attacks}},
        author = {{K. Kotwal, S. Bhattacharjee, and S. Marcel}},
Ketan Kotwal's avatar
Ketan Kotwal committed
        journal = {{IEEE Transactions on Biometrics, Behavior, and Identity Science}},
        volume = {00},
        number = {0},
        pages = {000--000},
        month = {{0}},
        year = {2019},
    }
Ketan Kotwal's avatar
Ketan Kotwal committed

If you use this package and/or its results, please cite the paper.


Installation
----------------------------------

The installation instructions are based on conda_ and works on **Linux systems
Ketan Kotwal's avatar
Ketan Kotwal committed
only**. Install conda before continuing.

Once you have installed conda_, download the source code of this paper and
unpack it. Then, you can create a conda environment with the following
Ketan Kotwal's avatar
Ketan Kotwal committed
command::

Ketan Kotwal's avatar
Ketan Kotwal committed
     $ cd bob.paper.xcsmad_facepad
Ketan Kotwal's avatar
Ketan Kotwal committed
     $ conda env create -f environment.yml
Ketan Kotwal's avatar
Ketan Kotwal committed
     $ conda activate bob.paper.xcsmad_facepad
Ketan Kotwal's avatar
Ketan Kotwal committed
     $ buildout
Ketan Kotwal's avatar
Ketan Kotwal committed

Ketan Kotwal's avatar
Ketan Kotwal committed
This will install all the required software to reproduce this paper.

Ketan Kotwal's avatar
Ketan Kotwal committed

Documentation
------------------
Ketan Kotwal's avatar
Ketan Kotwal committed

Ketan Kotwal's avatar
Ketan Kotwal committed
For further documentation on this package, please read the `Documentation <https://www.idiap.ch/software/bob/docs/bob/bob.paper.xcsmad_facepad/master/index.html>`_.
For a list of tutorials on this or the other packages of Bob_, or information on submitting issues, asking questions and starting discussions, please visit its website.
Ketan Kotwal's avatar
Ketan Kotwal committed

Ketan Kotwal's avatar
Ketan Kotwal committed

Contact
----------------
Ketan Kotwal's avatar
Ketan Kotwal committed

For questions or reporting issues to this software package, contact our
development `mailing list`_.


.. Place your references here:
.. _Bob: https://www.idiap.ch/software/bob
Ketan Kotwal's avatar
Ketan Kotwal committed
.. _installation: https://www.idiap.ch/software/bob/install
.. _mailing list: https://www.idiap.ch/software/bob/discuss
.. _bob package development: https://www.idiap.ch/software/bob/docs/bob/bob.extension/master/
.. _conda: https://conda.io
.. _install conda: https://conda.io/docs/install/quick.html#linux-miniconda-install