SECOM Tutorial

Huang Lin\(^1\)

\(^1\)NICHD, 6710B Rockledge Dr, Bethesda, MD 20892

October 18, 2022

get_upper_tri = function(cormat){
    cormat[lower.tri(cormat)] = NA
    diag(cormat) = NA
    return(cormat)
}

1. Introduction

Sparse Estimation of Correlations among Microbiomes (SECOM) (Lin, Eggesbø, and Peddada 2022) is a methodology that aims to detect both linear and nonlinear relationships between a pair of taxa within an ecosystem (e.g., gut) or across ecosystems (e.g., gut and tongue). SECOM corrects both sample-specific and taxon-specific biases and obtains a consistent estimator for the correlation matrix of microbial absolute abundances while maintaining the underlying true sparsity. For more details, please refer to the SECOM paper.

2. Installation

Download package.

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

Load the package.

library(ANCOMBC)

3. Example Data

The HITChip Atlas dataset contains genus-level microbiota profiling with HITChip for 1006 western adults with no reported health complications, reported in (Lahti et al. 2014). The dataset is also available via the microbiome R package (Lahti et al. 2017) in phyloseq (McMurdie and Holmes 2013) format.

data(atlas1006)

# Subset to baseline
tse = atlas1006[, atlas1006$time == 0]

# Re-code the bmi group
tse$bmi = recode(tse$bmi_group,
                 obese = "obese",
                 severeobese = "obese",
                 morbidobese = "obese")
# Subset to lean, overweight, and obese subjects
tse = tse[, tse$bmi %in% c("lean", "overweight", "obese")]

# Create the region variable
tse$region = recode(as.character(tse$nationality),
                    Scandinavia = "NE", UKIE = "NE", SouthEurope = "SE", 
                    CentralEurope = "CE", EasternEurope = "EE",
                    .missing = "unknown")

# Discard "EE" as it contains only 1 subject
# Discard subjects with missing values of region
tse = tse[, ! tse$region %in% c("EE", "unknown")]

print(tse)
class: TreeSummarizedExperiment 
dim: 130 873 
metadata(0):
assays(1): counts
rownames(130): Actinomycetaceae Aerococcus ... Xanthomonadaceae
  Yersinia et rel.
rowData names(3): Phylum Family Genus
colnames(873): Sample-1 Sample-2 ... Sample-1005 Sample-1006
colData names(12): age sex ... bmi region
reducedDimNames(0):
mainExpName: NULL
altExpNames(0):
rowLinks: NULL
rowTree: NULL
colLinks: NULL
colTree: NULL

4. Run SECOM on a Single Ecosystem

4.1 Run secom functions

4.2 Visualizations

5. Run SECOM on Multiple Ecosystems

5.1 Data manipulation

To compute correlations whithin and across different ecosystems, one needs to make sure that there are samples in common across these ecosystems.

class: TreeSummarizedExperiment 
dim: 130 578 
metadata(0):
assays(1): counts
rownames(130): Actinomycetaceae Aerococcus ... Xanthomonadaceae
  Yersinia et rel.
rowData names(3): Phylum Family Genus
colnames(578): Sample-1 Sample-2 ... Sample-577 Sample-578
colData names(12): age sex ... bmi region
reducedDimNames(0):
mainExpName: NULL
altExpNames(0):
rowLinks: NULL
rowTree: NULL
colLinks: NULL
colTree: NULL
class: TreeSummarizedExperiment 
dim: 130 181 
metadata(0):
assays(1): counts
rownames(130): Actinomycetaceae Aerococcus ... Xanthomonadaceae
  Yersinia et rel.
rowData names(3): Phylum Family Genus
colnames(181): Sample-1 Sample-2 ... Sample-180 Sample-181
colData names(12): age sex ... bmi region
reducedDimNames(0):
mainExpName: NULL
altExpNames(0):
rowLinks: NULL
rowTree: NULL
colLinks: NULL
colTree: NULL

5.2 Run secom functions

5.3 Visualizations

Pearson correlation with thresholding

corr_linear = res_linear$corr_th
cooccur_linear = res_linear$mat_cooccur

# Filter by co-occurrence
overlap = 10
corr_linear[cooccur_linear < overlap] = 0

df_linear = data.frame(get_upper_tri(corr_linear)) %>%
  rownames_to_column("var1") %>%
  pivot_longer(cols = -var1, names_to = "var2", values_to = "value") %>%
  filter(!is.na(value)) %>%
  mutate(var2 = gsub("\\...", " - ", var2),
         value = round(value, 2))

tax_name = sort(union(df_linear$var1, df_linear$var2))
df_linear$var1 = factor(df_linear$var1, levels = tax_name)
df_linear$var2 = factor(df_linear$var2, levels = tax_name)
txt_color = ifelse(grepl("CE", tax_name), "#1B9E77", "#D95F02")

