跳到正文
章节与参考

模块一 · 多序列关系 · 第 5 节,共 16 节

1.4 区间、点与跨行连接

下载 R 脚本包含本页准备与全部步骤。文件示例须先下载输入;预览和保存调用保留。
本页目录
R · 示例代码
library(ggchord)
library(dplyr)
准备数据与配置(展开)
R · 示例代码
p_chord_backbone <- ggchord(seq_data = seq_data_example) +
  geom_seq() +
  geom_seq_label() +
  coord_chord()
R · 示例代码
chord_links <- head(ribbon_data_example, 1)

1 改变连接带经过的位置

R · 示例代码
p_chord_backbone <- ggchord(seq_data = seq_data_example) +
  geom_seq() +
  geom_seq_label() +
  coord_chord()

chord_links <- head(ribbon_data_example, 1)

p_chord_ribbon <- p_chord_backbone +
  geom_link_ribbon(data = chord_links)
view_ggchord(p_chord_ribbon, width = 7, height = 7, units = "in")
加入一条区间比对带
加入一条区间比对带 · 打开高清原图

默认控制点在布局原点。将 link_ctrl_point 设为 c(0, 0.8),让控制点在布局坐标中上移。对比带在图中央的走向,两端仍对应原来的区间。

R · 示例代码
p_chord_route <- p_chord_backbone +
  geom_link_ribbon(data = chord_links, link_ctrl_point = c(0, 0.8))
view_ggchord(p_chord_route, width = 7, height = 7, units = "in")
向上移动连接带的控制点
向上移动连接带的控制点 · 打开高清原图

控制点用旋转前的布局坐标。默认旋转为 0°,所以 (0, 0.8) 沿图的正上方牵引连接带。改变整图旋转后,控制点也随图一起转动。贝塞尔曲线由控制点牵引,曲线一般不经过该点。

2 用一个真实 CDS 比较避障

取 MT108731.1 上的 48,053–49,111 bp CDS。它在这条比对的查询区间内。这里明确把正链箭头向内移 0.05 个布局单位,使箭头落在连接带一侧。

R · 示例代码
chord_obstacle <- subset(gene_data_example, accver == "MT108731.1" & start == 48053)
chord_obstacle$strand <- chord_obstacle$source_strand
p_chord_obstacle <- p_chord_backbone +
  geom_gene(data = chord_obstacle, position = position_strand(c("+" = -0.05)))

p_chord_no_avoid <- p_chord_obstacle +
  geom_link_ribbon(data = chord_links, link_avoid = "none")
view_ggchord(p_chord_no_avoid, width = 7, height = 7, units = "in")
固定间距下连接带与 CDS 重叠
固定间距下连接带与 CDS 重叠 · 打开高清原图

link_avoid = "none" 使用固定端点间距。沿MT108731.1 骨架靠近 49 kb 的位置看,比对带会盖住部分箭头。

R · 示例代码
p_chord_smooth <- p_chord_obstacle +
  geom_link_ribbon(data = chord_links, link_avoid = "smooth")
view_ggchord(p_chord_smooth, width = 7, height = 7, units = "in")
连接带在 CDS 附近平滑让位
连接带在 CDS 附近平滑让位 · 打开高清原图

link_avoid = "smooth" 在 CDS 附近平滑增大间距。沿同一段MT108731.1 骨架看,带的边缘局部缩进去,给箭头腾出空间。默认的 "uniform" 会让同一个端点区间采用一致的避让间距。如果指定数值 link_gap,就直接使用该间距。

3 用线连两个位置,用色带标区间

R · 示例代码
chord_query_region <- data.frame(
  accver = chord_links$qaccver, start = chord_links$qstart, end = chord_links$qend
)
chord_midpoints <- transform(chord_links,
  qpos = floor((qstart + qend) / 2), spos = floor((sstart + send) / 2)
)
p_chord_markers <- p_chord_backbone +
  geom_seq_region(data = chord_query_region, region_side = "outside") +
  geom_link_line(data = chord_midpoints, link_type = "straight",
                 arrow = grid::arrow(length = grid::unit(2, "mm")))
view_ggchord(p_chord_markers, width = 7, height = 7, units = "in")
区间高亮与有向点连接
区间高亮与有向点连接 · 打开高清原图

外侧色带标出查询序列的完整比对区间。 region_side = "outside" 将它放在骨架外侧。直线只连接两个区间的中点,arrow 指向目标端。需要看两端各覆盖多长时,使用比对带。

下一节放置序列和基因标签。

4 分支、筛选与固定样式的边界

