章节与参考
API 参考 · 第 2 节,共 4 节
图层与坐标模式的兼容边界
换坐标系时先确认单位、图层与参数。下表结合当前 Rd、源码契约与实际渲染;支持表示存在对应实现,不保证每个参数组合。支持的布局可以使用原生 bp/aa 单位;基因、引物和酶切仍有核酸限制。
图层与六类坐标
| 图层与参考 | 弦图 | 共线性图 | 单序列圆图 | Radial | Sankey | Dotplot | 条件与边界 |
|---|---|---|---|---|---|---|---|
geom_seq() |
支持 | 条件支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 共线性拒绝显式 radius、curvature、ring |
geom_seq_label() |
支持 | 条件支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 共线性不接受显式径向标签 radius |
geom_gene() |
条件支持 | 条件支持 | 条件支持 | 条件支持 | 条件支持 | 不支持 | 要求核酸单位和源正负链,aa 用通用特征 |
geom_feature() |
支持 | 支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 要求合法 ID、区间和一致的原生单位 |
geom_feature_plasmid() |
支持 | 支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 通用特征预设;跨模式使用须重查圆图 Position 默认值 |
geom_gene_label() |
支持 | 条件支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 与基因共享 Position;共线性 radial/tangent 对应竖排/横排 |
geom_feature_label() |
支持 | 条件支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 与特征共享 Position;共线性 radial/tangent 对应竖排/横排 |
geom_gene_label_repel() |
支持 | 条件支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 共线性拒绝 external=FALSE,按目标尺寸检查隐藏结果 |
geom_feature_label_repel() |
支持 | 条件支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 共线性拒绝 external=FALSE,检查适配与隐藏 |
geom_link_ribbon() |
支持 | 条件支持 | 不支持 | 条件支持 | 条件支持 | 不支持 | 共线性按显示行判断邻接;分段同行带省略并报告 |
geom_link_line() |
支持 | 条件支持 | 不支持 | 条件支持 | 条件支持 | 不支持 | 要求点坐标;不支持显式分段同行点连接 |
geom_seq_region() |
支持 | 支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 要求合法源区间、ID 和局部侧向 |
geom_seq_scale() |
不支持 | 支持 | 不支持 | 不支持 | 条件支持 | 不支持 | 直线标尺仅适用共线性模式 |
geom_seq_break() |
不支持 | 条件支持 | 不支持 | 条件支持 | 条件支持 | 不支持 | 要求共线性窗口边界,不修改源序列 |
geom_seq_center_label() |
条件支持 | 不支持 | 条件支持 | 不支持 | 不支持 | 不支持 | 仅一条显示序列,长度使用其原生 bp/aa 单位 |
geom_primer() |
条件支持 | 不支持 | 条件支持 | 不支持 | 不支持 | 不支持 | 仅一条显示 DNA 序列及合法结合坐标 |
geom_primer_label_repel() |
条件支持 | 不支持 | 条件支持 | 不支持 | 不支持 | 不支持 | 仅一条显示 DNA 序列,与引物共享位置 |
geom_restriction_site() |
条件支持 | 不支持 | 条件支持 | 不支持 | 不支持 | 不支持 | 仅一条显示 DNA 序列及实际计算的切割坐标 |
geom_track() |
支持 | 支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 源空间 Stat/Position;见基础矩阵和估计组合 |
geom_track_bar() |
支持 | 支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 统计观测数,给定数值请使用 col |
geom_track_col() |
支持 | 支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 显式 position_track、数值高度与数值域 |
geom_track_line() |
支持 | 支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 显式 position_track;闭合须明确请求,不跨缺失样本连接 |
geom_track_tile() |
支持 | 支持 | 支持 | 条件支持 | 条件支持 | 不支持 | 显式 position_track;不要求数值高度 |
geom_alignment_segment() |
不支持 | 不支持 | 不支持 | 不支持 | 不支持 | HSP identity 线段 | 专用双轴几何 |
23 个代表性图层分别在三种主要模式实际渲染,共 69 组明确标注的合成几何输入:59 组成功,10 组按契约拒绝,包含自动引物标签。中心标签在单序列弦图及圆图支持 bp/aa;引物与酶切要求 DNA。帮助已澄清这些边界。此处验证模式边界,不表示所有参数组合、生物识别或设备均已验收。参见完整运行记录。
读懂条件支持
R/coord-collinear.R 的 ggchord_validate_coord_contract() 显式检查圆图参数、自动方向与分段冲突。通用数据契约和核酸专属限制由运行时校验负责。完整源码随网站放在 assets/source/;函数参考从当前 roxygen/Rd 生成。
Position 只控制局部放置,不把不支持的图层转换成另一种坐标图层。共线性图的 outside/inside 是上方/下方,圆图是局部法线的外/内;复制配置前应重新读图。显示翻转与基因生物学链的区别见四种方向。
输入单位与脚本复用
安装方法见安装页,更新现有脚本时请参阅迁移说明。单圆图只接受单条显示序列;圆形蛋白只是显示布局,不声明蛋白分子为圆形。混合 bp/aa 数据必须先投影或分别作图。
新增坐标系
新增契约见Dotplot/Radial支持矩阵。Dotplot使用独立identity HSP层;Radial将已有Feature与Track框架接入环形邻接。圆图专有层、共享直线比例尺和branch会明确报错。新增图层检查与此前三视图证据分开记录。
| 图层与参考 | Dotplot | Radial |
|---|---|---|
geom_alignment_segment() |
支持identity HSP线段 | 不支持 |
静态跨面板组合
Fusion接受已注册Circular/Chord/Collinear/Sankey/Radial、多层组合及已注册字符面板,各面板保留原有图层契约。跨面板完整前缘采用一基闭区间边界和连续曲线映射;要求同单位来源区间完整可见,面板与实例路由无歧义。Fusion的标准标度只作用于跨面板图层。Dotplot端点、分面及隐式第三方坐标适配仍未注册。保存时重新测量物理面板,不代表具备全局避障或通用字号缩放。
局部对齐字符单元
| 图层/参考 | Chord / Collinear / Circular / Dotplot / Radial / Sankey | 普通 Cartesian ggplot |
|---|---|---|
geom_residue() |
不支持生物学骨架投影 | 支持局部字符单元及 identity/reverse 位置标度 |
字符对齐工作流 使用普通 ggplot x/y 坐标,源位置和对齐列保留为不同字段。按最终物理字形度量选择可读文字或明确的色格/报错策略,不改变源数据、不缩小字号。显式源映射注册后支持 Fusion/magnify 字符细节;可选 Biostrings 通过既有CDS map翻译真实字符,不推断比对或缺失phase。见CDS翻译与字符细节。
可选目标尺寸策略
adapt_ggchord() 支持单个 Chord、Circular、Collinear、 Sankey、Radial、Dotplot 图及显式启用策略的 Fusion 子面板。它调整默认主题样式, 在用户显式约束内排列原生图例;默认不启用。分面、任意自定义 grob、Fusion 外层 区域分配和全局标签求解器不在此范围内。
语义放大 支持独立的已注册细节、八侧名称、嵌套叶面板路径及自由区域,每行显式选择目标;有意重叠需主动允许,全局避障由独立布局策略负责。
Fusion还支持Sankey/Radial、多层组合及八方位/显式区域。叶面板路径保留独立来源,显式重叠导出覆盖顺序;Dotplot仍需独立轴注册。见高级区域与嵌套。