章节与参考
模块三 · 序列比对点图 · 第 2 节,共 2 节
3.1 HSP 双轴、方向与映射
数据来源、展示子集与重建规则见旗舰数据来源与构建。本页直接加载随包输入,集中设置绘图参数。
本页先用一对序列的真实 HSP 画出双轴线段,再扩展到四序列综合矩阵。最小输入是完整序列长度和 HSP 四端点;无需注释表。
1 绘制HSP真实端点
随包数据 sequence_detail_example$paf 保留 EMALE 序列对的11条已观测HSP,来源文件声明的序列长度提供两条轴。 随包表已按一基坐标规范化;反向比对的 target 端点保留降序。 原始文件及来源见输入下载。以下准备代码需要可选依赖dplyr。
每条线从(qstart, sstart)连接到(qend, send),无需geom_seq()。 颜色、透明度、线宽和线型复用link_*映射与标度。默认Identity范围为0–100, 刻度为0/50/80/90/95/100;显式用户标度优先。
R · 示例代码
p_viewdotplot <- ggchord(dotplot_seqs, dotplot_hsp) +
geom_alignment_segment(aes(link_colour = pident), linewidth = 0.65) +
coord_dotplot()
view_ggchord(p_viewdotplot, width = 8, height = 7, units = "in")
旧构造验证器可能对这些合法反向HSP的降序端点给出警告。应保留已规范化的端点顺序;逐区间升序排序会抹去显示倒位。
x_seqs和y_seqs分别选择和排列accession。gap使用原生bp/aa单位表示显示留白, 不代表省略源序列。轴方向接受1/-1或完整命名向量。显示翻转改变斜率,但不改来源表。 每条序列从源位置1起算;拼接后的区段保留各自accession和局部刻度标签。
R · 示例代码
dotplot_reversed <- ggchord(dotplot_seqs, dotplot_hsp) +
geom_alignment_segment(aes(link_colour = pident), linewidth = 0.65) +
coord_dotplot(y_orientation = -1)
dotplot_layout <- export_ggchord_layout(dotplot_reversed)
dotplot_layout$axis_layout用map_ggchord_position(..., axis = "x"/"y")转换原生位置与拼接坐标, inverse = TRUE用于反查,显示间隙返回NA。聚焦后的原始来源坐标用source = TRUE, 轴标签默认仍是窗口相对位置。未知方向会警告、省略并报告;方向元数据与端点冲突时报错。 同一显式HSP ID重复展示需要所有参与层指定allow_repeated=TRUE;无ID的重复或自比对 原行保持独立。没有cg/cs/CIGAR或其他精细轨迹时,只展示HSP线段,不推断逐碱基错配和缺口。
2 多序列综合矩阵
以下直接使用随包数据 flagship_dotplot_example,计数与标签表已准备完成。完整保留四序列的 32 条 HSP,不补造自比对、对称记录或缺失的 HSP。266 条 CDS 属于共用来源表,但不交给 Dotplot 的线段层。空白区域表示本次输入没有关系记录,不能据此认定不存在同源性。
上方列标题标明 query 序列及完整的 1–length 范围,左侧行标题标明 subject 序列范围;下方和右侧只显示各自序列的局部坐标。沿一列和一行的交点即可定位一对序列。每个带边框的矩形保留两条序列真实长度对应的宽高,淡色背景只帮助分区,不编码相似性。矩形间的留白是显示间隙。
这份输入的 6 个无序序列组合各只提供一个 query→subject 方向,没有反向互换记录,也没有自身比对。因此有 HSP 的区域只占半边;矩阵内标明每对记录数和无输入区域。不是渲染遗漏,也不把另一半留空解释为没有同源性。这里不自动镜像、补对角线或运行新的比对。此准备还使用可选依赖 tidyr。
准备数据与配置(展开)
R · 示例代码
library(ggchord)
library(dplyr)
flagship_paper <- "#FFFCF5"
flagship_sequences <- flagship_dotplot_example$seq_data
flagship_hsp <- flagship_dotplot_example$links
flagship_theme <- theme_ggchord_publication() +
theme(
plot.background = element_rect(fill = flagship_paper, colour = NA),
panel.background = element_rect(fill = flagship_paper, colour = NA),
legend.background = element_rect(fill = flagship_paper, colour = NA),
legend.key = element_rect(fill = flagship_paper, colour = NA),
legend.position = "right", legend.box = "vertical", legend.text = element_text(size = 8),
legend.title = element_text(size = 9),
plot.margin = margin(12, 16, 12, 16)
)R · 示例代码
dotplot_pair_counts <- flagship_dotplot_example$pair_counts
dotplot_cells <- flagship_dotplot_example$cell_labels
flag_dotplot <- ggchord(flagship_sequences, flagship_hsp) +
geom_alignment_segment(aes(link_colour = pident, link_linewidth = length), alpha = 0.85) +
scale_link_linewidth_continuous(range = c(0.8, 1.8), name = "HSP length (bp)") +
coord_dotplot(x_seqs = flagship_sequences$accver, y_seqs = flagship_sequences$accver,
gap = 4000) +
ggplot2::geom_text(data = dotplot_cells, aes(x = x, y = y, label = label),
inherit.aes = FALSE, hjust = 0, vjust = 1, size = 2.8, colour = "#566E67") +
labs(title = "Six observed sequence pairs · 32 HSPs",
subtitle = "One query→subject direction per pair; empty cells contain no input records") +
flagship_theme +
theme(
panel.grid = element_blank(), legend.position = "bottom", legend.box = "horizontal",
axis.text = element_text(size = 9),
axis.text.x.top = element_text(size = 10, face = "bold", margin = margin(b = 9)),
axis.text.y.left = element_text(size = 10, face = "bold", margin = margin(r = 9)),
axis.text.y.right = element_text(size = 9),
axis.ticks.length = unit(1.5, "mm"),
plot.margin = margin(12, 16, 12, 16)
)
3 按来源记录检查方向
四端点的相对方向来自源记录;反转显示轴会改变视觉斜率,但不改原始方向。可以按序列对统计已有 HSP 的方向:
4 查询精确坐标
下面将首条 HSP 的 query 起点换算到拼接 x 轴。反查时用 inverse = TRUE,并明确 axis;显示间隙返回 NA。该转换不改变四端点。
R · 示例代码
map_ggchord_position(
flag_dotplot, flagship_hsp$qaccver[1], flagship_hsp$qstart[1], axis = "x"
)5 边界与下一步
不支持骨架 gene/feature/track/ribbon 层、facet 或作为 Fusion 端点。需要 gap/mismatch 时,提供真实字符对齐,见字符工作流。操作示例:选一条线,找回四端点,分别解释斜率和配色。