.. vim: set fileencoding=utf-8 :
.. Manuel Guenther <manuel.guenther@idiap.ch>
.. Fri Sep 19 12:51:09 CEST 2014

.. image:: http://img.shields.io/badge/docs-stable-yellow.png
   :target: http://pythonhosted.org/bob.bio.csu/index.html
.. image:: http://img.shields.io/badge/docs-latest-orange.png
   :target: https://www.idiap.ch/software/bob/docs/latest/bioidiap/bob.bio.csu/master/index.html
.. image:: http://travis-ci.org/bioidiap/bob.bio.csu.svg?branch=v2.0.3
   :target: https://travis-ci.org/bioidiap/bob.bio.csu?branch=v2.0.3
.. image:: https://coveralls.io/repos/bioidiap/bob.bio.csu/badge.png?branch=v2.0.3
   :target: https://coveralls.io/r/bioidiap/bob.bio.csu?branch=v2.0.3
.. image:: https://img.shields.io/badge/github-master-0000c0.png
   :target: https://github.com/bioidiap/bob.bio.csu/tree/master
.. image:: http://img.shields.io/pypi/v/bob.bio.csu.png
   :target: https://pypi.python.org/pypi/bob.bio.csu
.. image:: http://img.shields.io/pypi/dm/bob.bio.csu.png
   :target: https://pypi.python.org/pypi/bob.bio.csu
.. image:: https://img.shields.io/badge/original-software-a000a0.png
   :target: http://www.cs.colostate.edu/facerec


================================================================
 bob.bio Wrapper classes for the CSU Face Recognition Resources
================================================================

This package is part of the ``bob.bio`` packages, which allow to run comparable and reproducible biometric recognition experiments on publicly available databases.

This package provides wrapper classes for the CSU face recognition resources, which can be downloaded from http://www.cs.colostate.edu/facerec.
Two algorithms are provided by the CSU toolkit (and also by this package): the local region PCA (LRPCA) and the LDA-IR (also known as CohortLDA).

For more information about the LRPCA and the LDA-IR algorithm, please refer to the documentation on http://www.cs.colostate.edu/facerec.
For further information about ``bob.bio``, please read `its Documentation <http://pythonhosted.org/bob.bio.base/index.html>`_.


Installation Instructions
-------------------------

The current package is just a set of wrapper classes for the CSU facerec2010 module, which is contained in the `CSU Face Recognition Resources <http://www.cs.colostate.edu/facerec>`_, where you need to download the Baseline 2011 Algorithms.
Please make sure that you have read installation instructions in the Documentation_ of this package on how to patch the original source code to work with our algorithms, before you try to go on woth this package.

.. note::
   Since the original CSU resources are not Python3 compatible, this package only supports Python2.
   For external dependencies of the CSU resources, please read their `README <http://www.cs.colostate.edu/facerec/algorithms/README.pdf>`__.

The ``bob.bio`` packages and parts of this package rely on Bob_, an open-source signal-processing and machine learning toolbox.
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 <https://github.com/idiap/bob/wiki/Dependencies>`_ for your operating system.


Documentation
-------------
For further documentation on this package, please read the `Stable Version <http://pythonhosted.org/bob.bio.csu/index.html>`_ or the `Latest Version <https://www.idiap.ch/software/bob/docs/latest/bioidiap/bob.bio.csu/master/index.html>`_ of the documentation.

For a list of tutorials on packages ob Bob_, or information on submitting issues, asking questions and starting discussions, please visit its website.


.. _bob: https://www.idiap.ch/software/bob
.. _documentation: http://pythonhosted.org/bob.bio.csu/index.html
