开源项目 Human-detection-and-Tracking 使用教程

1. 项目目录结构及介绍

Human-detection-and-Tracking/
├── data/
│   └── 存放用于训练的人脸图像数据
├── face_cascades/
│   └── 存放用于人脸检测的级联分类器文件
├── results/
│   └── 存放程序运行结果
├── scripts/
│   └── 存放一些辅助脚本
├── video/
│   └── 存放用于测试的视频文件
├── .gitignore
├── LICENSE
├── README.md
├── create_face_model.py
├── main.cpp
├── main.py
├── model.yaml
└── tracking.cpp

目录结构说明

• data/: 存放用于训练的人脸图像数据。每个图像文件应命名为 subjectx_y.jpg，例如 subject01_0.jpg。
• face_cascades/: 存放用于人脸检测的级联分类器文件。
• results/: 存放程序运行结果。
• scripts/: 存放一些辅助脚本，用于处理数据或执行其他任务。
• video/: 存放用于测试的视频文件。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。
• create_face_model.py: 用于创建人脸识别模型的 Python 脚本。
• main.cpp: 用于人脸检测和识别的 C++ 主程序。
• main.py: 用于人脸检测和识别的 Python 主程序。
• model.yaml: 存放训练好的人脸识别模型文件。
• tracking.cpp: 用于跟踪的 C++ 程序。

2. 项目的启动文件介绍

2.1 main.py

main.py 是 Python 版本的主程序，用于人脸检测和识别。启动该程序时，需要提供视频文件的路径作为命令行参数。

python3 main.py -v /path/to/input/videos/

例如，如果视频文件存放在 video/ 目录下，可以这样启动：

python3 main.py -v /video

2.2 main.cpp

main.cpp 是 C++ 版本的主程序，用于人脸检测和识别。启动该程序时，需要提供视频文件的路径作为命令行参数。

首先，需要编译 main.cpp 文件：

g++ -ggdb `pkg-config --cflags opencv` -o `basename main.cpp .cpp` main.cpp `pkg-config --libs opencv`

然后，运行编译后的程序：

./main /path/to/input/video_file

例如，如果视频文件存放在 video/ 目录下，可以这样启动：

./main /video/2.mp4

3. 项目的配置文件介绍

3.1 model.yaml

model.yaml 是训练好的人脸识别模型文件，包含了用于识别的人脸特征。该文件由 create_face_model.py 脚本生成。

3.2 create_face_model.py

create_face_model.py 是一个 Python 脚本，用于从 data/ 目录中的图像数据创建人脸识别模型文件 model.yaml。

运行该脚本时，需要提供图像数据的路径作为命令行参数：

python3 create_face_model.py -i /path/to/persons_images/

例如，如果图像数据存放在 data/ 目录下，可以这样运行：

python3 create_face_model.py -i /data

3.3 .gitignore

.gitignore 文件用于配置 Git 忽略的文件和目录，避免将不必要的文件提交到版本控制系统中。

3.4 LICENSE

LICENSE 文件包含了项目的许可证信息，本项目使用 Apache-2.0 许可证。

3.5 README.md

README.md 是项目的说明文档，包含了项目的简介、安装方法、使用说明等内容。