geom_feature_label: A 'ggplot2' geom to add text labels to point genetic features

In gggenes: Draw Gene Arrow Maps in 'ggplot2'

A 'ggplot2' geom to add text labels to point genetic features

Description

geom_feature_label() adds text labels to features drawn with geom_feature().

Usage

geom_feature_label(
  mapping = NULL,
  data = NULL,
  stat = "identity",
  position = "identity",
  na.rm = FALSE,
  show.legend = FALSE,
  inherit.aes = FALSE,
  feature_height = unit(4, "mm"),
  label_height = unit(3, "mm"),
  ...
)

Arguments

mapping, data, stat, position, na.rm, show.legend, inherit.aes, ...	As standard for ggplot2. inherit.aes is set to FALSE by default, as features are not likely to share any plot aesthetics other than y.
feature_height	grid::unit() object giving the offset from the molecule line to the inner edge of the label's bounding box. Can be set as a negative value to position labels on the opposite side of the molecule line. Defaults to 4 mm, which provides a 1 mm gap between feature and label when used with the default feature_height of geom_feature() (3 mm).
label_height	grid::unit() object giving the height of the label text. Defaults to 3 mm.

Details

Standard 'ggplot2' aesthetics for text are supported (see Aesthetics).

Aesthetics

• x (required; position of the feature)

• y (required; molecule)

• label (required; the label text)

• forward (optional; will draw text in the appropriate location for features with angled arrowheads)

• colour

• size

• alpha

• family

• fontface

• angle

See Also

geom_feature()

Examples

ggplot2::ggplot(example_genes, ggplot2::aes(xmin = start, xmax = end,
                                            y = molecule, fill = gene)) +
  geom_gene_arrow() +
  geom_feature(data = example_features, ggplot2::aes(x = position, y = molecule,
                                                     forward = forward)) +
  geom_feature_label(data = example_features,
                     ggplot2::aes(x = position, y = molecule, label = name,
                                  forward = forward)) +
  ggplot2::facet_wrap(~ molecule, scales = "free")

gggenes documentation built on July 5, 2026, 9:06 a.m.