CHANGES IN VERSION 1.28.2
------------------------------

NEW FEATURE

    o 'opls' method now handles SummarizedExperiment and MultiAssayExperiment
    o 'view' method now handles SummarizedExperiment
    o 'sacurine' dataset includes the ExpressionSet and SummarizedExperiment formats
    o NCI60 dataset from omicade4 available in MultiAssayExperiment and MultiDataSet

CHANGES IN VERSION 1.27.8
------------------------------

MINOR MODIFICATION

    o minor vignette correction

CHANGES IN VERSION 1.27.6
------------------------------

MINOR MODIFICATION

    o minor vignette correction
    
CHANGES IN VERSION 1.27.4
------------------------------

MINOR MODIFICATION

    o minor vignette update

CHANGES IN VERSION 1.27.2
------------------------------

MINOR MODIFICATION

    o minor documentation update

CHANGES IN VERSION 1.23.12
------------------------------

MINOR MODIFICATION

    o minor documentation update

CHANGES IN VERSION 1.23.8
------------------------------

MINOR MODIFICATION

    o vignette: minor update

CHANGES IN VERSION 1.23.6
------------------------------

MINOR MODIFICATION

    o 'view' method: minor update of documentation

CHANGES IN VERSION 1.23.4
------------------------------

BUG FIXED

    o 'view' method: display of row names

CHANGES IN VERSION 1.23.2
------------------------------

BUG FIXED

    o 'view' method: display of row names (reversed in the previous versions)

CHANGES IN VERSION 1.19.16
------------------------------

INTERNAL MODIFICATION

    o '.header' function: 'class(x) == ' removed from code to take into account the R 4.0 changes

CHANGES IN VERSION 1.19.14
------------------------------

INTERNAL MODIFICATION

    o 'strF' function: use of is.array instead of is.matrix to take into account the R 4.0 changes

CHANGES IN VERSION 1.19.12
------------------------------

INTERNAL MODIFICATION

    o 'strF' function: replacement by 'is(x, )': cont'd

CHANGES IN VERSION 1.19.10
------------------------------

INTERNAL MODIFICATION

    o 'strF' function: 'class(x) ==' replaced by 'is(x, )' as required by R/Bioconductor

CHANGES IN VERSION 1.19.8
------------------------------

NEW FEATURE

    o 'view' method: 'standardizeL' argument for the standardization of column values
    for display

CHANGES IN VERSION 1.19.6
------------------------------

BUG FIXED

    o 'view' method: ExpressionSet with empty metadata

CHANGES IN VERSION 1.19.4
------------------------------

NEW FEATURE

    o 'view' method: plot extended to data.frames and ExpressionSet

CHANGES IN VERSION 1.19.2
------------------------------

BUG FIXED

    o 'view' method: in case the matrix has no row nor column names

CHANGES IN VERSION 1.17.34
------------------------------

NEW FEATURE

    o 'view' method (wrapper of the imageF and strF functions)

CHANGES IN VERSION 1.17.32
------------------------------

BUG FIXED

    o plot.oplsMultiDataSet correction to include all plots in the .pdf file

CHANGES IN VERSION 1.17.30
------------------------------

MINOR MODIFICATION

    o Additional correction in getMset documentation (example)

CHANGES IN VERSION 1.17.28
------------------------------

MINOR MODIFICATION

    o Correcting typo in getMset documentation (example)

CHANGES IN VERSION 1.17.26
------------------------------

MINOR MODIFICATION

    o Including the set name in the figure of MultiDataSet models

CHANGES IN VERSION 1.17.24
------------------------------

MINOR MODIFICATION

    o Correction of the documentation for 'residuals' and 'plot-oplsMultidDataSet'

CHANGES IN VERSION 1.17.22
------------------------------

INTERNAL MODIFICATION

    o Correction of the example in the oplsMultiDataSet class documentation

CHANGES IN VERSION 1.17.20
------------------------------

NEW FEATURE

    o plotPhenoDataC parameter for coloring (score plots) according to one column from
    the pData data frame when the opls method has been applied to an ExpresssionSet

CHANGES IN VERSION 1.17.18
------------------------------

