annotate crossmap_region.xml @ 1:08209a7c4cb7 draft

"planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit e10d34b547557b2bd4f0be69e31204bd5703e422"
author iuc
date Thu, 20 Jan 2022 04:26:07 +0000
parents 067f3a52abd6
children 436fb49ce7ec
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
1 <tool id="crossmap_region" name="CrossMap region" version="@TOOL_VERSION@+galaxy@VERSION_SUFFIX@" profile="20.05">
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
2 <description>Convert genome coordinates or annotation files between genome assemblies</description>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
3 <macros>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
4 <import>macros.xml</import>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
5 </macros>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
6 <expand macro="requirements"/>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
7 <expand macro="stdio"/>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
8 <expand macro="version_command"/>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
9 <command><![CDATA[
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
10 CrossMap.py region
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
11 '${chain_source.input_chain}'
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
12 '${input}'
1
08209a7c4cb7 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit e10d34b547557b2bd4f0be69e31204bd5703e422"
iuc
parents: 0
diff changeset
13 $output
08209a7c4cb7 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit e10d34b547557b2bd4f0be69e31204bd5703e422"
iuc
parents: 0
diff changeset
14 --chromid $chromid
0
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
15 --ratio $ratio
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
16 ]]></command>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
17 <inputs>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
18 <param name="input" type="data" format="bed" label="BED file"
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
19 help="BED format file must have at least 3 columns (chrom, start, end) and no more than 12 columns"/>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
20 <expand macro="chain" />
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
21 <param argument="--ratio" type="float" min="0" max="1" value="0.85" label="Minimum ratio of bases that must remap."/>
1
08209a7c4cb7 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit e10d34b547557b2bd4f0be69e31204bd5703e422"
iuc
parents: 0
diff changeset
22 <param argument="--chromid" type="select" label="Chromid" help="The style of chromosome IDs">
08209a7c4cb7 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit e10d34b547557b2bd4f0be69e31204bd5703e422"
iuc
parents: 0
diff changeset
23 <option value="a" selected="true">Default (a)</option>
08209a7c4cb7 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit e10d34b547557b2bd4f0be69e31204bd5703e422"
iuc
parents: 0
diff changeset
24 <option value="s">Short style (s)</option>
08209a7c4cb7 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit e10d34b547557b2bd4f0be69e31204bd5703e422"
iuc
parents: 0
diff changeset
25 <option value="l">Long stype (l)</option>
08209a7c4cb7 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit e10d34b547557b2bd4f0be69e31204bd5703e422"
iuc
parents: 0
diff changeset
26 </param>
0
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
27 </inputs>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
28 <outputs>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
29 <data name="output" format="bed"/>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
30 </outputs>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
31 <tests>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
32 <test>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
33 <param name="input" value="test_bed_01_input_a.bed" ftype="bed"/>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
34 <param name="index_source" value="history"/>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
35 <param name="input_chain" value="aToB.over.chain" ftype="csv"/>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
36 <output name="output" file="test_region.bed"/>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
37 </test>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
38 </tests>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
39 <help><![CDATA[
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
40 @HELP_GENERAL@
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
41
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
42 CrossMap region
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
43 ---------------
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
44
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
45 Unlike the "CrossMap bed" function which splits big genomic regions, "CrossMap region" tries to convert the big genomic region as a whole.
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
46
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
47 BED
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
48 ---
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
49
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
50 BED format file must have at least 3 columns (chrom, start, end) and no more than 12 columns.
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
51 BED format: http://genome.ucsc.edu/FAQ/FAQformat.html#format1
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
52
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
53 A BED (Browser Extensible Data) file is a tab-delimited text file
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
54 describing genome regions or gene annotations. It is the standard file
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
55 format used by UCSC. It consists of one line per feature, each containing
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
56 3-12 columns. CrossMap converts BED files with less than 12 columns to a
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
57 different assembly by updating the chromosome and genome coordinates only;
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
58 all other columns remain unchanged. Regions from old assembly mapping to
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
59 multiple locations to the new assembly will be split. For 12-columns BED
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
60 files, all columns will be updated accordingly except the 4th column (name
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
61 of bed line), 5th column (score value) and 9th column (RGB value describing
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
62 the display color). 12-column BED files usually define multiple blocks (eg.
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
63 exon); if any of the exons fails to map to a new assembly, the whole BED
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
64 line is skipped.
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
65
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
66 Notes:
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
67
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
68 1. For BED-like formats mentioned above, CrossMap only updates “chrom (1st
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
69 column)”, “start (2nd column) ”, “end (3rd column) ” and “strand” (if
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
70 any). All other columns will keep AS-IS.
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
71 2. Lines starting with ‘#’, ‘browser’, ‘track’ will be skipped.
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
72 3. Lines will less than 3 columns will be skipped.
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
73 4. 2nd-column and 3-column must be integer, otherwise skipped.
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
74 5. “+” strand is assumed if no strand information was found.
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
75 6. For standard BED format (12 columns). If any of the defined exon blocks
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
76 cannot be uniquely mapped to target assembly, the whole entry will be
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
77 skipped.
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
78 7. If input region cannot be consecutively mapped target assembly, it will be split.
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
79 8. \*.unmap file contains regions that cannot be unambiguously converted.
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
80 ]]></help>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
81
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
82 <citations>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
83 <citation type="doi">10.1093/bioinformatics/btt730</citation>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
84 </citations>
067f3a52abd6 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
85 </tool>