QIIME 2用户文档. 10数据导出

https://docs.qiime2.org/2020.11/tutorials/exporting/

Exporting data

注：最好按本教程顺序学习，想直接学习本章，至少完成本系列1简介和安装。

为了使用QIIME 2，输入数据必须存储在QIIME 2对象（即qza文件）中。这是支持分布式、自动来源跟踪、语义类型验证和数据格式之间的转换的基础（有关QIIME 2对象的更多详细信息，请参阅核心概念页）。

有时，您需要从QIIME 2对象中导出数据，例如使用不同的微生物组分析程序分析数据，或在R中进行统计分析。这可以通过使用qiime tools export命令来实现，该命令以QIIME 2对象（.qza）文件和输出目录作为输入。对象中的数据将根据特定对象导出一个或多个文件。

注意: 当从QIIME 2对象导出数据时，将不再有与数据相关的来源。如果随后重新导入数据，则与新对象关联的源将从导入步骤开始，并且所有现有的来源信息都将丢失。因此，最好只在使用QIIME 2完成所有可以实现的处理步骤后，再从对象中导出数据，以最大化每个对象的来源追溯。

以下部分提供了从QIIME 2对象导出数据的示例。可以从任何QIIME 2对象或可视化中导出数据；该过程与下面描述的过程相同。

详者注：为什么要导出文件？
QIIME2采用统一qza文件格式，是为了保证文件格式统一和分析流程可追溯。但不可能要求每个人都用此需系统，而且此系统的功能也不是万能的，需要导出其它软件兼容的格式，方便交流和其它用户开展个性化的分析。

启动工作环境并创建工作目录

# 定义工作目录变量，方便以后多次使用
wd=~/github/QIIME2ChineseManual/2020.11
mkdir -p $wd
# 进入工作目录
cd $wd

# 方法1. 进入QIIME 2 conda工作环境
conda activate qiime2-2020.11
# 这时我们的命令行前面出现 (qiime2-2020.11) 表示成功进入工作环境

# 方法2. docker安装的请运行如下命令，默认加载当前目录至/data目录
docker run --rm -v $(pwd):/data --name=qiime -it  qiime2/core:2020.11

# 建立工作目录
mkdir -p exporting
cd exporting

导出特征表

Exporting a feature table

导出FeatureTable[Frequency]对象为BIOM v2.1格式

wget -c https://data.qiime2.org/2020.11/tutorials/exporting/feature-table.qza
qiime tools export \
  --input-path feature-table.qza \
  --output-path exported-feature-table

• feature-table.qza：QIIME 2特征表文件。 查看 | 下载

详者注

导出的biom文件位于exported-feature-table文件夹中，名为feature-table.biom，可用biom程序对文件进行格式转换和分析，可参阅以下教程：

• BIOM：生物观测矩阵——微生物组数据通用数据格式

BIOM 2.1格式也是HDF5格式，为二进制，无法直接查看，必须转换为文本阅读。

转换biom为tsv格式

biom convert -i exported-feature-table/feature-table.biom \
    -o exported-feature-table/feature-table.txt \
    --to-tsv

查看文件less -S exported-feature-table/feature-table.txt

# Constructed from biom file
#OTU ID K3.H    K3.Z    M2.Middle.L     K3.A    K3.R    K3.V
New.CleanUp.ReferenceOTU0       2.0     0.0     0.0     0.0 
New.CleanUp.ReferenceOTU1       0.0     1.0     6.0     1.0 
New.CleanUp.ReferenceOTU3       0.0     0.0     0.0     0.0 

同理tsv转换为biom的代码如下：

biom convert -i exported-feature-table/feature-table.txt \
    -o table.from_txt_hdf5.biom \
    --table-type="OTU table" --to-hdf5

导出进化树

Exporting a phylogenetic tree

导出Phylogeny[Unrooted]对象为newick格式

wget -c https://data.qiime2.org/2020.11/tutorials/exporting/unrooted-tree.qza
qiime tools export \
  --input-path unrooted-tree.qza \
  --output-path exported-tree

• unrooted-tree.qza：无根树文件。 查看 | 下载

导文件为exported-tree/tree.nwk，是标准树nwk文件