INTERNAL MODIFICATION

    o Minor internal modification

CHANGES IN VERSION 1.17.16
------------------------------

INTERNAL MODIFICATION

    o Minor internal modification

CHANGES IN VERSION 1.17.14
------------------------------

NEW FEATURE

    o Example of the analyis of a MultiDataSet ('NCI60_4arrays' from the 'omicade4' package)

CHANGES IN VERSION 1.17.12
------------------------------

NEW FEATURE

    o Multi data set names display on graphics
    
CHANGES IN VERSION 1.17.10
------------------------------

NEW FEATURE

    o plot method for oplsMultiDataSet objects

CHANGES IN VERSION 1.17.8
------------------------------

NEW FEATURE

    o opls can now be applied to MultiDataSet objects; getMset method to extract
    the complemented MultiDataSet

CHANGES IN VERSION 1.17.6
------------------------------

INTERNAL MODIFICATION

    o minor internal modification

CHANGES IN VERSION 1.17.4
------------------------------

INTERNAL MODIFICATION

    o minor internal modification
    
CHANGES IN VERSION 1.17.2
------------------------------

NEW FEATURE

    o info.txtC and fig.pdfC argument values NULL and NA replaced by 'none' and 'interactive', respectively 

CHANGES IN VERSION 1.15.26
------------------------------

NEW FEATURE

    o plot method: dev.new() is not called internally any more; consequently the 'parDevNewL' argument has been removed; layout can be either 1x1 or 2x2, depending on the length of the 'typeVc' argument; 'fig.pdfC' and 'info.txtC' arguments have been added for compatibility reasons with other packages; they have the same role as 'file.pdfC' and '.sinkC' which now generate a deprecated warning. 

CHANGES IN VERSION 1.15.24
------------------------------

MINOR MODIFICATION

    o plot method: turning off ellipse display in case of a single sample the class

CHANGES IN VERSION 1.15.22
------------------------------

INTERNAL MODIFICATION

    o imageF function: minor modification of the log parameter

CHANGES IN VERSION 1.15.20
------------------------------

NEW FEATURE

    o imageF function to visualize a numerical matrix
    
CHANGES IN VERSION 1.15.18
------------------------------

INTERNAL MODIFICATION

    o minor internal modification

CHANGES IN VERSION 1.15.16
------------------------------

INTERNAL MODIFICATION

    o modification of the way additional columns are added to the pData and fData of an ExpressionSet instance
    
    o 'Biobase' package now as 'depends' (not 'import') 

CHANGES IN VERSION 1.15.14
------------------------------

INTERNAL MODIFICATION

    o minor internal modification

CHANGES IN VERSION 1.15.12
------------------------------

INTERNAL MODIFICATION

    o minor modification in examples defining ExpressionSet instances

CHANGES IN VERSION 1.15.10
------------------------------

INTERNAL MODIFICATION

    o 'eset' is now a slot of the 'opls' class (used when the 'opls' method is applied to an ExpressionSet instance)

CHANGES IN VERSION 1.15.8
------------------------------

NEW FEATURE

    o 'plot' method: parPaletteVc argument to specify colors
    

CHANGES IN VERSION 1.15.6
------------------------------

NEW FEATURE

    o Application to ExpressionSet: first 2 scores and loadings, as well as fitted values and VIP now returned in the pData and fData
    
INTERNAL MODIFICATION

    o Unit testing switched from 'RUnit' to 'testthat'


CHANGES IN VERSION 1.15.4
------------------------------

INTERNAL MODIFICATION

    o Checking that the data matrix does not contain any infinite or NaN value

CHANGES IN VERSION 1.15.2
------------------------------

INTERNAL MODIFICATION

    o ImmunoOncology tag added to biocViews
    o minor correction in the diagnostics graph labeling

CHANGES IN VERSION 1.13.8
------------------------------

INTERNAL MODIFICATION

    o minor correction in the documentation
    
CHANGES IN VERSION 1.13.6
------------------------------

INTERNAL MODIFICATION

    o update of package vignette

CHANGES IN VERSION 1.13.4
------------------------------

