美文网首页
PlantCV 中文教程(2)

PlantCV 中文教程(2)

作者: 青叶007 | 来源:发表于2019-03-28 21:53 被阅读0次

安装配置

最低配置需求:

PlantCV 在以下系统已测试:

  • Linux: CentOS 7 (RedHat Enterprise Linux)
  • Linux: Ubuntu 12.04, 14.04, and 16.04
  • Linux: Raspbian "Jessie"
  • Mac OSX 10.11 and macOS 10.12+
  • Windows 10
  • Cloud9 IDE

需要的依赖包:

  • Python ( 2.7, 3.6及3.7版本已测试)
    • argparse
    • cv2 (即 OpenCV ; 部分功能要求 3.0+ 版本, 推荐使用 3.3+ 版本. 通过 PyPI 的 opencv-python 包进行安装)
    • matplotlib (最低需求 1.5版, 2+版本可正常工作)
    • numpy (最低需求 1.11版)
    • pandas
    • python-dateutil
    • scikit-image
    • scipy
    • plotnine
    • setuptools
    • pytest (仅用于测试)

推荐可选项:

  • conda (Anaconda 或者 Miniconda)
  • git
  • Jupyter
  • SQLite

通过package管理器安装

PlantCV 的稳定版可以通过 Python 包索引(PyPI)或者通过 Bioconda channel 进行 conda 安装。我们计划至少以月为周期在以上平台发布新版本。

PyPI

在任意虚拟运行环境通过 PyP I安装,以管理员身份或者 --user 角色输入以下内容

pip install plantcv

Conda

初次配制使用 conda 首先需要安装 AnacondaMiniconda 。如有需要,请添加以下通道到conda 配置中。

conda config --add channels defaults
conda config --add channels bioconda
conda config --add channels conda-forge

然后创建环境并安装PlantCV。

conda create -n plantcv plantcv

或者在已有环境中安装PlantCV。

conda install plantcv

手动安装

如果是开发者或者希望最新版本,也可以通过 Github 源安装。

基于 Conda 安装步骤

系统: Linux, macOS, Windows

根据使用情况可以有多种安装选项。如果有系统管理经验可以通过系统 package 管理工具和管理员权限来安装 PlantCV 及其依赖包。(如果安装出现问题可以咨询 )

对大部分用户我们推荐使用跨平台 package 管理系统 conda 进行安装。 Anaconda 或者 Miniconda 编译器都可以进行 conda 。 以下是安装步骤:

  1. 下载并安装适用操作系统的 conda 版本。除非有其他原因,我们推荐使用 Python 3。PlantCV 适用于 Python 2.7 但最终会停止针对 2.7 版本的更新。

  2. 从 GitHub 下载 PlantCV。可以使用 GitHub 客户端 或者命令行 git 。Git 允许你从 GitHub 更新, 如果不喜欢使用git也可以从 GitHub下载zip压缩包文件。

  3. 为 PlantCV 创建包含依赖包的 Python 环境。

  4. 安装 OpenCV 和 PlantC。

conda 以及 git 或者 Github 客户端安装完成后,复刻 PlantCV 库,打开命令行终端应用程序(在 Windows 中有其他的选项,本教程中使用 Anaconda Prompt 程序)。以下示例中我们使用 PlantCV 中的环境配置文件。

# 如果不使用Github 客户端程序,通过以下复刻 PlantCV。 
git clone https://github.com/danforthcenter/plantcv.git
# 进入 PlantCV 路径 (如果使用Github 客户端程序,以下路径会有所不同)
cd plantcv
# 创建 conda 环境,命名为 "plantcv"  并自动安装依赖包
conda env create -n plantcv -f environment.yml
# 激活 plantcv 环境 (每次开始新任务时都需要)
source activate plantcv
# 测试 PlantCV (可选)
python setup.py test
# 安装 PlantCV
python setup.py install

如果有损坏的环境,可以移除并重复以上步骤。

# 移除环境
conda env remove -n plantcv

sqlite3 在 macOS 和 Linux 版本上已经标配。在 Windows 中可以用 conda 来安装可选项 sqlite3 包.

conda install -c blaze sqlite3

使用 PlantCV 容器

平台: Linux, macOS, Windows

PlantCV 目前支持 Docker 系统,但是对 Singularity 及其他系统的支持还在开发中。 Docker 是一家提供操作系统级别虚拟器的平台。详见 Wikipedia 了解更多背景。容器是一种有效的方式,创建庆良便携的虚拟环境来隔离应用和包。PlantCV Docker 容器可以从 Docker Hub 获取。要使用 PlantCV container 必须要有 本地操作系统安装的 Docker。如果已有 docker, 可以通过以下方式使用 PlantCV :

# 从 Docker Hub 获取最新 PlantCV 镜像  
docker pull danforthcenter/plantcv
# 以下简单指令来部署 (导入成功无返回信息)
docker run danforthcenter/plantcv python -c 'import plantcv'

通过PlantCV Docker 容器分析数据需要映射包含容器文件系统的本地文件夹。我们在 /data的容器中设置了一个目录,以便将数据导入/导出容器。 在下面的示例中,本地数据和脚本位于名为/home/user的目录中,但它可以是您想要的任何目录。 /home/user 中的所有内容都可以在容器中访问,写入/容器中的数据的任何输出都将在你提供的本地路径写入。

这种情况下的示例,假设 /home/user 包含一个名为 test-script.py 的 PlantCV 脚本和一个名为 test-image.png 的图像。 在这种情况下,test-script.py 将是一个类似于 VIS tutorial 中描述的脚本。

# 使用 PlantCV docker 图像分析数据
docker run -v /home/user:/data danforthcenter/plantcv \
python /data/test-script.py -i /data/test-image.png -o /data -r /data/plantcv-results.txt

基于脚本的安装

平台: Ubuntu, macOS

复制 PlantCV 库:

git clone https://github.com/danforthcenter/plantcv.git

运行以下配置脚本:

cd plantcv
bash scripts/setup.sh

该脚本将指导你完成安装步骤,成功完成后以使用报告结束。

该脚本已在Ubuntu x86_64位16_04服务器版,OSX 10.11和macOS 10.12上进行了测试。

在其他系统上安装

Cloud9 IDE

Cloud9 是基于云的开发环境,可与Chromebook或其他客户端配合使用。 IDE工作区由Web浏览器中的Docker Ubuntu容器提供支持。

注册帐户后,创建一个新工作区并选择一个Python模板。

安装更新

sudo apt-get update

安装软件依赖包

sudo apt-get install git libopencv-dev python-opencv python-numpy python-matplotlib sqlite3

复制 PlantCV 到主路径

git clone https://github.com/danforthcenter/plantcv.git

默认分支(主)是最新版本。 如果想查看特定版本:

# 切换到稳定版
cd plantcv
git checkout v1.1

安装 PlantCV

sudo python setup.py install

安装完成后进行以下测试:

python -c 'import plantcv'

会返回以下错误:

libdc1394 error: Failed to initialize libdc1394

libdc1394允许程序与在ieee1394标准(火线)上工作的摄像机连接。 由于无法在Cloud9工作空间中启用USB访问,因此在运行管道时将始终出现此错误。 此错误对管道输出没有影响,并且可以继续工作,即使有警告。

要暂时删除驱动程序及错误可以使用:

sudo ln /dev/null /dev/raw1394

再次测试导入,您应该看不到更多错误。 重新启动工作空间将需要再次输入以删除libdc1394错误。

python -c 'import plantcv'

相关文章

网友评论

      本文标题:PlantCV 中文教程(2)

      本文链接:https://www.haomeiwen.com/subject/qldhbqtx.html