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 編輯器。

功能

一個引擎涵蓋從文字到已檢查模型的完整路徑,輸入與輸出皆為 JSON。

剖析

SysML v2 與 KerML 文字表示法,具錯誤復原能力:一個錯誤不會掩蓋檔案的其餘部分。標準庫隨引擎一起載入。

解析

跨套件與檔案的名稱、匯入、別名、特化、型別與重新定義,並提供暫留提示、前往定義、自動完成與重新命名。

檢查

135 個診斷代碼,各有嚴重性、確切範圍、訊息,以及編輯器可作為快速修正提供的建議修正方式。

評估

帶單位與量的運算式,例如從 body + 4 * 12 [kg] 得到 348 [kg],以及需求約束與驗證案例。需求的門檻值及其所追求的目標都從模型中讀取。

邊輸入邊重新分析

文件工作階段只重新剖析變更的部分並傳送 token 差異,因此編輯器在大型模型上仍保持流暢。

編輯文字而不失去格式

來自圖或表單的變更會寫回文字中。未變更的文字、註解與版面配置完全保持使用者原本的寫法。

比對、合併與重定基底

以變更清單比較模型的兩個版本、套用這些變更,並將文字編輯重定基底到較新的模型變更之上。

變體

檢查變異點、變體與組態,並可列出每種變體組合,依模型的約束加以判斷。

模擬(附加元件)

在模擬時間上執行動作流與狀態機,可單次執行、搭配您產品的輸入逐步執行,或進行 Monte Carlo 研究。相同的種子在瀏覽器與伺服器上會得到相同的結果。

JSON 交換

匯入與匯出 SysML v2 JSON,並以帶固定 id 的純記錄讀取模型。文字可以攜帶每個元素的 id,因此編輯後讀回的文字在重新命名與移動後,仍保留每個元素的識別。

已在 Holarch 中驗證

Holarch 中的每個 SysML v2 專案都由同一個引擎執行:編輯器、檢視與生命週期頁面。

附加元件

引擎本身即可檢查、分析與編輯模型。三個附加元件可擴充其功能,各自另行授權,並由您的授權權杖啟用,無需重新建置,也無需修改程式碼。

模擬

在模擬時間上執行動作流與狀態機:單次執行、搭配您產品的輸入逐步執行,或 Monte Carlo 研究。相同的種子在瀏覽器與伺服器上會得到相同的結果。沒有此附加元件時,含模擬註記的模型仍可檢查。

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 匯入背後的轉換器,與引擎分開授權。

  • 輸入:以 JSON 表示的 SysML v1 模型,採用 API 參考中記載的中立格式。您的產品讀取 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" } ] }

引擎整合指南中的真實請求與回應:一個語法錯誤與一個無法解析的名稱,各有固定代碼及在文字中的確切範圍。

效能

在產生的 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。
  • 壓縮後約 0.74 MB 的 WebAssembly。

以最多 250,000 行的產生模型測試:各種大小的結果。

實際數字取決於模型與電腦。評估期間您可以用自己的模型量測。

安全性

  • 不存取網路或檔案。WebAssembly 模組不從頁面匯入任何東西:它讀取您傳入的文字與記錄,並傳回 JSON。
  • 輸入限制。輸入大小、行長度、巢狀層數與運算式深度都有上限,因此惡意檔案無法耗盡記憶體或堆疊。
  • 經過模糊測試。請求、詞法分析器與剖析器的進入點、模擬器及語言操作都經過模糊測試。
  • 隔離執行。在瀏覽器中,它在自己的 worker 中執行。發生錯誤只會停止該 worker,您的頁面會將它重新啟動。

您會得到

  • 引擎:WebAssembly 建置,含標準庫。
  • JavaScript 整合層:worker 與供您頁面使用的用戶端。
  • 開發人員文件:整合指南、附真實請求與回應的所有請求參考、診斷代碼清單,以及可執行的範例(最小頁面、編輯器、模型瀏覽器、Node.js 與 Python)。
  • 授權期間的更新。
  • 由開發團隊透過電子郵件提供的支援。

授權

  • 年度授權,每次一年,依您產品中由引擎驅動之功能的每月活躍使用者數計價。
  • 在您自己的電腦上免費評估 60 天,含文件與範例。
  • 為大學與研究團隊提供學術與研究授權。
  • 企業使用可應要求提供:多個產品或大量使用者。
  • 附加元件:模擬、SysML v1 到 SysML v2 遷移與伺服器使用,各自另行授權。

告訴我們您的產品與預期使用者,我們會提供報價。

語言支援

目前版本為 Holarch Language Engine 2.1.2。它依據 OMG SysML v2 規格,支援 SysML v2 與 KerML 的子集。SysML v2 語言涵蓋範圍列出支援的結構與已知缺口,以它們在 Holarch 中的運作方式為準。評估文件中也為引擎附上相同的清單。

引擎在官方範例模型上與 OMG 試行實作的比較,以及它在損壞文字與大型模型上的表現(包括失敗之處):Language Engine 測試結果。

用您自己的模型試用引擎。

評估免費 60 天。