Changeset 36


Ignore:
Timestamp:
03/30/2009 03:06:17 PM (11 years ago)
Author:
dave
Message:

updated docs

File:
1 edited

Legend:

Unmodified
Added
Removed
  • foam/trunk/simple-faceident/README

    r27 r36  
    22-------------------------- 
    33 
    4 Uses OpenCV's face finder to record and detect identity. Sends bottles over  
    5 yarp on port /faceident containing the ID and confidence value. 
     4A simple approach to face identification, built on top of OpenCV and given a  
     5YARP network interface. 
    66 
    7 Use the number keys to train the system against different individuals. The idea  
    8 is that one by one, individuals show their faces, after which the system will  
    9 recognise who is who in the camera's view. The program will avoid recording  
    10 faces which are too similar to existing recorded ones. Press 'd' to switch to  
    11 switch off the training and just detect against existing faces. The boxes  
    12 around the faces display the id and the confidence value of the match. 
     7The program has two modes of operation. The first is calibration, where each  
     8user must show their face to the camera separately - press the number keys to  
     9assign each user with a different ID. You can see which face is mapped to  
     10which ID at the bottom of the window. 
    1311 
    14 Requires: OpenCV 
    15 Written and tested on Linux, but it should work in Windows too. 
    16 At the moment you'll probably have to run it with: 
     12The second mode of operation is face detection, where each visible detected  
     13face is given an ID based on it's closest match (within a given error  
     14threshold) with the faces recorded during calibration. The boxes drawn around  
     15the faces display the id and the confidence value of the match. When in this  
     16mode the program sends the following YARP messages: 
    1717 
    18 simple-faceident --cascade=/path/to/haarcascade_frontalface_alt.xml 
     18Port         Bottle contents                Meaning 
     19/faceident      "user appeared" ID confidence   A user has entered the view of the camera 
     20/faceident      "user disappeared" ID           The user has left the camera view 
    1921 
    20 In order to find OpenCV's data, on my machine it's in: 
     22Key                 Meaning 
     230-9 number keys     Calibrate a given id against a face in the scene 
     24d                   Start detect mode, which will send YARP messages 
     25c                   Clear all faces in the database 
     26 
     27Requires: OpenCV, YARP 
     28 
     29Written and tested on Linux, but it should work in Windows too. At the moment  
     30you'll probably have to run it with: 
     31 
     32simple-faceident -cascade=/path/to/haarcascade_frontalface_alt.xml 
     33 
     34In order to find OpenCV's data, on my machine it's in:  
    2135/usr/local/share/opencv/haarcascades/haarcascade_frontalface_alt.xml 
    2236 
    2337Todo: 
    24 * Command line parameters 
    25 * YARP interface 
    2638* Try normalised cross correlation instead of image differencing 
    2739 
Note: See TracChangeset for help on using the changeset viewer.