annotate spotyping.xml @ 6:20c20bcdec36 draft

planemo upload
author jowong
date Tue, 13 Nov 2018 02:50:56 -0500
parents f1b3a263dd3a
children 1bf76073c034
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
1 <tool id="spotyping" name="Spoligotype Prediction" version="0.1.5">
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
2 <description>fast and accurate in silico Mycobacterium spoligotyping from sequence reads</description>
0
376f0194b92a planemo upload
jowong
parents:
diff changeset
3 <requirements>
376f0194b92a planemo upload
jowong
parents:
diff changeset
4 <requirement type="package" version="2.1">spotyping</requirement>
376f0194b92a planemo upload
jowong
parents:
diff changeset
5 </requirements>
3
ee4b383e7a4b planemo upload
jowong
parents: 2
diff changeset
6 <command detect_errors="aggressive"><![CDATA[
6
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
7 SpoTyping.py
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
8 $advanced.seq
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
9 $advanced.swift
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
10 --min=$advanced.min
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
11 --rmin=$advanced.min_relax
0
376f0194b92a planemo upload
jowong
parents:
diff changeset
12 #if str( $data_input.data_selector ) == "paired"
376f0194b92a planemo upload
jowong
parents:
diff changeset
13 $data_input.input1.forward $data_input.input1.reverse
376f0194b92a planemo upload
jowong
parents:
diff changeset
14 #end if
376f0194b92a planemo upload
jowong
parents:
diff changeset
15 #if str( $data_input.data_selector ) == "single"
6
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
16 $data_input.input2
0
376f0194b92a planemo upload
jowong
parents:
diff changeset
17 #end if
5
f1b3a263dd3a planemo upload
jowong
parents: 4
diff changeset
18 && cp SITVIT_ONLINE.*.xls spotyping.xls
3
ee4b383e7a4b planemo upload
jowong
parents: 2
diff changeset
19 ]]>
1
6d7d31716caa planemo upload
jowong
parents: 0
diff changeset
20 </command>
0
376f0194b92a planemo upload
jowong
parents:
diff changeset
21 <inputs>
376f0194b92a planemo upload
jowong
parents:
diff changeset
22 <conditional name="data_input">
6
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
23 <param name="data_selector" type="select" label="Single or Paired-end Data" help="Select between paired and single end data to add name to dataset">
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
24 <option value="paired">Paired</option>
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
25 <option value="single">Single</option>
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
26 </param>
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
27 <when value="paired">
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
28 <param name="input1" format="data" type="data_collection" collection_type="paired" label="Select a paired collection" help="a paired data"/>
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
29 </when>
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
30 <when value="single">
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
31 <param name="input2" format="data" type="data" label="input" help="Specify dataset with single reads"/>
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
32 </when>
0
376f0194b92a planemo upload
jowong
parents:
diff changeset
33 </conditional>
6
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
34 <section name="advanced" title="Advanced options" expanded="false">
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
35 <param type="boolean" argument="--seq" label="Input is assembled sequence" help="Input is either a complete genomic sequence or assembled contigs from an isolate" truevalue="--seq" falsevalue="" checked="false" />
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
36 <param type="boolean" argument="--swift" label="Swift mode" checked="true" truevalue="--swift=on" falsevalue="--swift=off" />
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
37 <param name="min" type="integer" value="5" label="MIN" help="minimum number of error-free hits to support presence of a spacer" />
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
38 <param name="min_relax" type="integer" value="6" label="MIN RELAX" help="minimum number of 1-error-tolerant hits to support presence of a spacer " />
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
39 </section>
0
376f0194b92a planemo upload
jowong
parents:
diff changeset
40 </inputs>
376f0194b92a planemo upload
jowong
parents:
diff changeset
41 <outputs>
4
d849a2f860e2 planemo upload
jowong
parents: 3
diff changeset
42 <data name="output1" label="spoligotyping results" format="txt" from_work_dir="SpoTyping"/>
d849a2f860e2 planemo upload
jowong
parents: 3
diff changeset
43 <data name="output2" label="spoligotyping log" format="txt" from_work_dir="SpoTyping.log"/>
5
f1b3a263dd3a planemo upload
jowong
parents: 4
diff changeset
44 <data name="output3" label="query" format="excel.xls" from_work_dir="spotyping.xls"/>
0
376f0194b92a planemo upload
jowong
parents:
diff changeset
45 </outputs>
376f0194b92a planemo upload
jowong
parents:
diff changeset
46 <help><![CDATA[
6
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
47 This is a modified version of IUC's wrapper of spotyping without the concatenation and renaming or input files. The wrapper also runs properly when supplied with paired-end reads
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
48
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
49 SpoTyping_ is a software for predicting spoligotype_ from sequencing reads, complete genomic sequences and assembled contigs.
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
50
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
51 **Input:**
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
52
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
53 - Fastq file - if paired end data is used, you may choose to concatenate paired reads into a single input (e.g. using the cat tool)
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
54 - Fasta file of a complete genomic sequence or assembled contigs of an isolate (with --seq option)
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
55
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
56 *Note on input size*: In swift mode the sampling threshold is reached in approximately 30x coverage when using
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
57 paired end sequencing of a *M. tuberculosis* genome.
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
58
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
59 **Output:**
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
60
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
61 Count of hits from BLAST result for each spacer sequence and predicted spoligotype in the format of binary code and octal code.
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
62
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
63 **Options:**
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
64
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
65 \--noQuery
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
66 Avoid querying the SITVIT_ online service to describe the prevalance of the reported spoligotype.
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
67
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
68 \--seq
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
69 Set this if input is a fasta file that contains only complete genomic sequence or assembled contigs from an isolate. [Default is off]
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
70
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
71 \-s SWIFT, --swift=SWIFT
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
72 Swift mode, either "on" or "off" [Default: on] - swift mode samples 250 million bases to use for spoligotyping
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
73
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
74 \--sorted
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
75 Set if input reads are sorted relative to positions on a reference genome. If reads are sorted and swift mode is used, swift mode's sampling is adjusted
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
76 to sample reads across positions in the genome evenly.
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
77
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
78 \--filter
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
79 Filter reads such that:
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
80
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
81 1. Leading and trailing 'N's would be removed.
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
82 2. Any read with more than 3 'N's in the middle would be removed.
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
83 3. Any read with more than 7 consecutive bases identical would be trimmed/filtered out given
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
84 the length of the flanking regions.
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
85
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
86 **Got weird spoligotype prediction?**
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
87
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
88 Sequencing throughput is very low (<40Mbp, for example): SpoTyping may not be able to give accurate prediction due to the relatively low read depth.
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
89
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
90 **Interpreting the spoligotype**
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
91
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
92 The binary or octal spoligotype can be used to look up lineage information using a service
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
93 like `TB Lineage`_.
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
94
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
95 **SITVIT reports**
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
96
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
97 Optionally a report on the detected spoligotype can be retrieved from the SITVIT_ database. If such a report is requested it can also be
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
98 illustrated as a (PDF format) plot.
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
99
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
100 .. _SpoTyping: https://github.com/xiaeryu/SpoTyping
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
101 .. _spoligotype: https://www.ncbi.nlm.nih.gov/pubmed/19521871
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
102 .. _TB Lineage: http://tbinsight.cs.rpi.edu/run_tb_lineage.html
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
103 .. _SITVIT: http://www.pasteur-guadeloupe.fr:8081/SITVIT_ONLINE/
0
376f0194b92a planemo upload
jowong
parents:
diff changeset
104 ]]></help>
376f0194b92a planemo upload
jowong
parents:
diff changeset
105 <citations>
376f0194b92a planemo upload
jowong
parents:
diff changeset
106 <citation type="bibtex">
376f0194b92a planemo upload
jowong
parents:
diff changeset
107 @misc{githubSpoTyping,
376f0194b92a planemo upload
jowong
parents:
diff changeset
108 author = {Xia, Eryu},
376f0194b92a planemo upload
jowong
parents:
diff changeset
109 year = {2016},
376f0194b92a planemo upload
jowong
parents:
diff changeset
110 title = {SpoTyping},
376f0194b92a planemo upload
jowong
parents:
diff changeset
111 publisher = {GitHub},
376f0194b92a planemo upload
jowong
parents:
diff changeset
112 journal = {GitHub repository},
376f0194b92a planemo upload
jowong
parents:
diff changeset
113 url = {https://github.com/xiaeryu/SpoTyping},
376f0194b92a planemo upload
jowong
parents:
diff changeset
114 }</citation>
6
20c20bcdec36 planemo upload
jowong
parents: 5
diff changeset
115 <citation type="doi">10.1186/s13073-016-0270-7</citation>
0
376f0194b92a planemo upload
jowong
parents:
diff changeset
116 </citations>
376f0194b92a planemo upload
jowong
parents:
diff changeset
117 </tool>