Skip to content
Snippets Groups Projects
README.rst 2.83 KiB
Newer Older
Anjith GEORGE's avatar
Anjith GEORGE committed
.. -*- coding: utf-8 -*-

.. image:: https://img.shields.io/badge/docs-stable-yellow.svg
Anjith GEORGE's avatar
Anjith GEORGE committed
   :target: https://www.idiap.ch/software/bob/docs/bob/bob.paper.deep_pix_bis_pad.icb2019/master/index.html
Anjith GEORGE's avatar
Anjith GEORGE committed
.. image:: https://img.shields.io/badge/docs-latest-orange.svg
Anjith GEORGE's avatar
Anjith GEORGE committed
   :target: https://www.idiap.ch/software/bob/docs/bob/bob.paper.deep_pix_bis_pad.icb2019/master/index.html
Anjith GEORGE's avatar
Anjith GEORGE committed
.. image:: https://gitlab.idiap.ch/bob/bob.paper.deep_pix_bis_pad.icb2019/badges/master/build.svg
   :target: https://gitlab.idiap.ch/bob/bob.paper.deep_pix_bis_pad.icb2019/commits/master
.. image:: https://gitlab.idiap.ch/bob/bob.paper.deep_pix_bis_pad.icb2019/badges/master/coverage.svg
   :target: https://gitlab.idiap.ch/bob/bob.paper.deep_pix_bis_pad.icb2019/commits/master
.. image:: https://img.shields.io/badge/gitlab-project-0000c0.svg
   :target: https://gitlab.idiap.ch/bob/bob.paper.deep_pix_bis_pad.icb2019
.. image:: https://img.shields.io/pypi/v/bob.paper.deep_pix_bis_pad.icb2019.svg
   :target: https://pypi.python.org/pypi/bob.paper.deep_pix_bis_pad.icb2019


Anjith GEORGE's avatar
Anjith GEORGE committed
================================================
Deep Pixel-wise Binary Supervision for Face PAD
================================================
Anjith GEORGE's avatar
Anjith GEORGE committed

Anjith GEORGE's avatar
Anjith GEORGE committed
This package is part of the signal-processing and machine learning toolbox Bob_. 
Anjith GEORGE's avatar
Anjith GEORGE committed

Anjith GEORGE's avatar
Anjith GEORGE committed
This package contains source code to replicate the experimental results published in the following paper::
Anjith GEORGE's avatar
Anjith GEORGE committed

Anjith GEORGE's avatar
Anjith GEORGE committed
    @inproceedings{GeorgeICB2019,
        author = {Anjith George, Sebastien Marcel},
        title = {Deep Pixel-wise Binary Supervision for Face Presentation Attack Detection},
        year = {2019},
        booktitle = {ICB 2019},
    }
Anjith GEORGE's avatar
Anjith GEORGE committed

Anjith GEORGE's avatar
Anjith GEORGE committed
If you use this package and/or its results, please consider citing the paper.
Anjith GEORGE's avatar
Anjith GEORGE committed

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

Anjith GEORGE's avatar
Anjith GEORGE committed
The installation instructions are based on conda_ and works on **Linux systems
only**. `Install conda`_ before continuing.
Anjith GEORGE's avatar
Anjith GEORGE committed

Anjith GEORGE's avatar
Anjith GEORGE committed
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
command::

    $ cd bob.paper.deep_pix_bis_pad.icb2019
    $ conda env create -f environment.yml
    $ source activate bob.paper.deep_pix_bis_pad.icb2019  # activate the environment
    $ buildout
    $ bin/bob_dbmanage.py all download --missing
Anjith GEORGE's avatar
Anjith GEORGE committed
    $ bin/train_pixbis.py --help  # test the installation
Anjith GEORGE's avatar
Anjith GEORGE committed

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


Contact
-------

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
.. _installation: https://www.idiap.ch/software/bob/install
Anjith GEORGE's avatar
Anjith GEORGE committed
.. _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
Anjith GEORGE's avatar
Anjith GEORGE committed
.. _install conda: https://conda.io/docs/install/quick.html#linux-miniconda-install