annotate crossmap_region.xml @ 0:8635b6b8a8f2 draft

"planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
author iuc
date Thu, 15 Jul 2021 16:19:33 +0000
parents
children eb66d7a04bf8
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}'
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
13 --ratio $ratio
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
14 '$output'
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
15 ]]></command>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
16 <inputs>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
17 <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
18 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
19 <expand macro="chain" />
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
20 <param argument="--ratio" type="float" min="0" max="1" value="0.85" label="Minimum ratio of bases that must remap."/>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
21 </inputs>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
22 <outputs>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
23 <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
24 </outputs>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
25 <tests>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
26 <test>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
27 <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
28 <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
29 <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
30 <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
31 </test>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
32 </tests>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
33 <help><![CDATA[
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
34 @HELP_GENERAL@
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
35
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
36 CrossMap region
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
37 ---------------
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
38
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
39 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
40
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
41 BED
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
42 ---
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 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
45 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
46
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
47 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
48 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
49 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
50 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
51 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
52 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
53 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
54 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
55 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
56 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
57 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
58 line is skipped.
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
59
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
60 Notes:
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
61
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
62 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
63 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
64 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
65 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
66 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
67 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
68 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
69 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
70 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
71 skipped.
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
72 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
73 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
74 ]]></help>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
75
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
76 <citations>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
77 <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
78 </citations>
8635b6b8a8f2 "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/crossmap commit f436317e2f8d451621e297cfc474e43c20d60bb7"
iuc
parents:
diff changeset
79 </tool>