annotate kraken-filter.xml @ 6:ccfb9cbfcc72 draft

planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
author iuc
date Mon, 07 Aug 2017 17:27:49 -0400
parents d246279116a4
children 6e690205b306
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
1 <tool id="kraken-filter" name="Kraken-filter" version="@WRAPPER_VERSION@">
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
2 <description>filter classification by confidence score</description>
0
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
3 <macros>
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
4 <import>macros.xml</import>
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
5 </macros>
3
7fb926851f66 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit de7140295cce07e1bc1697e51dab4271c8d7a8a6
devteam
parents: 2
diff changeset
6 <expand macro="requirements" />
7fb926851f66 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit de7140295cce07e1bc1697e51dab4271c8d7a8a6
devteam
parents: 2
diff changeset
7 <expand macro="version_command" />
6
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
8 <command detect_errors="exit_code"><![CDATA[
1
f093ba52debe planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb1743eafd4ca98be0148d557770ef8635cc8d4c-dirty
devteam
parents: 0
diff changeset
9 @SET_DATABASE_PATH@ &&
6
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
10
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
11 kraken-filter
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
12 @INPUT_DATABASE@
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
13 --threshold $threshold
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
14 '${input}'
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
15 > '$filtered_output'
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
16 ]]></command>
0
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
17 <inputs>
6
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
18 <param name="input" type="data" format="tabular" label="Kraken output" help="Select taxonomy classification produced by kraken"/>
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
19 <param argument="--threshold" type="float" value="0" min="0" max="1"
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
20 label="Confidence threshold" help="A floating point number between 0 and 1; default=0"/>
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
21
0
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
22 <expand macro="input_database" />
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
23 </inputs>
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
24 <outputs>
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
25 <data format="tabular" name="filtered_output" />
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
26 </outputs>
3
7fb926851f66 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit de7140295cce07e1bc1697e51dab4271c8d7a8a6
devteam
parents: 2
diff changeset
27 <tests>
7fb926851f66 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit de7140295cce07e1bc1697e51dab4271c8d7a8a6
devteam
parents: 2
diff changeset
28 <test>
7fb926851f66 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit de7140295cce07e1bc1697e51dab4271c8d7a8a6
devteam
parents: 2
diff changeset
29 <param name="input" value="kraken_filter_test1.tab"/>
7fb926851f66 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit de7140295cce07e1bc1697e51dab4271c8d7a8a6
devteam
parents: 2
diff changeset
30 <param name="threshold" value="0"/>
7fb926851f66 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit de7140295cce07e1bc1697e51dab4271c8d7a8a6
devteam
parents: 2
diff changeset
31 <param name="kraken_database" value="test_db"/>
6
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
32
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
33 <output name="filtered_output" file="kraken_filter_test1_output.tab" ftype="tabular"/>
3
7fb926851f66 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit de7140295cce07e1bc1697e51dab4271c8d7a8a6
devteam
parents: 2
diff changeset
34 </test>
7fb926851f66 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit de7140295cce07e1bc1697e51dab4271c8d7a8a6
devteam
parents: 2
diff changeset
35 </tests>
7fb926851f66 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit de7140295cce07e1bc1697e51dab4271c8d7a8a6
devteam
parents: 2
diff changeset
36
0
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
37 <help>
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
38 <![CDATA[
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
39
2
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
40 .. class:: warningmark
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
41
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
42 **Note**: the database used must be the same as the one used in the original Kraken run
0
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
43
2
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
44 -----
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
45
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
46 **What it does**
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
47
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
48 At present, we have not yet developed a confidence score with a solid probabilistic interpretation for Kraken. However, we have developed a simple scoring scheme that has yielded good results for us, and we've made that available in the kraken-filter script. The approach we use allows a user to specify a threshold score in the [0,1] interval; the ``kraken-filter`` script then will adjust labels up the tree until the label's score (described below) meets or exceeds that threshold. If a label at the root of the taxonomic tree would not have a score exceeding the threshold, the sequence is called unclassified by ``kraken-filter``.
0
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
49
2
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
50 A sequence label's score is a fraction C/Q, where C is the number of k-mers mapped to LCA values in the clade rooted at the label, and Q is the number of k-mers in the sequence that lack an ambiguous nucleotide (i.e., they were queried against the database). Consider the example of the LCA mappings in Kraken's output::
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
51
6
ccfb9cbfcc72 planemo upload for repository https://github.com/galaxyproject/tools-iuc/blob/master/tool_collections/kraken/kraken_filter/ commit e8fc7c9dad5f583ad6763ecb9bd8c924832abacd
iuc
parents: 5
diff changeset
52 562:13 561:4 A:31 0:1 562:3
2
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
53
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
54 would indicate that::
0
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
55
2
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
56 the first 13 k-mers mapped to taxonomy ID #562
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
57 the next 4 k-mers mapped to taxonomy ID #561
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
58 the next 31 k-mers contained an ambiguous nucleotide
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
59 the next k-mer was not in the database
317726be0703 planemo upload for repository https://github.com/galaxyproject/tools-devteam/blob/master/tool_collections/kraken/kraken_filter/ commit cb6ebb843c71dcfc73aa05cc616f8e3229170108-dirty
devteam
parents: 1
diff changeset
60 the last 3 k-mers mapped to taxonomy ID #562
0
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
61
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
62 In this case, ID #561 is the parent node of #562. Here, a label of #562 for this sequence would have a score of C/Q = (13+3)/(13+4+1+3) = 16/21. A label of #561 would have a score of C/Q = (13+4+3)/(13+4+1+3) = 20/21. If a user specified a threshold over 16/21, kraken-filter would adjust the original label from #562 to #561; if the threshold was greater than 20/21, the sequence would become unclassified.
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
63 ]]>
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
64 </help>
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
65 <expand macro="citations" />
60d9479c58d6 Uploaded
devteam
parents:
diff changeset
66 </tool>