annotate README.md @ 3:eb27e0fe9ea3 draft default tip

planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 957d0e442c875f7cf8461866fac9695175ab371b
author ethevenot
date Wed, 28 Feb 2018 06:22:18 -0500
parents 75a031fa583d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
1 Univariate parametric and non-parametric hypothesis testing with correction for multiple testing
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
2 ================================================================================================
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
3
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
4 A Galaxy module from the [Workflow4metabolomics](http://workflow4metabolomics.org) infrastructure
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
5
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
6 Status: [![Build Status](https://travis-ci.org/workflow4metabolomics/univariate.svg?branch=master)](https://travis-ci.org/workflow4metabolomics/univariate).
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
7
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
8 ### Description
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
9
2
75a031fa583d planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit a81d4cc1df719dcc66def660927abda74972afaa
ethevenot
parents: 0
diff changeset
10 **Version:** 2.2.4
75a031fa583d planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit a81d4cc1df719dcc66def660927abda74972afaa
ethevenot
parents: 0
diff changeset
11 **Date:** 2018-01-11
0
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
12 **Author:** Marie Tremblay-Franco (INRA, MetaToul, MetaboHUB, W4M Core Development Team) and Etienne A. Thevenot (CEA, LIST, MetaboHUB, W4M Core Development Team)
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
13 **Email:** [marie.tremblay-franco(at)toulouse.inra.fr](mailto:marie.tremblay-franco@toulouse.inra.fr); [etienne.thevenot(at)cea.fr](mailto:etienne.thevenot@cea.fr)
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
14 **Citation:** Thevenot E.A., Roux A., Xu Y., Ezan E. and Junot C. (2015). Analysis of the human adult urinary metabolome variations with age, body mass index and gender by implementing a comprehensive workflow for univariate and OPLS statistical analyses. *Journal of Proteome Research*, **14**:3322-3335. [doi:10.1021/acs.jproteome.5b00354](http://dx.doi.org/10.1021/acs.jproteome.5b00354)
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
15 **Reference history:** [W4M00001a_sacurine-subset-statistics](http://galaxy.workflow4metabolomics.org/history/list_published), [W4M00004_mtbls1](http://galaxy.workflow4metabolomics.org/history/list_published)
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
16 **Licence:** CeCILL
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
17 **Funding:** Agence Nationale de la Recherche ([MetaboHUB](http://www.metabohub.fr/index.php?lang=en&Itemid=473) national infrastructure for metabolomics and fluxomics, ANR-11-INBS-0010 grant)
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
18
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
19 ### Installation
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
20
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
21 * Configuration file: `univariate_config.xml`
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
22 * Image file:
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
23 + `static/images/univariate_workflowPositionImage.png`
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
24 * Wrapper file: `univariate_wrapper.R`
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
25 * Script file: `univariate_script.R`
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
26 * R packages
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
27 + **batch** from CRAN
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
28
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
29 ```r
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
30 install.packages("batch", dep=TRUE)
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
31 ```
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
32 + **PMCMR** from CRAN
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
33
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
34 ```r
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
35 install.packages("PMCMR", dep=TRUE)
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
36 ```
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
37
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
38 ### Tests
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
39
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
40 The code in the wrapper can be tested by running the `runit/univariate_runtests.R` R file
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
41
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
42 You will need to install **RUnit** package in order to make it run:
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
43 ```r
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
44 install.packages('RUnit', dependencies = TRUE)
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
45 ```
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
46
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
47 ### Working example
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
48
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
49 See the **W4M00001a_sacurine-subset-statistics**, **W4M00001b_sacurine-subset-complete**, **W4M00002_mtbls2**, **W4M00003_diaplasma** shared histories in the **Shared Data/Published Histories** menu (https://galaxy.workflow4metabolomics.org/history/list_published)
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
50
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
51 ### News
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
52
2
75a031fa583d planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit a81d4cc1df719dcc66def660927abda74972afaa
ethevenot
parents: 0
diff changeset
53 ###### CHANGES IN VERSION 2.2.4
75a031fa583d planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit a81d4cc1df719dcc66def660927abda74972afaa
ethevenot
parents: 0
diff changeset
54
75a031fa583d planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit a81d4cc1df719dcc66def660927abda74972afaa
ethevenot
parents: 0
diff changeset
55 MINOR MODIFICATION
75a031fa583d planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit a81d4cc1df719dcc66def660927abda74972afaa
ethevenot
parents: 0
diff changeset
56
75a031fa583d planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit a81d4cc1df719dcc66def660927abda74972afaa
ethevenot
parents: 0
diff changeset
57 * Internal minor modifications for building and testing
75a031fa583d planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit a81d4cc1df719dcc66def660927abda74972afaa
ethevenot
parents: 0
diff changeset
58
0
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
59 ###### CHANGES IN VERSION 2.2.0
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
60
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
61 MAJOR MODIFICATION
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
62
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
63 * ANOVA and Kruskal-Wallis: The p-values of the post-hoc tests (i.e. from pairwise comparisons) are now further corrected for multiple testing over all variables (previously, only the p-value of the -first- omnibus test was corrected over all variables)
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
64
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
65 MINOR MODIFICATION
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
66
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
67 * All values in the 'dif', adjusted p-value, and 'sig' columns are now displayed (previously, the values were set to NA when the p-value of the omnibus test was not significant)
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
68
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
69 NEW FEATURE
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
70
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
71 * Graphic: a single pdf file containing the graphics of all significant tests is now produced as '_figure.pdf' output: boxplots (respectively scatterplots with the regression line in red and the R2 value) are displayed when the factor of interest is qualitative (respectively quantitative). The corrected p-value is indicated in the title of each plot
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
72
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
73 ###### CHANGES IN VERSION 2.1.4
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
74
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
75 NEW FEATURE
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
76
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
77 * Level names are now separated by '.' instead of '-' previously in the column names of the output variableMetadata table (e.g., 'jour_ttest_J3.J10_fdr' instead of 'jour_ttest_J3-J10_fdr' previously)
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
78
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
79 INTERNAL MODIFICATION
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
80
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
81 * Minor internal changes
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
82
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
83 ###### CHANGES IN VERSION 2.1.2
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
84
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
85 INTERNAL MODIFICATION
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
86
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
87 * Minor internal changes in .shed.yml for toolshed export
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
88
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
89 ###### CHANGES IN VERSION 2.1.1
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
90
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
91 INTERNAL MODIFICATION
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
92
ab2ee3414e4e planemo upload for repository https://github.com/workflow4metabolomics/univariate.git commit 98e8f4464b2f7321acb010e26e2a1c82fe37096e
ethevenot
parents:
diff changeset
93 * Internal handling of 'NA' p-values (e.g. when intensities are identical in all samples).