MultiBaC: MultiBaC
In MultiBaC: Multiomic Batch effect Correction

Description Usage Arguments Value References Examples

MultiBaC performs a multi-omic, multi-batch correction

MultiBaC is a strategy to correct batch effects from multiomic datasets distributed across different labs or data acquisition events. MultiBaC is the first Batch effect correction algorithm that dealing with batch effect correction in multiomics datasets. MultiBaC is able to remove batch effects across different omics generated within separate batches provided that at least one common omic data type is included in all the batches considered.

1
2
3

MultiBaC(mbac, test.comp = NULL, scale = FALSE, center = TRUE,
  showplot = TRUE, crossval = NULL, Interaction = FALSE,
  Variability = 0.9, showinfo = TRUE)

`mbac`	mbac object generated by createMbac.
`test.comp`	Maximum number of components allowed for PLS models. If NULL (default), the minimal effective rank of the matrices is used as the maximum number of components.
`scale`	Logical. Whether X and Y matrices must be scaled. By default, FALSE.
`center`	Logical. Whether X and Y matrices must be centered. By default, TRUE.
`showplot`	Logical. If TRUE (default), the Q2 and the explained variance plots are shown.
`crossval`	Integer: number of cross-validation segments. The number of samples (rows of 'x') must be at least >= crossvalI. If NULL (default), a leave-one-out crossvalidation is performed.
`Interaction`	Logical. Whether to model the interaction between experimental factors and bacth factor in ARSyN models. By default, FALSE.
`Variability`	From 0 to 1. Minimum percent of data variability that must be explained by each ARSyN model. By default, 0.90.
`showinfo`	Logical. If TRUE (default), the information about the function progress is shown.

Custom mbac object. Elements in a mbac object:

ListOfBatches: A list of MultiAssayExperiment objects (one per batch).
commonOmic: Name of the common omic between the batches.
CorrectedData: Same structure than ListOfBatches but with the corrected data instead of the original.
PLSmodels: PLS models created during MultiBaC method performance (one model per non-common omic data type).
ARSyNmodels: ARSyN models created during MultiBaC performance (one per omic data type).
InnerRelation: Table of class data.frame containing the inner correlation (i.e. correlation between the scores of X (t) and Y (u) matrices) for each PLS model across all components.

Ugidos, M., Tarazona, S., Prats-Montalbán, J. M., Ferrer, A., & Conesa, A. (2020). MultiBaC: A strategy to remove batch effects between different omic data types. Statistical Methods in Medical Research. https://doi.org/10.1177/0962280220907365

data('multiyeast')

my_mbac <- createMbac (inputOmics = list(A.rna, A.gro, B.rna, B.ribo, C.rna, C.par),
                       batchFactor = c("A", "A", "B", "B", "C", "C"),
                       experimentalDesign = list("A" =  c("Glu+", "Glu+",
                       "Glu+", "Glu-", "Glu-", "Glu-"),
                       "B" = c("Glu+", "Glu+", "Glu-", "Glu-"),
                       "C" = c("Glu+", "Glu+", "Glu-", "Glu-")),
                       omicNames = c("RNA", "GRO", "RNA", "RIBO", "RNA", "PAR"),
                       commonOmic = "RNA")

my_final_mbac <- MultiBaC (my_mbac,
                           test.comp = NULL, scale = FALSE,
                           center = TRUE, crossval = NULL,
                           Variability = 0.90,
                           Interaction = TRUE ,
                           showplot = FALSE,
                           showinfo = FALSE)