Windows上配置Mask R-CNN及运行示例demo.ipynb

　　最近做项目需要用到Mask R-CNN，于是花了几天时间配置、简单跑通代码，踩了很多坑，写下来分享给大家。

　　首先贴上官方Mask R-CNN的Github地址：https://github.com/matterport/Mask_RCNN，源码可以从这里下载，READ ME里也有一些介绍。

　　0、Mask R-CNN环境

　　Mask R-CNN是基于Python3，Keras，TensorFlow。

• Python 3.4+（自行安装，本文为Python 3.6）
• Jupyter Notebook
• TensorFlow>=1.3.0
• Keras>=2.0.8
• numpy、scipy、Pillow、cython、matplotlib、scikit-image、opencv-python、h5py、imgaug、IPython[all]

　　1、clone代码到当前目录，代码文件夹名为Mask_RCNN-master

 git clone https://github.com/matterport/Mask_RCNN.git

　　2、按Mask_RCNN-master/requirements.txt安装依赖环境

 pip3 install -r requirements.txt

　　注：此步安装了numpy、scipy、Pillow、cython、matplotlib、scikit-image、tensorflow>=1.3.0、keras>=2.0.8、opencv-python、h5py、imgaug、IPython[all]

　　我在此步遇到了问题，安装shaply的时候报错，OS Error：找不到指定模块

　　

　　用pip install单独安装shapely还是得到一样的错误。我的解决方法是：到https://www.lfd.uci.edu/~gohlke/pythonlibs/#shapely（一个非官方的扩展包下载地址，推荐），下载和你的python版本对应的shapely.whl：

　　

　　这里cp27指的是python2.7，win32是32位，win_amd64就是64位。我的电脑是64位，python3.6，所以我选择了第六个：

　　

　　接着运行如下命令：　

 python -m pip install Shapely-1.6.4.post1-cp36-cp36mwin_amd64.whl

　　安装成功。

　　3、下载训练好的COCO权重mask_rcnn_coco.h5

　　官网的下载地址为：https://github.com/matterport/Mask_RCNN/releases，下载下图第二个即可，把它放在Mask_RCNN-master目录下。

　　

　　若网速太慢，可从网盘下载。网盘链接：https://pan.baidu.com/s/12A0E6h-mP4zl9oqoTvj6Ig，密码：4eks^[1]

　　（网盘来源：https://blog.csdn.net/tanmx219/article/details/82828727）

　　4、安装pycocotools

　　pycocotools是coco训练集的api，如果你想使用coco训练、测试你的网络，就必须安装pycocotools。coco api提供了 Matlab, Python 和 Lua 的 API 接口，该 API 接口可以提供完整的图像标签数据的加载，parsing 和可视化。此外，网站还提供了数据相关的文章，教程等。^[2]

　　MS COCO数据集主页：http://cocodataset.org/

　　Github主页：https://github.com/Xinering/cocoapi，仅Linux使用，Windows不适用

　　关于API更多细节：http://cocodataset.org/#download

　　首先说清楚，这是个巨坑。安装了三天，期间遇到许多问题，一一解决之后才发现，pycocotools的作者根本没考虑Windows。一番百度之后，网上有两种解决方式：第一种是继续使用Linux版，暴力删除无效参数Wno-cpp和 Wno-unused-function，详见：https://www.jianshu.com/p/de455d653301

　　但这种实在过于粗暴啊...好在大佬在Github上分享了windows可用版：https://github.com/philferriere/cocoapi

　　一句就能解决：

 pip install git+https://github.com/philferriere/cocoapi.git#subdirectory=PythonAPI

　　注：必须安装Visual Studio C++。

　　5、安装jupyter notebooks

　　jupyter notebooks是一个web应用程序，你可以在上面编写、运行代码，可视化数据并查看结果，不仅如此，你的代码是被写入独立的单元中并被单独执行的，这允许用户测试项目中的特定代码块，而无需从脚本的开始执行代码。有关jupyter notebooks的基本介绍和用法：机器学习新手必看：jupyter notebooks入门指南

　　安装：

 pip install jupyter

　　安装成功后，python36/scripts如下：

　　

　　执行jupyter notebooks只需在命令行里输入：

 jupyter notebook

　　小提示：这款软件叫jupyter notebooks，运行只需打jupyter notebook就好，不需要加s。

　　启动成功，浏览器会自动打开notebooks窗口。有的计算机不会自动跳转，比如我，命令行会提示如下：

　　

　　复制最后一条网址：http://localhost:8888/?token=15771ade271dbc85b09003a6921e6029d9b3e6a153120465，浏览器打开即可。每次运行jupyter notebooks给的token都是不一样的，需要每次都复制打开。　

　　6、运行demo.ipynb

　　至此Mask R-CNN的环境就全部配置好啦，我们可以从Mask_RCNN-master/samples/demo.ipynb开始运行。demo.ipynb展示了一个使用MS COCO预先训练的模型来分割自己图像中的对象的例子， 它包括在任意图像上运行对象检测和实例分割的代码，在代码中，demo分割的图像随机来源于Mask_RCNN-master/images。

　　打开jupyter notebooks，按下图右下角的upload，打开demo.ipynb

　　

　　项目文件夹目录改成你的Mask_RCNN-master目录：

　　

　　运行代码，最下方会出现可视化结果：

　　

　　

　　不知为何，我的运行示例是错误的...正常的应该是这样：

　　

　　至此Mask R-CNN的简单示例运行就完成了。有问题可在下方留言。

　　参考资料：

　　[1]：https://blog.csdn.net/tanmx219/article/details/82828727

　　[2]：https://www.cnblogs.com/q735613050/p/8969452.html