1. Overview

This vignette is the fifth chapter in the “Pathway Significance Testing with pathwayPCA” workflow, providing a detailed perspective to the Inspect Results section of the Quickstart Guide. This vignette will discuss graphing the pathway-specific \(p\)-values, FDR values, and associated log-scores. Also, we will discuss how to plot the gene- or protein-specific loadings within a certain pathway and further how to plot the correlation between a gene or protein within a pathway and the principal component representing that pathway.

Before we move on, we will outline our steps. After reading this vignette, you should be able to

Plot the log-score rank of the top pathways.
Plot the feature loadings for a single pathway.
Plot the correlations between a pathway principal component and the features within that pathway.

1.1 Packages

First, load the pathwayPCA package and the tidyverse package suite.

library(tidyverse)
library(pathwayPCA)

1.2 Example Results

First, we will replicate the data setup from the previous vignette chapters on importing data and creating data objects ( Chapter 2: Import and Tidy Data and Chapter 3: Creating -Omics Data Objects, respectively). See these chapters for detailed explination of the code below.

# Load Data: see Chapter 2
data("colonSurv_df")
data("colon_pathwayCollection")

# Create -Omics Container: see Chapter 3
colon_OmicsSurv <- CreateOmics(
  assayData_df = colonSurv_df[, -(2:3)],
  pathwayCollection_ls = colon_pathwayCollection,
  response = colonSurv_df[, 1:3],
  respType = "surv"
)
#> 
#>   ======  Creating object of class OmicsSurv  =======
#> The input pathway database included 676 unique features.
#> The input assay dataset included 656 features.
#> Only pathways with at least 3 or more features included in the assay dataset are
#>   tested (specified by minPathSize parameter). There are 15 pathways which meet
#>   this criterion.
#> Because pathwayPCA is a self-contained test (PMID: 17303618), only features in
#>   both assay data and pathway database are considered for analysis. There are 615
#>   such features shared by the input assay and pathway database.

We will resume inspection of the analysis results from the chapter 4 vignette for the AESPCA method.

# AESPCA Analysis: see Chapter 4
colonSurv_aespcOut <- AESPCA_pVals(
  object = colon_OmicsSurv,
  numReps = 0,
  numPCs = 2,
  parallel = TRUE,
  numCores = 2,
  adjustpValues = TRUE,
  adjustment = c("BH", "Bonf")
)
#> Part 1: Calculate Pathway AES-PCs
#> Initializing Computing Cluster: DONE
#> Extracting Pathway PCs in Parallel: DONE
#> 
#> Part 2: Calculate Pathway p-Values
#> Initializing Computing Cluster: DONE
#> Extracting Pathway p-Values in Parallel: DONE
#> 
#> Part 3: Adjusting p-Values and Sorting Pathway p-Value Data Frame
#> DONE

2. Plot Pathway Significance Levels

The first element of this results data object is a data frame of pathways and their significance levels (pVals_df).

getPathpVals(colonSurv_aespcOut)
#> # A tibble: 15 × 4
#>    terms                                            rawp  FDR_BH FWER_Bonferroni
#>    <chr>                                           <dbl>   <dbl>           <dbl>
#>  1 PID_EPHB_FWD_PATHWAY                          6.53e-6 9.80e-5       0.0000980
#>  2 REACTOME_PHOSPHOLIPID_METABOLISM              1.96e-4 1.47e-3       0.00295  
#>  3 REACTOME_INSULIN_RECEPTOR_SIGNALLING_CASCADE  4.90e-4 2.45e-3       0.00735  
#>  4 KEGG_ASTHMA                                   8.21e-4 3.08e-3       0.0123   
#>  5 KEGG_ERBB_SIGNALING_PATHWAY                   1.47e-3 4.42e-3       0.0221   
#>  6 PID_TNF_PATHWAY                               2.60e-3 6.51e-3       0.0390   
#>  7 REACTOME_SIGNALING_BY_INSULIN_RECEPTOR        4.42e-3 9.08e-3       0.0662   
#>  8 KEGG_PENTOSE_PHOSPHATE_PATHWAY                4.84e-3 9.08e-3       0.0726   
#>  9 ST_GA12_PATHWAY                               1.48e-2 2.46e-2       0.222    
#> 10 KEGG_RETINOL_METABOLISM                       2.55e-2 3.82e-2       0.382    
#> 11 KEGG_NON_SMALL_CELL_LUNG_CANCER               4.69e-2 6.39e-2       0.703    
#> 12 KEGG_ANTIGEN_PROCESSING_AND_PRESENTATION      7.37e-2 9.21e-2       1        
#> 13 BIOCARTA_RELA_PATHWAY                         7.09e-1 8.01e-1       1        
#> 14 BIOCARTA_TNFR1_PATHWAY                        7.76e-1 8.01e-1       1        
#> 15 BIOCARTA_SET_PATHWAY                          8.01e-1 8.01e-1       1

