|
0
|
1 <tool id="unixtools_multijoin'_tool" name="Multi-Join" version="0.1.1">
|
|
|
2 <description>(combine multiple files)</description>
|
|
|
3 <command interpreter="perl">multijoin
|
|
|
4 --key '$key_column'
|
|
|
5 --values '$value_columns'
|
|
|
6 --filler '$filler'
|
|
|
7 $ignore_dups
|
|
|
8 $output_header
|
|
|
9 $input_header
|
|
2
|
10 $first_filename
|
|
0
|
11 #for $file in $files
|
|
|
12 '$file.filename'
|
|
|
13 #end for
|
|
|
14 > '$output'
|
|
|
15 </command>
|
|
|
16
|
|
|
17 <inputs>
|
|
2
|
18
|
|
|
19 <param name="first_filename" label="File to join" type="data" format="txt" />
|
|
|
20 <repeat name="files" title="with" min="2">
|
|
|
21 <param name="filename" label="add additional file" type="data" format="txt" />
|
|
0
|
22 </repeat>
|
|
|
23
|
|
|
24 <param name="key_column" label="Common key column" type="integer"
|
|
|
25 value="1" help="Usually gene-ID or other common value" />
|
|
|
26
|
|
2
|
27 <param name="value_columns" label="Column with values to preserve"
|
|
|
28 type="data_column" data_ref="first_filename" accept_default="true" multiple="True" display="checkboxes"/>
|
|
0
|
29
|
|
|
30 <param name="output_header" type="boolean" checked="false" truevalue="--out-header" falsevalue="" label="Add header line to the output file" help="" />
|
|
|
31 <param name="input_header" type="boolean" checked="false" truevalue="--in-header" falsevalue="" label="Input files contain a header line (as first line)" help="" />
|
|
|
32 <param name="ignore_dups" type="boolean" checked="false" truevalue="--ignore-dups" falsevalue="" label="Ignore duplicated keys" help="If not set, duplicated keys in the same file will cause an error." />
|
|
|
33 <param name="filler" type="text" size="20" value="0" label="Value to put in unpaired (empty) fields">
|
|
|
34 <sanitizer>
|
|
|
35 <valid initial="string.printable">
|
|
|
36 <remove value="'"/>
|
|
|
37 </valid>
|
|
|
38 </sanitizer>
|
|
|
39 </param>
|
|
|
40
|
|
|
41 </inputs>
|
|
|
42 <outputs>
|
|
1
|
43 <data name="output" format="input" metadata_source="input" />
|
|
0
|
44 </outputs>
|
|
|
45
|
|
|
46 <help>
|
|
|
47 **What it does**
|
|
|
48
|
|
|
49 This tool joins multiple tabular files based on a common key column.
|
|
|
50
|
|
|
51 -----
|
|
|
52
|
|
|
53 **Example**
|
|
|
54
|
|
|
55 To join three files, based on the 4th column, and keeping the 7th,8th,9th columns:
|
|
|
56
|
|
|
57 **First file (AAA)**::
|
|
|
58
|
|
|
59 chr4 888449 890171 FBtr0308778 0 + 266 1527 1722
|
|
|
60 chr4 972167 979017 FBtr0310651 0 - 3944 6428 6850
|
|
|
61 chr4 972186 979017 FBtr0089229 0 - 3944 6428 6831
|
|
|
62 chr4 972186 979017 FBtr0089231 0 - 3944 6428 6831
|
|
|
63 chr4 972186 979017 FBtr0089233 0 - 3944 6428 6831
|
|
|
64 chr4 995793 996435 FBtr0111046 0 + 7 166 642
|
|
|
65 chr4 995793 997931 FBtr0111044 0 + 28 683 2138
|
|
|
66 chr4 995793 997931 FBtr0111045 0 + 28 683 2138
|
|
|
67 chr4 1034029 1047719 FBtr0089223 0 - 5293 13394 13690
|
|
|
68 ...
|
|
|
69
|
|
|
70
|
|
|
71 **Second File (BBB)**::
|
|
|
72
|
|
|
73 chr4 90286 134453 FBtr0309803 0 + 657 29084 44167
|
|
|
74 chr4 251355 266499 FBtr0089116 0 + 56 1296 15144
|
|
|
75 chr4 252050 266506 FBtr0308086 0 + 56 1296 14456
|
|
|
76 chr4 252050 266506 FBtr0308087 0 + 56 1296 14456
|
|
|
77 chr4 252053 266528 FBtr0300796 0 + 56 1296 14475
|
|
|
78 chr4 252053 266528 FBtr0300800 0 + 56 1296 14475
|
|
|
79 chr4 252055 266528 FBtr0300798 0 + 56 1296 14473
|
|
|
80 chr4 252055 266528 FBtr0300799 0 + 56 1296 14473
|
|
|
81 chr4 252541 266528 FBtr0300797 0 + 56 1296 13987
|
|
|
82 ...
|
|
|
83
|
|
|
84 **Third file (CCC)**::
|
|
|
85
|
|
|
86 chr4 972167 979017 FBtr0310651 0 - 9927 6738 6850
|
|
|
87 chr4 972186 979017 FBtr0089229 0 - 9927 6738 6831
|
|
|
88 chr4 972186 979017 FBtr0089231 0 - 9927 6738 6831
|
|
|
89 chr4 972186 979017 FBtr0089233 0 - 9927 6738 6831
|
|
|
90 chr4 995793 996435 FBtr0111046 0 + 5 304 642
|
|
|
91 chr4 995793 997931 FBtr0111044 0 + 17 714 2138
|
|
|
92 chr4 995793 997931 FBtr0111045 0 + 17 714 2138
|
|
|
93 chr4 1034029 1047719 FBtr0089223 0 - 17646 13536 13690
|
|
|
94 ...
|
|
|
95
|
|
|
96
|
|
|
97 **Joining** the files, using **key column 4**, **value columns 7,8,9** and a **header line**, will return::
|
|
|
98
|
|
|
99 key AAA__V7 AAA__V8 AAA__V9 BBB__V7 BBB__V8 BBB__V9 CCC__V7 CCC__V8 CCC__V9
|
|
|
100 FBtr0089116 0 0 0 56 1296 15144 0 0 0
|
|
|
101 FBtr0089223 5293 13394 13690 0 0 0 17646 13536 13690
|
|
|
102 FBtr0089229 3944 6428 6831 0 0 0 9927 6738 6831
|
|
|
103 FBtr0089231 3944 6428 6831 0 0 0 9927 6738 6831
|
|
|
104 FBtr0089233 3944 6428 6831 0 0 0 9927 6738 6831
|
|
|
105 FBtr0111044 28 683 2138 0 0 0 17 714 2138
|
|
|
106 FBtr0111045 28 683 2138 0 0 0 17 714 2138
|
|
|
107 FBtr0111046 7 166 642 0 0 0 5 304 642
|
|
|
108 FBtr0300796 0 0 0 56 1296 14475 0 0 0
|
|
|
109 ...
|
|
|
110
|
|
|
111
|
|
|
112 # Input files need not be sorted.
|
|
|
113
|
|
|
114 -----
|
|
|
115
|
|
|
116 *multijoin* was written by A. Gordon (gordon at cshl dot edu)
|
|
|
117
|
|
|
118 </help>
|
|
|
119 </tool>
|
