# hunter

**Repository Path**: uniubi-opensource/hunter

## Basic Information

- **Project Name**: hunter
- **Description**: Hunter是一个包含人体检测、跟踪、人脸检测、识别、属性以及跨线统计的系统，可用于无感考勤、客流统计等场景。
- **Primary Language**: C++
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 16
- **Forks**: 4
- **Created**: 2022-03-30
- **Last Updated**: 2025-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 简介
Hunter是一个包含人体检测、跟踪、人脸检测、识别、属性以及跨线统计的系统，可用于无感考勤、客流统计等场景。
![image](background/background_3.png)
## 编译
编译环境：Windows  
Steps:  
clone to a dir, cd dir  
mkdir build && cd build  
cmake .. -G "Visual Studio 14 2015 Win64"  
运行 dispatcher-test
## 项目结构
3rdparty: 项目所用的第三方库，主要优minicaffe, opencv,openblas等。
background: 项目所用UI的背景图片。
cmake: 项目编译用  
model: 项目所用到的模型，以及相关的配置
src: 源文件  
- common: 项目公用的结构体定义  
- configuration: 配置文件解析  
- dispatcher: 模块总体调度，也是程序的入口  
- face-detection: 人脸检测
- face-identification: 人脸识别  
- face-information: 人脸属性  
- *-tracker: 跟踪  
- person-detection: 人体检测  
- person-detpose: 人体pose检测  
- person-information: 人体属性  
- person-reindentification: ReID  
- render: 绘制算法结果  
- staticstics: 统计算法信息  
- videostream: 视频输入的处理
注：由于文件太大，3rdparty及model目录请从网盘下载：
链接：https://pan.baidu.com/s/1wFtp_aZVYufgF4nFzda8ag 
提取码：8090
## 配置文件  
配置文件位于model目录中：
```
{   
    ##视频设置
    "video settings":{ 
        "mode":"online", ##online表示输入为rtsp摄像头，local则为视频文件
        "mfps":25,
        "video source":"rtsp://admin:abcd1234@192.168.30.20:554/",
        "rotate":2, ## <0, 不旋转，1,顺时针90,2 180,3 270
        "start frame":50,
        "start time":"2017-09-06 19:45:50"
        },
    
    "detector mode":1,
    "openpose model":{
        "model":["../model/pose_iter_440000.caffemodel", "../model/pose_deploy_linevec.prototxt"],
        "size":200
    },
    "person detector":{
        "model":"../model/deploy_mobilenet512_person_11_27",
        "epoch":0,
        "width":512,
        "height":512,
        "mean_r":123.0,
        "mean_g":117.0,
        "mean_b":104.0,
        "device type":"GPU",
        "device id":0,
        "threshold":0.5
    },
    "face detector":{
        "model":["../model/mtcnn/Pnet.txt","../model/mtcnn/Rnet.txt","../model/mtcnn/Onet.txt"],
        "width":200,
        "height":200
    },
    "face info":{
        "model":["../model/gender/squeezenet-a", "../model/age/age_resnet_female", "../model/age/age_resnet_male"],
        "epoch":19,
        "width":224,
        "height":224,
        "mean_r":123.0,
        "mean_g":117.0,
        "mean_b":104.0,
        "device type":"GPU",
        "device id":0,
        "threshold":0.5
    },
    "face id":{
        "enable":true,
        "model":[ "../model/facerec/sphereface_model.caffemodel","../model/facerec/sphereface_deploy.prototxt"],
        "feature mean":"../model/facerec/feature_mean.txt",
        "threshold":0.4 ##识别阈值
    },
    "door settings":[165,1533,986,1451], ##用于进出统计的门线坐标，x1y1,x2y2
    "render":{
        "background image":"../background/background_3.png",
        "person image":"../background/background_person_3.png",
        "draw rect":false, ##是否画框
        "mode":0
    },
    "statistics":{
        "init num_in":0,
        "init num_out":0,
        "init vip_in":0,
        "init non_vip_in":0,
		"init female_in":0,
		"init male_in":0
    },
    "database":{ ##人脸底库数据
      "image folder":"../database/employeechinese",
      "feature record":"../database/employeechinese.txt"
    },
    "tracker settings":{
       "max_track_length":5
    },
    "save face":{
        "issave":false,
        "save path":"../face_images/"
    }
}
```