annotate plotPCA.xml @ 1:47bf2e1f065b draft

planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
author bgruening
date Mon, 15 Feb 2016 10:32:55 -0500
parents 7fb0a96e74c1
children b15aaad44ab8
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
1 <tool id="deeptools_plot_pca" name="plotPCA" version="@WRAPPER_VERSION@.0">
1
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
2 <description>Generate principal component analysis (PCA) plots from multiBamSummary or multiBigwigSummary output</description>
0
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
3 <macros>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
4 <token name="@BINARY@">plotPCA</token>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
5 <import>deepTools_macros.xml</import>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
6 </macros>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
7 <expand macro="requirements"/>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
8 <command>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
9 <![CDATA[
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
10 @BINARY@
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
11 --corData "$corData"
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
12 --plotTitle "$plotTitle"
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
13 --plotFile "$outFileName"
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
14 --plotFileFormat "$outFileFormat"
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
15 ]]>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
16 </command>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
17 <inputs>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
18 <param name="corData" format="deeptools_coverage_matrix" type="data" label="Matrix file from the multiBamSummary or multiBigwigSummary tools"/>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
19 <expand macro="input_image_file_format" />
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
20 <expand macro="plotTitle" />
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
21 </inputs>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
22 <outputs>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
23 <expand macro="output_image_file_format_not_nested" />
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
24 </outputs>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
25 <tests>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
26 <test>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
27 <param name="corData" value="multiBamSummary_result2.npz" ftype="deeptools_coverage_matrix" />
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
28 <param name="plotTitle" value="Test Plot" />
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
29 <param name="outFileFormat" value="png" />
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
30 <output name="outFileName" file="plotPCA_result1.png" ftpye="png" compare="sim_size" delta="100" />
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
31 </test>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
32 </tests>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
33 <help>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
34 <![CDATA[
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
35
1
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
36 What it does
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
37 ---------------
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
38
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
39 This tool takes the **default output file of ``multiBamSummary``** or ``multiBigwigSummary`` to perform a principal component analysis (PCA).
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
40
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
41 Output
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
42 -------------
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
43
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
44 The result is a panel of two plots:
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
45
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
46 1. The eigenvalues of the **top two principal components**.
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
47 2. The **Scree plot** for the top five principal components where the bars represent the amount of variability explained by the individual factors and the red line traces the amount of variability is explained by the individual components in a cumulative manner
0
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
48
1
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
49 Example plot
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
50 ---------------
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
51
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
52 .. image:: $PATH_TO_IMAGES/plotPCA_annotated.png
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
53 :width: 600
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
54 :height: 315
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
55
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
56 ===================
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
57
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
58 Background
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
59 -----------------
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
60
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
61 Principal component analysis (PCA) can be used, for example, to determine whether **samples display greater variability** between experimental conditions than between replicates of the same treatment. PCA is also useful to identify unexpected patterns, such as those caused by batch effects or outliers.
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
62 Principal components represent the directions along which the variation in the data is maximal, so that the information (e.g., read coverage values) from thousands of regions can be represented by just a few dimensions.
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
63
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
64 PCA is not necessarily meant to identify unknown groupings or clustering; it is up to the researcher to determine the experimental or technical reason underlying the principal components.
47bf2e1f065b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit fef8b344925620444d93d8159c0b2731a5777920
bgruening
parents: 0
diff changeset
65
0
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
66
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
67 -----
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
68
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
69 @REFERENCES@
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
70 ]]>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
71 </help>
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
72 <expand macro="citations" />
7fb0a96e74c1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit 0a9265a12a303b54cdaa974e82e87c2ac60962ee-dirty
bgruening
parents:
diff changeset
73 </tool>