Type: Package

Title: Generate Publication Ready Visualizations of Single Cell Transcriptomics Data

Version: 3.0.0

Description: A system that provides a streamlined way of generating publication ready plots for known Single-Cell transcriptomics data in a "publication ready" format. This is, the goal is to automatically generate plots with the highest quality possible, that can be used right away or with minimal modifications for a research article.

License: GPL-3

URL: https://github.com/enblacar/SCpubr/, https://enblacar.github.io/SCpubr-book/

BugReports: https://github.com/enblacar/SCpubr/issues/

Depends: R (≥ 4.0.0)

Suggests: assertthat, circlize, cli, cluster, colorspace, ComplexHeatmap, covr, decoupleR, dplyr (≥ 1.1.0), enrichplot, forcats, ggalluvial (≥ 0.12.5), ggbeeswarm, ggdist, ggExtra, ggh4x, ggplot2 (≥ 3.4.0), ggplotify, ggrastr, ggrepel, ggridges, ggsignif, graphics, infercnv, KernSmooth, knitr, labeling, magrittr, MASS, Matrix, methods, Nebulosa, org.Hs.eg.db, patchwork, pheatmap, plyr, purrr, qpdf, RColorBrewer, rjags, rlang, rmarkdown, scales, scattermore, Seurat, SeuratObject, sf, stringr, svglite, testthat (≥ 3.0.0), tibble, tidyr, UCell, viridis, waffle, withr

VignetteBuilder: knitr

biocViews: Software, SingleCell, Visualization

Config/testthat/edition: 3

Encoding: UTF-8

LazyData: true

LazyDataCompression: xz

RoxygenNote: 7.3.2

NeedsCompilation: no

Packaged: 2025年08月20日 08:04:23 UTC; eblanco

Author: Enrique Blanco-Carmona ORCID iD [cre, aut]

Maintainer: Enrique Blanco-Carmona <scpubr@gmail.com>

Repository: CRAN

Date/Publication: 2025年08月20日 08:40:02 UTC

