Mercurial > repos > azomics > clustergrammer_flow

comparison clustergrammerIPG.xml @ 0:fee56ee2f7ac draft

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
"planemo upload for repository https://github.com/ImmPortDB/immport-galaxy-tools/tree/master/flowtools/clustergrammer_flow commit b11dfcf10d287c1da91ffb1d5d0148c7f8f61356"
author azomics
date Fri, 31 Jul 2020 19:06:45 -0400
parents
children c90127c2a1ae
comparison
equal deleted inserted replaced
-1:000000000000 0:fee56ee2f7ac
1 <tool id="clustergrammer_flow" name="Generate a heat map" version="1.1+galaxy0" profile="18.01">
2 <description>of a flow analysis using Clustergrammer</description>
3 <requirements>
4 <requirement type="package" version="2.11.2">jinja2</requirement>
5 <requirement type="package" version="1.13.6">clustergrammer</requirement>
6 </requirements>
7 <stdio>
8 <exit_code range="1"/>
9 <exit_code range="2" level="fatal" description="Please provide a comma-separated list of indices." />
10 <exit_code range="3" level="fatal" description="Please provide integer as indices." />
11 <exit_code range="4" level="fatal" description="Indices within one of the categories are used several times." />
12 <exit_code range="5" level="fatal" description="Please provide indices within the range of your input matrix." />
13 <exit_code range="6:"/>
14 </stdio>
15 <command><![CDATA[
16 python '$__tool_directory__/clustergrammerIPG.py' '${input_matrix}' '${html_file}' '${html_file.files_path}' '$__tool_directory__' '${dist_type}' '${linkage}'
17 #for $category in $cat
18 'new_cat'
19 '${category.roc}'
20 '${category.cat_title}'
21 '${category.label1}'
22 '${category.indices1}'
23 #for $catlabel in $category.cat_labels
24 'new_label'
25 '${catlabel.label}'
26 '${catlabel.indices}'
27 #end for
28 #end for
29 ;
30 cp -r '$__tool_directory__'/js '${html_file.files_path}'/;
31 cp -r '$__tool_directory__'/css '${html_file.files_path}'/;
32 ]]>
33 </command>
34 <inputs>
35 <param format="flowmfi" name="input_matrix" type="data" label="Centroids file" help="Any type of input matrix can be used."/>
36 <param name="dist_type" type="select" label="Clustering option - Compute distance using:" help="See below for documentation, default is set to cosine.">
37 <option value="cosine" selected="true">Cosine</option>
38 <option value="euclidean">Euclidian</option>
39 <option value="correlation">Correlation</option>
40 <option value="jaccard">Jaccard</option>
41 </param>
42 <param name="linkage" type="select" label="Clustering option - Linkage type" help="See below for documentation. default is set to average.">
43 <option value="average" selected="true">Average</option>
44 <option value="single">Single</option>
45 <option value="complete">Complete</option>
46 <option value="weighted">Weigthed</option>
47 </param>
48 <repeat name="cat" title="Category">
49 <param name="roc" type="select" label="Is this category for row data or column data?">
50 <option value="row" selected="true">Row data (population or cluster)</option>
51 <option value="col">Column (marker name)</option>
52 </param>
53 <param name="cat_title" type="text" label="Category Title" value="i.e.: Marker Type"/>
54 <param name="label1" type="text" label="Category label" value="i.e.: Surface Marker"/>
55 <param name="indices1" type="text" label="Indices of rows or columns this label should be given to." value="i.e.:1,2,5"/>
56 <repeat name="cat_labels" title="Category label">
57 <param name="label" type="text" label="Category label" value="i.e.: Phospho Marker"/>
58 <param name="indices" type="text" label="Indices of rows or columns this label should be given to." value="i.e.:3,6,7"/>
59 </repeat>
60 </repeat>
61 </inputs>
62 <outputs>
63 <data format="html" name="html_file" label="Heatmap of ${input_matrix.name}"/>
64 </outputs>
65 <tests>
66 <test>
67 <param name="input_matrix" value="test.flowmfi"/>
68 <output name="html_file" file="heatmap.html">
69 <extra_files type="file" name="mult_view.json" value="mult_view.json"/>
70 </output>
71 </test>
72 </tests>
73 <help><![CDATA[
74 This tool generates a heat map from the provided input matrix using Clustergrammer.
75
76 -----
77
78 **Input**
79
80 Please provide a tab-separated matrix of values as input, for instance a centroid file from a FLOCK analysis.
81 Rows and columns can be annotated by setting up categories and labels for each group within categories.
82
83 .. class:: infomark
84
85 Any type of matrix can be used but the datatype expected by this tool is flowmfi. You can modify the file format of any file in your history by clicking on the pencil next to the name of your file, and going to the 'Datatype' tab.
86
87 **Distance and Linkage types**
88
89 Distance_ and linkage_ are computed using functions implemented in SciPy. Please refer to their documentation for further explanations.
90
91 **Graphical output**
92
93 The output is an interactive heat-map of the matrix provided.
94
95 .. class:: warningmark
96
97 The color scale represents ranges of fluorescence intensity and covers values between the minimun and maximum intensity values in the dataset used as input.
98
99 .. class:: infomark
100
101 Some features might not show up depending on the browser used. If the dendograms aren't displayed, try opening the output in Chrome.
102
103 -----
104
105 **Example**
106
107 *Input*: Centroids file::
108
109 Population Marker1 Marker2 Marker3
110 1 38 49 10
111 2 21 63 100
112 3 31 52 45
113 4 11 78 25
114
115 *Interactive Graphical output*
116
117 .. image:: ./static/images/flowtools/clustergrammer.png
118
119 -----
120
121 Clustergrammer_ is a project from the Ma'ayan lab. Find them on GitHub_, more info here_.
122
123 .. _Clustergrammer: http://amp.pharm.mssm.edu/clustergrammer/
124 .. _GitHub: https://github.com/MaayanLab/clustergrammer
125 .. _here: https://clustergrammer.readthedocs.io/getting_started.html
126 .. _Distance: https://docs.scipy.org/doc/scipy/reference/spatial.distance.html
127 .. _linkage: https://docs.scipy.org/doc/scipy/reference/generated/scipy.cluster.hierarchy.linkage.html#scipy.cluster.hierarchy.linkage
128 ]]>
129 </help>
130 <citations>
131 <citation type="doi">10.1038/sdata.2017.151</citation>
132 </citations>
133 </tool>