|
80
|
1 <tool id="Summary_Statistics1" name="Summary Statistics" version="1.3.0">
|
|
|
2 <description>for any numerical column</description>
|
|
|
3 <expand macro="requirements" />
|
|
|
4 <macros>
|
|
|
5 <import>statistic_tools_macros.xml</import>
|
|
|
6 </macros>
|
|
|
7 <command interpreter="python">gsummary.py $input $out_file1 "$cond"</command>
|
|
|
8 <inputs>
|
|
|
9 <param format="tabular" name="input" type="data" label="Summary statistics on" help="Dataset missing? See TIP below"/>
|
|
|
10 <param name="cond" size="30" type="text" value="c5" label="Column or expression" help="See syntax below">
|
|
|
11 <validator type="empty_field" message="Enter a valid column or expression, see syntax below for examples"/>
|
|
|
12 </param>
|
|
|
13 </inputs>
|
|
|
14 <outputs>
|
|
|
15 <data format="tabular" name="out_file1" />
|
|
|
16 </outputs>
|
|
|
17 <tests>
|
|
|
18 <test>
|
|
|
19 <param name="input" value="1.bed"/>
|
|
|
20 <output name="out_file1" file="gsummary_out1.tabular"/>
|
|
|
21 <param name="cond" value="c2"/>
|
|
|
22 </test>
|
|
|
23 </tests>
|
|
|
24 <help>
|
|
|
25
|
|
|
26 .. class:: warningmark
|
|
|
27
|
|
|
28 This tool expects input datasets consisting of tab-delimited columns (blank or comment lines beginning with a # character are automatically skipped).
|
|
|
29
|
|
|
30 .. class:: infomark
|
|
|
31
|
|
|
32 **TIP:** If your data is not TAB delimited, use *Text Manipulation->Convert delimiters to TAB*
|
|
|
33
|
|
|
34 .. class:: infomark
|
|
|
35
|
|
|
36 **TIP:** Computing summary statistics may throw exceptions if the data value in every line of the columns being summarized is not numerical. If a line is missing a value or contains a non-numerical value in the column being summarized, that line is skipped and the value is not included in the statistical computation. The number of invalid skipped lines is documented in the resulting history item.
|
|
|
37
|
|
|
38 .. class:: infomark
|
|
|
39
|
|
|
40 **USING R FUNCTIONS:** Most functions (like *abs*) take only a single expression. *log* can take one or two parameters, like *log(expression,base)*
|
|
|
41
|
|
|
42 Currently, these R functions are supported: *abs, sign, sqrt, floor, ceiling, trunc, round, signif, exp, log, cos, sin, tan, acos, asin, atan, cosh, sinh, tanh, acosh, asinh, atanh, lgamma, gamma, gammaCody, digamma, trigamma, cumsum, cumprod, cummax, cummin*
|
|
|
43
|
|
|
44 -----
|
|
|
45
|
|
|
46 **Syntax**
|
|
|
47
|
|
|
48 This tool computes basic summary statistics on a given column, or on a valid expression containing one or more columns.
|
|
|
49
|
|
|
50 - Columns are referenced with **c** and a **number**. For example, **c1** refers to the first column of a tab-delimited file.
|
|
|
51
|
|
|
52 - For example:
|
|
|
53
|
|
|
54 - **log(c5)** calculates the summary statistics for the natural log of column 5
|
|
|
55 - **(c5 + c6 + c7) / 3** calculates the summary statistics on the average of columns 5-7
|
|
|
56 - **log(c5,10)** summary statistics of the base 10 log of column 5
|
|
|
57 - **sqrt(c5+c9)** summary statistics of the square root of column 5 + column 9
|
|
|
58
|
|
|
59 -----
|
|
|
60
|
|
|
61 **Examples**
|
|
|
62
|
|
|
63 - Input Dataset::
|
|
|
64
|
|
|
65 c1 c2 c3 c4 c5 c6
|
|
|
66 586 chrX 161416 170887 41108_at 16990
|
|
|
67 73 chrX 505078 532318 35073_at 1700
|
|
|
68 595 chrX 1361578 1388460 33665_s_at 1960
|
|
|
69 74 chrX 1420620 1461919 1185_at 8600
|
|
|
70
|
|
|
71 - Summary Statistics on column c6 of the above input dataset::
|
|
|
72
|
|
|
73 #sum mean stdev 0% 25% 50% 75% 100%
|
|
|
74 29250.000 7312.500 7198.636 1700.000 1895.000 5280.000 10697.500 16990.000
|
|
|
75
|
|
|
76 </help>
|
|
|
77 </tool>
|