(((New.CleanUp.ReferenceOTU1480:0.11995,(New.CleanUp.ReferenceOTU202:0.04479,
New.CleanUp.ReferenceOTU432:0.0049)0.769:0.04661)1:0.26705,
((New.CleanUp.ReferenceOTU1150:0.00016,(New.CleanUp.ReferenceOTU782:0.04264,(New.CleanUp.ReferenceOTU643:0.10438,
(((New.CleanUp.ReferenceOTU1014:0.01521,New.CleanUp.ReferenceOTU270:0.02738)0.879:0.02315,(((New.CleanUp.ReferenceOTU1008:0.0378

导出与提取

Exporting versus extracting

可以使用qiime tools extract来提取来提取QIIME 2对象。 提取对象不同于导出导出。 导出对象时，仅数据文件被放置在输出目录中。 提取还将在输出目录中以纯文本格式提供有关对象的QIIME 2的元数据，包括对象的出处。 对象可以按照以下代码提取。您要提取到的目录必须已经事先存在。

mkdir -p feature-table
qiime tools extract \
  --input-path feature-table.qza \
  --output-path feature-table

解压/提取目录包括一个对象编号UUID的目录，里面有所有文件。

推荐使用 https://view.qiime2.org 在线查看结果，可以图形化展示分析流程的追溯。

译者简介

刘永鑫，博士，中科院青促会会员，QIIME 2项目参与人。2008年毕业于东北农业大学微生物学专业，2014年于中国科学院大学获生物信息学博士，2016年遗传学博士后出站留所工作，任工程师。目前主要研究方向为宏基因组数据分析。目前在Science、Nature Biotechnology、Protein & Cell、Current Opinion in Microbiology等杂志发表论文30余篇，被引2千余次。2017年7月创办“宏基因组”公众号，目前分享宏基因组、扩增子原创文章2400余篇，代表作有《扩增子图表解读、分析流程和统计绘图三部曲(21篇)》、 《微生物组实验手册》、《微生物组数据分析》等，关注人数11万+，累计阅读2100万+。

Reference

https://docs.qiime2.org/2020.11/

Evan Bolyen, Jai Ram Rideout, Matthew R. Dillon, Nicholas A. Bokulich, Christian C. Abnet, Gabriel A. Al-Ghalith, Harriet Alexander, Eric J. Alm, Manimozhiyan Arumugam, Francesco Asnicar, Yang Bai, Jordan E. Bisanz, Kyle Bittinger, Asker Brejnrod, Colin J. Brislawn, C. Titus Brown, Benjamin J. Callahan, Andrés Mauricio Caraballo-Rodríguez, John Chase, Emily K. Cope, Ricardo Da Silva, Christian Diener, Pieter C. Dorrestein, Gavin M. Douglas, Daniel M. Durall, Claire Duvallet, Christian F. Edwardson, Madeleine Ernst, Mehrbod Estaki, Jennifer Fouquier, Julia M. Gauglitz, Sean M. Gibbons, Deanna L. Gibson, Antonio Gonzalez, Kestrel Gorlick, Jiarong Guo, Benjamin Hillmann, Susan Holmes, Hannes Holste, Curtis Huttenhower, Gavin A. Huttley, Stefan Janssen, Alan K. Jarmusch, Lingjing Jiang, Benjamin D. Kaehler, Kyo Bin Kang, Christopher R. Keefe, Paul Keim, Scott T. Kelley, Dan Knights, Irina Koester, Tomasz Kosciolek, Jorden Kreps, Morgan G. I. Langille, Joslynn Lee, Ruth Ley, Yong-Xin Liu, Erikka Loftfield, Catherine Lozupone, Massoud Maher, Clarisse Marotz, Bryan D. Martin, Daniel McDonald, Lauren J. McIver, Alexey V. Melnik, Jessica L. Metcalf, Sydney C. Morgan, Jamie T. Morton, Ahmad Turan Naimey, Jose A. Navas-Molina, Louis Felix Nothias, Stephanie B. Orchanian, Talima Pearson, Samuel L. Peoples, Daniel Petras, Mary Lai Preuss, Elmar Pruesse, Lasse Buur Rasmussen, Adam Rivers, Michael S. Robeson, Patrick Rosenthal, Nicola Segata, Michael Shaffer, Arron Shiffer, Rashmi Sinha, Se Jin Song, John R. Spear, Austin D. Swafford, Luke R. Thompson, Pedro J. Torres, Pauline Trinh, Anupriya Tripathi, Peter J. Turnbaugh, Sabah Ul-Hasan, Justin J. J. van der Hooft, Fernando Vargas, Yoshiki Vázquez-Baeza, Emily Vogtmann, Max von Hippel, William Walters, Yunhu Wan, Mingxun Wang, Jonathan Warren, Kyle C. Weber, Charles H. D. Williamson, Amy D. Willis, Zhenjiang Zech Xu, Jesse R. Zaneveld, Yilong Zhang, Qiyun Zhu, Rob Knight & J. Gregory Caporaso#. Reproducible, interactive, scalable and extensible microbiome data science using QIIME 2. Nature Biotechnology. 2019, 37: 852-857. doi:10.1038/s41587-019-0209-9