README.rst 2.94 KB
Newer Older
1
.. vim: set fileencoding=utf-8 :
Tiago de Freitas Pereira's avatar
Tiago de Freitas Pereira committed
2
.. Thu 18 Aug 13:44:41 CEST 2016
3

4
.. image:: https://img.shields.io/badge/docs-available-orange.svg
Jaden's avatar
Jaden committed
5
   :target: https://www.idiap.ch/software/bob/docs/bob/bob.db.ijba/master/index.html
6 7 8 9
.. image:: https://gitlab.idiap.ch/bob/bob.db.ijba/badges/master/pipeline.svg
   :target: https://gitlab.idiap.ch/bob/bob.db.ijba/commits/master
.. image:: https://gitlab.idiap.ch/bob/bob.db.ijba/badges/master/coverage.svg
   :target: https://gitlab.idiap.ch/bob/bob.db.ijba/commits/master
Tiago de Freitas Pereira's avatar
Tiago de Freitas Pereira committed
10 11
.. image:: https://img.shields.io/badge/gitlab-project-0000c0.svg
   :target: https://gitlab.idiap.ch/bob/bob.db.ijba
12 13


14
==================================
15
 IJB-A Database Interface for Bob
16
==================================
Tiago de Freitas Pereira's avatar
Tiago de Freitas Pereira committed
17 18

This package is part of the signal-processing and machine learning toolbox
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
Bob_.  This package contains an interface for the evaluation protocols of the
`IARPA Janus Benchmark A (IJB-A) database`_ and does not contain the original
image data for the database.  The original data should be obtained using the
link above.

The IJB-A database is a mixture of frontal and non-frontal images and videos
(provided as single frames) from 500 different identities.  In many of the
images and video frames, there are several people visible, but only the ones
that are annotated with a bounding box should be taken into consideration.  For
both model enrollment as well as for probing, images and video frames of one
person are combined into so-called Templates.

The database is divided in 10 splits each defining training, enrollment and
probe data.

This package implements the database interface including all its
particularities:

- First, it implements the FileSet protocol, since for some probes, several
  files (a mixture of images and video frames) are defined. In the
  Database.object_sets() function, FileSet objects are only returned for probe
  purposes.
- Second, some images contain several identities. Therefore, every physical
  image file can be stored in several File objects. Also, the File.make_path()
  function can create two different styles of file names: the original file
  name (to read original images), or a unique filename (to define a unique name
  for each extracted face).
- Third, the Templates with the same template_id might differ between the
  protocols, so that the Template.template_id is **not** unique. On the other
  hand, the Template.id is used as a unique key to query the SQL database.
49

50

Tiago de Freitas Pereira's avatar
Tiago de Freitas Pereira committed
51 52
Installation
------------
53

Jaden's avatar
Jaden committed
54
Complete Bob's `installation`_ instructions. Then, to install this package,
55
run::
56

57
  $ conda install bob.db.ijba
58

59

Tiago de Freitas Pereira's avatar
Tiago de Freitas Pereira committed
60 61
Contact
-------
62

Tiago de Freitas Pereira's avatar
Tiago de Freitas Pereira committed
63 64
For questions or reporting issues to this software package, contact our
development `mailing list`_.
65 66


Tiago de Freitas Pereira's avatar
Tiago de Freitas Pereira committed
67
.. Place your references here:
68
.. _bob: https://www.idiap.ch/software/bob
69
.. _installation: https://www.idiap.ch/software/bob/install
70
.. _mailing list: https://www.idiap.ch/software/bob/discuss
71
.. _iarpa janus benchmark a (ijb-a) database: http://www.nist.gov/itl/iad/ig/ijba_request.cfm