环境配置¶

requirements.txt 只记录 Python 依赖。系统字体、pdfcrop 和 LaTeX 工具链属于系统依赖，需要单独安装。

1. Python 依赖¶

案例中的绘图脚本主要依赖 Matplotlib 和 NumPy。当前用于生成案例图的主要版本是：

matplotlib==3.9.2
numpy==1.26.4

安装：

pip install -r requirements.txt

英文论文图建议配置 Arial 或 Helvetica；如果用 PowerPoint 编辑公式，建议额外配置 Latin Modern Math。

详细安装、检查和 Matplotlib 设置见字体配置。

Matplotlib 导出的 PDF 有时会带白边。即使在 savefig 中使用 bbox_inches="tight" 或 tight layout，仍可能残留少量空白。

一种处理方式是在 LaTeX 中手动裁剪：

\includegraphics[width=\linewidth, trim=10pt 20pt 10pt 20pt, clip]{figures/example.pdf}

其中 trim=left bottom right top，四个值分别表示从左、下、右、上裁掉多少空白。这适合临时微调单张图，但需要反复试参数，不适合批量生成。

更推荐的做法是在 Matplotlib 脚本导出 PDF 后，直接调用 pdfcrop 自动裁剪：

os.system(f"pdfcrop {output_pdf} {output_pdf}")

这样可以把裁剪步骤固定在绘图脚本里，减少手工后处理，也更容易保证多张图的裁剪方式一致。裁剪后的 PDF 插入 LaTeX 时通常只需要：

\includegraphics[width=\linewidth]{figures/example.pdf}

pdfcrop 通常来自 TeX Live：

sudo apt update
sudo apt install texlive-extra-utils

which pdfcrop
pdfcrop --version

当前环境中 pdfcrop 路径为：

/usr/bin/pdfcrop