installation.rst 4.61 KB
Newer Older
Pedro TOME's avatar
Pedro TOME committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34
.. vim: set fileencoding=utf-8 :
.. date: Thu Jan 15 15:58:57 CEST 2015

.. _installation:

Installation Instructions

.. note::
  This documentation includes several ``file://`` links that usually point to files or directories in your source directory.
  When you are reading this documentation online, these links won't work.
  Please read `Generate this documentation`_ on how to create this documentation including working ``file://`` links.


To have a stable version of the FingerveinRecLib, the safest option is to go to the `FingerveinRecLib <>`_ web page on PyPI_ and download the latest version.

Nevertheless, the library is also available as a project of `Idiap at GitHub`_.
To check out the current version of the FingerveinRecLib, go to the console, move to any place you like and call:

.. code-block:: sh

  $ git clone

Be aware that you will get the latest changes and that it might not work as expected.


The FingerveinRecLib is a satellite package of Bob_, where most of the image processing, feature extraction, and fingervein recognition algorithms, as well as the evaluation techniques are implemented. This package uses FaceRecLib_ as a parent package.
Pedro TOME's avatar
Pedro TOME committed
36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115
In its current version, the FingerveinRecLib requires Bob_ version 2 or greater.
Since version 2.0 there is no need for a global installation of Bob any more, all required packages will be automatically downloaded from PyPi_.

To install `Packages of Bob <>`_, please read the `Installation Instructions <>`_.
For Bob_ to be able to work properly, some dependent packages are required to be installed.
Please make sure that you have read the `Dependencies <>`_ for your operating system.

.. note::
  Currently, running Bob_ under MS Windows in not yet supported.
  However, we found that running Bob_ in a virtual Unix environment such as the one provided by VirtualBox_ is a good alternative.

Usually, all possible database satellite packages (called ``bob.db.[...]``) are automatically downloaded from PyPI_.
If you don't want to download the databases, please edit the ``eggs`` section of the buildout.cfg_ configuration file by removing the databases that you don't want.

The ``gridtk`` tool kit is mainly used for submitting submitting jobs to Idiap_'s SGE_ grid.
The latest version also supports to run jobs in parallel on the local machine.
You can safely remove this line from the buildout.cfg_ if you are not at Idiap and if you don't want to launch your experiments in parallel.

Image Databases

With the FingerveinRecLib you will run fingervein recognition experiments using some default finger vein image databases.
Though the verification protocols are implemented in the FingerveinRecLib, the images are **not included**.
To download the image databases, please refer to the according Web-pages, database URL's will be given in the :ref:`databases` section.

Set-up your FingerveinRecLib

Now, you have everything ready so that you can continue to set up the FingerveinRecLib.
To do this, we use the BuildOut_ system.
To proceed, open a terminal in your FaceRecLib main directory and call:

.. code-block:: sh

  $ python
  $ bin/buildout

The first step will generate a `bin <file:../bin>`_ directory in the main directory of the FingerveinRecLib.
The second step automatically downloads all dependencies of the FingerveinRecLib and creates all required scripts that we will need soon.

Test your Installation

One of the scripts that were generated during the bootstrap/buildout step is a test script.
To verify your installation, you should run the script by calling:

.. code-block:: sh

  $ bin/nosetests

In case any of the tests fail for unexplainable reasons, please file a bug report through the `GitHub bug reporting system`_.

.. note::
  Usually, all tests should pass with the latest stable versions of the Bob_ packages.
  In other versions, some of the tests may fail.

Generate this documentation

To generate this documentation, you call:

.. code-block:: sh

  $ bin/sphinx-build docs sphinx

Afterwards, the documentation is available and you can read it, e.g., by using:

.. code-block:: sh

  $ firefox sphinx/index.html

.. _buildout.cfg: file:../buildout.cfg

.. include:: links.rst

.. _facereclib: