annotate easyjoin.xml @ 27:08cdbfffce67 draft

planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit 2dc2df988bd2dde9f8d7f629b594186dbd4fdc2b
author bgruening
date Fri, 07 Mar 2025 20:43:41 +0000
parents f22a309187a3
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
26
f22a309187a3 planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit c2b1677d1c94433f777c2dc28ac8eec0a99cc6a7
bgruening
parents: 21
diff changeset
1 <tool id="tp_easyjoin_tool" name="Join" version="@TOOL_VERSION@+galaxy@VERSION_SUFFIX@" profile="@PROFILE@">
0
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
2 <description>two files</description>
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
3 <macros>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
4 <import>macros.xml</import>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
5 </macros>
26
f22a309187a3 planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit c2b1677d1c94433f777c2dc28ac8eec0a99cc6a7
bgruening
parents: 21
diff changeset
6 <expand macro="creator"/>
13
3c685c4106b3 planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit b9d202134c3c6d0e5c398c3ae75e410067fcfc52
bgruening
parents: 10
diff changeset
7 <expand macro="requirements">
26
f22a309187a3 planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit c2b1677d1c94433f777c2dc28ac8eec0a99cc6a7
bgruening
parents: 21
diff changeset
8 <requirement type="package" version="5.32">perl</requirement>
13
3c685c4106b3 planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit b9d202134c3c6d0e5c398c3ae75e410067fcfc52
bgruening
parents: 10
diff changeset
9 </expand>
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
10 <version_command>join --version | head -n 1</version_command>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
11 <command>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
12 <![CDATA[
26
f22a309187a3 planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit c2b1677d1c94433f777c2dc28ac8eec0a99cc6a7
bgruening
parents: 21
diff changeset
13 cp '$__tool_directory__/sort-header' ./ &&
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
14 chmod +x sort-header &&
26
f22a309187a3 planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit c2b1677d1c94433f777c2dc28ac8eec0a99cc6a7
bgruening
parents: 21
diff changeset
15 perl '$__tool_directory__/easyjoin'
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
16 $jointype
21
0e3b611245f7 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit 9c4d4fe09cbbd818532d793d01d1cb16edbd496b-dirty"
bgruening
parents: 15
diff changeset
17 -t $'\t'
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
18 $header
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
19 -e '$empty_string_filler'
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
20 -o auto
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
21 $ignore_case
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
22 -1 '$column1'
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
23 -2 '$column2'
26
f22a309187a3 planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit c2b1677d1c94433f777c2dc28ac8eec0a99cc6a7
bgruening
parents: 21
diff changeset
24 '$infile1'
f22a309187a3 planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit c2b1677d1c94433f777c2dc28ac8eec0a99cc6a7
bgruening
parents: 21
diff changeset
25 '$infile2'
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
26 > '$output'
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
27 ]]>
0
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
28 </command>
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
29 <inputs>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
30 <param name="infile1" format="tabular" type="data" label="1st file" />
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
31 <param name="column1" label="Column to use from 1st file" type="data_column" data_ref="infile1" accept_default="true" />
0
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
32
21
0e3b611245f7 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit 9c4d4fe09cbbd818532d793d01d1cb16edbd496b-dirty"
bgruening
parents: 15
diff changeset
33 <param name="infile2" format="tabular" type="data" label="2nd File" />
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
34 <param name="column2" label="Column to use from 2nd file" type="data_column" data_ref="infile2" accept_default="true" />
0
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
35
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
36 <param name="jointype" type="select" label="Output lines appearing in">
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
37 <option value=" " selected="True">Both 1st &amp; 2nd file.</option>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
38 <option value="-v 1">1st but not in 2nd file. (-v 1)</option>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
39 <option value="-v 2">2nd but not in 1st file. (-v 2)</option>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
40 <option value="-a 1">Both 1st &amp; 2nd file, plus unpairable lines from 1st file. (-a 1)</option>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
41 <option value="-a 2">Both 1st &amp; 2nd file, plus unpairable lines from 2st file. (-a 2)</option>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
42 <option value="-a 1 -a 2">All lines [-a 1 -a 2]</option>
0
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
43 <option value="-v 1 -v 2">All unpairable lines [-v 1 -v 2]</option>
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
44 </param>
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
45
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
46 <param name="header" type="boolean" checked="false" truevalue="--header" falsevalue=""
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
47 label="First line is a header line" help="Use if first line contains column headers. It will not be sorted." />
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
48 <param name="ignore_case" type="boolean" checked="false" truevalue="-i" falsevalue=""
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
49 label="Ignore case" help="Sort and Join key column values regardless of upper/lower case letters." />
10
c78b1767db2b planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit 10052765d6b712cf7d38356af4251fcc38a339b6-dirty
bgruening
parents: 8
diff changeset
50 <param name="empty_string_filler" type="text" value="0" label="Value to put in unpaired (empty) fields">
0
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
51 <sanitizer>
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
52 <valid initial="string.printable">
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
53 <remove value="&apos;"/>
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
54 </valid>
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
55 </sanitizer>
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
56 </param>
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
57 </inputs>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
58 <outputs>
6
8928e6d1e7ba Uploaded
bgruening
parents: 4
diff changeset
59 <data name="output" format_source="infile1" metadata_source="infile1"/>
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
60 </outputs>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
61 <tests>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
62 <test>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
63 <param name="infile1" value="easyjoin1.tabular" />
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
64 <param name="column1" value="1" />
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
65 <param name="infile2" value="easyjoin2.tabular" />
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
66 <param name="column2" value="1" />
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
67 <param name="header" value="True" />
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
68 <param name="jointype" value="-a 1 -a 2" />
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
69 <output name="output" file="easyjoin_result1.tabular" />
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
70 </test>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
71 </tests>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
72 <help>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
73 <![CDATA[
0
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
74 **What it does**
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
75
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
76 This tool joins two tabular files based on a common key column.
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
77
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
78 -----
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
79
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
80 **Example**
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
81
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
82 **First file**::
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
83
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
84 Fruit Color
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
85 Apple red
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
86 Banana yellow
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
87 Orange orange
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
88 Melon green
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
89
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
90 **Second File**::
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
91
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
92 Fruit Price
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
93 Orange 7
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
94 Avocado 8
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
95 Apple 4
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
96 Banana 3
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
97
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
98 **Joining** both files, using **key column 1** and a **header line**, will return::
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
99
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
100 Fruit Color Price
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
101 Apple red 4
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
102 Avocado . 8
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
103 Banana yellow 3
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
104 Melon green .
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
105 Orange orange 7
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
106
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
107 .. class:: infomark
0
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
108
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
109 * Input files need not be sorted.
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
110 * The header line (**Fruit Color Price**) was joined and kept as first line.
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
111 * Missing values ( Avocado's color, missing from the first file ) are replaced with a period character.
0
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
112
4
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
113 ]]>
56e80527c482 Uploaded
bgruening
parents: 3
diff changeset
114 </help>
14
7725ab6dab67 planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/text_processing/text_processing commit b'e6ee273f75fff61d1e419283fa8088528cf59470\n'
bgruening
parents: 13
diff changeset
115 <expand macro="citations" />
0
ec66f9d90ef0 initial uploaded
bgruening
parents:
diff changeset
116 </tool>