Dlib 是一个现代 C++ 工具包,包含了用于在 C++ 中创建复杂软件以解决实际问题的机器学习算法和工具。请参阅 http://dlib.net 获取项目的主要文档和 API 参考。
编译 dlib C++ 示例程序
进入 examples 文件夹并输入:
mkdir build; cd build; cmake .. ; cmake --build .
这将编译所有示例程序。 如果您的 CPU 支持 AVX 指令集,那么可以像这样开启它们:
mkdir build; cd build; cmake .. -DUSE_AVX_INSTRUCTIONS=1; cmake --build .
这样可以让某些操作运行得更快。
最后,Visual Studio 用户通常应该在 64 位模式下进行所有操作。默认情况下,Visual Studio 是 32 位的,无论是在输出中还是在其自身的执行中,所以您必须明确告诉它使用 64 位。既然现在不是 1990 年代了,您可能会希望使用 64 位模式。通过如下 cmake 命令来实现:
cmake .. -G "Visual Studio 14 2015 Win64" -T host=x64
编译使用 dlib 的 C++ 程序
examples 文件夹中有一个 CMake 教程,可以指导您如何操作。在 dlib 网站 上还有其他说明。
另外,如果您使用 vcpkg 依赖管理器,您可以通过一个命令下载并安装带有 CMake 集成的 dlib:
vcpkg install dlib
编译 dlib Python API
在运行 Python 示例程序之前,您必须先安装构建所需的环境:
python -m venv venv
pip install build
然后,您必须编译 dlib 并将其安装到您的环境中。输入以下命令:
python -m build --wheel
pip install dist/dlib-<version>.whl
或者通过 PyPi 下载 dlib:
pip install dlib
运行单元测试套件
输入以下命令编译并运行 dlib 单元测试套件:
cd dlib/test
mkdir build
cd build
cmake ..
cmake --build . --config Release
./dtest --runall
请注意,在 Windows 上,您的编译器可能会将测试可执行文件放在名为 Release
的子文件夹中。如果是这种情况,那么您需要先进入该文件夹再运行测试。
该库根据 Boost 软件许可证授权,可以在 dlib/LICENSE.txt 中找到。简而言之,该许可证允许您随意使用 dlib,即使是在闭源商业软件中。
dlib 赞助商
该研究部分基于国家情报总监办公室 (ODNI) 下属的情报高级研究计划活动 (IARPA) 的工作支持,合同号为 2014-14071600010。此处包含的观点和结论是作者的观点和结论,不应被解释为 ODNI、IARPA 或美国政府的官方政策或认可,无论是明确或隐含的。