美文网首页
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