Examples

案例库

适用版本：v1.1.0。以下完整示例使用英文内容；中文标签可改用 ctexart 与 XeLaTeX。

图形选型

目的	接口
数值大小、正负变化、目标与误差	\gradbar
基准与当前值	\gradcompare、\graddumbbell
上下界与点估计	\gradrange
分级背景上的完成度	\gradbullet
可相加的组成与贡献	\gradstack
等间隔趋势	\gradspark，支持 line/bar/winloss
单个数值的颜色编码	\gradheat
原始样本的分布	\gradboxplot，加载 distribution

1. 收支贡献与前后比较

\documentclass{article}
\usepackage{gradbars}
\begin{document}
\gradstack[min=-60,max=100,width=65mm,
  stack totals=separate,palette=categorical]{60,-25,20,-15}
\par\medskip
\graddumbbell[min=0,max=100,width=65mm,
  track color=black!40,stem width=.9pt,
  compare label=delta]{40}{68}
\end{document}

正负堆叠分别累计为 +80 和 -40，净值为 +40。哑铃的 delta 是当前减基准，即 +28；灰色轨道表示完整范围。

2. 同一序列的三种趋势

\documentclass{article}
\usepackage{gradbars}
\gradbarssetup{width=65mm,height=8mm,precision=0}
\begin{document}
\gradspark[spark range=fixed,min=-40,max=60]{20,-10,NA,40,0,-30}
\par\medskip
\gradspark[spark type=bar,spark range=fixed,
  min=-40,max=60]{20,-10,NA,40,0,-30}
\par\medskip
\gradspark[spark type=winloss]{20,-10,NA,40,0,-30}
\end{document}

折线和柱形表达大小，win-loss 只表达正、负、零。NA 保留位置并断开连线；最后一个位置缺失时，其标签也是缺失。自动范围主要比较形状，比较绝对水平时固定范围。

3. 模型指标、相关矩阵与消融

\documentclass{article}
\usepackage{gradbars}
\usegradbarslibrary{reports}
\begin{document}
\begin{center}
\begin{gradtable}[align=c,header align=c,
  style=metrics,width=\linewidth]
\gradcolumn{name}{Model}
\gradmetriccolumn{accuracy}{Accuracy}
\gradmetriccolumn[options={style=report-metric,
  better=lower,unit={ ms},precision=1}]{latency}{Latency}
\gradrow{Alpha,92,35}
\gradrow{Beta,95,48}
\gradrow{Gamma,90,28}
\end{gradtable}
\end{center}
\end{document}

reports 还提供 \gradcorrelationcolumn 和 \gradablationcolumn。指标方向需要明确声明，预设不替用户推断统计意义。

完整领域报告示例 · 普通表格示例 · 四组展示图的可复现源码

CSV、分组汇总和跨页见表格与 CSV，箱线图与配色见分布与图例。