数据可视化教程
开工
- 先执行
tutorial-authoring,再读取 content-structure.md。 - 明确图要回答的问题、数据形态、主要读者、网页/论文/演示载体和最终显示尺寸。
- 核对图形函数、扩展包、返回对象和导出接口的当前官方文档。
- 统计图先确认估计目标、分母、不确定性和数据限制;不能用视觉修饰掩盖数据或方法问题。
- 按 共同辨析合同 判断是否存在会影响当前任务的相邻图形。若图形选择会改变读者看到的统计量或比较任务,才在首次绘图前说明选择依据。
内容主线
按“问题 → 数据 → 最小图 → 读图 → 改进 → 误导风险 → 导出”组织,不强制固定行数、三个示例或每个代码块都出图。每个新增示例必须增加一种信息能力,例如分组、区间、标注、分面、坐标转换或无障碍,而不是只换主题和颜色。
- 先解释图形编码与统计量,再讲样式;比较相邻图形时保持数据、尺度和统计变换一致。
- 数据变换、排序、聚合和缺失处理必须在代码中可见。
- 不把平滑线、箱线图须、误差条或显著性标记解释成它们没有表达的量。
- 坐标截断、对数尺度、双轴、面积/体积编码和抖动会改变读图,应说明原因与限制。
- 图题、坐标、图例、单位和注释由读者任务决定;不机械要求每张图内部重复文章标题。
- 不用“更美观”选择图形。明确每个候选图回答的问题、可能遮蔽的结构和最常见误读。
配色与可访问性
按需读取 color-palettes.md。颜色与变量类型匹配,并用形状、线型、直接标签或分面提供冗余编码。期刊风格包只是候选色值来源,不代表期刊认可,也不保证色盲、灰度或投影条件下可读。
代码与图件
- 所有图由文章代码实跑生成;随机抖动、抽样或布局才设置种子。
- 中间对象命名清楚,使读者能核对数据到图的转换。
- 使用最终载体的物理尺寸检查字号、线宽、图例和多面板密度。
- 每张内容图提供准确
fig.alt或 Markdown 替代文本;替代文本描述结构、组别和主要关系。 - 图件选择与导出读取 visual-templates.md。
验证与导航
- 按 quality-checklist.md 审查并实跑所有绘图代码。
- 更新
_quarto.yml后从doc/运行Rscript generate_sections.R。 - 只渲染目标文章、
sections/visualization.qmd和index.qmd。 - 检查最终 HTML、目标尺寸图片、中文字体、替代文本、颜色以外的编码和完整日志。