AHRD (Automated Assignment of Human Readable Descriptions ), 对基因进行注释，包括GO。
githup直戳这里
安装
首先必须安装Java 1.7 以上版本，以及ant
利用git 克隆
git clone https://github.com/groupschoof/AHRD.git
cd AHRD
git checkout tags/v3.3.3
或者自行下载AHRD v.3.3.3 (zip or tar.gz) 安装
减压缩后，键入
ant dist
即可得到执行程序. ./dist/ahrd.jar
使用
- 输入数据
- 蛋白序列，fasta格式
- blastp or blat 比对结果 (可以和swissprot,trembl,tair 等任何库进行比较)，tap 分隔
可以通过如下命令得到
blastp -outfmt 6 -query query_sequences_AA.fasta -db uniprot_swissprot.fasta -out query_vs_swissprot.txt
- GO (可选)
若想对GO进行注释，则需要一个GO注释文件，可从 Uniprot server下载goa_uniprot_all.gaf.gz
wget http://ftp.ebi.ac.uk/pub/databases/GO/goa/UNIPROT/goa_uniprot_all.gaf.gz
该文件包含所有UniprotKB ID 所对应的GO，根据blast的结果将GO添加到特定对应的基因上。
若自己提供GO 对应文件则需要修改添加相应正则匹配，因为uniprotKB GOA 文件使用的是短名称，类似W9QFR0， 但是uniprotKB FASTA数据使用的是长名称，类似tr|W9QFR0|W9QFR0_9ROSA， 为了将二者相对应，AHRD提供了相应的正则去匹配，默认情况下，ARHD可以处理uniprot格式文件，若自己提供GO 对应文件则需要修改添加相应正则匹配。
- 利用正则调取短蛋白名称和GO文件进行匹配，利用reference_go_regex, e.g. reference_go_regex: ^UniProtKB\s+(?<shortAccession>\S+)\s+\S+\s+(?<goTerm>GO:\d{7})
- 利用正则从长名称中调取短名称，比如在拟南芥中，short_accession_regex: "^(?<shortAccession>.+)$".
- 配置文件
根据需求进行文件的配置，可参考实例文件 ./test/resources/ahrd_example_input.yml
proteins_fasta: ./test/resources/proteins.fasta
token_score_bit_score_weight: 0.468
token_score_database_score_weight: 0.2098
token_score_overlap_score_weight: 0.3221
gene_ontology_result: ./test/resources/reference_gene_ontology_annotations_uniprotKB_GOA.txt
prefer_reference_with_go_annos: true
output: ./ahrd_output.csv
blast_dbs:
swissprot:
weight: 653
description_score_bit_score_weight: 2.717061
file: ./test/resources/swissprot_blast8_tabular.txt
database: ./test/resources/swissprot_blast_db.fasta
blacklist: ./test/resources/blacklist_descline.txt
filter: ./test/resources/filter_descline_sprot.txt
token_blacklist: ./test/resources/blacklist_token.txt
trembl:
weight: 904
description_score_bit_score_weight: 2.590211
file: ./test/resources/trembl_blast8_tabular.txt
database: ./test/resources/trembl_blast_db.fasta
blacklist: ./test/resources/blacklist_descline.txt
filter: ./test/resources/filter_descline_trembl.txt
token_blacklist: ./test/resources/blacklist_token.txt
tair:
weight: 854
description_score_bit_score_weight: 2.917405
file: ./test/resources/tair_blast8_tabular.txt
database: ./test/resources/tair_blast_db.fasta
fasta_header_regex: "^>(?<accession>[aA][tT][0-9mMcC][gG]\\d+(\\.\\d+)?)\\s+\\|[^\\|]+\\|\\s+(?<description>[^\\|]+)(\\s*\\|.*)?$"
short_accession_regex: "^(?<shortAccession>.+)$"
blacklist: ./test/resources/blacklist_descline.txt
filter: ./test/resources/filter_descline_tair.txt
token_blacklist: ./test/resources/blacklist_token.txt
其中，
- gene_ontology_result 为GO对应文件，若不进行GO注释，则可删除
- 第2，3，4列为权重文件，若使用blastx结果而非blastp，应对其值进行修改。
由于该算法基于蛋白质序列，而BLASTX搜索基于核苷酸序列，因此在计算blast结果的重叠分数时会出现问题。 要解决此问题，必须将token_score_overlap_score_weight设置为0.0。 因此，其他两个分数必须提高。 这三个参数的总和为1。结果参数配置如下所示：
token_score_bit_score_weight: 0.6
token_score_database_score_weight: 0.4
token_score_overlap_score_weight: 0.0
- prefer_reference_with_go_annos: true 若使用GO注释，强烈建议选择true
- Description blacklist: 实为正则表达，即对描述结果匹配到的内容（比如：Whole genome shotgun sequence）忽视。
- Description filter: 实为正则表达，即对描述结果匹配到的内容（the trailing Species-Descriptions ’OS=Arabidopsis thaliana）进行删除。
- Token blacklist： 实为正则表达，对任何匹配的内容进行忽视。
** 拟南芥官网下载pep
- 输出文件
AHRD支持两种输出格式， Tap分隔以及fasta格式
- tap 分隔格式
每一列信息如下：
- Protein-Accession: query 蛋白名称
- Blast-Hit-Accession： 蛋白库的名称
-
AHRD-Quality-Code： 包含三种字符，如果满足个字的条件则为*，不满足为-。条件如下：
- Human-Readable-Description: 注释描述
- Interpro-ID (Description)
- Gene-Ontology-Term： GO 注释描述
- fasta格式
若想出书fasta格式，则需要键入如下
output_fasta: true
- 运行
java -Xmx2g -jar ./dist/ahrd.jar your_use_case_file.yml
若运行时出现如下报错
Error: A JNI error has occurred, please check your installation and try again
Exception in thread "main" java.lang.UnsupportedClassVersionError:
ahrd/controller/AHRD has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0
表明java 和javac版本不一致，可查看
java -version
javac -version
选择相同版本的java进行
