Repository navigation
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 |
\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。
\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 仅支持折线。
在主 .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 命令。
\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。引用表格时通常需要编译两遍。
这个案例需要支持 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 中文手册。
适用版本:gradbars v1.1.0(2026-10-25)。完整参数以该版本手册为准;GitHub 发布与 CTAN 提交分别进行。维护:SuFan / Tape5try。