heat_linear_th = df_linear %>%
  ggplot(aes(var2, var1, fill = value)) +
  geom_tile(color = "black") +
  scale_fill_gradient2(low = "blue", high = "red", mid = "white", 
                       na.value = "grey", midpoint = 0, limit = c(-1,1), 
                       space = "Lab", name = NULL) +
  scale_x_discrete(drop = FALSE) +
  scale_y_discrete(drop = FALSE) +
  geom_text(aes(var2, var1, label = value), color = "black", size = 4) +
  labs(x = NULL, y = NULL, title = "Pearson (Thresholding)") +
  theme_bw() +
  geom_vline(xintercept = 6.5, color = "blue", linetype = "dashed") +
  geom_hline(yintercept = 6.5, color = "blue", linetype = "dashed") +
  theme(axis.text.x = element_text(angle = 45, vjust = 1, size = 12, hjust = 1, 
                                   face = "italic", color = txt_color),
        axis.text.y = element_text(size = 12, face = "italic", 
                                   color = txt_color),
        strip.text.x = element_text(size = 14),
        strip.text.y = element_text(size = 14),
        legend.text = element_text(size = 12),
        plot.title = element_text(hjust = 0.5, size = 15),
        panel.grid.major = element_blank(),
        axis.ticks = element_blank(),
        legend.position = "none") +
  coord_fixed()

heat_linear_th

Pearson correlation with p-value filtering

corr_linear = res_linear$corr_th
cooccur_linear = res_linear$mat_cooccur

# Filter by co-occurrence
overlap = 10
corr_linear[cooccur_linear < overlap] = 0

df_linear = data.frame(get_upper_tri(corr_linear)) %>%
  rownames_to_column("var1") %>%
  pivot_longer(cols = -var1, names_to = "var2", values_to = "value") %>%
  filter(!is.na(value)) %>%
  mutate(var2 = gsub("\\...", " - ", var2),
         value = round(value, 2))

tax_name = sort(union(df_linear$var1, df_linear$var2))
df_linear$var1 = factor(df_linear$var1, levels = tax_name)
df_linear$var2 = factor(df_linear$var2, levels = tax_name)
txt_color = ifelse(grepl("CE", tax_name), "#1B9E77", "#D95F02")

heat_linear_fl = df_linear %>%
  ggplot(aes(var2, var1, fill = value)) +
  geom_tile(color = "black") +
  scale_fill_gradient2(low = "blue", high = "red", mid = "white", 
                       na.value = "grey", midpoint = 0, limit = c(-1,1), 
                       space = "Lab", name = NULL) +
  scale_x_discrete(drop = FALSE) +
  scale_y_discrete(drop = FALSE) +
  geom_text(aes(var2, var1, label = value), color = "black", size = 4) +
  labs(x = NULL, y = NULL, title = "Pearson (Filtering)") +
  theme_bw() +
  geom_vline(xintercept = 6.5, color = "blue", linetype = "dashed") +
  geom_hline(yintercept = 6.5, color = "blue", linetype = "dashed") +
  theme(axis.text.x = element_text(angle = 45, vjust = 1, size = 12, hjust = 1, 
                                   face = "italic", color = txt_color),
        axis.text.y = element_text(size = 12, face = "italic", 
                                   color = txt_color),
        strip.text.x = element_text(size = 14),
        strip.text.y = element_text(size = 14),
        legend.text = element_text(size = 12),
        plot.title = element_text(hjust = 0.5, size = 15),
        panel.grid.major = element_blank(),
        axis.ticks = element_blank(),
        legend.position = "none") +
  coord_fixed()

heat_linear_fl

Distance correlation with p-value filtering

corr_dist = res_dist$dcorr_fl
cooccur_dist = res_dist$mat_cooccur

# Filter by co-occurrence
overlap = 10
corr_dist[cooccur_dist < overlap] = 0

df_dist = data.frame(get_upper_tri(corr_dist)) %>%
  rownames_to_column("var1") %>%
  pivot_longer(cols = -var1, names_to = "var2", values_to = "value") %>%
  filter(!is.na(value)) %>%
  mutate(var2 = gsub("\\...", " - ", var2),
         value = round(value, 2))

tax_name = sort(union(df_dist$var1, df_dist$var2))
df_dist$var1 = factor(df_dist$var1, levels = tax_name)
df_dist$var2 = factor(df_dist$var2, levels = tax_name)
txt_color = ifelse(grepl("CE", tax_name), "#1B9E77", "#D95F02")