Given the \(p\)-values from these pathways, we will now graph their score (negative log of the \(p\)-value) and description for the top 15 most-significant pathways.

2.1 Trim Pathway Names

Because pathway names are quite long, we truncate names longer than 35 characters for better display in the graphs.

pVals_df <- 
  getPathpVals(colonSurv_aespcOut) %>% 
  mutate(
    terms = ifelse(
      str_length(terms) > 35,
      paste0(str_sub(terms, 1, 33), "..."),
      terms
    )
  )

pVals_df
#> # A tibble: 15 × 4
#>    terms                                      rawp    FDR_BH FWER_Bonferroni
#>    <chr>                                     <dbl>     <dbl>           <dbl>
#>  1 PID_EPHB_FWD_PATHWAY                 0.00000653 0.0000980       0.0000980
#>  2 REACTOME_PHOSPHOLIPID_METABOLISM     0.000196   0.00147         0.00295  
#>  3 REACTOME_INSULIN_RECEPTOR_SIGNALL... 0.000490   0.00245         0.00735  
#>  4 KEGG_ASTHMA                          0.000821   0.00308         0.0123   
#>  5 KEGG_ERBB_SIGNALING_PATHWAY          0.00147    0.00442         0.0221   
#>  6 PID_TNF_PATHWAY                      0.00260    0.00651         0.0390   
#>  7 REACTOME_SIGNALING_BY_INSULIN_REC... 0.00442    0.00908         0.0662   
#>  8 KEGG_PENTOSE_PHOSPHATE_PATHWAY       0.00484    0.00908         0.0726   
#>  9 ST_GA12_PATHWAY                      0.0148     0.0246          0.222    
#> 10 KEGG_RETINOL_METABOLISM              0.0255     0.0382          0.382    
#> 11 KEGG_NON_SMALL_CELL_LUNG_CANCER      0.0469     0.0639          0.703    
#> 12 KEGG_ANTIGEN_PROCESSING_AND_PRESE... 0.0737     0.0921          1        
#> 13 BIOCARTA_RELA_PATHWAY                0.709      0.801           1        
#> 14 BIOCARTA_TNFR1_PATHWAY               0.776      0.801           1        
#> 15 BIOCARTA_SET_PATHWAY                 0.801      0.801           1

2.2 Tidy the Pathway Results

For the data frame containing the survival data pathway \(p\)-values, we will transform the data for better graphics. This code takes in the pathway \(p\)-values data frame from the AESPCA method output and gathers it into a “tidy” data frame (compatible with ggplot). We also add on a column for the negative natural logarithm of the pathway \(p\)-values (called score) and recode the label of the \(p\)-value adjustment method.

colonOutGather_df <-
  # Take in the results data frame,
  pVals_df %>%
  # "tidy" the data,
  gather(variable, value, -terms) %>%
  # add the score variable, and
  mutate(score = -log(value)) %>%
  # store the adjustment methods as a factor
  mutate(variable = factor(variable)) %>% 
  mutate(
    variable = recode_factor(
      variable,
      rawp = "None",
      FDR_BH = "Hochberg",
      FWER_Bonferroni = "Bonferroni"
    )
  )

2.3 Plot Significant Survival Pathways for One Adjustment

Now we will plot the pathway \(p\)-values for the most significant pathways as a horizontal bar chart. For more information on how to modify ggplot graphs, or to learn how to create your own, please see Chang’s R Graphics Cookbook or Wickham’s ggplot2: Elegant Graphics for Data Analysis.

First, we select the rows of the \(p\)-values data frame which correspond to the adjustment method we are interested in. We will select the Benjamini and Hochberg FDR-adjustment method.

BHpVals_df <- 
  colonOutGather_df %>% 
  filter(variable == "Hochberg") %>% 
  select(-variable)

Now we plot the pathway significance level for the pathways based on this FDR-adjustment method.

