dlib README

The project's README from github.com/davisking/dlib. As one markdown file: README.md.

dlib C++ library GitHub Actions C++ Status GitHub Actions Python Status

Dlib is a modern C++ toolkit containing machine learning algorithms and tools for creating complex software in C++ to solve real world problems. See http://dlib.net for the main project documentation and API reference.

Compiling dlib C++ example programs

Go into the examples folder and type:

mkdir build; cd build; cmake .. ; cmake --build .

That will build all the examples. If you have a CPU that supports AVX instructions then turn them on like this:

mkdir build; cd build; cmake .. -DUSE_AVX_INSTRUCTIONS=1; cmake --build .

Doing so will make some things run faster.

Finally, Visual Studio users should usually do everything in 64bit mode. By default Visual Studio is 32bit, both in its outputs and its own execution, so you have to explicitly tell it to use 64bits. Since it's not the 1990s anymore you probably want to use 64bits. Do that with a cmake invocation like this:

cmake .. -G "Visual Studio 14 2015 Win64" -T host=x64

Compiling your own C++ programs that use dlib

The examples folder has a CMake tutorial that tells you what to do. There are also additional instructions on the dlib web site.

Alternatively, if you are using the vcpkg dependency manager you can download and install dlib with CMake integration in a single command:

vcpkg install dlib

Compiling dlib Python API

Either fetch the latest stable release of dlib from PyPi and install that:

pip install dlib

Or fetch the very latest version from github and install that:

git clone https://github.com/davisking/dlib.git
cd dlib
pip install .

It's possible to change build settings by passing parameters to setup.py or DLIB_* environment variables. For example, setting the environment variable DLIB_NO_GUI_SUPPORT to ON will add the cmake option -DDLIB_NO_GUI_SUPPORT=ON.

Running the unit test suite

Type the following to compile and run the dlib unit test suite:

cd dlib/test
mkdir build
cd build
cmake ..
cmake --build . --config Release
./dtest --runall

Note that on windows your compiler might put the test executable in a subfolder called Release. If that's the case then you have to go to that folder before running the test.

This library is licensed under the Boost Software License, which can be found in dlib/LICENSE.txt. The long and short of the license is that you can use dlib however you like, even in closed source commercial software.

dlib sponsors

This research is based in part upon work supported by the Office of the Director of National Intelligence (ODNI), Intelligence Advanced Research Projects Activity (IARPA) under contract number 2014-14071600010. The views and conclusions contained herein are those of the authors and should not be interpreted as necessarily representing the official policies or endorsements, either expressed or implied, of ODNI, IARPA, or the U.S. Government.

dlib (davisking/dlib)

Searching Database…

14.5K ·GitHub
Dlib
这是什么？Dlib 是一个现代的 C++ 工具包，包含机器学习算法和工具，用于构建实际的机器学习和数据分析应用，并附带 Python API。
这是 C++ 库，还是也能在 Python 中使用？它主要是一个 C++ 库，但也提供 Python API，可以从 PyPi 单独安装，或从源代码构建。
怎样把 dlib 加到我的项目里？C++ 用户可以参考 examples 文件夹中的 CMake 教程，或通过 vcpkg 包管理器一条命令安装并集成到 CMake 中。Python 用户只需从 PyPi 安装最新发布版，或从 GitHub 构建最新版本。
构建它需要 C++ 编译器和 CMake 吗？需要。构建 C++ 示例和库依赖 CMake 和 C++ 编译器；在支持的 CPU 上，你还可以选择启用 AVX 指令来加快速度。
在 Windows 上构建时有什么需要注意的坑吗？Visual Studio 默认生成 32 位的输出，其自身也以 32 位方式运行，因此要在 Windows 上正确构建 dlib，你需要明确指定 64 位的 CMake 生成器。
怎样检查我构建的 dlib 是否真的能正常工作？编译并运行 test 文件夹中自带的基于 CMake 的单元测试套件；在 Windows 上，测试可执行文件可能位于 Release 子文件夹中。
dlib 包含图形界面工具吗，还是只能无界面运行？它包含可选的图形界面支持，构建时可以通过设置环境变量 DLIBNOGUISUPPORT 将其关闭，这会对应加上相应的 CMake 选项。
dlib 的开发是谁资助的？dlib 背后的部分研究得到了美国国家情报总监办公室（ODNI）和 IARPA 的一份特定合同支持，不过 README 指出这并不代表它们的官方背书。
What are similar projects?opencv_contrib, opencv, X-AnyLabeling, libfacedetection, faceai, annoy, kornia, tesseract
Which topics is it in?face-detection, toolkit, c-plus-plus, object-detection, cmake, algorithms, neural-network, data-science, image-processing, cpp, computer-vision, c++
Creator
davisking
Size
49.9 MB
Stars
14.5K
Updated
CommitOct 04Releasev20.0.1Mar 29
Age
12y
Commits · 90 Days