Holarch

行為

模擬

以離散事件模擬或蒙地卡羅研究執行 Action 流程、讀取時間、成本、資源與使用率結果、以指令碼控制決策,並針對需求記錄驗證結果。

使用方式 →

本頁內容
  1. 概觀
  2. 概念
    1. 模擬器讀取的內容
  3. 使用方式
    1. 使用時機與原因
    2. 執行離散事件模擬
    3. 執行蒙地卡羅研究
    4. 檢查需求並記錄結果
    5. 已儲存的執行
    6. 實作範例:CubeSat EO-1 成像過境
    7. 提示與良好做法
    8. 常見錯誤
    9. 與其他功能的關聯
  4. 模擬規則
    1. 持續時間和分布
    2. 控制結構
    3. Resource
    4. 資產和使用率
    5. 成本
    6. 亂數和種子
  5. 模擬器頁面
    1. 頁首和執行列
    2. 設定
    3. 離散事件控制項
    4. 蒙地卡羅控制項
    5. 面板上方的附註
  6. 面板
    1. 面板選單
    2. 離散事件分頁
    3. 蒙地卡羅分頁
  7. 指令碼
    1. 掛鉤
    2. 提示建立器
    3. 指令碼中可用的內容
    4. 範例:依電池電量決定分支
    5. 沙箱和信任
  8. 鍵盤和滑鼠
  9. 訊息
  10. 限制
  11. 相關內容

概觀

模擬器會在模擬時間上執行 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)。

持續時間、決策、資源、資產、成本和種子的詳細規則,請參閱下方的模擬規則。

使用方式

使用時機與原因

當功能流程已存在,且其動作已有持續時間、執行者和資源時,就可以進行模擬。這通常是在功能分析之後,於配置和架構權衡期間。

模擬回答:

  • 作業需要多長時間,時間的變化有多大?
  • 哪些動作位於要徑上?它們在哪裡等待資料、資源或資產容量?
  • 電池電量或資料儲存等資源是否保持在限制範圍內?
  • 哪些資產過載?
  • 效能需求(時間、成本、資源水準)達成的機率是多少?這會成為與該需求關聯的分析驗證結果。

執行離散事件模擬

  1. 開啟該作業的 Action 圖。
  2. 選擇▶ 模擬 ▾ → 離散事件。

    模擬器會以該 Action 作為根 Action開啟。

    其他開啟方式:導覽列中的行為 → 模擬器(它會開啟在已儲存模擬器設定的 Action 上,否則開啟在第一個有流程的 Action 上;視需要選擇其他根 Action),或 Action 的開啟位置 ▾ → Simulator(模擬器)。以滑鼠選擇其他根 Action會立即開啟它;使用鍵盤時,請選擇它並按 Enter(或按一下開啟)。

  3. 檢查設定:按一下頂端列中的設定(其工具提示會列出目前的設定)。主要設定包括決策、速度、變動固定持續時間及± %、隨機種子和日曆日期(請參閱設定)。
  4. 按▶ 播放。

    時鐘開始運行,Action 隨時間變化(時間軸分頁)會逐漸增長。執行中的 Action 圖會將執行中的動作標為綠色,等待中的標為橘色,完成的標為灰色。

  5. 按⏸ 暫停以停止並檢查。
  6. 按⏭ 單步前進到下一個事件,或按⏩ 執行到結束以不顯示動畫完成執行。
  7. 出現標題為Input for …(… 的輸入)的對話方塊時,請選擇路徑或輸入值。
  8. 按一下確定。

    執行會如先前一樣繼續:播放、單步或執行到結束。

  9. 執行結束時閱讀結果:
    • 狀態:已完成 100%、死結或已停止。發生死結後,它會說明執行在何時停止,以及每個等待中的動作在等待什麼,例如於 0 ms 停止:F1 Separate and Detumble 等待 ADCS Sensor Data,但沒有任何較早的動作產生它。按一下動作的名稱即可檢查它;
    • Total Time(總時間)和總成本;
    • 資源和使用率面板;
    • 主控台,顯示警告。
  10. 按一下任何橫條或圖表元素即可查看詳細資料。

    該實體會在屬性面板中開啟,顯示它在此次執行中執行的頻率和時間長度。開啟位置 ▾ → 項目檢視會開啟其頁面。

  11. 按⟲ 重設以清除執行並重新開始。

執行蒙地卡羅研究

  1. 將頁首切換為蒙地卡羅。或從 Action 圖改選▶ 模擬 ▾ → 蒙地卡羅。
  2. 設定執行(1 至 20,000;預設 100)。
  3. 如果您希望固定持續時間有變化,請設定變動固定持續時間。
  4. 如果研究必須可重複,請輸入隨機種子。
  5. 按▶ 執行蒙地卡羅。

    如果某些 OR 或 LOOP 沒有機率或次數,未指定的決策對話方塊會將其列出。

  6. 在該對話方塊中,按一下使用等機率以繼續。或按一下取消,並在 Action 圖中設定它們。

    您會看到進度列和執行中的文字 k / n · mean … · mean cost …。按一下取消即可停止;快顯通知顯示「已停止蒙地卡羅執行」。

    研究完成時,文字會顯示模擬次數和經過的時間。

  7. 閱讀已完成的執行,然後閱讀分布分頁(統計、持續時間分布、累積機率(S 曲線))以及Drivers(驅動因素)分頁中的分支組合。

    如果有任何執行發生死結或失敗,紅色方框會顯示次數和 P(failure) 及其 95% 信賴區間。

  8. 若要查看某次執行失敗的原因,請開啟失敗的執行並按一下檢視執行。

    該次執行會以其自己的種子在離散事件模式中重播。

  9. 按一下返回蒙地卡羅結果即可返回。

