comparison rgweblogo/rgWebLogo3.xml @ 3:fad187cb76fe draft

Uploaded
author fubar
date Thu, 05 Dec 2013 00:56:04 -0500
parents
children 38ee0ae2f220
comparison
equal deleted inserted replaced
2:ef1f89257fdb 3:fad187cb76fe
1 <tool id="rgweblogo3" name="Sequence Logo" version="0.5">
2 <stdio>
3 <regex match=".*" source="both" level="warning" description="chatter from weblogo:"/>
4 </stdio>
5 <requirements>
6 <requirement type="package" version="3.3">package_weblogo</requirement>
7 <requirement type="package" version="1.7.1">numpy</requirement>
8 <requirement type="package" version="9.07">ghostscript</requirement>
9 </requirements>
10 <description>Generator from fasta</description>
11 <command interpreter="python">
12 rgWebLogo3.py -F $outformat -s $size -i $input -o $output -t "$logoname" -c "$colours" -U "$units"
13 #if $range.mode == 'part'
14 -l "$range.seqstart" -u "$range.seqend"
15 #end if
16 </command>
17 <inputs>
18 <page>
19 <param format="fasta" name="input" type="data" label="Fasta File" />
20 <param name="logoname" label="Title for output Sequence Logo" type="text" size="50" value="Galaxy-Rgenetics Sequence Logo" />
21 <param name="outformat" type="select" label="Output format for image (or text report)" >
22 <option value="png" selected="True">PNG screen quality</option>
23 <option value="png_print">High quality printable PNG</option>
24 <option value="pdf">PDF</option>
25 <option value="jpeg">JPG</option>
26 <option value="eps">EPS</option>
27 <option value="txt">Text (shows the detailed calculations for each position - no image)</option>
28 </param>
29 <param name="units" type="select" label="Display Units"
30 help="What the height of each logo element depicts - eg bits of entropy (default)">
31 <option value="bits" selected="True">Entropy (bits)</option>
32 <option value="probability">Probability</option>
33 <option value="nats">Nats</option>
34 <option value="kT">kT</option>
35 <option value="kJ/mol">kJ/mol</option>
36 <option value="kcal/mol">kcal/mol</option>
37 </param>
38 <param name="colours" type="select" label="Colour scheme for output Sequence Logo"
39 help="Note that some of these only make sense for protein sequences!">
40 <option value="auto" selected="True">Default automatic colour selection</option>
41 <option value="base pairing">Base pairing</option>
42 <option value="charge">Charge colours</option>
43 <option value="chemistry">Chemistry colours</option>
44 <option value="classic">Classical colours</option>
45 <option value="hydrophobicity">Hydrophobicity</option>
46 <option value="monochrome">monochrome</option>
47 </param>
48
49
50 <conditional name="range">
51 <param name="mode" type="select" label="Include entire sequence (default) or specify a subsequence range to use">
52 <option value="complete" selected="true">complete sequence</option>
53 <option value="part">Only use a part of the sequence</option>
54 </param>
55 <when value="complete">
56 </when>
57 <when value="part">
58 <param name="seqstart" size="5" type="integer" value="1" help="WARNING: Specifying indexes outside the sequence lengths will cause unpredictable but bad consequences!"
59 label="Index (eg 1=first letter) of the start of the sequence range to include in the logo">
60 </param>
61 <param name="seqend" size="5" type="integer" value="99999" label="Index (eg 75=75th letter) of the end of the sequence range to include in the logo" >
62 </param>
63 </when>
64 </conditional>
65 <param name="size" type="select" label="Output weblogo size" >
66 <option value="large" selected="True">Large</option>
67 <option value="medium">Medium</option>
68 <option value="small">Small</option>
69 </param>
70 </page>
71 </inputs>
72 <outputs>
73 <data format="pdf" name="output" label="${logoname}.${outformat}">
74 <change_format>
75 <when input="outformat" value="png_print" format="png" />
76 <when input="outformat" value="png" format="png" />
77 <when input="outformat" value="jpeg" format="jpg" />
78 <when input="outformat" value="eps" format="eps" />
79 <when input="outformat" value="txt" format="txt" />
80 </change_format>
81 </data>
82 </outputs>
83 <tests>
84 <test>
85 <param name="input" value="rgClustal_testout.fasta" />
86 <param name = "logoname" value="Galaxy/Rgenetics weblogo" />
87 <param name = "outformat" value="jpeg" />
88 <param name = "mode" value="complete" />
89 <param name = "size" value="medium" />
90 <param name = "colours" value="auto" />
91 <param name = "units" value="bits" />
92 <output name="output" file="rgWebLogo3_test.jpg" ftype="jpg" compare="sim_size" delta="10000" />
93 </test>
94 <test>
95 <param name="input" value="rgClustal_testout.fasta" />
96 <param name = "logoname" value="Galaxy/Rgenetics weblogo" />
97 <param name = "outformat" value="png" />
98 <param name = "mode" value="complete" />
99 <param name = "size" value="medium" />
100 <param name = "colours" value="auto" />
101 <param name = "units" value="probability" />
102 <output name="output" file="rgWebLogo3_test2.png" ftype="png" compare="sim_size" delta="10000" />
103 </test>
104 </tests>
105 <help>
106
107 **Note**
108
109 This tool uses Weblogo3_ in Galaxy to generate a sequence logo. The input file must be a fasta file in your current history.
110
111 It is recommended for (eg) viewing multiple sequence alignments output from the clustalw tool - set the output to fasta and feed
112 it in to this tool.
113
114 A typical output looks like this
115
116 .. image:: $PATH_TO_IMAGES/rgWebLogo3_test.jpg
117
118 ----
119
120 **Warning about input Fasta format files**
121
122 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
123 and refuse to call the weblogo3 executable if irregular length sequences are detected.
124
125 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
126 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
127 sequences are exactly the same length!
128
129
130 **Attribution**
131
132 Weblogo attribution and associated documentation are available at Weblogo3_
133
134 This Galaxy wrapper calls their software so depends on it and their license for your legal comfort.
135 The wrapper was written by Ross Lazarus for the rgenetics project and the source code is licensed under the LGPL_ like other rgenetics artefacts
136
137 .. _Weblogo3: http://weblogo.threeplusone.com/manual.html
138
139 .. _LGPL: http://www.gnu.org/copyleft/lesser.html
140
141 </help>
142
143 </tool>
144
145