# Contents

# 1 Overview

ADAM is a GSEA R package created to group a set of genes from comparative samples (control versus experiment) 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 ((???)). Each group of genes is called GFAG (Group of Functionally Associated Genes). The package has support for many species in regards to the genes and their respective functions.

In the package’s analysis, 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, by using the correction method defined by PCorrectionMethod argument, generating a q-value ((???)). The significative GFAGs will be those whose q-value stay under the cutoff set by PCorrection argument. Optionally, it’s possible to run Wilcoxon test and/or Fisher’s exact test ((???)). These tests also provide a corrected p-value, and siginificative groups can be seen through them.

# 2 GFAGAnalysis

GFAGAnalysis function provides a complete analysis, using all available arguments. As an example, lets consider a gene expression set of Aedes aegypti:

    suppressMessages(library(ADAM))

    data("ExpressionAedes")
    head(ExpressionAedes)

    ##         gene  control1 experiment1  control2 experiment2
    ## 1 AAEL000372 0.9750520   11.744300 15.432300     0.00000
    ## 2 AAEL000433 1.5934700   11.876400  0.133743     1.23991
    ## 3 AAEL000596 0.5680230    3.365710  7.411010    13.06860
    ## 4 AAEL000599 0.0370953    0.361577  0.154117     0.34019
    ## 5 AAEL000656 0.0648374    0.278074  1.340890     1.15750
    ## 6 AAEL000759 2.3512100   48.762500  6.276890    25.02600

The first column refers to the gene names, while the others are the expression obtained by a specific experiment (in this case, RNA-seq). ADAM always need two samples (control versus experiment). This way, we must select two sample columns from the expression data:

    Comparison <- c("control1,experiment1","control2,experiment2")

Each GFAG has a number of genes associated to it. This way, the analysis can consider all GFAGs or just those with a certain number of genes:

    Minimum <- 3
    Maximum <- 20

The p-values for each GFAG is calculated through the bootstrap method, which demands a seed for generating random numbers and a number of bootstraps steps (the number of bootstraps should be a value that ensures the p-value precision):

    SeedBootstrap <- 1049
    StepsBootstrap <- 1000

The p-values will be corrected by a specific method with a certain cutoff value:

    CutoffValue <- 0.05
    MethodCorrection <- "fdr"

In order to group the genes according to their functions, it’s necessary an annotation package or a file relating genes and functions. In this case, Aedes aegypti doesn’t have an annotation package. This way, we build our own file:

    data("KeggPathwaysAedes")
    head(KeggPathwaysAedes)

    ##         gene pathwayID                 pathwayDescription
    ## 1 AAEL012172  aag00270 Cysteine and methionine metabolism
    ## 2 AAEL026440  aag00270 Cysteine and methionine metabolism
    ## 3 AAEL026231  aag00270 Cysteine and methionine metabolism
    ## 4 AAEL001176  aag00270 Cysteine and methionine metabolism
    ## 5 AAEL002399  aag00270 Cysteine and methionine metabolism
    ## 6 AAEL026357  aag00270 Cysteine and methionine metabolism

It’s necessary to inform which function domain and gene nomenclature are being used. As Aedes agypti doesn’t have an annotation package, the domain will be “own” and the nomenclature “gene”:

    Domain <- "own"
    Nomenclature <- "geneStableID"

Wilcoxon test and Fisher’s exact test will be run:

    Wilcoxon <- TRUE
    Fisher <- TRUE

As all arguments were defined, then we can run GFAGAnalysis function:

    ResultAnalysis <- suppressMessages(GFAGAnalysis(ComparisonID = Comparison,
                                ExpressionData = ExpressionAedes,
                                MinGene = Minimum,
                                MaxGene = Maximum,
                                SeedNumber = SeedBootstrap,
                                BootstrapNumber = StepsBootstrap,
                                PCorrection = CutoffValue,
                                DBSpecies = KeggPathwaysAedes,
                                PCorrectionMethod = MethodCorrection,
                                WilcoxonTest = Wilcoxon,
                                FisherTest = Fisher,
                                AnalysisDomain = Domain,
                                GeneIdentifier = Nomenclature))

