Newer
Older
Olegs NIKISINS
committed
.. _bob.pad.face.installation:
Olegs NIKISINS
committed
==============
Installation
==============
The installation of this package is divided in 2-parts. Installation of the
package and its software dependencies and the installation of databases.
Package Installation
--------------------
To install this package, first follow our `installation`_ instructions. Then,
using the buildout command provided by the distribution, bootstrap this package
using buildout:
Olegs NIKISINS
committed
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
.. code-block:: sh
$ buildout
Sphinx Documentation Building
-----------------------------
Once the package is installed, you may re-build this documentation locally by
running:
.. code-block:: sh
$ sphinx-build doc html
The resulting HTML documentation will be output inside the directory `html`.
Setting up Databases
--------------------
In order to run face PAD algorithms using this package, you'll need to
make sure to download the raw files corresponding to the databases you'd like
to process. The raw files are not distributed with Bob_ software as biometric
data is, to most countries, considered sensible data that cannot be obtained
without explicit licensing from a data controller. You must visit the websites
below, sign the license agreements and then download the data before trying out
to run the baselines.
.. note::
If you're at the Idiap Research Institute in Switzlerand, the datasets in
the baselines mentioned in this guide are already downloaded and
pre-installed on our shared file system. You don't need to re-download
databases or create a ``~/.bob_bio_databases.txt`` file.
The current system readily supports the following freely available datasets:
* `REPLAYATTACK`_
* `REPLAY-MOBILE`_
* `MSU MFSD`_
* ``Aggregated DB``
Olegs NIKISINS
committed
After downloading the databases, annotate the base directories in which they
are installed. Then, follow the instructions in
:ref:`bob.pad.base.installation` to let this framework know where databases are
located on your system.
Development
-----------
If you're developing this package, you may automatically clone all necessary
Bob_ repositories on your local package installation. This allows you to build
against an environment which contains all of our dependencies_, but no
previously installed Bob_ packages. To do so, use the buildout recipe in
``develop.cfg`` just after bootstraping:
.. code-block:: sh
$ buildout -c develop.cfg
Database SQL support files
==========================
If you installed all packages from scratch like above, you'll need to download
the SQL support files of some of the database front-ends available in this
package. This operation can be easily done like this:
.. code-block:: sh
$ bob_dbmanage.py all download
.. include:: links.rst