如何下载和获取 The Libra Toolkit

The Libra Toolkit 的官方公开发布版是 libra-tk-1.1.2d.tar.gz（2015 年 12 月 29 日），可直接从项目主页 libra.cs.uoregon.edu 的 Downloads 区域下载。如果你需要比 1.1.2d 更新的代码，则要从 Bitbucket 源码仓库获取开发版本。两者定位不同：发布版适合直接使用和复现，开发版适合跟进最新改动。

两个获取途径

发布版是打包好的 tar.gz 压缩包，下载后解压即可进入构建流程。开发版是源码仓库，需要用版本控制工具拉取，代码状态可能领先于发布版，也可能包含尚未稳定的改动。

版本说明

• 1.1.2：改用 OASIS 构建系统，目的是让构建和安装过程更干净。
• 1.1.2d：在 1.1.2 基础上更新了文档，更清楚地描述如何用 OPAM 安装，并修复了一个与 OPAM 相关的兼容性问题。

也就是说，如果你打算用 OPAM 管理依赖或安装，应优先选 1.1.2d 而不是更早的 1.1.2。

使用前需要知道的前提

Libra 是一组用于离散概率模型学习与推理的算法集合，涵盖贝叶斯网络（BN）、马尔可夫网络（MN）、依赖网络（DN）、和积网络（SPN）和算术电路（AC）。每个算法都实现为命令行程序，选项和文件格式在全工具集内保持一致，因此既可以交互式使用，也可以写进脚本。

它由 Daniel Lowd 和 Amirmohammad (Pedram) Rooshenas 编写，采用修改版 BSD 许可证发布。相比其他工具包，Libra 更侧重结构学习，尤其是精确推理高效的易处理模型。

下载后的验证方法

下载 tar.gz 后，先确认压缩包完整、能正常解压，再按包内文档执行构建。由于 1.1.2 起使用 OASIS 构建系统，构建命令与旧版本不同；若通过 OPAM 安装，按 1.1.2d 更新后的文档操作即可。构建完成后，运行任一命令行程序并查看其帮助信息，能正常输出选项说明即说明安装可用。

常见卡点

• 拿到的是开发版却按发布版文档操作：开发版代码可能已变化，遇到构建失败先对照仓库中的最新说明。
• 用旧版本文档装 1.1.2d：1.1.2d 专门更新了 OPAM 安装说明，装这个版本时应看对应文档。
• 只找 tar.gz 而忽略仓库：如果发布版里的功能不满足需求，开发版可能已经包含更新内容。

引用信息

若在研究中使用了 Libra，可按官方给出的格式引用：

@article{lowd&rooshenas2015,
  title = {The Libra Toolkit for Probabilistic Models},
  author = {Lowd, Daniel and Rooshenas, Amirmohammad},
  journal = {Journal of Machine Learning Research},
  year = {2015},
  volume = {16},
  pages = {2459-2463}
}