跳到正文
章节与参考

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

在已注册基因组面板中标记真实源区间,连接独立基因组图或已注册字符细节中的同一区间。源图和细节都可以本身是嵌套Fusion。返回Fusion,不新增Coord,也不裁剪图片。普通ggsave按实际目标尺寸重建面板、高亮及引线。

用法

R · 示例代码
magnify_ggchord(
  plot,
  region,
  detail_plot,
  side = c("right", "top", "left", "bottom"),
  center_size = NULL,
  detail_size = NULL,
  connector = c("leader", "none", "envelope"),
  colour = "#B45309",
  alpha = 0.2,
  highlight_width = 1.5,
  linewidth = 0.35,
  linetype = 2,
  detail_box = NULL,
  allow_overlap = FALSE,
  center_box = NULL,
  route = c("direct", "avoid"),
  guides = c("keep", "collect"),
  frame_region = NULL
)

参数

plot

已注册的ggchord基因组源图或嵌套Fusion。

region

非空数据框,包含原始来源一基闭区间坐标 accver、start、end。默认边界为有序正整数。可选 instance 和 detail_instance 为每行精确选择源及细节显示实例;歧义会报错。显式 wrap = TRUE 允许 start > end 的跨环状源原点区间。两个选定叶面板必须声明相同的完整源长度,字符来源须使用 as_ggchord_alignment(circular = TRUE)。区间绘为两段,只保留两个外侧边界引线。细节列表使用 detail_panel 列逐行选择目标。嵌套叶使用 detail/center 等完整路径;可选 source_panel 同样选择 center 下的源叶。歧义的容器选择会报错。

detail_plot

显式已注册ggchord基因组图、嵌套Fusion、来自 register_ggchord_alignment() 的字符图,或按唯一名称给出的图列表。每个面板至少有一个选区,center 是保留名。选区在两端均须完整可见,bp/aa单位一致。字符图须显式注册源/对齐列映射,未注册的普通图会拒绝。

side

fusion_panel() 中的命名方位,包括斜向。对于图形列表,提供按面板 ID 命名的字符向量;固定方位互异,auto 可以重复以自动分配外围位置。每个输入选区仍须明确选择其 detail_panel。

center_size, detail_size

可选面板宽高比例,沿用 ggchord_fusion() 与 fusion_panel()。单细节默认保留较小源面板和较宽细节区域。多细节可用命名尺寸列表或NULL沿用Fusion默认分配,center_size同样沿用Fusion规则。超界报错,重叠必须显式allow_overlap。

connector

"leader" 为每行绘制两条装饰性边界引线;"none" 只保留高亮。"envelope" 按来源/细节面板对合组选区,逐个描绘精确源高亮带的边框,并为细节序列及其原生标签加框,排除子图标题和图例。两条引线从真实源高亮带的边缘连到细节框;不以带留白的合并大框包住多个源选区。细节框只表示展示范围,不代表单个基因组区间。引线不是生物学色带或比对。

colour

固定的高亮与引线颜色。

alpha

高亮透明度,范围 [0,1];引线使用不透明颜色。 字符选区使用无填充单元格描边,保留字形对比度和残基底色,不受此透明度影响。

highlight_width

正数,以物理 mm 指定高亮带宽。 字符面板改为沿实际单元格高度描边。

linewidth

非负引线宽度,采用通常的 ggplot2 约定。

linetype

引线线型,默认虚线。

detail_box

显式细节区域,替代side/detail_size,沿用fusion_panel()的box约定。多图须用覆盖全部面板的命名列表;物理区域按实际目标尺寸重新检查。

allow_overlap

按ggchord_fusion()显式允许容器重叠,后加入者覆盖先加入者,默认FALSE。

center_box

显式源区域分配,替代center_size。

route

默认直接连接边界引线;avoid 绕开实测的其他容器及原生文字/图例包围框。端点固定,找不到可行路径时明确失败,不隐藏选区。

guides

子图图例放置方式,传递给ggchord_fusion()。默认"keep";使用"collect"共享原生外侧图例。

frame_region

可选数据框,按 region 的相同行顺序提供每行有序正整数源坐标 start/end。只改变源图框和引线离开点,不改变 region、细节数据或实测放大倍率;默认 NULL 使用精确选区。可选 accver 必须逐行匹配 region。框必须在同一源实例中完整可见;跨原点框或选区须先显式拆分。

返回值

ggchord_fusion() 对象。export_ggchord_fusion() 另返回毫米单位的 focus_regions、focus_fronts 和 leaders,以及保留原始选区、精确实例、源 origin 和采样物理路径长度比的 focus_region_data(元数据同名不会冲突)。派生表以 region_row 标识原始输入行,以 region_piece 标识跨原点拆分段;原始输入保持完整。统计口径记为 explicit_detail_plot。引线不进入 connections 或 relationship_data。leader_paths 含最终装饰折线顶点。路由在实测物理空间内确定,不保证全局最优布局,也不自动重建图层;若细节分配没有放大选区,实测比率可能小于一。 envelope引线以组内第一个region_row为导出键;focus_regions$leader_group记录每个成员选区对应的组键。 frame_start/frame_end 独立记录源图框范围,start/end仍为真实选区;显式框输入保存在 focus_frame_region_data。

详细说明

请用 focus_ggchord_data() 或其他有源坐标说明的数据流程显式构建 detail_plot。此函数不复制或筛选任意图层,不静默决定 Stat 的 local/global 口径。细节图拥有自己的数据、映射、统计和标签;解析同一区间时使用原始源原点,包括改名或重复聚焦窗口。

示例

R · 示例代码
library(dplyr)
data(plasmid_example_pUC19)
whole <- ggchord(plasmid_example_pUC19) + geom_seq() + coord_circular()
region <- tibble(accver = "pUC19", start = 101, end = 1900)
local <- focus_ggchord_data(plasmid_example_pUC19, loci = region)
detail <- ggchord(local$seq_data) +
  geom_seq() + coord_collinear(seq_axis = "vertical")
magnify_ggchord(whole, region, detail)

magnify_ggchord(whole, region, detail,
  center_box = c(.02, .35, .2, .8), detail_box = c(.45, .98, .1, .9),
  connector = "envelope")

magnify_ggchord(whole, region, detail,
  frame_region = tibble(start = 81, end = 1920))

搜索说明

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