Mercurial > repos > immport-devteam > flow_overview

comparison genFlowOverview.xml @ 1:b5453d07f740 draft default tip

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/flow_overview commit 65373effef15809f3db0e5f9603ef808f4110aa3"
author azomics
date Wed, 29 Jul 2020 17:03:53 -0400
parents
children
comparison
equal deleted inserted replaced
0:8283ff163ba6 1:b5453d07f740
1 <tool id="gen_flow_overview" name="Generate overview information" version="1.2+galaxy0" profile="18.01">
2 <description>of reference set of clusters or populations.</description>
3 <requirements>
4 <requirement type="package" version="3.3.0">matplotlib</requirement>
5 <requirement type="package" version="1.5.1">scipy</requirement>
6 <requirement type="package" version="1.0.5">pandas</requirement>
7 <requirement type="package" version="2.11.2">jinja2</requirement>
8 <requirement type="package" version="1.26.0">bioconductor-flowcl</requirement>
9 </requirements>
10 <stdio>
11 <exit_code range="2" level="fatal" description="There was a problem running flowCL. You might want to check your marker names - See stderr for more details." />
12 <exit_code range="3" level="fatal" description="There are too many populations in the input file. The maximum number of populations is 40." />
13 <exit_code range="4:" level="fatal" description="See stderr for more details." />
14 </stdio>
15 <command><![CDATA[
16 #if $ontology.runcl == "no"
17 python '$__tool_directory__/genFlowOverview.py' -i '${input}' -o '${html_file}' -M '${mfi}' -d '${html_file.files_path}' -t '$__tool_directory__';
18 #else
19 python '$__tool_directory__/genFlowOverview.py' -i '${input}' -o '${html_file}' -M '${mfi}' -d '${html_file.files_path}' -t '$__tool_directory__' -p '${scores}';
20 #end if
21
22 cp -r '$__tool_directory__'/js '${html_file.files_path}';
23 cp -r '$__tool_directory__'/css '${html_file.files_path}';
24 ]]>
25 </command>
26 <inputs>
27 <param format="flowclr" name="input" type="data" label="Flow Result File"/>
28 <param name="mfi" type="select" label="Calculate centroids using:">
29 <option value="mfi" selected="true">Mean Fluorescence Intensity</option>
30 <option value="mdfi">Median Fluorescence Intensity</option>
31 <option value="gmfi">Geometric Mean Fluorescence Intensity</option>
32 </param>
33 <conditional name="ontology">
34 <param name="runcl" type="select" label="Associate FLOCK population score profiles with Cell Ontology?" help="using FlowCL">
35 <option value="no">No, thank you</option>
36 <option value="yes">Yes, pretty please, even though it will take 10 more minutes to run</option>
37 </param>
38 <when value="yes">
39 <param format="flowscore" name="scores" type="data" label="Population score profiles from FLOCK"/>
40 </when>
41 </conditional>
42 </inputs>
43 <outputs>
44 <data format="html" name="html_file" label="Overview of ${input.name}">
45 </data>
46 </outputs>
47 <tests>
48 <test>
49 <param name="input" value="input.flowclr"/>
50 <param name="mfi" value="mfi"/>
51 <param name="runcl" value="no"/>
52 <output name="html_file" file="out1/out.html">
53 <extra_files type="file" name="flow.mfi" value="out1/flow.mfi"/>
54 <extra_files type="file" name="flow.mfi_pop" value="out1/flow.mfi_pop"/>
55 <extra_files type="file" name="flow.overview" value="out1/flow.overview"/>
56 <extra_files type="file" name="flow.sample" value="out1/flow.sample"/>
57 <extra_files type="file" name="boxplotData.json" value="out1/boxplotData.json" compare="sim_size"/>
58 <extra_files type="file" name="m0_m0_90X90.png" value="out1/m0_m0_90X90.png" compare="sim_size"/>
59 <extra_files type="file" name="m0_m1_90X90.png" value="out1/m0_m1_90X90.png" compare="sim_size"/>
60 <extra_files type="file" name="m1_m0_90X90.png" value="out1/m1_m0_90X90.png" compare="sim_size"/>
61 <extra_files type="file" name="m1_m1_90X90.png" value="out1/m1_m1_90X90.png" compare="sim_size"/>
62 </output>
63 </test>
64 <test>
65 <param name="input" value="input.flowclr"/>
66 <param name="mfi" value="mfi"/>
67 <param name="runcl" value="yes"/>
68 <param name="scores" value="profile.flowscore"/>
69 <output name="html_file" file="out2/out.html">
70 <extra_files type="file" name="boxplotData.json" value="out2/boxplotData.json" compare="sim_size"/>
71 <extra_files type="file" name="CLprofiles.txt" value="out2/CLprofiles.txt"/>
72 <extra_files type="file" name="flow.mfi" value="out2/flow.mfi"/>
73 <extra_files type="file" name="flow.mfi_pop" value="out2/flow.mfi_pop"/>
74 <extra_files type="file" name="flow.overview" value="out2/flow.overview"/>
75 <extra_files type="file" name="flow.sample" value="out2/flow.sample"/>
76 <extra_files type="file" name="m0_m0_90X90.png" value="out2/m0_m0_90X90.png" compare="sim_size"/>
77 <extra_files type="file" name="m0_m1_90X90.png" value="out2/m0_m1_90X90.png" compare="sim_size"/>
78 <extra_files type="file" name="m1_m0_90X90.png" value="out2/m1_m0_90X90.png" compare="sim_size"/>
79 <extra_files type="file" name="m1_m1_90X90.png" value="out2/m1_m1_90X90.png" compare="sim_size"/>
80 <extra_files type="file" name="scores.txt" value="out2/scores.txt"/>
81 <extra_files type="file" name="flowcl_pop01.pdf" value="out2/flowcl_pop01.pdf" compare="sim_size"/>
82 <extra_files type="file" name="flowcl_pop01.txt" value="out2/flowcl_pop01.txt"/>
83 <extra_files type="file" name="flowcl_pop04.pdf" value="out2/flowcl_pop04.pdf" compare="sim_size"/>
84 <extra_files type="file" name="flowcl_pop04.txt" value="out2/flowcl_pop04.txt"/>
85 <extra_files type="file" name="flowcl_pop07.pdf" value="out2/flowcl_pop07.pdf" compare="sim_size"/>
86 <extra_files type="file" name="flowcl_pop07.txt" value="out2/flowcl_pop07.txt"/>
87 <extra_files type="file" name="flowcl_pop13.pdf" value="out2/flowcl_pop13.pdf" compare="sim_size"/>
88 <extra_files type="file" name="flowcl_pop13.txt" value="out2/flowcl_pop13.txt"/>
89 <extra_files type="file" name="flowcl_pop14.pdf" value="out2/flowcl_pop14.pdf" compare="sim_size"/>
90 <extra_files type="file" name="flowcl_pop14.txt" value="out2/flowcl_pop14.txt"/>
91 <extra_files type="file" name="flowcl_pop15.pdf" value="out2/flowcl_pop15.pdf" compare="sim_size"/>
92 <extra_files type="file" name="flowcl_pop15.txt" value="out2/flowcl_pop15.txt"/>
93 <extra_files type="file" name="flowcl_pop19.pdf" value="out2/flowcl_pop19.pdf" compare="sim_size"/>
94 <extra_files type="file" name="flowcl_pop19.txt" value="out2/flowcl_pop19.txt"/>
95 <extra_files type="file" name="flowcl_pop20.pdf" value="out2/flowcl_pop20.pdf" compare="sim_size"/>
96 <extra_files type="file" name="flowcl_pop20.txt" value="out2/flowcl_pop20.txt"/>
97 <extra_files type="file" name="flowcl_pop23.pdf" value="out2/flowcl_pop23.pdf" compare="sim_size"/>
98 <extra_files type="file" name="flowcl_pop23.txt" value="out2/flowcl_pop23.txt"/>
99 </output>
100 </test>
101 </tests>
102 <help><![CDATA[
103 This tool generates an overview of flow data clustering analysis results.
104 -----
105 **Input**
106 Tool input is a tab-separated file containing markers fluorescence intensities for each event as well as population, for instance generated as part of FLOCK, FlowSOM or CrossSample run. If the option is selected, flowCL is used to associate populations defined by FLOCK to a Cell Ontology term. This option is not available for FlowSOM runs.
107 .. class:: infomark
108 Tip: Marker names need to be in the Cell Ontology for flowCL to run.
109 .. class:: warningmark
110 The number of populations or clusters this tool can handle is limited to 40.
111 **Output**
112 The output is a page with multiple tabs that allows visualization of the data.
113 .. class: warningmark
114 The input table is proportionally downsampled to 20K events for the visualization.
115 .. class:: warningmark
116 *The output of this tool is interactive. However, comments or any other modifications made are not saved when exiting the view.*
117 -----
118 **Example**
119 *Input* - fluorescence intensities per marker and population ID per event::
120 Marker1 Marker2 Marker3 ... Population
121 33 47 11 ... 1
122 31 64 11 ... 6
123 21 62 99 ... 2
124 14 34 60 ... 7
125 ... ... ... ... ...
126 *Output*
127 Summary of the data:
128 The comment field of this table is editable, and can be used to name the populations. The edited values are used to populate the legends of the other graphs. The columns are re-orderable. The 'col visibility' button allows to choose which columns to display. 'CSV', 'PDF' and 'Copy' respectively allow to download a comma-separated values file, a pdf version or to copy to your clipboard in a tab-separated format the current view of the table.
129 .. image:: ../../static/images/flowtools/summary.png
130 .. image:: ../../static/images/flowtools/edit_summary.png
131 Scatterplots overview:
132 .. image:: ../../static/images/flowtools/overview.png
133 2D Scatterplot:
134 The user can choose which populations and markers to display. The Plotly toolbar allows more control over the display of the graph. There is an option to save the plot as a png file.
135 .. image:: ../../static/images/flowtools/scatter2D.png
136 3D Scatterplot:
137 The user can choose which populations and markers to display. The Plotly toolbar allows more control over the display of the graph. There is an option to save the plot as a png file.
138 .. class:: warningmark
139 Unfortunately Chrome stopped supporting the plugin enabling this visualization. If you get an error message stating that WebGL is not supported, try switching to Firefox.
140 .. image:: ../../static/images/flowtools/scatter3D.png
141 Parallel Coordinates:
142 The user can reorder the markers, and choose which populations to display either by selecting them in the legends via checkboxes or by selecting them on the graph. Data selected for display is shown in the table below the graph. Mousing over a line in that table highlights the corresponding line on the graph. The 'col visibility' button allows to choose which columns to display. 'CSV', 'PDF' and 'Copy' respectively allow to download a comma-separated values file, a pdf version or to copy to your clipboard in a tab-separated format the current view of the table.
143 .. image:: ../../static/images/flowtools/pcflock.png
144 Summary Statistics Boxplots:
145 The user can choose whether to group the boxplots per marker or per population. By default, the values displayed are the 25th, median and 75th percentiles. The whiskers represent 1.5 times the interquartile range. The MFI or the values can be displayed by checking the corresponding checkboxes. The number of markers that can be plotted simultaneously is limited to 5. The number of outliers per data point is limited to 100. If there are more than 100 outliers, they are downsampled randomly to a 100 and a warning message is displayed.
146 .. image:: ../../static/images/flowtools/bpflock.png
147 If the ontology option was selected, the following tab is displayed.
148 The CL terms hyperlink to their representation in the Immport Cell Ontology browser. The full flowCL run summary is accessible by clicking on the phenotype.
149 .. image:: ../../static/images/flowtools/profileCL_go.png
150 ]]>
151 </help>
152 <citations>
153 <citation type="doi">10.1093/bioinformatics/btu807</citation>
154 </citations>
155 </tool>