终极指南：如何快速安装和使用Funannotate基因组注释工具

Funannotate是一款强大的真核生物基因组注释工具，专为生物信息学分析而设计。本指南将为您提供完整的Funannotate安装和使用教程，涵盖Docker快速部署和conda环境配置两种主流方案。

一键Docker部署步骤 🐳

Docker部署是最快速的Funannotate安装方式，特别适合希望快速开始基因组注释工作的用户。

快速开始Docker部署

# 从Docker Hub拉取最新镜像
docker pull nextgenusfs/funannotate

# 下载Docker包装脚本
wget -O funannotate-docker https://raw.githubusercontent.com/nextgenusfs/funannotate/master/funannotate-docker

# 添加执行权限
chmod +x funannotate-docker

# 运行测试验证安装
funannotate-docker test -t predict --cpus 12

Docker镜像包含了Funannotate所需的所有依赖项和数据库，但请注意GeneMark由于许可限制未包含在内。

conda环境快速配置 📦

对于希望在本地环境中安装的用户，conda提供了灵活的解决方案。

使用conda安装Funannotate

# 添加必要的conda通道
conda config --add channels defaults
conda config --add channels bioconda
conda config --add channels conda-forge

# 创建Funannotate环境
conda create -n funannotate "python>=3.6,<3.9" funannotate

使用mamba加速安装

如果conda解决环境依赖较慢，推荐使用mamba：

# 在base环境中安装mamba
conda install -n base mamba

# 使用mamba创建环境
mamba create -n funannotate funannotate

基因组注释实战教程 🔬

安装完成后，按照以下步骤配置和使用Funannotate：

环境激活和检查

# 激活conda环境
conda activate funannotate

# 检查所有模块是否安装
funannotate check --show-versions

数据库设置

# 下载并设置数据库到可写位置
funannotate setup -d $HOME/funannotate_db

# 设置环境变量
echo "export FUNANNOTATE_DB=$HOME/funannotate_db" > /conda/envs/funannotate/etc/conda/activate.d/funannotate.sh
echo "unset FUNANNOTATE_DB" > /conda/envs/funannotate/etc/conda/deactivate.d/funannotate.sh

运行测试验证

# 运行完整测试（需要网络连接下载数据）
funannotate test -t all --cpus 4

常见问题解决方案 ⚠️

GeneMark安装问题

由于许可限制，GeneMark需要手动安装：

• 访问GeneMark官网获取许可和下载
• 修改所有Perl脚本的shebang行使用/usr/bin/env perl
• 设置$GENEMARK_PATH环境变量

数据库路径配置

确保$FUNANNOTATE_DB环境变量正确指向数据库位置，否则需要在每次运行时指定数据库路径。

性能优化建议

• 根据可用CPU核心数调整--cpus参数
• 确保有足够的磁盘空间存放数据库（约20GB）
• 对于大型基因组，预留足够的内存资源

通过本指南，您应该能够成功安装和配置Funannotate基因组注释工具，开始您的生物信息学分析之旅。记得参考官方文档：docs/install.rst 获取最新信息和详细说明。