Skip to content

Examples

Tapestry-1 edited this page Oct 7, 2026 · 3 revisions

案例库

适用版本:v0.0.4(2026-10-06)。以下片段放在加载 gradbars 后的 document 环境中;每个案例单独使用。

快速入门 提供完整文档外壳。

图形选型

目的 接口
数值大小或相对零点的增减 \gradbar
用细线和点表示位置 \gradbar[shape=lollipop]
宽基准条与细当前条 \gradcompare
比较前后位置或差值 \graddumbbell
上下界与点估计 \gradrange
分级背景上的完成度 \gradbullet
可相加的正负贡献 \gradstack
等间隔变化趋势 \gradspark

1. 收支贡献与前后比较

\gradstack[min=-60,max=100,width=60mm,
  stack totals=separate]{60,-25,20,-15}

\graddumbbell[min=0,max=100,width=60mm,
  compare label=delta]{40}{68}

堆叠独立累计正值和负值,本例是 +80 与 -40。净值为 +40,但两侧贡献不会因此消失。哑铃的 delta 是当前减基准,即 28。

2. 趋势中的缺失位置

\gradspark[width=60mm,height=6mm,
  spark range=fixed,min=0,max=100]{25,40,NA,60,80}

\gradspark[width=60mm,height=6mm,
  spark range=fixed,min=0,max=100]{80,70,60,NA,NA}

NA 保留横向位置并断开连线;末项缺失时末项标签也是缺失。共享 fixed 范围可以比较不同序列的水平;每行 auto 范围主要用于观察形状。本版 spark 仅支持折线。

3. 从 CSV 取值并采用共享范围

在主 .tex 文件旁创建 results.csv:

Model,Score,Latency
Baseline,72.4,125
"Compact, tuned",81.6,88
"Model ""Plus""",92.7,61
Pending,N/A,null
Zero,0,0
\gradbarsloadcsv{results}{results.csv}
\gradbarscsvtable[width=40mm,precision=1]{results}{Model}{Score}

\gradbarscsvstyle{latency}{results}{Latency}
\begin{tabular}{@{}ll@{}}
  \gradbarscsvcell{results}{1}{Model} &
    \gradbarcsv[style=latency]{results}{1}{Latency}\\
  \gradbarscsvcell{results}{3}{Model} &
    \gradbarcsv[style=latency]{results}{3}{Latency}\\
\end{tabular}

行号从表头之后的 1 开始。范围样式扫描完整数值列,包含零,缺失值不参与计算。默认缺失标记为 NA、N/A、null;文本取值保留原始字符。

此版 CSV 不能通过 data=results 自动绑定 gradtable,也不能自动排序或筛选。字段按字符读取,不执行其中的 TeX 命令。

4. 分组、复用样式与跨页

\gradtablestyle{benchmark}{rules=booktabs,header align=c,
  text width=26mm,graphic width=35mm,label width=12mm}
\begin{gradtable}[style=benchmark,long=true,width=\linewidth,
  caption={Benchmark},label={tab:benchmark}]
  \gradcolumn{name}{Method}
  \gradcolumn[type=bar,mark=both,
    options={max=100,precision=1}]{score}{Score}
  \gradgroup{Baselines}
  \gradrow{A,72.4}\gradrow{B,81.6}
  \gradgroup{Improved}
  \gradrow{C,92.7}\gradrow{D,87.3}
\end{gradtable}

数据足够长时在行间分页并重复表头,排名仍依据全表数据。long=true 用于单栏正文,不放入 table 浮动体或 minipage。引用表格时通常需要编译两遍。

5. 显式替代文本

这个案例需要支持 PDF tagging 的较新发行版,元数据声明必须放在 documentclass 之前:

\DocumentMetadata{tagging=on,lang=en-US}
\documentclass{article}
\usepackage{gradbars}
\begin{document}
\gradbar{72}
\gradbar[alt={Accuracy is 72 out of 100.}]{72}
\end{document}

开启标记后,独立图形生成英文描述,alt 可以覆盖。嵌入已有 TikZ 图形时应给外层图形提供描述。它不代表整份文档已经达到 PDF/UA 要求。

更多排版案例见 v0.0.4 中文手册。

Clone this wiki locally