Quick Start

快速入门

适用版本：v1.1.0（2026-10-25）。首页 · 案例库

1. 安装完整模块

支持 LaTeX 2025-11-01+、expl3 2025-12-29+ 和 PGF/TikZ 3.1.11a+。当前安装来源以 GitHub v1.1.0 Release 为准。

任选一种方式：

1. 下载标签源码，将 sty/ 下全部 22 个 .sty 文件一起放到主 .tex 文件旁。
2. 下载 Release 的 gradbars-ctan.zip，解压后在其中的 gradbars/ 目录运行 tex gradbars.ins，得到完整模块。

长期使用时，将完整模块放入 TEXMFHOME/tex/latex/gradbars/。先执行 kpsewhich -var-value=TEXMFHOME 确认路径；按发行版要求刷新文件名数据库。不要只复制 gradbars.sty，也不要混装不同版本的模块。

用 kpsewhich gradbars.sty 检查实际加载位置，编译日志应显示 2026/10/25 v1.1.0。项目目录中的旧文件可能优先于 TEXMF。

2. 第一张可视化表格

以下完整文档可用 pdfLaTeX、XeLaTeX 或 LuaLaTeX 编译：

\documentclass{article}
\usepackage{gradbars}
\begin{document}
\begin{center}
\begin{gradtable}[align=c,header align=c,width=\linewidth]
  \gradcolumn{method}{Method}
  \gradcolumn[type=bar,mark=both,
    options={max=100,precision=1}]{score}{Score}
  \gradcolumn[type=number,mark=best,
    options={better=lower,precision=1}]{time}{Time / ms}
  \gradrow{Baseline,72.4,18.2}
  \gradrow{Proposed,92.7,11.5}
  \gradrow{Pending,NA,NA}
\end{gradtable}
\end{center}
\end{document}

mark=both 标记最佳与第二个不同的有效数值；并列值同时标记。better=lower 表示越低越好。NA 是缺失，零仍是有效观测。中文内容可改用 ctexart 和 XeLaTeX。

3. 普通表格只写数字

\documentclass{article}
\usepackage{gradbars,booktabs}
\gradbarscolumn*{G}{min=0,max=1,width=18mm,
  precision=3,theme=gray,height=3ex}
\begin{document}
\begin{center}
\begin{tabular}{lGG}
\toprule
Method & \gradbarshead{Precision} & \gradbarshead{Recall}\\
\midrule
Alpha & 1.000 & 0.968\\
Beta & & 0.750\\
Zero & 0 & NA\\
\bottomrule
\end{tabular}
\end{center}
\end{document}

\gradbarscolumn* 提供格内居中标签。字面空格保持空白并预留图形宽度，NA 显示缺失。表头用 \gradbarshead 绕过数字收集。选用尚未定义的单个 ASCII 字母作为列名；无需手写 collectcell。

4. 按需加载

默认加载 stack,spark,heat,csv,table 五个库。distribution、legend、reports 需要显式加载：

% 放在导言区
\usepackage{gradbars}
\usegradbarslibrary{distribution,legend,reports}

只用基础图形可选 \usepackage[libraries=none]{gradbars}。后续库加载也必须放在导言区。