Holarch

SysML v2

SysML v2 專案中的模擬中繼資料

HolarchSimulation 中繼資料庫:SysML v2 模型如何為模擬器攜帶持續時間、分支機率、迴圈次數、資源、成本與狀態機設定,以及如何撰寫和移動它們。

使用方式 →

本頁內容
  1. 概觀
  2. 概念
    1. 標稱值與分布
    2. 哪個設定優先
    3. 兩種模擬器
  3. 使用方式
    1. 使用時機與原因
    2. 設定持續時間、機率或迴圈次數
    3. 在文字中撰寫註記
    4. 將舊設定移入模型
    5. 模擬狀態機
    6. 實作範例:Hybrid Car 示範專案
    7. 提示與良好做法
    8. 常見錯誤
    9. 與其他功能的關聯
  4. 註記
    1. 分布
    2. 相關輸入
    3. 機率與次數
    4. 資源與成本
    5. 需要 SysML 引擎的註記
  5. 訊息
  6. 限制
  7. 相關內容

概觀

在 SysML v2 專案中,模擬器的設定是模型的一部分。它們是來自庫套件 HolarchSimulation 的中繼資料註記,每個 SysML v2 專案都會載入此套件。使用它們的模型仍是有效的 SysML v2:其他工具會將這些註記讀取為一般的中繼資料,只有模擬器會賦予它們意義。

註記要不是位於其所註記的元素內,就是以 about 指名該元素:

succession toCruise first shift if speed > 30 then cruise {
  @HolarchSimulation::Probability { percent = 70; }
}
metadata HolarchSimulation::Cost about DriveCycle::drive { amount = 0.4; unit = "USD"; label = "Energy"; }

概念

標稱值與分布

步驟的持續時間是其屬性 duration(或類型為 DurationValue 或 TimeValue 的屬性)。其數值是其他工具與 Holarch 計算所看到的標稱持續時間。該屬性上的分布註記會讓模擬器改為抽樣持續時間:

action cruise {
  attribute duration : ISQ::DurationValue = 1 [min] {
    @HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
  }
}

哪個設定優先

  • 分布註記優先於屬性本身的數值。
  • 模型可以計算的防護條件、if 條件或迴圈條件會自行決定。只有在無法計算時才會使用 Probability 或 LoopCount(LoopCount 一律計算通過次數)。
  • 在模擬設定移入模型之前所做的設定,會以 Holarch 資料的形式保存在模型旁。在您將它們移入之前,它們仍然優先,因此執行會得到相同的結果(請參閱將舊設定移入模型)。

兩種模擬器

模擬器頁面會在設定的右側顯示由哪個模擬器執行模型:SysML 引擎(Holarch Language Engine 的模擬器)或 JavaScript 模擬器。兩者讀取相同的註記。狀態機、刺激輸入、來自 Resource、Consumes、Produces 與 Seizes 的資源、來自 Cost 的成本,以及需要 SysML 引擎的註記下的其他註記,只能以 SysML 引擎執行。

使用方式

使用時機與原因

當模型是設計的正式記錄時,請將模擬設定寫入模型:這些數字會隨 .sysml 檔案一起傳遞、出現在文字的審查中,並與模型的其餘部分一起進行版本控制。在分析運作情境(時間軸、分支比例、資源使用)時,以及在對照蒙地卡羅研究檢查需求之前使用它們。

設定持續時間、機率或迴圈次數

  1. 在 Action Flow View、瀏覽器或編輯器中選取步驟、接續、決策、迴圈或 if 動作。
  2. 在屬性面板的模擬區段中,設定持續時間(固定值或分布)、機率 (%)、反覆次數或 then 的機率(%)。
  3. Holarch 會將註記寫入模型:持續時間會將屬性的數值設為平均值並新增分布註記(若步驟沒有該屬性則寫入 attribute duration : ISQ::DurationValue);機率 (%)會寫入 Probability;反覆次數會寫入 LoopCount。每次變更都能以一次復原撤回,並會立即顯示在文字中。
  4. 清除欄位即可移除其註記。

Holarch 在寫入每個變更之前,會先以 SysML 檢查器檢查它。會增加錯誤的變更不會寫入,並會有訊息指出問題。

在文字中撰寫註記

  1. 開啟編輯器。
  2. 在元素本體內以 @HolarchSimulation::Kind { field = value; } 新增註記,或在其後以 metadata HolarchSimulation::Kind about element { … } 新增。
  3. 對於 Consumes、Produces 與 Seizes,請先指名步驟,再指名資源:metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }。

將舊設定移入模型

模擬設定是在移入模型之前所做的專案,會在模擬器的設定上方顯示此專案的部分模擬設定是 Holarch 資料,不屬於模型。

  1. 按一下將模擬設定移入模型…。
  2. 預覽會列出每個設定以及取代它的註記。
  3. 按一下移入模型。所有設定都會移入,一次復原即可全部撤回;執行會得到相同的結果。

模擬狀態機

