/AOViz

short-read amplicon data visualization suite

Primary LanguageRBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

What is AOViz?

AOViz is an R and RShiny based app for visualizing amplicon sequence data. It is designed to allow users to quickly and efficiently visualize their amplicon datasets and produce "near-publication-ready" figures. Importantly, AOViz provides users with a high level of interactivity and customization during figure generation. By seemlessly combining amplicon datasets with provided metadata, users can more readily explore and visualize microbial community compositional patterns. AOViz is, and will continue to be, a work in progress. The main branch is stable and should do everything it says it will, but if you encounter any errors please let me know and I'll do my best to address them in a timely manner.

Usage summary

Because AOViz is built using RShiny, users can simply download this repository to any location on their local machine and execute it by running the server.R script in RStudio (after installing the appropriate packages, of course).

Users require two files: an ASV table and an associated metadata table, both in a .txt or .tsv format. It is critical that the column names match the examples below exactly. Specifically, "Feature ID", "Consensus.Lineage", and "ReprSequence" in the ASV table, and "SampleName" in the metadata table. Note that the metadata "SampleName" column contains sample names that match the sample names in the ASV table. If you are having errors using AOViz, this is the first place to check.

ASV table ASV_example

Metadata table

meta_example

Example figures

AOViz produces four main plots: a sequencing depth plot, a taxonomic bar plot, a relative abundance bubble plot, and a PCoA triplot. These four plots are contained within seprate RShiny tabs and run independent of each other. Descriptions of these plots are produces are contained in their respective tabs. For each tab, there is an option to download the figure and associated data tables, as well as statistics when applicable (i.e., triplot). The examples below are directly out of AOViz

Read plot (bar and box)

read_plot_bar_example read_plot_box_example

Taxonomy bar plot (class)

taxa_barplot_example

Bubble plot

bubbleplot_5ab_example

Bray-Curtis triplot.

For this plot, arrows represent numeric medata fit to the PCoA coordinates. These arrows are associated with p-values and R2 values (contained within a stats table available for download). Taxonomic relative abundance information is also mapped to PCoA data and shown in ordination space. Also available in UniFrac if provided a tree in newick format. braycurtis_triplot_example