【亲测免费】 FaceBoxes 项目安装与使用教程

1. 项目目录结构及介绍

FaceBoxes 项目的目录结构如下：

FaceBoxes/
├── cmake/
├── data/
│   └── WIDER_FACE/
├── docker/
├── docs/
├── examples/
│   └── images/
├── include/
│   └── caffe/
├── matlab/
├── models/
│   └── faceboxes/
├── python/
├── scripts/
├── src/
├── test/
├── tools/
├── .gitattributes
├── CMakeLists.txt
├── CONTRIBUTING.md
├── CONTRIBUTORS.md
├── INSTALL.md
├── LICENSE
├── Makefile
├── Makefile.config.example
├── README.md
├── caffe.cloc
├── faceboxes_framework.jpg
└── faceboxes_performance.jpg

目录介绍

• cmake/: 包含 CMake 构建文件。
• data/: 包含数据集相关文件，如 WIDER_FACE 数据集。
• docker/: 包含 Docker 相关文件。
• docs/: 包含项目文档。
• examples/: 包含示例图像。
• include/caffe/: 包含 Caffe 的头文件。
• matlab/: 包含 MATLAB 相关脚本。
• models/faceboxes/: 包含 FaceBoxes 模型的定义文件。
• python/: 包含 Python 脚本。
• scripts/: 包含各种脚本文件。
• src/: 包含源代码文件。
• test/: 包含测试脚本。
• tools/: 包含工具脚本。
• .gitattributes: Git 属性配置文件。
• CMakeLists.txt: CMake 构建配置文件。
• CONTRIBUTING.md: 贡献指南。
• CONTRIBUTORS.md: 贡献者列表。
• INSTALL.md: 安装指南。
• LICENSE: 项目许可证。
• Makefile: 构建 Makefile。
• Makefile.config.example: Makefile 配置示例。
• README.md: 项目介绍和使用说明。
• caffe.cloc: Caffe 代码统计文件。
• faceboxes_framework.jpg: FaceBoxes 框架图。
• faceboxes_performance.jpg: FaceBoxes 性能图。

2. 项目启动文件介绍

FaceBoxes 项目的启动文件主要是 train.sh 和 test/demo.py。

train.sh

train.sh 是用于训练 FaceBoxes 模型的脚本。它位于 models/faceboxes/ 目录下。使用该脚本可以启动训练过程。

cd $FaceBoxes_ROOT/models/faceboxes
sh train.sh

test/demo.py

test/demo.py 是用于测试和演示 FaceBoxes 模型的 Python 脚本。它位于 test/ 目录下。使用该脚本可以加载预训练模型并进行人脸检测。

cd $FaceBoxes_ROOT/test
python demo.py

3. 项目的配置文件介绍

FaceBoxes 项目的主要配置文件是 Makefile.config。该文件位于项目根目录下，用于配置 Caffe 的编译选项。

Makefile.config

Makefile.config 文件包含了 Caffe 的编译配置选项，如 CUDA 路径、OpenCV 路径等。用户可以根据自己的环境修改该文件。

cp Makefile.config.example Makefile.config

修改 Makefile.config 文件以适应你的 Caffe 安装环境。

# 例如，设置 CUDA 路径
CUDA_DIR := /usr/local/cuda

# 设置 OpenCV 路径
OPENCV_DIR := /usr/local/opencv

保存并关闭文件后，使用以下命令编译项目：

make all -j

通过以上步骤，你可以成功配置和启动 FaceBoxes 项目。