heat_dist_fl = df_dist %>%
  ggplot(aes(var2, var1, fill = value)) +
  geom_tile(color = "black") +
  scale_fill_gradient2(low = "blue", high = "red", mid = "white", 
                       na.value = "grey", midpoint = 0, limit = c(-1,1), 
                       space = "Lab", name = NULL) +
  scale_x_discrete(drop = FALSE) +
  scale_y_discrete(drop = FALSE) +
  geom_text(aes(var2, var1, label = value), color = "black", size = 4) +
  labs(x = NULL, y = NULL, title = "Distance (Filtering)") +
  theme_bw() +
  geom_vline(xintercept = 6.5, color = "blue", linetype = "dashed") +
  geom_hline(yintercept = 6.5, color = "blue", linetype = "dashed") +
  theme(axis.text.x = element_text(angle = 45, vjust = 1, size = 12, hjust = 1, 
                                   face = "italic", color = txt_color),
        axis.text.y = element_text(size = 12, face = "italic", 
                                   color = txt_color),
        strip.text.x = element_text(size = 14),
        strip.text.y = element_text(size = 14),
        legend.text = element_text(size = 12),
        plot.title = element_text(hjust = 0.5, size = 15),
        panel.grid.major = element_blank(),
        axis.ticks = element_blank(),
        legend.position = "none") +
  coord_fixed()

heat_dist_fl

Session information

sessionInfo()
R version 4.2.1 (2022-06-23)
Platform: x86_64-pc-linux-gnu (64-bit)
Running under: Ubuntu 20.04.5 LTS

Matrix products: default
BLAS:   /home/biocbuild/bbs-3.15-bioc/R/lib/libRblas.so
LAPACK: /home/biocbuild/bbs-3.15-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    stats     graphics  grDevices utils     datasets  methods  
[8] base     

other attached packages:
 [1] caret_6.0-93                   lattice_0.20-45               
 [3] DT_0.25                        mia_1.4.0                     
 [5] MultiAssayExperiment_1.22.0    TreeSummarizedExperiment_2.4.0
 [7] Biostrings_2.64.1              XVector_0.36.0                
 [9] SingleCellExperiment_1.18.1    SummarizedExperiment_1.26.1   
[11] Biobase_2.56.0                 GenomicRanges_1.48.0          
[13] GenomeInfoDb_1.32.4            IRanges_2.30.1                
[15] S4Vectors_0.34.0               BiocGenerics_0.42.0           
[17] MatrixGenerics_1.8.1           matrixStats_0.62.0            
[19] forcats_0.5.2                  stringr_1.4.1                 
[21] dplyr_1.0.10                   purrr_0.3.5                   
[23] readr_2.1.3                    tidyr_1.2.1                   
[25] tibble_3.1.8                   ggplot2_3.3.6                 
[27] tidyverse_1.3.2                ANCOMBC_1.6.4                 

loaded via a namespace (and not attached):
  [1] estimability_1.4.1          ModelMetrics_1.2.2.2       
  [3] coda_0.19-4                 bit64_4.0.5                
  [5] knitr_1.40                  irlba_2.3.5.1              
  [7] multcomp_1.4-20             DelayedArray_0.22.0        
  [9] data.table_1.14.4           rpart_4.1.16               
 [11] hardhat_1.2.0               RCurl_1.98-1.9             
 [13] doParallel_1.0.17           generics_0.1.3             
 [15] ScaledMatrix_1.4.1          TH.data_1.1-1              
 [17] RSQLite_2.2.18              proxy_0.4-27               
 [19] future_1.28.0               bit_4.0.4                  
 [21] tzdb_0.3.0                  xml2_1.3.3                 
 [23] lubridate_1.8.0             assertthat_0.2.1           
 [25] DirichletMultinomial_1.38.0 viridis_0.6.2              
 [27] gargle_1.2.1                gower_1.0.0                
 [29] xfun_0.33                   hms_1.1.2                  
 [31] jquerylib_0.1.4             evaluate_0.17              
 [33] fansi_1.0.3                 dbplyr_2.2.1               
 [35] readxl_1.4.1                DBI_1.1.3                  
 [37] htmlwidgets_1.5.4           googledrive_2.0.0          
 [39] Rmpfr_0.8-9                 CVXR_1.0-10                
 [41] ellipsis_0.3.2              crosstalk_1.2.0            
 [43] backports_1.4.1             energy_1.7-10              
 [45] permute_0.9-7               deldir_1.0-6               
 [47] sparseMatrixStats_1.8.0     vctrs_0.4.2                
 [49] cachem_1.0.6                withr_2.5.0                
 [51] checkmate_2.1.0             emmeans_1.8.1-1            
 [53] vegan_2.6-4                 treeio_1.20.2              
 [55] cluster_2.1.4               gsl_2.1-7.1                
 [57] ape_5.6-2                   lazyeval_0.2.2             
 [59] crayon_1.5.2                recipes_1.0.2              
 [61] pkgconfig_2.0.3             labeling_0.4.2             
 [63] nlme_3.1-160                vipor_0.4.5                
 [65] nnet_7.3-18                 rlang_1.0.6                
 [67] globals_0.16.1              lifecycle_1.0.3            
 [69] sandwich_3.0-2              modelr_0.1.9               
 [71] rsvd_1.0.5                  cellranger_1.1.0           
 [73] rngtools_1.5.2              Matrix_1.5-1               
 [75] boot_1.3-28                 zoo_1.8-11                 
 [77] reprex_2.0.2                base64enc_0.1-3            
 [79] beeswarm_0.4.0              googlesheets4_1.0.1        
 [81] png_0.1-7                   viridisLite_0.4.1          
 [83] rootSolve_1.8.2.3           bitops_1.0-7               
 [85] pROC_1.18.0                 blob_1.2.3                 
 [87] DelayedMatrixStats_1.18.2   doRNG_1.8.2                
 [89] decontam_1.16.0             parallelly_1.32.1          
 [91] jpeg_0.1-9                  DECIPHER_2.24.0            
 [93] beachmat_2.12.0             scales_1.2.1               
 [95] memoise_2.0.1               magrittr_2.0.3             
 [97] plyr_1.8.7                  zlibbioc_1.42.0            
 [99] compiler_4.2.1              RColorBrewer_1.1-3         
