Brief Overview
metasnf is a package that facilitates usage of the meta clustering paradigm described in (Caruana et al. 2006) with the similarity network fusion (SNF) data integration procedure developed in (Wang et al. 2014). The package offers a comprehensive suite of tools to assist users in transforming multi-modal tabular data into cluster solutions, decision making in the clustering process, and visualization along the way with a strong emphasis on context-specific utility and principled validation of results.
Installation
You will need R version 4.1.0 or higher to install this package. metasnf can be installed from CRAN:
install.packages("metasnf")Development versions can be installed from GitHub:
# Latest development version
devtools::install_github("BRANCHlab/metasnf")
# Install a specific tagged version
devtools::install_github("BRANCHlab/metasnf@v1.1.2")Quick Start
Minimal usage of the package looks like this:
# Load the package
library(metasnf)
# Setting up the data
data_list <- generate_data_list(
list(abcd_cort_t, "cortical_thickness", "neuroimaging", "continuous"),
list(abcd_cort_sa, "cortical_surface_area", "neuroimaging", "continuous"),
list(abcd_subc_v, "subcortical_volume", "neuroimaging", "continuous"),
list(abcd_income, "household_income", "demographics", "continuous"),
list(abcd_pubertal, "pubertal_status", "demographics", "continuous"),
uid = "patient"
)
#> Warning in generate_data_list(list(abcd_cort_t, "cortical_thickness",
#> "neuroimaging", : 200 subject(s) dropped due to incomplete data.
# Specifying 5 different sets of settings for SNF
set.seed(42)
settings_matrix <- generate_settings_matrix(
data_list,
nrow = 5,
max_k = 40
)
# This matrix has clustering solutions for each of the 5 SNF runs!
solutions_matrix <- batch_snf(data_list, settings_matrix)Check out the tutorial vignettes below to learn about how the package can be used:
And more tutorials can be found under the “articles” section of the documentation home page: https://branchlab.github.io/metasnf/index.html
Background
Why use meta clustering?
Clustering algorithms seek solutions where members of the same cluster are very similar to each other and members of distinct clusters are very dissimilar to each other. In sufficiently noisy datasets where many qualitatively distinct solutions with similar scores of clustering quality exist, it is not necessarily the case that the top solution selected by a clustering algorithm will also be the most useful one for the user’s context.
To address this issue, the original meta clustering procedure Caruana et al., 2006 involved generating a large number of reasonable clustering solutions, clustering those solutions into qualitatively similar ones, and having the user examine those “meta clusters” to find something that seems like it’ll be the most useful.
Why use SNF?
In the clinical data setting, we often have access to patient data across a wide range of domains, such as imaging, genetics, biomarkers, demographics. When trying to extract subtypes out of all this information, direct concatenation of the data followed by cluster analysis can result in a substantial amount of lost (valuable) signal contained in each individual domain. Empirically, SNF has been demonstrated to effectively integrate highly diverse patient data for the purposes of clinical subtyping.