do_ActivityHeatmap(
 sample,
 input_gene_list,
 subsample = 2500,
 group.by = NULL,
 assay = NULL,
 slot = NULL,
 statistic = "ulm",
 number.breaks = 5,
 values.show = FALSE,
 values.threshold = NULL,
 values.size = 3,
 values.round = 1,
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = -1,
 sequential.palette = "YlGnBu",
 sequential.direction = 1,
 diverging.palette = "RdBu",
 diverging.direction = -1,
 enforce_symmetry = TRUE,
 legend.position = "bottom",
 legend.width = 1,
 legend.length = 20,
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 legend.type = "colorbar",
 na.value = "grey75",
 font.size = 14,
 font.type = "sans",
 axis.text.x.angle = 45,
 flip = FALSE,
 colors.use = NULL,
 min.cutoff = NA,
 max.cutoff = NA,
 verbose = TRUE,
 return_object = FALSE,
 grid.color = "white",
 border.color = "black",
 flavor = "Seurat",
 nbin = 24,
 ctrl = 100,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

input_gene_list

named_list | Named list of lists of genes to be used as input.

subsample

numeric | Number of cells to subset for the analysis. NA will use all. Cells are selected at random.

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

assay

character | Assay to use. Defaults to the current assay.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

statistic

character | DecoupleR statistic to use for the analysis. values in the Idents of the Seurat object are reported, assessing how specific a given gene set is for a given cell population compared to other gene sets of equal expression.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

values.show

logical | Whether to add values as text in the heatmap.

values.threshold

numeric | Value from which the text color turns from black to white. If mode = "hvg", this is applied to both ends of the color scale.

values.size

numeric | Size of the text labels.

values.round

numeric | Decimal to which round the values to.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

diverging.palette

character | Type of symmetrical color palette to use. Out of the diverging palettes defined in brewer.pal .

diverging.direction

numeric | Either 1 or -1. Direction of the divering palette. This basically flips the two ends.

enforce_symmetry

logical | Return a symmetrical plot axes-wise or continuous color scale-wise, when applicable.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

na.value

character | Color value for NA.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

flip

logical | Whether to invert the axis of the displayed plot.

colors.use

named_vector | Named vector of valid color representations (either name of HEX codes) with as many named colors as unique values of group.by. If group.by is not provided, defaults to the unique values of Idents. If not provided, a color scale will be set by default.

min.cutoff, max.cutoff

numeric | Set the min/max ends of the color scale. Any cell/group with a value lower than min.cutoff will turn into min.cutoff and any cell with a value higher than max.cutoff will turn into max.cutoff. In FeaturePlots, provide as many values as features. Use NAs to skip a feature.

verbose

logical | Whether to show extra comments, warnings,etc.

return_object

logical | Returns the Seurat object with the modifications performed in the function. Nomally, this contains a new assay with the data that can then be used for any other visualization desired.

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

border.color

character | Color for the border of the heatmap body.

flavor

character | One of: Seurat, UCell. Compute the enrichment scores using AddModuleScore or AddModuleScore_UCell.

nbin

numeric | Number of bins to use in AddModuleScore.

ctrl

numeric | Number of genes in the control set to use in AddModuleScore.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_ActivityHeatmap", passive = TRUE)
 
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 
 # Genes have to be unique.
 genes <- list("A" = rownames(sample)[1:5],
 "B" = rownames(sample)[6:10],
 "C" = rownames(sample)[11:15])
 
 # Default parameters.
 p <- SCpubr::do_ActivityHeatmap(sample = sample,
 input_gene_list = genes,
 nbin = 1,
 ctrl = 5,
 flavor = "Seurat",
 subsample = NA,
 verbose = FALSE)
 p
 
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_AlluvialPlot(
 sample,
 first_group,
 last_group,
 middle_groups = NULL,
 colors.use = NULL,
 colorblind = FALSE,
 plot.title = NULL,
 plot.subtitle = NULL,
 plot.caption = NULL,
 font.size = 14,
 font.type = "sans",
 xlab = NULL,
 ylab = "Number of cells",
 repel = FALSE,
 fill.by = last_group,
 use_labels = FALSE,
 stratum.color = "black",
 stratum.fill = "white",
 stratum.width = 1/3,
 stratum.fill.conditional = FALSE,
 use_geom_flow = FALSE,
 alluvium.color = "white",
 flow.color = "white",
 flip = FALSE,
 label.color = "black",
 curve_type = "sigmoid",
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = -1,
 sequential.palette = "YlGnBu",
 sequential.direction = 1,
 plot.grid = FALSE,
 grid.color = "grey75",
 grid.type = "dashed",
 na.value = "white",
 legend.position = "bottom",
 legend.title = NULL,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

first_group

character | Categorical metadata variable. First group of nodes of the alluvial plot.

last_group

character | Categorical metadata variable. Last group of nodes of the alluvial plot.

middle_groups

character | Categorical metadata variable. Vector of groups of nodes of the alluvial plot.

colors.use

character | Named list of colors corresponding to the unique values in fill.by (which defaults to last_group).

colorblind

logical | Whether to use colorblind-friendly colors for categorical variables. In place when colors.use is not used. Allows for a maximum of 85 different classes within a categorical variable.

plot.title, plot.subtitle, plot.caption

character | Title, subtitle or caption to use in the plot.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

xlab, ylab

character | Titles for the X and Y axis.

repel

logical | Whether to repel the text labels.

fill.by

character | One of first_group, middle_groups (one of the values, if multiple mid_groups) or last_group. These values will be used to color the alluvium/flow.

use_labels

logical | Whether to use labels instead of text for the stratum.

stratum.color, alluvium.color, flow.color

character | Color for the border of the alluvium (and flow) and stratum.

stratum.fill

character | Color to fill the stratum.

stratum.width

logical | Width of the stratum.

stratum.fill.conditional

logical | Whether to fill the stratum with the same colors as the alluvium/flow.

use_geom_flow

logical | Whether to use geom_flow instead of geom_alluvium . Visual results might differ.

flip

logical | Whether to invert the axis of the displayed plot.

label.color

character | Color for the text labels.

curve_type

character | Type of curve used in geom_alluvium . One of:

• linear.

• cubic.

• quintic.

• sine.

• arctangent.

• sigmoid.

• xspline.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

plot.grid

logical | Whether to plot grid lines.

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

grid.type

character | One of the possible linetype options:

• blank.

• solid.

• dashed.

• dotted.

• dotdash.

• longdash.

• twodash.

na.value

character | Color value for NA.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.title

character | Title for the legend.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_AlluvialPlot", passive = TRUE)
 message(value)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Compute basic sankey plot.
 p <- SCpubr::do_AlluvialPlot(sample = sample,
 first_group = "orig.ident",
 last_group = "seurat_clusters")
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_BarPlot(
 sample,
 group.by,
 order = FALSE,
 add.n = FALSE,
 add.n.face = "bold",
 add.n.expand = c(0, 1.15),
 add.n.size = 4,
 order.by = NULL,
 split.by = NULL,
 facet.by = NULL,
 position = "stack",
 font.size = 14,
 font.type = "sans",
 legend.position = "bottom",
 legend.title = NULL,
 legend.ncol = NULL,
 legend.nrow = NULL,
 legend.byrow = FALSE,
 axis.text.x.angle = 45,
 xlab = NULL,
 ylab = NULL,
 colors.use = NULL,
 colorblind = FALSE,
 flip = FALSE,
 plot.title = NULL,
 plot.subtitle = NULL,
 plot.caption = NULL,
 plot.grid = FALSE,
 grid.color = "grey75",
 grid.type = "dashed",
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain",
 strip.text.face = "bold",
 return_data = FALSE
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

group.by

character | Metadata column to compute the counts of. Has to be either a character or factor column.

order

logical | Whether to order the results in descending order of counts.

add.n

logical | Whether to add the total counts on top of each bar.

add.n.face

character | Font face of the labels added by add.n.

add.n.expand

numeric | Vector of two numerics representing the start and end of the scale. Minimum should be 0 and max should be above 1. This basically expands the Y axis so that the labels fit when flip = TRUE.

• stack: Set the bars side by side, displaying the total number of counts. Uses position_stack.

• fill: Set the bars on top of each other, displaying the proportion of counts from the total that each group represents. Uses position_fill.

add.n.size

numeric | Size of the labels

order.by

character | When split.by is used, value of group.by to reorder the columns based on its value.

split.by

character | Metadata column to split the values of group.by by. If not used, defaults to the active idents.

facet.by

character | Metadata column to gather the columns by. This is useful if you have other overarching metadata.

position

character | Position function from ggplot2. Either stack or fill.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.title

character | Title for the legend.

legend.ncol

numeric | Number of columns in the legend.

legend.nrow

numeric | Number of rows in the legend.

legend.byrow

logical | Whether the legend is filled by row or not.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

xlab, ylab

character | Titles for the X and Y axis.

colors.use

named_vector | Named vector of valid color representations (either name of HEX codes) with as many named colors as unique values of group.by. If group.by is not provided, defaults to the unique values of Idents. If not provided, a color scale will be set by default.

colorblind

logical | Whether to use colorblind-friendly colors for categorical variables. In place when colors.use is not used. Allows for a maximum of 85 different classes within a categorical variable.

flip

logical | Whether to invert the axis of the displayed plot.

plot.title, plot.subtitle, plot.caption

character | Title, subtitle or caption to use in the plot.

plot.grid

logical | Whether to plot grid lines.

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

grid.type

character | One of the possible linetype options:

• blank.

• solid.

• dashed.

• dotted.

• dotdash.

• longdash.

• twodash.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

strip.text.face

character | Controls the style of the font for the strip text. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

return_data

logical | Returns a data.frame with the count and proportions displayed in the plot.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_BarPlot", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Basic bar plot, horizontal.
 p1 <- SCpubr::do_BarPlot(sample = sample,
 group.by = "seurat_clusters",
 legend.position = "none",
 plot.title = "Number of cells per cluster")
 # Split by a second variable.
 sample$modified_orig.ident <- sample(x = c("Sample_A", "Sample_B", "Sample_C"),
 size = ncol(sample),
 replace = TRUE,
 prob = c(0.2, 0.7, 0.1))
 p <- SCpubr::do_BarPlot(sample,
 group.by = "seurat_clusters",
 split.by = "modified_orig.ident",
 plot.title = "Number of cells per cluster in each sample",
 position = "stack")
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_BeeSwarmPlot(
 sample,
 feature_to_rank,
 group.by = NULL,
 assay = NULL,
 reduction = NULL,
 slot = NULL,
 continuous_feature = FALSE,
 order = FALSE,
 colors.use = NULL,
 colorblind = FALSE,
 legend.title = NULL,
 legend.type = "colorbar",
 legend.position = "bottom",
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.length = 20,
 legend.width = 1,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 legend.ncol = NULL,
 legend.icon.size = 4,
 plot.title = NULL,
 plot.subtitle = NULL,
 plot.caption = NULL,
 xlab = NULL,
 ylab = NULL,
 font.size = 14,
 font.type = "sans",
 remove_x_axis = FALSE,
 remove_y_axis = FALSE,
 flip = FALSE,
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = 1,
 sequential.palette = "YlGnBu",
 sequential.direction = 1,
 verbose = TRUE,
 raster = FALSE,
 raster.dpi = 300,
 plot_cell_borders = TRUE,
 border.size = 1.5,
 border.color = "black",
 pt.size = 2,
 min.cutoff = NA,
 max.cutoff = NA,
 na.value = "grey75",
 number.breaks = 5,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

feature_to_rank

character | Feature for which the cells are going to be ranked. Ideal case is that this feature is stored as a metadata column.

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

assay

character | Assay to use. Defaults to the current assay.

reduction

character | Reduction to use. Can be the canonical ones such as "umap", "pca", or any custom ones, such as "diffusion". If you are unsure about which reductions you have, use Seurat::Reductions(sample). Defaults to "umap" if present or to the last computed reduction if the argument is not provided.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

continuous_feature

logical | Is the feature to rank and color for continuous? I.e: an enrichment score.

order

logical | Whether to reorder the groups based on the median of the ranking.

colors.use

named_vector | Named vector of valid color representations (either name of HEX codes) with as many named colors as unique values of group.by. If group.by is not provided, defaults to the unique values of Idents. If not provided, a color scale will be set by default.

colorblind

logical | Whether to use colorblind-friendly colors for categorical variables. In place when colors.use is not used. Allows for a maximum of 85 different classes within a categorical variable.

legend.title

character | Title for the legend.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

legend.ncol

numeric | Number of columns in the legend.

legend.icon.size

numeric | Size of the icons in legend.

plot.title, plot.subtitle, plot.caption

character | Title, subtitle or caption to use in the plot.

xlab, ylab

character | Titles for the X and Y axis.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

remove_x_axis, remove_y_axis

logical | Remove X axis labels and ticks from the plot.

flip

logical | Whether to invert the axis of the displayed plot.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

verbose

logical | Whether to show extra comments, warnings,etc.

raster

logical | Whether to raster the resulting plot. This is recommendable if plotting a lot of cells.

raster.dpi

numeric | Pixel resolution for rasterized plots. Defaults to 1024. Only activates on Seurat versions higher or equal than 4.1.0.

plot_cell_borders

logical | Whether to plot border around cells.

border.size

numeric | Width of the border of the cells.

border.color

character | Color for the border of the heatmap body.

pt.size

numeric | Size of the dots.

min.cutoff, max.cutoff

numeric | Set the min/max ends of the color scale. Any cell/group with a value lower than min.cutoff will turn into min.cutoff and any cell with a value higher than max.cutoff will turn into max.cutoff. In FeaturePlots, provide as many values as features. Use NAs to skip a feature.

na.value

character | Color value for NA.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_BeeSwarmPlot", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Basic Bee Swarm plot - categorical coloring.
 # This will color based on the unique values of seurat_clusters.
 p <- SCpubr::do_BeeSwarmPlot(sample = sample,
 feature_to_rank = "PC_1",
 group.by = "seurat_clusters",
 continuous_feature = FALSE)
 # Basic Bee Swarm plot - continuous coloring.
 # This will color based on the PC_1 values.
 p <- SCpubr::do_BeeSwarmPlot(sample = sample,
 feature_to_rank = "PC_1",
 group.by = "seurat_clusters",
 continuous_feature = TRUE)
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_BoxPlot(
 sample,
 feature,
 group.by = NULL,
 split.by = NULL,
 assay = NULL,
 slot = "data",
 font.size = 14,
 font.type = "sans",
 axis.text.x.angle = 45,
 colors.use = NULL,
 colorblind = FALSE,
 na.value = "grey75",
 plot.title = NULL,
 plot.subtitle = NULL,
 plot.caption = NULL,
 xlab = NULL,
 ylab = NULL,
 legend.title = NULL,
 legend.title.position = "top",
 legend.position = "bottom",
 legend.ncol = NULL,
 legend.nrow = NULL,
 legend.byrow = FALSE,
 boxplot.line.color = "black",
 outlier.color = "black",
 outlier.alpha = 0.5,
 boxplot.linewidth = 0.5,
 boxplot.width = NULL,
 plot.grid = TRUE,
 grid.color = "grey75",
 grid.type = "dashed",
 flip = FALSE,
 order = FALSE,
 use_silhouette = FALSE,
 use_test = FALSE,
 comparisons = NULL,
 test = "wilcox.test",
 map_signif_level = c(`***` = 0.001, `**` = 0.01, `*` = 0.05),
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

feature

character | Feature to represent.

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

split.by

character | Secondary metadata variable to further group (split) the output by. Has to be a character of factor column.

assay

character | Assay to use. Defaults to the current assay.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

colors.use

named_vector | Named vector of valid color representations (either name of HEX codes) with as many named colors as unique values of group.by. If group.by is not provided, defaults to the unique values of Idents. If not provided, a color scale will be set by default.

colorblind

logical | Whether to use colorblind-friendly colors for categorical variables. In place when colors.use is not used. Allows for a maximum of 85 different classes within a categorical variable.

na.value

character | Color value for NA.

plot.title, plot.subtitle, plot.caption

character | Title, subtitle or caption to use in the plot.

xlab, ylab

character | Titles for the X and Y axis.

legend.title

character | Title for the legend.

legend.title.position

character | Position for the title of the legend. One of:

• top: Top of the legend.

• bottom: Bottom of the legend.

• left: Left of the legend.

• right: Right of the legend.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.ncol

numeric | Number of columns in the legend.

legend.nrow

numeric | Number of rows in the legend.

legend.byrow

logical | Whether the legend is filled by row or not.

boxplot.line.color

character | Color of the borders of the boxplots if use_silhouette is FALSE.

outlier.color

character | Color of the outlier dots.

outlier.alpha

numeric | Alpha applied to the outliers.

boxplot.linewidth

numeric | Width of the lines in the boxplots. Also controls the lines of the tests applied if use_test is set to true.

boxplot.width

numeric | Width of the boxplots.

plot.grid

logical | Whether to plot grid lines.

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

grid.type

character | One of the possible linetype options:

• blank.

• solid.

• dashed.

• dotted.

• dotdash.

• longdash.

• twodash.

flip

logical | Whether to invert the axis of the displayed plot.

order

logical | Whether to order the boxplots by average values. Can not be used alongside split.by.

use_silhouette

logical | Whether to color the borders of the boxplots instead of the inside area.

use_test

logical | Whether to apply a statistical test to a given pair of elements. Can not be used alongside split.by.

comparisons

A list of length-2 vectors. The entries in the vector are either the names of 2 values on the x-axis or the 2 integers that correspond to the index of the columns of interest.

test

the name of the statistical test that is applied to the values of the 2 columns (e.g. t.test, wilcox.test etc.). If you implement a custom test make sure that it returns a list that has an entry called p.value.

map_signif_level

Boolean value, if the p-value are directly written as annotation or asterisks are used instead. Alternatively one can provide a named numeric vector to create custom mappings from p-values to annotation: For example: c("***"=0.001, "**"=0.01, "*"=0.05). Alternatively, one can provide a function that takes a numeric argument (the p-value) and returns a string.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_BoxPlot", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Basic box plot.
 p <- SCpubr::do_BoxPlot(sample = sample,
 feature = "nCount_RNA")
 p
 # Use silhouette style.
 p <- SCpubr::do_BoxPlot(sample = sample,
 feature = "nCount_RNA",
 use_silhouette = TRUE)
 p
 # Order by mean values.
 p <- SCpubr::do_BoxPlot(sample = sample,
 feature = "nCount_RNA",
 order = TRUE)
 p
 # Apply second grouping.
 sample$orig.ident <- ifelse(sample$seurat_clusters %in% c("0", "1", "2", "3"), "A", "B")
 p <- SCpubr::do_BoxPlot(sample = sample,
 feature = "nCount_RNA",
 split.by = "orig.ident")
 p
 # Apply statistical tests.
 p <- SCpubr::do_BoxPlot(sample = sample,
 feature = "nCount_RNA",
 group.by = "orig.ident",
 use_test = TRUE,
 comparisons = list(c("A", "B")))
 p
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_CNVHeatmap(
 sample,
 infercnv_object,
 chromosome_locations,
 group.by = NULL,
 using_metacells = FALSE,
 metacell_mapping = NULL,
 include_chr_arms = FALSE,
 values.show = FALSE,
 values.threshold = NULL,
 values.size = 3,
 values.round = 1,
 legend.type = "colorbar",
 legend.position = "bottom",
 legend.length = 20,
 legend.width = 1,
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 font.size = 14,
 pt.size = 1,
 font.type = "sans",
 axis.text.x.angle = 45,
 enforce_symmetry = TRUE,
 legend.title = NULL,
 na.value = "grey75",
 viridis.palette = "G",
 viridis.direction = 1,
 verbose = FALSE,
 min.cutoff = NA,
 max.cutoff = NA,
 number.breaks = 5,
 diverging.palette = "RdBu",
 diverging.direction = -1,
 sequential.palette = "YlGnBu",
 sequential.direction = -1,
 use_viridis = TRUE,
 return_object = FALSE,
 grid.color = "white",
 border.color = "black",
 flip = FALSE,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

infercnv_object

infercnv | Output inferCNV object run on the same Seurat object.

chromosome_locations

tibble | Tibble containing the chromosome regions to use. Can be obtained using utils::data("human_chr_locations", package = "SCpubr").

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

using_metacells

logical | Whether inferCNV was run using metacells or not.

metacell_mapping

named_vector | Vector or cell - metacell mapping.

include_chr_arms

logical | Whether the output heatmap should also include chromosome arms or just whole chromosomes.

values.show

logical | Whether to add values as text in the heatmap.

values.threshold

numeric | Value from which the text color turns from black to white. If mode = "hvg", this is applied to both ends of the color scale.

values.size

numeric | Size of the text labels.

values.round

numeric | Decimal to which round the values to.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

pt.size

numeric | Size of the dots.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

enforce_symmetry

logical | Return a symmetrical plot axes-wise or continuous color scale-wise, when applicable.

legend.title

character | Title for the legend.

na.value

character | Color value for NA.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

verbose

logical | Whether to show extra comments, warnings,etc.

min.cutoff, max.cutoff

numeric | Set the min/max ends of the color scale. Any cell/group with a value lower than min.cutoff will turn into min.cutoff and any cell with a value higher than max.cutoff will turn into max.cutoff. In FeaturePlots, provide as many values as features. Use NAs to skip a feature.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

diverging.palette

character | Type of symmetrical color palette to use. Out of the diverging palettes defined in brewer.pal .

diverging.direction

numeric | Either 1 or -1. Direction of the divering palette. This basically flips the two ends.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

use_viridis

logical | Whether to use viridis color scales.

return_object

logical | Returns the Seurat object with the modifications performed in the function. Nomally, this contains a new assay with the data that can then be used for any other visualization desired.

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

border.color

character | Color for the border of the heatmap body.

flip

logical | Whether to invert the axis of the displayed plot.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_CNVHeatmap", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # This function expects that you have run inferCNV on your
 # own and you have access to the output object.
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds",
 package = "SCpubr"))
 # Define your inferCNV object.
 infercnv_object <- readRDS(system.file("extdata/infercnv_object_example.rds",
 package = "SCpubr"))
 # Get human chromosome locations.
 chromosome_locations = SCpubr::human_chr_locations
 # Compute for a all chromosomes.
 p <- SCpubr::do_CNVHeatmap(sample = sample,
 infercnv_object = infercnv_object,
 using_metacells = FALSE,
 chromosome_locations = chromosome_locations)
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_CellularStatesPlot(
 sample,
 input_gene_list,
 x1,
 y1,
 x2 = NULL,
 y2 = NULL,
 group.by = NULL,
 colors.use = NULL,
 colorblind = FALSE,
 legend.position = "bottom",
 legend.icon.size = 4,
 legend.ncol = NULL,
 legend.nrow = NULL,
 legend.byrow = FALSE,
 plot.title = NULL,
 plot.subtitle = NULL,
 plot.caption = NULL,
 font.size = 14,
 font.type = "sans",
 xlab = NULL,
 ylab = NULL,
 axis.ticks = TRUE,
 axis.text = TRUE,
 verbose = FALSE,
 enforce_symmetry = FALSE,
 plot_marginal_distributions = FALSE,
 marginal.type = "density",
 marginal.size = 5,
 marginal.group = TRUE,
 plot_cell_borders = TRUE,
 plot_enrichment_scores = FALSE,
 border.size = 2,
 border.color = "black",
 pt.size = 2,
 raster = FALSE,
 raster.dpi = 1024,
 plot_features = FALSE,
 features = NULL,
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = 1,
 sequential.palette = "YlGnBu",
 sequential.direction = -1,
 nbin = 24,
 ctrl = 100,
 number.breaks = 5,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

input_gene_list

named_list | Named list of lists of genes to be used as input.

x1

character | A name of a list from input_gene_list. First feature in the X axis. Will go on the right side of the X axis if y2 is not provided and top-right quadrant if provided.

y1

character | A name of a list from input_gene_list. First feature on the Y axis. Will become the Y axis if y2 is not provided and bottom-right quadrant if provided.

x2

character | A name of a list from input_gene_list. Second feature on the X axis. Will go on the left side of the X axis if y2 is not provided and top-left quadrant if provided.

y2

character | A name of a list from input_gene_list. Second feature on the Y axis. Will become the bottom-left quadrant if provided.

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

colors.use

named_vector | Named vector of valid color representations (either name of HEX codes) with as many named colors as unique values of group.by. If group.by is not provided, defaults to the unique values of Idents. If not provided, a color scale will be set by default.

colorblind

logical | Whether to use colorblind-friendly colors for categorical variables. In place when colors.use is not used. Allows for a maximum of 85 different classes within a categorical variable.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.icon.size

numeric | Size of the icons in legend.

legend.ncol

numeric | Number of columns in the legend.

legend.nrow

numeric | Number of rows in the legend.

legend.byrow

logical | Whether the legend is filled by row or not.

plot.title, plot.subtitle, plot.caption

character | Title, subtitle or caption to use in the plot.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

xlab, ylab

character | Titles for the X and Y axis.

axis.ticks

logical | Whether to show axis ticks.

axis.text

logical | Whether to show axis text.

verbose

logical | Whether to show extra comments, warnings,etc.

enforce_symmetry

logical | Whether to enforce the plot to follow a symmetry (3 variables, the X axis has 0 as center, 4 variables, all axis have the same range and the plot is squared).

plot_marginal_distributions

logical | Whether to plot marginal distributions on the figure or not.

marginal.type

character | One of:

• density: Compute density plots on the margins.

• histogram: Compute histograms on the margins.

• boxplot: Compute boxplot on the margins.

• violin: Compute violin plots on the margins.

• densigram: Compute densigram plots on the margins.

marginal.size

numeric | Size ratio between the main and marginal plots. A value of 5 means that the main plot is 5 times bigger than the marginal plots.

marginal.group

logical | Whether to group the marginal distribution by group.by or current identities.

plot_cell_borders

logical | Whether to plot border around cells.

plot_enrichment_scores

logical | Whether to report enrichment scores for the input lists as plots.

border.size

numeric | Width of the border of the cells.

border.color

character | Color for the border of the heatmap body.

pt.size

numeric | Size of the dots.

raster

logical | Whether to raster the resulting plot. This is recommendable if plotting a lot of cells.

raster.dpi

numeric | Pixel resolution for rasterized plots. Defaults to 1024. Only activates on Seurat versions higher or equal than 4.1.0.

plot_features

logical | Whether to also report any other feature onto the primary plot.

features

character | Additional features to plot.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

nbin

numeric | Number of bins to use in AddModuleScore.

ctrl

numeric | Number of genes in the control set to use in AddModuleScore.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_CellularStatesPlot", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Define some gene sets to query. It has to be a named list.
 gene_set <- list("A" = rownames(sample)[1:10],
 "B" = rownames(sample)[11:20],
 "C" = rownames(sample)[21:30],
 "D" = rownames(sample)[31:40])
 # Using two variables: A scatter plot X vs Y.
 p <- SCpubr::do_CellularStatesPlot(sample = sample,
 input_gene_list = gene_set,
 x1 = "A",
 y1 = "B",
 nbin = 1,
 ctrl = 10)
 p
 # Using three variables. Figure from: https://www.nature.com/articles/nature20123.
 p <- SCpubr::do_CellularStatesPlot(sample = sample,
 input_gene_list = gene_set,
 x1 = "A",
 y1 = "B",
 x2 = "C",
 nbin = 1,
 ctrl = 10)
 p
 # Using four variables. Figure from: https://pubmed.ncbi.nlm.nih.gov/31327527/
 p <- SCpubr::do_CellularStatesPlot(sample = sample,
 input_gene_list = gene_set,
 x1 = "A",
 y1 = "C",
 x2 = "B",
 y2 = "D",
 nbin = 1,
 ctrl = 10)
 p
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_ChordDiagramPlot(
 sample = NULL,
 from = NULL,
 to = NULL,
 colors.from = NULL,
 colors.to = NULL,
 colorblind = FALSE,
 big.gap = 10,
 small.gap = 1,
 link.border.color = NA,
 link.border.width = 1,
 highlight_group = NULL,
 alpha.highlight = 25,
 link.sort = NULL,
 link.decreasing = TRUE,
 z_index = FALSE,
 self.link = 1,
 symmetric = FALSE,
 directional = 1,
 direction.type = c("diffHeight", "arrows"),
 link.arr.type = "big.arrow",
 scale = FALSE,
 alignment = "default",
 annotationTrack = c("grid", "axis"),
 padding_labels = 4,
 font.size = 1
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

from, to

character | Categorical metadata variable to be used as origin and end points of the interactions.

colors.from, colors.to

named_vector | Named vector of colors corresponding to the unique values of "from" and "to".

colorblind

logical | Whether to use colorblind-friendly colors for categorical variables. In place when colors.use is not used. Allows for a maximum of 85 different classes within a categorical variable.

big.gap

numeric | Space between the groups in "from" and "to".

small.gap

numeric | Space within the groups.

link.border.color

character | Color for the border of the links. NA = no color.

link.border.width

numeric | Width of the border line of the links.

highlight_group

character | A value from from that will be used to highlight only the links coming from it.

alpha.highlight

numeric | A value between 00 (double digits) and 99 to depict the alpha of the highlighted links. No transparency needs "FF"

link.sort

pass to chordDiagramFromMatrix or chordDiagramFromDataFrame

link.decreasing

pass to chordDiagramFromMatrix or chordDiagramFromDataFrame

z_index

logical | Whether to bring the bigger links to the top.

self.link

numeric | Behavior of the links. One of:

• 1: Prevents self linking.

• 2: Allows self linking.

symmetric

pass to chordDiagramFromMatrix

directional

numeric | Set the direction of the links. One of:

• 0: Non-directional data.

• 1: Links go from "from" to "to".

• -1: Links go from "to" to "from".

• 2: Links go in both directions.

direction.type

character | How to display the directions. One of:

• diffHeight: Sets a line at the origin of the group showing to how many groups and in which proportion this group is linked to.

• arrows: Sets the connection as arrows.

• both: Sets up both behaviors. Use as: c("diffHeight", "arrows").

link.arr.type

character | Sets the appearance of the arrows. One of:

• triangle: Arrow with a triangle tip at the end displayed on top of the link.

• big.arrow: The link itself ends in a triangle shape.

scale

logical | Whether to put all nodes the same width.

alignment

character | How to align the diagram. One of:

• default: Allows circlize to set up the plot as it sees fit.

• horizontal: Sets the break between "from" and "to" groups on the horizontal axis.

• vertical: Sets the break between "from" and "to" groups on the vertical axis.

annotationTrack

pass to chordDiagramFromMatrix or chordDiagramFromDataFrame

padding_labels

numeric | Number of extra padding (white spaces) of the labels so that they do not overlap with the scales.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_ChordDiagramPlot", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Basic chord diagram.
 sample$assignment <- ifelse(sample$seurat_clusters %in% c("0", "4", "7"), "A", "B")
 sample$assignment[sample$seurat_clusters %in% c("1", "2")] <- "C"
 sample$assignment[sample$seurat_clusters %in% c("10", "5")] <- "D"
 sample$assignment[sample$seurat_clusters %in% c("8", "9")] <- "E"
 p <- SCpubr::do_ChordDiagramPlot(sample = sample,
 from = "seurat_clusters",
 to = "assignment")
 p
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_ColorBlindCheck(
 colors.use,
 flip = FALSE,
 font.size = 14,
 font.type = "sans",
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.text.face = "plain",
 legend.title.face = "bold",
 grid.color = "white",
 border.color = "black",
 axis.text.x.angle = 45
)

colors.use

character | One color upon which generate the color scale. Can be a name or a HEX code.

flip

logical | Whether to invert the axis of the displayed plot.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

border.color

character | Color for the border of the heatmap body.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_ColorBlindCheck", passive = TRUE)
 
 if (isTRUE(value)){
 # Generate a color wheel based on a single value.
 colors <- c("red", "green", "blue")
 p <- SCpubr::do_ColorBlindCheck(colors.use = colors)
 
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_ColorPalette(
 colors.use,
 n = 12,
 opposite = FALSE,
 adjacent = FALSE,
 triadic = FALSE,
 split_complementary = FALSE,
 tetradic = FALSE,
 square = FALSE,
 complete_output = FALSE,
 plot = FALSE,
 font.size = 14,
 font.type = "sans"
)

colors.use

character | One color upon which generate the color scale. Can be a name or a HEX code.

n

numeric | Number of colors to include in the color wheel. Use it when all other options are FALSE, otherwise, it becomes 12.

opposite

logical | Return the opposing color to the one provided.

adjacent

logical | Return the adjacent colors to the one provided.

triadic

logical | Return the triadic combination of colors to the one provided.

split_complementary

logical | Return the split complementary combination of colors to the one provided.

tetradic

logical | Return the tetradic combination of colors to the one provided.

square

logical | Return the square combination of colors to the one provided.

complete_output

logical | Runs all the previous options and returns all the outputs as a list that contains all color vectors, all plots and a combined plot with everything.

plot

logical | Whether to also return a plot displaying the values instead of a vector with the color.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_ColorPalette", passive = TRUE)
 
 if (isTRUE(value)){
 # Generate a color wheel based on a single value.
 colors <- SCpubr::do_ColorPalette(colors.use = "steelblue")
 p <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 plot = TRUE)
 
 # Generate a pair of opposite colors based on a given one.
 colors <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 opposite = TRUE)
 p <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 opposite = TRUE,
 plot = TRUE)
 
 # Generate a trio of adjacent colors based on a given one.
 colors <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 adjacent = TRUE)
 p <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 adjacent = TRUE,
 plot = TRUE)
 
 # Generate a trio of triadic colors based on a given one.
 colors <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 triadic = TRUE)
 p <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 triadic = TRUE,
 plot = TRUE)
 
 # Generate a trio of split complementary colors based on a given one.
 colors <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 split_complementary = TRUE)
 p <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 split_complementary = TRUE,
 plot = TRUE)
 
 # Generate a group of tetradic colors based on a given one.
 colors <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 tetradic = TRUE)
 p <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 tetradic = TRUE,
 plot = TRUE)
 
 # Generate a group of square colors based on a given one.
 colors <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 square = TRUE)
 p <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 square = TRUE,
 plot = TRUE)
 
 # Retrieve the output of all options.
 out <- SCpubr::do_ColorPalette(colors.use = "steelblue",
 complete_output = TRUE)
 ## Retrieve the colors.
 colors <- out$colors
 ## Retrieve the plots.
 plots <- out$plots
 ## Retrieve a combined plot with all the options.
 p <- out$combined_plot
 
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_CorrelationHeatmap(
 sample = NULL,
 input_gene_list = NULL,
 cluster = TRUE,
 remove.diagonal = TRUE,
 mode = "hvg",
 values.show = FALSE,
 values.threshold = NULL,
 values.size = 3,
 values.round = 1,
 assay = NULL,
 group.by = NULL,
 legend.title = "Pearson coef.",
 enforce_symmetry = ifelse(mode == "hvg", TRUE, FALSE),
 font.size = 14,
 font.type = "sans",
 na.value = "grey75",
 legend.width = 1,
 legend.length = 20,
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 legend.type = "colorbar",
 legend.position = "bottom",
 min.cutoff = NA,
 max.cutoff = NA,
 number.breaks = 5,
 plot.title = NULL,
 plot.subtitle = NULL,
 plot.caption = NULL,
 diverging.palette = "RdBu",
 diverging.direction = -1,
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = -1,
 sequential.palette = "YlGnBu",
 sequential.direction = 1,
 axis.text.x.angle = 45,
 grid.color = "white",
 border.color = "black",
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

input_gene_list

named_list | Named list of lists of genes to be used as input.

cluster

logical | Whether to cluster the elements in the heatmap or not.

remove.diagonal

logical | Whether to convert diagnoal to NA. Normally this value would be 1, heavily shifting the color scale.

mode

character | Different types of correlation matrices can be computed. Right now, the only possible value is "hvg", standing for Highly Variable Genes. The sample is subset for the HVG and the data is re-scaled. Scale data is used for the correlation.

values.show

logical | Whether to add values as text in the heatmap.

values.threshold

numeric | Value from which the text color turns from black to white. If mode = "hvg", this is applied to both ends of the color scale.

values.size

numeric | Size of the text labels.

values.round

numeric | Decimal to which round the values to.

assay

character | Assay to use. Defaults to the current assay.

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

legend.title

character | Title for the legend.

enforce_symmetry

logical | Return a symmetrical plot axes-wise or continuous color scale-wise, when applicable.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

na.value

character | Color value for NA.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

min.cutoff, max.cutoff

numeric | Set the min/max ends of the color scale. Any cell/group with a value lower than min.cutoff will turn into min.cutoff and any cell with a value higher than max.cutoff will turn into max.cutoff. In FeaturePlots, provide as many values as features. Use NAs to skip a feature.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

plot.title, plot.subtitle, plot.caption

character | Title, subtitle or caption to use in the plot.

diverging.palette

character | Type of symmetrical color palette to use. Out of the diverging palettes defined in brewer.pal .

diverging.direction

numeric | Either 1 or -1. Direction of the divering palette. This basically flips the two ends.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

border.color

character | Color for the border of the heatmap body.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_CorrelationHeatmap", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Default values.
 p <- SCpubr::do_CorrelationHeatmap(sample = sample)
 p
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_DimPlot(
 sample,
 reduction = NULL,
 group.by = NULL,
 split.by = NULL,
 split.by.combined = TRUE,
 colors.use = NULL,
 colorblind = FALSE,
 shuffle = TRUE,
 order = NULL,
 raster = FALSE,
 pt.size = 1,
 label = FALSE,
 label.color = "black",
 label.fill = "white",
 label.size = 4,
 label.box = TRUE,
 repel = FALSE,
 cells.highlight = NULL,
 idents.highlight = NULL,
 idents.keep = NULL,
 sizes.highlight = 1,
 ncol = NULL,
 plot.title = NULL,
 plot.subtitle = NULL,
 plot.caption = NULL,
 legend.title = NULL,
 legend.position = "bottom",
 legend.title.position = "top",
 legend.ncol = NULL,
 legend.nrow = NULL,
 legend.icon.size = 4,
 legend.byrow = FALSE,
 legend.dot.border = TRUE,
 raster.dpi = 2048,
 dims = c(1, 2),
 font.size = 14,
 font.type = "sans",
 na.value = "grey75",
 plot_cell_borders = TRUE,
 border.size = 2,
 border.color = "black",
 border.density = 1,
 plot_marginal_distributions = FALSE,
 marginal.type = "density",
 marginal.size = 5,
 marginal.group = TRUE,
 plot.axes = FALSE,
 plot_density_contour = FALSE,
 contour.position = "bottom",
 contour.color = "grey90",
 contour.lineend = "butt",
 contour.linejoin = "round",
 contour_expand_axes = 0.25,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

reduction

character | Reduction to use. Can be the canonical ones such as "umap", "pca", or any custom ones, such as "diffusion". If you are unsure about which reductions you have, use Seurat::Reductions(sample). Defaults to "umap" if present or to the last computed reduction if the argument is not provided.

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

split.by

character | Secondary metadata variable to further group (split) the output by. Has to be a character of factor column.

split.by.combined

logical | Adds a combined view of the all the values before splitting them by split.by. Think of this as a regular DimPlot added in front. This is set to TRUE if split.by is used in combination with group.by.

colors.use

named_vector | Named vector of valid color representations (either name of HEX codes) with as many named colors as unique values of group.by. If group.by is not provided, defaults to the unique values of Idents. If not provided, a color scale will be set by default.

colorblind

logical | Whether to use colorblind-friendly colors for categorical variables. In place when colors.use is not used. Allows for a maximum of 85 different classes within a categorical variable.

shuffle

logical | Whether to shuffle the cells or not, so that they are not plotted cluster-wise. Recommended.

order

character | Vector of identities to be plotted. Either one with all identities or just some, which will be plotted last.

raster

logical | Whether to raster the resulting plot. This is recommendable if plotting a lot of cells.

pt.size

numeric | Size of the dots.

label

logical | Whether to plot the cluster labels in the UMAP. The cluster labels will have the same color as the cluster colors.

label.color

character | Color of the labels in the plot.

label.fill

character | Color to fill the labels. Has to be a single color, that will be used for all labels. If NULL, the colors of the clusters will be used instead.

label.size

numeric | Size of the labels in the plot.

label.box

logical | Whether to plot the plot labels as geom_text (FALSE) or geom_label (TRUE).

repel

logical | Whether to repel the text labels.

cells.highlight, idents.highlight

character | Vector of cells/identities to focus into. The identities have to much those in Seurat::Idents(sample) The rest of the cells will be grayed out. Both parameters can be used at the same time.

idents.keep

character | Vector of identities to keep. This will effectively set the rest of the cells that do not match the identities provided to NA, therefore coloring them according to na.value parameter.

sizes.highlight

numeric | Point size of highlighted cells using cells.highlight parameter.

ncol

numeric | Number of columns used in the arrangement of the output plot using "split.by" parameter.

plot.title, plot.subtitle, plot.caption

character | Title, subtitle or caption to use in the plot.

legend.title

character | Title for the legend.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.title.position

character | Position for the title of the legend. One of:

• top: Top of the legend.

• bottom: Bottom of the legend.

• left: Left of the legend.

• right: Right of the legend.

legend.ncol

numeric | Number of columns in the legend.

legend.nrow

numeric | Number of rows in the legend.

legend.icon.size

numeric | Size of the icons in legend.

legend.byrow

logical | Whether the legend is filled by row or not.

legend.dot.border

logical | Adds a black border around the dots in the legend.

raster.dpi

numeric | Pixel resolution for rasterized plots. Defaults to 1024. Only activates on Seurat versions higher or equal than 4.1.0.

dims

numeric | Vector of 2 numerics indicating the dimensions to plot out of the selected reduction. Defaults to c(1, 2) if not specified.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

na.value

character | Color value for NA.

plot_cell_borders

logical | Whether to plot border around cells.

border.size

numeric | Width of the border of the cells.

border.color

character | Color for the border of the heatmap body.

border.density

numeric | Controls the number of cells used when plot_cell_borders = TRUE. Value between 0 and 1. It computes a 2D kernel density and based on this cells that have a density below the specified quantile will be used to generate the cluster contour. The lower this number, the less cells will be selected, thus reducing the overall size of the plot but also potentially preventing all the contours to be properly drawn.

plot_marginal_distributions

logical | Whether to plot marginal distributions on the figure or not.

marginal.type

character | One of:

• density: Compute density plots on the margins.

• histogram: Compute histograms on the margins.

• boxplot: Compute boxplot on the margins.

• violin: Compute violin plots on the margins.

• densigram: Compute densigram plots on the margins.

marginal.size

numeric | Size ratio between the main and marginal plots. A value of 5 means that the main plot is 5 times bigger than the marginal plots.

marginal.group

logical | Whether to group the marginal distribution by group.by or current identities.

plot.axes

logical | Whether to plot axes or not.

plot_density_contour

logical | Whether to plot density contours in the UMAP.

contour.position

character | Whether to plot density contours on top or at the bottom of the visualization layers, thus overlapping the clusters/cells or not.

contour.color

character | Color of the density lines.

contour.lineend

character | Line end style (round, butt, square).

contour.linejoin

character | Line join style (round, mitre, bevel).

contour_expand_axes

numeric | To make the contours fit the plot, the limits of the X and Y axis are expanding a given percentage from the min and max values for each axis. This controls such percentage.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_DimPlot", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Basic DimPlot.
 p <- SCpubr::do_DimPlot(sample = sample)
 # Restrict the amount of identities displayed.
 p <- SCpubr::do_DimPlot(sample = sample,
 idents.keep = c("1", "3", "5"))
 # Group by another variable rather than `Seurat::Idents(sample)`
 p <- SCpubr::do_DimPlot(sample = sample,
 group.by = "seurat_clusters")
 # Split the output in as many plots as unique identities.
 p <- SCpubr::do_DimPlot(sample = sample,
 split.by = "seurat_clusters")
 # Highlight given identities
 p <- SCpubr::do_DimPlot(sample,
 idents.highlight = c("1", "3"))
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_DotPlot(
 sample,
 features,
 assay = NULL,
 slot = "data",
 group.by = NULL,
 split.by = NULL,
 zscore.data = FALSE,
 min.cutoff = NA,
 max.cutoff = NA,
 dot.min = 5,
 enforce_symmetry = ifelse(base::isTRUE(zscore.data), TRUE, FALSE),
 legend.title = NULL,
 legend.type = "colorbar",
 legend.position = "bottom",
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.length = 20,
 legend.width = 1,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 legend.ncol = NULL,
 legend.nrow = NULL,
 legend.byrow = FALSE,
 dot.scale = 8,
 plot.title = NULL,
 plot.subtitle = NULL,
 plot.caption = NULL,
 xlab = NULL,
 ylab = NULL,
 font.size = 14,
 font.type = "sans",
 cluster = FALSE,
 flip = FALSE,
 axis.text.x.angle = 45,
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = -1,
 sequential.palette = "YlGnBu",
 sequential.direction = 1,
 diverging.palette = "RdBu",
 diverging.direction = -1,
 na.value = "grey75",
 plot.grid = TRUE,
 grid.color = "grey75",
 grid.type = "dashed",
 number.breaks = 5,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

features

character | Features to represent.

assay

character | Assay to use. Defaults to the current assay.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

split.by

character | Secondary metadata variable to further group (split) the output by. Has to be a character of factor column.

zscore.data

logical | Whether to compute Z-scores instead of showing average expression values. This allows to see, for each gene, which group has the highest average expression, but prevents you from comparing values across genes. Can not be used with slot = "scale.data" or with split.by.

min.cutoff, max.cutoff

numeric | Set the min/max ends of the color scale. Any cell/group with a value lower than min.cutoff will turn into min.cutoff and any cell with a value higher than max.cutoff will turn into max.cutoff. In FeaturePlots, provide as many values as features. Use NAs to skip a feature.

dot.min

numeric | Ranges from 0 to 100. Filter out dots whose Percent Expressed falls below this threshold.

enforce_symmetry

logical | Return a symmetrical plot axes-wise or continuous color scale-wise, when applicable.

legend.title

character | Title for the legend.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

legend.ncol

numeric | Number of columns in the legend.

legend.nrow

numeric | Number of rows in the legend.

legend.byrow

logical | Whether the legend is filled by row or not.

dot.scale

numeric | Scale the size of the dots.

plot.title, plot.subtitle, plot.caption

character | Title, subtitle or caption to use in the plot.

xlab, ylab

character | Titles for the X and Y axis.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

cluster

logical | Whether to cluster the identities based on the expression of the features.

flip

logical | Whether to invert the axis of the displayed plot.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

diverging.palette

character | Type of symmetrical color palette to use. Out of the diverging palettes defined in brewer.pal .

diverging.direction

numeric | Either 1 or -1. Direction of the divering palette. This basically flips the two ends.

na.value

character | Color value for NA.

plot.grid

logical | Whether to plot grid lines.

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

grid.type

character | One of the possible linetype options:

• blank.

• solid.

• dashed.

• dotted.

• dotdash.

• longdash.

• twodash.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_DotPlot", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 
 # Define your Seurat object.
 # sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Basic Dot plot.
 # genes <- rownames(sample)[1:14]
 # p <- SCpubr::do_DotPlot(sample = sample,
 # features = genes)
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_EnrichmentHeatmap(
 sample,
 input_gene_list,
 features.order = NULL,
 groups.order = NULL,
 cluster = TRUE,
 scale_scores = FALSE,
 assay = NULL,
 slot = NULL,
 reduction = NULL,
 group.by = NULL,
 values.show = FALSE,
 values.threshold = NULL,
 values.size = 3,
 values.round = 1,
 verbose = FALSE,
 na.value = "grey75",
 legend.position = "bottom",
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = 1,
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.length = 20,
 legend.width = 1,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 legend.type = "colorbar",
 font.size = 14,
 font.type = "sans",
 axis.text.x.angle = 45,
 enforce_symmetry = FALSE,
 nbin = 24,
 ctrl = 100,
 flavor = "Seurat",
 legend.title = NULL,
 ncores = 1,
 storeRanks = TRUE,
 min.cutoff = NA,
 max.cutoff = NA,
 pt.size = 1,
 plot_cell_borders = TRUE,
 border.size = 2,
 return_object = FALSE,
 number.breaks = 5,
 sequential.palette = "YlGnBu",
 diverging.palette = "RdBu",
 diverging.direction = -1,
 sequential.direction = 1,
 flip = FALSE,
 grid.color = "white",
 border.color = "black",
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

input_gene_list

named_list | Named list of lists of genes to be used as input.

features.order

character | Should the gene sets be ordered in a specific way? Provide it as a vector of characters with the same names as the names of the gene sets.

groups.order

named_list | Should the groups in theheatmaps be ordered in a specific way? Provide it as a named list (as many lists as values in group.by) with the order for each of the elements in the groups.

cluster

logical | Whether to perform clustering of rows and columns.

scale_scores

logical | Whether to transform the scores to a range of 0-1 for plotting.

assay

character | Assay to use. Defaults to the current assay.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

reduction

character | Reduction to use. Can be the canonical ones such as "umap", "pca", or any custom ones, such as "diffusion". If you are unsure about which reductions you have, use Seurat::Reductions(sample). Defaults to "umap" if present or to the last computed reduction if the argument is not provided.

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

values.show

logical | Whether to add values as text in the heatmap.

values.threshold

numeric | Value from which the text color turns from black to white. If mode = "hvg", this is applied to both ends of the color scale.

values.size

numeric | Size of the text labels.

values.round

numeric | Decimal to which round the values to.

verbose

logical | Whether to show extra comments, warnings,etc.

na.value

character | Color value for NA.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

enforce_symmetry

logical | Whether the geyser and feature plot has a symmetrical color scale.

nbin

numeric | Number of bins to use in AddModuleScore.

ctrl

numeric | Number of genes in the control set to use in AddModuleScore.

flavor

character | One of: Seurat, UCell. Compute the enrichment scores using AddModuleScore or AddModuleScore_UCell.

legend.title

character | Title for the legend.

ncores

numeric | Number of cores used to run UCell scoring.

storeRanks

logical | Whether to store the ranks for faster UCell scoring computations. Might require large amounts of RAM.

min.cutoff, max.cutoff

numeric | Set the min/max ends of the color scale. Any cell/group with a value lower than min.cutoff will turn into min.cutoff and any cell with a value higher than max.cutoff will turn into max.cutoff. In FeaturePlots, provide as many values as features. Use NAs to skip a feature.

pt.size

numeric | Size of the dots.

plot_cell_borders

logical | Whether to plot border around cells.

border.size

numeric | Width of the border of the cells.

return_object

logical | Return the Seurat object with the enrichment scores stored.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

diverging.palette

character | Type of symmetrical color palette to use. Out of the diverging palettes defined in brewer.pal .

diverging.direction

numeric | Either 1 or -1. Direction of the divering palette. This basically flips the two ends.

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

flip

logical | Whether to invert the axis of the displayed plot.

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

border.color

character | Color for the border of the heatmap body.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_EnrichmentHeatmap", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Genes have to be unique.
 genes <- list("A" = rownames(sample)[1:5],
 "B" = rownames(sample)[6:10],
 "C" = rownames(sample)[11:15])
 # Default parameters.
 p <- SCpubr::do_EnrichmentHeatmap(sample = sample,
 input_gene_list = genes,
 nbin = 1,
 ctrl = 10)
 p
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_ExpressionHeatmap(
 sample,
 features,
 group.by = NULL,
 assay = NULL,
 cluster = TRUE,
 features.order = NULL,
 groups.order = NULL,
 slot = "data",
 values.show = FALSE,
 values.threshold = NULL,
 values.size = 3,
 values.round = 1,
 legend.title = "Avg. Expression",
 na.value = "grey75",
 legend.position = "bottom",
 legend.width = 1,
 legend.length = 20,
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 legend.type = "colorbar",
 font.size = 14,
 font.type = "sans",
 axis.text.x.angle = 45,
 enforce_symmetry = FALSE,
 min.cutoff = NA,
 max.cutoff = NA,
 diverging.palette = "RdBu",
 diverging.direction = -1,
 sequential.palette = "YlGnBu",
 sequential.direction = 1,
 number.breaks = 5,
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = -1,
 flip = FALSE,
 grid.color = "white",
 border.color = "black",
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

features

character | Features to represent.

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

assay

character | Assay to use. Defaults to the current assay.

cluster

logical | Whether to perform clustering of rows and columns.

features.order

character | Should the gene sets be ordered in a specific way? Provide it as a vector of characters with the same names as the names of the gene sets.

groups.order

named_list | Should the groups in theheatmaps be ordered in a specific way? Provide it as a named list (as many lists as values in group.by) with the order for each of the elements in the groups.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

values.show

logical | Whether to add values as text in the heatmap.

values.threshold

numeric | Value from which the text color turns from black to white. If mode = "hvg", this is applied to both ends of the color scale.

values.size

numeric | Size of the text labels.

values.round

numeric | Decimal to which round the values to.

legend.title

character | Title for the legend.

na.value

character | Color value for NA.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

enforce_symmetry

logical | Return a symmetrical plot axes-wise or continuous color scale-wise, when applicable.

min.cutoff, max.cutoff

numeric | Set the min/max ends of the color scale. Any cell/group with a value lower than min.cutoff will turn into min.cutoff and any cell with a value higher than max.cutoff will turn into max.cutoff. In FeaturePlots, provide as many values as features. Use NAs to skip a feature.

diverging.palette

character | Type of symmetrical color palette to use. Out of the diverging palettes defined in brewer.pal .

diverging.direction

numeric | Either 1 or -1. Direction of the divering palette. This basically flips the two ends.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

flip

logical | Whether to invert the axis of the displayed plot.

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

border.color

character | Color for the border of the heatmap body.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_ExpressionHeatmap", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Define list of genes.
 genes <- rownames(sample)[1:10]
 # Default parameters.
 p <- SCpubr::do_ExpressionHeatmap(sample = sample,
 features = genes,
 viridis.direction = -1)
 
 p
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_FeaturePlot(
 sample,
 features,
 assay = NULL,
 reduction = NULL,
 slot = NULL,
 order = FALSE,
 group.by = NULL,
 group.by.colors.use = NULL,
 colorblind = FALSE,
 group.by.legend = NULL,
 group.by.show.dots = TRUE,
 group.by.dot.size = 8,
 group.by.cell_borders = FALSE,
 group.by.cell_borders.alpha = 0.1,
 split.by = NULL,
 idents.keep = NULL,
 cells.highlight = NULL,
 idents.highlight = NULL,
 dims = c(1, 2),
 enforce_symmetry = FALSE,
 symmetry.type = "absolute",
 symmetry.center = NA,
 pt.size = 1,
 font.size = 14,
 font.type = "sans",
 legend.title = NULL,
 legend.type = "colorbar",
 legend.position = "bottom",
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.length = 20,
 legend.width = 1,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 legend.ncol = NULL,
 legend.nrow = NULL,
 legend.byrow = FALSE,
 plot.title = NULL,
 plot.subtitle = NULL,
 plot.caption = NULL,
 individual.titles = NULL,
 individual.subtitles = NULL,
 individual.captions = NULL,
 ncol = NULL,
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = 1,
 raster = FALSE,
 raster.dpi = 1024,
 plot_cell_borders = TRUE,
 border.size = 2,
 border.color = "black",
 border.density = 1,
 na.value = "grey75",
 verbose = TRUE,
 plot.axes = FALSE,
 min.cutoff = rep(NA, length(features)),
 max.cutoff = rep(NA, length(features)),
 scale.limits = NULL,
 plot_density_contour = FALSE,
 contour.position = "bottom",
 contour.color = "grey90",
 contour.lineend = "butt",
 contour.linejoin = "round",
 contour_expand_axes = 0.25,
 label = FALSE,
 label.color = "black",
 label.size = 4,
 number.breaks = 5,
 diverging.palette = "RdBu",
 diverging.direction = -1,
 sequential.palette = "YlGnBu",
 sequential.direction = 1,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

features

character | Features to represent.

assay

character | Assay to use. Defaults to the current assay.

reduction

character | Reduction to use. Can be the canonical ones such as "umap", "pca", or any custom ones, such as "diffusion". If you are unsure about which reductions you have, use Seurat::Reductions(sample). Defaults to "umap" if present or to the last computed reduction if the argument is not provided.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

order

logical | Whether to order the cells based on expression.

group.by

character | Metadata variable based on which cells are grouped. This will effectively introduce a big dot in the center of each cluster, colored using a categorical color scale or with the values provided by the user in group.by.colors.use. It will also displays a legend.

group.by.colors.use

character | Colors to use for the group dots.

colorblind

logical | Whether to use colorblind-friendly colors for categorical variables. In place when colors.use is not used. Allows for a maximum of 85 different classes within a categorical variable.

group.by.legend

character | Title for the legend when group.by is used. Use NA to disable it and NULL to use the default column title provided in group.by.

group.by.show.dots

logical | Controls whether to place in the middle of the groups.

group.by.dot.size

numeric | Size of the dots placed in the middle of the groups.

group.by.cell_borders

logical | Plots another border around the cells displaying the same color code of the dots displayed with group.by. Legend is shown always with alpha = 1 regardless of the alpha settings.

group.by.cell_borders.alpha

numeric | Controls the transparency of the new borders drawn by group.by.cell_borders.

split.by

character | Secondary metadata variable to further group (split) the output by. Has to be a character of factor column.

idents.keep

character | Vector of identities to plot. The gradient scale will also be subset to only the values of such identities.

cells.highlight, idents.highlight

character | Vector of cells/identities to focus into. The identities have to much those in Seurat::Idents(sample) The rest of the cells will be grayed out. Both parameters can be used at the same time.

dims

numeric | Vector of 2 numerics indicating the dimensions to plot out of the selected reduction. Defaults to c(1, 2) if not specified.

enforce_symmetry

logical | Return a symmetrical plot axes-wise or continuous color scale-wise, when applicable.

symmetry.type

character | Type of symmetry to be enforced. One of:

• absolute: The highest absolute value will be taken into a account to generate the color scale. Works after min.cutoff and max.cutoff.

• centered: Centers the scale around the provided value in symmetry.center. Works after min.cutoff and max.cutoff.

symmetry.center

numeric | Value upon which the scale will be centered.

pt.size

numeric | Size of the dots.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

legend.title

character | Title for the legend.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

legend.ncol

numeric | Number of columns in the legend.

legend.nrow

numeric | Number of rows in the legend.

legend.byrow

logical | Whether the legend is filled by row or not.

plot.title, plot.subtitle, plot.caption

character | Title, subtitle or caption to use in the plot.

individual.titles, individual.subtitles, individual.captions

character | Titles or subtitles. for each feature if needed. Either NULL or a vector of equal length of features.

ncol

numeric | Number of columns used in the arrangement of the output plot using "split.by" parameter.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

raster

logical | Whether to raster the resulting plot. This is recommendable if plotting a lot of cells.

raster.dpi

numeric | Pixel resolution for rasterized plots. Defaults to 1024. Only activates on Seurat versions higher or equal than 4.1.0.

plot_cell_borders

logical | Whether to plot border around cells.

border.size

numeric | Width of the border of the cells.

border.color

character | Color for the border of the heatmap body.

border.density

numeric | Controls the number of cells used when plot_cell_borders = TRUE. Value between 0 and 1. It computes a 2D kernel density and based on this cells that have a density below the specified quantile will be used to generate the cluster contour. The lower this number, the less cells will be selected, thus reducing the overall size of the plot but also potentially preventing all the contours to be properly drawn.

na.value

character | Color value for NA.

verbose

logical | Whether to show extra comments, warnings,etc.

plot.axes

logical | Whether to plot axes or not.

min.cutoff, max.cutoff

numeric | Set the min/max ends of the color scale. Any cell/group with a value lower than min.cutoff will turn into min.cutoff and any cell with a value higher than max.cutoff will turn into max.cutoff. In FeaturePlots, provide as many values as features. Use NAs to skip a feature.

scale.limits

numeric | Vector of two values (i.e: c(0, 1)) to limit the scales. Particularly useful to extend the color scale beyond the values in the dataset, contrary to min.cutoff and max.cutoff.

plot_density_contour

logical | Whether to plot density contours in the UMAP.

contour.position

character | Whether to plot density contours on top or at the bottom of the visualization layers, thus overlapping the clusters/cells or not.

contour.color

character | Color of the density lines.

contour.lineend

character | Line end style (round, butt, square).

contour.linejoin

character | Line join style (round, mitre, bevel).

contour_expand_axes

numeric | To make the contours fit the plot, the limits of the X and Y axis are expanding a given percentage from the min and max values for each axis. This controls such percentage.

label

logical | Whether to plot the cluster labels in the UMAP. The cluster labels will have the same color as the cluster colors.

label.color

character | Color of the labels in the plot.

label.size

numeric | Size of the labels in the plot.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

diverging.palette

character | Type of symmetrical color palette to use. Out of the diverging palettes defined in brewer.pal .

diverging.direction

numeric | Either 1 or -1. Direction of the divering palette. This basically flips the two ends.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_FeaturePlot", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Regular FeaturePlot.
 p <- SCpubr::do_FeaturePlot(sample = sample,
 features = "nCount_RNA")
 # FeaturePlot with a subset of identities
 # (in Seurat::Idents(sample)) maintaining the original UMAP shape.
 idents.use <- levels(sample)[!(levels(sample) %in% c("2", "5", "8"))]
 p <- SCpubr::do_FeaturePlot(sample = sample,
 idents.highlight = idents.use,
 features = c("EPC1"))
 # Splitting the FeaturePlot by a variable and
 # maintaining the color scale and the UMAP shape.
 p <- SCpubr::do_FeaturePlot(sample = sample,
 features = "EPC1",
 split.by = "seurat_clusters")
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_GroupwiseDEHeatmap(
 sample,
 de_genes,
 group.by = NULL,
 assay = NULL,
 slot = "data",
 number.breaks = 5,
 dot.scale = 8,
 top_genes = 5,
 p.cutoff = 0.05,
 flip = FALSE,
 plot.title = NULL,
 plot.subtitle = NULL,
 plot.caption = NULL,
 xlab = NULL,
 ylab = NULL,
 use_viridis = FALSE,
 colors.use = NULL,
 colorblind = FALSE,
 viridis.direction = -1,
 viridis.palette = "G",
 sequential.direction = 1,
 sequential.palette = "YlGnBu",
 diverging.palette = "RdBu",
 diverging.direction = -1,
 legend.position = "bottom",
 legend.title = NULL,
 legend.width = 1,
 legend.length = 7.5,
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 legend.ncol = NULL,
 legend.nrow = NULL,
 legend.byrow = FALSE,
 legend.type = "colorbar",
 font.size = 14,
 font.type = "sans",
 axis.text.x.angle = 45,
 min.cutoff = NA,
 max.cutoff = NA,
 enforce_symmetry = FALSE,
 na.value = "grey75",
 border.color = "black",
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

de_genes

tibble | DE genes matrix resulting of running Seurat::FindAllMarkers().

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

assay

character | Assay to use. Defaults to the current assay.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

dot.scale

numeric | Scale the size of the dots.

top_genes

numeric | Top N differentially expressed (DE) genes by group to retrieve.

p.cutoff

numeric | Cutoff to use for adjusted p.value to filter significant genes.

flip

logical | Whether to invert the axis of the displayed plot.

plot.title, plot.subtitle, plot.caption

character | Title, subtitle or caption to use in the plot.

xlab, ylab

character | Titles for the X and Y axis.

use_viridis

logical | Whether to use viridis color scales.

colors.use

named_vector | Named vector of valid color representations (either name of HEX codes) with as many named colors as unique values of group.by. If group.by is not provided, defaults to the unique values of Idents. If not provided, a color scale will be set by default.

colorblind

logical | Whether to use colorblind-friendly colors for categorical variables. In place when colors.use is not used. Allows for a maximum of 85 different classes within a categorical variable.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

diverging.palette

character | Type of symmetrical color palette to use. Out of the diverging palettes defined in brewer.pal .

diverging.direction

numeric | Either 1 or -1. Direction of the divering palette. This basically flips the two ends.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.title

character | Title for the legend.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

legend.ncol

numeric | Number of columns in the legend.

legend.nrow

numeric | Number of rows in the legend.

legend.byrow

logical | Whether the legend is filled by row or not.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

min.cutoff, max.cutoff

numeric | Set the min/max ends of the color scale. Any cell/group with a value lower than min.cutoff will turn into min.cutoff and any cell with a value higher than max.cutoff will turn into max.cutoff. In FeaturePlots, provide as many values as features. Use NAs to skip a feature.

enforce_symmetry

logical | Return a symmetrical plot axes-wise or continuous color scale-wise, when applicable.

na.value

character | Color value for NA.

border.color

character | Color for the border of the heatmap body.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_GroupwiseDEHeatmap", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Compute DE genes and transform to a tibble.
 de_genes <- readRDS(system.file("extdata/de_genes_example.rds", package = "SCpubr"))
 # Default output.
 p <- SCpubr::do_GroupwiseDEHeatmap(sample = sample,
 de_genes = de_genes)
 p
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_LigandReceptorPlot(
 liana_output,
 split.by = NULL,
 keep_source = NULL,
 keep_target = NULL,
 top_interactions = 25,
 top_interactions_by_group = FALSE,
 dot_border = TRUE,
 magnitude = "sca.LRscore",
 specificity = "aggregate_rank",
 sort.by = "E",
 sorting.type.specificity = "descending",
 sorting.type.magnitude = "descending",
 border.color = "black",
 axis.text.x.angle = 45,
 legend.position = "bottom",
 legend.type = "colorbar",
 legend.length = 20,
 legend.width = 1,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = 1,
 sequential.palette = "YlGnBu",
 sequential.direction = 1,
 font.size = 14,
 dot.size = 1,
 font.type = "sans",
 plot.grid = TRUE,
 grid.color = "grey90",
 grid.type = "dotted",
 compute_ChordDiagrams = FALSE,
 sort_interactions_alphabetically = FALSE,
 number.breaks = 5,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain",
 return_interactions = FALSE,
 invert_specificity = TRUE,
 invert_magnitude = FALSE,
 verbose = TRUE
)

liana_output

tibble | Object resulting from running liana::liana_wrap and liana::liana_aggregate.

split.by

character | Whether to further facet the plot on the y axis by common ligand.complex or receptor.complex. Values to provide: NULL, ligand.complex, receptor.complex.

keep_source, keep_target

character | Identities to keep for the source/target of the interactions. NULL otherwise.

top_interactions

numeric | Number of unique interactions to retrieve ordered by magnitude and specificity. It does not necessarily mean that the output will contain as many, but rather an approximate value.

top_interactions_by_group

logical | Enforce the value on top_interactions to be applied to each group in source column.

dot_border

logical | Whether to draw a black border in the dots.

specificity, magnitude

character | Which columns to use for specificity and magnitude.

sort.by

character | How to arrange the top interactions. Interactions are sorted and then the top N are retrieved and displayed. This takes place after subsetting for keep_source and keep_target One of:

• A: Sorts by specificity.

• B: Sorts by magnitude.

• C: Sorts by specificity, then magnitude (gives extra weight to specificity).

• D: Sorts by magnitude, then specificity (gives extra weight to magnitude). Might lead to the display of non-significant results.

• E: Sorts by specificity and magnitude equally.

sorting.type.specificity, sorting.type.magnitude

character | Whether the sorting of e magnitude or specificity columns is done in ascending or descending order. This synergises with the value of e invert_specificity and e invert_magnitude parameters.

border.color

character | Color for the border of the heatmap body.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

dot.size

numeric | Size aesthetic for the dots.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

plot.grid

logical | Whether to plot grid lines.

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

grid.type

character | One of the possible linetype options:

• blank.

• solid.

• dashed.

• dotted.

• dotdash.

• longdash.

• twodash.

compute_ChordDiagrams

logical | Whether to also compute Chord Diagrams for both the number of interactions between source and target but also between ligand.complex and receptor.complex.

sort_interactions_alphabetically

logical | Sort the interactions to be plotted alphabetically (TRUE) or keep them in their original order in the matrix (FALSE).

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

return_interactions

logical | Whether to return the data.frames with the interactions so that they can be plotted as chord plots using other package functions.

invert_specificity, invert_magnitude

logical | Whether to -log10 transform specificity and magnitude columns.

verbose

logical | Whether to show extra comments, warnings,etc.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_LigandReceptorPlot", passive = TRUE)
 if (isTRUE(value)){
 liana_output <- readRDS(system.file("extdata/liana_output_example.rds", package = "SCpubr"))
 # Ligand Receptor analysis plot.
 p <- SCpubr::do_LigandReceptorPlot(liana_output = liana_output)
 p
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_LoadingsHeatmap(
 sample,
 group.by = NULL,
 subsample = NA,
 dims = 1:10,
 top_loadings = 5,
 assay = NULL,
 slot = "data",
 grid.color = "white",
 border.color = "black",
 number.breaks = 5,
 na.value = "grey75",
 legend.position = "bottom",
 legend.title = "Expression",
 legend.type = "colorbar",
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.length = 20,
 legend.width = 1,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 font.size = 14,
 font.type = "sans",
 axis.text.x.angle = 45,
 use_viridis = FALSE,
 sequential.direction = 1,
 sequential.palette = "YlGnBu",
 viridis.palette = "G",
 viridis.direction = -1,
 diverging.palette = "RdBu",
 diverging.direction = -1,
 min.cutoff.loadings = NA,
 max.cutoff.loadings = NA,
 min.cutoff.expression = NA,
 max.cutoff.expression = NA,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

subsample

numeric | Number of cells to subsample the Seurat object to increase computational speed. Use NA to include the Seurat object as is.

dims

numeric | PCs to include in the analysis.

top_loadings

numeric | Number of top and bottom scored genes in the PCA Loadings for each PC.

assay

character | Assay to use. Defaults to the current assay.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

border.color

character | Color for the border of the heatmap body.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

na.value

character | Color value for NA.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.title

character | Title for the legend.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

use_viridis

logical | Whether to use viridis color scales.

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

diverging.palette

character | Type of symmetrical color palette to use. Out of the diverging palettes defined in brewer.pal .

diverging.direction

numeric | Either 1 or -1. Direction of the divering palette. This basically flips the two ends.

min.cutoff.loadings, max.cutoff.loadings

numeric | Cutoff to subset the scale of the Loading score heatmap. NA will use quantiles 0.05 and 0.95.

min.cutoff.expression, max.cutoff.expression

numeric | Cutoff to subset the scale of the expression heatmap. NA will use 0 (no quantile) and quantile 0.95.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_LoadingsHeatmap", passive = TRUE)
 
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 
 p <- SCpubr::do_LoadingsHeatmap(sample = sample,
 dims = 1:2)
 p
 
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_MetadataHeatmap(
 sample = NULL,
 group.by = NULL,
 metadata = NULL,
 from_df = FALSE,
 df = NULL,
 colors.use = NULL,
 colorblind = FALSE,
 cluster = FALSE,
 flip = TRUE,
 heatmap.gap = 1,
 axis.text.x.angle = 45,
 legend.position = "bottom",
 font.size = 14,
 legend.font.size = NULL,
 legend.symbol.size = NULL,
 legend.ncol = NULL,
 legend.nrow = NULL,
 legend.byrow = FALSE,
 na.value = "grey75",
 font.type = "sans",
 grid.color = "white",
 border.color = "black",
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain",
 xlab = "",
 ylab = ""
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

group.by

character | Metadata column to use as basis for the plot.

metadata

character | Metadata columns that will be used to plot the heatmap on the basis of the variable provided to group.by.

from_df

logical | Whether to provide a data frame with the metadata instead.

df

data.frame | Data frame containing the metadata to plot. Rows contain the unique values common to all columns (metadata variables). The columns must be named.

colors.use

named_list | A named list of named vectors. The names of the list correspond to the names of the values provided to metadata and the names of the items in the named vectors correspond to the unique values of that specific metadata variable. The values are the desired colors in HEX code for the values to plot. The used are pre-defined by the pacakge but, in order to get the most out of the plot, please provide your custom set of colors for each metadata column!

colorblind

logical | Whether to use colorblind-friendly colors for categorical variables. In place when colors.use is not used. Allows for a maximum of 85 different classes within a categorical variable.

cluster

logical | Whether to perform clustering of rows and columns.

flip

logical | Whether to invert the axis of the displayed plot.

heatmap.gap

numeric | Size of the gap between heatmaps in mm.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

legend.font.size

numeric | Size of the font size of the legend. NULL uses default theme font size for legend according to the font.size parameter.

legend.symbol.size

numeric | Size of symbols in the legend in mm. NULL uses the default size.

legend.ncol

numeric | Number of columns in the legend.

legend.nrow

numeric | Number of rows in the legend.

legend.byrow

logical | Whether the legend is filled by row or not.

na.value

character | Color value for NA.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

border.color

character | Color for the border of the heatmap body.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

xlab, ylab

character | Titles for the X and Y axis.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_MetadataHeatmap", passive = TRUE)
 
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 
 # Can also use a Seurat object.
 df <- data.frame(row.names = letters[1:5],
 "A" = as.character(seq(1, 5)),
 "B" = rev(as.character(seq(1, 5))))
 
 p <- SCpubr::do_MetadataHeatmap(from_df = TRUE,
 df = df)
 
 p
 
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_NebulosaPlot(
 sample,
 features,
 slot = NULL,
 dims = c(1, 2),
 pt.size = 1,
 reduction = NULL,
 combine = TRUE,
 method = c("ks", "wkde"),
 joint = FALSE,
 return_only_joint = FALSE,
 plot.title = NULL,
 plot.subtitle = NULL,
 plot.caption = NULL,
 legend.type = "colorbar",
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.length = 20,
 legend.width = 1,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 font.size = 14,
 font.type = "sans",
 legend.position = "bottom",
 plot_cell_borders = TRUE,
 border.size = 2,
 border.color = "black",
 viridis.palette = "G",
 viridis.direction = 1,
 verbose = TRUE,
 na.value = "grey75",
 plot.axes = FALSE,
 number.breaks = 5,
 use_viridis = FALSE,
 sequential.palette = "YlGnBu",
 sequential.direction = 1,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

features

character | Features to represent.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

dims

numeric | Vector of 2 numerics indicating the dimensions to plot out of the selected reduction. Defaults to c(1, 2) if not specified.

pt.size

numeric | Size of the dots.

reduction

character | Reduction to use. Can be the canonical ones such as "umap", "pca", or any custom ones, such as "diffusion". If you are unsure about which reductions you have, use Seurat::Reductions(sample). Defaults to "umap" if present or to the last computed reduction if the argument is not provided.

combine

logical | Whether to create a single plot out of multiple features.

method

Kernel density estimation method:

• ks: Computes density using the kde function from the ks package.

• wkde: Computes density using a modified version of the kde2d function from the MASS package to allow weights. Bandwidth selection from the ks package is used instead.

joint

logical | Whether to plot different features as joint density.

return_only_joint

logical | Whether to only return the joint density panel.

plot.title, plot.subtitle, plot.caption

character | Title, subtitle or caption to use in the plot.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

plot_cell_borders

logical | Whether to plot border around cells.

border.size

numeric | Width of the border of the cells.

border.color

character | Color for the border of the heatmap body.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

verbose

logical | Whether to show extra comments, warnings,etc.

na.value

character | Color value for NA.

plot.axes

logical | Whether to plot axes or not.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

use_viridis

logical | Whether to use viridis color scales.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_NebulosaPlot", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 # Basic Nebulosa plot.
 p <- SCpubr::do_NebulosaPlot(sample = sample,
 features = "EPC1")
 # Compute joint density.
 p <- SCpubr::do_NebulosaPlot(sample = sample,
 features = c("EPC1", "TOX2"),
 joint = TRUE)
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_PackageReport(startup = FALSE, extended = FALSE)

startup

logical | Whether the message should be displayed at startup, therefore, also containing welcoming messages and tips. If FALSE, only the report itself will be printed.

extended

logical | Whether the message should also include installed packages, current and available version, and which SCpubr functions can be used with the currently installed packages.

# Print a package report.
SCpubr::do_PackageReport(startup = FALSE, extended = FALSE)

do_PathwayActivityHeatmap(
 sample,
 activities,
 group.by = NULL,
 split.by = NULL,
 slot = "scale.data",
 statistic = "norm_wmean",
 pt.size = 1,
 border.size = 2,
 values.show = FALSE,
 values.threshold = NULL,
 values.size = 3,
 values.round = 1,
 na.value = "grey75",
 legend.position = "bottom",
 legend.width = 1,
 legend.length = 20,
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 legend.type = "colorbar",
 font.size = 14,
 font.type = "sans",
 axis.text.x.angle = 45,
 enforce_symmetry = TRUE,
 min.cutoff = NA,
 max.cutoff = NA,
 number.breaks = 5,
 diverging.palette = "RdBu",
 diverging.direction = -1,
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = -1,
 sequential.palette = "YlGnBu",
 sequential.direction = 1,
 flip = FALSE,
 return_object = FALSE,
 grid.color = "white",
 border.color = "black",
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

activities

tibble | Result of running decoupleR method with progeny regulon prior knowledge.

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

split.by

character | Secondary metadata variable to further group (split) the output by. Has to be a character of factor column.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

statistic

character | DecoupleR statistic to use. One of:

• wmean: For weighted mean.

• norm_wmean: For normalized weighted mean.

• corr_wmean: For corrected weighted mean.

pt.size

numeric | Size of the dots.

border.size

numeric | Width of the border of the cells.

values.show

logical | Whether to add values as text in the heatmap.

values.threshold

numeric | Value from which the text color turns from black to white. If mode = "hvg", this is applied to both ends of the color scale.

values.size

numeric | Size of the text labels.

values.round

numeric | Decimal to which round the values to.

na.value

character | Color value for NA.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

enforce_symmetry

logical | Return a symmetrical plot axes-wise or continuous color scale-wise, when applicable.

min.cutoff, max.cutoff

numeric | Set the min/max ends of the color scale. Any cell/group with a value lower than min.cutoff will turn into min.cutoff and any cell with a value higher than max.cutoff will turn into max.cutoff. In FeaturePlots, provide as many values as features. Use NAs to skip a feature.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

diverging.palette

character | Type of symmetrical color palette to use. Out of the diverging palettes defined in brewer.pal .

diverging.direction

numeric | Either 1 or -1. Direction of the divering palette. This basically flips the two ends.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

flip

logical | Whether to invert the axis of the displayed plot.

return_object

logical | Returns the Seurat object with the modifications performed in the function. Nomally, this contains a new assay with the data that can then be used for any other visualization desired.

grid.color

character | Color of the grid in the plot. In heatmaps, color of the border of the cells.

border.color

character | Color for the border of the heatmap body.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_PathwayActivityHeatmap", passive = TRUE)
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds",
 package = "SCpubr"))
 # Define your activities object.
 progeny_activities <- readRDS(system.file("extdata/progeny_activities_example.rds",
 package = "SCpubr"))
 # General heatmap.
 out <- SCpubr::do_PathwayActivityHeatmap(sample = sample,
 activities = progeny_activities)
 p <- out$heatmaps$average_scores
 p
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_RankedEnrichmentHeatmap(
 sample,
 input_gene_list,
 assay = NULL,
 slot = NULL,
 scale.enrichment = TRUE,
 dims = 1:2,
 subsample = 2500,
 reduction = NULL,
 group.by = NULL,
 colors.use = NULL,
 colorblind = FALSE,
 raster = FALSE,
 interpolate = FALSE,
 nbin = 24,
 ctrl = 100,
 flavor = "Seurat",
 main.heatmap.size = 0.95,
 enforce_symmetry = ifelse(isTRUE(scale.enrichment), TRUE, FALSE),
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = -1,
 sequential.palette = "YlGnBu",
 sequential.direction = 1,
 font.size = 14,
 font.type = "sans",
 na.value = "grey75",
 legend.width = 1,
 legend.length = 20,
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 legend.type = "colorbar",
 legend.position = "bottom",
 legend.nrow = NULL,
 legend.ncol = NULL,
 legend.byrow = FALSE,
 number.breaks = 5,
 diverging.palette = "RdBu",
 diverging.direction = -1,
 axis.text.x.angle = 45,
 border.color = "black",
 return_object = FALSE,
 verbose = FALSE,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

input_gene_list

named_list | Named list of lists of genes to be used as input.

assay

character | Assay to use. Defaults to the current assay.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

scale.enrichment

logical | Should the enrichment scores be scaled (z-scored) for better comparison in between gene sets? Setting this to TRUE should make intra- gene set comparisons easier at the cost ot not being able to compare inter- gene sets in absolute values.

dims

numeric | Vector of 2 numerics indicating the dimensions to plot out of the selected reduction. Defaults to c(1, 2) if not specified.

subsample

numeric | Number of cells to subset for the analysis. NA will use all. Cells are selected at random.

reduction

character | Reduction to use. Can be the canonical ones such as "umap", "pca", or any custom ones, such as "diffusion". If you are unsure about which reductions you have, use Seurat::Reductions(sample). Defaults to "umap" if present or to the last computed reduction if the argument is not provided.

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

colors.use

list | A named list of named vectors. The names of the list correspond to the names of the values provided to metadata and the names of the items in the named vectors correspond to the unique values of that specific metadata variable. The values are the desired colors in HEX code for the values to plot. The used are pre-defined by the package but, in order to get the most out of the plot, please provide your custom set of colors for each metadata column!

colorblind

logical | Whether to use colorblind-friendly colors for categorical variables. In place when colors.use is not used. Allows for a maximum of 85 different classes within a categorical variable.

raster

logical | Whether to raster the resulting plot. This is recommendable if plotting a lot of cells.

interpolate

logical | Smoothes the output heatmap, saving space on disk when saving the image. However, the image is not as crisp.

nbin

numeric | Number of bins to use in AddModuleScore.

ctrl

numeric | Number of genes in the control set to use in AddModuleScore.

flavor

character | One of: Seurat, UCell. Compute the enrichment scores using AddModuleScore or AddModuleScore_UCell.

main.heatmap.size

numeric | A number from 0 to 1 corresponding to how big the main heatmap plot should be with regards to the rest (corresponds to the proportion in size).

enforce_symmetry

logical | Return a symmetrical plot axes-wise or continuous color scale-wise, when applicable.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

na.value

character | Color value for NA.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.nrow

numeric | Number of rows in the legend.

legend.ncol

numeric | Number of columns in the legend.

legend.byrow

logical | Whether the legend is filled by row or not.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

diverging.palette

character | Type of symmetrical color palette to use. Out of the diverging palettes defined in brewer.pal .

diverging.direction

numeric | Either 1 or -1. Direction of the divering palette. This basically flips the two ends.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

border.color

character | Color for the border of the heatmap body.

return_object

logical | Returns the Seurat object with the modifications performed in the function. Nomally, this contains a new assay with the data that can then be used for any other visualization desired.

verbose

logical | Whether to show extra comments, warnings,etc.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_RankedEnrichmentHeatmap", passive = TRUE)
 
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 
 # Genes have to be unique.
 genes <- list("A" = rownames(sample)[1:5],
 "B" = rownames(sample)[6:10],
 "C" = rownames(sample)[11:15])
 
 
 # This will query, for the provided components, the enrichment of the gene 
 # sets for all cells and plot them in the context of the cells reordered by 
 # the position alongside each dimensional reduction component. 
 p <- SCpubr::do_RankedEnrichmentHeatmap(sample = sample,
 input_gene_list = genes,
 nbin = 1,
 ctrl = 5,
 flavor = "Seurat",
 subsample = NA,
 dims = 1:2,
 verbose = FALSE)
 
 p
 
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_RankedExpressionHeatmap(
 sample,
 features,
 assay = NULL,
 slot = NULL,
 dims = 1:2,
 subsample = 2500,
 reduction = NULL,
 group.by = NULL,
 colors.use = NULL,
 colorblind = FALSE,
 raster = FALSE,
 interpolate = FALSE,
 nbin = 24,
 ctrl = 100,
 main.heatmap.size = 0.95,
 enforce_symmetry = TRUE,
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = -1,
 sequential.palette = "YlGnBu",
 sequential.direction = 1,
 font.size = 14,
 font.type = "sans",
 na.value = "grey75",
 legend.width = 1,
 legend.length = 20,
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 legend.type = "colorbar",
 legend.position = "bottom",
 legend.nrow = NULL,
 legend.ncol = NULL,
 legend.byrow = FALSE,
 number.breaks = 5,
 diverging.palette = "RdBu",
 diverging.direction = -1,
 axis.text.x.angle = 45,
 border.color = "black",
 return_object = FALSE,
 verbose = FALSE,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

features

character | Features to represent.

assay

character | Assay to use. Defaults to the current assay.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

dims

numeric | Vector of 2 numerics indicating the dimensions to plot out of the selected reduction. Defaults to c(1, 2) if not specified.

subsample

numeric | Number of cells to subset for the analysis. NA will use all. Cells are selected at random.

reduction

character | Reduction to use. Can be the canonical ones such as "umap", "pca", or any custom ones, such as "diffusion". If you are unsure about which reductions you have, use Seurat::Reductions(sample). Defaults to "umap" if present or to the last computed reduction if the argument is not provided.

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

colors.use

list | A named list of named vectors. The names of the list correspond to the names of the values provided to metadata and the names of the items in the named vectors correspond to the unique values of that specific metadata variable. The values are the desired colors in HEX code for the values to plot. The used are pre-defined by the package but, in order to get the most out of the plot, please provide your custom set of colors for each metadata column!

colorblind

logical | Whether to use colorblind-friendly colors for categorical variables. In place when colors.use is not used. Allows for a maximum of 85 different classes within a categorical variable.

raster

logical | Whether to raster the resulting plot. This is recommendable if plotting a lot of cells.

interpolate

logical | Smoothes the output heatmap, saving space on disk when saving the image. However, the image is not as crisp.

nbin

numeric | Number of bins to use in AddModuleScore.

ctrl

numeric | Number of genes in the control set to use in AddModuleScore.

main.heatmap.size

numeric | A number from 0 to 1 corresponding to how big the main heatmap plot should be with regards to the rest (corresponds to the proportion in size).

enforce_symmetry

logical | Return a symmetrical plot axes-wise or continuous color scale-wise, when applicable.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .

sequential.direction

numeric | Direction of the sequential color scale. Either 1 or -1.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

na.value

character | Color value for NA.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.nrow

numeric | Number of rows in the legend.

legend.ncol

numeric | Number of columns in the legend.

legend.byrow

logical | Whether the legend is filled by row or not.

number.breaks

numeric | Controls the number of breaks in continuous color scales of ggplot2-based plots.

diverging.palette

character | Type of symmetrical color palette to use. Out of the diverging palettes defined in brewer.pal .

diverging.direction

numeric | Either 1 or -1. Direction of the divering palette. This basically flips the two ends.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

border.color

character | Color for the border of the heatmap body.

return_object

logical | Returns the Seurat object with the modifications performed in the function. Nomally, this contains a new assay with the data that can then be used for any other visualization desired.

verbose

logical | Whether to show extra comments, warnings,etc.

plot.title.face, plot.subtitle.face, plot.caption.face, axis.title.face, axis.text.face, legend.title.face, legend.text.face

character | Controls the style of the font for the corresponding theme element. One of:

• plain: For normal text.

• italic: For text in itallic.

• bold: For text in bold.

• bold.italic: For text both in itallic and bold.

 # Check Suggests.
 value <- SCpubr:::check_suggests(function_name = "do_RankedExpressionHeatmap", passive = TRUE)
 
 if (isTRUE(value)){
 # Consult the full documentation in https://enblacar.github.io/SCpubr-book/
 
 # Define your Seurat object.
 sample <- readRDS(system.file("extdata/seurat_dataset_example.rds", package = "SCpubr"))
 
 # Genes have to be unique.
 genes <- rownames(sample)[1:15]
 
 
 # This will query, for the provided components, the expression of the genes 
 # for all cells and plot them in the context of the cells reordered by 
 # the position alongside each dimensional reduction component. 
 p <- SCpubr::do_RankedExpressionHeatmap(sample = sample,
 features = genes,
 nbin = 1,
 ctrl = 5,
 subsample = NA,
 dims = 1:2,
 verbose = FALSE)
 
 p
 
 } else if (base::isFALSE(value)){
 message("This function can not be used without its suggested packages.")
 message("Check out which ones are needed using `SCpubr::state_dependencies()`.")
 }

do_RidgePlot(
 sample,
 feature,
 group.by = NULL,
 split.by = NULL,
 assay = "SCT",
 slot = "data",
 continuous_scale = FALSE,
 legend.title = NULL,
 legend.ncol = NULL,
 legend.nrow = NULL,
 legend.byrow = FALSE,
 legend.position = "bottom",
 legend.width = 1,
 legend.length = 20,
 legend.framewidth = 0.5,
 legend.tickwidth = 0.5,
 legend.framecolor = "grey50",
 legend.tickcolor = "white",
 legend.type = "colorbar",
 colors.use = NULL,
 colorblind = FALSE,
 font.size = 14,
 font.type = "sans",
 axis.text.x.angle = 45,
 plot.title = NULL,
 plot.subtitle = NULL,
 plot.caption = NULL,
 xlab = NULL,
 ylab = NULL,
 use_viridis = FALSE,
 viridis.palette = "G",
 viridis.direction = 1,
 sequential.palette = "YlGnBu",
 sequential.direction = 1,
 plot.grid = TRUE,
 grid.color = "grey75",
 grid.type = "dashed",
 flip = FALSE,
 number.breaks = 5,
 plot.title.face = "bold",
 plot.subtitle.face = "plain",
 plot.caption.face = "italic",
 axis.title.face = "bold",
 axis.text.face = "plain",
 legend.title.face = "bold",
 legend.text.face = "plain"
)

sample

Seurat | A Seurat object, generated by CreateSeuratObject.

feature

character | Feature to represent.

group.by

character | Metadata variable to group the output by. Has to be a character of factor column.

split.by

character | Secondary metadata variable to further group (split) the output by. Has to be a character of factor column.

assay

character | Assay to use. Defaults to the current assay.

slot

character | Data slot to use. Only one of: counts, data, scale.data. Defaults to "data".

continuous_scale

logical | Whether to color the ridges depending on a categorical or continuous scale.

legend.title

character | Title for the legend.

legend.ncol

numeric | Number of columns in the legend.

legend.nrow

numeric | Number of rows in the legend.

legend.byrow

logical | Whether the legend is filled by row or not.

legend.position

character | Position of the legend in the plot. One of:

• top: Top of the figure.

• bottom: Bottom of the figure.

• left: Left of the figure.

• right: Right of the figure.

• none: No legend is displayed.

legend.length, legend.width

numeric | Length and width of the legend. Will adjust automatically depending on legend side.

legend.framewidth, legend.tickwidth

numeric | Width of the lines of the box in the legend.

legend.framecolor

character | Color of the lines of the box in the legend.

legend.tickcolor

character | Color of the ticks of the box in the legend.

legend.type

character | Type of legend to display. One of:

• normal: Default legend displayed by ggplot2.

• colorbar: Redefined colorbar legend, using guide_colorbar.

colors.use

character | Named vector of colors to use. Has to match the unique values of group.by or color.by (if used) when scale_type is set to categorical.

colorblind

logical | Whether to use colorblind-friendly colors for categorical variables. In place when colors.use is not used. Allows for a maximum of 85 different classes within a categorical variable.

font.size

numeric | Overall font size of the plot. All plot elements will have a size relationship with this font size.

font.type

character | Base font family for the plot. One of:

• mono: Mono spaced font.

• serif: Serif font family.

• sans: Default font family.

axis.text.x.angle

numeric | Degree to rotate the X labels. One of: 0, 45, 90.

plot.title, plot.subtitle, plot.caption

character | Title, subtitle or caption to use in the plot.

xlab, ylab

character | Titles for the X and Y axis.

use_viridis

logical | Whether to use viridis color scales.

viridis.palette

character | A capital letter from A to H or the scale name as in scale_fill_viridis.

viridis.direction

numeric | Either 1 or -1. Controls how the gradient of viridis scale is formed.

sequential.palette

character | Type of sequential color palette to use. Out of the sequential palettes defined in brewer.pal .