Mercurial > repos > abossers > mummer_toolsuite

comparison MUMmer/mummerplot_tool.xml @ 0:59f302448cf6

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Migrated tool version 1.0.0 from old tool shed archive to new tool shed repository
author abossers
date Tue, 07 Jun 2011 17:22:27 -0400
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:59f302448cf6
1 <tool id="mummerplot_tool" name="MUMmer plot" version="1.0.1" force_history_refresh="true">
2 <description>: Generate MUMmerplots from MUMmer match file</description>
3 <command interpreter="bash">
4 mummerplot_tool.sh
5 #if $img_format=="png"
6 png $input_match $out_png
7 #else
8 postscript $input_match $out_postscript
9 #end if
10 $cmd_extra
11 </command>
12 <inputs>
13 <param name="input_match" type="data" format="tabular" label="MUMmer match (delta or tiling) file" />
14 <param name="img_format" type="select" label="Output format" >
15 <option value="png" selected="true">PNG image</option>
16 <option value="postscript">Postscript</option>
17 </param>
18 <param name="cmd_extra" type="text" size="40" value="" label="Extra cmd line options" help="See cmd line options below" />
19 </inputs>
20 <outputs>
21 <data name="out_png" format="png" label="MUMmerplot png">
22 <filter>img_format=="png"</filter>
23 </data>
24 <data name="out_postscript" format="ps" label="MUMmerplot ps">
25 <filter>img_format=="postscript"</filter>
26 </data>
27 </outputs>
28 <requirements>
29 <requirement type="binary">mummerplot</requirement>
30 </requirements>
31 <tests>
32 <test>
33 </test>
34 </tests>
35 <help>
36 |
37
38
39 **Reference**
40 =============
41
42 - **MUMmerplot Galaxy tool wrapper: Alex Bossers, CVI of Wageningen UR, The Netherlands**
43
44 - **MUMmerplot running on MUMmer-match file:** http://mummer.sourceforge.net/manual#mummerplot
45
46 - **MUMmer tutorials:** http://mummer.sourceforge.net/examples/
47
48 If you found these tools/wrappers usefull in your research, please acknowledge our work. If you improve
49 or modify the wrappers please add instead of substitute yourself into the acknowlegement section :)
50
51
52 **MUMmerplot**
53 ==============
54
55 | This plotting tool requires a MUMmer match file (either the delta file or the tiling result file)!
56 | MUMmerplot requires gnuplot (www.gnuplot.info) to be installed.
57 |
58 | **The plotting has by default set the arguments --large and --png/--postscript to generate a fixed image instead of an interactive view!** Optional cmd line arguments can be used.
59 |
60
61
62
63 Mummerplot is a script utility that takes output from *MUMmer, nucmer or promer* as DELTA file, or the
64 *show-tiling* result file, and converts it to a format suitable for plotting with gnuplot. The primary
65 plot type is an alignment dotplot where a sequence is laid out on each axis and a point is plotted at
66 every position where the two sequences show similarity. As an extension to this plot style, mummerplot
67 is also able to offset multiple 1-vs-1 dotplots to form a multiplot where multiple sequences can be
68 laid out on each axis. This plot style is especially handy for browsing an alignment of two contig
69 sets. Identity plots are also possible by coloring each data point with a color gradient representing
70 identity, or by collapsing the y-axis data onto a single line and then vertically offsetting the
71 data points by their identities. In addition to producing the plot data, mummerplot also generates a
72 gnuplot script that will be evaluated in order to generate the graph.
73
74
75 The *match file* can either be a three column match list from mummer (either 3 or 4 column format),
76 the delta file from nucmer or promer, or the default output from show-tiling. mummerplot will
77 automatically detect the type of input file it is given, regardless of its file extension, or it
78 will fail if the input file is of an unrecognized type.
79
80
81
82 Optional command line arguments
83 -------------------------------
84
85 --breaklen Highlight alignments with a breakpoint further than the given distance from the nearest sequence end
86 --nocolor Color plot lines with a percent similarity gradient or turn off all color (default color by match direction)
87 --coverage Generate a reference coverage plot, also known as a percent identity plot (default behavior for show-tiling input)
88 --depend Print dependency information and exit
89 --filter Only display alignments which represent the "best" one-to-one mapping of reference and query subsequences (requires delta formatted input)
90 --help Print help information and exit
91 --layout Layout a multiplot by ordering and orienting sequences such that the largest hits cluster near the main diagonal (requires delta formatted input)
92 --prefix *do not use in galaxy!* Set the output file prefix (default 'out')
93 --rv Reverse video, swap the foreground and background colors for x11 plots (requires x11 terminal)
94 --IdR Select a specific reference sequence for the x-axis
95 --IdQ Select a specific query sequence for the y-axis
96 --Rfile Generate a multiplot by using the order and length information contained in this file, either a FastA file of the desired reference sequences or a tab-delimited list of sequence IDs, lengths and orientations [ +-]
97 --Qfile Generate a multiplot by using the order and length information contained in this file, either a FastA file of the desired query sequences or a tab-delimited list of sequence IDs, lengths and orientations [ +-]
98 --size Set the output size to small, medium or large
99 --large **default enabled to generate highres image**. Other sizes no effect: --small --medium --large
100 --SNP Highlight SNP locations in the alignment
101 --terminal *do not use in galaxy* Set the output terminal to x11, postscript or png
102 --png **either png or postscript for fixed image**. Other interactive x11 not enabled
103 --postscript Alternate output format instead of png.
104 --xrange Set the x-range for the plot in the form "[min,max]"
105 --yrange Set the y-range for the plot in the form "[min,max]"
106 --version Display version information and exit
107
108
109 </help>
110 </tool>
111