top.alex.waterfall.plots: Waterfall Plots for Lesion and Expression Data of Top...

View source: R/top.alex.waterfall.plots.R

top.alex.waterfall.plotsR Documentation

Waterfall Plots for Lesion and Expression Data of Top Significant Genes

Description

Function return waterfall plots for top significant genes in the KW results table based on the specified q value.

Usage

top.alex.waterfall.plots(out.dir, alex.data, alex.kw.results, q, lsn.data)

Arguments

out.dir

Path to the folder where the waterfall plots of selected genes based on the specified q value of the KW results table will be added.

alex.data

output of the alex.prep.lsn.expr function. It's a list of three data tables that include "row.mtch", "alex.expr" with expression data, "alex.lsn" with lesion data. Rows of alex.expr, and "alex.lsn" matrices are ordered by gene ensembl IDs and columns are ordered by patient ID.

alex.kw.results

ALEX Kruskal-Wallis test results (output of the KW.hit.express function).

q

Maximum allowed KW q-value threshold for a gene to be plotted based on the output of the KW.hit.express function.

lsn.data

Lesion data in a GRIN compatible format.

Details

Function will return waterfall plots for top significant genes in the KW results table based on the user specified q-value threshold of the KW test.The plots will be added to the user specified outdir folder.

Value

Function will return waterfall plots for top significant genes in the KW results table.

Author(s)

Abdelrahman Elsayed abdelrahman.elsayed@stjude.org and Stanley Pounds stanley.pounds@stjude.org

References

Cao, X., Elsayed, A. H., & Pounds, S. B. (2023). Statistical Methods Inspired by Challenges in Pediatric Cancer Multi-omics.

See Also

alex.prep.lsn.expr(), KW.hit.express(), alex.waterfall.prep(), alex.waterfall.plot()

Examples

data(expr.data)
data(lesion.data)
data(hg19.gene.annotation)

# prepare expression, lesion data and return the set of genes with both types of data available
# ordered by gene IDs in rows and patient IDs in columns:
alex.data=alex.prep.lsn.expr(expr.data, lesion.data,
                             hg19.gene.annotation, min.expr=5,
                              min.pts.lsn=5)

# run KW test for association between lesion groups and expression level of the same gene:
alex.kw.results=KW.hit.express(alex.data, hg19.gene.annotation, min.grp.size=5)

# return waterfall plots for a list of top significant genes to a pre-specified folder:
dir.create(resultsFolder <- file.path(tempdir(), "temp.out"))

waterfall.plts=top.alex.waterfall.plots(out.dir=resultsFolder,
                                        alex.data, alex.kw.results,
                                        1e-15, lesion.data)

unlink(resultsFolder, recursive = TRUE)

GRIN2 documentation built on April 4, 2025, 1:41 a.m.