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 的 Duration 属性(一个数字或一个分布,带单位)动作所需的时间。已分解的动作所需时间与其子流程相同。
分解具有自身流程的子 Action运行子流程,代替父项自身的持续时间
触发器动作 receives 的 Input/Output(关系属性 Trigger,除非设为 false,否则开启)动作等待,直到每个触发 I/O 都已生成
I/O 生成动作 generates 的 Input/Output动作结束时(在任何 Conduit 延迟之后)变为可用
Conduit 延迟transfers 该 I/O 的 Conduit:Latency 加上 Size ÷ Capacity延迟 I/O 的交付
Resource到 Resource 的 consumes、seizes 和 produces 关系,带有 Amount(默认 1)开始时消耗和占用。占用的数量在结束时释放。结束时产生。
Asset 容量带 Amount 的 performed by,以及该资产在其父项下的多重性动作等待,直到资产有空闲容量
Asset 忙碌时间执行动作的每个 Asset(performed by)忙碌 (%) 和利用率图表
成本由 Action 或执行 Asset incurred by 的 Cost 实体累加到运行中的总成本
日历根和每个 Action 的 Start 属性仅在日历日期中使用
脚本动作或结构的仿真脚本设置持续时间、决定分支、向您提示并跟踪值的钩子

时间以秒为单位保存,并以最易读的单位显示(ms、sec、min、hr、days、months 或 years)。

关于持续时间、判断、资源、资产、成本和种子的详细规则,请参阅下文的仿真规则。

如何使用

何时使用及原因

在功能流程已存在且其动作具有持续时间、执行者和资源时进行仿真。这通常是在功能分析之后、分配和架构权衡期间。

仿真回答以下问题:

  • 操作需要多长时间,时间的变化有多大?
  • 哪些动作在关键路径上?它们在何处等待数据、资源或资产容量?
  • 电池电量或数据存储等资源是否保持在限值内?
  • 哪些资产过载?
  • 满足某项性能需求(时间、成本、资源水平)的概率是多少?这会成为关联到该需求的分析验证结果。

运行离散事件仿真

  1. 打开该操作的 Action 图。
  2. 选择 ▶ 仿真 ▾ → 离散事件。

    仿真器会以该 Action 作为根 Action打开。

    其他打开方式:导航栏中的行为 → 仿真器(它会打开已保存仿真器设置的 Action,否则打开第一个有流程的 Action;根据需要选择其他根 Action),或 Action 的打开方式 ▾ → 仿真器。用鼠标选择其他根 Action会立即打开它;使用键盘时,选择它并按 Enter(或点击打开)。

  3. 检查设置:点击顶部栏中的设置(其工具提示列出当前设置)。主要设置有决策、速度、带 ± % 的改变固定持续时间、随机种子和日历日期(请参阅设置)。
  4. 按 ▶ 播放。

    时钟开始运行,Action 随时间变化(时间线标签页)不断增长。运行中的 Action 图将正在运行的动作着为绿色,等待中的为橙色,已完成的为灰色。

  5. 按 ⏸ 暂停停止并检查。
  6. 按 ⏭ 单步前进到下一个事件,或按 ⏩ 运行到结束在没有动画的情况下完成。
  7. 当出现标题为… 的输入的对话框时,选择路径或输入值。
  8. 点击确定。

    运行按之前的方式继续:播放、单步或运行到结束。

  9. 运行结束时阅读结果:
    • 状态:已完成 100%、死锁或已停止。发生死锁后,它会说明运行何时停止以及每个等待中的动作在等待什么,例如Stopped at 0 ms: F1 Separate and Detumble waits for ADCS Sensor Data, which no earlier action produces.点击动作名称可检查它;
    • 总时间和总成本;
    • 资源和利用率面板;
    • 控制台,用于查看警告。
  10. 点击任意条形或图表元素可查看详细信息。

    该实体在属性面板中打开,并显示它在此次运行中运行的次数和时长。打开方式 ▾ → 条目视图打开其页面。

  11. 按 ⟲ 重置清除运行并重新开始。

