The iPath User’s Guide
24 October 2023
Abstract
This vignette introduces the usage of the Bioconductor package iPath (individualized pathway analysis), which is capable of identifying highly predictive biomarkers for clinical outcomes. It includes two major steps: calculating the personalized iES for each sample and each pathway, and investigating whether stratified tumor samples are associated with clinical. Here, we introduce iPath, or individual-level pathway analysis, to quantify the magnitude of alteration occurring for a particular pathway at the individual sample level. Our goal is to understand cancer one tumor sample at a time outcomes.
Package
iPath 1.8.0
1 Installation and help
1.1 Install iPath
To install this package, start R (version > “4.0”) and enter:
if(!requireNamespace("BiocManager", quietly = TRUE))
install.packages("BiocManager")
BiocManager::install("iPath")1.2 Help for iPath
If you have any iPath-related questions, please post to the GitHub Issue section of iPath at https://github.com/suke18/iPath/issues, which will be helpful for the construction of iPath.
2 Introduction
2.1 Background
Identifying biomarkers to predict the clinical outcomes of individual patients is a fundamental problem in clinical oncology. Multiple single-gene biomarkers have already been identified and used in the clinics. However, multiple oncogenes or tumor-suppressor genes are involved during the process of tumorigenesis. Additionally, the efficacy of single-gene biomarkers is limited by the extensively variable expression levels measured by high-throughput assays. In this study, we hypothesize that in individual tumor samples, the disruption of transcription homeostasis in key pathways or gene set plays an important role in tumorigenesis and has profound implications for the patient’s clinical outcome. We devised a computational method named iPath to identify, at the individual sample level, which pathways or gene sets significantly deviate from their norms. We conducted a pan-cancer analysis and demonstrated that iPath is capable of identifying highly predictive biomarkers for clinical outcomes, including overall survival, tumor subtypes, and tumor stage classifications.
2.2 Citation
- For using (iPath) feature selection procedure, DOI is 10.1016/j.crmeth.2021.100050
- For downloading TCGA dataset, https://www.bioconductor.org/packages/release/bioc/html/RTCGA.html
3 Calculate iES
iPath requires an normalized expression matrix with rows representing the genes and columns representing the samples. To preprocess the expression matrix, iPath filters out the genes depending on standard deviations (sd). Here, we sampled PRAD TCGA dataset for illustration. It is noted that iPath requires a gene set database (GSDB) as another input, which can be obtained by the MSigDB database.
3.1 Load the data
The PRAD_data dataset is loaded with three objects including the RPKM expression matrix (prad_exprs), corresponding phenotype information (prad_inds). prad_inds is the binary vector with 0 representing normal and 1 representing tumor sample, and simulated clinical dataset (prad_cli).
library(iPath)
data(PRAD_data)
dim(prad_exprs)
data(GSDB_example)
head(prad_cli)3.2 Calculate iES per sample per pathway
The core of iPath is to calculate the iES score for each patient and pathway. The function iES_cal2 requires two input an expression matrix and gene set database (GSDB). The returned matrix contains iES with rows corresponding to the pathways and columns corresponding to the samples.
iES_mat = iES_cal2(Y = prad_exprs, GSDB = GSDB_example)
iES_mat[1:2, 1:4]4 Test association with survival outcomes
After computing iES matrix, it is important to investigate whether the classified normal-like and perturbed groups exist significance different in terms of survival outcomes. To perform the classifcaiton in tumor samples, we use normal sampels as reference by fiting a Guassian Mixture. The investigation is conducted for each individual pathway. iES_surv function inputs the iES matrix from the iES_cal2 step, the clinical data, and the binary vector indicating the patient phenotypes; for example, 0 represents normal sample and 1 represents tumor sample.
surv_outcomes = iES_surv(iES_mat = iES_mat, cli = prad_cli, indVec = prad_inds)
#> Warning in coxph.fit(X, Y, istrat, offset, init, control, weights = weights, :
#> Loglik converged before variable 1 ; coefficient may be infinite.
head(surv_outcomes)
#> nPerturb c-index coef pval
#> SimPathway1 8 0.5418719 -0.6874565 0.5041147
#> SimPathway2 5 0.5615764 -18.2110687 0.1970832
#> SimPathway3 11 0.4802956 -0.2586764 0.73862785 Data visualization
5.1 waterfall
We also provide two forms of visualization for iES scores. One is the waterfall plot ranked from the smallest to the largest.
water_fall(iES_mat, gs_str = "SimPathway2", indVec = prad_inds)
density_fall(iES_mat, gs_str = "SimPathway2", indVec = prad_inds)
5.2 one survival outcomes
iES_survPlot(iES_mat = iES_mat, cli = prad_cli, gs_str = "SimPathway1", indVec = prad_inds, title = TRUE)
6 Session Info
sessionInfo()
#> R version 4.3.1 (2023-06-16)
#> Platform: x86_64-pc-linux-gnu (64-bit)
#> Running under: Ubuntu 22.04.3 LTS
#>
#> Matrix products: default
#> BLAS: /home/biocbuild/bbs-3.18-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] stats graphics grDevices utils datasets methods base
#>
#> other attached packages:
#> [1] iPath_1.8.0 survival_3.5-7 BiocParallel_1.36.0
#> [4] mclust_6.0.0 BiocStyle_2.30.0
#>
#> loaded via a namespace (and not attached):
#> [1] gtable_0.3.4 xfun_0.40 bslib_0.5.1
#> [4] ggplot2_3.4.4 rstatix_0.7.2 lattice_0.22-5
#> [7] vctrs_0.6.4 tools_4.3.1 generics_0.1.3
#> [10] parallel_4.3.1 tibble_3.2.1 fansi_1.0.5
#> [13] pkgconfig_2.0.3 Matrix_1.6-1.1 data.table_1.14.8
#> [16] lifecycle_1.0.3 farver_2.1.1 compiler_4.3.1
#> [19] munsell_0.5.0 codetools_0.2-19 carData_3.0-5
#> [22] htmltools_0.5.6.1 sass_0.4.7 yaml_2.3.7
#> [25] pillar_1.9.0 car_3.1-2 ggpubr_0.6.0
#> [28] jquerylib_0.1.4 tidyr_1.3.0 cachem_1.0.8
#> [31] survminer_0.4.9 magick_2.8.1 abind_1.4-5
#> [34] km.ci_0.5-6 tidyselect_1.2.0 digest_0.6.33
#> [37] dplyr_1.1.3 purrr_1.0.2 bookdown_0.36
#> [40] labeling_0.4.3 splines_4.3.1 fastmap_1.1.1
#> [43] grid_4.3.1 colorspace_2.1-0 cli_3.6.1
#> [46] magrittr_2.0.3 utf8_1.2.4 broom_1.0.5
#> [49] withr_2.5.1 scales_1.2.1 backports_1.4.1
#> [52] rmarkdown_2.25 matrixStats_1.0.0 gridExtra_2.3
#> [55] ggsignif_0.6.4 zoo_1.8-12 evaluate_0.22
#> [58] knitr_1.44 KMsurv_0.1-5 survMisc_0.5.6
#> [61] rlang_1.1.1 Rcpp_1.0.11 xtable_1.8-4
#> [64] glue_1.6.2 BiocManager_1.30.22 jsonlite_1.8.7
#> [67] R6_2.5.1