changeset 0:c4611129661b draft

planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/datamash commit 8a7a779896ce1b9b296557a2c31bd93f5fbb5462
author iuc
date Wed, 28 Oct 2015 12:46:01 -0400
parents
children 2f3c6f2dcf39
files datamash-ops.xml macros.xml test-data/datamash_reverse_input.txt test-data/datamash_reverse_output.txt test-data/datamash_transpose_input.txt test-data/datamash_transpose_output.txt test-data/group_compute_input.txt test-data/group_compute_output.txt tool_dependencies.xml
diffstat 9 files changed, 299 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/datamash-ops.xml	Wed Oct 28 12:46:01 2015 -0400
@@ -0,0 +1,147 @@
+<?xml version="1.0"?>
+<tool id="datamash_ops" name="Datamash" version="1.0.6">
+    <description>(operations on tabular data)</description>
+    <macros>
+        <import>macros.xml</import>
+    </macros>
+    <expand macro="requirements" />
+    <expand macro="stdio" />
+    <command>
+        <![CDATA[
+            datamash
+                $header_in
+                $header_out
+                $need_sort
+                $print_full_line
+                $ignore_case
+                #if str($grouping).strip()
+                --group '$grouping'
+                #end if
+                #for $oper in $operations
+                    ${oper.op_name}
+                    ${oper.op_column}
+                #end for
+                < $in_file > $out_file
+          ]]>
+    </command>
+    <expand macro="inputs_outputs">
+        <param help="Example: to group by the first and fourth fields, use 1,4." label="Group by fields" name="grouping" type="text">
+            <validator message="Invalid value in field. Allowed values are 0-9, space, comma." type="regex">^[0-9, ]*$</validator>
+        </param>
+        <param falsevalue="" help="--header-in" label="Input file has a header line" name="header_in" truevalue="--header-in" type="boolean" />
+        <param falsevalue="" help="--header-out" label="Print header line" name="header_out" truevalue="--header-out" type="boolean" />
+        <param falsevalue="" help="--sort" label="Sort input" name="need_sort" truevalue="--sort" type="boolean" />
+        <param falsevalue="" help="--full" label="Print all fields from input file" name="print_full_line" truevalue="--full" type="boolean" />
+        <param falsevalue="" help="--ignore-case" label="Ignore case when grouping" name="ignore_case" truevalue="--ignore-case" type="boolean" />
+        <repeat default="1" min="1" name="operations" title="Operation to perform on each group">
+            <param label="Type" name="op_name" type="select">
+                <option value="count">count</option>
+                <option value="sum">sum</option>
+                <option value="min">minimum</option>
+                <option value="max">maximum</option>
+                <option value="absmin">Absolute minimum</option>
+                <option value="absmax">Absolute maximum</option>
+                <option value="mean">Mean</option>
+                <option value="pstdev">Population Standard deviantion</option>
+                <option value="sstdev">Sample Standard deviantion</option>
+                <option value="median">Median</option>
+                <option value="q1">1st quartile</option>
+                <option value="q3">3rd quartile</option>
+                <option value="iqr">Inter-quartile range</option>
+                <option value="mad">Median Absolute Deviation</option>
+                <option value="pvar">Variance (population)</option>
+                <option value="svar">Variance (sample)</option>
+                <option value="sskew">Skewness (sample)</option>
+                <option value="pskew">Skewness (population)</option>
+                <option value="skurt">Kurtosis (sample)</option>
+                <option value="pkurt">Kurtosis (population)</option>
+                <option value="jarque">Jarque-Bera Normality test</option>
+                <option value="dpo">DAgostino-Pearson Omnibus Normality Test</option>
+                <option value="mode">Mode</option>
+                <option value="antimode">Anti-Mode</option>
+                <option value="unique">Combine all unique values</option>
+                <option value="collapse">Combine all values</option>
+                <option value="countunique">Count Unique values</option>
+            </param>
+            <param data_ref="in_file" label="On column" name="op_column" type="data_column" />
+        </repeat>
+    </expand>
+    <tests>
+        <test>
+            <param name="in_file" value="group_compute_input.txt" />
+            <param name="grouping" value="2" />
+            <param name="header_in" value="true" />
+            <param name="header_out" value="true" />
+            <param name="need_sort" value="true" />
+            <param name="print_full_line" value="false" />
+            <param name="op_column" value="3" />
+            <param name="op_name" value="sum" />
+            <param name="ignore_case" value="false" />
+            <output file="group_compute_output.txt" name="out_file" />
+        </test>
+    </tests>
+    <help>
+<![CDATA[
+@HELP_HEADER@
+
+**Syntax**
+
+This tools performs common operations (such as summing, counting, mean, standard-deviation) on input file, based on tabular data. The tool can also optionaly group the input based on a given field.
+
+-----
+
+**Example 1**
+
+- Find the average score in statistics course of college students, grouped by their college major. The input file has three fields (Name,Major,Score) and a header line::
+
+    Name        Major            Score
+    Bryan       Arts             68
+    Isaiah      Arts             80
+    Gabriel     Health-Medicine  100
+    Tysza       Business         92
+    Zackery     Engineering      54
+    ...
+    ...
+
+- Grouping the input by the second column (*Major*), and performing operations **mean** and **sample standard deviation** on the third column (*Score*), gives::
+
+    GroupBy(Major)     mean(Score)   sstdev(Score)
+    Arts               68.9474       10.4215
+    Business           87.3636       5.18214
+    Engineering        66.5385       19.8814
+    Health-Medicine    90.6154       9.22441
+    Life-Sciences      55.3333       20.606
+    Social-Sciences    60.2667       17.2273
+
+This sample file is available at http://www.gnu.org/software/datamash .
+
+**Example 2**
+
+- Using the UCSC RefSeq Human Gene Track, available at: http://hgdownload.soe.ucsc.edu/goldenPath/hg38/database/refGene.txt.gz
+
+- List the number and identifiers of isoforms per gene. The gene identifier is in column 13, the isoform/transcript identifier is in column 2. Grouping by column 13 and performing **count** and **Combine all values** on column 2, gives::
+
+    GroupBy(field-13)     count(field-2)     collapse(field-2)
+    A1BG                  1                  NM_130786
+    A1BG-AS1              1                  NR_015380
+    A1CF                  6                  NM_001198818,NM_001198819,NM_001198820,NM_014576,NM_138932,NM_138933
+    A2M                   1                  NM_000014
+    A2M-AS1               1                  NR_026971
+    A2ML1                 2                  NM_001282424,NM_144670
+    ...
+
+- Count how many transcripts are listed for each chromosome and strand. Chromosome is on column 3, Strand is in column 4. Transcript identifiers are in column 2. Grouping by columns **3,4** and performing operation **count** on column 2, gives::
+
+    GroupBy(field-3)     GroupBy(field-4)     count(field-2)
+    chr1                 +                    2456
+    chr1                 -                    2431
+    chr2                 +                    1599
+    chr2                 -                    1419
+    chr3                 +                    1287
+    chr3                 -                    1249
+    ...
+
+@HELP_FOOTER@
+]]>
+    </help>
+</tool>
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/macros.xml	Wed Oct 28 12:46:01 2015 -0400
@@ -0,0 +1,40 @@
+<?xml version="1.0"?>
+<macros>
+    <xml name="inputs_outputs">
+        <inputs>
+            <param format="tabular" help="" label="Input tabular dataset" name="in_file" type="data" />
+            <yield />
+        </inputs>
+        <outputs>
+            <data format="tabular" name="out_file" label="${tool.name} on ${on_string}" />
+        </outputs>
+    </xml>
+    <xml name="requirements">
+        <requirements>
+            <requirement type="package" version="1.0.6">datamash</requirement>
+        </requirements>
+    </xml>
+    <xml name="stdio">
+        <stdio>
+            <exit_code description="Error" level="fatal" range="1:" />
+        </stdio>
+    </xml>
+    <token name="@HELP_FOOTER@">
+-----
+
+**GNU Datamash** is a Free and Open Source Software, see more details on the Datamash_ Website.
+
+**GNU Datamash** is also available as a command-line program, see http://www.gnu.org/software/datamash/download/ .
+
+For more details about supported statistical operations, see Datamash_ website.
+
+.. _Datamash: http://www.gnu.org/software/datamash/
+    </token>
+    <token name="@HELP_HEADER@">
+.. class:: infomark
+
+**TIP:** Input data must be TAB delimited. If the desired dataset does not appear in the input list, use *Text Manipulation->Convert* to convert it to **Tabular** type.
+
+-----
+    </token>
+</macros>
\ No newline at end of file
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/test-data/datamash_reverse_input.txt	Wed Oct 28 12:46:01 2015 -0400
@@ -0,0 +1,4 @@
+Genes	Sample	Counts
+NOX1	A1	514
+DcP	A2	542
+HH	B3	490
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/test-data/datamash_reverse_output.txt	Wed Oct 28 12:46:01 2015 -0400
@@ -0,0 +1,4 @@
+Counts	Sample	Genes
+514	A1	NOX1
+542	A2	DcP
+490	B3	HH
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/test-data/datamash_transpose_input.txt	Wed Oct 28 12:46:01 2015 -0400
@@ -0,0 +1,3 @@
+Genes	NOX1	DcP	HH
+Sample	A1	A2	B3
+Counts	514	542	490
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/test-data/datamash_transpose_output.txt	Wed Oct 28 12:46:01 2015 -0400
@@ -0,0 +1,4 @@
+Genes	Sample	Counts
+NOX1	A1	514
+DcP	A2	542
+HH	B3	490
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/test-data/group_compute_input.txt	Wed Oct 28 12:46:01 2015 -0400
@@ -0,0 +1,84 @@
+Name	Major	Score
+Ignatius	Engineering	83
+Austin	Life-Sciences	91
+Zackery	Engineering	54
+Marques	Arts	58
+Darren	Business	94
+Darius	Social-Sciences	51
+Thanh	Engineering	53
+Joe'Quann	Engineering	75
+Bryan	Arts	68
+Devin	Engineering	92
+Joseph	Social-Sciences	61
+Joshua	Life-Sciences	14
+Ja'Won	Social-Sciences	37
+Tyreque	Arts	74
+Sage	Arts	55
+Antonio	Engineering	88
+Michael	Engineering	39
+Randy	Social-Sciences	68
+Dilan	Health-Medicine	84
+Omar	Engineering	99
+Zachary	Arts	80
+Faison	Engineering	47
+Angel	Health-Medicine	100
+Gabriel	Health-Medicine	100
+John	Life-Sciences	70
+Leonard	Business	87
+Juan	Business	79
+Jonathan	Health-Medicine	100
+Christopher	Life-Sciences	59
+Brandon	Life-Sciences	72
+D'Angelo	Health-Medicine	90
+Justin	Social-Sciences	90
+Israel	Health-Medicine	81
+William	Arts	46
+David	Social-Sciences	69
+Drake	Social-Sciences	59
+Drake	Social-Sciences	76
+Nathan	Arts	71
+Trevon	Arts	74
+Aaron	Business	83
+Daniel	Health-Medicine	91
+Kevin	Health-Medicine	100
+Antonio	Engineering	56
+Donovan	Arts	75
+Kerris	Business	82
+Andre	Health-Medicine	72
+Dakota	Business	83
+Aaron	Life-Sciences	58
+Walter	Arts	75
+Isaiah	Arts	80
+Christian	Life-Sciences	67
+Dalton	Health-Medicine	100
+Jesse	Social-Sciences	32
+Diego	Health-Medicine	82
+Nathen	Life-Sciences	46
+Anthony	Life-Sciences	32
+Christian	Business	88
+David	Business	92
+Avery	Engineering	51
+Paul	Arts	63
+Derek	Arts	60
+Levi	Arts	76
+Lance	Social-Sciences	65
+Sonny	Engineering	50
+Shawn	Arts	65
+Leonardo	Engineering	78
+Yeng	Life-Sciences	39
+Leroy	Social-Sciences	74
+Gurnam	Life-Sciences	66
+Fernando	Arts	78
+Williams	Social-Sciences	62
+Roberto	Arts	65
+Teriuse	Business	94
+Nathaniel	Arts	88
+Chase	Social-Sciences	27
+Caleb	Business	87
+Tysza	Business	92
+Nico	Arts	59
+Manuel	Social-Sciences	61
+Patrick	Health-Medicine	92
+Peter	Health-Medicine	86
+Allen	Life-Sciences	50
+Joel	Social-Sciences	72
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/test-data/group_compute_output.txt	Wed Oct 28 12:46:01 2015 -0400
@@ -0,0 +1,7 @@
+GroupBy(Major)	sum(Score)
+Arts	1310
+Business	961
+Engineering	865
+Health-Medicine	1178
+Life-Sciences	664
+Social-Sciences	904
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tool_dependencies.xml	Wed Oct 28 12:46:01 2015 -0400
@@ -0,0 +1,6 @@
+<?xml version="1.0"?>
+<tool_dependency>
+    <package name="datamash" version="1.0.6">
+        <repository changeset_revision="414953c0168d" name="package_datamash_1_0_6" owner="iuc" toolshed="https://toolshed.g2.bx.psu.edu" />
+    </package>
+</tool_dependency>