运行蒙特卡洛研究

  1. 将页眉切换到蒙特卡洛。也可以在 Action 图中改为选择 ▶ 仿真 ▾ → 蒙特卡洛。
  2. 设置运行次数(1 到 20,000;默认 100)。
  3. 如果希望固定持续时间有分布范围,请设置改变固定持续时间。
  4. 如果研究必须可重复,请输入随机种子。
  5. 按 ▶ 运行蒙特卡洛。

    如果某些 OR 或 LOOP 没有概率或次数,未指定的决策对话框会列出它们。

  6. 在该对话框中,点击使用等概率继续。或点击取消,然后在 Action 图中设置它们。

    您会看到一个进度条和运行中的文字 k / n · mean … · mean cost …。点击取消可停止;提示消息显示“蒙特卡洛运行已停止”。

    研究完成后,文字显示仿真次数和耗时。

  7. 阅读已完成的运行,然后是分布标签页(统计、持续时间分布、累积概率(S 曲线))和驱动因素标签页中的分支组合。

    如果有运行发生死锁或失败,红色框会给出数量以及 P(failure) 及其 95% 置信区间。

  8. 要查看运行失败的原因,请打开失败的运行并点击查看运行。

    该运行以其自身的种子在离散事件模式下重放。

  9. 点击返回蒙特卡洛结果返回。

检查需求并记录结果

在蒙特卡洛研究之后使用此功能,将结果转化为验证结果。

  1. 点击对照需求检查…。
  2. 选择输出:总时间、总成本、每个 Resource 的最小或最终数量,或一个数值型脚本全局变量(Global: …)。
  3. 用以下两种方式之一设置阈值:
    • 从 Measure:选择一个度量和一个使用(阈值或目标)。字段会根据该 Measure 填写(见下文)。
    • 手动:设置准则(≤ 至多或≥ 至少)、值和单位,然后选择 Requirement。
  4. 设置所需概率 (%)(默认 90)。

    您会看到结果表:

    • 准则和运行;
    • 平均值(95% CI)和 P5 / P50 / P95;
    • P(meet),及其 95% 置信区间;
    • 裕度(平均值与阈值);
    • 结果:通过或失败。
  5. 点击记录结果…。

    记录结果预览列出它将进行的更改:

    • Measure 的 Projected Value(或 Value)设为平均值。
    • 一个 Test Case 验证该需求。它是一个名为“Simulation check: <output> <criterion>”的新测试用例,或您选择的现有测试用例。其状态变为 Passed 或 Failed,其实际结果设为结果文字。
  6. 取消勾选您要跳过的任何行。
  7. 点击应用。

    一次撤销即可全部撤回。

