Contents

1 Introduction and Background

MOMA is a tool for inferring connections between Master Regulator proteins and genomic driver events in cancer. Master regulators are regulatory proteins (primarily transcription factors and co-transcription factors) that control cell state. In the case of cancer and other disease states transcription factors have been shown to be key drivers of maintaining the disease state and can be targets for interventions. Often these master regulators are not mutated themselves but are downstream of mutations and other genomic alterations that ultimately dysregulate the normal activity of that regulator. MOMA uses multiple inputs of information to infer these connections and to improve the predictive value of the master regulator analysis.

For more information on Master Regulators and our tool for calculating their values see the paper published on VIPER in Nature Genetics in 2016 paper // package.


2 Running MOMA

2.1 Getting Started

First install and load the library into the R session. Make sure all the other dependent packages have already been installed to ensure full functionality, including graphics and plotting functions.

if (!requireNamespace("BiocManager", quietly = TRUE))
    install.packages("BiocManager")
BiocManager::install("MOMA")
library(MOMA)

Explore the test data saved in the MultiAssayExperiment object. Confirm that we have 50 test samples and 2505 VIPER inferred proteins in the test viper matrix. This was generated by using VIPER on the GBM gene expression signature. The matrix has the samples across the columns and the regulators in the rows.

The other assays needed for the experiment are:

  • SNP matrix: binary 0/1 values where 1 indicates the prescence of a mutation
  • CNV matrix: copy number variant values
  • Fusion matrix: binary 0/1 values (optional)
example.gbm.mae
#> A MultiAssayExperiment object of 3 listed
#>  experiments with user-defined names and respective classes.
#>  Containing an ExperimentList class object of length 3:
#>  [1] viper: matrix with 2505 rows and 50 columns
#>  [2] cnv: matrix with 598 rows and 50 columns
#>  [3] mut: matrix with 60 rows and 50 columns
#> Functionality:
#>  experiments() - obtain the ExperimentList instance
#>  colData() - the primary/phenotype DataFrame
#>  sampleMap() - the sample coordination DataFrame
#>  `$`, `[`, `[[` - extract colData columns, subset, or experiment
#>  *Format() - convert into a long or wide DataFrame
#>  assays() - convert ExperimentList to a SimpleList of matrices
#>  exportClass() - save data to flat files

MultiAssayExperiment::assays(example.gbm.mae)$viper[1:3, 1:3]
#>     TCGA-14-1825-01 TCGA-16-0846-01 TCGA-32-2634-01
#> 165      -3.0369845       0.5837581       -1.982579
#> 196      -2.4667300      -3.7642532       -1.941096
#> 257       0.7872116       0.3260199        1.683252

Next, we select the biological pathways we’d like to use to aid in our inference task. In this case, we’re using the CINDy modulator inference algorithm [paper] as well as protein-protein interactions predicted by the PrePPI structure-based algorithm [paper]. The output of the CINDy algorithm is a likelihood (p value) for the association of an upstream modulator with a particular regulators activity. The relevant output for PrePPI is a likelihood (p value) that a modulator structurally binds to a regulator.

To make the MOMA object they need to be a named list of lists, with the indexes of each being a regulator and their associated partners.

note: CINDy values are context specific and need to be obtained for a particular tissue/expression set. Values calculated from the tumor types in TCGA can be found [here] for use in applying this analysis to other datasets. The PREPPi values are not context specific and the values from this example analysis can be used with other datasets.

names(gbm.pathways)
#> [1] "cindy"  "preppi"

gbm.pathways$cindy[1:3]
#> $`55553`
#> 10000 
#>     1 
#> 
#> $`171023`
#>        10013        58484 
#> 5.257461e-06 1.000000e+00 
#> 
#> $`51295`
#>        10025        23370        51079         9546 
#> 1.000000e+00 3.995671e-06 3.995671e-06 7.360446e-06

2.2 Generating the MOMA object

Initialize the Moma object with the assays and pathway data in order to start the analysis. The required inputs are the following:

  • Assays: a MultiAssayExperiment object with the previously mentioned assays. Alternatively a named list with the assays as matrices can be supplied. In both cased the names of the assays must be “viper”, “cnv”, “mut” and “fusion”
  • Pathway list: see above