[101] lme4_1.1-30                 cli_3.4.1                  
[103] lmerTest_3.1-3              listenv_0.8.0              
[105] htmlTable_2.4.1             Formula_1.2-4              
[107] MASS_7.3-58.1               mgcv_1.8-40                
[109] tidyselect_1.2.0            stringi_1.7.8              
[111] highr_0.9                   yaml_2.3.6                 
[113] BiocSingular_1.12.0         latticeExtra_0.6-30        
[115] ggrepel_0.9.1               grid_4.2.1                 
[117] sass_0.4.2                  tools_4.2.1                
[119] lmom_2.9                    future.apply_1.9.1         
[121] parallel_4.2.1              rstudioapi_0.14            
[123] foreach_1.5.2               foreign_0.8-83             
[125] gridExtra_2.3               gld_2.6.5                  
[127] prodlim_2019.11.13          farver_2.1.1               
[129] digest_0.6.30               lava_1.6.10                
[131] Rcpp_1.0.9                  broom_1.0.1                
[133] scuttle_1.6.3               httr_1.4.4                 
[135] Rdpack_2.4                  colorspace_2.0-3           
[137] rvest_1.0.3                 fs_1.5.2                   
[139] splines_4.2.1               yulab.utils_0.0.5          
[141] tidytree_0.4.1              expm_0.999-6               
[143] scater_1.24.0               Exact_3.2                  
[145] xtable_1.8-4                gmp_0.6-6                  
[147] jsonlite_1.8.2              nloptr_2.0.3               
[149] timeDate_4021.106           ipred_0.9-13               
[151] R6_2.5.1                    Hmisc_4.7-1                
[153] pillar_1.8.1                htmltools_0.5.3            
[155] glue_1.6.2                  fastmap_1.1.0              
[157] minqa_1.2.4                 BiocParallel_1.30.4        
[159] BiocNeighbors_1.14.0        class_7.3-20               
[161] codetools_0.2-18            mvtnorm_1.1-3              
[163] utf8_1.2.2                  bslib_0.4.0                
[165] numDeriv_2016.8-1.1         ggbeeswarm_0.6.0           
[167] DescTools_0.99.46           interp_1.1-3               
[169] survival_3.4-0              rmarkdown_2.17             
[171] munsell_0.5.0               e1071_1.7-11               
[173] GenomeInfoDbData_1.2.8      iterators_1.0.14           
[175] haven_2.5.1                 reshape2_1.4.4             
[177] gtable_0.3.1                rbibutils_2.2.9            

References

Lahti, Leo, Jarkko Salojärvi, Anne Salonen, Marten Scheffer, and Willem M De Vos. 2014. “Tipping Elements in the Human Intestinal Ecosystem.” Nature Communications 5 (1): 1–10.

Lahti, Leo, Sudarshan Shetty, T Blake, J Salojarvi, and others. 2017. “Tools for Microbiome Analysis in R.” Version 1: 10013.

Lin, Huang, Merete Eggesbø, and Shyamal Das Peddada. 2022. “Linear and Nonlinear Correlation Estimators Unveil Undescribed Taxa Interactions in Microbiome Data.” Nature Communications 13 (1): 1–16.

McMurdie, Paul J, and Susan Holmes. 2013. “Phyloseq: An R Package for Reproducible Interactive Analysis and Graphics of Microbiome Census Data.” PloS One 8 (4): e61217.