Overview

ADAMgui is an Graphical User Interface for the ADAM package which is GSEA R package created to group a set of genes from comparative samples (control versus experiment) belonging to different species according to their respective functions (Gene Ontology and KEGG pathways as default) and show their significance by calculating p-values referring to gene diversity and activity (Castro et al. (2009)). Each group of genes is called GFAG (Group of Functionally Associated Genes).

The ADAM package was constituted by an statistical class, all genes present in the expression data are grouped by their respective functions according to the domains described by AnalysisDomain argument. The relationship between genes and functions are made based on the species annotation package. If there is no annotation package, a three column file (gene, function and function description) must be provided. For each GFAG, gene diversity and activity in each sample are calculated. As the package always compare two samples (control versus experiment), relative gene diversity and activity for each GFAG are calculated. Using bootstrap method, for each GFAG, according to relative gene diversity and activity, two p-values are calculated. The p-values are then corrected, according to the correction method defined by PCorrectionMethod argument, generating a q-value (Molan (2018)). The significative GFAGs will be those whoose q-value stay under the cutoff set by PCorrection argument. Optionally, it’s possible to run Wilcoxon test and/or Fisher’s exact test (Fontoura and Mombach (2016)). These tests also provide a corrected p-value, and siginificative groups can be seen through them.

The ADAMgui package provides a graphical class so the outputs of the statistical functions in the ADAM package can be studied through different plots. It’s possible, for example, to choose a specific GFAG and observe the gene expression behavior within it. Features as differential expression and fold change can be easily seen.

Package Download and Installation

Download and installation of the package can be done with Bioconductor plataform via BiocManager package, as the code chunk shows:

if (!requireNamespace("BiocManager", quietly = TRUE)){
    install.packages("BiocManager") 
    BiocManager::install("ADAMgui")}

Download and installation of the development version of the package can be done from the package’s GitHub repositories as follows:

BiocManager::install('jrybarczyk/ADAMgui')

After download and installation of the desired version of the ADAMgui package, it can be loaded:

library(ADAMgui)

Graphical User Interface (GUI)

The ADAMgui package contains 2 graphical modules for visualization and analysis of the GFAGAnalysis output file. These modules are shiny-generated (GUI)s that allows the user to create and download plots in .eps format. The functions that launches those applications are: GFAGpathUi() and GFAGtargetUi(). The sections below contains more information about both applications.

library(ADAMgui)
data("ResultAnalysisAedes")

library(ADAMgui)
data("ResultAnalysisAedes")
dt<-ResultAnalysisAedes[1:10,]

write.table(dt,'ResultAnalysisAedes.txt',sep='\t',quote = F,
    row.names = F,col.names = T)

library(ADAMgui)

 GFAGpathUi(TRUE)  #Run the app in your default browser.
 GFAGpathUi(FALSE) #Run the app in R (your local machine).

library(ADAM)
library(ADAMgui)

data("ResultAnalysisAedes") # GFAG Output data

data("ExpressionAedes") # target expression data

data("GeneFunctionAedes") # Path-to-Target relationship data

data("DiffAedes") # target differential expression

# save the GFAG output file
write.table(dt,'ResultAnalysisAedes.txt',sep='\t',quote = F,
    row.names = F,col.names = T)

# save the target expression file
write.table(dt,'ExpressionAedes.txt',sep='\t',quote = F,
    row.names = F,col.names = T)

# save the Path-to-Target relationship file
write.table(dt,'GeneFunctionAedes.txt',sep='\t',quote = F,
    row.names = F,col.names = T)

# save the target differential expression file
write.table(dt,'DiffAedes.txt',sep='\t',quote = F,
    row.names = F,col.names = T)

library(ADAM)
library(ADAMgui)

GFAGtargetUi(TRUE)  #Run the app in your default browser.
GFAGtargetUi(FALSE) #Run the app in R (your local machine).

Session Info

