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

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.7386278

5 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