檢查需求並記錄結果

在蒙地卡羅研究之後使用,將結果轉換為驗證結果。

  1. 按一下對照需求檢查…。
  2. 選擇輸出:總時間、總成本、每個 Resource 的最小或最終數量,或數值型的指令碼全域變數(Global: …)。
  3. 以下列兩種方式之一設定閾值:
    • From a Measure(從 Measure):選擇一個度量和一個使用(Threshold 或 Objective)。欄位會從該 Measure 填入(見下文)。
    • By hand(手動):設定準則(≤ 至多或≥ 至少)、值和單位,並選擇需求。
  4. 設定所需機率 (%)(預設 90)。

    您會看到結果表格:

    • 準則和執行;
    • 平均值(95% CI)和P5 / P50 / P95;
    • P(meet),附其 95% 信賴區間;
    • 裕度(平均值與閾值);
    • 結果:通過或失敗。
  5. 按一下記錄結果…。

    記錄結果預覽會列出它將進行的變更:

    • Measure 的 Projected Value(或值)會設為平均值。
    • 一個 Test Case 會驗證該需求。它是名為「Simulation check: <output> <criterion>」的新 Test Case,或您選擇的現有 Test Case。其狀態會變成 Passed 或 Failed,其實際結果會設為結果文字。
  6. 取消勾選您要略過的任何列。
  7. 按一下套用。

    一次復原即可全部撤回。

在步驟 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,匯入時接受任一名稱。

重新開啟已儲存的結果:

  1. 開啟頁首中的已儲存的結果 ▾。
  2. 選擇結果。

    橫幅顯示「正在檢視已儲存的結果:…」。其在目前的模型上重新執行連結會以相同模式執行目前的模型。

實作範例: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 的流程:

  1. 三個步驟依序執行:
    • OPS.1 Transmit Imaging Plan(三角分布 4 至 9 分鐘,峰值 6;Ground Station);
    • OPS.2 Receive Imaging Plan(1 分鐘);
    • OPS.3 Load Command Schedule(2 分鐘)。
  2. 一個 Parallel:OPS.4 Rotate to Target(常態分布,3 ± 0.5 分鐘)和 OPS.5 Prepare Camera(5 分鐘)。兩者都由 OPS.3 產生的 Command Schedule I/O 觸發。
  3. 一個 LOOP Each target,4 次:OPS.6 Capture Image Strip(常態分布,40 ± 6 秒),接著 OPS.7 Encode and Store Image(均勻分布 20 至 40 秒)。
  4. 一個 OR Contact in view?:
    • 是 (75%) 執行 OPS.8 Transmit Image Data(常態分布,8 ± 1.5 分鐘);
    • 否 (25%) 執行 OPS.9 Hold Data Onboard。
  5. 一個 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% 的均勻變動。

執行它:

  1. 開啟行為 → 模擬器。
  2. 選擇 OPS Run Nominal Imaging Pass 作為根 Action,並保留離散事件。
  3. 按⏩ 執行到結束。

    您會看到:

    • 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 實體。
  4. 切換到蒙地卡羅。
  5. 按▶ 執行蒙地卡羅(200 次執行)。

    分支組合(Drivers 分頁)顯示約四分之三的執行走 是。

  6. 按一下對照需求檢查…並保留總時間。
  7. 選擇 Measure MOE-7 Planning Cycle Time,並將使用設為 Threshold。

    值變為 100,單位為 Minutes,準則為 ≤,需求為 6.5 Planning Cycle Time。

  8. 保留 90%,然後閱讀 P(meet) 和判定結果。
  9. 按一下記錄結果…,然後按套用。

    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 Carlo1 至 20,000100
決策離散事件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 至 10010
隨機種子兩者一個數字,或留空以隨機產生空白
日曆日期離散事件時鐘從根 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 掛鉤。當圖本身無法表達某種行為時(例如根據資源水準做決策),請使用指令碼。

撰寫指令碼:

  1. 在 Action 圖中選取元素。
  2. 在屬性面板中,按一下編輯指令碼…(動作),或在 OR、SYNC 和 LOOP 面板中按一下編輯指令碼… / 新增指令碼…。

    編輯器對話方塊會開啟,例如指令碼:Capture Image Strip或OR 指令碼:…。

  3. 按一下新增 onStart()、新增 prompt()、新增 onEnd()或新增 duration(),即可插入空的掛鉤。
  4. 撰寫程式碼。Tab 會插入兩個空格。
  5. 按一下儲存(或取消)。

掛鉤

掛鉤呼叫時機傳回值
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 會請您核准它們。此詢問會在 ▶ 播放、⏭ 單步、⏩ 執行到結束和 ▶ 執行蒙地卡羅之前出現。

  1. 開始執行。

    執行其他作者的指令碼?對話方塊會列出指令碼的數量,並說明指令碼在沙箱中執行,無法存取您的專案、檔案或網路。

  2. 開啟顯示指令碼以審查它們。
  3. 按一下執行指令碼以執行它們,或按一下取消。

按一下執行指令碼後,這些指令碼從此在此瀏覽器中即為受信任的指令碼。

鍵盤和滑鼠

動作效果
按一下甘特圖長條、圖表點、樹狀圖儲存格或狀態列在屬性面板中開啟該實體
按一下分解的甘特圖列標籤摺疊或展開其子項
指令碼編輯器中的 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 會設定其延遲;只有第一個父項會設定資產的容量。