if (!require("BiocManager")) {
install.packages("BiocManager")
}
BiocManager::install("glmSparseNet")
library(dplyr)
library(Matrix)
library(ggplot2)
library(forcats)
library(parallel)
library(reshape2)
library(survival)
library(VennDiagram)
library(futile.logger)
library(curatedTCGAData)
library(MultiAssayExperiment)
library(TCGAutils)
#
library(glmSparseNet)
#
#
# Some general options for futile.logger the debugging package
flog.layout(layout.format("[~l] ~m"))
options(
"glmSparseNet.show_message" = FALSE,
"glmSparseNet.base_dir" = withr::local_tempdir()
)
# Setting ggplot2 default theme as minimal
theme_set(ggplot2::theme_minimal())
This vignette uses the STRING database (https://string-db.org/) of protein-protein interactions as the network-based penalizer in generalized linear models using Breast invasive carcinoma sample dataset.
The degree vector is calculated manually to account for genes that are not present in the STRING database, as these will not have any interactions, i.e. edges.
Retrieve all interactions from STRING databse. We have included a helper function that retrieves the Homo sapiens known interactions.
For this vignette, we use a cached version of all interaction with
score_threshold = 700
Note: Text-based interactions are excluded from the network.
# Not evaluated in vignette as it takes too long to download and process
allInteractions700 <- stringDBhomoSapiens(scoreThreshold = 700)
stringNetwork <- buildStringNetwork(allInteractions700, "external")
Build a sparse matrix object that contains the network.
stringNetworkUndirected <- stringNetwork + Matrix::t(stringNetwork)
stringNetworkUndirected <- (stringNetworkUndirected != 0) * 1
## [INFO] Directed graph (score_threshold = 700)
## [INFO] * total edges: 225330
## [INFO] * unique protein: 11033
## [INFO] * edges per protein: 20.423276
## [INFO]
## [INFO] Undirected graph (score_threshold = 700)
## [INFO] * total edges: 225209
## [INFO] * unique protein: 11033
## [INFO] * edges per protein: 20.412309
## [INFO] Summary of degree:
##
## Min. 1st Qu. Median Mean 3rd Qu. Max.
## 1.00 3.00 13.00 40.83 43.00 4175.00
qplot(
degreeNetworkVector[
degreeNetworkVector <= quantile(degreeNetworkVector, probs = .99999)
],
geom = "histogram", fill = my.colors(2), bins = 100
) +
theme(legend.position = "none") + xlab("Degree (up until 99.999% quantile)")
glmSparseNet
brca <- curatedTCGAData(
diseaseCode = "BRCA", assays = "RNASeq2GeneNorm",
version = "1.1.38", dry.run = FALSE
)
Build the survival data from the clinical columns.
xdata
and ydata
# keep only solid tumour (code: 01)
brcaPrimarySolidTumor <- TCGAutils::TCGAsplitAssays(brca, "01")
xdataRaw <- t(assay(brcaPrimarySolidTumor[[1]]))
# Get survival information
ydataRaw <- colData(brcaPrimarySolidTumor) |>
as.data.frame() |>
# Convert days to integer
dplyr::mutate(
Days.to.date.of.Death = as.integer(Days.to.date.of.Death),
Days.to.Last.Contact = as.integer(Days.to.Date.of.Last.Contact)
) |>
# Find max time between all days (ignoring missings)
dplyr::rowwise() |>
dplyr::mutate(
time = max(days_to_last_followup, Days.to.date.of.Death,
Days.to.Last.Contact, days_to_death,
na.rm = TRUE
)
) |>
# Keep only survival variables and codes
dplyr::select(patientID, status = vital_status, time) |>
# Discard individuals with survival time less or equal to 0
dplyr::filter(!is.na(time) & time > 0) |>
as.data.frame()
# Set index as the patientID
rownames(ydataRaw) <- ydataRaw$patientID
# keep only features that are in degreeNetworkVector and have
# standard deviation > 0
validFeatures <- colnames(xdataRaw)[
colnames(xdataRaw) %in% names(degreeNetworkVector[degreeNetworkVector > 0])
]
xdataRaw <- xdataRaw[
TCGAbarcode(rownames(xdataRaw)) %in% rownames(ydataRaw), validFeatures
]
xdataRaw <- scale(xdataRaw)
# Order ydata the same as assay
ydataRaw <- ydataRaw[TCGAbarcode(rownames(xdataRaw)), ]
# Using only a subset of genes previously selected to keep this short example.
set.seed(params$seed)
smallSubset <- c(
"AAK1", "ADRB1", "AK7", "ALK", "APOBEC3F", "ARID1B", "BAMBI",
"BRAF", "BTG1", "CACNG8", "CASP12", "CD5", "CDA", "CEP72",
"CPD", "CSF2RB", "CSN3", "DCT", "DLG3", "DLL3", "DPP4",
"DSG1", "EDA2R", "ERP27", "EXD1", "GABBR2", "GADD45A",
"GBP1", "HTR1F", "IFNK", "IRF2", "IYD", "KCNJ11", "KRTAP5-6",
"MAFA", "MAGEB4", "MAP2K6", "MCTS1", "MMP15", "MMP9",
"NFKBIA", "NLRC4", "NT5C1A", "OPN4", "OR13C5", "OR13C8",
"OR2T6", "OR4K2", "OR52E6", "OR5D14", "OR5H1", "OR6C4",
"OR7A17", "OR8J3", "OSBPL1A", "PAK6", "PDE11A", "PELO",
"PGK1", "PIK3CB", "PMAIP1", "POLR2B", "POP1", "PPFIA3",
"PSME1", "PSME2", "PTEN", "PTGES3", "QARS", "RABGAP1",
"RBM3", "RFC3", "RGPD8", "RPGRIP1L", "SAV1", "SDC1", "SDC3",
"SEC16B", "SFPQ", "SFRP5", "SIPA1L1", "SLC2A14", "SLC6A9",
"SPATA5L1", "SPINT1", "STAR", "STXBP5", "SUN3", "TACC2",
"TACR1", "TAGLN2", "THPO", "TNIP1", "TP53", "TRMT2B", "TUBB1",
"VDAC1", "VSIG8", "WNT3A", "WWOX", "XRCC4", "YME1L1",
"ZBTB11", "ZSCAN21"
) |>
sample(size = 50) |>
sort()
# make sure we have 100 genes
smallSubset <- c(smallSubset, sample(colnames(xdataRaw), 51)) |>
unique() |>
sort()
xdata <- xdataRaw[, smallSubset[smallSubset %in% colnames(xdataRaw)]]
ydata <- ydataRaw |>
dplyr::select(time, status) |>
dplyr::filter(!is.na(time) | time < 0)
#
# Add degree 0 to genes not in STRING network
myDegree <- degreeNetworkVector[smallSubset]
myString <- stringNetworkBinary[smallSubset, smallSubset]
Degree distribution for sample set of gene features (in xdata).
set.seed(params$seed)
foldid <- glmSparseNet:::balancedCvFolds(ydata$status)$output
Penalizes using the Hub heuristics, see hubHeuristic
function definition for
more details.
resultCVHub <- cv.glmHub(xdata,
Surv(ydata$time, ydata$status),
family = "cox",
foldid = foldid,
network = myString,
network.options = networkOptions(minDegree = 0.2)
)
Kaplan-Meier estimator separating individuals by low and high risk (based on model’s coefficients)
## Warning: The `plot.title` argument of `separate2GroupsCox()` is deprecated as of
## glmSparseNet 1.21.0.
## ℹ Please use the `plotTitle` argument instead.
## This warning is displayed once every 8 hours.
## Call `lifecycle::last_lifecycle_warnings()` to see where this warning was
## generated.
## Warning: The `legend.outside` argument of `separate2GroupsCox()` is deprecated as of
## glmSparseNet 1.21.0.
## ℹ Please use the `legendOutside` argument instead.
## This warning is displayed once every 8 hours.
## Call `lifecycle::last_lifecycle_warnings()` to see where this warning was
## generated.
## $pvalue
## [1] 9.628346e-05
##
## $plot
##
## $km
## Call: survfit(formula = survival::Surv(time, status) ~ group, data = prognosticIndexDf)
##
## n events median 0.95LCL 0.95UCL
## Low risk - 1 983 129 3959 3738 7455
## High risk - 1 97 23 2911 2469 NA
Penalizes using the Orphan heuristics, see orphanHeuristic
function
definition for more details.
resultCVOrphan <- cv.glmOrphan(xdata,
Surv(ydata$time, ydata$status),
family = "cox",
foldid = foldid,
network = myString,
network.options = networkOptions(minDegree = 0.2)
)
Kaplan-Meier estimator separating individuals by low and high risk (based on model’s coefficients)
## $pvalue
## [1] 0
##
## $plot
##
## $km
## Call: survfit(formula = survival::Surv(time, status) ~ group, data = prognosticIndexDf)
##
## n events median 0.95LCL 0.95UCL
## Low risk - 1 540 34 7455 6456 NA
## High risk - 1 540 118 2866 2573 3472
Uses regular glmnet model as simple baseline
library(glmnet)
## Loaded glmnet 4.1-8
resultCVGlmnet <- cv.glmnet(xdata,
Surv(ydata$time, ydata$status),
family = "cox",
foldid = foldid
)
Kaplan-Meier estimator separating individuals by low and high risk (based on model’s coefficients)
## $pvalue
## [1] 0
##
## $plot
##
## $km
## Call: survfit(formula = survival::Surv(time, status) ~ group, data = prognosticIndexDf)
##
## n events median 0.95LCL 0.95UCL
## Low risk - 1 540 38 6593 4398 NA
## High risk - 1 540 114 2854 2551 3461
Venn diagram of overlapping genes.
Descriptive table showing which genes are selected in each model
We can observe, that elastic net without network-based penalization selects the best model with 40% more genes than glmOrphan and glmHub, without loosing accuracy.
note: size of circles represent the degree of that gene in network.
sessionInfo()
## R version 4.4.0 beta (2024-04-15 r86425)
## Platform: x86_64-pc-linux-gnu
## Running under: Ubuntu 22.04.4 LTS
##
## Matrix products: default
## BLAS: /home/biocbuild/bbs-3.19-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_US.UTF-8 LC_COLLATE=en_US.UTF-8
## [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] grid parallel stats4 stats graphics grDevices utils
## [8] datasets methods base
##
## other attached packages:
## [1] glmnet_4.1-8 VennDiagram_1.7.3
## [3] reshape2_1.4.4 forcats_1.0.0
## [5] Matrix_1.7-0 glmSparseNet_1.22.0
## [7] TCGAutils_1.24.0 curatedTCGAData_1.25.4
## [9] MultiAssayExperiment_1.30.0 SummarizedExperiment_1.34.0
## [11] Biobase_2.64.0 GenomicRanges_1.56.0
## [13] GenomeInfoDb_1.40.0 IRanges_2.38.0
## [15] S4Vectors_0.42.0 BiocGenerics_0.50.0
## [17] MatrixGenerics_1.16.0 matrixStats_1.3.0
## [19] futile.logger_1.4.3 survival_3.6-4
## [21] ggplot2_3.5.1 dplyr_1.1.4
## [23] BiocStyle_2.32.0
##
## loaded via a namespace (and not attached):
## [1] jsonlite_1.8.8 shape_1.4.6.1
## [3] magrittr_2.0.3 magick_2.8.3
## [5] GenomicFeatures_1.56.0 farver_2.1.1
## [7] rmarkdown_2.26 BiocIO_1.14.0
## [9] zlibbioc_1.50.0 vctrs_0.6.5
## [11] memoise_2.0.1 Rsamtools_2.20.0
## [13] RCurl_1.98-1.14 rstatix_0.7.2
## [15] tinytex_0.50 progress_1.2.3
## [17] htmltools_0.5.8.1 S4Arrays_1.4.0
## [19] BiocBaseUtils_1.6.0 AnnotationHub_3.12.0
## [21] lambda.r_1.2.4 curl_5.2.1
## [23] broom_1.0.5 pROC_1.18.5
## [25] SparseArray_1.4.0 sass_0.4.9
## [27] bslib_0.7.0 plyr_1.8.9
## [29] httr2_1.0.1 zoo_1.8-12
## [31] futile.options_1.0.1 cachem_1.0.8
## [33] GenomicAlignments_1.40.0 mime_0.12
## [35] lifecycle_1.0.4 iterators_1.0.14
## [37] pkgconfig_2.0.3 R6_2.5.1
## [39] fastmap_1.1.1 GenomeInfoDbData_1.2.12
## [41] digest_0.6.35 colorspace_2.1-0
## [43] AnnotationDbi_1.66.0 ps_1.7.6
## [45] ExperimentHub_2.12.0 RSQLite_2.3.6
## [47] ggpubr_0.6.0 labeling_0.4.3
## [49] filelock_1.0.3 km.ci_0.5-6
## [51] fansi_1.0.6 httr_1.4.7
## [53] abind_1.4-5 compiler_4.4.0
## [55] bit64_4.0.5 withr_3.0.0
## [57] backports_1.4.1 BiocParallel_1.38.0
## [59] carData_3.0-5 DBI_1.2.2
## [61] highr_0.10 ggsignif_0.6.4
## [63] biomaRt_2.60.0 rappdirs_0.3.3
## [65] DelayedArray_0.30.0 rjson_0.2.21
## [67] tools_4.4.0 chromote_0.2.0
## [69] glue_1.7.0 restfulr_0.0.15
## [71] promises_1.3.0 checkmate_2.3.1
## [73] generics_0.1.3 gtable_0.3.5
## [75] KMsurv_0.1-5 tzdb_0.4.0
## [77] tidyr_1.3.1 survminer_0.4.9
## [79] websocket_1.4.1 data.table_1.15.4
## [81] hms_1.1.3 car_3.1-2
## [83] xml2_1.3.6 utf8_1.2.4
## [85] XVector_0.44.0 BiocVersion_3.19.1
## [87] foreach_1.5.2 pillar_1.9.0
## [89] stringr_1.5.1 later_1.3.2
## [91] splines_4.4.0 BiocFileCache_2.12.0
## [93] lattice_0.22-6 rtracklayer_1.64.0
## [95] bit_4.0.5 tidyselect_1.2.1
## [97] Biostrings_2.72.0 knitr_1.46
## [99] gridExtra_2.3 bookdown_0.39
## [101] xfun_0.43 stringi_1.8.3
## [103] UCSC.utils_1.0.0 yaml_2.3.8
## [105] evaluate_0.23 codetools_0.2-20
## [107] tibble_3.2.1 BiocManager_1.30.22
## [109] cli_3.6.2 xtable_1.8-4
## [111] munsell_0.5.1 processx_3.8.4
## [113] jquerylib_0.1.4 survMisc_0.5.6
## [115] Rcpp_1.0.12 GenomicDataCommons_1.28.0
## [117] dbplyr_2.5.0 png_0.1-8
## [119] XML_3.99-0.16.1 readr_2.1.5
## [121] blob_1.2.4 prettyunits_1.2.0
## [123] bitops_1.0-7 scales_1.3.0
## [125] purrr_1.0.2 crayon_1.5.2
## [127] rlang_1.1.3 KEGGREST_1.44.0
## [129] rvest_1.0.4 formatR_1.14