本页完整说明已译为现代汉语；函数、参数、代码和原始数据标识保留原样。 使用教程
全站目录 · 按任务查找
绘制弦图中的基因注释文字。它独立于 geom_gene()，应加在 geom_gene() 后为箭头标注文字。
用法
代码
geom_gene_label(
mapping = NULL,
data = NULL,
label_orientation = "horizontal",
label_side = "outside",
label_overlap = "hide",
label_rotation = NULL,
label_radial_offset = 0.04,
label_circum_offset = NULL,
label_circum_limit = NULL,
label_wrap = NULL,
position = "identity",
show.legend = FALSE,
inherit.aes = FALSE,
...
)参数
- mapping
默认 NULL，使用预计算数据。
- data
默认 NULL，从布局自动获取。
- label_orientation
文字相对序列路径的方向，默认
"horizontal"，支持"radial"、"tangent"或"horizontal"。- label_side
标签侧向，默认
"outside"。可放在弦图外侧、按链选择"auto"侧，或强制"inside"。- label_overlap
固定标签碰撞策略，默认
"hide"。"hide"省略后出现的冲突标签，"nudge"使用历史温和调整，"allow"保留全部请求位置。因此"hide"模式下可通过输入行顺序设置优先级。- label_rotation
可选数值、向量或列表，旋转角度，默认 0。
- label_radial_offset
可选数值、向量或列表，径向偏移，默认 0.04。
- label_circum_offset
可选数值、向量或列表，周向偏移，默认 0。
- label_circum_limit
可选逻辑值、向量或列表，是否限制周向偏移，默认 TRUE。
- label_wrap
数值或 NULL，默认 NULL。按指定字符数（如 15）换行，使长注释更窄、减少重叠。
- position
位置调整。标签使用独立数据或没有几何层时，应提供与基因/注释层相同的
position_feature_stack()。在coord_collinear()中，未显式提供 Position 的标签共享匹配几何层的轨道；显式标签 Position 不移动几何。唯一feature_id列允许取子集或重排，但标识、区间和链必须一致。多个匹配几何层需要显式标签 Position 或无歧义注释 ID。- show.legend, inherit.aes
标准 ggplot2 图层参数。
- ...
传给
geom_text()的其他参数。
返回值
一个 ggplot2 图层。需要标签自动避开彼此及基因并带引导线时，改用 geom_gene_label_repel()。
详细说明
这是确定性的固定位置图层，默认将标签放在序列外侧，并按输入行顺序省略冲突项。label_overlap = "nudge" 保留历史温和调整，"allow" 在请求位置绘制全部标签。需要带引导线的自动布局时使用 geom_gene_label_repel()。