Pie chart or donut chart of cluster proportions inside spatial regions

Generates pie or donut charts to visualize the proportion of cells from different clusters within each spatial region (e.g., boundary or ring). The plot is faceted by region_id to show the composition of each spatial subregion. Optionally, percentage labels can be added with filtering based on a minimum proportion threshold.

Usage

plotStatsPie(
  cell_stats = NULL,
  plot_donut = FALSE,
  add_labels = TRUE,
  label_cutoff = 0.01,
  label_color = "white",
  label_size = 4,
  label_nudge_x = 0.1,
  colors = colors15_cheng
)

Arguments

cell_stats

A data frame containing cluster statistics per region, typically the output from statsCellsInside(). Must include columns region_id, cluster, and proportion.

plot_donut

Logical. If TRUE, a donut chart is generated; otherwise, a pie chart. Default is FALSE.

add_labels

Logical. If TRUE, percentage labels are displayed inside each slice. Default is TRUE.

label_cutoff

Numeric. Proportional threshold below which labels are hidden (e.g., 0.01 = 1%). Default is 0.01.

label_color

Character. Color of the percentage labels. Default is "white".

label_size

Numeric. Text size for percentage labels. Default is 4.

label_nudge_x

Numeric. Horizontal adjustment for label positioning. Default is 0.1.

colors

A vector of cluster colors. Default uses colors15_cheng.

Value

A ggplot2 object representing a faceted pie or donut chart per spatial region.

Examples

coords <- readRDS(system.file("extdata", "MouseBrainCoords.rds",
    package = "SpNeigh"
))

boundary_points <- getBoundary(
    data = coords, one_cluster = 2,
    eps = 120, minPts = 10
)
boundary_points <- subset(boundary_points, region_id == 2) # (Optional)
cells_inside <- getCellsInside(data = coords, boundary = boundary_points)
stats_cells <- statsCellsInside(cells_inside)

plotStatsPie(stats_cells, add_labels = FALSE)

plotStatsPie(stats_cells, label_cutoff = 0)

plotStatsPie(stats_cells, label_cutoff = 0.01)

plotStatsPie(stats_cells, plot_donut = TRUE)