狀態機以 SysML 引擎執行。

  1. 開啟行為 → 模擬器,並選擇一個狀態定義或展現狀態的零件作為根。
  2. 選用:在一起執行下,選擇一個向該零件傳送訊號的情境動作,例如示範專案的 TestDrive。
  3. 在激勵下,按一下 + 新增激勵,並設定於(時間與單位)、訊號與目標(一個狀態機,或接受它的每個狀態機)。
  4. 按 ▶ 播放、⏭ 單步或 ⏩ 執行到結束。執行中的狀態機會點亮作用中的狀態並標示觸發的轉換;狀態分頁會顯示狀態隨時間變化與已觸發的轉換。
  5. 在蒙地卡羅中,狀態分頁會顯示狀態停留時間與轉換次數。對照需求檢查…會將每個狀態的停留時間及其在執行中所佔的比例提供為輸出。

在 State Transition View 上,▶ 模擬會開啟一列,含 ▶ 播放、⏭ 單步、⏩ 執行到結束、重設與在模擬器中開啟。執行會使用模擬器上為該狀態定義儲存的刺激輸入。

實作範例:Hybrid Car 示範專案

Hybrid Car 示範專案(管理專案 → 專案檔案 ▾ → 新增示範專案)使用此庫:

  • DriveCycle:shift 之後的接續 toCruise 具有 Probability 70;else 分支取其餘的 30 %。cruise 的標稱時間為 1 min,從 Triangular 分布(45 s、1 min、2 min)抽樣。
  • DrivenCar:動力系統的電池是 62 Wh 的 Resource;drive 會 Consumes 其中的 1.5 Wh,並具有每次使用 0.4 USD 的 Cost。
  • PowertrainStates:轉換 startElectric 的防護條件具有 Probability 80;accept when charge < 15 會在電量下降時切換為 hybrid;accept after 30 [min] 會結束充電。
  • TestDrive:一個向 demoCar 傳送 StartRequest、等待一小時,然後傳送 StopRequest 與 PlugIn 的情境。將 Demo Car 與 Test Drive 一起執行,即可看到動力系統變更狀態。

示範專案的檢查結果為 0 個診斷。

提示與良好做法

  • 讓標稱值保持有意義:將其設為分布的期望值,如同屬性面板所做的。
  • 為您註記的接續命名(succession toCruise first …),以便在文字中輕鬆找到註記。
  • 優先使用模型可以計算的條件,而不是機率;對於模型未描述的內容才使用 Probability。

常見錯誤

  • 機率沒有作用:防護條件可以計算,因此由它決定。屬性面板會顯示「計算結果為 true:一律採用。」或「計算結果為 false:永不採用。」
  • 分支機率總和不是 100 %:沒有 Probability 的分支會分配剩餘的部分;當已給定的機率超過 100 % 時,警告會顯示「分支機率總和為 N %。請將其變更為總和 100 %。」
  • 將持續時間註記放在步驟本身上:分布應放在持續時間屬性上,而不是動作上。

與其他功能的關聯

註記

分布

將分布放在持續時間屬性上。位置與尺度欄位接受含單位的量值(45 [s]、2 [min]);形狀欄位接受數字。

註記欄位意義
常態mean, sd常態分布。
三角low, mode, high三角分布,low ≤ mode ≤ high。
均勻low, high介於 low 與 high 之間的均勻分布。
Exponentialmean具有給定平均值的指數分布。
Gammashape, scaleGamma 分布;平均值為 shape × scale。
LogNormalmedian, sigma其對數以中位數的對數為中心呈常態分布。
Weibullscale, shapeWeibull 分布。
Betaalpha, beta, scale0..1 上的 Beta 分布,乘以 scale。
Poissonmean, scale具有給定平均值的計數,乘以 scale。
Binomialtrials, p, scale若干次試驗中的成功次數,乘以 scale。

抽樣到小於零的持續時間會重新抽樣。

相關輸入

沒有相關性時,從分布抽樣的每個數值都彼此獨立。Correlation 會讓其中兩個數值一起變動:

metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
註記作用對象意義
Correlation coefficientabout a, b:兩個屬性,各有一個分布其數值的等級(Spearman)相關係數,範圍為 -1 到 1。0 表示獨立,1 表示等級一律相同,-1 表示相反。
  • 每個屬性保有自己的分布。模擬器會將所有配對合併為一個相關矩陣(Gaussian copula):一次執行中某屬性抽樣的第 n 個數值,會與其所相關之每個屬性的第 n 個數值配對。
  • 一組相關屬性的係數必須能彼此相容:a 與 b 強相關、b 與 c 強相關,但 a 與 c 相反,這是不可能的。檢查會回報這樣的組;請減弱其中一個係數。
  • 持續時間與數量(Consumes、Produces、Seizes)以相同方式相關。使用相同種子的執行會得到相同的數值。
  • 在模擬器上,以 SysML 引擎的蒙地卡羅模式中,相關輸入會列出根的配對。選擇兩個屬性與一個係數,然後按一下 + 新增相關性、變更係數,或按一下 × 移除一個;每次變更都能以一次復原撤回。研究完成後,已達成會顯示各次執行所抽樣數值的等級相關係數。
  • Hybrid Car 示範專案的 ChargeStop 將等待空閒充電器的時間與充電時間相關聯(0.6)。

