跳到正文
章节与参考

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

将策略添加到 ggchord 图中。普通打印、ggsave、预览和诊断路径都按实际设备或 Fusion 面板尺寸重建。不添加策略的图保持既有行为。

用法

R · 示例代码
adapt_ggchord(
  mode = c("adaptive", "fixed", "scale"),
  reference_size = c(8, 6),
  text_scale_range = c(0.85, 1.35),
  min_text_size = 2.5
)

参数

mode

选择 adaptive、fixed 或 scale。

reference_size

以英寸表示的正宽度和高度。缩放模式使用目标面积与参考面积之比的四次方根,并限制文字倍率。

text_scale_range

包含 1 的正文字倍率下限和上限。线宽与默认间距使用文字倍率的平方根。

min_text_size

自动减小主题文字时的字号下限,单位 mm。已小于此值的默认字号保持原值,不自动放大。显式字号和已有标签适应策略保持各自契约。

返回值

使用 + 添加的图对象策略。目标尺寸的 diagnose_ggchord() 结果包含 adaptive_layout(有效样式与缩放因子)及 guide_layout(候选、约束、最终排布和实测边界)。可行的图例排布不认证每个标签或任意 grob。普通纯布局导出只报告策略,不声称已得到目标设备的图例布局。

详细说明

fixed 保持默认主题尺寸和图例部件的参考物理尺寸。scale 有界调整主题驱动的默认文字、线条和间距。adaptive 进一步联合选择已训练原生图例和色条的排布,再重测完整图形。已有标签布局按新尺寸重新运行,不是新的全局标签碰撞求解器。数据、源坐标和标度映射不变。省略线宽参数的原生骨架、link、ribbon 和 alignment 图层使用有界线宽倍率;显式线宽及映射线宽保留自身值和标度规则。其他几何常量及原生主题派生的美学表达式不统一相乘。显式 geom 样式、映射尺寸、主题字段和图例约束优先。仅未指定的行列、方向和位置可以调整。连续及分段色条保持完整,保留标度刻度和顺序。未知自定义图例仅测量,不重排。无法容纳时警告并报告约束,不静默移除类别。在组合前向各需要的 Fusion 子图添加策略。面板测量后重建跨面板端点;外层区域分配和独立关系图例不由此策略控制。分面及任意注释 grob 不在自动布局契约内。

示例

R · 示例代码
library(dplyr)
#> 
#> Attaching package: ‘dplyr’
#> The following objects are masked from ‘package:stats’:
#> 
#>     filter, lag
#> The following objects are masked from ‘package:base’:
#> 
#>     intersect, setdiff, setequal, union
seqs <- seq_data_example |>
  slice_head(n = 2) |>
  select(accver, length)
p <- ggchord(seqs) +
  geom_seq() +
  geom_seq_label() +
  adapt_ggchord(reference_size = c(8, 6))
p

# ggplot2::ggsave("adaptive.png", p, width = 8, height = 6, units = "in")

搜索说明

↑ ↓ 选择 · Enter 打开 · Esc 关闭;也可按任务查找。 API 与功能