章节与参考
模块一 · 多序列关系 · 第 5 节,共 16 节
1.4 区间、点与跨行连接
本页目录
准备数据与配置(展开)
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")
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")
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 允许跨行连接
只有 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")
默认 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",完全相同的 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 分支图相比,仅把 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 表选择已有序列对,不生成比对 |
12 用点代替区间
点连接要显式提供 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")
只改为 "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_example14 选择区间区间连接或点连接
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")
点连接只画前三条真实比对的中点,箭头指向目标端。需要显示整个比对区间时,继续用连接带。