章节与参考
本页完整说明已译为现代汉语;函数、参数、代码和原始数据标识保留原样。 用法说明
使用标准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")
