{ "info": { "author": "Manuel Guenther", "author_email": "manuel.guenther@idiap.ch", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Framework :: Bob", "Framework :: Buildout", "Intended Audience :: Science/Research", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Natural Language :: English", "Programming Language :: Python :: 2.7", "Topic :: Scientific/Engineering" ], "description": "An Open Source Framework for Standardized Comparisons of Face Recognition Algorithms\n====================================================================================\n\nThis package provides the source code to run the experiments published in the paper `An Open Source Framework for Standardized Comparisons of Face Recognition Algorithms `_.\nIt relies on the FaceRecLib_ to execute all face recognition experiments.\nMost of the face recognition algorithms are implemented in Bob_, while one of them is taken from the `CSU Face Recognition Resources`_.\n\n.. note::\n Currently, this package only works in Unix-like environments and under MacOS.\n Due to limitations of the Bob library, MS Windows operating systems are not supported.\n We are working on a port of Bob for MS Windows, but it might take a while.\n\n.. note::\n The experiments described in this section use the FaceRecLib_ in version 1.1.3, Bob_ in version 1.2.0 and the January 2012 release of the `CSU Face Recognition Resources`_.\n These versions are pin-pointed in the **setup.py** file (see the ``install_requires`` section).\n For other versions, the results might be slightly different.\n\nInstallation\n------------\nThe installation of this package relies on the BuildOut_ system. By default, the command line sequence::\n\n $ python bootstrap.py\n $ bin/buildout\n\nshould download and install most requirements, including the FaceRecLib_, the Database interface packages for the `BANCA database `_ and `the Good, the Bad & the Ugly database `_, and, finally, the `Wrapper classes for the CSU Face Recognition Resources `_.\nUnfortunately, some packages must be installed manually:\n\nBob\n...\nTo install the Bob toolkit, please visit http://www.idiap.ch/software/bob/ and follow the installation instructions.\nPlease verify that you have at least version 1.2.0 of Bob installed.\nIf you have installed Bob in a non-standard directory, please open the **buildout.cfg** file from the base directory and set the 'prefixes' directory accordingly.\n\nCSU Face Recognition Resources\n..............................\nDue to the fact that the CSU toolkit needs to be patched to work with the FaceRecLib, the setup is unfortunately slightly more complicated.\nTo be able to run the experiments based on the CSU toolkit, i.e., the LDA-IR algorithm, please download the CSU Face Recognition Resources from http://www.cs.colostate.edu/facerec.\nAfter unpacking the CSU toolkit, it needs to be patched.\nFor this reason, please follow the instructions:\n\n1. Patch the CSU toolkit::\n\n $ bin/buildout -c buildout-before-patch.cfg\n $ bin/patch_CSU.py [YOUR_CSU_SOURCE_DIRECTORY]\n\n2. Update the **buildout.cfg** file by modifying the ``sources-dir = [YOUR_CSU_SOURCE_DIRECTORY]`` entry to point to the base directory of the patched version of the CSU toolkit.\n\nMake sure that you update your installation by **again** calling::\n\n $ bin/buildout\n\n.. note::\n The patch file is only valid for the current version of the CSU toolkit (last checked in December 2012).\n If you have another version, please see the `Getting help`_ section.\n\n.. note::\n At Idiap, you can also use the pre-patched version of the CSU toolkit.\n Just use::\n\n $ bin/buildout -c buildout-idiap.cfg\n\n instead of downloading and patching the CSU toolkit.\n\n\nDatabases\n.........\n\nOf course, we are not allowed to re-distribute the original images to run the experiments on.\nTo re-run the experiments, please make sure to have your own copy of the `BANCA `_ and `the Good, the Bad & the Ugly `_ images.\n\n\nDocumentation\n-------------\nAfter installing you might want to create the documentation for this satellite package, which includes more detailed information on how to re-run the experiments and regenerate the scientific plots from the paper.\nTo generate and open the documentation execute::\n\n $ bin/sphinx-build docs sphinx\n $ firefox sphinx/index.html\n\nOf course, you can use any web browser of your choice.\n\n\nGetting help\n------------\n\nIn case anything goes wrong, please feel free to open a new ticket in our `GitHub page `_, or send an email to manuel.guenther@idiap.ch.\n\n\nCite our paper\n--------------\n\nIf you use the FaceRecLib_ or this package in any of your experiments, please cite the following paper::\n\n @inproceedings{Guenther_BeFIT2012,\n author = {G{\\\"u}nther, Manuel AND Wallace, Roy AND Marcel, S{\\'e}bastien},\n editor = {Fusiello, Andrea AND Murino, Vittorio AND Cucchiara, Rita},\n keywords = {Biometrics, Face Recognition, Open Source, Reproducible Research},\n month = oct,\n title = {An Open Source Framework for Standardized Comparisons of Face Recognition Algorithms},\n booktitle = {Computer Vision - ECCV 2012. Workshops and Demonstrations},\n series = {Lecture Notes in Computer Science},\n volume = {7585},\n year = {2012},\n pages = {547-556},\n publisher = {Springer Berlin},\n location = {Heidelberg},\n url = {http://publications.idiap.ch/downloads/papers/2012/Gunther_BEFIT2012_2012.pdf}\n }\n\n\n.. _facereclib: http://pypi.python.org/pypi/facereclib\n.. _bob: http://www.idiap.ch/software/bob\n.. _csu face recognition resources: http://www.cs.colostate.edu/facerec\n.. _buildout: http://www.buildout.org", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/bioidiap/xfacereclib.paper.BeFIT2012", "keywords": "", "license": "LICENSE.txt", "maintainer": "", "maintainer_email": "", "name": "xfacereclib.paper.BeFIT2012", "package_url": "https://pypi.org/project/xfacereclib.paper.BeFIT2012/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/xfacereclib.paper.BeFIT2012/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://github.com/bioidiap/xfacereclib.paper.BeFIT2012" }, "release_url": "https://pypi.org/project/xfacereclib.paper.BeFIT2012/1.0.0/", "requires_dist": null, "requires_python": null, "summary": "Running the face recognition experiments as given in paper: \"An Open Source Framework for Standardized Comparisons of Face Recognition Algorithms\".", "version": "1.0.0" }, "last_serial": 2355367, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "981b2fd2c0673829797f4a078ea283ed", "sha256": "32f1d614f9edac1ed8f9c70b177d95166eabb868e6b70652159f0ca2997cba39" }, "downloads": -1, "filename": "xfacereclib.paper.BeFIT2012-1.0.0.zip", "has_sig": false, "md5_digest": "981b2fd2c0673829797f4a078ea283ed", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 136818, "upload_time": "2013-09-05T14:01:08", "url": "https://files.pythonhosted.org/packages/81/61/7fa1b0dfc23f0e2ea4f05997af87f8e6a88748265935164ac232123ecfc6/xfacereclib.paper.BeFIT2012-1.0.0.zip" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "981b2fd2c0673829797f4a078ea283ed", "sha256": "32f1d614f9edac1ed8f9c70b177d95166eabb868e6b70652159f0ca2997cba39" }, "downloads": -1, "filename": "xfacereclib.paper.BeFIT2012-1.0.0.zip", "has_sig": false, "md5_digest": "981b2fd2c0673829797f4a078ea283ed", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 136818, "upload_time": "2013-09-05T14:01:08", "url": "https://files.pythonhosted.org/packages/81/61/7fa1b0dfc23f0e2ea4f05997af87f8e6a88748265935164ac232123ecfc6/xfacereclib.paper.BeFIT2012-1.0.0.zip" } ] }