installation.rst 3.4 KB
Newer Older
1 2 3 4 5 6 7
.. vim: set fileencoding=utf-8 :
.. author: Manuel Günther <manuel.guenther@idiap.ch>
.. author: Pavel Korshunov <pavel.korshunov@idiap.ch>
.. date: Wed Apr 27 14:58:21 CEST 2016

.. _bob.pad.base.installation:

8 9 10
===========================
 Installation Instructions
===========================
11

12 13 14
As noted before, this package is part of the ``bob.pad`` packages, which in
turn are part of the signal-processing and machine learning toolbox Bob_. To
install Bob_, please read the `Installation Instructions <bobinstall_>`_.
15

16 17
Then, to install the ``bob.pad`` packages and in turn maybe the database
packages that you want to use, use conda_ to install them:
18

19
.. code-block:: sh
20

21 22 23
    $ conda search bob.pad # searching
    $ conda search bob.db  # searching
    $ conda install bob.pad.base bob.pad.<padname> bob.db.<dbname>
24

25 26
where you would replace ``<padname>`` and ``<dbname>`` with the name of
packages that you want to use.
27

28 29
An example installation
-----------------------
30

31 32 33 34 35 36 37 38 39 40 41
For example, to run a speech presentation attack detection experiments,
you need preprocessor, extractor, classifier, and
a database. Preprocessors and extractors can be reused from ``bob.bio`` packages, while classifier is normally
provided in ``bob.pad``. Hence for speech PAD, you can take
the :py:class:`bob.bio.spear.preprocessor.Energy_2Gauss` and the
:py:class:`bob.bio.spear.extractor.Cepstral` feature extractor defined in
:ref:`bob.bio.spear <bob.bio.spear>`, and the
:py:class:`bob.pad.voice.algorithm.GmmAlgorithm` algorithm defined in
:ref:`bob.pad.voice <bob.pad.voice>`, using voicePA database (contains speech presentation attacks)
interface defined in :ref:`bob.db.voicepa <bob.db.voicepa>`. Running the
command line below will install all the required packages:
42

43
.. code-block:: sh
44

45 46 47 48 49 50 51
    $ source activate <bob_conda_environment>
    $ conda install bob.bio.base \
                    bob.bio.spear \
                    bob.pad.base \
                    bob.pad.voice \
                    bob.db.voicepa \
                    gridtk
52 53

Databases
54
---------
55 56 57 58

With ``bob.pad`` you will run biometric recognition experiments using databases that contain presentation attacks.
Though the PAD protocols are implemented in ``bob.pad``, the original data are **not included**.
To download the original data of the databases, please refer to the according Web-pages.
59 60
For a list of supported databases including their download URLs,
please refer to the `spoofing_databases <https://gitlab.idiap.ch/bob/bob/wikis/Packages>`_.
61 62 63

After downloading the original data for the databases, you will need to tell ``bob.pad``, where these databases can be found.
For this purpose, we have decided to implement a special file, where you can set your directories.
Pavel KORSHUNOV's avatar
Pavel KORSHUNOV committed
64
Similar to ``bob.bio.base``, by default, this file is located in ``~/.bob_bio_databases.txt``, and it contains several lines, each line looking somewhat like:
65 66 67 68 69 70 71 72 73 74 75 76 77

.. code-block:: text

   [DEFAULT_DATABASE_DIRECTORY] = /path/to/your/directory

.. note::
   If this file does not exist, feel free to create and populate it yourself.


Please use ``./bin/databases.py`` for a list of known databases, where you can see the raw ``[YOUR_DATABASE_PATH]`` entries for all databases that you haven't updated, and the corrected paths for those you have.


.. note::
78
   If you have installed only ``bob.pad.base``, there is no database listed -- as all databases are included in other extension packages, such as ``bob.pad.voice``.
79 80 81


.. include:: links.rst