|
22
|
1 <tool id="dante" name="Domain based ANnotation of Transposable Elements - DANTE" version="1.1.0">
|
|
0
|
2 <description> Tool for annotation of transposable elements based on the similarity to conserved protein domains database. </description>
|
|
|
3 <requirements>
|
|
|
4 <requirement type="package">last</requirement>
|
|
|
5 <requirement type="package">numpy</requirement>
|
|
3
|
6 <requirement type="package" version="1.0">rexdb</requirement>
|
|
10
|
7 <requirement type="set_environment">REXDB</requirement>
|
|
0
|
8 </requirements>
|
|
15
|
9 <stdio>
|
|
|
10 <regex match="Traceback" source="stderr" level="fatal" description="Unknown error" />
|
|
|
11 <regex match="error" source="stderr" level="fatal" description="Unknown error" />
|
|
|
12 </stdio>
|
|
|
13 <command>
|
|
|
14 #if str($input_type.input_type_selector) == "aln"
|
|
|
15 python3 ${__tool_directory__}/parse_aln.py -a $(input_sequences) -f sequences.fasta -p sequences.profile
|
|
|
16 &&
|
|
|
17 INPUT_SEQUENCES="sequences.fasta"
|
|
|
18 #else
|
|
|
19 INPUT_SEQUENCES=$(input_sequences)
|
|
|
20 #end if
|
|
|
21 &&
|
|
|
22
|
|
|
23
|
|
|
24 python3 ${__tool_directory__}/dante.py --query \${INPUT_SEQUENCES} --domain_gff ${DomGff}
|
|
|
25 --protein_database \${REXDB}/${db_type}_pdb
|
|
|
26 --classification \${REXDB}/${db_type}_class
|
|
|
27 --scoring_matrix ${scoring_matrix}
|
|
|
28
|
|
22
|
29 &&
|
|
|
30 python3 ${__tool_directory__}/dante_gff_output_filtering.py --dom_gff ${DomGff}
|
|
|
31 --domains_prot_seq ${Domains_filtered} --domains_filtered ${DomGff_filtered}
|
|
|
32 --output_dir .
|
|
|
33 --selected_dom All --th_identity 0.35
|
|
|
34 --th_similarity 0.45 --th_length 0.8
|
|
|
35 --interruptions 3 --max_len_proportion 1.2
|
|
|
36 --element_type ''
|
|
15
|
37
|
|
|
38 #if str($input_type.input_type_selector) == "aln"
|
|
|
39 &&
|
|
|
40 python3 ${__tool_directory__}/coverage2gff.py -p sequences.profile -g ${DomGff}
|
|
|
41 #end if
|
|
10
|
42
|
|
15
|
43 #if str($iterative) == "Yes"
|
|
|
44 &&
|
|
|
45 python3 ${__tool_directory__}/dante_gff_output_filtering.py --dom_gff ${DomGff}
|
|
|
46 --domains_prot_seq domains_filtered.fasta --domains_filtered domains_filtered.gff
|
|
|
47 --output_dir .
|
|
|
48 --selected_dom All --th_identity 0.35
|
|
|
49 --th_similarity 0.45 --th_length 0.9
|
|
|
50 --interruptions 1 --max_len_proportion 1.1
|
|
|
51 --element_type ''
|
|
|
52 &&
|
|
10
|
53
|
|
15
|
54
|
|
|
55
|
|
|
56 python3 ${__tool_directory__}/fasta2database.py domains_filtered.fasta domains_filtered.db
|
|
|
57 domains_filtered.class
|
|
|
58 &&
|
|
10
|
59
|
|
15
|
60 lastdb -p domains_filtered.db domains_filtered.db
|
|
|
61 &&
|
|
|
62
|
|
|
63 python3 ${__tool_directory__}/dante.py --query \${INPUT_SEQUENCES} --domain_gff ${DomGff2}
|
|
|
64 --protein_database domains_filtered.db
|
|
|
65 --classification domains_filtered.class
|
|
|
66 --scoring_matrix BL80
|
|
|
67
|
|
10
|
68
|
|
15
|
69 #if str($input_type.input_type_selector) == "aln"
|
|
|
70 &&
|
|
|
71 python3 ${__tool_directory__}/coverage2gff.py -p sequences.profile -g ${DomGff2}
|
|
|
72 #end if
|
|
|
73 #end if
|
|
10
|
74
|
|
15
|
75 </command>
|
|
|
76 <inputs>
|
|
0
|
77
|
|
15
|
78 <conditional name="input_type">
|
|
|
79 <param name="input_type_selector" type="select" label="Choose the type of sequence data">
|
|
|
80 <option value="fasta" selected="true">Fasta</option>
|
|
|
81 <option value="aln">Aln file</option>
|
|
|
82 </param>
|
|
|
83 <when value="fasta">
|
|
|
84 <param name="input_sequences" type="data" format="fasta" label="Sequences in fasta format"/>
|
|
|
85 </when>
|
|
|
86 <when value="aln">
|
|
|
87 <param name="input_sequences" type="data" format="txt" label="Sequences in ALN format (extracted from RepeatExplorer)"/>
|
|
|
88 </when>
|
|
|
89 </conditional>
|
|
|
90 <param name="db_type" type="select" label="Select taxon and protein domain database version (REXdb)" help="">
|
|
|
91 <options from_file="rexdb_versions.loc">
|
|
|
92 <column name="name" index="0"/>
|
|
|
93 <column name="value" index="1"/>
|
|
|
94 </options>
|
|
|
95 </param>
|
|
10
|
96
|
|
15
|
97 <param name="scoring_matrix" type="select" label="Select scoring matrix">
|
|
|
98 <option value="BL80" selected="true" >BLOSUM80</option>
|
|
|
99 <option value="BL62">BLOSUM62</option>
|
|
|
100 <option value="MIQS">MIQS</option>
|
|
|
101 </param>
|
|
0
|
102
|
|
15
|
103 <param name="iterative" type="select" label="Run iterative search" truevalue="true" valsevalue="false"
|
|
|
104 help="Second iteration run search against database of proteins extracted from query. Second iteration can yield some extra hits in some cases.">
|
|
|
105 <option value="No" selected="true">No</option>
|
|
|
106 <option value="Yes">Yes</option>
|
|
|
107 </param>
|
|
|
108 </inputs>
|
|
0
|
109
|
|
15
|
110 <outputs>
|
|
22
|
111 <data format="gff3" name="DomGff" label="DANTE on ${on_string}, full output" />
|
|
|
112 <data format="gff3" name="DomGff_filtered" label="DANTE on ${on_string}, filtered output" />
|
|
|
113 <data format="fasta" name="Domains_filtered" label="DANTE on ${on_string}, protein domains, filtered output" />
|
|
15
|
114 <data format="gff3" name="DomGff2" label="DANTE on ${on_string}: 2nd pass">
|
|
|
115 <filter>iterative == "Yes" </filter>
|
|
|
116 </data>
|
|
|
117 </outputs>
|
|
|
118 <tests>
|
|
|
119 <test>
|
|
|
120 <param name="input_type" value="fasta"/>
|
|
|
121 <param name="input_sequences" value="GEPY_test_long_1.fa"/>
|
|
|
122 <param name="db_type" value="Viridiplantae_v3.0"/>
|
|
|
123 <param name="scoring_matrix" value="BL80"/>
|
|
|
124 <param name="iterative" value="No"/>
|
|
|
125 <output name="DomGff" value="GEPY_test_long_1_output_unfiltered.gff3"/>
|
|
|
126 </test>
|
|
0
|
127
|
|
15
|
128
|
|
|
129 </tests>
|
|
0
|
130
|
|
|
131
|
|
15
|
132 <help>
|
|
0
|
133
|
|
15
|
134
|
|
22
|
135
|
|
15
|
136
|
|
|
137 **WHAT IT DOES**
|
|
|
138
|
|
|
139 This tool uses external aligning programme `LAST`_ and RepeatExplorer database of TE protein domains(REXdb) (Viridiplantae and Metazoa)
|
|
|
140
|
|
|
141 .. _LAST: http://last.cbrc.jp/
|
|
|
142
|
|
|
143 *Lastal* runs similarity search to find hits between query DNA sequence and our database of protein domains from all Viridiplantae repetitive elements. Hits with overlapping positions in the sequence (even through other hits) forms a cluster which represents one potential protein domain. Strand orientation is taken into consideration when forming the clusters which means each cluster is built from forward or reverse stranded hits exclusively. The clusters are subsequently processed separately; within one cluster positions are scanned base-by-base and classification strings are assigned for each of them based on the database sequences which were mapped on that place. These asigned classification strings consist of a domain type as well as class and lineage of the repetitive element where the database protein comes from. Different classification levels are separated by "|" character. Every hit is scored according to the scoring matrix used for DNA-protein alignment (BLOSUM80). For single position only the hits reaching certain percentage (80% by default) of the overall best score within the whole cluster are reported. One cluster of overlapping hits represents one domain region and is recorded as one line in the resulting GFF3 file. Regarding the classition strings assigned to one region (cluster) there are three situations that can occur:
|
|
0
|
144
|
|
15
|
145 1. There is a single classification string assigned to each position as well as classifications along all the positions in the region are mutually uniform, in this case domain's final classification is equivalent to this unique classification.
|
|
|
146 2. There are multiple classification strings assigned to one cluster, i.e. one domain, which leads to classification to the common (less specific) level of all the strings
|
|
|
147 3. There is a conflict at the domain type level, domains are reported with slash (e.g. RT/INT) and the classification is in this case ambiguous
|
|
|
148
|
|
|
149 **There are 2 outputs produced by this tool:**
|
|
|
150
|
|
|
151 1. GFF3 file of all proteins domains built from all hits found by LAST. Domains are reported per line as regions (start - end) on the original DNA sequence including the seq ID, alignment score and strand orientation. The last "Attributes" column contains several semicolon-separated information related to annotation, repetitive classification, alignment and its quality. This file can undergo further filtering using *Protein Domain Filter* tool
|
|
0
|
152
|
|
15
|
153 - Attributes reported always:
|
|
|
154
|
|
|
155 Name
|
|
0
|
156 type of domain; if ambiguous reported with slash
|
|
|
157
|
|
15
|
158 Final_classification
|
|
0
|
159 definite classification based on all partial classifications of Region_hits_classifications attribute or
|
|
|
160 "Ambiguous_domain" when there is an ambiguous domain type
|
|
|
161
|
|
15
|
162 Region_Hits_Classifications
|
|
0
|
163 all hits classifications (comma separated) from a certain domain region that reach the set score threshold; in case of multiple annotations the square brackets indicate the number of bases having this particular classification
|
|
15
|
164
|
|
|
165 - Attributes only reported in case of unambiguous domain type (all the attributes including quality information are related to the Best_Hit of the region):
|
|
|
166
|
|
|
167 Best_hit
|
|
0
|
168 classification and position of the best alignment with the highest score within the cluster; in the square brackets is the percentage of the whole cluster range that this best hit covers
|
|
|
169
|
|
15
|
170 Best_Hit_DB_Pos
|
|
0
|
171 showing which part of the original datatabase domain corresponding to the Best Hit was aligned on query DNA (e.g. **Best_Hit_DB_Pos=17:75of79** means the Best Hit reported in GFF represents region from 17th to 75th of total 79 aminoacids in the original domain from the database)
|
|
|
172
|
|
15
|
173 DB_Seq
|
|
0
|
174 database protein sequence of the best hit mapped to the query DNA
|
|
|
175
|
|
15
|
176 Query_Seq
|
|
0
|
177 alignment sequence of the query DNA for the best hit
|
|
|
178
|
|
15
|
179 Identity
|
|
0
|
180 ratio of identical amino acids in alignment sequence to the length of alignment
|
|
|
181
|
|
15
|
182 Similarity
|
|
0
|
183 ratio of alignment positions with positive score (according to the scoring matrix) to the length of alignment
|
|
|
184
|
|
15
|
185 Relat_Length
|
|
0
|
186 ratio of gapless length of the aligned protein sequence to the whole length of the database protein
|
|
|
187
|
|
15
|
188 Relat_Interruptions
|
|
0
|
189 number of the interruptions (frameshifts + stop codons) in aligned translated query sequence per each starting 100 AA
|
|
|
190
|
|
15
|
191 Hit_to_DB_Length
|
|
0
|
192 proportion of alignment length to the original length of the protein domain from database
|
|
15
|
193
|
|
|
194
|
|
0
|
195
|
|
15
|
196 !NOTE: Tool can in average process 0.5 Gbps of the DNA sequence per day. This is only a rough estimate and it is highly dependent on input data (repetive elements occurence) as well as computing resources. Maximum running time of the tool is 7 days.
|
|
0
|
197
|
|
15
|
198 </help>
|
|
0
|
199 </tool>
|
|
|
200
|
