Draw Grouped Bar Charts with Facets — draw

This function creates grouped bar charts with optional faceting. It is useful for comparing category-specific values across different groups and panels.

draw_barchart(
  data,
  x,
  y,
  group = NULL,
  facet = NULL,
  facet_label = NULL,
  y_label = NULL,
  rev_group = FALSE,
  grid = NULL,
  topn = NULL,
  axis = NULL,
  bar_side = NULL,
  bar_way = NULL,
  gap = NULL,
  csize = 0.8,
  space = 0.9,
  adj = -0.01,
  gl = NULL,
  cols = NULL,
  palette = "Peach",
  x_label_side = 1,
  legend = FALSE,
  legend_label = NULL,
  legend_pos = c(0.4, 0.2),
  dens = c(-1, -1),
  overlay = FALSE
)

Arguments

data: A data.frame or tibble containing the input data.
x: The categorical variable (unquoted) for the x-axis.
y: The numerical variable (unquoted) for the y-axis (bar height).
group: Optional grouping variable (unquoted) used for color/fill aesthetics.
facet: Optional faceting variable (unquoted) for splitting the data into panels.
facet_label: Optional character vector of labels corresponding to each facet.
y_label: Optional y-axis label or vector of labels for facets.
rev_group: Reverse the bar position of group variables.
grid: A numeric vector of length 2 indicating the layout (rows, columns) of the plot grid.
topn: Number of top x categories to display in each group/panel.
axis: Optional vector of breaks for the y-axis. If NULL, computed automatically.
bar_side: Integer indicating the side of bars: 1 = left, 2 = right.
bar_way: Integer for bar layout: 1 = one-sided, 2 = mirrored.
gap: Horizontal spacing between bars and y-axis (default depends on x_label_side).
csize: Character size scaling factor (default = 0.8).
space: Vertical space between bars (default = 0.9).
adj: Vertical adjustment of x-label text (default = -0.01).
gl: Integer. Indicating the line type of the grids.
cols: Optional vector of colors for bars.
palette: Character. Name of palette colors.
x_label_side: Side to place x-labels: 1 = inside, 2 = outside (default = 1).
legend: Logical. Whether to show a legend (default = FALSE).
legend_label: Optional character vector for legend labels.
legend_pos: Optional, numeric vector of length 2 for legend position.
dens: A numeric vector of two density values for bar shading (default = c(-1, -1)).
overlay: Logical. Whether to overlay bars from two groups in the same panel.

Value

A base R plot with grouped bar charts, optionally faceted.

Examples

data("canregs")
asr <- create_asr(canregs[[1]], year, sex, cancer, event = "fbs")
asr <- cr_filter(asr, drop = c("total", "others"))
draw_barchart(asr, x = cancer, y = cr, group =  year, facet = sex)