ggplot(BHpVals_df) +
  # set overall appearance of the plot
  theme_bw() +
  # Define the dependent and independent variables
  aes(x = reorder(terms, score), y = score) +
  # From the defined variables, create a vertical bar chart
  geom_col(position = "dodge", fill = "#F47321") +
  # Set main and axis titles
  ggtitle("AES-PCA Significant Pathways: Colon Cancer") +
  xlab("Pathways") +
  ylab("Negative Log BH-FDR") +
  # Add a line showing the alpha = 0.01 level
  geom_hline(yintercept = -log(0.01), size = 2, color = "#005030") +
  # Flip the x and y axes
  coord_flip()

2.4 Plot Significant Survival Pathways for All Adjustments

If we were interested in comparing adjustment methods, we can. This figure shows that a few of the simulated pathways are significant at the \(\alpha = 0.01\) for either the Benjamini and Hochberg or Bonferroni FWER approaches. The vertical black line is at \(-\log(p = 0.01)\). This figure is slightly different from the figures shown in the Graph Top Pathways subsection of the Quickstart Guide.

ggplot(colonOutGather_df) +
  # set overall appearance of the plot
  theme_bw() +
  # Define the dependent and independent variables
  aes(x = reorder(terms, score), y = score) +
  # From the defined variables, create a vertical bar chart
  geom_col(position = "dodge", aes(fill = variable)) +
  # Set the legend, main titles, and axis titles
  scale_fill_discrete(guide = FALSE) +
  ggtitle("AES-PCA Significant Colon Pathways by FWER Adjustment") +
  xlab("Pathways") +
  ylab("Negative Log p-Value") +
  # Add a line showing the alpha = 0.01 level
  geom_hline(yintercept = -log(0.01), size = 1) +
  # Flip the x and y axes
  coord_flip() + 
  # Create a subplot for each p-value adjustment method
  facet_grid(. ~ variable)
#> Warning: It is deprecated to specify `guide = FALSE` to remove a guide. Please
#> use `guide = "none"` instead.

3. Inspecting the Driving Genes

Now that we have a few significant pathways, we can look at the loadings of each gene onto the first AES-PC from these pathways.

pVals_df %>% 
  filter(FDR_BH < 0.01) %>% 
  select(terms)
#> # A tibble: 8 × 1
#>   terms                               
#>   <chr>                               
#> 1 PID_EPHB_FWD_PATHWAY                
#> 2 REACTOME_PHOSPHOLIPID_METABOLISM    
#> 3 REACTOME_INSULIN_RECEPTOR_SIGNALL...
#> 4 KEGG_ASTHMA                         
#> 5 KEGG_ERBB_SIGNALING_PATHWAY         
#> 6 PID_TNF_PATHWAY                     
#> 7 REACTOME_SIGNALING_BY_INSULIN_REC...
#> 8 KEGG_PENTOSE_PHOSPHATE_PATHWAY

3.1 Extract Pathway Decomposition

We will chose the top two significant pathways for closer inspection, and we want to ascertain which genes load onto the pathway PCs. Notice that the pathway loadings are named by the internal pathway key, so we need to use the getPathPCL() to match this key to its pathway and extract the pathway PCs and loadings (PC & L) list from the colonSurv_aespcOut object. Here are the loading vectors and pathway details from PID_EPHB_FWD_PATHWAY:

pathway491_ls <- getPathPCLs(colonSurv_aespcOut, "PID_EPHB_FWD_PATHWAY")
pathway491_ls
#> $PCs
#> # A tibble: 250 × 3
#>    sampleID      V1     V2
#>    <chr>      <dbl>  <dbl>
#>  1 subj1    -0.712   0.525
#>  2 subj2    -0.0580  0.293
#>  3 subj3    -1.65    0.367
#>  4 subj4     3.63    1.78 
#>  5 subj5    -1.60   -0.279
#>  6 subj6     1.95    3.12 
#>  7 subj7     2.38    1.48 
#>  8 subj8    -1.48   -0.126
#>  9 subj9    -0.102   0.364
#> 10 subj10    1.89    2.05 
#> # … with 240 more rows
#> 
#> $Loadings
#> # A tibble: 40 × 3
#>    featureID    PC1   PC2
#>    <chr>      <dbl> <dbl>
#>  1 EPHB2      0.242 0.123
#>  2 EPHB4      0.168 0    
#>  3 EFNA5      0     0    
#>  4 MAPK1     -0.265 0.251
#>  5 SRC        0     0.416
#>  6 GRB2       0     0    
#>  7 MAP2K1     0     0    
#>  8 PXN        0     0.471
#>  9 CRK        0     0    
#> 10 CDC42      0     0    
#> # … with 30 more rows
#> 
#> $pathway
#> [1] "pathway491"
#> 
#> $term
#> [1] "PID_EPHB_FWD_PATHWAY"
#> 
#> $description
#> [1] NA

This tells us that pathway491 represents the EPHB forward signaling pathway.

We can also extract the PCs and loadings vectors for KEGG_ASTHMA (the Asthma pathway), which we will compare later.

pathway177_ls <- getPathPCLs(colonSurv_aespcOut, "KEGG_ASTHMA")

3.2 Gene Loadings

3.2.1 Wrangle Pathway Loadings

Given the loading vectors from the EPHB forward signaling pathway, we need to wrangle them into a data frame that the ggplot() function can use. For this, we’ve written a function that you can modify as you need. This function takes in the pathway PC & L list returned by the getPathPCLs() function and returns a data frame with all the components necessary for a plot of the gene loadings. For more aesthetically-pleasing plots, we set the default for one PC or loading vector per figure.

TidyLoading <- function(pathwayPCL, numPCs = 1){
  # browser()
  
  # Remove rows with 0 loading from the first numPCs columns
  loadings_df <- pathwayPCL$Loadings
  totLoad_num  <- rowSums(abs(
    loadings_df[, 2:(numPCs + 1), drop = FALSE]
  ))
  keepRows_idx <- totLoad_num > 0
  loadings_df <- loadings_df[keepRows_idx, , drop = FALSE]
  
  # Sort the value on first feature
  load_df <- loadings_df %>% 
    arrange(desc(PC1))
  
  # Wrangle the sorted loadings:
  gg_df <- load_df %>%
    # make the featureID column a factor, and rename the ID column,
    mutate(ID = factor(featureID, levels = featureID)) %>% 
    select(-featureID) %>% 
    # "tidy" the data, and
    gather(Feature, Value, -ID) %>% 
    # add the up / down indicator.
    mutate(Direction = ifelse(Value > 0, "Up", "Down"))
  
  # Add the pathway name and description
  attr(gg_df, "PathName") <- pathwayPCL$term
  attr(gg_df, "Description") <- pathwayPCL$description
  
  gg_df
  
}

We can use this function to “tidy up” the loadings from the EPHB forward signaling pathway:

tidyLoad491_df <- TidyLoading(pathwayPCL = pathway491_ls)
tidyLoad491_df
#> # A tibble: 26 × 4
#>    ID    Feature   Value Direction
#>    <fct> <chr>     <dbl> <chr>    
#>  1 EPHB2 PC1      0.242  Up       
#>  2 EPHB4 PC1      0.168  Up       
#>  3 MAPK3 PC1      0.0451 Up       
#>  4 EFNB3 PC1     -0.0371 Down     
#>  5 RAP1A PC1     -0.0448 Down     
#>  6 NCK1  PC1     -0.184  Down     
#>  7 ROCK1 PC1     -0.218  Down     
#>  8 RAP1B PC1     -0.238  Down     
#>  9 MAPK1 PC1     -0.265  Down     
#> 10 SYNJ1 PC1     -0.280  Down     
#> # … with 16 more rows

3.2.2 Plot the Gene Loadings

We also wrote a function to create a ggplot graph object which uses this tidy data frame.