INTERNAL MODIFICATION

    o fixed bug in unit test

CHANGES IN VERSION 1.13.2
------------------------------

BUG CORRECTION

    o predict method: naming of the predicted Y matrix output columns in case of PLS modeling of multiple responses
    
INTERNAL MODIFICATION

    o ropls.Rproj file added for package management with RStudio

CHANGES IN VERSION 1.7.2
------------------------------

INTERNAL MODIFICATION

    o vignette now in pdf format

CHANGES IN VERSION 1.5.22
------------------------------

INTERNAL MODIFICATION

    o minor code formatting

CHANGES IN VERSION 1.5.20
------------------------------

BUG CORRECTION

    o PCA: correction in the computation of variance and R2X (svd), and the determination of the optimal number of components

CHANGES IN VERSION 1.5.18
------------------------------

INTERNAL MODIFICATION

    o correction in the vignette (determination of optimal number of components in PCA)

CHANGES IN VERSION 1.5.16
------------------------------

INTERNAL MODIFICATION

    o minor vignette formatting

CHANGES IN VERSION 1.5.14
------------------------------

NEW FEATURE

    o 'fromW4M' function and 'toW4M' method to import preprocessed tables
    generated by the online Workflow4metabolomics infrastructure into an
    ExpressionSet bioconductor object (and vice versa)

CHANGES IN VERSION 1.5.12
------------------------------

INTERNAL MODIFICATION

    o minor vignette formatting

CHANGES IN VERSION 1.5.10
------------------------------

INTERNAL MODIFICATION

    o checking automated documentation with the 'roxygen2' package; automated vignette with rmarkdown and knitr

CHANGES IN VERSION 1.5.8
------------------------------

INTERNAL MODIFICATION

    o deleting missing files from svn repository

CHANGES IN VERSION 1.5.6
------------------------------

NEW FEATURE

    o opls can now be applied to ExpressionSet instances
    o vignette is now in html format
    o automated documentation with the 'roxygen2' package; automated vignette with rmarkdown and knitr

CHANGES IN VERSION 1.5.4
------------------------------

NEW FEATURE

    o package documentation now available with ?ropls, help("ropls"), or help("ropls-package")

CHANGES IN VERSION 1.5.2
------------------------------

BUG FIXED

    o stop messages generated when non-significant predictive or first orthogonal components are obtained

CHANGES IN VERSION 1.5.0
------------------------------

NEW FEATURES

    o 'opls' is now an S4 class: please use the accessors e.g. 'getScoreMN(oplsModel)' instead of 'oplsModel$scoreMN', or 'getScoreMN(oplsModel, orthoL = TRUE)' instead of 'oplsModel$orthoScoreMN'
    o The full list of accessors is: getLoadingMN, getScoreMN, getVipVn, getWeightMN (all with the orthoL argument), in addition to getSummaryDF, getPcaVarVn, getSubsetVi
    o Please see the vignette and documentation for examples    
    

CHANGES IN VERSION 1.3.19
------------------------------

BUG FIXED

    o Committing the new files

CHANGES IN VERSION 1.3.18
------------------------------

NEW FEATURE

    o 'coefficients' method renamed as 'coef'
    
BUG FIXED

    o 'methods-opls_class.R' file renamed as 'opls-methods.R' to ensure 'opls' class is defined before the methods

CHANGES IN VERSION 1.3.17
------------------------------

BUG FIXED

    o Committing the new files

CHANGES IN VERSION 1.3.16
------------------------------

BUG FIXED

    o Committing the new files

CHANGES IN VERSION 1.3.15
------------------------------

NEW FEATURES

    o Switching to S4 class
    o Evaluating the metabolomics workflow in the vignette    

CHANGES IN VERSION 1.3.14
------------------------------

NEW FEATURES

    o plot.opls: when 'parAsColFcVn' is a character vector, it is converted to a factor (thus drawing ellipses by default)
            
BUG FIXED

    o plot.opls: handling of ellipse display when parEllipseL parameter set to NA (default)

CHANGES IN VERSION 1.3.13
------------------------------

NEW FEATURES

    o opls: no scaling option now available
            
