annotate histogram2.xml @ 0:9c0d844f4e48 draft

Imported from capsule None
author devteam
date Mon, 28 Jul 2014 11:30:12 -0400
parents
children a60f7f660872
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
1 <tool id="histogram_rpy" name="Histogram" version="1.0.3">
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
2 <description>of a numeric column</description>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
3 <requirements>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
4 <requirement type="package" version="1.0.3">rpy</requirement>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
5 <requirement type="package" version="2.11.0">R</requirement>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
6 </requirements>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
7 <command interpreter="python">histogram.py $input $out_file1 $numerical_column "$title" "$xlab" $breaks $density $frequency</command>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
8 <inputs>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
9 <param name="input" type="data" format="tabular" label="Dataset" help="Dataset missing? See TIP below"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
10 <param name="numerical_column" type="data_column" data_ref="input" numerical="True" label="Numerical column for x axis" />
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
11 <param name="breaks" type="integer" size="4" value="0" label="Number of breaks (bars)"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
12 <param name="title" type="text" size="30" value="Histogram" label="Plot title"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
13 <param name="xlab" type="text" size="30" value="V1" label="Label for x axis"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
14 <param name="density" type="boolean" checked="yes" label="Include smoothed density"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
15 <param name="frequency" type="boolean" checked="no" label="Plot as frequency (counts)"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
16 </inputs>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
17 <outputs>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
18 <data format="pdf" name="out_file1" />
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
19 </outputs>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
20 <tests>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
21 <test>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
22 <param name="input" value="histogram_in1.tabular" ftype="tabular"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
23 <param name="numerical_column" value="2"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
24 <param name="breaks" value="0"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
25 <param name="title" value="Histogram"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
26 <param name="xlab" value="V1"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
27 <param name="density" value="true"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
28 <param name="frequency" value="false"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
29 <output name="out_file1" file="histogram_out1.pdf"/>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
30 </test>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
31 </tests>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
32 <help>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
33
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
34 .. class:: infomark
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
35
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
36 **TIP:** To remove comment lines that do not begin with a *#* character, use *Text Manipulation-&gt;Remove beginning*
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
37
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
38 .. class:: infomark
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
39
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
40 **TIP:** If your data is not TAB delimited, use *Text Manipulation-&gt;Convert*
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
41
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
42 -----
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
43
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
44 **Syntax**
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
45
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
46 This tool computes a histogram of the numerical values in a column of a dataset.
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
47
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
48 - All invalid, blank and comment lines in the dataset are skipped. The number of skipped lines is displayed in the resulting history item.
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
49 - **Column for x axis** - only numerical columns are possible.
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
50 - **Number of breaks(bars)** - breakpoints between histogram cells. Value of '0' will determine breaks automatically.
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
51 - **Plot title** - the histogram title.
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
52 - **Label for x axis** - the label of the x axis for the histogram.
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
53 - **Include smoothed density** - if checked, the resulting graph will join the given corresponding points with line segments.
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
54
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
55 -----
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
56
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
57 **Example**
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
58
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
59 - Input file::
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
60
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
61 1 68 4.1
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
62 2 71 4.6
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
63 3 62 3.8
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
64 4 75 4.4
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
65 5 58 3.2
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
66 6 60 3.1
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
67 7 67 3.8
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
68 8 68 4.1
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
69 9 71 4.3
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
70 10 69 3.7
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
71
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
72 - Create a histogram on column 2 of the above dataset.
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
73
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
74 .. image:: histogram2.png
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
75
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
76 </help>
9c0d844f4e48 Imported from capsule None
devteam
parents:
diff changeset
77 </tool>