In the example above, we used the function supressMessages just to stop showing messages during the GFAGAnalysis function execution. The output of GFAGAnalysis will be a list with two elements. The first corresponds to a data frame showing genes and their respective functions:

    head(ResultAnalysis[[1]])

    ##         gene  GroupID
    ## 1 AAEL000759 aag00270
    ## 2 AAEL001176 aag00270
    ## 3 AAEL001378 aag00270
    ## 4 AAEL002399 aag00270
    ## 5 AAEL004059 aag00270
    ## 6 AAEL004728 aag00270

The second element of the output list result corresponds to data frames according to the argument ComparisonID:

    DT::datatable(as.data.frame(ResultAnalysis[[2]][1]), width = 800,
                options = list(scrollX = TRUE))

    DT::datatable(as.data.frame(ResultAnalysis[[2]][2]), width = 800,
                options = list(scrollX = TRUE))

The data frames corresponding to the second element of the list have the following columns:

- ID - A code identifying the GFAG (GO term, KEGG pathway or one according to users annotations).
- Description - Description of the GFAG.
- Raw_Number_Genes -
- Sample_Number_Genes -
- H_ - Two columns. GFAG gene diversity of each sample (control versus experiment).
- N_ - Two columns. GFAG gene activity of each sample (control versus experiment).
- h - Relative gene diversity.
- n - Relative gene activity.
- pValue_h - GFAG p-value related to gene diversity.
- pValue_n - GFAG p-value related to gene activity.
- qValue_h - GFAG corrected p-value related to gene diversity.
- qValue_n - GFAG corrected p-value related to gene activity.
- Significance_h - GFAG significance related to gene diversity. “significative” means the q-value is lower than the cutoff set by PCorrection argument, while “not-significative” means the opposite.
- Significance_n - GFAG significance related to gene activity. “significative” means the q-value is lower than the cutoff set by PCorrection argument, while “not-significative” means the opposite.
- Wilcox_pvalue - GFAG p-value generated by Wilcoxon test.
- Wilcox_qvalue - Wilcoxon GFAG corrected p-value.
- Wilcox_significance - GFAG significance related Wilcoxon test. “significative” means the q-value is lower than the cutoff set by PCorrection argument, while “not-significative” means the opposite.
- Fisher_pvalue - GFAG p-value generated by Fisher’s exact test.
- Fisher_qvalue - Fisher GFAG corrected p-value.
- Fisher_significance - GFAG significance related to Fisher’s exact test. “significative” means the q-value is lower than the cutoff set by PCorrection argument, while “not-significative” means the opposite.

# 3 ADAnalysis

ADAnalysis function provides a partial analysis, where is calculated just gene diversity and activity of each GFAG with no signicance by bootstrap, Wilcoxon or Fisher. As an example, lets consider the same gene expression set of Aedes aegypti previously used in GFAGAnalysis funcion example:

    suppressMessages(library(ADAM))
    data("ExpressionAedes")
    data("KeggPathwaysAedes")

As ADAM always need two samples (control versus experiment), let’s select two sample columns from the expression data and define minimum and maximum number of genes per GFAG:

    Comparison <- c("control1,experiment1")
    Minimum <- 3
    Maximum <- 100

Aedes aegypti doesn’t have an annotation package. This way, we build our own file:

    SpeciesID <- "KeggPathwaysAedes"

It’s necessary to inform which function domain and gene nomenclature are being used. Aedes agypti doesn’t have an annotation package. So the domain will be “own” and the nomenclature “geneStableID”:

    Domain <- "own"
    Nomenclature <- "geneStableID"

As all arguments were defined, then we can run ADAnalysis function:

    ResultAnalysis <- suppressMessages(ADAnalysis(ComparisonID = Comparison,
                                ExpressionData = ExpressionAedes,
                                MinGene = Minimum,
                                MaxGene = Maximum,
                                DBSpecies = KeggPathwaysAedes,
                                AnalysisDomain = Domain,
                                GeneIdentifier = Nomenclature))