参数 当前默认 什么时候改变与注意事项
link_branch "none" query/subject 让相同端点共享主干;端点不相同不能凭空组成同源分支
link_branch_fraction 0.15 主干相对最短成员的长度比例,范围 (0, 0.5];仅启用分支时有意义
pairs NULL 显式选择序列对;不创建新比对记录
link_gap NULL 交给避障策略;显式数值覆盖自动间距
link_avoid "uniform" none 固定间距,smooth 局部避让;不避让文字与引线
link_ctrl_point NULL 弦图默认原点;共线性依据端点推导;不是 bp 坐标
nonadjacent_linewidth 0.4 只控制共线性非相邻显示行边框,0 沿用普通 linewidth

固定 fill/alpha/colour/linewidth 放在 aes() 外;数据差异映射到 ribbon 专用属性并配匹配标度。显式固定值优先于相应映射,所以映射透明度时省略固定 alpha。改变颜色不能证明不同生物学关系。完整签名见 geom_link_ribbon()。

接着用共享端点分支与点连接比较分支主干、主干比例及曲线/直线。

5 跨行连接

准备数据与配置(展开)
R · 示例代码
p_linear_base <- ggchord(seq_data = seq_data_example) +
  geom_seq() +
  geom_seq_label() +
  coord_collinear()
R · 示例代码
chord_links <- head(ribbon_data_example, 1)
R · 示例代码
p_linear_link <- p_linear_base + geom_link_ribbon(data = chord_links)

6 允许跨行连接

R · 示例代码
cross_link <- head(subset(ribbon_data_example,
  qaccver == "MT108731.1" & saccver == "OQ646790.1"), 1)
p_linear_cross <- p_linear_link +
  geom_link_ribbon(data = cross_link, adjacent_only = FALSE)
view_ggchord(p_linear_cross, width = 8, height = 5, units = "in")
跨过第二行的连接带
跨过第二行的连接带 · 打开高清原图

只有 Collinear 的相邻行连接默认使用细实线,跨行连接默认使用较粗虚线。Chord、Radial 和 Sankey 不应用这个自动跨行样式,默认使用普通实线。普通线宽由 linewidth 控制;跨行线宽由 nonadjacent_linewidth 单独控制,默认 0.4。

第二个连接层只接收一条第一行到第三行的比对。adjacent_only = FALSE 让这条带可见,默认虚线轮廓提示它跨过中间一行。原来第一、二行的连接仍由第一个层绘制。

7 单独设置跨行边框

R · 示例代码
p_cross_width <- p_linear_link +
  geom_link_ribbon(data = cross_link, adjacent_only = FALSE,
    nonadjacent_linewidth = 0.8)
view_ggchord(p_cross_width, width = 8, height = 5, units = "in")
单独加粗跨行连接带边框
单独加粗跨行连接带边框 · 打开高清原图

nonadjacent_linewidth = 0.8 加粗第二个图层中的跨行带,不改变第一个图层的相邻带,也不改变线型。

R · 示例代码
p_cross_same <- p_linear_link +
  geom_link_ribbon(data = cross_link, adjacent_only = FALSE,
    linewidth = 0.2, nonadjacent_linewidth = 0)
view_ggchord(p_cross_same, width = 8, height = 5, units = "in")
跨行边框沿用普通线宽
跨行边框沿用普通线宽 · 打开高清原图

设为 0 时,跨行带使用该图层的普通 linewidth,这里是 0.2。它仍是虚线。若使用 aes(linewidth = ...) 映射,实际线宽由映射及标度控制。

8 共享分支与点连接

9 准备共享端点的示意输入

R · 示例代码
library(ggchord)
branch_seqs <- data.frame(accver = c("query", "target_a", "target_b"), length = 1000)
branch_links <- data.frame(
  qaccver = c("query", "query"), saccver = c("target_a", "target_b"),
  qstart = 200, qend = 600, sstart = c(100, 300), send = c(500, 700)
)
branch_base <- ggchord(branch_seqs, ribbon_data = branch_links) +
  geom_seq() + geom_seq_label() + coord_chord(rotation = 0)

三条示意序列各为 1000 bp。两条连接共用 query 的 200–600 bp,分别到两个 target 的不同区间。所有坐标为一基闭区间。每张图固定 9 × 7 英寸;不为改变分支重写端点。

10 独立带与共享 query 主干

R · 示例代码
p_comparebranchnone <- branch_base + geom_link_ribbon(link_branch = "none")
view_ggchord(p_comparebranchnone, width = 9, height = 7, units = "in")
简化示意:相同 query 区间的两条带独立绘制。
简化示意:相同 query 区间的两条带独立绘制。 · 打开高清原图