Other optional inputs include:

  • Gene Blacklist: genes to not include in the analysis. By default the Broad Institute’s list of highly mutated genes are excluded [link]
  • Output Folder : Directory to save results to.
  • Gene Map : Dataframe mapping Gene Names to Entrez IDs and Cytoband locations. One is already provided by default.
momaObj <- MomaConstructor(example.gbm.mae, gbm.pathways)
#> Found the following assays:viper, cnv, mut
#> Common samples across main assays: 50
#> Checking labels on pathway cindy
#> Found labels for 364 TFs in VIPER matrix
#> Checking labels on pathway preppi
#> Found labels for 2505 TFs in VIPER matrix

2.3 MOMA Analysis on GBM Data

The first step, runDIGGIT() will run the DIGGIT inference algorithm [paper] to find statistical interactions between VIPER-inferred proteins and genomic events.

The makeInteractions() function will infer robust computational predictions using all the provided data, including the Conditional Inference of Network Dynamics (CINDy) algorithm.

The Rank() function will create a final ranking of candidate Master Regulators for this cohort of patient samples.

momaObj$runDIGGIT()

momaObj$makeInteractions()

momaObj$Rank()

Clustering of the samples, using the protein ranks computed in the last step, can then be performed using Cluster(). Multiple cluster solutions will be calculated, ranging from 2 to 15 clusters by default. The reliability or average silhouette scores of each can be assessed to determine an optimal ‘k’ number of clusters. By default the clustering solution with the maximum reliability will be saved to the object, but any solution can be saved in afterwards.

momaObj$Cluster()
#> using pearson correlation with weighted vipermat
#> testing clustering options, k = 2..15
#> Using reliability scores to select best solution.
#> Best solution is: 6clusters

# Explore the reliability scores
momaObj$clustering.results$all.cluster.reliability
#>  2clusters  3clusters  4clusters  5clusters  6clusters  7clusters  8clusters 
#>  0.6144845  0.7529229  0.7456256  0.7775375  0.7907407  0.6766867  0.6616316 
#>  9clusters 10clusters 11clusters 12clusters 13clusters 14clusters 15clusters 
#>  0.6022523  0.5793794  0.5645946  0.5290190  0.5175175  0.5476476  0.5363463

# Save in the 3 cluster solution
momaObj$sample.clustering <- momaObj$clustering.results$`3clusters`$clustering

Genomic saturation analysis is then performed on each cluster with the saturationCalculation() function, allowing us to find the key proteins that are downstream of the majority of genomic events in the samples within a particular cluster. These regulators make up that cluster’s checkpoint.

The results of this analysis can be accessed directly in the following result fields:

  • momaObj$checkpoints
  • momaObj$genomic.saturation
  • momaObj$coverage.summaryStats

These will be used for plotting the genomic saturation curves as well.

momaObj$saturationCalculation()
cluster1.checkpoint <- momaObj$checkpoints[[1]]
print (cluster1.checkpoint[1:5])
#> [1] "5702"  "55170" "7014"  "23028" "29128"

3 Plotting the Results

3.1 Visualizing the VIPER matrix

The primary results of the analysis are the master regululators of each particular cluster’s checkpoint, as displayed above. You can plot the original VIPER matrix subset down to only these regulators using whatever heatmap function you like.

3.2 Visualizing the Genomic Saturation and Events Plots

The other important results of the analysis are the statisically significant genomic events found to be upstream of each of the checkpoint master regulators. The makeSaturationPlots() function takes the subtype specific genomic event interactions calculated in the previous step and makes plots for viewing the results. Because there are usually quite a large number of events that are detected only the most frequently occurring events will be plotted. (Note: to account for amplifications and deletions being events that can occur across multiple genes, these events are considered on a cytoband basis).

The two plot types are:

  • Genomic Event Oncoprint Plots : these plot the different types of genomic events found to be upstream of the regulators in the checkpoint, using the style of cBioPortal’s plotting. The samples in that cluster are in the columns and the rows are the top significant events to be plotted (max number can be changed). Summary bar plots are on the top and right side.
  • Saturation Curves : these plot the number of regulators needed to capture a certain percentage of genomic events. The inflection points plotted on this graph match up with the cut off for which regulators make up a particular cluster’s checkpoint.

The data for these plots are stored as grobs and ggplot objects so layers or other graphic modifications can be added afterwards for further customization.

library(ggplot2)
library(grid)
grid.draw(plots$oncoprint.plots[[3]])

