一般的なReadMe
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 でエクスポート可能な ListObject を使用しますが、これを容易にするツールを提供します。- 呼び出しごとに 1 つまたは複数の観測値 (行) を評価できます
- 通常の関数出力として返される結果
- 効率性を高めるキャッシュ可能なモデルを使用
- 追加のデータ ラングリング ツール
- HDF5 複合データセットのインポート/エクスポート
- フラットファイルのインポート/エクスポート
- 追加の VBA モジュール処理
- jpmml.evaluator の Java ラッパー
- jni 経由で XLL から呼び出し可能
- コマンドラインからスタンドアロンとしてテスト可能
ただし、JVM を使用して Excel アドインを通じて呼び出すことができます。- 入力データと出力データは次のとおりです。
- HDF5 複合データセット
- フラットファイル
- メモリ内 (jni 経由で呼び出された場合など)
- 起動スクリプトとサンプルが含まれています
- WDS-JniPMML-XLL-Launch.bat: 新しい Excel インスタンスを起動し、インストールせずにアドインを実行するためのスクリプト
- WDS-JniPMML-XLL-Test-Launch.bat: アドインとサンプル ワークブックを実行するためのスクリプト WDS-JniPMML-XLL-Test.xlsm
- test/data: 通常の PMML ケースのテスト セット
プロジェクト構成に関するいくつかのメモ
- JniPMML-[AAA]: プロジェクトの目的に直接関連する言語固有のライブラリ
- 可能な限り、可能な限り近いコードの命名規則と構造は、言語間で同様に保たれます。
- WDS-[AAA]: JniPMML-[AAA] ライブラリとは独立して使用できる言語固有のユーティリティ ライブラリ
- lib: 直接使用できるコンパイルされた最終製品
- スクリプト: スクリプトを作成します。特に言語をまたいだドキュメントの構築に使用します。
前提条件
- 64ビットエクセル
ただし、コンパイルすると 32 ビットが追加される可能性があります。- VBA プロジェクト オブジェクト モデルへのアクセス (VBA モジュール ハンドラーを使用する場合)
- HDF5 と HDFView
- コンパイルする場合は HDF5 ライブラリと HDFView ライブラリが必要ですが、この機能は削除される可能性があります。
- 提供される jar では、少なくとも HDFView がパス上にあるか、Excel の起動時にコマンド ライン オプションとして渡されるパス上にある必要があります。
- Java jdk-12
最新の HDFView インストールを使用する場合に必要です。- コンパイル環境
github 構成は、Visual Studio Community Edition および Intellij Community Edition 用です。- DocFx
DocFx は、JavaDoc 側の DocFxDoclet を含むドキュメントのビルドに使用されます。
ライセンスノート
Wypasek Data Science, Inc. (WDataSci) の公開 github サイトで公開されているすべてのコード寄稿および開発は、MIT ライセンスに基づいてリリースされます。他のソースからのコードはそのように記載されており、他のソフトウェアを含む可能性のあるアセンブリ、XLL、および/または jar (たとえば、Apache の Maven または ExcelDna が他のソースからバンドルされる可能性があるため) は、一般的に使用される IDE プロジェクトおよび/またはとともにリリースされます。またはそれらを生成するために使用されるソリューション ファイル。
