Menpo. Menpo项目的Python包,用于处理带注释的数据。
什么是Menpo?
Menpo是一个Menpo项目包,从头开始设计,旨在使导入、操作和可视化图像和网格数据变得尽可能简单。特别是,我们专注于机器学习和计算机视觉领域常见的带注释数据。所有核心类型都是可标记的
,并且可视化这些标记点非常简单。由于在Menpo中标记点是一等公民,因此像遮罩图像、在标记点内裁剪图像和对齐图像等任务变得非常简单。
面甲是覆盖全部或部分面部的面部护具,提供了一种固定头重的兜鍪(头盔)的方法。兜鍪的下巴绳(忍之绳)会系在面甲的下巴处。有一些叫做折钉或称为缚具的小钩子位于各个位置,用来帮助固定兜鍪的下巴绳。
--- 维基百科,面甲
安装
在Menpo团队,我们坚信应该尽可能简化安装过程。不幸的是,我们是一个复杂的项目,依赖于满足许多复杂的第三方库依赖。默认的Python打包环境并不能轻松完成这项任务。因此,我们倡导使用Anaconda提供的conda生态系统。为了使事情尽可能简单,我们建议你也使用conda!为了说服你,请访问Menpo网站查找所有主要平台的安装说明。
如果你坚持使用最常用的Python包管理系统pip
来使用Menpo,那么你应该可以按照以下方式安装Menpo:
> pip install menpo
我们强烈推荐使用conda,它不需要编译就可以安装Menpo或其依赖项,如Numpy、SciPy或Matplotlib。通过conda
安装就像这样简单:
> conda install -c conda-forge menpo
构建状态
并且还有额外的好处,可以安装一些常用的科学包,如SciPy和Numpy,因为Menpo也使用这些包。
使用
Menpo广泛使用Jupyter Notebooks来解释包的功能。这些Notebooks托管在menpo/menpo-notebooks仓库中。我们强烈建议在安装后:
- 下载最新版本的notebooks
- 使用Conda安装Jupyter notebook和IPython:
conda install jupyter ipython notebook
- 运行
jupyter notebook
- 尝试使用这些notebooks。
想不安装任何东西就体验Menpo吗?你可以直接从menpo网站浏览notebooks。
其他Menpo项目
Menpo被设计为实现机器学习和计算机视觉领域算法的核心库。例如,我们开发了一些更具体的库,它们依赖于Menpo的核心组件:
- menpofit:实现了最先进的可变形模型算法,包括活动外观模型、约束局部模型和监督下降方法。
- menpo3d:用于处理3D网格数据的有用工具,包括可视化和OpenGL光栅化器。这个包的要求很复杂,真的受益于conda的使用!
- menpodetect:一个包装现有物体检测源的包。核心项目采用BSD许可证,但由于包装了其他项目,它们可能与这个BSD许可证不兼容。因此,我们敦促在非学术目的使用这个库时要谨慎。
文档
查看我们在ReadTheDocs上的文档
测试
我们使用pytest进行单元测试。
安装pytest
、mock
和pytest-mock
后,在仓库的顶层运行
>> pytest .
将运行所有单元测试。
Menpo的一些小部分只有在用户安装了某些可选依赖项时才可用。这些包括:
- 3D查看方法,仅在安装了
menpo3d
时可用 menpo.feature.dsift
仅在安装了cyvlfeat
时可用- 某些扭曲单元测试仅在安装了
opencv
时可用