annotate rgWebLogo3.xml @ 2:ced02f5334a0 draft

planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/weblogo3 commit de7140295cce07e1bc1697e51dab4271c8d7a8a6
author devteam
date Fri, 18 Dec 2015 19:20:26 -0500
parents d16cc2d33359
children 13045f6015cb
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
1 <tool id="rgweblogo3" name="Sequence Logo" version="0.4">
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
2 <description>generator for fasta (eg Clustal alignments)</description>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
3 <requirements>
1
d16cc2d33359 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 0
diff changeset
4 <requirement type="package" version="1.7.1">numpy</requirement>
0
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
5 <requirement type="package" version="3.3">weblogo</requirement>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
6 <requirement type="package" version="9.10">ghostscript</requirement>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
7 </requirements>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
8 <command interpreter="python">
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
9 rgWebLogo3.py -F $outformat -s $size -i $input -o $output -t "$logoname" -c "$colours" -U "$units"
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
10 #if $range.mode == 'part'
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
11 -l "$range.seqstart" -u "$range.seqend"
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
12 #end if
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
13 </command>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
14 <inputs>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
15 <page>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
16 <param format="fasta" name="input" type="data" label="Fasta File" />
1
d16cc2d33359 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 0
diff changeset
17 <param name="logoname" label="Title for output Sequence Logo" type="text" value="Galaxy-Rgenetics Sequence Logo" />
0
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
18 <param name="outformat" type="select" label="Output format for image (or text report)" >
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
19 <option value="png" selected="True">PNG screen quality</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
20 <option value="png_print">High quality printable PNG</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
21 <option value="pdf">PDF</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
22 <option value="jpeg">JPG</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
23 <option value="eps">EPS</option>
1
d16cc2d33359 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 0
diff changeset
24 <option value="logodata">Text (shows the detailed calculations for each position - no image)</option>
0
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
25 </param>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
26 <param name="units" type="select" label="Display Units"
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
27 help="What the height of each logo element depicts - eg bits of entropy (default)">
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
28 <option value="bits" selected="True">Entropy (bits)</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
29 <option value="probability">Probability</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
30 <option value="nats">Nats</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
31 <option value="kT">kT</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
32 <option value="kJ/mol">kJ/mol</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
33 <option value="kcal/mol">kcal/mol</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
34 </param>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
35 <param name="colours" type="select" label="Colour scheme for output Sequence Logo"
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
36 help="Note that some of these only make sense for protein sequences!">
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
37 <option value="auto" selected="True">Default automatic colour selection</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
38 <option value="base pairing">Base pairing</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
39 <option value="charge">Charge colours</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
40 <option value="chemistry">Chemistry colours</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
41 <option value="classic">Classical colours</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
42 <option value="hydrophobicity">Hydrophobicity</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
43 <option value="monochrome">monochrome</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
44 </param>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
45
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
46
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
47 <conditional name="range">
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
48 <param name="mode" type="select" label="Include entire sequence (default) or specify a subsequence range to use">
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
49 <option value="complete" selected="true">complete sequence</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
50 <option value="part">Only use a part of the sequence</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
51 </param>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
52 <when value="complete">
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
53 </when>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
54 <when value="part">
1
d16cc2d33359 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 0
diff changeset
55 <param name="seqstart" type="integer" value="1" help="WARNING: Specifying indexes outside the sequence lengths will cause unpredictable but bad consequences!"
0
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
56 label="Index (eg 1=first letter) of the start of the sequence range to include in the logo">
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
57 </param>
1
d16cc2d33359 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 0
diff changeset
58 <param name="seqend" type="integer" value="99999" label="Index (eg 75=75th letter) of the end of the sequence range to include in the logo" >
0
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
59 </param>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
60 </when>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
61 </conditional>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
62 <param name="size" type="select" label="Output weblogo size" >
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
63 <option value="large" selected="True">Large</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
64 <option value="medium">Medium</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
65 <option value="small">Small</option>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
66 </param>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
67 </page>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
68 </inputs>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
69 <outputs>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
70 <data format="pdf" name="output" label="${logoname}_output.${outformat}">
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
71 <change_format>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
72 <when input="outformat" value="png_print" format="png" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
73 <when input="outformat" value="png" format="png" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
74 <when input="outformat" value="jpeg" format="jpg" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
75 <when input="outformat" value="eps" format="eps" />
1
d16cc2d33359 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 0
diff changeset
76 <when input="outformat" value="logodata" format="txt" />
0
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
77 </change_format>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
78 </data>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
79 </outputs>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
80 <tests>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
81 <test>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
82 <param name="input" value="rgClustal_testout.fasta" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
83 <param name="logoname" value="Galaxy/Rgenetics weblogo" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
84 <param name="outformat" value="jpeg" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
85 <param name="mode" value="complete" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
86 <param name="size" value="medium" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
87 <param name="colours" value="auto" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
88 <param name="units" value="bits" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
89 <output name="output" file="rgWebLogo3_test.jpg" ftype="jpg" compare="sim_size" delta="10000" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
90 </test>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
91 <test>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
92 <param name="input" value="rgClustal_testout.fasta" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
93 <param name="logoname" value="Galaxy/Rgenetics weblogo" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
94 <param name="outformat" value="png" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
95 <param name="mode" value="complete" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
96 <param name="size" value="medium" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
97 <param name="colours" value="auto" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
98 <param name="units" value="probability" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
99 <output name="output" file="rgWebLogo3_test2.png" ftype="png" compare="sim_size" delta="10000" />
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
100 </test>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
101 </tests>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
102 <help>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
103
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
104 **Note**
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
105
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
106 This tool uses Weblogo3_ in Galaxy to generate a sequence logo. The input file must be a fasta file in your current history.
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
107
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
108 It is recommended for (eg) viewing multiple sequence alignments output from the clustalw tool - set the output to fasta and feed
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
109 it in to this tool.
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
110
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
111 A typical output looks like this
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
112
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
113 .. image:: ${static_path}/images/rgWebLogo3_test.jpg
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
114
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
115 ----
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
116
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
117 **Warning about input Fasta format files**
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
118
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
119 The Weblogo3 program used by this tool will fail if your fasta sequences are not all EXACTLY the same length. The tool will provide a warning
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
120 and refuse to call the weblogo3 executable if irregular length sequences are detected.
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
121
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
122 Fasta alignments from the companion ClustalW Galaxy tool will work but many other fasta files may cause this tool to fail - please do not file
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
123 a Galaxy bug report - this is a feature of the tool and a problem with your source data - not a tool error - please make certain all your fasta
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
124 sequences are the same length!
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
125
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
126 ----
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
127
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
128 **Attribution**
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
129
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
130 Weblogo attribution and associated documentation are available at Weblogo3_
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
131
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
132 This Galaxy wrapper was written by Ross Lazarus for the rgenetics project and the source code is licensed under the LGPL_ like other rgenetics artefacts
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
133
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
134 .. _Weblogo3: http://weblogo.berkeley.edu/
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
135
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
136 .. _LGPL: http://www.gnu.org/copyleft/lesser.html
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
137
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
138 </help>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
139
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
140 </tool>
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
141
f64b81fda062 Imported from capsule None
devteam
parents:
diff changeset
142