添加序列名称图层 — geom_seq

0.16.6 文档

本页完整说明已译为现代汉语；函数、参数、代码和原始数据标识保留原样。使用教程

全站目录 · 按任务查找

在每条序列弧中点放置名称，可设置径向偏移、旋转、字号、文字方向和对齐。

用法

代码geom_seq_label(
  mapping = NULL,
  data = NULL,
  seq_label_radius = 1,
  seq_label_rotation = NULL,
  labels = NULL,
  seq_label_orientation = c("arc", "horizontal"),
  seq_label_hjust = NULL,
  seq_label_vjust = NULL,
  check_overlap = FALSE,
  position = "identity",
  show.legend = FALSE,
  inherit.aes = FALSE,
  ...
)

参数

mapping: 默认 NULL，使用预计算数据。
data: 默认 NULL，从布局自动获取。
seq_label_radius: 可选数值/向量，标签径向位置相对序列弧半径的倍数：1 在弧上，> 1 在外侧（远离弦图中心），< 1 在内侧，默认 1。不能与 coord_collinear() 同时显式提供；该布局将序列名放在水平轨道左端旁。
seq_label_rotation: 可选数值/向量，在沿弧方向上追加的旋转角度，默认 NULL（0 度）；seq_label_orientation = "horizontal" 时忽略。
labels: 可选字符向量，覆盖名称文字，默认使用 geom_seq() 中的标签或序列 ID。
seq_label_orientation: 文字方向，默认 "arc"。"arc" 沿序列弧旋转并保持可读，"horizontal" 水平绘制并向远离弦图中心的方向延伸。
seq_label_hjust: 可选数值/向量，水平对齐，默认 NULL。沿弧方向默认 -0.2，使文字位于序列内侧附近；seq_label_orientation = "horizontal" 时自动选择，使文字向中心外延伸。
seq_label_vjust: 可选数值/向量，垂直对齐，默认 NULL（0.5）。
check_overlap: 逻辑值，默认 FALSE。TRUE 时跳过与已绘标签重叠的文字，对应 ggplot2 的 geom_text() 选项。
position, show.legend, inherit.aes: 标准 ggplot2 图层参数。
...: 传给 geom_text() 的其他参数。

返回值

一个 ggplot2 图层。

示例

代码library(dplyr)
data(seq_data_example)
seqs <- seq_data_example |>
  select(accver, length)
ggchord(seq_data = seqs) +
  geom_seq() +
  geom_seq_label()