## R version 4.4.2 (2024-10-31)
## Platform: x86_64-pc-linux-gnu
## Running under: Ubuntu 24.04.1 LTS
## 
## Matrix products: default
## BLAS:   /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3 
## LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.26.so;  LAPACK version 3.12.0
## 
## locale:
##  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
##  [3] LC_TIME=en_US.UTF-8        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: Etc/UTC
## tzcode source: system (glibc)
## 
## attached base packages:
## [1] stats     graphics  grDevices utils     datasets  methods   base     
## 
## other attached packages:
## [1] ADAMgui_1.23.0 ADAM_1.23.0   
## 
## loaded via a namespace (and not attached):
##   [1] DBI_1.2.3                   pbapply_1.7-2              
##   [3] gridExtra_2.3               testthat_3.2.1.1           
##   [5] rlang_1.1.4                 magrittr_2.0.3             
##   [7] matrixStats_1.4.1           compiler_4.4.2             
##   [9] RSQLite_2.3.8               reshape2_1.4.4             
##  [11] png_0.1-8                   vctrs_0.6.5                
##  [13] stringr_1.5.1               pkgconfig_2.0.3            
##  [15] crayon_1.5.3                fastmap_1.2.0              
##  [17] backports_1.5.0             XVector_0.47.0             
##  [19] utf8_1.2.4                  promises_1.3.2             
##  [21] rmarkdown_2.29              UCSC.utils_1.3.0           
##  [23] purrr_1.0.2                 varhandle_2.0.6            
##  [25] bit_4.5.0                   xfun_0.49                  
##  [27] zlibbioc_1.52.0             cachem_1.1.0               
##  [29] GenomeInfoDb_1.43.2         jsonlite_1.8.9             
##  [31] blob_1.2.4                  later_1.4.1                
##  [33] DelayedArray_0.33.2         broom_1.0.7                
##  [35] parallel_4.4.2              R6_2.5.1                   
##  [37] bslib_0.8.0                 stringi_1.8.4              
##  [39] RColorBrewer_1.1-3          car_3.1-3                  
##  [41] brio_1.1.5                  GenomicRanges_1.59.1       
##  [43] jquerylib_0.1.4             Rcpp_1.0.13-1              
##  [45] SummarizedExperiment_1.37.0 knitr_1.49                 
##  [47] IRanges_2.41.1              httpuv_1.6.15              
##  [49] Matrix_1.7-1                tidyselect_1.2.1           
##  [51] abind_1.4-8                 yaml_2.3.10                
##  [53] plyr_1.8.9                  lattice_0.22-6             
##  [55] tibble_3.2.1                Biobase_2.67.0             
##  [57] shiny_1.9.1                 KEGGREST_1.47.0            
##  [59] evaluate_1.0.1              Biostrings_2.75.1          
##  [61] ggpubr_0.6.0                pillar_1.9.0               
##  [63] BiocManager_1.30.25         carData_3.0-5              
##  [65] MatrixGenerics_1.19.0       DT_0.33                    
##  [67] stats4_4.4.2                shinyjs_2.1.0              
##  [69] generics_0.1.3              colorRamps_2.3.4           
##  [71] S4Vectors_0.45.2            ggplot2_3.5.1              
##  [73] munsell_0.5.1               scales_1.3.0               
##  [75] BiocStyle_2.35.0            xtable_1.8-4               
##  [77] glue_1.8.0                  maketools_1.3.1            
##  [79] tools_4.4.2                 sys_3.4.3                  
##  [81] data.table_1.16.2           ggsignif_0.6.4             
##  [83] buildtools_1.0.0            grid_4.4.2                 
##  [85] tidyr_1.3.1                 AnnotationDbi_1.69.0       
##  [87] colorspace_2.1-1            GenomeInfoDbData_1.2.13    
##  [89] Formula_1.2-5               cli_3.6.3                  
##  [91] fansi_1.0.6                 S4Arrays_1.7.1             
##  [93] dplyr_1.1.4                 gtable_0.3.6               
##  [95] rstatix_0.7.2               sass_0.4.9                 
##  [97] digest_0.6.37               BiocGenerics_0.53.3        
##  [99] SparseArray_1.7.2           ggrepel_0.9.6              
## [101] htmlwidgets_1.6.4           memoise_2.0.1              
## [103] htmltools_0.5.8.1           lifecycle_1.0.4            
## [105] httr_1.4.7                  GO.db_3.20.0               
## [107] mime_0.12                   bit64_4.5.2