检查指定尺寸的一次渲染而不改变原图

0.16.6 文档

本页完整说明已译为现代汉语；函数、参数、代码和原始数据标识保留原样。使用教程

全站目录 · 按任务查找

在所选临时设备构建，gtable 布局后测量实际单面板，再在有界渲染局部上下文内细化物理几何。原图及缓存不变，标准保存仍用 ggplot2::ggsave()。

用法

代码diagnose_ggchord(
  plot,
  width = 7,
  height = 5,
  units = c("in", "cm", "mm", "px"),
  device = c("png", "pdf", "svg"),
  dpi = 144,
  min_size = 2,
  min_linewidth = 0.2,
  colour_vision = FALSE
)

参数

plot: 一个 ggchord 图。
width, height: 正目标画布尺寸。
units: 尺寸单位 "in"、"cm"、"mm" 或 "px"。
device: 目标设备 "png"、"pdf" 或 "svg"，必须在当前 R 环境可用；仅检查此设备。
dpi: 栅格分辨率，同时确定像素尺寸。
min_size, min_linewidth: 建议的最小字号及线宽，均为 mm，不修改输入样式。
colour_vision: 是否请求可选的色觉模拟提示。

返回值

ggchord_diagnostics 列表，含 measurement、checks、文字与图例测量、颜色建议、已有 label_diagnostics、annotation_registry、track_registry、track_diagnostics 及捕获的设备警告。单位与来源见 ggchord_layout_contract。measurement$status 只表示面板测量，不等于全部质量或可移植性检查通过。

详细说明

结果是证据，不是通用质量认证。检查已登记顶点边界、文字、小字号/线宽、超大图例及已有标签/轨道诊断。clip = "off" 时对象在面板外但画布内是合法的。不认证未登记 grob、箭头外延、字体嵌入/回退或跨软件透明度；设备警告保留。灰度建议比较不透明离散映射色的亮度差（小于 0.05），不包含连续渐变。colour_vision = TRUE 时可选 colorspace 公共模拟在严重度 1、线性 RGB 下检查红/绿/蓝色觉缺陷，将 Lab 距离小于 10 标记。这些启发式阈值忽略空间、透明叠加和观察条件，不自动修改图或使运行失败。

示例

代码library(dplyr)
data(seq_data_example)
seqs <- seq_data_example |>
  select(accver, length)
p <- ggchord(seq_data = seqs) +
  geom_seq()
diagnose_ggchord(p, width = 8, height = 6, units = "in", device = "png")