默认 link_branch = "none" 时两条带各自走向目标,query 端附近可以重叠。

R · 示例代码
p_comparebranchquery <- branch_base + geom_link_ribbon(link_branch = "query")
view_ggchord(p_comparebranchquery, width = 9, height = 7, units = "in")
同一简化输入,只启用 query 分支,默认比例 0.15。
同一简化输入,只启用 query 分支,默认比例 0.15。 · 打开高清原图

只改成 "query",完全相同的 query 端点可形成共享主干。仅仅区间有重叠不等于端点完全相同;真实数据若没有合适组,启用分支也可能不改变图。"subject" 则以相同 subject 端点分组。

11 改变主干比例

R · 示例代码
p_comparebranchfraction <- branch_base +
  geom_link_ribbon(link_branch = "query", link_branch_fraction = 0.35)
view_ggchord(p_comparebranchfraction, width = 9, height = 7, units = "in")
保持 query 分支,只将主干比例从 0.15 改为 0.35。
保持 query 分支,只将主干比例从 0.15 改为 0.35。 · 打开高清原图

与 query 分支图相比,仅把 link_branch_fraction 从默认 0.15 改为 0.35。主干相对最短成员变长;它不是 identity、相似性概率或新的比对长度。

参数 默认 作用与限制
link_branch "none" none/query/subject;选择共享哪一端
link_branch_fraction 0.15 范围 (0, 0.5];none 时不产生共享主干
link_ctrl_point NULL 分支时影响远端形状,接合点由主干确定
pairs NULL qaccver/saccver 表选择已有序列对,不生成比对

点连接要显式提供 qpos/spos,不能把区间表直接当作点表。本例选择两个区间的中点;这项选择会丢失带宽所表达的区间长度,因此先说明选点依据。

R · 示例代码
point_links <- data.frame(
  qaccver = branch_links$qaccver, saccver = branch_links$saccver,
  qpos = (branch_links$qstart + branch_links$qend) / 2,
  spos = (branch_links$sstart + branch_links$send) / 2
)
R · 示例代码
p_comparelinkcurve <- branch_base + geom_link_line(data = point_links, link_type = "curve")
view_ggchord(p_comparelinkcurve, width = 9, height = 7, units = "in")
同一简化输入,用曲线连接区间中点。
同一简化输入,用曲线连接区间中点。 · 打开高清原图

默认 link_type = "curve" 用曲线连接位置。

R · 示例代码
p_comparelinkstraight <- branch_base + geom_link_line(data = point_links, link_type = "straight")
view_ggchord(p_comparelinkstraight, width = 9, height = 7, units = "in")
只把 link_type 改为 straight,中点锚定不变。
只把 link_type 改为 straight,中点锚定不变。 · 打开高清原图

只改为 "straight";位置、输入和尺寸相同。需要有向箭头时另加 arrow = grid::arrow(),其方向表达 query 到 subject 的绘图约定,不能单独作为基因链或转录证据。

13 真实数据、模式与操作示例

真实比对必须保留自己的 q/s 端点。若没有完全相同的端点,不要为了形成主干而改写坐标。筛选与聚束见连接处理,几何分支不会自动完成这些统计操作。

弦图与共线性图可用这些连接层;单序列圆图拒绝 ribbon/link。共线性图的邻接筛选仍适用,要显示跨行带先检查 adjacent_only 或显式 pairs,见跨行连接。

操作示例:只将主干比例改为 0.25;再回到默认比例,比较曲线与直线的选点。用自己的数据时先决定需要展示区间长度还是单个位置,随后查看 geom_link_ribbon() 与 geom_link_line()。

准备数据与配置(展开)
R · 示例代码
ribbon_sequences <- seq_data_example
observed_links <- ribbon_data_example

14 选择区间区间连接或点连接

R · 示例代码
points <- transform(head(observed_links, 3),
  qpos = floor((qstart + qend) / 2),
  spos = floor((sstart + send) / 2)
)
p_points <- ggchord(seq_data = ribbon_sequences) +
  geom_seq() +
  geom_link_line(data = points, arrow = grid::arrow(length = grid::unit(2, "mm"))) +
  coord_chord()
view_ggchord(p_points, width = 10, height = 8, units = "in")
从已有 HSP 区间计算中点的点连接
从已有 HSP 区间计算中点的点连接 · 打开高清原图

点连接只画前三条真实比对的中点,箭头指向目标端。需要显示整个比对区间时,继续用连接带。

搜索说明

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