macOS下安装Dlib和Python2.7

macOS下安装Dlib和Python2.7

Dlib是一个使用现代C++技术编写的跨平台的通用库，遵守Boost Software licence.

主要特点如下：

1. 完善的文档：每个类每个函数都有详细的文档，并且提供了大量的示例代码，如果你发现文档描述不清晰或者没有文档，告诉作者，作者会立刻添加。
2. 可移植代码：代码符合ISO C++标准，不需要第三方库支持，支持win32、Linux、Mac OS X、Solaris、HPUX、BSDs 和 POSIX 系统
3. 线程支持：提供简单的可移植的线程API
4. 网络支持：提供简单的可移植的Socket API和一个简单的Http服务器
5. 图形用户界面：提供线程安全的GUI API
6. 数值算法：矩阵、大整数、随机数运算等
7. 机器学习算法：
8. 图形模型算法：
9. 图像处理：支持读写Windows BMP文件，不同类型色彩转换
10. 数据压缩和完整性算法：CRC32、Md5、不同形式的PPM算法
11. 测试：线程安全的日志类和模块化的单元测试框架以及各种测试assert支持
12. 一般工具：XML解析、内存管理、类型安全的big/little endian转换、序列化支持和容器类

本文学习如何在Mac osx系统中安装dlib，假设我们已经成功安装了Homebrew、anaconda。

第一步：准备工作

Homebrew

# 运行以下命令安装Homebrew，Homebrew默认被安装到/usr/local/Homebrew
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

# 添加环境变量，我装了oh-my-zsh，故将export命令添加到~/.zshrc中
echo 'export PATH=/usr/local/opt/opencv/bin:$PATH' >> ~/.zshrc

# 成功验证
brew -v

Anaconda

根据官网教程来下载安装anaconda客户端。

# 添加环境变量，也可以使用你喜欢的编辑器修改配置文件~/.zshrc或者~/.bash_profile
echo 'export PATH=~/anaconda/bin:$PATH' >> ~/.zshrc

# 查看已安装环境及当前被激活的环境，用户安装的不同python环境都会被放在目录~/anaconda/envs下，当前被激活的环境会显示有一个星号或者括号
conda info -e

# 创建python2.7虚拟环境，命名为pydlib，创建时自动安装完整anaconda集合包
conda create --n pydlib python=python2.7 anaconda

# 激活某个虚拟环境，conda、python、pip等均是运行在当前激活环境下的 
source activate pydlib

# 取消环境激活
source deactivate  # mac或Liunx

# 修改~/.zshrc配置文件，为source activate设置别名workon，为source deactivate设置别名workdone
echo alias workon=\"source activate\" >> ~/.zshrc
echo alias workdone=\"source deactivate\" >> ~/.zshrc

# 执行.zshrc使修改生效
source ~/.zshrc

# 现在就可以用workon 环境名，激活某个虚拟环境，用workdone取消激活某个虚拟环境
 Garden  ~  workon pydlib
 Garden  (e) pydlib  ~  workdone
 Garden  ~ 

注意：以下操作都是在虚拟环境pydlib下进行的。

第二步：安装依赖

dlib有四个主要的依赖工具：

1. Boost
2. Boost.Python
3. CMake
4. X11/XQuartx

下面我们来安装这些工具

brew install cmake
brew install boost
brew install boost-python --with-python3

安装验证:

brew list | grep cmake
# 如果成功安装，则有如下显示
cmake
brew list | grep boost
# 如果boost和boost-python成功安装，则有如下显示
boost
boost-python

X11是执行Unix程序的图形窗口环境。Mac OS X本身的程序是Aqua界面的，但是为了能够兼容unix和linux移植过来的程序（Mac OS X由BSD-UNIX修改而来），比如MatLab，就需要x11窗口环境。

运行dlib需要X11，但Mac目前没有自带X11，需要重新下载安装XQuartz window manager.dmg安装包，默认安装目录为opt/X11，需要在/usr/loca/opt目录下创建软连接，创建命令如下，创建后重启Mac

cd /usr/local/opt
ln -s /opt/X11 X11

第三步：安装dlib

python依赖包

dlib没有严格意义上的python依赖包，但是如果你想要使用dlib做任何视觉或图像处理的工作，一定要安装:

1. Numpy
2. Scipy
3. scikit-image

# 首先切换到pydlib环境
workon pydlib
# 查看是否安装对应包，anaconda的默认集合包一般会包括前两个
conda list | grep numpy

# 使用conda或pip进行安装
pip install numpy
pip install scipy
pip install scikit-image

安装dlib

以前我们还需要手动编译dlib（和安装Opencv类似），现在我们可以通过pip（conda不可以）来安装dlib：

# 此命令会从PyPI下载dlib安装包，自动通过CMake进行配置、编译并安装到你的系统
pip install dlib

安装验证：

Garden  ~  workon pydlib
 Garden  (e) pydlib  ~  python
Python 2.7.13 |Anaconda custom (x86_64)| (default, Dec 20 2016, 23:05:08)
[GCC 4.2.1 Compatible Apple LLVM 6.0 (clang-600.0.57)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
Anaconda is brought to you by Continuum Analytics.
Please check out: http://continuum.io/thanks and https://anaconda.org
>>> import dlib
>>>

参考

[1] How to install dlib
by Adrian Rosebrock on March 27, 2017 in dlib, Libraries, Tutorials