You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This package provides a common interface to run 45 deconvolution methods.
Installation
This package requires R version 4.0 or later.
We run each deconvolution in a separate container.
Therefore, a container engine (i.e., docker or singularity) needs to be installed.
To check ifdocker or singularity is installed and R can communicate with it, run:
if (!requireNamespace("babelwhale", quietly=TRUE)) {
install.packages("babelwhale")
}
# For dockerbabelwhale::test_docker_installation(detailed=TRUE)
# OR for singularity, make sure singularity binary is in PATHbabelwhale::test_singularity_installation(detailed=TRUE)
Install DeconBenchmark
if (!requireNamespace("devtools", quietly=TRUE)) {
install.packages("devtools")
}
devtools::install_github("tinnlab/DeconBenchmark")
library(DeconBenchmark)
Supported methods
List of supported methods, their required inputs beside bulk data and their original package.
The dockerfile for each method is located in the DeconBenchmark-docker repository.
Please cite the original publications if you use the methods in your work.
Examples
Get the list of all available methods.
allSupportMethods<- getSupportedMethods() # Get the list of supported methods
print(allSupportMethods)
Select methods to run and get their required inputs.
methodsToRun<- c("ReFACTor", "scaden", "DeconRNASeq") # Select methods to run (must be in the list of supported methods)# Get the required inputs for each method. # ContainerEngine is "docker" by default. Change containerEngine to "singularity" if you want to use singularity insteadrequiredInputs<- getMethodsInputs(methodsToRun, containerEngine="docker")
print(requiredInputs) # list(ReFACTor = c("bulk", "nCellTypes"), scaden = c("bulk", "singleCellExpr", "singleCellLabels"), DeconRNASeq = c("bulk", "signature"))
Load example data
data(BloodExample) # Load example data
print(names(BloodExample)) # c("bulk", "singleCellExpr", "singleCellLabels")bulk<-BloodExample$bulk
BayesCCE, Deblender, and DecOT require a MATLAB license to run.
Visit the Matlab license center at https://www.mathworks.com/licensecenter/licenses to obtain a license file.
The hostid of this license is the same as the hostid of the host machine.
If docker is used, the user of this license must be root.
If singularity is used, the user of this license is the same as the user of the host machine.
To run these methods, pass matlabLicenseFile=PATH_TO_YOUR_MATLAB_LICENSE as an argument to runDeconvolution.