annotate crossmap_region.xml @ 1:eb66d7a04bf8 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:31:00 +0000
parents 8635b6b8a8f2
children a50ef4d58c90
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
8635b6b8a8f2 "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">
8635b6b8a8f2 "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>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
3 <macros>
8635b6b8a8f2 "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>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
5 </macros>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
6 <expand macro="requirements"/>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
7 <expand macro="stdio"/>
8635b6b8a8f2 "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"/>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
9 <command><![CDATA[
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
10 CrossMap.py region
8635b6b8a8f2 "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}'
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
12 '${input}'
1
eb66d7a04bf8 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit e10d34b547557b2bd4f0be69e31204bd5703e422"
iuc
parents: 0
diff changeset
13 $output
eb66d7a04bf8 "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
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
15 --ratio $ratio
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
16 ]]></command>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
17 <inputs>
8635b6b8a8f2 "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"
8635b6b8a8f2 "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"/>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
20 <expand macro="chain" />
8635b6b8a8f2 "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
eb66d7a04bf8 "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">
eb66d7a04bf8 "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>
eb66d7a04bf8 "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>
eb66d7a04bf8 "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>
eb66d7a04bf8 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit e10d34b547557b2bd4f0be69e31204bd5703e422"
iuc
parents: 0
diff changeset
26 </param>
0
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
27 </inputs>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
28 <outputs>
8635b6b8a8f2 "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"/>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
30 </outputs>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
31 <tests>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
32 <test>
8635b6b8a8f2 "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"/>
8635b6b8a8f2 "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"/>
8635b6b8a8f2 "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"/>
8635b6b8a8f2 "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"/>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
37 </test>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
38 </tests>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
39 <help><![CDATA[
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
40 @HELP_GENERAL@
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
41
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
42 CrossMap region
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
43 ---------------
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
44
8635b6b8a8f2 "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.
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
46
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
47 BED
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
48 ---
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
49
8635b6b8a8f2 "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.
8635b6b8a8f2 "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
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
52
8635b6b8a8f2 "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
8635b6b8a8f2 "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
8635b6b8a8f2 "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
8635b6b8a8f2 "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
8635b6b8a8f2 "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;
8635b6b8a8f2 "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
8635b6b8a8f2 "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
8635b6b8a8f2 "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
8635b6b8a8f2 "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
8635b6b8a8f2 "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.
8635b6b8a8f2 "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
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
64 line is skipped.
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
65
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
66 Notes:
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
67
8635b6b8a8f2 "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
8635b6b8a8f2 "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
8635b6b8a8f2 "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.
8635b6b8a8f2 "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.
8635b6b8a8f2 "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.
8635b6b8a8f2 "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.
8635b6b8a8f2 "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.
8635b6b8a8f2 "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
8635b6b8a8f2 "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
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
77 skipped.
8635b6b8a8f2 "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.
8635b6b8a8f2 "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.
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
80 ]]></help>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
81
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
82 <citations>
8635b6b8a8f2 "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>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
84 </citations>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
85 </tool>