PathwayBarChart <- function(ggData_df, y_lab,
                            colours = c(Up = "#009292", Down = "#920000"),
                            label_size = 5,
                            sigFigs = 0,
                            ...){
  
  # Base plot layer
  p1 <- ggplot(ggData_df, aes(x = ID, y = Value, color = Direction))
  
  # Add geometric layer and split by Feature
  p1 <- p1 +
    geom_col(aes(fill = Direction), width = 0.5) +
    facet_wrap(~Feature, nrow = length(unique(ggData_df$Feature)))
  
  # Add Gene Labels
  p1 <- p1 +
    geom_text(
      aes(y = 0, label = ID),
      vjust = "middle",
      hjust = ifelse(ggData_df$Direction == "Up", "top", "bottom"),
      size = label_size, angle = 90, color = "black"
    )
  
  # Add Value Labels
  p1 <- p1 +
    geom_text(
      aes(label = ifelse(ggData_df$Value == 0, "", round(Value, sigFigs))),
      vjust = ifelse(ggData_df$Direction == "Up", "top", "bottom"),
      hjust = "middle",
      size = label_size, color = "black"
    )
  
  # Set the Theme
  p1 <- p1 +
    scale_y_continuous(expand = c(0.15, 0.15)) +
    theme_classic() +
    theme(
      axis.title.x = element_blank(),
      axis.text.x  = element_blank(),
      axis.ticks.x = element_blank(),
      strip.text   = element_text(size = 14),
      legend.position = "none"
    )
  
  # Titles, Subtitles, and Labels
  pathName <- attr(ggData_df, "PathName")
  pathDesc <- attr(ggData_df, "Description")
  if(is.na(pathDesc)){
    p1 <- p1 + ggtitle(pathName) + ylab(y_lab)
  } else {
    p1 <- p1 + labs(title = pathName, subtitle = pathDesc, y = y_lab)
  }
  
  # Return
  p1
  
}

This is the resulting loading bar plot for the EPHB forward signaling pathway (because all of the loadings are between -1 and 1, we set the significant figures to 2):


PathwayBarChart(
  ggData_df = tidyLoad491_df,
  y_lab = "PC Loadings",
  sigFigs = 2
)
#> Warning: Use of `ggData_df$Value` is discouraged. Use `Value` instead.

For comparison, this is the bar plot for the asthma pathway (pathway177 in our -Omics data container):

# pathway177_loadings_bar_chart, fig.height = 6, fig.width = 10.7, out.width = "100%", out.height = "60%"
PathwayBarChart(
  ggData_df = tidyLoad177_df,
  y_lab = "PC Loadings",
  sigFigs = 2
)
#> Warning: Use of `ggData_df$Value` is discouraged. Use `Value` instead.

3.3 Gene Correlations with PCs

3.3.1 Calculate Pathway Correlations

Additionally, we can calculate the correlation between gene expression in the assay corresponding to the EPHB forward signaling pathway and the PC vectors extracted from this pathway. Thus, we need to extract the recorded gene levels corresponding to the non-zero loadings for the PCs, calculate the Spearman correlations between these values and their extracted PCs, then wrangle these correlations into a data frame that the ggplot() function can use. We have written an additional function that you can modify as you need. This function takes in the Omics data container (that you created in Chapter 3) and the PC & L list returned by getPathPCLs(). This function returns a data frame with all the components necessary for a plot of the assay-PC correlations.

TidyCorrelation <- function(Omics, pathwayPCL, numPCs = 1){
  
  loadings_df <- pathwayPCL$Loadings
  totLoad_num  <- rowSums(abs(
    loadings_df[, 2:(numPCs + 1), drop = FALSE]
  ))
  keepRows_idx <- totLoad_num > 0
  loadings_df <- loadings_df[keepRows_idx, , drop = FALSE]
  
  geneNames <- loadings_df$featureID
  geneCorr_mat <- t(
    cor(
      pathwayPCL$PCs[, -1],
      getAssay(Omics)[geneNames],
      method = "spearman"
    )
  )
  colnames(geneCorr_mat) <- paste0("PC", 1:ncol(geneCorr_mat))

  pathwayPCL$Loadings <- data.frame(
    featureID = rownames(geneCorr_mat),
    geneCorr_mat,
    stringsAsFactors = FALSE,
    row.names = NULL
  )
  
  TidyLoading(pathwayPCL, numPCs = numPCs)
  
}

We can use this function to “tidy up” the loadings from the EPHB forward signaling pathway:

tidyCorr491_df <- TidyCorrelation(
  Omics = colon_OmicsSurv,
  pathwayPCL = pathway491_ls
)
tidyCorr491_df
#>        ID Feature       Value Direction
#> 1   EPHB2     PC1  0.48756885        Up
#> 2   EPHB4     PC1  0.42455590        Up
#> 3   MAPK3     PC1  0.33756419        Up
#> 4   RAP1A     PC1 -0.29517214      Down
#> 5   EFNB3     PC1 -0.31177022      Down
#> 6   MAPK1     PC1 -0.44113346      Down
#> 7   ROCK1     PC1 -0.50611242      Down
#> 8   RAP1B     PC1 -0.52530894      Down
#> 9    NCK1     PC1 -0.54333836      Down
#> 10 PIK3CA     PC1 -0.61548850      Down
#> 11  SYNJ1     PC1 -0.65350665      Down
#> 12  ITSN1     PC1 -0.74234263      Down
#> 13 MAP4K4     PC1 -0.74507829      Down
#> 14  EPHB2     PC2  0.20538918        Up
#> 15  EPHB4     PC2  0.07888067        Up
#> 16  MAPK3     PC2  0.07749823        Up
#> 17  RAP1A     PC2 -0.10685319      Down
#> 18  EFNB3     PC2 -0.16173775      Down
#> 19  MAPK1     PC2  0.67115788        Up
#> 20  ROCK1     PC2 -0.30859295      Down
#> 21  RAP1B     PC2 -0.04189417      Down
#> 22   NCK1     PC2  0.06723602        Up
#> 23 PIK3CA     PC2  0.23174041        Up
#> 24  SYNJ1     PC2 -0.09783440      Down
#> 25  ITSN1     PC2  0.06114568        Up
#> 26 MAP4K4     PC2  0.12289233        Up

3.3.2 Plot the Assay-PC Correlation

This is the resulting correlation bar plot for the EPHB forward signaling pathway:


PathwayBarChart(
  ggData_df = tidyCorr491_df,
  y_lab = "Assay-PC Correlations",
  sigFigs = 1
)

And this is the same figure for the asthma pathway.

PathwayBarChart(
  ggData_df = tidyCorr177_df,
  y_lab = "Assay-PC Correlations",
  sigFigs = 1
)

4. Plot patient-specific pathway activities

estimate pathway activities for each patient, both for protein expressions and copy number expressions separately

This is the circle plot for the IL-1 signaling pathway:

# Load data (already ordered by copyNumber PC1 score)
circlePlotData <- readRDS("circlePlotData.RDS")

# Set color scales
library(grDevices)
bluescale <- colorRampPalette(c("blue", "white"))(45)
redscale  <- colorRampPalette(c("white", "red"))(38)
Totalpalette <- c(bluescale,redscale)

# Apply colours
copyCol <-  Totalpalette[circlePlotData$copyNumOrder]
proteoCol <- Totalpalette[circlePlotData$proteinOrder]

Blue stands for negative PC1 score, Red stands for positive PC1 score. The inner loop measures copy number variation, while the outer loop measures protein expression.

library(circlize)
#> ========================================
#> circlize version 0.4.13
#> CRAN page: https://cran.r-project.org/package=circlize
#> Github page: https://github.com/jokergoo/circlize
#> Documentation: https://jokergoo.github.io/circlize_book/book/
#> 
#> If you use it in published research, please cite:
#> Gu, Z. circlize implements and enhances circular visualization
#>   in R. Bioinformatics 2014.
#> 
#> This message can be suppressed by:
#>   suppressPackageStartupMessages(library(circlize))
#> ========================================

# Set parameters
nPathway <- 83
factors  <- 1:nPathway

# Plot Setup
circos.clear()
circos.par(
  "gap.degree" = 0,
  "cell.padding" = c(0, 0, 0, 0),
  start.degree = 360/40,
  track.margin = c(0, 0),
  "clock.wise" = FALSE
)
circos.initialize(factors = factors, xlim = c(0, 3))

# ProteoOmics
circos.trackPlotRegion(
  ylim = c(0, 3),
  factors = factors,
  bg.col = proteoCol,
  track.height = 0.3
)

# Copy Number
circos.trackPlotRegion(
  ylim = c(0, 3),
  factors = factors,
  bg.col = copyCol,
  track.height = 0.3
)

# Add labels
suppressMessages(
  circos.trackText(
    x = rep(-3, nPathway),
    y = rep(-3.8, nPathway),
    labels = "PID_IL1",
    factors = factors,
    col = "#2d2d2d",
    font = 2,
    adj = par("adj"),
    cex = 1.5,
    facing = "downward",
    niceFacing = TRUE
  )
)

5. Review

We have has covered in this vignette:

Plotting the log-score rank of the top pathways.
Plotting the feature loadings for a single pathway.
Plotting the correlations between a pathway principal component and the features within that pathway.

We are exploring options to connect this package to other pathway-testing software. We are further considering other summary functions and/or graphics to help display the output of our *_pVals() functions. If you have any questions, comments, complaints, or suggestions, please submit an issue ticket and give us some feedback. Also you can visit our development page.

Here is the R session information for this vignette:

