rank_abundance_plot {barcodetrackR} | R Documentation

## Rank Abundance Plot

### Description

Create a rank abundance plot of the barcodes in the chosen samples provided in 'your_SE'. Use this function to visualize the distribution of barcode abundances within sample(s). Note: If comparing the visualization to the statistical testing results from 'rank_abundance_stat_test' function in barcodetrackR, please set the 'scale_rank' to TRUE. The K-S test is agnostic to number of samples so it is directly comparable to the visualization produced when the barcode ranks are scaled between 0 and 1.

### Usage

    rank_abundance_plot(
      your_SE,
      scale_rank = FALSE,
      point_size = 3,
      your_title = NULL,
      text_size = 12,
      plot_labels = NULL,
      return_table = FALSE
    )

### Arguments

`your_SE` | Summarized Experiment object containing clonal tracking data as created by the barcodetrackR 'create_SE' function.
`scale_rank` | Logical. Whether or not to scale all ranks from 0 to 1 or keep barcode ranks as their actual integer values. When 'scale_rank' is set to FALSE, all samples will not necessarily have the same x maximum.
`point_size` | Numeric. Size of the points for the plot.
`your_title` | Character. Specify a title for the plot.
`text_size` | Numeric. Size of text in plot.
`plot_labels` | Vector of labels for each sample. If not specified, the colnames(your_SE) will be used.
`return_table` | Logical. If set to TRUE, rather than a plot, the function will return a dataframe containing for each sample, each barcode in rank order with its abundance in that sample, its scaled rank (0 to 1), and the cumulative sum of abundance for all barcodes with rank <= the rank of that barcode.

### Value

Displays a rank-abundance plot (made by ggplot2) of the samples chosen.
Each point represents a single barcode with the x-value describing its rank in abundance with 1 being the most abundant barcode
The y-value representing the cumulative abundance of all barcodes with rank less than or equal to the x-axis value.
If the return_table is set to TRUE, instead of a plot, a datframe with the rank abundance data will be returned.

### Examples

    data(wu_subset)
    rank_abundance_plot(your_SE = wu_subset[, 1:4], point_size = 2)

[Package barcodetrackR version 1.0.0 Index]