In the example above, we used the function supressMessages just to stop showing messages during the ADAnalysis function execution. The output of ADAnalysis will be a list with two elements. The first corresponds to a data frame showing genes and their respective functions:

    head(ResultAnalysis[[1]])

    ##         gene  GroupID
    ## 1 AAEL000759 aag00270
    ## 2 AAEL001176 aag00270
    ## 3 AAEL001378 aag00270
    ## 4 AAEL002399 aag00270
    ## 5 AAEL004059 aag00270
    ## 6 AAEL004728 aag00270

The second element of the output list result corresponds to data frames according to the argument ComparisonID:

    DT::datatable(as.data.frame(ResultAnalysis[[2]][1]), width = 800,
                options = list(scrollX = TRUE))

The data frames corresponding to the second element of the list have the following columns:

- ID - A code identifying the GFAG (GO term, KEGG pathway or one according to users annotations).
- Description - Description of the GFAG.
- Raw_Number_Genes -
- Sample_Number_Genes -
- H_ - Two columns. GFAG gene diversity of each sample (control versus experiment).
- N_ - Two columns. GFAG gene activity of each sample (control versus experiment).
- h - Relative gene diversity.
- n - Relative gene activity.

# 4 Session information

    ## R version 4.0.0 (2020-04-24)
    ## Platform: x86_64-w64-mingw32/x64 (64-bit)
    ## Running under: Windows Server 2012 R2 x64 (build 9600)
    ##
    ## Matrix products: default
    ##
    ## locale:
    ## [1] LC_COLLATE=C
    ## [2] LC_CTYPE=English_United States.1252
    ## [3] LC_MONETARY=English_United States.1252
    ## [4] LC_NUMERIC=C
    ## [5] LC_TIME=English_United States.1252
    ##
    ## attached base packages:
    ## [1] stats     graphics  grDevices utils     datasets  methods   base
    ##
    ## other attached packages:
    ## [1] ADAM_1.4.0       BiocStyle_2.16.0
    ##
    ## loaded via a namespace (and not attached):
    ##  [1] KEGGREST_1.28.0             SummarizedExperiment_1.18.0
    ##  [3] tidyselect_1.0.0            xfun_0.13
    ##  [5] purrr_0.3.4                 pbapply_1.4-2
    ##  [7] lattice_0.20-41             vctrs_0.2.4
    ##  [9] htmltools_0.4.0             stats4_4.0.0
    ## [11] yaml_2.2.1                  blob_1.2.1
    ## [13] rlang_0.4.5                 pillar_1.4.3
    ## [15] glue_1.4.0                  DBI_1.1.0
    ## [17] BiocGenerics_0.34.0         bit64_0.9-7
    ## [19] lifecycle_0.2.0             matrixStats_0.56.0
    ## [21] GenomeInfoDbData_1.2.3      stringr_1.4.0
    ## [23] zlibbioc_1.34.0             Biostrings_2.56.0
    ## [25] htmlwidgets_1.5.1           memoise_1.1.0
    ## [27] evaluate_0.14               Biobase_2.48.0
    ## [29] knitr_1.28                  IRanges_2.22.0
    ## [31] crosstalk_1.1.0.1           GenomeInfoDb_1.24.0
    ## [33] parallel_4.0.0              AnnotationDbi_1.50.0
    ## [35] Rcpp_1.0.4.6                DT_0.13
    ## [37] BiocManager_1.30.10         DelayedArray_0.14.0
    ## [39] S4Vectors_0.26.0            jsonlite_1.6.1
    ## [41] XVector_0.28.0              bit_1.1-15.2
    ## [43] png_0.1-7                   digest_0.6.25
    ## [45] stringi_1.4.6               bookdown_0.18
    ## [47] dplyr_0.8.5                 GenomicRanges_1.40.0
    ## [49] grid_4.0.0                  tools_4.0.0
    ## [51] bitops_1.0-6                magrittr_1.5
    ## [53] tibble_3.0.1                RCurl_1.98-1.2
    ## [55] RSQLite_2.2.0               crayon_1.3.4
    ## [57] GO.db_3.10.0                pkgconfig_2.0.3
    ## [59] ellipsis_0.3.0              Matrix_1.2-18
    ## [61] assertthat_0.2.1            rmarkdown_2.1
    ## [63] httr_1.4.1                  R6_2.4.1
    ## [65] compiler_4.0.0

# 5 References