一般自述文件
WDS-JniPMML-XLL 的主要目标是为 Excel 提供模型评估器。特别是,访问标准 PMML 评估器是使用和/或比较的起点。后续版本将包含其他模型规格并实现其他评估器。
使用简单介绍请参见文档文章。
除了其他评估器之外,提供对标准 PMML 评估器 jpmml(跨编程语言)的访问还存在技术挑战。在幕后,为了创建一个快速高效的 Excel 界面,使用户免受技术细节的影响,常用的插件语言 (C#/VB/VBA) 必须从工作簿中获取数据(多列,可能多行),对其进行转换,在 Java 中调用 jpmml,然后将适当的数据(可能具有多个列和行)返回到工作簿。
这项工作并不排除用另一种语言编写 PMML 评估器(或重写 jpmml,这可能是个好主意)。然而,正如其他评估者所添加的那样,基于通用 Excel 的界面提供了比较的基础。
通过此版本,WDS-JniPMML-XLL 提供:
- 一对 Excel 插件 (XLL) 和 VBA 支持:
- 评估 PMML 模型
- 作为 Excel 函数调用
- 使用事实上的标准实现,jpmml.evaluator
- 使用工作表内表中的输入数据
使用 XmlMap 的可导出 ListObjects,但提供了方便的工具- 每次调用可以评估一个或多个观察结果(行)
- 结果作为正常函数输出返回
- 通过可缓存模型提高效率
- 额外的数据整理工具
- 导入/导出 HDF5 复合数据集
- 导入/导出平面文件
- 附加 VBA 模块处理
- jpmml.evaluator 的 Java 包装器
- 可通过 jni 从 XLL 调用
- 可从命令行独立测试
但是,可以使用 JVM 通过 Excel AddIn 进行调用。- 输入和输出数据可以是:
- HDF5 复合数据集
- 平面文件
- 在内存中(通过 jni 调用时)
- 包含启动脚本和示例
- WDS-JniPMML-XLL-Launch.bat:用于启动新 Excel 实例的脚本,无需安装即可运行 AddIn
- WDS-JniPMML-XLL-Test-Launch.bat:用于运行 AddIn 和示例工作簿 WDS-JniPMML-XLL-Test.xlsm 的脚本
- 测试/数据:常见 PMML 案例的测试集
一些项目组织说明
- JniPMML-[AAA]:与项目目标直接相关的语言特定库
- 尽可能并尽可能接近的代码命名约定和结构在不同语言中保持相似。
- WDS-[AAA]:可以独立于 JniPMML-[AAA] 库使用的特定于语言的实用程序库
- lib:编译后的最终产品,可以直接使用
- 脚本:制作脚本,特别是用于跨语言文档构建
先决条件
- 64 位 Excel
不过,如果编译的话,可能会添加 32 位。- 访问 VBA 项目对象模型(如果使用 VBA 模块处理程序)
- HDF5 和 HDFView
- 编译时需要 HDF5 和 HDFView 库,但可以删除该功能。
- 提供的 jar 至少需要 HDFView 位于启动 Excel 时作为命令行选项传入的路径或路径上
- Java jdk-12
使用最新的 HDFView 安装时需要。- 编译环境
github 配置适用于 Visual Studio Community Edition 和 Intellij Community Edition。- 文档Fx
DocFx 用于文档构建,包括 JavaDoc 端的 DocFxDoclet。
许可说明
Wypasek Data Science, Inc. (WDataSci) 在其公共 github 网站上发布的所有代码贡献和开发均根据 MIT 许可证发布。来自其他来源的代码同样如此注明,并且可能包含其他软件的任何程序集、XLL 和/或 jar(例如,Apache 的 Maven 或 ExcelDna 可能从其他来源捆绑)与常用的 IDE 项目和/一起发布或用于生成它们的解决方案文件。