annotate README.md @ 1:60c360e466a8 draft default tip

planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit 0f382a5296aae9bfc77df06b0a5ad493eb3c01f3
author ethevenot
date Wed, 28 Feb 2018 10:04:14 -0500
parents 4b9488602d57
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
1 Multivariate analysis by PCA, PLS(-DA), and OPLS(-DA)
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
2 =====================================================
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
3
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
4 A Galaxy module from the [Workflow4metabolomics](http://workflow4metabolomics.org) infrastructure
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
5
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
6 Status: [![Build Status](https://travis-ci.org/workflow4metabolomics/multivariate.svg?branch=master)](https://travis-ci.org/workflow4metabolomics/multivariate).
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
7
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
8 ### Description
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
9
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
10 **Version:** 2.3.8
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
11 **Date:** 2016-10-21
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
12 **Author:** Etienne A. Thevenot (CEA, LIST, MetaboHUB, W4M Core Development Team)
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
13 **Email:** [etienne.thevenot(at)cea.fr](mailto:etienne.thevenot@cea.fr)
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
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)
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
15 **Licence:** CeCILL
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
16 **Reference history:** [W4M00001a_sacurine-subset-statistics](http://galaxy.workflow4metabolomics.org/history/list_published), [W4M00001b_sacurine_complete](http://galaxy.workflow4metabolomics.org/history/list_published)
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
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)
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
18
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
19 ### Installation
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
20
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
21 * Configuration file: `multivariate_config.xml`
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
22 * Image files:
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
23 + `static/images/multivariate_workflowPositionImage.png`
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
24 + `static/images/multivariate_workingExampleImage.png`
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
25 * Wrapper file: `multivariate_wrapper.R`
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
26 * R packages
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
27 + **batch** from CRAN
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
28
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
29 ```r
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
30 install.packages("batch", dep=TRUE)
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
31 ```
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
32
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
33 + **ropls** from Bioconductor
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
34
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
35 ```r
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
36 source("http://www.bioconductor.org/biocLite.R")
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
37 biocLite("ropls")
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
38 ```
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
39
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
40 ### Tests
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
41
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
42 The code in the wrapper can be tested by running the `runit/multivariate_runtests.R` R file
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
43
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
44 You will need to install **RUnit** package in order to make it run:
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
45 ```r
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
46 install.packages('RUnit', dependencies = TRUE)
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
47 ```
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
48
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
49 ### Working example
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
50
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
51 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)
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
52
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
53 ### News
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
54
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
55 ###### CHANGES IN VERSION 2.3.8
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
56
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
57 MINOR MODIFICATION
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
58
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
59 * (O)PLS(-DA) coefficients display in case of multiple quantitative (or multiclass) response: now the column names of the coefficients for each response are correctly labelled in the variableMetadata file
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
60
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
61 ###### CHANGES IN VERSION 2.3.6
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
62
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
63 INTERNAL MODIFICATION
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
64
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
65 * minor internal modifications
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
66
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
67 ###### CHANGES IN VERSION 2.3.4
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
68
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
69 INTERNAL MODIFICATION
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
70
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
71 * minor update of .shed.yml
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
72
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
73 ###### CHANGES IN VERSION 2.3.2
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
74
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
75 INTERNAL MODIFICATION
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
76
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
77 * Modification of the `multivariate_wrapper.R` file to handle **ropls** package versions of 1.3.15 and above (i.e. after switching to S4 classes)
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
78
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
79 ###### CHANGES IN VERSION 2.3.0
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
80
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
81 NEW FEATURES
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
82
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
83 * **Predictions** now available (see the 'Samples to be tested' argument)
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
84 * OPLS(-DA): **Predictive and Orthogonal VIP** are now computed (see the 'comments' section)
4b9488602d57 planemo upload for repository https://github.com/workflow4metabolomics/multivariate.git commit ebbe4eb415f9e153eec5015bbffcdf0a925f2fa4
ethevenot
parents:
diff changeset
85 * **Multiclass PLS-DA** implemented (see the 'comments' section)