Holarch

開発者向け

Holarch Language Engine

ライセンス提供している SysML v2 と KerML の言語エンジンです。

Holarch の SysML v2 プロジェクトを支えるエンジンを、お客様の製品で利用できます。SysML v2 と KerML のテキストを構文解析、名前解決、チェック、評価し、ブラウザーでは WebAssembly として、またはお客様のサーバー上で動作します。

動作中の Holarch Language Engine:値を入力すると単位のエラーが表示され、修正すると消えます。定義へ移動で別パッケージのパート定義にジャンプし、250,000 行のモデルをコマンドラインからチェックして、診断のコードと経過時間を表示します

対象

言語実装を自ら開発・保守することなく、自社製品で SysML v2 テキストを扱いたいチーム。

ツールベンダー

モデリング、作図、アーキテクチャのツールに、SysML v2 の編集、チェック、インポートを追加できます。

PLM、要求管理、シミュレーションの製品

SysML v2 モデルを読み込み、要求や単位付きの値をたどり、他のツールとモデルを交換できます。

社内エンジニアリングツールのチーム

レビューパイプラインでモデルをチェックし、レポートを生成し、社内ツールの中でエンジニアに SysML v2 エディターを提供できます。

機能

テキストからチェック済みモデルまでの全工程を 1 つのエンジンで処理します。入力も出力も JSON です。

構文解析

SysML v2 と KerML のテキスト表記をエラー回復付きで解析します。1 つの誤りがファイルの残りを隠すことはありません。標準ライブラリはエンジンと一緒に読み込まれます。

名前解決

パッケージやファイルをまたいで、名前、インポート、エイリアス、特化、型付け、再定義を解決します。ホバー、定義へ移動、補完、名前の変更に対応しています。

チェック

135 種類の診断コード。それぞれに重大度、正確な範囲、メッセージ、エディターでクイックフィックスとして提示できる修正案があります。

評価

単位と数量を含む式(body + 4 * 12 [kg] から 348 [kg] など)や、要求の制約と検証ケースを評価します。要求のしきい値とその目標値はモデルから読み取ります。

入力に合わせて再解析

ドキュメントセッションは変更された部分だけを再解析してトークンの差分を送るため、大規模なモデルでもエディターの応答性が保たれます。

書式を崩さずにテキストを編集

ダイアグラムやフォームからの変更はテキストに書き戻されます。変更されていないテキスト、コメント、レイアウトはユーザーが書いたとおりに保たれます。

差分、マージ、リベース

モデルの 2 つのバージョンを変更の一覧として比較して適用し、テキストの編集を新しいモデルの変更の上にリベースできます。

バリアント

可変点、バリアント、構成をチェックし、バリアントのすべての組み合わせを一覧にしてモデルの制約に照らして判定できます。

シミュレーション(アドオン)

アクションフローとステートマシンをシミュレーション時間上で実行します。単発の実行、お客様の製品からの入力によるステップ実行、モンテカルロスタディに対応しています。同じシードなら、ブラウザーでもサーバーでも同じ結果になります。

JSON による交換

SysML v2 JSON をインポート・エクスポートし、安定した ID を持つプレーンなレコードとしてモデルを読み取れます。テキストに各要素の ID を持たせられるため、編集したテキストを読み戻しても、名前の変更や移動を経て各要素の同一性が保たれます。

Holarch での実績

Holarch のすべての SysML v2 プロジェクトで、エディター、ビュー、ライフサイクルページを同じエンジンが動かしています。

アドオン

エンジン単体でモデルのチェック、分析、編集ができます。3 つのアドオンで機能を拡張でき、それぞれ個別にライセンスされ、ライセンストークンによって有効になります。再ビルドもコード変更も不要です。

シミュレーション

アクションフローとステートマシンをシミュレーション時間上で実行します。単発の実行、お客様の製品からの入力によるステップ実行、モンテカルロスタディに対応しています。同じシードなら、ブラウザーでもサーバーでも同じ結果になります。シミュレーション注釈を含むモデルも、アドオンなしでチェックできます。

SysML v1 から SysML v2 への移行

SysML v1 モデルをチェック済みの SysML v2 テキストに変換し、すべての要素について変換、近似、破棄のいずれかを示すレポートを出力します。移行アドオンの仕組み。

サーバーでの利用

ブラウザーのページの外でエンジンを実行できます。Node.js、Deno、サーバーレス関数、Python 拡張に対応しています。ビルドパイプラインでモデルをチェックしたり、一括で変換したり、自社サービスからのリクエストに応答したりできます。

アドオン:SysML v1 から SysML v2 への移行

移行アドオンは、OMG SysML 2.0 仕様の SysML v1 から SysML v2 への変換に基づいて、SysML v1 モデルを SysML v2 テキストに変換します。Holarch の SysML v1 インポートを支える変換器で、エンジンとは別にライセンスされます。

  • 入力:API リファレンスに記載された中立的な形式の JSON による SysML v1 モデル。お客様の製品が XMI ファイル(Cameo や MagicDraw、Enterprise Architect、Rhapsody、Papyrus から)を読み込んでモデルを送ります。エンジンは XML もファイルも読み込みません。
  • 出力:SysML v2 テキスト、そのテキストに対するエンジンのチェック結果、そしてすべての要素を変換、近似、破棄に分類し、安定した理由コードと変換後の SysML v2 名を示すレポート。
  • 再現性:同じモデルは毎回同じテキストに変換されます。
  • 上限あり:最大 250,000 要素、8 MiB のテキストまでのモデルに対応します。それより大きいモデルにはエラーで応答し、処理が止まることはありません。

