行为
仿真
将 Action 流作为离散事件仿真或蒙特卡洛研究运行,读取时间、成本、资源和利用率结果,用脚本定义决策,并针对需求记录验证结果。
本页内容
概述
仿真器在仿真时间上运行一个 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)。
关于持续时间、判断、资源、资产、成本和种子的详细规则,请参阅下文的仿真规则。
如何使用
何时使用及原因
在功能流程已存在且其动作具有持续时间、执行者和资源时进行仿真。这通常是在功能分析之后、分配和架构权衡期间。
仿真回答以下问题:
- 操作需要多长时间,时间的变化有多大?
- 哪些动作在关键路径上?它们在何处等待数据、资源或资产容量?
- 电池电量或数据存储等资源是否保持在限值内?
- 哪些资产过载?
- 满足某项性能需求(时间、成本、资源水平)的概率是多少?这会成为关联到该需求的分析验证结果。
运行离散事件仿真
- 打开该操作的 Action 图。
- 选择 ▶ 仿真 ▾ → 离散事件。
仿真器会以该 Action 作为根 Action打开。
其他打开方式:导航栏中的行为 → 仿真器(它会打开已保存仿真器设置的 Action,否则打开第一个有流程的 Action;根据需要选择其他根 Action),或 Action 的打开方式 ▾ → 仿真器。用鼠标选择其他根 Action会立即打开它;使用键盘时,选择它并按 Enter(或点击打开)。
- 检查设置:点击顶部栏中的设置(其工具提示列出当前设置)。主要设置有决策、速度、带 ± % 的改变固定持续时间、随机种子和日历日期(请参阅设置)。
- 按 ▶ 播放。
时钟开始运行,Action 随时间变化(时间线标签页)不断增长。运行中的 Action 图将正在运行的动作着为绿色,等待中的为橙色,已完成的为灰色。
- 按 ⏸ 暂停停止并检查。
- 按 ⏭ 单步前进到下一个事件,或按 ⏩ 运行到结束在没有动画的情况下完成。
- 当出现标题为… 的输入的对话框时,选择路径或输入值。
- 点击确定。
运行按之前的方式继续:播放、单步或运行到结束。
- 运行结束时阅读结果:
- 状态:已完成 100%、死锁或已停止。发生死锁后,它会说明运行何时停止以及每个等待中的动作在等待什么,例如Stopped at 0 ms: F1 Separate and Detumble waits for ADCS Sensor Data, which no earlier action produces.点击动作名称可检查它;
- 总时间和总成本;
- 资源和利用率面板;
- 控制台,用于查看警告。
- 点击任意条形或图表元素可查看详细信息。
该实体在属性面板中打开,并显示它在此次运行中运行的次数和时长。打开方式 ▾ → 条目视图打开其页面。
- 按 ⟲ 重置清除运行并重新开始。
运行蒙特卡洛研究
- 将页眉切换到蒙特卡洛。也可以在 Action 图中改为选择 ▶ 仿真 ▾ → 蒙特卡洛。
- 设置运行次数(1 到 20,000;默认 100)。
- 如果希望固定持续时间有分布范围,请设置改变固定持续时间。
- 如果研究必须可重复,请输入随机种子。
- 按 ▶ 运行蒙特卡洛。
如果某些 OR 或 LOOP 没有概率或次数,未指定的决策对话框会列出它们。
- 在该对话框中,点击使用等概率继续。或点击取消,然后在 Action 图中设置它们。
您会看到一个进度条和运行中的文字
k / n · mean … · mean cost …。点击取消可停止;提示消息显示“蒙特卡洛运行已停止”。研究完成后,文字显示仿真次数和耗时。
- 阅读已完成的运行,然后是分布标签页(统计、持续时间分布、累积概率(S 曲线))和驱动因素标签页中的分支组合。
如果有运行发生死锁或失败,红色框会给出数量以及 P(failure) 及其 95% 置信区间。
- 要查看运行失败的原因,请打开失败的运行并点击查看运行。
该运行以其自身的种子在离散事件模式下重放。
- 点击返回蒙特卡洛结果返回。
检查需求并记录结果
在蒙特卡洛研究之后使用此功能,将结果转化为验证结果。
- 点击对照需求检查…。
- 选择输出:总时间、总成本、每个 Resource 的最小或最终数量,或一个数值型脚本全局变量(Global: …)。
- 用以下两种方式之一设置阈值:
- 从 Measure:选择一个度量和一个使用(阈值或目标)。字段会根据该 Measure 填写(见下文)。
- 手动:设置准则(≤ 至多或≥ 至少)、值和单位,然后选择 Requirement。
- 设置所需概率 (%)(默认 90)。
您会看到结果表:
- 准则和运行;
- 平均值(95% CI)和 P5 / P50 / P95;
- P(meet),及其 95% 置信区间;
- 裕度(平均值与阈值);
- 结果:通过或失败。
- 点击记录结果…。
记录结果预览列出它将进行的更改:
- Measure 的 Projected Value(或 Value)设为平均值。
- 一个 Test Case 验证该需求。它是一个名为“Simulation check: <output> <criterion>”的新测试用例,或您选择的现有测试用例。其状态变为 Passed 或 Failed,其实际结果设为结果文字。
- 取消勾选您要跳过的任何行。
- 点击应用。
一次撤销即可全部撤回。
在步骤 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,导入时两个名称都接受。
重新打开已保存的结果:
- 打开页眉中的已保存的结果 ▾。
- 选择结果。
横幅显示“正在查看已保存的结果:…”。其在当前模型上重新运行链接以相同模式运行当前模型。
实例: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 的流程:
- 三个按顺序运行的步骤:
- 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?:
- Yes(75%)运行 OPS.8 Transmit Image Data(正态分布,8 ± 1.5 分钟);
- No(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 期间恢复。
- 总成本显示“无成本”,因为该演示没有 Cost 实体。
- Action 随时间变化并排显示 OPS.4 和 OPS.5,以及 OPS.6 和 OPS.7 的四次带编号迭代(
- 切换到蒙特卡洛。
- 按 ▶ 运行蒙特卡洛(200 次运行)。
分支组合(驱动因素标签页)显示大约四分之三的运行走 Yes。
- 点击对照需求检查…并保留总时间。
- 选择 Measure MOE-7 Planning Cycle Time,并将使用设为阈值。
值变为 100,单位为 Minutes,准则为 ≤,Requirement 为 6.5 Planning Cycle Time。
- 保留 90%,阅读 P(meet) 和判定。
- 点击记录结果…,然后点击应用。
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,000 | 100 |
| 决策 | 离散事件 | 自动(无脚本时)、询问(无脚本时) | 自动(无脚本时) |
| 速度 | 离散事件 | 1×、10×、100×、1,000×、10,000×、100,000×(每个真实秒对应的仿真秒数) | 100× |
| 改变固定持续时间 | 两者(每种模式分别保存) | 无、Uniform ±%、Triangular ±% | 无 |
| ± % | 两者 | 0 到 100 | 10 |
| 随机种子 | 两者 | 一个数字,留空则随机 | 空白 |
| 日历日期 | 离散事件 | 从根 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) |
| Resource | Resource 水平随时间变化 | 所选 Resource 的数量随时间的变化 | Resource 水平随时间变化 (CSV) |
| Resource | Resource 数量 | 每个 Resource 的初始、最小、最大、最终、消耗和产生数量 | Resource 变化 (CSV) |
| Resource | Asset 忙碌时间 | 每个执行 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) |
| Resource | Resource 水平 | 每个 Resource 的平均最小、最大和最终数量 | 各次运行的 Resource (CSV) |
| Resource | Asset 忙碌时间 | 每个执行 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 钩子。当仅靠图无法表达某种行为时使用它们,例如基于资源水平的判断。
编写脚本:
- 在 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 保存提示对话框的回答,以输入名称为键。
使用自动(无脚本时)时以及在蒙特卡洛中,不显示提示,而是使用默认值:数字的值或 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 会要求您批准它们。该问题出现在 ▶ 播放、⏭ 单步、⏩ 运行到结束和 ▶ 运行蒙特卡洛之前。
- 开始运行。
对话框运行其他作者的脚本?列出脚本的数量。它说明脚本在沙箱中运行,无法访问您的项目、文件或网络。
- 打开显示脚本以审阅它们。
- 点击运行脚本运行它们,或点击取消。
一旦您点击运行脚本,这些脚本此后在此浏览器中即受信任。
键盘和鼠标
| 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 设置其延迟;只有第一个父项设置资产的容量。
相关内容
- 指南:系统工程中的蒙特卡洛仿真,从点估计到概率。
- Action 图:构建流程、结构、I/O、资源和脚本。
- 功能分析:从需求派生功能和流程。
- 帮助中的仿真器、仿真脚本和仿真并对照需求检查。
- 属性类型和分布以及设置验证、运行套件并生成 RVTM。