跳到正文
章节与参考

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

使用标准qaccver/saccver与qstart/qend/sstart/send字段。可选qpanel/spanel和q_instance/s_instance明确选择面板与显示实例;仅在候选唯一时推断缺省选择。query/subject角色不依赖面板摆放方位。区间为一基闭区间,按输入方向保留跨度为[min-1,max]的前缘;单位置区间也有非零宽度。要求区间完整可见;需要拆分或聚焦时,先显式准备来源数据。

用法

R · 示例代码
fusion_ribbon(
  data,
  mapping = NULL,
  qpanel = NULL,
  spanel = NULL,
  gradient = FALSE,
  tip = c("none", "subject"),
  allow_repeated = FALSE,
  curvature = 0.3,
  fill = NULL,
  colour = NA,
  alpha = 0.35,
  linewidth = 0.25,
  linetype = 1,
  show.legend = NA,
  route = c("direct", "avoid", "bundle"),
  route_width = 0.8
)

参数

data

保留原始端点的关系数据框。

mapping

标准ggplot2美学映射,可映射fill、colour、alpha、linewidth和linetype。存在pident且未明确指定fill时,默认使用Identity映射及0/50/80/90/95/100刻度。组合层使用标准scale_fill_*等标度;各面板的角色标度只在其内部生效。

qpanel, spanel

可选的固定面板ID,不得与同名数据列同时指定。

gradient

显式启用query到subject的序列颜色插值,不得与固定fill或fill映射同时使用。

tip

"none"或装饰性的"subject"尖头。即使绘制尖头,仍导出完整来源前缘。

allow_repeated

显式允许重复展示source_hsp_id。

curvature

控制点距离相对于端点间距的比例,范围为[0,1]。接近切向进入时选择方向一致的垂直端点法向,避免人为S形双弯;不重排有序来源前缘。

fill, colour, alpha, linewidth, linetype

固定样式优先于对应映射。没有pident时,默认填充为steelblue。

show.legend

标准ggplot2图例选择:NA按映射自动决定;TRUE/FALSE或命名逻辑向量控制参与图例的美学。

route

默认 direct 绘制 Bezier 连接带;avoid 在实测障碍间寻找路径。bundle 要求显式 route_group 字符列,在同一图层的每组及有序面板对内共享通道;每条观测、源行、完整端面及样式仍独立,不聚合证据,也不暗示生物学流动。avoid 保留完整区间端面,中间使用较窄的多边形通道。无法找到无碰撞路线时明确报错。

route_width

avoid/bundle 通道的正宽度,单位毫米,默认 .8。这是绘制宽度,不是比对长度或统计权重。

返回值

供ggchord_fusion()使用的组件。

示例

R · 示例代码
data(seq_data_example)
data(ribbon_data_example)
p <- ggchord(seq_data_example) + geom_seq()
ggchord_fusion(p) +
  fusion_panel(p + coord_collinear(), "detail") +
  fusion_ribbon(ribbon_data_example, qpanel = "center", spanel = "detail")

搜索说明

↑ ↓ 选择 · Enter 打开 · Esc 关闭;也可按任务查找。 API 与功能