章节与参考
本页完整说明已译为现代汉语;函数、参数、代码和原始数据标识保留原样。 用法说明
Fusion 是静态组合,不是坐标系。添加独立的 fusion_panel() 和 fusion_ribbon() 图层。标准 ggplot2::ggsave() 按目标尺寸重建面板与区间端面。源图及其标度保持独立。组合标度和主题用于跨面板连接、独立 Guide 及原生外层图形装饰。用 labs(title/subtitle/caption/tag) 和标准 plot Theme 元素配置组合标题、图注、背景及边距。子图轴及样式仍局部管理,组合本身没有笛卡尔数据轴。
参数
- center
ggchord基因组图(Circular、Chord、Collinear、Sankey、Radial)或另一张Fusion。嵌套生物学端点用完整面板路径选择。
- center_size
可选宽高比例,相对于扣除原生外层图形装饰及跨面板 Guide 后的组合内容区。NULL 分配可用空间。
- layout
"fixed"使用固定面板分配;"adaptive"还按物理宽高适配中心,并将原生跨面板 Guide 候选与面板区域联合测量。未锁定的 Guide 位置、方向和行列可自适应;显式原生设置及绝对尺寸框保持固定。允许多个外侧 Guide 位置。两种模式均按实际面板尺寸重建标签和图例,不缩小用户显式字体。无法满足空间约束时明确失败,不丢弃 keys。- allow_overlap
显式允许容器重叠,默认 FALSE 对重叠报错。TRUE 时后加入面板覆盖先加入者。连接使用互不重叠的原生 grid 裁剪,避免半透明填充反复累积。普通子图边距不会切断连接,后层容器仍覆盖前层内容。这是有意摆放,不是全局避障。
- center_box
可选中央分配:xmin、xmax、ymin、ymax 为四个比例值,相对于扣除外层装饰和 Guide 后的组合内容区;也可提供四个绝对 grid 单位。与 center_size 互斥,见 fusion_panel()。
- guides
"keep"(默认)将子图图例保留在各自面板。"collect"将原生外侧图例收集到组合边缘,并对视觉内容相同的图例去重。不合并或重新训练各面板的标度;共享语义时应使用相同的limits、breaks及guide样式。即使标题相同,不同图例也会分别保留。子图legend.position = "none"继续隐藏;内部图例不能收集。嵌套组合的跨面板图例保留在其组合内部。收集后的图例框按设备可用宽度换行。
返回值
可打印并传给ggplot2::ggsave()的Fusion对象。
示例
R · 示例代码
library(dplyr)
data(seq_data_example)
seqs <- seq_data_example |> select(accver, length) |> slice_head(n = 2)
center <- ggchord(seqs) + geom_seq() + coord_chord()
detail <- ggchord(seqs) + geom_seq() + coord_collinear(seq_axis = "vertical")
ggchord_fusion(center, guides = "collect") +
fusion_panel(detail, id = "detail", side = "right") +
ggplot2::labs(title = "Independent genomic views",
caption = "Source: bundled sequence records")
