annotate vennerable/Vennerable.xml @ 0:77bbf955e8de default tip

initial commit
author eric
date Thu, 06 Nov 2014 15:07:54 +0100
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
77bbf955e8de initial commit
eric
parents:
diff changeset
1 <tool id="Vennerable" name="Vennerable" version="1.2c" >
77bbf955e8de initial commit
eric
parents:
diff changeset
2 <description>: Plot data in Venn or Edwards/Venn-like diagrams</description>
77bbf955e8de initial commit
eric
parents:
diff changeset
3 <command>
77bbf955e8de initial commit
eric
parents:
diff changeset
4 R --slave --vanilla --file=\$VENNERABLE_SCRIPT_PATH/vennerable/Vennerable.R
77bbf955e8de initial commit
eric
parents:
diff changeset
5 --args $inputFile
77bbf955e8de initial commit
eric
parents:
diff changeset
6 #if $opt.userSpecified == "Yes"
77bbf955e8de initial commit
eric
parents:
diff changeset
7 default
77bbf955e8de initial commit
eric
parents:
diff changeset
8 #else
77bbf955e8de initial commit
eric
parents:
diff changeset
9 "$opt.xNames"
77bbf955e8de initial commit
eric
parents:
diff changeset
10 #end if
77bbf955e8de initial commit
eric
parents:
diff changeset
11 $weighting
77bbf955e8de initial commit
eric
parents:
diff changeset
12 #if $imagetype.value == "svg"
77bbf955e8de initial commit
eric
parents:
diff changeset
13 $outputFile_svg
77bbf955e8de initial commit
eric
parents:
diff changeset
14 $plottype
77bbf955e8de initial commit
eric
parents:
diff changeset
15 $resolution
77bbf955e8de initial commit
eric
parents:
diff changeset
16 svg
77bbf955e8de initial commit
eric
parents:
diff changeset
17 #else if $imagetype.value == "png"
77bbf955e8de initial commit
eric
parents:
diff changeset
18 $outputFile_png
77bbf955e8de initial commit
eric
parents:
diff changeset
19 $plottype
77bbf955e8de initial commit
eric
parents:
diff changeset
20 $resolution
77bbf955e8de initial commit
eric
parents:
diff changeset
21 png
77bbf955e8de initial commit
eric
parents:
diff changeset
22 #else
77bbf955e8de initial commit
eric
parents:
diff changeset
23 $outputFile_pdf
77bbf955e8de initial commit
eric
parents:
diff changeset
24 $plottype
77bbf955e8de initial commit
eric
parents:
diff changeset
25 $resolution
77bbf955e8de initial commit
eric
parents:
diff changeset
26 pdf
77bbf955e8de initial commit
eric
parents:
diff changeset
27 #end if
77bbf955e8de initial commit
eric
parents:
diff changeset
28 2&gt;$Vennerable_log
77bbf955e8de initial commit
eric
parents:
diff changeset
29 1&gt;&gt;$Vennerable_log
77bbf955e8de initial commit
eric
parents:
diff changeset
30 </command>
77bbf955e8de initial commit
eric
parents:
diff changeset
31 <inputs>
77bbf955e8de initial commit
eric
parents:
diff changeset
32 <param name="inputFile" format="tabular" type="data" label="Data set" />
77bbf955e8de initial commit
eric
parents:
diff changeset
33 <conditional name="opt">
77bbf955e8de initial commit
eric
parents:
diff changeset
34 <param name="userSpecified" type="select" label="Use column headers as dataset names?">
77bbf955e8de initial commit
eric
parents:
diff changeset
35 <option value="Yes">Yes</option>
77bbf955e8de initial commit
eric
parents:
diff changeset
36 <option value="No">No</option>
77bbf955e8de initial commit
eric
parents:
diff changeset
37 </param>
77bbf955e8de initial commit
eric
parents:
diff changeset
38 <when value="Yes">
77bbf955e8de initial commit
eric
parents:
diff changeset
39 </when>
77bbf955e8de initial commit
eric
parents:
diff changeset
40 <when value="No">
77bbf955e8de initial commit
eric
parents:
diff changeset
41 <param name="xNames" type="text" label="Alternative data names" value="A,B,C,D" help="(comma-separated)"/>
77bbf955e8de initial commit
eric
parents:
diff changeset
42 </when>
77bbf955e8de initial commit
eric
parents:
diff changeset
43 </conditional>
77bbf955e8de initial commit
eric
parents:
diff changeset
44 <param name="plottype" type="select" label="Plot type to use" help="some other options might get disabled for certain plottypes" >
77bbf955e8de initial commit
eric
parents:
diff changeset
45 <option value="AWFE" selected="True">AWFE: Edwards-Venn (Non-weighted up to 5 datasets)</option>
77bbf955e8de initial commit
eric
parents:
diff changeset
46 <option value="ChowRuskey">Chow-Ruskey (always weigthed max 9 sets common intersect not 0)</option>
77bbf955e8de initial commit
eric
parents:
diff changeset
47 <option value="ellipses">Ellipses (4 datasets only and always non-weighted)</option>
77bbf955e8de initial commit
eric
parents:
diff changeset
48 <option value="circles">Circles (max 3 datasets)</option>
77bbf955e8de initial commit
eric
parents:
diff changeset
49 <option value="squares">Squares (max 4 datasets non-weighted)</option>
77bbf955e8de initial commit
eric
parents:
diff changeset
50 <option value="battle">Edwards-Venn Squares battle (max 9 datasets, non-weighted)</option>
77bbf955e8de initial commit
eric
parents:
diff changeset
51 </param>
77bbf955e8de initial commit
eric
parents:
diff changeset
52 <param name="weighting" type="select" label="Use weighting for data in plot" >
77bbf955e8de initial commit
eric
parents:
diff changeset
53 <option value="FALSE" selected="True">Non-weighted</option>
77bbf955e8de initial commit
eric
parents:
diff changeset
54 <option value="TRUE">Weighted</option>
77bbf955e8de initial commit
eric
parents:
diff changeset
55 </param>
77bbf955e8de initial commit
eric
parents:
diff changeset
56 <param name="resolution" type="integer" label="Resolution to use (dpi)" value="150" help="Plot features can be sized with this setting (PNG only). Lower (50) is larger text.&lt;br /&gt;&lt;i&gt;Default is vector graphics format SVG!&lt;/i&gt;" />
77bbf955e8de initial commit
eric
parents:
diff changeset
57 <param name="imagetype" type="select" label="Image output format" help="Scalable Vector Graphics (SVG) format is best for post processing" >
77bbf955e8de initial commit
eric
parents:
diff changeset
58 <option value="pdf" selected="True">PDF</option>
77bbf955e8de initial commit
eric
parents:
diff changeset
59 <option value="svg">SVG</option>
77bbf955e8de initial commit
eric
parents:
diff changeset
60 <option value="png">PNG</option>
77bbf955e8de initial commit
eric
parents:
diff changeset
61 </param>
77bbf955e8de initial commit
eric
parents:
diff changeset
62 </inputs>
77bbf955e8de initial commit
eric
parents:
diff changeset
63 <outputs>
77bbf955e8de initial commit
eric
parents:
diff changeset
64 <data name="outputFile_svg" format="svg" label="Venn diagram svg of ${inputFile.name}">
77bbf955e8de initial commit
eric
parents:
diff changeset
65 <filter>imagetype=="svg"</filter>
77bbf955e8de initial commit
eric
parents:
diff changeset
66 </data>
77bbf955e8de initial commit
eric
parents:
diff changeset
67 <data name="outputFile_png" format="png" label="Venn diagram png of ${inputFile.name}">
77bbf955e8de initial commit
eric
parents:
diff changeset
68 <filter>imagetype=="png"</filter>
77bbf955e8de initial commit
eric
parents:
diff changeset
69 </data>
77bbf955e8de initial commit
eric
parents:
diff changeset
70 <data name="outputFile_pdf" format="pdf" label="Venn diagram pdf of ${inputFile.name}">
77bbf955e8de initial commit
eric
parents:
diff changeset
71 <filter>imagetype=="pdf"</filter>
77bbf955e8de initial commit
eric
parents:
diff changeset
72 </data>
77bbf955e8de initial commit
eric
parents:
diff changeset
73 <data name="Vennerable_log" format="tabular" label="Vennerable output and error log file" />
77bbf955e8de initial commit
eric
parents:
diff changeset
74 </outputs>
77bbf955e8de initial commit
eric
parents:
diff changeset
75 <tests>
77bbf955e8de initial commit
eric
parents:
diff changeset
76 <test>
77bbf955e8de initial commit
eric
parents:
diff changeset
77 </test>
77bbf955e8de initial commit
eric
parents:
diff changeset
78 </tests>
77bbf955e8de initial commit
eric
parents:
diff changeset
79 <requirements>
77bbf955e8de initial commit
eric
parents:
diff changeset
80 <requirement type="package" version="3.0.3">R</requirement>
77bbf955e8de initial commit
eric
parents:
diff changeset
81 <requirement type="package" version="1.0">vennerable_r_packages</requirement>
77bbf955e8de initial commit
eric
parents:
diff changeset
82 <requirement type="set_environment">VENNERABLE_SCRIPT_PATH</requirement>
77bbf955e8de initial commit
eric
parents:
diff changeset
83 </requirements>
77bbf955e8de initial commit
eric
parents:
diff changeset
84 <help>
77bbf955e8de initial commit
eric
parents:
diff changeset
85 |
77bbf955e8de initial commit
eric
parents:
diff changeset
86
77bbf955e8de initial commit
eric
parents:
diff changeset
87
77bbf955e8de initial commit
eric
parents:
diff changeset
88 **What it does**
77bbf955e8de initial commit
eric
parents:
diff changeset
89
77bbf955e8de initial commit
eric
parents:
diff changeset
90 Vennerable V3.0 (07-10-2014)
77bbf955e8de initial commit
eric
parents:
diff changeset
91
77bbf955e8de initial commit
eric
parents:
diff changeset
92 This tool will use the Vennerable R package to plot data as weighted or un-weighted diagrams such as Venn, Edwards-Venn and Chow-Rusky.
77bbf955e8de initial commit
eric
parents:
diff changeset
93
77bbf955e8de initial commit
eric
parents:
diff changeset
94 The tool can take from 2 to 9 collumns (in battle mode) of data but more are adviced not to be used (for speed and clarity).
77bbf955e8de initial commit
eric
parents:
diff changeset
95
77bbf955e8de initial commit
eric
parents:
diff changeset
96 Since version Vennerable version 3 it supports up to 9 datasets in battle mode. Wrapper version 1.2 and up support output in svg, pdf and png.
77bbf955e8de initial commit
eric
parents:
diff changeset
97
77bbf955e8de initial commit
eric
parents:
diff changeset
98 -----
77bbf955e8de initial commit
eric
parents:
diff changeset
99
77bbf955e8de initial commit
eric
parents:
diff changeset
100 **Input**
77bbf955e8de initial commit
eric
parents:
diff changeset
101
77bbf955e8de initial commit
eric
parents:
diff changeset
102 It takes a tabular file containing identifiers. Matches will be calculated automatically.
77bbf955e8de initial commit
eric
parents:
diff changeset
103
77bbf955e8de initial commit
eric
parents:
diff changeset
104 Be sure to specify headers if you haven't any in your dataset! Otherwise the top row of data will be excluded.
77bbf955e8de initial commit
eric
parents:
diff changeset
105
77bbf955e8de initial commit
eric
parents:
diff changeset
106 ::
77bbf955e8de initial commit
eric
parents:
diff changeset
107
77bbf955e8de initial commit
eric
parents:
diff changeset
108 DataA DataB DataC DataD
77bbf955e8de initial commit
eric
parents:
diff changeset
109 HUM1 AGK2 AGK2 RTT3
77bbf955e8de initial commit
eric
parents:
diff changeset
110 AGK2 ZZE3 ERT3 ZPD3
77bbf955e8de initial commit
eric
parents:
diff changeset
111 ZPD3 AAW3 RTT3 WER2
77bbf955e8de initial commit
eric
parents:
diff changeset
112 WER2 HUM1 RRW4 DUM1
77bbf955e8de initial commit
eric
parents:
diff changeset
113
77bbf955e8de initial commit
eric
parents:
diff changeset
114 -----
77bbf955e8de initial commit
eric
parents:
diff changeset
115
77bbf955e8de initial commit
eric
parents:
diff changeset
116 **Example**
77bbf955e8de initial commit
eric
parents:
diff changeset
117
77bbf955e8de initial commit
eric
parents:
diff changeset
118 .. image:: ../static/images/WURtools/VennerablePlot.png
77bbf955e8de initial commit
eric
parents:
diff changeset
119
77bbf955e8de initial commit
eric
parents:
diff changeset
120 -----
77bbf955e8de initial commit
eric
parents:
diff changeset
121
77bbf955e8de initial commit
eric
parents:
diff changeset
122 **References**
77bbf955e8de initial commit
eric
parents:
diff changeset
123
77bbf955e8de initial commit
eric
parents:
diff changeset
124 - alex.bossers@wur.nl
77bbf955e8de initial commit
eric
parents:
diff changeset
125 - Vennerable R package: http://r-forge.r-project.org/projects/vennerable/
77bbf955e8de initial commit
eric
parents:
diff changeset
126
77bbf955e8de initial commit
eric
parents:
diff changeset
127 -----
77bbf955e8de initial commit
eric
parents:
diff changeset
128
77bbf955e8de initial commit
eric
parents:
diff changeset
129 .. class:: infomark
77bbf955e8de initial commit
eric
parents:
diff changeset
130
77bbf955e8de initial commit
eric
parents:
diff changeset
131 **TIP:** If your data is not TAB delimited, use *Text Manipulation-&gt;Convert*
77bbf955e8de initial commit
eric
parents:
diff changeset
132
77bbf955e8de initial commit
eric
parents:
diff changeset
133
77bbf955e8de initial commit
eric
parents:
diff changeset
134 </help>
77bbf955e8de initial commit
eric
parents:
diff changeset
135 </tool>