リクエストは API リファレンスの v1_convert です。アドオンがない場合、エンジンはこのリクエストに feature-not-licensed で応答し、他のリクエストは通常どおり動作します。

リクエストとその応答

// Request (the model shortened)
{ "op": "v1_convert",
  "model": { "format": "holarch-xmi-model", … } }

// Answer (shortened)
{ "text": "package 'Rover Model' { … }",
  "diagnostics": [],
  "report": {
    "summary": { "elements": 31, "converted": 27,
                 "approximated": 2, "dropped": 2 },
    "items": [ { "kind": "Association",
                 "status": "dropped",
                 "reason": "association" }, … ] } }

エンジンで変換した小さなテストモデル:31 要素、変換後のテキストに診断なし。

動作の仕組み

ブラウザーでは、エンジンは Web Worker 内の WebAssembly モジュールとして動作するため、解析がページをブロックすることはありません。小さな JavaScript 連携レイヤーがリクエストを送り、応答を Promise として返します。Node.js または Python 用のサーバービルドはご要望に応じて提供します。

How the engine fits into a browser applicationYour application calls the JavaScript integration layer with JSON requests. The layer passes them to a Web Worker that runs the WebAssembly engine with the standard library loaded, and returns JSON answers. The engine has no network or file access. Your application editor, views, pipeline JavaScript integration layer requests as promises WEB WORKER Holarch Language Engine WebAssembly, no network or file access Standard library JSON

リクエストとその応答

// Request
{ "op": "analyze",
  "text": "package P { part a : Engine; part b }" }

// Answer (tokens left out)
{ "diagnostics": [
    { "code": "syntax.expected-token",
      "args": { "expected": ";", "found": "}" },
      "range": { "from": 35, "to": 35 },
      "severity": "error" },
    { "code": "name.unresolved",
      "args": { "name": "Engine" },
      "field": "typedBy",
      "range": { "from": 21, "to": 27 },
      "severity": "error" } ] }

エンジンの連携ガイドに載っている実際のリクエストと応答:1 つの構文エラーと 1 つの解決できない名前。それぞれに安定したコードとテキスト内の正確な範囲が示されます。

性能

生成した 10,000 行のモデルでの測定値:

  • 10,000 行のモデル全体を最初から解析(構文解析、名前解決、チェック)するのに 150 ms。Safari の WebAssembly では 215 ms。
  • 編集後に 10,000 行のモデルを再チェックするのに 1.3〜6.8 ms(95 パーセンタイル)。Safari の WebAssembly では 3〜4 ms。
  • エンジン本体(標準ライブラリ読み込み済み):17 MiB。モデル全体の解析で 10,000 行あたり約 29 MiB、編集セッション全体で 10,000 行あたり約 33 MiB が加わります。
  • WebAssembly は圧縮時で約 0.74 MB です。

最大 250,000 行の生成モデルでテストしています:各サイズの結果。

実際の数値はモデルとコンピューターによって異なります。評価版でお客様のモデルを使って測定できます。

セキュリティ

  • ネットワークやファイルへのアクセスなし。WebAssembly モジュールはページから何もインポートしません。渡されたテキストとレコードを読み取り、JSON を返します。
  • 入力の上限。入力サイズ、行の長さ、入れ子、式の深さに上限があるため、悪意のあるファイルでメモリやスタックを使い果たすことはできません。
  • ファジング済み。リクエスト、字句解析器、構文解析器の各エントリーポイント、シミュレーター、言語操作はファズテストを実施しています。
  • 分離。ブラウザーでは専用のワーカーで動作します。障害が起きても止まるのはそのワーカーだけで、ページがワーカーを再起動します。

提供内容

  • エンジン:標準ライブラリ付きの WebAssembly ビルド。
  • JavaScript 連携レイヤー:ワーカーと、お客様のページ用のクライアント。
  • 開発者向けドキュメント:連携ガイド、実際のリクエストと応答を載せた全リクエストのリファレンス、診断コードの一覧、実行可能なサンプル(最小限のページ、エディター、モデルブラウザー、Node.js、Python)。
  • ライセンス期間中のアップデート。
  • 開発チームによるメールでのサポート。

ライセンス

  • 1 年単位の年間ライセンス。料金は、お客様の製品でエンジンが支える機能の月間アクティブユーザー数で決まります。
  • お客様のコンピューターで使える60 日間の無料評価版(ドキュメントとサンプル付き)。
  • 大学や研究グループ向けのアカデミック・研究ライセンス。
  • エンタープライズでの利用はご相談ください:複数の製品や多数のユーザー。
  • アドオン:シミュレーション、SysML v1 から SysML v2 への移行、サーバーでの利用。それぞれ個別にライセンスされます。

製品と想定ユーザー数をお知らせいただければ、お見積もりをお送りします。

言語サポート

現在のバージョンは Holarch Language Engine 2.1.2 です。OMG SysML v2 仕様に基づき、SysML v2 と KerML のサブセットに対応しています。SysML v2 言語の対応範囲に、Holarch での動作に基づいて対応している構文と既知の未対応箇所を掲載しています。評価版のドキュメントにも、エンジンについて同じ一覧が含まれています。

公式サンプルモデルでの OMG のパイロット実装との比較や、壊れたテキストや大規模モデルでの結果(失敗を含む):Language Engine のテスト結果。

お客様のモデルでエンジンをお試しください。

評価版は 60 日間無料です。