行為
模擬
以離散事件模擬或蒙地卡羅研究執行 Action 流程、讀取時間、成本、資源與使用率結果、以指令碼控制決策,並針對需求記錄驗證結果。
本頁內容
概觀
模擬器會在模擬時間上執行 Action 的流程,完全依照其Action 圖所繪製的內容。它有兩種模式:
- 離散事件:一次計時執行,您可以觀看、逐步執行並在其中回答決策。它顯示哪些動作在何時執行、它們在等待什麼、資源如何增減、哪些資產忙碌,以及執行的成本。
- 蒙地卡羅:以取樣的持續時間和決策進行多次獨立執行。它顯示總時間和成本的分布、百分位數、累積機率曲線、所採取的決策路徑,以及達到某個閾值的機率。
模擬器讀取模型,執行期間絕不會變更模型。它以三種方式寫入專案:根動作的設定(隨您變更而儲存)、每次完成執行的執行紀錄,以及記錄結果…。
概念
模擬器讀取的內容
模擬器從模型中取得它所需的一切。請在執行前於 Action 圖和實體的屬性中設定這些內容。
| 模型元素 | 來源 | 模擬如何使用它 |
|---|---|---|
| 流程 | 根 Action 的 Action 圖:序列、Parallel、SYNC、OR、LOOP 和 EXIT | 依序執行元素。分支平行執行,或選擇其中一個。 |
| 持續時間 | 每個 Action 的持續時間屬性(數字或分布,附單位) | 動作所需的時間。已分解的動作所需時間與其子流程相同。 |
| 分解 | 有自己流程的子 Action | 執行子流程,取代父項目自身的持續時間 |
| 觸發 | 動作 receives 的 Input/Output(關係屬性 Trigger,除非設為 false 否則開啟) | 動作會等待,直到每個觸發 I/O 都已產生 |
| I/O 產生 | 動作 generates 的 Input/Output | 在動作結束時、經過任何 Conduit 延遲後可用 |
| Conduit 延遲 | transfers 該 I/O 的 Conduit:Latency 加上 大小 ÷ 容量 | 延遲 I/O 的傳遞 |
| Resource | 與 Resource 之間的 consumes、seizes 和 produces 關係,附 Amount(預設 1) | 在開始時消耗和佔用。佔用的數量在結束時釋放。在結束時產生。 |
| 資產容量 | 附 Amount 的 performed by,以及資產在其父項目下的 Multiplicity | 動作會等待,直到資產有空閒容量 |
| 資產忙碌時間 | 執行動作的每個 Asset(performed by) | Busy (%)(忙碌百分比)和使用率圖表 |
| 成本 | 由 Action 或執行的 Asset incurred by 的 Cost 實體 | 加入累計總成本 |
| 行事曆 | 根和每個 Action 的開始屬性 | 僅用於日曆日期 |
| 指令碼 | 動作或結構的模擬指令碼 | 設定持續時間、決定分支、提示您並追蹤值的掛鉤 |
時間以秒為單位保存,並以最易讀的單位顯示(ms、sec、min、hr、days、months 或 years)。
持續時間、決策、資源、資產、成本和種子的詳細規則,請參閱下方的模擬規則。
使用方式
使用時機與原因
當功能流程已存在,且其動作已有持續時間、執行者和資源時,就可以進行模擬。這通常是在功能分析之後,於配置和架構權衡期間。
模擬回答:
- 作業需要多長時間,時間的變化有多大?
- 哪些動作位於要徑上?它們在哪裡等待資料、資源或資產容量?
- 電池電量或資料儲存等資源是否保持在限制範圍內?
- 哪些資產過載?
- 效能需求(時間、成本、資源水準)達成的機率是多少?這會成為與該需求關聯的分析驗證結果。
執行離散事件模擬
- 開啟該作業的 Action 圖。
- 選擇▶ 模擬 ▾ → 離散事件。
模擬器會以該 Action 作為根 Action開啟。
其他開啟方式:導覽列中的行為 → 模擬器(它會開啟在已儲存模擬器設定的 Action 上,否則開啟在第一個有流程的 Action 上;視需要選擇其他根 Action),或 Action 的開啟位置 ▾ → Simulator(模擬器)。以滑鼠選擇其他根 Action會立即開啟它;使用鍵盤時,請選擇它並按 Enter(或按一下開啟)。
- 檢查設定:按一下頂端列中的設定(其工具提示會列出目前的設定)。主要設定包括決策、速度、變動固定持續時間及± %、隨機種子和日曆日期(請參閱設定)。
- 按▶ 播放。
時鐘開始運行,Action 隨時間變化(時間軸分頁)會逐漸增長。執行中的 Action 圖會將執行中的動作標為綠色,等待中的標為橘色,完成的標為灰色。
- 按⏸ 暫停以停止並檢查。
- 按⏭ 單步前進到下一個事件,或按⏩ 執行到結束以不顯示動畫完成執行。
- 出現標題為Input for …(… 的輸入)的對話方塊時,請選擇路徑或輸入值。
- 按一下確定。
執行會如先前一樣繼續:播放、單步或執行到結束。
- 執行結束時閱讀結果:
- 狀態:已完成 100%、死結或已停止。發生死結後,它會說明執行在何時停止,以及每個等待中的動作在等待什麼,例如於 0 ms 停止:F1 Separate and Detumble 等待 ADCS Sensor Data,但沒有任何較早的動作產生它。按一下動作的名稱即可檢查它;
- Total Time(總時間)和總成本;
- 資源和使用率面板;
- 主控台,顯示警告。
- 按一下任何橫條或圖表元素即可查看詳細資料。
該實體會在屬性面板中開啟,顯示它在此次執行中執行的頻率和時間長度。開啟位置 ▾ → 項目檢視會開啟其頁面。
- 按⟲ 重設以清除執行並重新開始。
執行蒙地卡羅研究
- 將頁首切換為蒙地卡羅。或從 Action 圖改選▶ 模擬 ▾ → 蒙地卡羅。
- 設定執行(1 至 20,000;預設 100)。
- 如果您希望固定持續時間有變化,請設定變動固定持續時間。
- 如果研究必須可重複,請輸入隨機種子。
- 按▶ 執行蒙地卡羅。
如果某些 OR 或 LOOP 沒有機率或次數,未指定的決策對話方塊會將其列出。
- 在該對話方塊中,按一下使用等機率以繼續。或按一下取消,並在 Action 圖中設定它們。
您會看到進度列和執行中的文字
k / n · mean … · mean cost …。按一下取消即可停止;快顯通知顯示「已停止蒙地卡羅執行」。研究完成時,文字會顯示模擬次數和經過的時間。
- 閱讀已完成的執行,然後閱讀分布分頁(統計、持續時間分布、累積機率(S 曲線))以及Drivers(驅動因素)分頁中的分支組合。
如果有任何執行發生死結或失敗,紅色方框會顯示次數和 P(failure) 及其 95% 信賴區間。
- 若要查看某次執行失敗的原因,請開啟失敗的執行並按一下檢視執行。
該次執行會以其自己的種子在離散事件模式中重播。
- 按一下返回蒙地卡羅結果即可返回。
檢查需求並記錄結果
在蒙地卡羅研究之後使用,將結果轉換為驗證結果。
- 按一下對照需求檢查…。
- 選擇輸出:總時間、總成本、每個 Resource 的最小或最終數量,或數值型的指令碼全域變數(Global: …)。
- 以下列兩種方式之一設定閾值:
- From a Measure(從 Measure):選擇一個度量和一個使用(Threshold 或 Objective)。欄位會從該 Measure 填入(見下文)。
- By hand(手動):設定準則(≤ 至多或≥ 至少)、值和單位,並選擇需求。
- 設定所需機率 (%)(預設 90)。
您會看到結果表格:
- 準則和執行;
- 平均值(95% CI)和P5 / P50 / P95;
- P(meet),附其 95% 信賴區間;
- 裕度(平均值與閾值);
- 結果:通過或失敗。
- 按一下記錄結果…。
記錄結果預覽會列出它將進行的變更:
- Measure 的 Projected Value(或值)會設為平均值。
- 一個 Test Case 會驗證該需求。它是名為「Simulation check: <output> <criterion>」的新 Test Case,或您選擇的現有 Test Case。其狀態會變成 Passed 或 Failed,其實際結果會設為結果文字。
- 取消勾選您要略過的任何列。
- 按一下套用。
一次復原即可全部撤回。
在步驟 3 中選擇 Measure 時,它會依下列方式填入欄位:
- 其值會填入值和單位。
- 其 Improvement Direction 決定準則:Negative 為 ≤,Positive 為 ≥。
- 它 specifies 的 Requirement 會填入需求。
已儲存的執行
每次完成的執行都會為您儲存;不需要儲存步驟。
- 離散事件執行會在結束時(完成、死結或停止)儲存。蒙地卡羅研究會在其所有執行完成時儲存;取消的研究不會儲存。
- 紀錄是一個標示為 Simulation Run 的 Artifact,附有
.sim檔案。其名稱為「<root> run <date> seed <n>」,例如「Perform Delivery Mission run 2026-10-14 09.30 seed 48213」,研究則為「<root> Monte Carlo <date> seed <n>」。其說明會摘要結果。 - 沒有隨機種子的執行會取得一個種子,因此名稱會告訴您如何重複它:輸入該種子並再次執行。
- 快顯通知「已儲存為 <name>。」會連結到該紀錄。
- 蒙地卡羅執行的重播和開啟的紀錄不會再次儲存。檢視者無法儲存紀錄。
- 在資料庫中刪除您不需要的紀錄(依標籤 Simulation Run 篩選)。
較舊的專案使用標籤名稱 Simulation Output;專案開啟時會變成 Simulation Run,匯入時接受任一名稱。
重新開啟已儲存的結果:
- 開啟頁首中的已儲存的結果 ▾。
- 選擇結果。
橫幅顯示「正在檢視已儲存的結果:…」。其在目前的模型上重新執行連結會以相同模式執行目前的模型。
實作範例:CubeSat EO-1 成像過境
示範專案包含作業OPS Run Nominal Imaging Pass。它也包含需求6.5 Planning Cycle Time:「The mission shall complete each planning cycle, from target list uplink to product delivery, within 100 minutes.」以管理專案 → Project Files ▾ → New Demo Project(專案檔案 ▾ → 新增示範專案)建立示範。
OPS 的流程:
- 三個步驟依序執行:
- OPS.1 Transmit Imaging Plan(三角分布 4 至 9 分鐘,峰值 6;Ground Station);
- OPS.2 Receive Imaging Plan(1 分鐘);
- OPS.3 Load Command Schedule(2 分鐘)。
- 一個 Parallel:OPS.4 Rotate to Target(常態分布,3 ± 0.5 分鐘)和 OPS.5 Prepare Camera(5 分鐘)。兩者都由 OPS.3 產生的 Command Schedule I/O 觸發。
- 一個 LOOP Each target,4 次:OPS.6 Capture Image Strip(常態分布,40 ± 6 秒),接著 OPS.7 Encode and Store Image(均勻分布 20 至 40 秒)。
- 一個 OR Contact in view?:
- 是 (75%) 執行 OPS.8 Transmit Image Data(常態分布,8 ± 1.5 分鐘);
- 否 (25%) 執行 OPS.9 Hold Data Onboard。
- 一個 Parallel:一個分支上是 OPS.10 Recharge Battery in Sunlight(35 分鐘)。另一個分支上是 OPS.11 Receive Downlink(9 分鐘),接著 OPS.12 Process Image Products(常態分布,45 ± 10 分鐘)。
資源:
- Battery Charge(初始 62 Wh,最小 23,最大 77)。OPS.4 至 OPS.8 消耗它。OPS.10 產生它(+30 Wh)。
- Data Storage(初始 1.5 GB)。每次 OPS.7 增加 2.5 GB,OPS.8 減少 8 GB。
示範中 OPS 已儲存設定:種子 42,以及 200 次蒙地卡羅反覆,固定持續時間有 ±10% 的均勻變動。
執行它:
- 開啟行為 → 模擬器。
- 選擇 OPS Run Nominal Imaging Pass 作為根 Action,並保留離散事件。
- 按⏩ 執行到結束。
您會看到:
- Action 隨時間變化並排顯示 OPS.4 和 OPS.5,以及 OPS.6 和 OPS.7 的四次編號反覆(
#2、#3、#4)。 - 較長的 OPS.11 → OPS.12 分支決定了結束時間。
- 在Resource分頁上,Resource 水準隨時間變化顯示 Battery Charge 在成像期間逐步下降,並在 OPS.10 期間恢復。
- 總成本顯示「No costs」(無成本),因為示範中沒有 Cost 實體。
- Action 隨時間變化並排顯示 OPS.4 和 OPS.5,以及 OPS.6 和 OPS.7 的四次編號反覆(
- 切換到蒙地卡羅。
- 按▶ 執行蒙地卡羅(200 次執行)。
分支組合(Drivers 分頁)顯示約四分之三的執行走 是。
- 按一下對照需求檢查…並保留總時間。
- 選擇 Measure MOE-7 Planning Cycle Time,並將使用設為 Threshold。
值變為 100,單位為 Minutes,準則為 ≤,需求為 6.5 Planning Cycle Time。
- 保留 90%,然後閱讀 P(meet) 和判定結果。
- 按一下記錄結果…,然後按套用。
MOE-7 的 Projected Value 取得平均值。驗證 6.5 的 Test Case 取得 Status Passed 或 Failed。RVTM 現在會在 6.5 旁列出該 Test Case。
提示與良好做法
- 為每個末端動作設定持續時間。沒有持續時間的動作不花時間,也不會出現在時間軸上。
- 對於您不確定的持續時間,請使用分布。變動固定持續時間只用於快速的敏感度檢查。
- 在蒙地卡羅之前,為每個 OR 設定機率,為每個 LOOP 設定反覆次數。否則每次執行都會隨機選擇,結果中也會註明。
- 在記錄驗證結果之前設定隨機種子,讓結果可以重現。種子會包含在記錄的文字中。
- 執行足夠的反覆次數。當所需機率落在信賴區間內時,檢查會顯示「Run more iterations for a firmer verdict.」(執行更多反覆次數以取得更確定的判定。)
- 設定會在您變更時隨根動作一起儲存,因此會跟著專案移動。
常見錯誤
| 症狀 | 原因 | 修正方式 |
|---|---|---|
| 狀態顯示死結;主控台顯示「waiting for I/O … (never generated)」(等待 I/O …,從未產生) | 某個動作以觸發方式接收一個在所走路徑上沒有任何項目產生的 I/O(例如在 OR 之後) | 在每條路徑上都產生該 I/O,或將 receives 關係上的 Trigger 設為 false |
| 死結「waiting for … (never available)」(等待 …,從未可用) | 某個 Resource 從未回升到動作所需的數量以上,或資產的容量小於某個動作的 Amount | 提高 Initial Amount、新增一個產生的動作,或檢查 Amount 和 Multiplicity |
| 每次執行的總時間都相同 | 所有持續時間都是固定的,且變動為無 | 使用分布,或設定變動固定持續時間 |
| 「Simulation aborted: too many steps (check LOOP counts or recursive decomposition).」(模擬已中止:步驟過多,請檢查 LOOP 次數或遞迴分解。) | 某個 LOOP 執行次數過多,或某個動作位於自己的分解之中 | 降低 LOOP 次數或修正分解 |
| 主控台顯示「Script error in …」(… 中的指令碼錯誤) | 指令碼擲回例外 | 開啟該動作的指令碼(Action 圖屬性面板中的編輯指令碼…),並修正顯示的那一行 |
| 資產使用率是空的 | 沒有任何動作 performed by Asset | 將動作與其執行的 Asset 建立關係 |
與其他功能的關聯
- Fed by(資料來源):Action 圖流程,以及其動作、I/O、資源、管道、資產和成本的屬性與關係。在功能分析中建立的流程就是同一個流程。
- 輸出至:
- Measure(Projected Value 或 Value);
- 驗證需求的 Test Case,進而影響 RVTM 和測試中心;
- 含已儲存結果的 Artifact;
- MS Project XML 時程和 CSV 報告。
模擬規則
本節詳細說明模擬器如何處理持續時間、決策、資源、資產、成本和亂數。
持續時間和分布
- 持續時間是一個值和一個單位:Milliseconds、Seconds、Minutes、Hours、Days、Weeks、Months 或 Years。沒有單位的值會視為小時。
- 該值是固定數字或分布,例如
=norm.dist(40, 6)或=triang.dist(4, 9, 6)。 - 分布會在每次執行時取樣。
- 取樣到的負持續時間會重新抽取。因此常態分布的行為就像在 0 處截斷。
- 提供十種分布:beta、binomial、exponential、gamma、log normal、normal、Poisson、triangular、uniform 和 Weibull。請參閱屬性類型和分布。
=script()的持續時間會在每次執行時呼叫該動作的duration()掛鉤。在持續時間值中輸入=script();掛鉤會以持續時間的單位傳回持續時間(沒有數字則計為 0)。
變動固定持續時間是一項只為固定數字增加變化的設定。分布絕不會再進一步變動。
- Uniform ±%(均勻 ±%)在 ± 該百分比範圍內均勻取樣。
- Triangular ±%(三角 ±%)以峰值位於固定值的三角形取樣。
控制結構
| 結構 | 模擬行為 |
|---|---|
| 平行(無實體) | 同時開始每個分支。所有分支完成後才繼續。 |
| SYNC | 與 Parallel 相同。其持續時間是一個逾時。逾時時,未完成的分支會被停止(其甘特圖橫條變成紅色,顯示「stopped by SYNC timed out」),流程繼續。 |
| OR | 只採取一個分支,由判斷類型(見下文)選擇 |
| LOOP | 在每次執行前檢查其當符合時重複,條件成立時再次執行本體 |
| EXIT | 結束所在的 LOOP。在最上層時則結束流程。 |
OR 判斷類型:
- 機率:每個分支都有機率 (%)。留空的分支平均分享 100% 的剩餘部分。如果每個機率都是 0,則每個分支的可能性相同。
- 資源數量:每個分支比較所選 Resource 的目前數量(
==、!=、>、<、>=、<=)。採取第一個條件成立的分支,否則採取標示為 else 的分支。 - 指令碼:該結構的
onEnd()傳回要採取之分支的名稱(或其索引)。未知的名稱會記錄警告,並隨機採取一個分支。 - 無(執行時詢問或隨機):當決策設為Ask (when no script)(詢問,無指令碼時)時,對話方塊會詢問要走哪一條路徑。否則會隨機選擇一個分支。
LOOP 繼續條件:
- 反覆次數:固定的執行次數(至少 1)。
- 機率:每次執行前,以此機率 (%) 繼續。
- 資源數量:當 Resource 數量符合比較條件時繼續。
- 指令碼:每次執行前會呼叫
onEnd()。true會再次執行本體,false會停止,數字則設定還要執行幾次。 - 無(執行時詢問或隨機):在提示模式中,對話方塊會詢問How many iterations?(反覆幾次?預設 3)。否則會隨機執行 0、1 或 2 次。
Resource
Resource 有 Initial Amount、Minimum Amount、Maximum Amount 和單位。初始數量會限制在最小值和最大值之間。
- consumes:在動作開始時取走該數量,且不歸還。
- seizes:在動作開始時取走該數量,並在結束時釋放。
- produces:在動作結束時加入該數量。超過最大值的數量會被截斷。
當動作需要的數量超過可用數量時會等待。「不可用」表示數量會低於 Minimum Amount,未設定最小值時則低於 0。動作會等待,直到其他動作釋放或產生足夠的數量。其甘特圖橫條會顯示紫色斜線的等待。
資產和使用率
- 執行動作的每個 Asset(performed by)在該動作執行期間都處於忙碌狀態。
- Busy (%)(忙碌百分比)是模擬時間中至少有一個其動作在執行的比例。
若要建立容量模型,請在 performed by 關係上設定 Amount。
- 資產的容量是其父項目 decomposed by 關係上 Multiplicity 的上限。例如,
0..2表示 2。 - 當資產沒有空閒容量時,動作會等待(橘色斜線的等待)。
- 沒有 Multiplicity 時,容量不受限制。
成本
- Cost 實體有 Amount、Rate 和單位。
- Rate 為 Per Hour(每小時)時,數量會乘以動作以小時計的持續時間。否則會在動作結束時收取一次。
- 由執行的 Asset incurred by 的 Cost 會針對該 Asset 執行的每個動作收取。它會乘以 performed by 的 Amount(未設定時為 1)。
- 找到的第一個 Cost 的單位會用於標示每個成本數字。
亂數和種子
- 隨機種子可讓執行可重複。留空則每次都使用新的亂數序列。
- 在蒙地卡羅中,每次執行都從研究的種子取得自己的種子。因此您可以使用執行分頁中的重播(或失敗執行的檢視執行),在離散事件模式中重播任何單次執行。
- 指令碼中的
Math.random()使用相同的種子產生器。
模擬器頁面
頁首和執行列
頁首下方的列由左至右包含根 Action、該模式的執行控制項(見下文)、設定和模式切換。第一次執行前,頁面會顯示一行說明和 Action 圖;摘要卡片(狀態、總時間、總成本,或蒙地卡羅的卡片)會在第一次執行時出現。
- 根 Action:其流程被執行的動作。清單顯示每個有動作流程的 Action。沒有流程的動作顯示為「(no flow)」(無流程)。選擇其他根會為其重新開啟頁面。
- 離散事件 / 蒙地卡羅:模式。切換時會保留每種模式的設定。
- 頁首:已儲存的結果 ▾(已儲存的執行,或「尚無已儲存的執行。每次完成的執行都會儲存在這裡。」)和開啟 Action 圖。
設定
設定會顯示或隱藏列下方的執行設定(一開始隱藏;此選擇會記憶在此瀏覽器中)。其工具提示會列出目前的設定,例如「自動決策、100× 速度、固定持續時間、種子 42」。
| 設定 | 模式 | 數值 | 預設 |
|---|---|---|---|
| 執行 | Monte Carlo | 1 至 20,000 | 100 |
| 決策 | 離散事件 | Automatic (when no script)(自動,無指令碼時)、Ask (when no script)(詢問,無指令碼時) | Automatic (when no script)(自動,無指令碼時) |
| 速度 | 離散事件 | 1×、10×、100×、1,000×、10,000×、100,000×(每真實秒的模擬秒數) | 100× |
| 變動固定持續時間 | 兩者(每種模式分別保存) | 無、Uniform ±%(均勻 ±%)、Triangular ±%(三角 ±%) | 無 |
| ± % | 兩者 | 0 至 100 | 10 |
| 隨機種子 | 兩者 | 一個數字,或留空以隨機產生 | 空白 |
| 日曆日期 | 離散事件 | 時鐘從根 Action 的開始日期起算;有開始日期的 Action 會等到該日期 | 關閉 |
| 以暫停狀態開始(逐步執行) | 離散事件 | 頁面開啟時即建立執行,可直接使用 ⏭ 單步 | 關閉 |
- 設定變更時會與根動作一起儲存在專案中,並套用於每位開啟它的人。每次變更都能以一次復原撤回。這些設定也會記憶在此瀏覽器中,供其他根動作使用。
- 重設為預設值(位於「設定會與此 Action 一起儲存。」之後)會還原預設值,並清除圖表的實體選擇。
- 檢視者可為自己的執行變更設定;這些設定不會儲存在專案中。
離散事件控制項
- ▶ 播放 / ⏸ 暫停:以所選速度播放執行動畫。沒有事件的長時段會立即略過。
- ⏭ 單步:前進到下一個事件。
- ⏩ 執行到結束:不播放動畫,直接執行到結束。遇到提示時仍會停下。
- ⟲ 重設:捨棄此次執行。
- 時鐘:目前的模擬時間(在日曆日期模式下為日期和時間)。
蒙地卡羅控制項
- ▶ 執行蒙地卡羅、取消、進度列和進度文字。
- 對照需求檢查…(在有已完成執行的研究之後啟用)。
- 任何執行都可以從執行分頁重播,或下載為 MS Project 排程。
面板上方的附註
需要處理的通知(例如檢視已儲存的結果)在設定隱藏時仍會顯示。
- 變動開啟時顯示「固定持續時間加入 ±n% 均勻變動。」(或三角)。
- 使用使用等機率之後顯示「n 個未指定的結構使用等機率:…」。
- 失敗執行方塊(蒙地卡羅)與重播橫幅「以種子 s 和研究的設定重播蒙地卡羅執行 n(死結或錯誤)。」
面板
結果以固定版面呈現:頂端是摘要列,下方是分頁。每個分頁包含兩欄面板;寬面板(圖、甘特圖、事件記錄、統計和執行)橫跨兩欄。執行之前,每個面板會顯示其說明。開啟的分頁會記憶在此瀏覽器中。
面板選單
每個面板都有標題和一個 ⋯ 選單:
- 下載資料…會以面板的資料開啟匯出對話方塊:包含所有欄的 CSV 檔案,Action 隨時間變化另有排程 (MS Project XML)。檔案名稱為「<root> <panel title>」。
- 下載影像…會開啟匯出對話方塊,提供 <panel title> (PNG)(含透明背景和Scale)以及 <panel title> (SVG)。影像使用淺色主題的色彩。
- 選擇實體…(成本、資源和資產圖表)會開啟選擇實體:依名稱或編號篩選清單,勾選實體(全部、無),然後按一下套用。未勾選任何實體時,圖表會顯示所有實體。成本圖表另有顯示總計。色彩依清單順序採用圖表調色盤。此選擇會與根動作一起儲存。
按一下圖表、狀態清單或事件記錄中的實體,即可在屬性面板中開啟它,並顯示它執行的次數和時間長度。
離散事件分頁
摘要列:狀態、總時間和總成本。
| 分頁 | 面板 | 顯示內容 | 資料 |
|---|---|---|---|
| — | 狀態 | 目前正在執行的動作及其進度。黃色:等待 Input/Output;紫色:等待 Resource;橘色:等待 Asset 容量。結束時:已完成 100%、死結或已停止,並顯示動作執行次數和總時間 | — |
| — | 總時間 | 模擬時鐘(在日曆日期模式下為日期,並顯示經過時間) | — |
| — | 總成本 | 累計總成本和計入成本的實體數量 | — |
| 時間軸 | 執行中的 Action 圖 | 根 Action 圖(唯讀),動作依狀態著色:執行中(綠色)、等待中(橘色)和已完成(灰色) | — |
| 時間軸 | Action 隨時間變化 | 已執行動作的甘特圖;斜線部分為等待;分解的動作以括號表示,按一下即可摺疊(▸/▾);重複執行會編號為 #2、#3;紅色長條表示因 SYNC 逾時而停止;紅色虛線標示時鐘。工具:+、−(縮放)、重設、隱藏線條箭頭 / 顯示線條箭頭、隱藏線條色彩 / 顯示線條色彩 | 時間軸 (CSV)、排程 (MS Project XML) |
| 成本 | 成本隨時間變化 | 每個所選實體的累計成本,以及總計 | 成本隨時間變化 (CSV) |
| 成本 | 各實體成本 | 每個所選實體的總成本(長條圖) | 各項目成本 (CSV) |
| Resource | 資源水準隨時間變化 | 所選 Resource 隨時間變化的數量 | 資源水準隨時間變化 (CSV) |
| Resource | 資源數量 | 每個 Resource 的初始、最小、最大、最終、已消耗和已產生數量 | 資源變更 (CSV) |
| Resource | 資產忙碌時間 | 每個執行中 Asset 的忙碌率 (%),以及隨時間變化的使用中單位數(或執行中的動作數) | 資產使用 (CSV) |
| 記錄 | 主控台 | print() 輸出、指令碼錯誤(含行號)、警告和死結 | 主控台 (CSV) |
| 記錄 | 事件記錄 | 每個引擎事件:start、end、wait、resume、io、transfer、resource、decision、loop、exit、sync、killed、cost、deadlock、error | 事件記錄 (CSV) |
| 記錄 | 指令碼變數 | 指令碼全域變數(globals.put)及其目前值;展開某個值可查看其歷程 | 全域值 (CSV) |
執行播放期間,只會重繪摘要列和開啟的分頁;其他分頁會在您開啟它們或執行結束時更新。
蒙地卡羅分頁
摘要列:已完成的執行。
| 分頁 | 面板 | 顯示內容 | 資料 |
|---|---|---|---|
| — | 已完成的執行 | 已完成的模擬;持續時間和成本的平均值與標準差。死結或發生錯誤的執行會另外計算並排除 | 蒙地卡羅摘要 (CSV) |
| 分布 | 統計 | 持續時間、成本以及每個數值指令碼全域變數的平均值、平均值的 95% 信賴區間、標準差、最小值、P5、中位數 (P50)、P95 和最大值(僅限已完成的執行) | — |
| 分布 | 持續時間分布 | 每次執行總持續時間的直方圖 | 執行持續時間 (CSV) |
| 分布 | 成本分布 | 每次執行總成本的直方圖(沒有成本時顯示「沒有任何執行有成本。」) | 執行成本 (CSV) |
| 分布 | 累積機率(S 曲線) | 所選輸出的累積分布,含 x 欄位和讀數 P(X ≤ x) | — |
| 驅動因素 | 各 Action 時間 | 所有執行中各動作的合併持續時間 | 動作持續時間 (CSV) |
| 驅動因素 | 各 Action 成本 | 所有執行中每個動作或資產的合併成本 | 動作成本 (CSV) |
| 驅動因素 | 分支組合 | OR 分支的每種組合,含執行和比例 | 分支組合 (CSV) |
| Resource | 資源水準 | 每個 Resource 的平均最小、最大和最終數量 | 跨執行的資源 (CSV) |
| Resource | 資產忙碌時間 | 每個執行中 Asset 的平均忙碌率 (%)(資產少於三個時為長條圖) | 跨執行的資產使用 (CSV) |
| 執行 | 執行 | 每次執行,含執行、種子、結果(Completed、Deadlock、Error)、持續時間和成本。按一下欄標題即可排序(再按一下則反向)。P10、P50 和 P90 會挑選持續時間分布中該點的執行並將其醒目提示。重播會以其種子在離散事件模式中再次執行;MS Project 會將其下載為 MS Project XML 排程「<root> run <n>.xml」。只會列出前 500 次執行 | 執行 (CSV)(每次執行:種子、結果、持續時間、成本、路徑、全域變數) |
研究中不會保留每次執行的主控台訊息;重播某次執行即可查看。
指令碼
指令碼是 Action、OR、SYNC 和 LOOP 上的 JavaScript 掛鉤。當圖本身無法表達某種行為時(例如根據資源水準做決策),請使用指令碼。
撰寫指令碼:
- 在 Action 圖中選取元素。
- 在屬性面板中,按一下編輯指令碼…(動作),或在 OR、SYNC 和 LOOP 面板中按一下編輯指令碼… / 新增指令碼…。
編輯器對話方塊會開啟,例如指令碼:Capture Image Strip或OR 指令碼:…。
- 按一下新增 onStart()、新增 prompt()、新增 onEnd()或新增 duration(),即可插入空的掛鉤。
- 撰寫程式碼。Tab 會插入兩個空格。
- 按一下儲存(或取消)。
掛鉤
| 掛鉤 | 呼叫時機 | 傳回值 |
|---|---|---|
onStart() | 動作或結構開始時 | — |
prompt(p) | 在 onStart 之後,用於建立輸入對話方塊 | —(填入 p) |
onEnd(response) | 動作結束時;OR 做出決策時;LOOP 每次執行前 | OR:分支名稱或索引。LOOP:true 表示繼續,false 表示停止,或後續執行次數 |
duration() | 動作的 Duration 為 =script() 時 | 以 Duration 單位表示的持續時間 |
response 包含提示對話方塊的回答,以輸入名稱為索引鍵。
使用 Automatic (when no script) 時以及在蒙地卡羅中,不會顯示提示,而是使用預設值:數字的值或 0、核取方塊的值,或第一個選項。
提示建立器
p.setTitle(text):對話方塊標題(預設為「Input for <name>」)。p.addEnumInput(title, name, choices, default):選項清單。p.addTextInput(title, name, default)、p.addBigtitleTextInput(title, name, default)(多行)、p.addNumberInput(title, name, default)、p.addBooleanInput(title, name, default)(核取方塊)。
對話方塊顯示「模擬已於 <time> 暫停。」,並以確定關閉。
指令碼中可用的內容
print(x, …):寫入主控台。物件會以 JSON 輸出。globals.put(key, value)、globals.get(key):在指令碼變數中隨時間追蹤的值。數值全域變數會成為統計、S 曲線和對照需求檢查…中的蒙地卡羅輸出(Global: key)。Sim.getEntityById(id)、Sim.getEntityByGlobalId(id)、Sim.getEntityByName(name)、Sim.getEntityByNumber(number)、Sim.getEntitiesByName(name)、Sim.getEntitiesByNumber(number):傳回實體包裝物件。- 屬性:
id、name、number、description、className。 - 方法:
getId()、getGlobalId()、getName()、getNumber()、getDescription()、getAttribute(name)(依屬性名稱,不分大小寫)和attributes().get(name)。
- 屬性:
Sim.getIOValueById(id)、Sim.getIOValueByGlobalId(id)、Sim.getIOValueByName(name)、Sim.getIOValueByNumber(number):Input/Output 的 Value 屬性。Sim.getAmount(name)、Sim.getAmountById(id)、Sim.getAmountByGlobalId(id):Resource 的目前數量。Sim.getResourceByName(name)會傳回{id, name, amount, units}。Sim.setResourceById(id, value)、Sim.setResourceByGlobalId(id, value)、Sim.setResourceByName(name, value):設定 Resource 的數量(記錄為 Script 變更)。Sim.getCurrentTime()(自開始起的毫秒數)和Sim.getCurrentCost()。
每個指令碼在每次執行中只編譯一次,因此最上層變數在迴圈的各次執行之間會保留其值。除了資源數量之外,模型對指令碼而言是唯讀的。
範例:依電池電量決定分支
function onEnd() {
const wh = Sim.getAmount('Battery Charge');
globals.put('Battery at decision', wh);
return wh > 40 ? 'Yes' : 'No';
}
將此放在 OR Contact in view? 上,並將判斷類型設為指令碼。分支名稱必須是是和否。
沙箱和信任
- 每次執行都在獨立的沙箱中進行,並使用模型的唯讀副本。指令碼無法存取頁面、其他專案、檔案、瀏覽器儲存空間或網路。
- 執行超過 8 秒的指令碼呼叫會停止執行:「<name> 的指令碼執行超過 8 秒,已停止。請檢查是否有無窮迴圈。」
- 您在此瀏覽器中撰寫或核准的指令碼為受信任的指令碼。
執行中可能包含來自其他地方的指令碼,例如匯入的檔案或其他成員的編輯。在這類執行之前,Holarch 會請您核准它們。此詢問會在 ▶ 播放、⏭ 單步、⏩ 執行到結束和 ▶ 執行蒙地卡羅之前出現。
- 開始執行。
執行其他作者的指令碼?對話方塊會列出指令碼的數量,並說明指令碼在沙箱中執行,無法存取您的專案、檔案或網路。
- 開啟顯示指令碼以審查它們。
- 按一下執行指令碼以執行它們,或按一下取消。
按一下執行指令碼後,這些指令碼從此在此瀏覽器中即為受信任的指令碼。
鍵盤和滑鼠
| 動作 | 效果 |
|---|---|
| 按一下甘特圖長條、圖表點、樹狀圖儲存格或狀態列 | 在屬性面板中開啟該實體 |
| 按一下分解的甘特圖列標籤 | 摺疊或展開其子項 |
| 指令碼編輯器中的 Tab | 插入兩個空格 |
訊息
| 訊息 | 意義與修正方式 |
|---|---|
| 「沒有可模擬的 Action」/「為 Action 新增子 Action,並在其 Action 圖中繪製流程。」 | 專案中沒有具有流程的 Action |
| 「模擬錯誤」及詳細資料 | 執行無法開始或沙箱失敗;請閱讀詳細資料 |
| 「根 Action 已不存在。請選擇另一個根 Action。」 | 根已被刪除 |
| 「<name> (<hook>) 中的指令碼錯誤:<message>」 | 指令碼擲回例外;執行停止。主控台會顯示行號 |
| 「<name>:指令碼傳回「x」,不符合任何分支;已隨機挑選。」 | OR 指令碼傳回不明的分支名稱 |
| 「<name>:超過 10000 次反覆運算 — 請檢查 LOOP 條件。」 | LOOP 永不停止 |
| 永不結束的迴圈(執行之前) | 沒有任何 EXIT 能結束以 100 % 重複的迴圈 (Action.19)。請修正它,或按一下仍要執行。 |
| 「存在無限階層 (A → B → A)。請在圖中移除其中一個分解關聯。」 | 某個動作被分解成它自己 |
| 「Simulation aborted: too many steps (check LOOP counts or recursive decomposition).」(模擬已中止:步驟過多,請檢查 LOOP 次數或遞迴分解。) | 單次執行中超過 20,000 次動作執行 |
| 「模擬已中止:已達事件上限。」 | 單次執行中超過 500,000 個事件 |
| 「死結:<action> 正在等待 I/O <name>(從未產生)」 | 觸發 I/O 從未產生 |
| 「死結:<action> 正在等待 <amount> <resource>(從未可用)」/「正在等待 Asset 容量:…」 | 資源或容量從未變為可用 |
| 「Asset <name> 有多個父項;使用第一個父項決定其容量。」 | 資產的容量來自第一個父項的 Multiplicity |
| 「<I/O> 由多個 Conduit 傳送;模擬器使用了 <conduit>。」 | 只套用第一個 Conduit 的延遲 |
| 「模擬指令碼沒有網路存取權(Sim.httpGet、httpPost 和 httpPut 無法使用)。」 | 指令碼無法呼叫網路 |
| 「找不到名稱為 <name> 的實體」/「找不到 id 為 <id> 的資源」 | Sim 查詢沒有找到任何結果 |
| 「模擬指令碼無法在執行時編譯程式碼。」/「模擬指令碼無法使用 import()。」 | 指令碼嘗試建立或載入程式碼 |
| 「<name> 的指令碼執行超過 8 秒,已停止。請檢查是否有無窮迴圈。」 | 指令碼監控程式 |
| 「模擬停止回應,已停止。」 | 沙箱在指令碼之外停止回應 |
| 「蒙地卡羅執行已停止」 | 您按了取消 |
| 「N 次執行中有 n 次失敗(d 次死結,e 次錯誤)。P(failure) = …」 | 失敗的執行會從統計中排除;請使用檢視執行 |
| 「沒有已完成的執行。請先執行蒙地卡羅。」 | 對照需求檢查…需要已完成的執行 |
| 「輸入門檻值,或選擇一個 Measure。」/「請先輸入門檻值。」 | 檢查沒有值 |
| 「<Measure> 沒有數值的 Threshold Value。請輸入門檻值。」 | Measure 的門檻值或目標值不是數字 |
| 「選擇一個 Measure 或 Requirement 以記錄結果。」 | 記錄結果…需要目標 |
| 「至少選取一項變更。」 | 記錄結果的每一列都未勾選 |
| 「已記錄結果」 | Measure 和 Test Case 已更新 |
| 「所需機率落在信賴區間內。請執行更多次反覆運算以取得更明確的判定。」 | 執行次數更多時,判定可能會改變 |
| 「無法讀取已儲存的結果:<reason>。請再次執行模擬。」 | 已儲存的 .sim 檔案遺失或無效;請按一下重新執行 |
| 「此面板屬於另一種模擬模式。」 | 另一種模式的面板 |
| 「僅供檢視:請向擁有者要求編輯存取權。」 | 檢視者可以執行模擬,但無法儲存設定、結果或記錄的檢查 |
限制
- 蒙地卡羅:每項研究 1 至 20,000 次反覆運算。
- 單次執行:最多 20,000 次動作執行、500,000 個事件,以及單一 LOOP 的 10,000 次執行。
- 指令碼呼叫:每次 8 秒。
- 失敗執行表格:列出前 50 次失敗的執行。執行 ⋯ → 下載資料… → 執行 (CSV) 會列出每次執行。
- 執行分頁:列出前 500 次執行;執行 (CSV) 包含所有執行。
- 蒙地卡羅統計只使用已完成的執行。
- 只有第一個傳送 I/O 的 Conduit 會設定其延遲;只有第一個父項會設定資產的容量。
相關內容
- 指南:系統工程中的蒙地卡羅模擬,從點估計到機率。
- Action 圖:建立流程、結構、I/O、資源和指令碼。
- 功能分析:從需求推導功能和流程。
- 說明中的模擬器、模擬指令碼和模擬並對照需求檢查。
- 屬性類型與分布和設定驗證、執行套件並產生 RVTM。