Skip to main content
File added late

1 file was added to this release more than 14 days after its initial publication. Inspect the release files before installing.

Pre-release

This release is a pre-release and may not be stable for production use.

This package contains scripts to reproduce the experiments of my Ph.D. thesis at Ecole Polytechnique Fédérale de Lausanne (EPFL). It was developed when I was working in the Biometrics group at the Idiap Research Institute:

@phdthesis{ElShafey_EPFL2014,
  title = {Scalable Probabilistic Models for Face and Speaker Recognition},
  author = {Laurent El Shafey},
  month = {April},
  year = {2014},
  school = {Ecole Polytechnique F{\'e}d{\'e}rale de Lausanne (EPFL)},
  url = {http://publications.idiap.ch/index.php/publications/show/2830},
}

In particular, this package provides instructions to combine code (see Bob, which contains the implementations of machine learning algorithms and signal processing tools) and data to generate the plots depicted in my thesis.

Installation

To download the xbob.thesis.elshafey2014 package, please go to http://pypi.python.org/pypi/xbob.thesis.elshafey2014, click on the download button and extract the .zip file to a folder of your choice.

The xbob.thesis.elshafey2014 is a satellite package of the free signal processing and machine learning library Bob, and some of its algorithms rely on the CSU Face Recognition Resources. These two dependencies have to be downloaded manually, as explained in the following.

Bob

You will need a copy of Bob in version 1.2.2 to run the algorithms. Please download Bob from its webpage. After downloading, you should go to the console and write:

$ python bootstrap.py
$ bin/buildout

This will download all required dependencies and install them locally. If you don’t want all the database packages to be downloaded, please remove the xbob.db.[database] lines from the eggs section of the file buildout.cfg in the main directory before calling the three commands above.

The CSU Face Recognition Resources

Two open source face recognition algorithms are provided by the CSU Face Recognition Resources, namely the LRPCA and the LDA-IR (a.k.a. CohortLDA) algorithm. For these algorithms, optional wrapper classes are provided in the xfacereclib.extension.CSU satellite package. By default, this package is disabled. To enable them, please call:

$ bin/buildout -c buildout-with-csu.cfg

after downloading and patching the CSU resources, and updating the sources-dir in the buildout-with-csu.cfg file – as explained in xfacereclib.extension.CSU.

Databases

Experiments are conducted on several databases. They should be downloaded and extracted manually to be able to reproduce the plots.

Once you have installed the databases, you should set the path to raw data into some configuration files. For instance, for running experiments on the BANCA database, you should set the variable ‘banca_directory’ in the file banca.py to your directory that contains the images of this database. This is explained in more details in the complete documentation.

Running experiments

If you have set up everything mentioned above, you are ready to run the recognition experiments.

This process is split into two different steps:

1. Generation of raw scores from raw data (image/audio files [and possibly annotations]) of the databases

2. Generation of plots from these raw scores

There is a single exception with the plots generated on the M-iris synthetic dataset. In this case, the experiments does not require any external data and can be reproduced in one step. In practice, the first step has high computational requirements, which depend on the database considered.

Read further

There are several file links in the documentation, which won’t work in the online documentation. To generate the documentation locally, type:

$ bin/sphinx-build docs sphinx
$ firefox sphinx/index.html

and read further instructions on how to use this package.

Cite our paper

If you use this package in any of your experiments, please cite the following paper:

@phdthesis{ElShafey_EPFL2014,
  title = {Scalable Probabilistic Models for Face and Speaker Recognition},
  author = {Laurent El Shafey},
  month = {April},
  year = {2014},
  school = {Ecole Polytechnique F{\'e}d{\'e}rale de Lausanne (EPFL)},
  url = {http://publications.idiap.ch/index.php/publications/show/2830},
}

Problems

In case of problems, please contact me (Laurent El Shafey).

If you are facing technical issues to be able to run the scripts of this package, you can send a message on the Bob’s mailing list.

Please follow these guidelines when (or even better before) reporting any bug.

Release files for xbob.thesis.elshafey2014 0.0.1a0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

File added late

1 file was uploaded more than 14 days after the first file in this release.

While project maintainers occasionally add legitimate files to an existing release, late additions can also indicate a security compromise.

We recommend inspecting the release files before installing.

Source distribution (sdist)

Source distribution for xbob.thesis.elshafey2014 0.0.1a0
File Size Uploaded
xbob.thesis.elshafey2014-0.0.1a0.zip 234.5 kB Details

Release files / xbob.thesis.elshafey2014-0.0.1a0.zip

File added late

This file was uploaded more than 14 days after the first file in this release.

While project maintainers occasionally add legitimate files to an existing release, late additions can also indicate a security compromise.

We recommend inspecting the release file before installing.

Download URL xbob.thesis.elshafey2014-0.0.1a0.zip
Size 234.5 kB
Tags Source
SHA-256 checksum
How to use checksums
6694fc4ee795337f87e5862ded54656ccd763b94e2771e20c69b56cba055776d
BLAKE2b-256 checksum
How to use checksums
cfb316de072b4aac1df2c5dc3ca3195279203799bf47b046520318572f320b2d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.0.1a0 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page