BUG FIXED

    o opls: computation of the matrix of correlations (when the number of features is <= 100)

CHANGES IN VERSION 1.3.12
------------------------------

NEW FEATURES

    o opls: multiclass PLS-DA implemented (PLS2 approach; comments added in the vignette)
            default number of permutations set to 20 (instead of 10)
            predictive components denoted in the tables by 'p' (instead of 'h' previously)
            OPLS(-DA): simplified "modelDF" data frame ('rotation' row has been suppressed)
            
BUG FIXED

    o opls: PCA model with 'svd' and a single component
            

CHANGES IN VERSION 1.3.11
------------------------------

NEW FEATURES

    o opls: for OPLS(-DA), vipVn and orthoVipVn are now computed as the VIP4,p and VIP4,o described in Galindo-Prieto et al (2014)
    o plot.opls: changes in palette: black/grey colors for diagnostics and other colors for scores    

CHANGES IN VERSION 1.3.10
------------------------------

BUG FIXED

    o plot.opls: minor bug fixed ('x-score' label and color display of test samples when 'subset' is not NULL)

CHANGES IN VERSION 1.3.9
------------------------------

NEW FEATURES

    o vignette: minor update

CHANGES IN VERSION 1.3.8
------------------------------

NEW FEATURES

    o vignette: "some words of warning" section added

CHANGES IN VERSION 1.3.7
------------------------------

NEW FEATURES

    o vignette: default figures from plot.opls included
    
CHANGES IN VERSION 1.3.6
------------------------------

NEW FEATURES

    o strF: object size now displayed in Mb (instead of bytes); minor corrections to handle all matrices and data frames (whatever the dimensions, mode, row and column names)
    o unit tests: new tests added to increase test coverage

CHANGES IN VERSION 1.3.5
------------------------------

NEW FEATURES

    o unit tests: warning message corrected in order to allow test coverage display on the Bioconductor page
    
CHANGES IN VERSION 1.3.4
------------------------------

NEW FEATURES

    o vignette: minor correction in the default number of permutations for single response (O)PLS(-DA) models

CHANGES IN VERSION 1.3.3
------------------------------

NEW FEATURES

    o vignette: detailed explanations of Q2Y computation 


CHANGES IN VERSION 1.3.2
------------------------------

NEW FEATURES

    o plot.opls: 'plotVc' argument renamed 'typeVc' similarly to the default 'plot' function

CHANGES IN VERSION 1.3.1
------------------------------

NEW FEATURES

    o opls: now takes either a (numeric) data frame or matrix as 'x' input (instead of matrix only)   
    o predict: now takes either a (numeric) data frame or matrix as 'newdata' input (instead of matrix only) 

CHANGES IN VERSION 1.1.11
------------------------------

NEW FEATURES

    o NEWS format updated

CHANGES IN VERSION 1.1.10
------------------------------

NEW FEATURES

    o opls: PLS models can now be built for 'x' data with a single variable
        
CHANGES IN VERSION 1.1.9
------------------------------

NEW FEATURES

    o opls: default number of permutations set to 10 (instead of 100) as a compromise to enable both quick computation and a first hint at model significance

    o opls: maximum number of components in automated mode (predI = NA or orthoI = NA) set to 10 (instead of 15)

    o plot.opls: bug corrected in case of single component model without permutation testing

CHANGES IN VERSION 1.1.8
------------------------------

SIGNIFICANT USER-VISIBLE CHANGES

    o sacurine dataset name simplification: names of sample metadata are now 'age', 'bmi', and 'gender' instead of 'ageVn', 'bmiVn', and 'genderFc'; names of variableMetadata are now 'msiLevel', 'hmdb', 'chemicalClass' instead of 'msiLevelVn', 'hmdbVc', 'chemicalClassVc'

CHANGES IN VERSION 1.1.7
------------------------------

NEW FEATURES

    o Control to avoid overfitting was strenghtened by: i) setting the default number of permutations to 100 (instead of 0) and ii) changing the default plot ("summary") to include both the "permutation" and the "overview" graphics

CHANGES IN VERSION 1.1.6
------------------------------