plots$curve.plots[[3]] +
  ggtitle("Genomic Saturation Curve for GBM Subtype 3")

4 Saving Data

Any of the results fields can be saved by using the saveData() function. Pass in any of the names of the results fields and they will be saved to files in the designated output folder. If no names are passed all results will be saved.

momaObj$saveData(output.folder = "outputs", "hypotheses", "checkpoints")

5 Session Info

Here is the output of sessionInfo() on the system on which this package and documentation was compiled.

sessionInfo()
#> R Under development (unstable) (2023-10-22 r85388)
#> Platform: x86_64-pc-linux-gnu
#> Running under: Ubuntu 22.04.3 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      stats     graphics  grDevices utils     datasets  methods  
#> [8] base     
#> 
#> other attached packages:
#> [1] ggplot2_3.4.4    S4Vectors_0.41.0 IRanges_2.37.0   MOMA_1.15.0     
#> [5] BiocStyle_2.31.0
#> 
#> loaded via a namespace (and not attached):
#>  [1] tidyselect_1.2.0            farver_2.1.1               
#>  [3] dplyr_1.1.3                 bitops_1.0-7               
#>  [5] fastmap_1.1.1               RCurl_1.98-1.12            
#>  [7] digest_0.6.33               lifecycle_1.0.3            
#>  [9] cluster_2.1.4               Cairo_1.6-1                
#> [11] statmod_1.5.0               magrittr_2.0.3             
#> [13] compiler_4.4.0              rlang_1.1.1                
#> [15] sass_0.4.7                  tools_4.4.0                
#> [17] utf8_1.2.4                  yaml_2.3.7                 
#> [19] knitr_1.44                  labeling_0.4.3             
#> [21] S4Arrays_1.3.0              DelayedArray_0.29.0        
#> [23] plyr_1.8.9                  RColorBrewer_1.1-3         
#> [25] abind_1.4-5                 withr_2.5.1                
#> [27] purrr_1.0.2                 BiocGenerics_0.49.0        
#> [29] stats4_4.4.0                fansi_1.0.5                
#> [31] colorspace_2.1-0            scales_1.2.1               
#> [33] iterators_1.0.14            MultiAssayExperiment_1.29.0
#> [35] SummarizedExperiment_1.33.0 cli_3.6.1                  
#> [37] rmarkdown_2.25              crayon_1.5.2               
#> [39] generics_0.1.3              robustbase_0.99-0          
#> [41] reshape2_1.4.4              tzdb_0.4.0                 
#> [43] rjson_0.2.21                BiocBaseUtils_1.5.0        
#> [45] qvalue_2.35.0               cachem_1.0.8               
#> [47] stringr_1.5.0               zlibbioc_1.49.0            
#> [49] splines_4.4.0               parallel_4.4.0             
#> [51] BiocManager_1.30.22         XVector_0.43.0             
#> [53] matrixStats_1.0.0           vctrs_0.6.4                
#> [55] Matrix_1.6-1.1              jsonlite_1.8.7             
#> [57] bookdown_0.36               hms_1.1.3                  
#> [59] GetoptLong_1.0.5            clue_0.3-65                
#> [61] magick_2.8.1                foreach_1.5.2              
#> [63] limma_3.59.0                tidyr_1.3.0                
#> [65] jquerylib_0.1.4             glue_1.6.2                 
#> [67] DEoptimR_1.1-3              MKmisc_1.9                 
#> [69] codetools_0.2-19            stringi_1.7.12             
#> [71] shape_1.4.6                 gtable_0.3.4               
#> [73] GenomeInfoDb_1.39.0         GenomicRanges_1.55.0       
#> [75] ComplexHeatmap_2.19.0       munsell_0.5.0              
#> [77] tibble_3.2.1                pillar_1.9.0               
#> [79] htmltools_0.5.6.1           GenomeInfoDbData_1.2.11    
#> [81] circlize_0.4.15             R6_2.5.1                   
#> [83] doParallel_1.0.17           lattice_0.22-5             
#> [85] evaluate_0.22               Biobase_2.63.0             
#> [87] readr_2.1.4                 png_0.1-8                  
#> [89] bslib_0.5.1                 Rcpp_1.0.11                
#> [91] SparseArray_1.3.0           xfun_0.40                  
#> [93] MatrixGenerics_1.15.0       pkgconfig_2.0.3            
#> [95] GlobalOptions_0.1.2