sessionInfo()
#> R version 4.1.1 (2021-08-10)
#> Platform: x86_64-pc-linux-gnu (64-bit)
#> Running under: Ubuntu 20.04.3 LTS
#> 
#> Matrix products: default
#> BLAS:   /home/biocbuild/bbs-3.14-bioc/R/lib/libRblas.so
#> LAPACK: /home/biocbuild/bbs-3.14-bioc/R/lib/libRlapack.so
#> 
#> 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       
#> 
#> attached base packages:
#> [1] stats4    parallel  stats     graphics  grDevices utils     datasets 
#> [8] methods   base     
#> 
#> other attached packages:
#>  [1] circlize_0.4.13             SummarizedExperiment_1.24.0
#>  [3] Biobase_2.54.0              GenomicRanges_1.46.0       
#>  [5] GenomeInfoDb_1.30.0         IRanges_2.28.0             
#>  [7] S4Vectors_0.32.0            BiocGenerics_0.40.0        
#>  [9] MatrixGenerics_1.6.0        matrixStats_0.61.0         
#> [11] survminer_0.4.9             ggpubr_0.4.0               
#> [13] survival_3.2-13             pathwayPCA_1.10.0          
#> [15] forcats_0.5.1               stringr_1.4.0              
#> [17] dplyr_1.0.7                 purrr_0.3.4                
#> [19] readr_2.0.2                 tidyr_1.1.4                
#> [21] tibble_3.1.5                ggplot2_3.3.5              
#> [23] tidyverse_1.3.1            
#> 
#> loaded via a namespace (and not attached):
#>  [1] colorspace_2.0-2       ggsignif_0.6.3         ellipsis_0.3.2        
#>  [4] rio_0.5.27             XVector_0.34.0         GlobalOptions_0.1.2   
#>  [7] fs_1.5.0               rstudioapi_0.13        farver_2.1.0          
#> [10] bit64_4.0.5            fansi_0.5.0            lubridate_1.8.0       
#> [13] xml2_1.3.2             splines_4.1.1          knitr_1.36            
#> [16] jsonlite_1.7.2         broom_0.7.9            km.ci_0.5-2           
#> [19] dbplyr_2.1.1           compiler_4.1.1         httr_1.4.2            
#> [22] backports_1.2.1        assertthat_0.2.1       Matrix_1.3-4          
#> [25] fastmap_1.1.0          cli_3.0.1              lars_1.2              
#> [28] htmltools_0.5.2        tools_4.1.1            gtable_0.3.0          
#> [31] glue_1.4.2             GenomeInfoDbData_1.2.7 Rcpp_1.0.7            
#> [34] carData_3.0-4          cellranger_1.1.0       jquerylib_0.1.4       
#> [37] vctrs_0.3.8            nlme_3.1-153           xfun_0.27             
#> [40] openxlsx_4.2.4         rvest_1.0.2            lifecycle_1.0.1       
#> [43] rstatix_0.7.0          zlibbioc_1.40.0        zoo_1.8-9             
#> [46] scales_1.1.1           vroom_1.5.5            hms_1.1.1             
#> [49] yaml_2.2.1             curl_4.3.2             gridExtra_2.3         
#> [52] KMsurv_0.1-5           sass_0.4.0             stringi_1.7.5         
#> [55] highr_0.9              zip_2.2.0              shape_1.4.6           
#> [58] rlang_0.4.12           pkgconfig_2.0.3        bitops_1.0-7          
#> [61] evaluate_0.14          lattice_0.20-45        labeling_0.4.2        
#> [64] bit_4.0.4              tidyselect_1.1.1       magrittr_2.0.1        
#> [67] R6_2.5.1               generics_0.1.1         DelayedArray_0.20.0   
#> [70] DBI_1.1.1              pillar_1.6.4           haven_2.4.3           
#> [73] foreign_0.8-81         withr_2.4.2            mgcv_1.8-38           
#> [76] abind_1.4-5            RCurl_1.98-1.5         modelr_0.1.8          
#> [79] crayon_1.4.1           car_3.0-11             survMisc_0.5.5        
#> [82] utf8_1.2.2             tzdb_0.1.2             rmarkdown_2.11        
#> [85] grid_4.1.1             readxl_1.3.1           data.table_1.14.2     
#> [88] reprex_2.0.1           digest_0.6.28          xtable_1.8-4          
#> [91] munsell_0.5.0          bslib_0.3.1

Suppl. Ch. 5 - Visualizing the Results

Gabriel Odom

2021-10-26