taxatree_plot_labels: Add labels to taxatree plots/key

In david-barnett/microViz: Microbiome Data Analysis and Visualization

Add labels to taxatree plots/key

Description

Finer control over label drawing for taxatree_plotkey (with .draw_label = FALSE), and label drawing for taxatree_plots output too.

Usage

taxatree_plot_labels(
  p,
  circular = TRUE,
  taxon_renamer = identity,
  fun = ggrepel::geom_text_repel,
  label_var = "label",
  x_nudge = 0.1,
  y_nudge = 0.025,
  rotate = 0,
  fontface = "bold",
  size = 2.5,
  colour = "grey15",
  max.overlaps = Inf,
  min.segment.length = 0,
  segment.size = 0.15,
  segment.color = "grey15",
  point.padding = 0.05,
  box.padding = 0.1,
  seed = NA,
  ...
)

Arguments

p	taxatree_plotkey or taxatree_plots output plot
circular	is the plot layout circular? labels are drawn differently for circular trees
taxon_renamer	function that takes taxon names and returns modified names for labels
fun	ggrepel labelling function: geom_text_repel or geom_label_repel
label_var	name of variable in taxatree_stats that indicates which taxa to label
x_nudge	absolute amount by which the initial position of taxon labels is nudged (relevant only for circular layouts, use nudge_x for other layouts)
y_nudge	absolute amount by which the initial position of taxon labels is nudged (relevant only for circular layouts, use nudge_y for other layouts)
rotate	angle to rotate labels' outer edges away from horizontal (relevant only for circular layouts, use angle for other layouts)
fontface	fontface of label text
size	size of labels
colour	colour of label outlines and text
max.overlaps	max number of overlapping labels tolerated
min.segment.length	min length of label line segment to bother drawing
segment.size	thickness of line segment
segment.color	colour of line segment
point.padding	padding around node points (for label positioning)
box.padding	padding around labels/text (for label positioning)
seed	set this for reproducible label positions
...	Arguments passed on to ggrepel::geom_text_repel arrow specification for arrow heads, as created by arrow force Force of repulsion between overlapping text labels. Defaults to 1. force_pull Force of attraction between a text label and its corresponding data point. Defaults to 1. max.time Maximum number of seconds to try to resolve overlaps. Defaults to 0.5. max.iter Maximum number of iterations to try to resolve overlaps. Defaults to 10000. xlim,ylim Limits for the x and y axes. Text labels will be constrained to these limits. By default, text labels are constrained to the entire plot area. direction "both", "x", or "y" – direction in which to adjust position of labels verbose If TRUE, some diagnostics of the repel algorithm are printed

david-barnett/microViz documentation built on April 17, 2025, 4:25 a.m.