人脸识别、检测、比对系统【Exadel CompreFace】学习笔记

Exadel CompreFace 是一个领先的免费和开源的人脸识别系统

1. 识别

人脸识别服务用于人脸识别。首先需要将已知的面孔上传到面孔集合中，然后在其中识别未知的面孔。

2. 检测

人脸检测服务用于检测图像中的所有人脸。它不能识别人脸，只能在图像上找到。

3. 比对

比较给定两张图片中的人脸，并返回它们的相似性。

文档、API和SDK：
https://github.com/exadel-inc/CompreFace

安装docker-compose

1. 下载
   cd /usr/local/compreFace && sudo curl -L https://get.daocloud.io/docker/compose/releases/download/1.25.1/docker-compose-uname -s-uname -m -o /usr/local/bin/docker-compose
2. 给予权限
   sudo chmod +x /usr/local/bin/docker-compose
3. 测试安装结果
   docker-compose --version

安装&运行

1. Download CompreFace_1.1.0.zip archive or run:
   wget -q -O tmp.zip 'https://github.com/exadel-inc/CompreFace/releases/download/v1.1.0/CompreFace_1.1.0.zip' && unzip tmp.zip && rm tmp.zip
2. To start CompreFace run:
   docker-compose up -d
3. Open in your browser: http://localhost:8000/login
4. To stop properly run:
   docker-compose stop
5. To start again run:
   docker-compose start

REST API 应用

人脸识别服务

人脸识别服务用于人脸识别。这意味着您首先需要将已知的人脸上传到人脸集合中，然后在其中识别未知的人脸。当你上传一张未知的脸时，该服务会返回与之最相似的脸。此外，人脸识别服务支持验证端点，以检查从人脸采集的人是否正确。

请求

curl -X POST "http://localhost:8000/api/v1/recognition/recognize?limit=<limit>&prediction_count=<prediction_count>&det_prob_threshold=<det_prob_threshold>&face_plugins=<face_plugins>&status=<status>" \ -H "Content-Type: multipart/form-data" \ -H "x-api-key: <service_api_key>" \ -F file=<local_file>

响应

http://10.3.0.254:8000/api/v1/recognition/recognize?face_plugins=age,gender,landmarks,mask

{
    "result": [
        {
            "age": { //年龄
                "probability": 0.9548584222793579, //概率
                "high": 20,
                "low": 15
            },
            "gender": { //性别
                "probability": 1.0, //概率
                "value": "female"
            },
           "box": { //边界框参数的集合
                "probability": 1.0, //发现的人脸是人脸的概率
                "x_max": 1546,//包含面的坐标系的坐标
                "y_max": 688,
                "x_min": 1133,
                "y_min": 241
            },
            "mask": { //面具
                "probability": 1.0,
                "value": "without_mask"
            },
            "subjects": [ //按相似度排序，大小为<prediction_count>的相似subject的列表
            	{
                    "subject": "zls",
                    "similarity": 1.0
                }
            ],
            "landmarks": [ //包含面部标志的框架的坐标列表
                [73,82],
                [106,81],
                [90,103],
                [74,117],
                [104,117]
            ]
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

应用

• 系统用户管理上传到compreFace服务器
• 前端检查人脸并拍照
• 然后调用接口进行比对
• subject用来区分人脸信息

subject下会有多张图像；

1. 理解成一个角色，subject对应角色名。某个subject上传拥有该角色所有用户的头像，匹配到该subject就表示具有该角色（应该有相应的权限）

2. 一个用户一个subject，subject对应用户名（或唯一标识）。