機率與次數

註記作用對象意義
Probability percent從決策出發的接續該分支的權重。沒有權重的分支會分配 100 的剩餘部分。
if 動作無法計算條件時,then 分支的機率。
迴圈動作每次通過後重複的機率。
轉換無法計算防護條件時,該防護條件成立的機率。
LoopCount count迴圈動作通過次數;優先於迴圈的條件。
LoopExit迴圈本體中到 done 的接續結束整個迴圈,而不只是該次通過。

資源與成本

註記作用對象意義
Resource initial、minimum、maximum、unit零件或項用法一定數量的資源池。如果該用法宣告了 attribute level : Real,模擬器會讓它保持等於該數量,因此防護條件可以讀取它。
Consumes amountabout step, pool在步驟開始時取用。
Produces amountabout step, pool在步驟結束時加入。
Seizes amountabout step, pool在步驟開始時取用,並在結束時歸還。
Utilization amountperform 動作用法步驟佔用執行零件的程度。
Cost amount、rate、unit、label步驟或執行零件每次使用(CostRate::perUse)或每小時(CostRate::perHour)的成本。

需要 SysML 引擎的註記

註記意義
Transfer latency、capacity、per在連接或介面上:延遲透過它傳送的項與訊號。
Size size在項上:其用於傳送延遲的大小。
Timeout limit在匯合上:時限到期時停止未完成的分支。
NotBefore time在步驟上:在此執行時間之前不會開始。
ForkTargets、JoinSources在進入或離開平行狀態的轉換上:進入的子狀態,或必須處於作用中的子狀態。
History deep在複合狀態上:重新進入時,會回到離開時作用中的子狀態。
HostHook key、points保留給 Holarch 使用:執行會在列出的點暫停以等待輸入。

JavaScript 模擬器會讀取 Probability、LoopCount 與分布。

訊息

訊息意義
此專案的部分模擬設定是 Holarch 資料,不屬於模型。較舊的設定仍儲存在模型旁。請按一下將模擬設定移入模型…。
模擬設定移入模型之前的 Holarch 資料;它優先於模型。顯示在屬性面板的模擬區段中。變更該欄位即可將其寫入模型,或在模擬器上移入所有設定。
模型中沒有持續時間。請在此處設定(會寫入 attribute duration : ISQ::DurationValue),或在文字中撰寫。該步驟沒有持續時間屬性。
@Normal: sd must be greater than zero. Change sd.(@Normal:sd 必須大於零。請變更 sd。)(其他分布與參數也有類似訊息)某個分布參數缺失或超出範圍。使用 SysML 引擎時,模型檢查會在編輯器中回報它,模擬器在修正之前會拒絕執行。
@Normal: sd has another unit dimension than …位置或尺度參數的單位與屬性不同,例如持續時間上使用了公尺。
@LoopCount does not apply to a part …此註記位於其不適用的元素種類上。請移動或刪除它。
metadata Consumes … about needs an action and a part or item annotated @Resource.about 之後的元素數量或種類錯誤。
A probability of N % is outside 0 to 100.請輸入 0 到 100 的百分比。
The branch probabilities of this decision add up to N %; the simulator scales them to 100 %.警告:每個分支都有權重,但總和不是 100。
A correlation needs two different attributes …、… is not an attribute … 或 … has no distribution, so nothing is drawn to correlate …Correlation 將同一個屬性指名了兩次、指名了不是屬性的對象,或指名了沒有分布的屬性。
The coefficient N is outside -1 to 1. 或 The correlation has no coefficient.請輸入 -1 到 1 的係數。
“a” and “b” are already correlated; the first correlation is used. …警告:同一配對的第二個 Correlation 會被忽略。請移除其中一個。
The correlations of … contradict each other: no joint distribution has them …一組係數無法同時成立(矩陣不是半正定)。請減弱其中一個。模擬器在修正之前會拒絕執行。
在 <time> 發生死結:N 個步驟正在等待永遠不會到來的事物。使用 SysML 引擎時顯示在結果上方,並列出每個等待中的步驟。沒有傳送者的 accept、從未產生的項或從未釋放的資源都會使執行停止。

限制

  • 持續時間以秒、分、時或日撰寫(SI::s、SI::min、SI::h、SI::d)。毫秒會寫成秒;週、月與年會寫成日。
  • 狀態機、刺激輸入與一起執行需要 SysML 引擎。
  • 相關輸入需要 SysML 引擎;JavaScript 模擬器會獨立抽樣每個數值。一個組中最多可以相關 200 個屬性。
  • 矛盾係數的檢查涵蓋寫在同一個命名空間中的相關性;模擬器會檢查該次執行的所有相關性。

SysML® 與 OMG® 是 Object Management Group, Inc. 在美國及其他國家的註冊商標。