Here, we describe the workflow to run variance-sensitive clustering on data stored in a SummarizedExperiment, QFeatures or MultiAssayExperiment object. This vignette is distributed under a CC BY-SA license.
vsclust 1.2.0
For a more detailed explanation of the VSClust function and the workflow, please take a look on the vignette for running the VSClust workflow.
Here, we present an example script to integrate the clustering with data object
from Bioconductor, such as QFeatures
, SummarizedExperiment
and
MultiAssayExperiment
.
Use the common Bioconductor commands for installation:
if (!require("BiocManager", quietly = TRUE))
install.packages("BiocManager")
BiocManager::install("vsclust")
The full functionality can be obtained by additionally installing and loading the
packages yaml
, shiny
, clusterProfiler
, and matrixStats
.
Here, we define the different parameters for the data set RNASeq2GeneNorm
from
the miniACC
object.
The number of replicates and experimental conditions will be retrieved automatically by specifying the metadata for the grouping.
#### Input parameters, only read when now parameter file was provided #####
## All principal parameters for running VSClust can be defined as in the
## shiny app at computproteomics.bmb.sdu.dk/Apps/VSClust
# name of study
Experiment <- "miniACC"
# Paired or unpaired statistical tests when carrying out LIMMA for
# statistical testing
isPaired <- FALSE
# Number of threads to accelerate the calculation (use 1 in doubt)
cores <- 1
# If 0 (default), then automatically estimate the cluster number for the
# vsclust run from the Minimum Centroid Distance
PreSetNumClustVSClust <- 0
# If 0 (default), then automatically estimate the cluster number for the
# original fuzzy c-means from the Minimum Centroid Distance
PreSetNumClustStand <- 0
# max. number of clusters when estimating the number of clusters.
# Higher numbers can drastically extend the computation time.
maxClust <- 10
At first, we load will log-transform the original data and normalize it to the median. Statistical testing will be applied on the resulting object. After estimating the standard deviations, the matrix consists of the averaged quantitative feature values and a last column for the standard deviations of the features.
We will separate the samples according to their OncoSign
.
data(miniACC, package="MultiAssayExperiment")
# log-transformation and remove of -Inf values
logminiACC <- log2(assays(miniACC)$RNASeq2GeneNorm)
logminiACC[!is.finite(logminiACC)] <- NA
# normalize to median
logminiACC <- t(t(logminiACC) - apply(logminiACC, 2, median, na.rm=TRUE))
miniACC2 <- c(miniACC, log2rnaseq = logminiACC, mapFrom=1L)
## Warning: Assuming column order in the data provided
## matches the order in 'mapFrom' experiment(s) colnames
boxplot(logminiACC)
#### running statistical analysis and estimation of individual variances
statOut <- PrepareSEForVSClust(miniACC2, "log2rnaseq",
coldatname = "OncoSign",
isPaired=isPaired, isStat=TRUE)
## -- The following categories will be used as experimental
## conditions:
## CN2
## TP53/NF1
## TERT/ZNRF3
## CN1
## Unclassified
## NA
## CTNNB1
## -- Extracted NumReps: 21 and NumCond: 7
We can see that there is no good separation of cancer signatures on the PCA plot.
There is no simple way to find the optimal number of clusters in a data set. For obtaining this number, we run the clustering for different cluster numbers and evaluate them via so-called validity indices, which provide information about suitable cluster numbers. VSClust uses mainly the “Maximum centroid distances” that denotes the shortest distance between any of the centroids. Alternatively, one can inspect the Xie Beni index.
The output of estimClustNum
contains the suggestion for the number of
clusters.
We further visualize the outcome.
#### Estimate number of clusters with maxClust as maximum number clusters to run
#### the estimation with
ClustInd <- estimClustNum(statOut$dat, maxClust=maxClust, cores=cores)
## Running cluster number 3
## Running cluster number 4
## Running cluster number 5
## Running cluster number 6
## Running cluster number 7
## Running cluster number 8
## Running cluster number 9
## Running cluster number 10
#### Use estimate cluster number or use own
if (PreSetNumClustVSClust == 0)
PreSetNumClustVSClust <- optimalClustNum(ClustInd)
if (PreSetNumClustStand == 0)
PreSetNumClustStand <- optimalClustNum(ClustInd, method="FCM")
#### Visualize
estimClust.plot(ClustInd)
Both validity indices agree with each other and suggest 7 as the most reasonable estimate for the cluster number. However, we can also see that this decreases the number of clustered features quite drastically from over 150 to about 90.
Now we run the clustering again with the optimal parameters from the estimation. One can take alternative numbers of clusters corresponding to large decays in the Minimum Centroid Distance or low values of the Xie Beni index.
First, we carry out the variance-sensitive method
#### Run clustering (VSClust and standard fcm clustering
ClustOut <- runClustWrapper(statOut$dat,
PreSetNumClustVSClust, NULL,
VSClust=TRUE,
cores=cores)
Bestcl <- ClustOut$Bestcl
VSClust_cl <- Bestcl
We see how different groups of genes show distinctive pattern of their expression in different oncological signatures.
sessionInfo()
## R version 4.3.0 RC (2023-04-13 r84269)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 22.04.2 LTS
##
## Matrix products: default
## BLAS: /home/biocbuild/bbs-3.17-bioc/R/lib/libRblas.so
## LAPACK: /usr/lib/x86_64-linux-gnu/lapack/liblapack.so.3.10.0
##
## locale:
## [1] LC_CTYPE=en_US.UTF-8 LC_NUMERIC=C
## [3] LC_TIME=en_GB LC_COLLATE=C
## [5] LC_MONETARY=en_US.UTF-8 LC_MESSAGES=en_US.UTF-8
## [7] LC_PAPER=en_US.UTF-8 LC_NAME=C
## [9] LC_ADDRESS=C LC_TELEPHONE=C
## [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C
##
## time zone: America/New_York
## tzcode source: system (glibc)
##
## attached base packages:
## [1] stats4 stats graphics grDevices utils datasets methods
## [8] base
##
## other attached packages:
## [1] MultiAssayExperiment_1.26.0 SummarizedExperiment_1.30.0
## [3] Biobase_2.60.0 GenomicRanges_1.52.0
## [5] GenomeInfoDb_1.36.0 IRanges_2.34.0
## [7] S4Vectors_0.38.0 BiocGenerics_0.46.0
## [9] MatrixGenerics_1.12.0 matrixStats_0.63.0
## [11] vsclust_1.2.0 BiocStyle_2.28.0
##
## loaded via a namespace (and not attached):
## [1] gtable_0.3.3 xfun_0.39 bslib_0.4.2
## [4] ggplot2_3.4.2 lattice_0.21-8 vctrs_0.6.2
## [7] tools_4.3.0 bitops_1.0-7 generics_0.1.3
## [10] parallel_4.3.0 tibble_3.2.1 fansi_1.0.4
## [13] highr_0.10 BiocBaseUtils_1.2.0 pkgconfig_2.0.3
## [16] Matrix_1.5-4 lifecycle_1.0.3 GenomeInfoDbData_1.2.10
## [19] compiler_4.3.0 stringr_1.5.0 munsell_0.5.0
## [22] httpuv_1.6.9 htmltools_0.5.5 sass_0.4.5
## [25] RCurl_1.98-1.12 yaml_2.3.7 later_1.3.0
## [28] pillar_1.9.0 jquerylib_0.1.4 ellipsis_0.3.2
## [31] DelayedArray_0.26.0 cachem_1.0.7 limma_3.56.0
## [34] magick_2.7.4 mime_0.12 tidyselect_1.2.0
## [37] digest_0.6.31 stringi_1.7.12 dplyr_1.1.2
## [40] reshape2_1.4.4 bookdown_0.33 splines_4.3.0
## [43] fastmap_1.1.1 grid_4.3.0 colorspace_2.1-0
## [46] cli_3.6.1 magrittr_2.0.3 utf8_1.2.3
## [49] promises_1.2.0.1 scales_1.2.1 rmarkdown_2.21
## [52] XVector_0.40.0 qvalue_2.32.0 shiny_1.7.4
## [55] evaluate_0.20 knitr_1.42 rlang_1.1.0
## [58] Rcpp_1.0.10 xtable_1.8-4 glue_1.6.2
## [61] BiocManager_1.30.20 jsonlite_1.8.4 R6_2.5.1
## [64] plyr_1.8.8 zlibbioc_1.46.0