NEW FEATURES

    o .sinkC argument added in the opls and plot.opls methods: Diversion of messages is required for Galaxy integration

CHANGES IN VERSION 1.1.5
------------------------------

NEW FEATURES

    o current implementation supports two-class only classification

CHANGES IN VERSION 1.1.4
------------------------------

NEW FEATURES

    o renamed slot of opls object: rotationMN -> weightStarMN

CHANGES IN VERSION 1.1.3
------------------------------

NEW FEATURES

    o Minor internal changes regarding default ellipse plotting options and checking the compatibility between the subset size and the cross-validation fold

CHANGES IN VERSION 1.1.2
------------------------------

BUG FIXES

    o Minor internal changes

CHANGES IN VERSION 1.1.1
------------------------------

SIGNIFICANT USER-VISIBLE CHANGES

    o The packaging was modified (but not the algorithms) to be consistent with other machine learning packages: 'opls' is now a class and the 'print', 'plot', 'predict', 'summary', 'fitted', 'coefficients' and 'residuals' methods are available (see the vignette)

SIGNIFICANT USER-VISIBLE CHANGES

    o renamed method: roplsF -> opls

    o renamed arguments
        testVi -> now 'subset' which indicates the indices of the training (instead of the testing) observations

    o values:
        tMN -> scoreMN
        pMN -> loadingMN
        wMN -> weightMN
        bMN -> coefficients
        rMN -> rotationMN
        varVn -> pcaVarVn
        tOrthoMN -> orthoScoreMN
        pOrthoMN -> orthoLoadingMN
        wOrthoMN -> orthoWeightMN

    o new (S3) methods for objects of class 'opls'
        print
        summary
        plot
        predict
        fitted
        coefficients
        residuals

CHANGES IN VERSION 1.0.2
------------------------------

NEW FEATURES

    o roplsF outputs: '.char2numF' function (required for class prediction on new datasets); replaces 'c2nLs'

CHANGES IN VERSION 1.0.1
------------------------------

SIGNIFICANT USER-VISIBLE CHANGES

    o renamed roplsF arguments (to indicate integers more explicitly)
        'predN' -> 'predI'
        'orthoN' -> 'orthoI'
        'crossvalN' -> 'crossvalI'
        'permN' -> 'permI'
        'parCompVn' -> 'parCompVi'
        'parTopLoadN' -> 'parTopLoadI'

CHANGES IN VERSION 0.99.7
------------------------------

SIGNIFICANT USER-VISIBLE CHANGES

    o rename ('sacurine' data set) for compatibility with 'Workflow4Metabolomics.org':
        'profileMN'  -> dataMatrix
        'sampleDF'   -> sampleMetadata
        'variableDF' -> variableMetadata
        
CHANGES IN VERSION 0.99.6
------------------------------

SIGNIFICANT USER-VISIBLE CHANGES

    o roplsF:
        handling of PLS models with single predictive component only

CHANGES IN VERSION 0.99.4
------------------------------

SIGNIFICANT USER-VISIBLE CHANGES

    o rename:
        'sacuri' data set -> 'sacurine'

CHANGES IN VERSION 0.99.2
------------------------------

SIGNIFICANT USER-VISIBLE CHANGES

    o rename:
        ropF -> roplsF
        ropStrF -> strF

    o depreacated roplsF arguments:
        parObsColLabVcn: now available through the parLabVc and parAsColVcn arguments
        parObsLegVc: not useful
	
    o rename roplsF arguments:
        ncpN -> predN
        ncoN -> orthoN
        ploVc -> plotVc
        algC -> algoC
        savImg.pdfC -> fileFig.pdfC
        savLog.txtC -> fileInfo.txtC
        logL -> log10L
        perN -> permN
        scaC -> scaleC
        tesVi -> testVi
        vrbC -> verboseC
        parObsColVc -> parAsColVcn
        parPcsVn -> parCompVn
        parMahL -> parEllipsesL
        parObsLabVc -> parLabVc
        parMaiL -> parTitleL
        parNexN -> parTopLoadN		

NEW FEATURES

    o ropColF -> now split between .colorF and .legendF
    o ropMahF -> now .ellipseF