在步骤 3 中选择 Measure 时,它会按如下方式填写字段:

  • 其值填入值和单位。
  • 其 Improvement Direction 决定准则:Negative 对应 ≤,Positive 对应 ≥。
  • 它 specifies 的 Requirement 填入 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>”。其描述概述结果。
  • 没有随机种子的运行会获得一个种子,因此名称会告诉您如何重复它:输入该种子并再次运行。
  • 提示消息“已保存为 <名称>。”链接到该记录。
  • 蒙特卡洛运行的重放和已打开的记录不会再次保存。查看者无法保存记录。
  • 在数据库中删除不需要的记录(按标签 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.”用管理项目 → 项目文件 ▾ → 新建演示项目创建该演示。

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?:
    • Yes(75%)运行 OPS.8 Transmit Image Data(正态分布,8 ± 1.5 分钟);
    • No(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 期间恢复。
    • 总成本显示“无成本”,因为该演示没有 Cost 实体。
  4. 切换到蒙特卡洛。
  5. 按 ▶ 运行蒙特卡洛(200 次运行)。

    分支组合(驱动因素标签页)显示大约四分之三的运行走 Yes。

  6. 点击对照需求检查…并保留总时间。
  7. 选择 Measure MOE-7 Planning Cycle Time,并将使用设为阈值。

    值变为 100,单位为 Minutes,准则为 ≤,Requirement 为 6.5 Planning Cycle Time。

  8. 保留 90%,阅读 P(meet) 和判定。
  9. 点击记录结果…,然后点击应用。

    MOE-7 的 Projected Value 获得平均值。验证 6.5 的 Test Case 获得状态 Passed 或 Failed。RVTM 现在会针对 6.5 列出该 Test Case。

提示和良好做法

  • 为每个叶动作设置 Duration。没有 Duration 的动作不占用时间,并在时间轴上隐藏。
  • 对不确定的持续时间使用分布。仅将改变固定持续时间用作快速敏感性检查。
  • 在蒙特卡洛之前,为每个 OR 设置概率,为每个 LOOP 设置迭代次数。否则每次运行都会随机选取,结果中也会注明这一点。
  • 在记录验证结果之前设置随机种子,使结果可以重现。种子会包含在记录的文字中。
  • 运行足够多的迭代。当所需概率落在置信区间内时,检查会显示“运行更多迭代以获得更可靠的判定。”
  • 设置在您更改时随根动作一起保存,因此它们会随项目一起携带。

常见错误

现象原因修正
状态显示死锁;控制台显示“等待 I/O …(从未生成)”某个动作将一个 I/O 作为触发器接收,而在所走的路径上(例如在 OR 之后)没有任何对象生成它在每条路径上都生成该 I/O,或在 receives 关系上将 Trigger 设为 false
死锁“等待 …(从不可用)”某个 Resource 永远无法回升到动作所需的数量以上,或某个资产的容量小于一个动作的 Amount提高 Initial Amount、添加一个产生动作,或检查 Amount 和多重性
每次运行的总时间都相同所有持续时间都是固定的,且变化为无使用分布,或设置改变固定持续时间
“仿真已中止:步骤过多(请检查 LOOP 次数或递归分解)。”某个 LOOP 运行次数过多,或某个动作位于其自身的分解中降低 LOOP 次数或修正分解
控制台显示“Script error in …”脚本抛出了异常打开该动作的脚本(Action 图属性面板中的编辑脚本…)并修正所示的行
Asset 利用率为空没有动作 performed by 某个 Asset将动作关联到其执行 Asset

关联方式

  • 输入来源:Action 图流程,以及其动作、I/O、资源、Conduit、资产和成本的属性与关系。在功能分析中构建的流程就是同一个流程。
  • 输出到:
    • Measure(Projected Value 或 Value);
    • 验证需求的 Test Case,进而影响 RVTM 和测试中心;
    • 带有已保存结果的 Artifact;
    • MS Project XML 进度计划和 CSV 报告。

仿真规则

本节准确说明仿真器如何处理持续时间、判断、资源、资产、成本和随机数。

持续时间和分布

  • Duration 是一个值和一个单位:Milliseconds、Seconds、Minutes、Hours、Days、Weeks、Months 或 Years。没有单位的值按小时读取。
  • 该值是一个固定数字或一个分布,例如 =norm.dist(40, 6) 或 =triang.dist(4, 9, 6)。
  • 每次执行时都会对分布进行采样。
  • 采样到的负持续时间会重新抽取。因此,正态分布的表现如同在 0 处截断。
  • 提供十种分布:beta、二项、指数、gamma、对数正态、正态、泊松、三角、均匀和 Weibull。请参阅属性类型和分布。
  • =script() 的 Duration 会在每次执行时调用该动作的 duration() 钩子。在 Duration 值中输入 =script();钩子以 Duration 的单位返回持续时间(没有数字则计为 0)。

改变固定持续时间是一个只为固定数字增加分布范围的设置。分布永远不会被进一步改变。

  • Uniform ±% 在 ± 百分比范围内均匀采样。
  • Triangular ±% 按在固定值处达到峰值的三角分布采样。

控制结构

构造仿真行为
Parallel(无实体)同时启动每个分支。所有分支完成后继续。
SYNC与 Parallel 相同。其 Duration 是一个超时。超时到期时,未完成的分支会被停止(其甘特条变为红色,显示“stopped by SYNC timed out”),流程继续。
OR只走一个分支,由判断类型(见下文)选择
LOOP在每一轮之前检查其当满足时重复,条件成立时再次运行主体
EXIT结束所在的 LOOP。在顶层时结束流程。

OR 判断类型:

  • 概率:每个分支有一个概率 (%)。留空的分支平均分配 100% 中剩余的部分。如果每个概率都为 0,则每个分支的可能性相同。
  • 资源数量:每个分支比较所选 Resource 的当前数量(==、!=、>、<、>=、<=)。走第一个条件成立的分支,否则走标记为 else 的分支。
  • 脚本:结构的 onEnd() 返回要走的分支名称(或其索引)。未知名称会记录警告,并随机选择一个分支。
  • 无(运行时询问或随机):当决策设为询问(无脚本时)时,对话框会询问走哪条路径。否则随机选取一个分支。

LOOP 继续条件:

  • 迭代次数:固定的轮数(至少 1)。
  • 概率:每一轮之前,以此概率 (%) 继续。
  • 资源数量:当 Resource 数量满足比较条件时继续。
  • 脚本:每一轮之前调用 onEnd()。true 再次运行主体,false 停止,数字则设置还要运行多少轮。
  • 无(运行时询问或随机):在提示模式下,对话框会询问迭代多少次?(默认 3)。否则随机运行 0、1 或 2 轮。

Resource

Resource 具有 Initial Amount、Minimum Amount、Maximum Amount 和 Units。初始数量会被限制在最小值和最大值之间。

  • consumes:动作开始时取走该数量,且不归还。
  • seizes:动作开始时取走该数量,结束时释放。
  • produces:动作结束时增加该数量。超过最大值的数量会被截断。

当动作需要的数量多于可用数量时,它会等待。“不可用”表示数量将低于 Minimum Amount,或在未设置最小值时低于 0。动作等待,直到其他动作释放或产生足够的数量。其甘特条显示紫色斜线等待。

资产和利用率

  • 执行动作的每个 Asset(performed by)在该动作运行期间处于忙碌状态。
  • 忙碌 (%)是其至少一个动作正在运行的时间占仿真时间的比例。

要对容量建模,请在 performed by 关系上设置 Amount。

  • 资产的容量是其父项 decomposed by 关系上多重性的上限。例如,0..2 表示 2。
  • 当资产没有空闲容量时,动作会等待(橙色斜线等待)。
  • 没有多重性时,容量不受限制。

成本

  • Cost 实体具有 Amount、Rate 和 Units。
  • Rate 为 Per Hour 时,数量乘以动作以小时计的持续时间。否则在动作结束时一次性计费。
  • 由执行 Asset 引发的 Cost 会针对该 Asset 执行的每个动作计费。它会乘以 performed by 的 Amount(未设置时为 1)。
  • 找到的第一个 Cost 的单位用于标注每个成本数字。

随机数和种子

  • 随机种子使运行可重复。留空则每次使用新的随机序列。
  • 在蒙特卡洛中,每次运行都从研究的种子派生自己的种子。因此,您可以用运行标签页中的重放(或对于失败的运行使用查看运行),在离散事件模式下重放任意单次运行。
  • 脚本中的 Math.random() 使用相同的带种子生成器。

仿真器页面

页眉和运行栏

页眉下方的栏从左到右依次是根 Action、该模式的运行控件(见下文)、设置和模式切换。首次运行之前,页面显示一行说明和 Action 图;摘要卡片(状态、总时间、总成本,或蒙特卡洛的相应卡片)随首次运行出现。

  • 根 Action:运行其流程的动作。列表显示每个带有动作流程的 Action。没有流程的动作显示为“(无流程)”。选择另一个根会为其重新打开页面。
  • 离散事件 / 蒙特卡洛:模式。切换时会保留每种模式的设置。
  • 页眉:已保存的结果 ▾(已保存的运行,或“尚无已保存的运行。每次完成的运行都会保存在此处。”)和打开 Action 图。

设置

设置显示或隐藏栏下方的运行设置(初始隐藏;该选择会在此浏览器中记住)。其工具提示列出当前设置,例如“自动判断,100× 速度,固定持续时间,种子 42”。

设置模式值默认
运行蒙特卡洛1 到 20,000100
决策离散事件自动(无脚本时)、询问(无脚本时)自动(无脚本时)
速度离散事件1×、10×、100×、1,000×、10,000×、100,000×(每个真实秒对应的仿真秒数)100×
改变固定持续时间两者(每种模式分别保存)无、Uniform ±%、Triangular ±%无
± %两者0 到 10010
随机种子两者一个数字,留空则随机空白
日历日期离散事件从根 Action 的 Start 日期开始计时;带有 Start 的 Action 会等待到该时间关闭
以暂停状态开始(逐步执行)离散事件页面打开时即创建运行,可直接使用 ⏭ 单步关闭
  • 设置在您更改时随根动作保存在项目中,并对所有打开它的人生效。每次更改都可通过一次撤销撤回。它们还会在此浏览器中记住,用于其他根动作。
  • 重置为默认值(位于“设置随此 Action 保存。”之后)恢复默认值,并清除图表的实体选择。
  • 查看者可以为自己的运行更改设置;这些设置不会保存在项目中。

离散事件控件

  • ▶ 播放 / ⏸ 暂停:以所选速度动画显示运行。没有事件的长时间段会被立即跳过。
  • ⏭ 单步:前进到下一个事件。
  • ⏩ 运行到结束:不带动画地运行到结束。遇到提示时仍会停止。
  • ⟲ 重置:放弃该运行。
  • 时钟:当前仿真时间(在日历日期中为日期和时间)。

蒙特卡洛控件

  • ▶ 运行蒙特卡洛、取消、进度条和进度文字。
  • 对照需求检查…(在有已完成运行的研究之后启用)。
  • 任何运行都可以从运行标签页重放,或下载为 MS Project 进度计划。

面板上方的说明

需要注意的通知(例如正在查看已保存的结果)在隐藏设置时仍然可见。

  • 开启变化时显示“已为固定持续时间添加 ±n% 均匀变化。”(或三角变化)。
  • 使用使用等概率之后显示“已对 n 个未指定的结构使用等概率:…”。
  • 失败运行框(蒙特卡洛)和重放横幅“正在以种子 s 和研究的设置重放蒙特卡洛运行 n(死锁或错误)。”

面板

结果采用固定布局:顶部是摘要栏,下方是标签页。每个标签页包含两列面板;宽面板(图、甘特图、事件日志、统计和运行)横跨两列。运行之前,每个面板显示其说明。打开的标签页会在此浏览器中记住。

面板菜单

每个面板都有一个标题和一个 ⋯ 菜单:

  • 下载数据…打开导出对话框,包含该面板的数据:含所有列的 CSV 文件;对于 Action 随时间变化,还有进度表 (MS Project XML)。文件名为“<root> <面板标题>”。
  • 下载图像…打开导出对话框,包含 <面板标题> (PNG)(可选透明背景和缩放比例)和 <面板标题> (SVG)。图像使用浅色主题配色。
  • 选择实体…(成本、资源和资产图表)打开选择实体:按名称或编号筛选列表,勾选实体(全部、无),然后点击应用。不勾选任何实体时,图表显示所有实体。成本图表增加显示总计。颜色按列表顺序遵循图表调色板。该选择随根动作保存。

点击图表、状态列表或事件日志中的实体,可在属性面板中打开它,并显示其运行次数和时长。

离散事件标签页

摘要栏:状态、总时间和总成本。

标签页面板显示内容数据
—状态当前正在运行的动作及其进度。黄色:等待 Input/Output;紫色:等待 Resource;橙色:等待 Asset 容量。结束时显示:已完成 100%、死锁或已停止,以及动作执行次数和总时间—
—总时间仿真时钟(在日历日期中为日期,并显示已用时间)—
—总成本运行中的总成本和计入成本的实体数量—
时间线运行中的 Action 图根 Action 图(只读),动作在运行时着为绿色、等待时为橙色、完成后为灰色—
时间线Action 随时间变化已执行动作的甘特图;斜线部分为等待;已分解的动作为可点击折叠的括号(▸/▾);重复执行编号为 #2、#3;红色条表示被超时的 SYNC 停止;红色虚线标记时钟。工具:+、−(缩放)、重置、隐藏线条箭头 / 显示线条箭头、隐藏线条颜色 / 显示线条颜色时间线 (CSV)、进度表 (MS Project XML)
成本成本随时间变化每个所选实体的累计成本,以及总计成本随时间变化 (CSV)
成本按实体的成本每个所选实体的总成本(条形图)按条目的成本 (CSV)
ResourceResource 水平随时间变化所选 Resource 的数量随时间的变化Resource 水平随时间变化 (CSV)
ResourceResource 数量每个 Resource 的初始、最小、最大、最终、消耗和产生数量Resource 变化 (CSV)
ResourceAsset 忙碌时间每个执行 Asset 的忙碌 (%),以及随时间使用中的单位数(或运行中的动作数)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% CI、标准差、最小值、P5、中位数 (P50)、P95 和最大值(仅限已完成的运行)—
分布持续时间分布每次运行总持续时间的直方图运行持续时间 (CSV)
分布成本分布每次运行总成本的直方图(没有成本时显示“没有运行产生成本。”)运行成本 (CSV)
分布累积概率(S 曲线)所选输出的累积分布,带有 x 字段和读数 P(X ≤ x)—
驱动因素按 Action 的时间所有运行中各动作的合计持续时间Action 持续时间 (CSV)
驱动因素按 Action 的成本所有运行中每个动作或资产的合计成本Action 成本 (CSV)
驱动因素分支组合每种 OR 分支组合,带有运行和占比分支组合 (CSV)
ResourceResource 水平每个 Resource 的平均最小、最大和最终数量各次运行的 Resource (CSV)
ResourceAsset 忙碌时间每个执行 Asset 的平均忙碌 (%)(资产少于三个时为条形图)各次运行的 Asset 使用情况 (CSV)
运行运行每次运行,带有运行、种子、结果(Completed、Deadlock、Error)、Duration 和成本。点击列标题可排序(再次点击则反向)。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 保存提示对话框的回答,以输入名称为键。

使用自动(无脚本时)时以及在蒙特卡洛中,不显示提示,而是使用默认值:数字的值或 0、复选框的值,或第一个选项。

提示构建器

  • p.setTitle(text):对话框标题(默认“<名称> 的输入”)。
  • 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)(复选框)。

对话框显示“仿真已在 <时间> 暂停。”,点击确定关闭。

脚本中可用的内容

  • 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 的数量(记录为脚本更改)。
  • 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? 上,判断类型设为脚本。分支名称必须为 Yes 和 No。

沙箱和信任

  • 每次运行都在单独的沙箱中执行,使用模型的只读副本。脚本无法访问页面、其他项目、文件、浏览器存储或网络。
  • 运行超过 8 秒的脚本调用会停止运行:“<名称> 的脚本运行超过 8 秒,已被停止。请检查是否存在死循环。”
  • 您在此浏览器中编写或批准的脚本是受信任的。

运行可能包含来自其他地方的脚本,例如导入的文件或其他成员的编辑。在这样的运行之前,Holarch 会要求您批准它们。该问题出现在 ▶ 播放、⏭ 单步、⏩ 运行到结束和 ▶ 运行蒙特卡洛之前。

  1. 开始运行。

    对话框运行其他作者的脚本?列出脚本的数量。它说明脚本在沙箱中运行,无法访问您的项目、文件或网络。

  2. 打开显示脚本以审阅它们。
  3. 点击运行脚本运行它们,或点击取消。

一旦您点击运行脚本,这些脚本此后在此浏览器中即受信任。

键盘和鼠标

Action效果
点击甘特条、图表点、树状图单元格或状态行在属性面板中打开该实体
点击已分解的甘特行标签折叠或展开其子项
脚本编辑器中的 Tab插入两个空格

消息

留言含义和解决方法
“没有可仿真的 Action”/“为 Action 添加子 Action,并在其 Action 图中绘制它们的流。”项目中没有带流程的 Action
“仿真错误”及详细信息运行无法启动或沙箱失败;请阅读详细信息
“根 Action 已不存在。请选择其他根 Action。”根已被删除
“Script error in <name> (<hook>): <message>”脚本抛出异常;运行停止。控制台显示行号
“<名称>:脚本返回了“x”,与任何分支都不匹配;已随机选取。”OR 脚本返回了未知的分支名称
“<名称>:超过 10000 次迭代 — 请检查 LOOP 条件。”某个 LOOP 从不停止
永不结束的循环(运行之前)没有 EXIT 可以结束以 100 % 重复的循环(Action.19)。请修正它,或选择仍然运行。
“存在无限层级(A → B → A)。请在图中移除其中一个分解关联。”某个动作被分解为它自身
“仿真已中止:步骤过多(请检查 LOOP 次数或递归分解)。”一次运行中超过 20,000 次动作执行
“仿真已中止:已达到事件上限。”一次运行中超过 500,000 个事件
“死锁:<动作> 正在等待 I/O <名称>(从未生成)”某个触发 I/O 从未生成
“死锁:<动作> 正在等待 <数量> <资源>(从不可用)”/“正在等待 Asset 容量:…”某个资源或容量从未变为可用
“Asset <名称> 有多个父项;使用第一个父项确定其容量。”资产的容量来自第一个父项的多重性
“<I/O> 由多个 Conduit 传送;仿真器使用了 <conduit>。”只应用第一个 Conduit 的延迟
“仿真脚本没有网络访问权限(Sim.httpGet、httpPost 和 httpPut 不可用)。”脚本无法调用网络
“No entity was found with name: <name>”/“No resource was found with id: <id>”Sim 查找没有找到任何内容
“仿真脚本无法在运行时编译代码。”/“仿真脚本无法使用 import()。”脚本尝试创建或加载代码
“<名称> 的脚本运行超过 8 秒,已被停止。请检查是否存在死循环。”脚本看门狗
“仿真停止响应,已被停止。”沙箱在脚本之外停止响应
“蒙特卡洛运行已停止”您点击了取消
“N 次运行中有 n 次失败(d 次死锁,e 次出错)。P(failure) = …”失败的运行被排除在统计之外;请使用查看运行
“没有已完成的运行。请先运行蒙特卡洛。”对照需求检查…需要已完成的运行
“请输入阈值,或选择一个 Measure。”/“请先输入阈值。”检查没有值
“<Measure> 没有数值型 Threshold Value。请输入阈值。”Measure 的阈值或目标不是数字
“选择一个 Measure 或 Requirement 来记录结果。”记录结果…需要一个目标
“请至少选择一项更改。”记录结果的每一行都未勾选
“已记录结果”Measure 和 Test Case 已更新
“所需概率落在置信区间内。运行更多迭代以获得更可靠的判定。”判定可能随更多运行而改变
“无法读取已保存的结果:<原因>。请再次运行仿真。”已保存的 .sim 文件缺失或无效;请点击重新运行
“此面板用于另一种仿真模式。”另一种模式的面板
"View only: ask an owner for edit access."(仅查看:请向所有者申请编辑权限。)查看者可以运行仿真,但不能保存设置、结果或记录的检查

限制

  • 蒙特卡洛:每项研究 1 到 20,000 次迭代。
  • 单次运行:最多 20,000 次动作执行、500,000 个事件,以及单个 LOOP 的 10,000 轮。
  • 脚本调用:每次 8 秒。
  • 失败运行表:列出前 50 次失败的运行。运行 ⋯ → 下载数据… → 运行 (CSV)列出每次运行。
  • 运行标签页:列出前 500 次运行;运行 (CSV)包含全部运行。
  • 蒙特卡洛统计只使用已完成的运行。
  • 只有传送 I/O 的第一个 Conduit 设置其延迟;只有第一个父项设置资产的容量。