章节与参考
本页完整说明已译为现代汉语;函数、参数、代码和原始数据标识保留原样。 用法说明
普通 Cartesian ggplot 的局部核酸/蛋白片段图层。将 x 映射到对齐列(或有独立依据的源位置),y 映射到序列行,label 映射到真实字符。不计算比对,也不通过 ggchord 的生物学骨架坐标投影。使用 register_ggchord_alignment() 将精确源位置关联到 Fusion/magnify 细节面板。位置标度训练包含半格边界,默认完整显示首末字符。原生位置标度须为 identity 或 reverse;拒绝非线性标度和非 Cartesian 坐标,避免误画单位置格。
用法
R · 示例代码
geom_residue(
mapping = NULL,
data = NULL,
overflow = c("tile", "error"),
position = "identity",
show.legend = FALSE,
inherit.aes = TRUE,
line_width = NULL,
...
)参数
- mapping, data
标准 ggplot2 图层映射与数据。必需美学为 x、y 和 label;支持普通 colour、fill、alpha、size、family 和 fontface 映射与标度。显式
size的单位为 mm;省略时字形统一适配单元格,最小为3 mm。- overflow
字母无法容纳时使用
"tile"(默认)或"error"。- position, show.legend, inherit.aes
标准 ggplot2 图层参数。
- line_width
每个显示行的可选正整数列数;默认 NULL 不换行。从最小已显示 x 值开始分段,gap仍占一列,多序列共用相同边界。行标签显示原始列范围,横轴为行内列号。只改变展示,保留原始输入和源坐标。注册 Fusion 的每个选区须位于一个显示行内,跨行选区显式拆成多个源区间。
- ...
传给图层的固定文字/色格美学及 na.rm。
详细说明
绘制时比较每格最终物理宽高与实际字形度量。overflow = "tile" 对无法容纳的字母保留映射色格,省略文字;"error" 则要求字母可读。不会静默缩小显式字号;每种目标尺寸(含标准 ggsave)均重新判断,单独提高 DPI 不会增加物理空间。色格沿边缘连续拼接成对齐矩阵。图形仍使用默认 Cartesian 坐标时,图层提供 1:1 固定比例,使行距与对齐列同样紧凑;显式坐标优先。未映射或固定 size 时,字形按同一比例放大以适应单元格,最小为 3 mm;更小空间继续遵守溢出策略。不提供 fill 时将 label 映射到 fill;根据数据明确的 alphabet 字段(DNA/RNA/AA,否则 AA)推断化学性质标度。用户提供的 fill 映射、固定值与标度优先。显式字母表与配色控制见 scale_fill_residue()。
示例
R · 示例代码
# 明确标记的人工格式示例,真实数据工作流见说明。
cells <- as_ggchord_alignment(c(A = "AC-G", B = "ACTG"), "DNA")
ggplot2::ggplot(cells, aes(alignment_column, accver, label = symbol)) +
geom_residue(aes(fill = symbol))
long <- as_ggchord_alignment(c(A = strrep("ACGT", 25)), "DNA")
ggplot2::ggplot(long, aes(alignment_column, accver, label = symbol)) +
geom_residue(line_width = 50)
