Mercurial > repos > iuc > usher_ripples

comparison ripples.xml @ 0:359daa4b6d10 draft default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/usher commit d44fdcd836306a2096d50bebb28d8faacdb0fbfd
author iuc
date Mon, 02 Feb 2026 14:38:06 +0000
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:359daa4b6d10
1 <tool id='usher_ripples' name='UShER RIPPLES' version='@TOOL_VERSION@+galaxy@VERSION_SUFFIX@' profile='@PROFILE@'>
2 <description>detect recombination events in large mutation annotated tree (MAT) files.</description>
3 <macros>
4 <import>macros.xml</import>
5 </macros>
6 <expand macro="xrefs"/>
7 <expand macro='requirements' />
8 <expand macro="version"/>
9 <command detect_errors='exit_code'><![CDATA[
10 ## get correct extension filenames
11 ln -sf '$input_mat' '$input_mat.element_identifier' &&
12
13 ripples
14 --input-mat '$input_mat.element_identifier'
15
16 --branch-length $branch_length
17 --min-coordinate-range $min_coordinate_range
18 --max-coordinate-range $max_coordinate_range
19 --samples-filename '$samples_filename'
20 --parsimony-improvement $parsimony_improvement
21 --num-descendants $num_descendants
22
23 --outdir ./
24 --threads \${GALAXY_SLOTS:-1} > output_stdout.txt
25
26 ]]> </command>
27 <inputs>
28 <param argument="--input-mat" type="data" format="protobuf3" label="Mutation-annotated tree object" help="Load a mutation annotated tree file, in protocol-buffers format (protobuf3)."/>
29 <param argument="--branch-length" type="integer" value="3" min="0" label="Minimum branch length" help="Minimum length of the branch to consider for recombination events. Default = 3." />
30 <param argument="--min-coordinate-range" type="integer" value="1000" min="0" label="Minimal coordinate range" help="Minimum range of the genomic coordinates of the mutations on the recombinant branch. Default = 1,000." />
31 <param argument="--max-coordinate-range" type="integer" value="10000000" min="0" label="Maximal coordinate range" help="Maximum range of the genomic coordinates of the mutations on the recombinant branch. Default = 10,000,000." />
32 <param argument="--samples-filename" type="data" format="txt" label="Sample restriction file" help="Restrict the search to the ancestors of the samples specified in the input file." />
33 <param argument="--parsimony-improvement" type="integer" value="3" min="0" label="Parsimony improvement" help="Minimum improvement in parsimony score of the recombinant sequences during the partial placement. Default = 3." />
34 <param argument="--num-descendants" type="integer" value="10" label="Number of descendants" help="Minimum number of leaves that node should have to be considered for recombinatino. Default = 10." />
35 </inputs>
36 <outputs>
37 <data name="recombination" format="tabular" from_work_dir='recombination.tsv' label="${tool.name} on ${on_string}: recombinations" >
38 <actions>
39 <action name="column_names" type="metadata" default="recomb_node_id,breakpoint-1_interval,breakpoint-2_interval,donor_node_id,donor_is_sibling,donor_parsimony,acceptor_node_id,acceptor_is_sibling,acceptor_parsimony,original_parsimony,min_starting_parsimony,recomb_parsimony" />
40 </actions>
41 </data>
42 <data name="descendants" format="tabular" from_work_dir='descendants.tsv' label="${tool.name} on ${on_string}: descendants" >
43 <actions>
44 <action name="column_names" type="metadata" default="node_id,descendants" />
45 </actions>
46 </data>
47
48 </outputs>
49 <tests>
50 <test expect_num_outputs="2">
51 <param name="input_mat" value="mutation_annotation.pb" ftype="protobuf3"/>
52 <param name="samples_filename" value="sample_names.txt" ftype="txt"/>
53 <output name="descendants" file="test_26_descendants.tabular" ftype="tabular"/>
54 <output name="recombination" file="test_26_recombination.tabular" ftype="tabular"/>
55 </test>
56 <test expect_num_outputs="2">
57 <param name="input_mat" value="mutation_annotation.pb" ftype="protobuf3"/>
58 <param name="samples_filename" value="sample_names.txt" ftype="txt"/>
59 <param name="num_descendants" value="20" />
60 <param name="parsimony_improvement" value="5" />
61 <param name="branch_length" value="2" />
62 <output name="descendants" file="test_27_descendants.tabular" ftype="tabular"/>
63 <output name="recombination" file="test_27_recombination.tabular" ftype="tabular"/>
64 </test>
65 </tests>
66 <help><![CDATA[
67
68 .. class:: infomark
69
70 **Purpose**
71
72 RIPPLES (Recombination Inference using Phylogenetic PLacEmentS) is a program used to detect recombination events in large mutation annotated tree (MAT) files.
73
74 ----
75
76 RIPPLES is a program to rapidly and sensitively detect recombinant nodes and their ancestors in a mutation-annotated tree (MAT). RIPPLES exploits the fact that recombinant lineages arising from diverse genomes will often be found on “long branches” which result from accommodating the divergent evolutionary histories of the two parental haplotypes. Therefore, RIPPLES first identifies long branches in a MAT. RIPPLES then exhaustively breaks the potential recombinant sequence into distinct segments that are differentiated by mutations on the recombinant sequence and separated by up to two breakpoints. For each set of breakpoints, RIPPLES places each of its corresponding segments using maximum parsimony to find the two parental nodes – a donor and an acceptor – that result in the highest parsimony score improvement relative to the original placement on the global phylogeny. The nodes for which a set of breakpoints along with two parental nodes can be identified that provide a parsimony score improvement above a user-specified threshold are reported as recombinants.
77
78 .. class:: infomark
79
80 **RIPPLES Common Options**
81
82 - input-mat: Input mutation-annotated tree file [REQUIRED]. If only this argument is set, print the count of samples and nodes in the tree.
83 - branch-length (-l): Minimum length of the branch to consider for recombination events. Default = 3.
84 - min-coordinate-range (-r): Minimum range of the genomic coordinates of the mutations on the recombinant branch. Default = 1,000.
85 - max-coordinate-range (-R): Maximum range of the genomic coordinates of the mutations on the recombinant branch. Default = 10,000,000.
86 - samples-filename (-s): Restrict the search to the ancestors of the samples specified in the input file.
87 - parsimony-improvement (-p): Minimum improvement in parsimony score of the recombinant sequences during the partial placement. Default = 3.
88 - num-descendants (-n): Minimum number of leaves that node should have to be considered for recombinatino. Default = 10.
89
90 You can find more information in the `RIPPLES official documentation page <https://usher-wiki.readthedocs.io/en/latest/ripples.html>`_.
91
92 ]]> </help>
93 <expand macro="citations" />
94 </tool>