Holarch

行为

Action 图

使用顺序、并行、决策、循环和退出结构对功能流建模,包括在动作之间传递的项、它们使用的资源以及执行它们的资产,然后进行仿真。

使用方法 →

本页内容
  1. 概述
  2. 概念
    1. 流程
    2. 流程周围的条目
  3. 如何使用
    1. 何时使用及原因
    2. 从零开始构建流程
    3. 从选项板拖动构建流程
    4. 连接 Input/Output 和 Resource
    5. 分配执行者
    6. 分解和向下钻取
    7. 仿真和确认
    8. 实例:CubeSat EO-1 成像过程
    9. 提示和良好做法
    10. 常见错误
    11. 与其他功能的关联方式
  4. 编辑器
    1. 页面标题区
    2. 工具栏
    3. 排列 ▾
    4. 生成 Asset 图
    5. 调色板
    6. 画布手势
    7. 每种形状显示的内容
    8. 属性面板
  5. 图如何映射到 LML
  6. 仿真脚本
  7. 删除和移除
  8. 键盘快捷键
  9. 选项和设置
  10. 消息
  11. 限制
  12. 相关页面

概述

Action 图显示父 Action 是如何执行的。它是 LML 行为图,仿真器运行的正是它所显示的内容。

该图显示:

  • 子 Action,按其运行顺序排列;
  • 流程在何处分成并行路径或备选路径,以及在何处循环;
  • 从一个 Action 传递到另一个 Action 的 Input/Output(I/O);
  • 每个 Action 使用的 Resource;
  • 执行工作的资产。

该图是模型的视图,而不是绘图。您添加、移动或删除的每个形状都会更改项目中的实体和关系。每次更改都可通过一次撤销撤回。

同一流程还驱动功能流程框图(FFBD)、SysML 活动图和时间线图。在其中任何一个中编辑流程,其他图都会随之更新。

概念

流程

流程从左侧的绿色开始胶囊运行到右侧的红色结束胶囊。箭头连接其间的元素。每个元素是以下之一:

元素形式含义实体
Action(串行步骤)带编号和名称的蓝色圆角框在前一个元素结束时开始的步骤根的一个子 Action(decomposed by)
并行标有 parallel 的分叉条和一个闭合条同时运行的两个或更多分支。所有分支完成后流程继续。无
SYNC标有 SYNC、右侧带尖角的块,以及一个闭合条带有自身实体的并行分支。其 Duration 是一个超时,会停止未完成的分支。名为“Sync Action”的 Action(控制类型 SYNC)
OR标有 OR、左侧带尖角的块,以及一个闭合圆一个判断:只运行一个分支名为“Or Action”的 Action(控制类型 OR)
LOOP一个入口圆、循环主体、标有 LOOP 的块,以及一个虚线返回箭头当继续条件成立时,主体重复执行。每一轮之前检查该条件。名为“Loop Action”的 Action(控制类型 LOOP)
EXIT标有 EXIT 的红色框到达时结束所在的 LOOP(或其所在的流程)无

分支是 Parallel、SYNC 或 OR 内部的一条路径。每个分支都是自己的序列,可以包含任何元素,包括更多结构。LOOP 包含一个序列,称为其主体。

OR、SYNC 和 LOOP 是带有自身实体的结构。该实体像步骤一样是根的子项,因此结构可以带有名称、脚本以及(对于 SYNC)超时。结构不是步骤:它们从不显示为 Action 框,时间线等视图也会跳过它们。

流程周围的条目

项形式关系含义
Input/Output流程上方的平行四边形。触发 Action 时为绿色,否则为灰色。Action generates I/O;Action receives I/O在 Action 之间传递的信息、数据或物料
父 Input/Output标有 parent input(开始左侧)或 parent output(结束右侧)的平行四边形根 Action receives 或 generates 它父 Action 的接口。在没有子 Action 使用它时以虚线绘制。
Resource流程下方的紫色六边形Action consumes、produces 或 seizes Resource,并带有 AmountAction 消耗、归还或产生的数量
执行 Asset⟂ 以及 Action 名称下方的 Asset 名称Asset performs Action执行该 Action 的人或物。在资产打开时显示。
执行者⟂ 以及 Parallel 或 SYNC 分支上的 Asset 名称Asset performs 该分支上的每个 Action整个分支的执行者。每次编辑时都保持同步。

对仿真而言有两个重要术语:

  • Trigger:设置了 Trigger(默认)的接收 I/O 会使接收它的 Action 等到该 I/O 存在为止。
  • 可选:关闭了 Trigger 的接收 I/O。Action 不等待它就开始。

Resource 线标有关系和数量,例如 consumes 1.5。只被占用的 Resource 以较浅的颜色绘制。

如何使用

何时使用及原因

在有了一组功能之后、将其分配给物理架构之前,构建 Action 图。这些功能通常来自对需求进行的功能分析。

该图回答以下问题:

  • 功能按什么顺序运行,哪些并行运行?
  • 系统在何处做出判断?
  • 每个功能需要什么、产生什么?
  • 整个序列需要多长时间?

每个分解层级使用一个图。从顶层运行场景开始,例如任务时间线或用例。然后为每个需要自身细节的功能添加一个图。

该图是可执行的。将其与仿真器结合使用,可在硬件存在之前尽早检查时间和资源需求。

从零开始构建流程

创建图:

  1. 打开导航栏底部的图。
  2. 点击+ 新建图。
  3. 在图类型下,选取 Action 图(位于行为组中,标记为 LML)。
  4. 在根中输入新 Action 的名称,例如 Run Nominal Imaging Pass。(稍后在属性面板中为其指定编号,例如 OPS。)
  5. 点击创建。

    您会看到开始和结束,以及提示将元素拖到此处或点击 + Action。

按顺序添加步骤:

  1. 点击 + 添加 ▾ → + Action ▾ → 新建 Action…。
  2. 在添加 Action中输入名称。
  3. 点击确定(或按 Enter)。

    您会在流程中看到一个带编号的 Action 框。编号从父级的编号延续:OPS.1、OPS.2,依此类推。新 Action 是根的子项。

  4. 保持新 Action 处于选中状态,对下一步重复步骤 1 到 3。+ Action 总是插入到所选元素之后。

添加同时运行的步骤:

  1. 选择并行步骤开始之前的那一步。
  2. 点击 + 添加 ▾ → + Sync。

    您会看到一个带两个空分支的 SYNC。

  3. 点击分支线以选择它。
  4. 点击 + 添加 ▾ → + Action ▾ → 新建 Action…,向该分支添加一个步骤。
  5. 如果需要第三个分支,请点击 + 分支。

当您不需要超时、名称或脚本时,使用 + 添加 ▾ → + Action ▾ → 并行分支(无实体)代替 + Sync。

添加判断:

  1. 选择判断之前的步骤。
  2. 点击 + 或。
  3. 输入问题,例如 Contact in view?。

    您会看到两个分支 Yes 和 No,各为 50%。

  4. 选择该 OR,并在属性面板中设置守卫名称和概率。

重复一个步骤:

  1. 选择该步骤。
  2. 点击 + 添加 ▾ → + 循环。
  3. 输入循环名称。

    您会看到该步骤被包裹在一个运行两次的循环中。

  4. 在属性面板中设置迭代次数或其他条件。

设置持续时间并检查结果:

  1. 选择一个 Action。
  2. 在属性面板的进度组中填写 Duration。
  3. 要为多个 Action 设置相同的 Duration,请 Shift+点击它们,然后在属性面板中设置 Duration (N Actions)。
  4. 点击工具栏中的图检查徽章(✓ 检查,或 ⚠ 和一个数字)。

    属性面板列出没有 Duration 的 Action 和未连接的条目。

从选项板拖动构建流程

左侧的选项板包含结构和条目类型。将它们拖到画布上,而不是使用工具栏。

  1. 将 Action 拖到流程的任意一条线上。当条目位于有效位置上方时,放置线会突出显示。

    您会在该位置看到一个“New Action”。属性面板中它的名称字段已被选中,可直接输入。

  2. 输入名称。
  3. 以同样的方式将 Parallel、或、Sync、循环或退出拖到线上。
  4. 将 Input/Output 拖到一个 Action 上。这会创建一个由该 Action 生成的 I/O。将其放到空白画布上可放置一个未连接的 I/O。
  5. 将 Resource 拖到一个 Action 上。这会创建一个由该 Action 消耗的 Resource(Amount 1)。将其放到空白画布上可放置为未连接状态。
  6. 将执行者拖到 Parallel 或 SYNC 的分支线上,然后选择 Asset。

    现在该 Asset 执行该分支上的每个 Action。

要复用模型中已有的条目:

  1. 在添加或查找…中输入名称。在项目中列出匹配的 Action、Input/Output、Resource 和 Asset。
  2. 将匹配项拖到图上:
    • 将 Action 拖到线上;
    • 将 I/O 或 Resource 拖到 Action 或画布上;
    • 将 Asset 拖到 Parallel 或 SYNC 的分支线上。

使用键盘时,让选项板条目获得焦点并按 Enter 或 Space。结构会添加到主流程末尾。Input/Output 和 Resource 会放到视图中心。

连接 Input/Output 和 Resource

通过将一个形状的手柄拖到另一个形状来连接条目。

将一个 I/O 从一个 Action 传递到另一个 Action:

  1. 选择第一个 Action。

    您会在其上方看到一个绿色手柄。

  2. 将手柄拖到第二个 Action 上。

    悬停时,目标框会显示为两半。

  3. 在 Trigger(上半部分)上释放可创建触发输入,在可选(下半部分)上释放可创建可选输入。

    Holarch 创建一个新的 Input/Output。第一个 Action 生成它,第二个 Action 接收它。新 I/O 会被选中,其名称字段可直接输入。

  4. 输入 I/O 名称。

Action 的手柄也可以拖到其他位置:

  • 拖到现有 Input/Output 上:该 Action 生成它。
  • 拖到 Resource 上:该 Action 产生它(Amount 1)。
  • 拖到空白画布上:Holarch 为该 Action 创建一个新输出。

让 Action 接收现有的 I/O:

  1. 选择该 Input/Output。
  2. 将其手柄(位于形状下方)拖到 Action 上。
  3. 在 Action 上释放,然后在连接选择器中选择 Input(触发器)或 Input(可选)。

如果该 Action 已接收该 I/O,则只会更改其 Trigger 设置。

让 Action 使用 Resource:

  1. 选择该 Resource。
  2. 将其手柄(位于形状上方)拖到 Action 上。
  3. 在消耗(上半部分)或占用(下半部分)上释放。

在消耗和占用之间切换会保留数量。

设置资源关联的数量:

  1. 选择该 Action。
  2. 在属性面板的追溯部分中,在 consumes、produces 或 seizes 下找到该 Resource,然后点击属性。
  3. 编辑关系属性 Amount。

手动放置 I/O 和 Resource:

  • 将 Input/Output 或 Resource 形状拖到所需位置。位置随图一起保存。
  • 点击其属性面板中的重置位置,使其回到使用它的 Action 上方或下方的自动布局。
  • 选择排列 ▾ → 重置 Input/Output 和 Resource 的位置可重置全部。

分配执行者

为一个 Action 分配 Asset:

  1. 选择该 Action,然后选择打开方式 ▾ → 条目视图。(在图上,performed by 在属性面板中被锁定,因为它由图管理。)
  2. 在追溯部分中,用 + → 关联现有…添加 performed by。
  3. 选取该 Asset。

为 Parallel 或 SYNC 的整个分支分配 Asset,有两种方式:

  • 将执行者从“添加”面板拖到分支线上。
  • 选择 Parallel 或 SYNC,然后点击属性面板中该分支旁边的 + Asset。

打开工具栏中的资产,可在每个 Action 名称下方显示执行者。

分解和向下钻取

为一个 Action 设置自己的子流程:

  1. 选择该 Action。
  2. 点击分解。

    该 Action 自己的 Action 图会打开。

  3. 在那里构建其子流程。
  4. 点击页眉中的▲ 父级返回。

您也可以通过双击已分解的 Action 或点击其分解图标来打开子流程。

将多个步骤分组到一个新的子 Action 中:

  1. Shift+点击同一条线上相邻的两个或更多元素。
  2. 点击分解(分组)。

    这些元素移入一个名为“New Action”的新子 Action,并拥有自己的流程。您会看到提示消息已分组到新的子 Action。请在属性面板中为其命名。,并且名称字段已被选中。

  3. 输入新名称。

将子流程展平回此图:

  1. 选择一个已分解的 Action。
  2. 点击展平(在工具栏或属性面板中)。

    其子流程在此图中替换它。

  3. 选择保留 Action可将清空的 Action 保留在模型中(在此图之外),或选择删除条目将其删除。

在仿真器中,已分解的 Action 运行其子流程。不使用它自己的 Duration。

仿真和确认

  1. 首次运行之前打开图检查徽章,并修正其列出的问题。

    您会看到仿真器将视为缺失的内容:

    • 没有 Duration 的 Action 按 0 仿真。
    • 没有 Action 生成的 I/O 会让其接收者一直等待(死锁)。
    • 列出没有被任何对象使用的 Resource。
  2. 修正检查报告的问题。
  3. 点击 ▶ 仿真 ▾,选择离散事件观察一次定时运行,或选择蒙特卡洛进行多次运行。

    仿真器会以此 Action 为根打开。

  4. 运行仿真。

永远等待的运行会报告为死锁。仿真器的状态显示原因,日志标签页会列出它:

  • 等待 I/O …(从未生成)
  • 等待 …(从不可用)

修正图并再次运行。例如,将触发输入改为可选输入。

实例:CubeSat EO-1 成像过程

演示项目包含 Action 图 OPS Run Nominal Imaging Pass。

  1. 使用管理项目 → 项目文件 ▾ → 新建演示项目创建演示项目。
  2. 从行为 → Action 图打开该图。

流程如下运行:

  1. 三个步骤按顺序运行:
    • OPS.1 Transmit Imaging Plan(Ground Station,三角分布 4–9 分钟,最可能值 6);
    • OPS.2 Receive Imaging Plan(UHF Transceiver,1 分钟);
    • OPS.3 Load Command Schedule(C&DH,2 分钟)。
  2. 一个 Parallel 同时运行 OPS.4 Rotate to Target(ADCS,正态分布 3 ± 0.5 分钟)和 OPS.5 Prepare Camera(Payload Camera,5 分钟)。两者都以 Command Schedule 作为触发器接收。
  3. 一个名为 Each target 的 LOOP 将 OPS.6 Capture Image Strip 和 OPS.7 Encode and Store Image 运行四次(Continue (×4))。
  4. 一个名为 Contact in view? 的 OR 选择下一步:
    • Yes (75%):OPS.8 Transmit Image Data;
    • No (25%):OPS.9 Hold Data Onboard。
  5. 最后一个 Parallel 在为电池充电(OPS.10)的同时,由地面接收并处理数据(OPS.11、OPS.12)。

该流程使用两个 Resource:

  • Battery Charge(Wh,初始 62,最小 23,最大 77)。OPS.4 (1.5)、OPS.5 (0.8)、OPS.6 (2)、OPS.7 (0.3) 和 OPS.8 (6) 消耗它。OPS.10 (30) 产生它。
  • Data Storage(GB)。OPS.7 (2.5) 产生它,OPS.8 (8) 消耗它。

Image Data Package 是 OPS.11 的可选输入。因此,没有通信联系的过程不会使地面段死锁。

尝试以下更改:

  1. 选择该 OR,将 Yes 改为 60,No 改为 40。

    分支标签显示 Yes (60%) 和 No (40%)。属性面板显示 Total 100%。

  2. 选择该 LOOP,并将迭代次数设为 6。

    循环文字显示 Continue (×6)。

  3. 选择 ▶ 仿真 ▾ → 蒙特卡洛并运行。

    每个过程的目标越多,消耗的电池电量越多。摘要栏和分布标签页显示更长的过程时间。

  4. 打开资产可查看每个执行者。
  5. 选择排列 ▾ → 生成 Asset 图。

    Holarch 创建 Asset“Run Nominal Imaging Pass performers”。其子项是执行 Asset,每个在其中两个之间传递的 I/O 都有对应的 Conduit。其 Asset 图会打开。

提示和良好做法

  • Action 用动词 + 宾语命名(Capture Image Strip),I/O 用名词命名(Image Strip)。OR 守卫以 OR 问题的答案命名。
  • 每个图保持在大约七到十二个元素。用分解(分组)将细节分组到子 Action 中。
  • 默认使用 Parallel(无实体)。仅在需要超时、名称或脚本时使用 SYNC。
  • 概率模式下的 OR 合计必须为 100%。概率未知时,选择无(运行时询问或随机)。仿真器随后会询问,或蒙特卡洛使用等概率。
  • 仿真之前为每个叶 Action 设置 Duration。时间有变化时使用分布,例如 =norm.dist(40,6) Seconds。
  • 当 Action 可以在没有某个接收 I/O 的情况下开始时,将该 I/O 设为可选。否则,从不产生它的分支会使运行死锁。
  • 在根的属性面板(排列 ▾ → 图设置)中使用重新编号子项…,并将子项顺序设为流程顺序,以按流程顺序为子项编号。

常见错误

现象原因修正
请将该结构拖放到流程线上。结构或 Action 在形状或空白画布上释放在元素之间的箭头上释放它
分支概率合计为 90 %。请将其调整为合计 100 %。OR 概率合计不正确更正百分比,或添加一个分支
仿真永不结束(死锁)某个 Action 等待一个在此路径上没有任何对象生成的触发 I/O将该输入设为可选,或在每条路径上都生成它
某个 Action 在仿真中不占用时间没有 Duration,或该 Action 已分解(改为运行其子流程)设置其 Duration,或为其子项添加持续时间
某个步骤似乎消失了它已从图中移除,但仍保留在模型中在添加或查找…中输入其名称,然后将其拖回到线上
生成 Asset 图报告No Action here has a performer…没有 Action 带有 performed by Asset,也没有分支带有执行者先分配执行者

与其他功能的关联方式

  • 输入来源:功能分析创建功能(子 Action)及其流程。需求通过 satisfied by 到达 Action。Asset 和 Resource 来自架构。
  • 输出到仿真器:时间、成本、资源水平、Asset 利用率和需求检查。请参阅仿真。
  • 输出到同一流程的其他视图:FFBD 和活动图。
  • 输出到派生视图:
    • 时间线图(根据开始时间和 Duration 生成进度);
    • 序列图(生命线是执行 Asset,消息是 I/O);
    • 生成 Asset 图(物理上下文和 Conduit);
    • N² 图(功能之间的 I/O);
    • IDEF0(输入和输出)。
  • 可追溯性:属性面板的追溯部分显示每个 Action 的需求(satisfies)。RVTM 和可追溯性矩阵读取相同的关系。

编辑器

Action 图使用共享的图编辑器(请参阅图)。它有一行工具栏、左侧的选项板、画布以及右侧的属性面板。

  • 图类型选择器:以适用于 Action 的另一种图类型显示同一个根 Action。这些类型包括 Hierarchy、Spider、Tree、Risk、Timeline、Action、Sequence、Use Case、N2、IDEF0、ICOM (A0)、Activity 和 FFBD。
  • ▲ 父级:打开父 Action 的 Action 图。仅当根有父 Action 时显示。

工具栏

工具栏是一行分组。插入组中的添加项(+ Action ▾、+ Sync、+ 或、+ 循环、+ 退出、+ 分支、+ I/O)位于一个 + 添加 ▾ 列表中:它们作用于所选位置(其后、其周围、其分支上),而左侧的添加面板通过拖动或 Enter 添加。在列表中,↓ 和 ↑ 在添加项之间移动,Esc 关闭列表。窗口较窄时,条目会移入 ⋯(更多操作);+ 添加 ▾ 保留在该行中,只有分解和 ▶ 仿真 ▾ 保持完整长度。选择形状会打开属性面板,而不会移动工具栏的按钮。

组控件功能
模式平移拖动背景可移动视图(默认)。
模式框选在 Action 图上只选择注释。用 Shift+点击选择流程元素。
插入+ 添加 ▾打开下方添加项的列表(“在所选位置添加”)。
插入+ Action ▾新建 Action…会询问名称(默认 New Action)。现有 Action…选取一个不是根、不是其祖先、也不在此图中的 Action。并行分支(无实体)添加并行分支。插入到所选内容之后、所选分支的末尾或流程末尾。
插入+ Sync添加带两个空分支的 SYNC。
插入+ 或询问判断名称(一个问题)(默认 Or Action),然后添加一个带 Yes 和 No 分支、各 50% 的 OR。
插入+ 循环询问循环名称(重复条件)(默认 Loop Action)。选择了元素时,会将该元素包裹在循环中(将所选元素放入 LOOP)。否则添加一个空循环(添加空 LOOP)。新循环运行 2 次迭代。
插入+ 退出在所选内容之后添加 EXIT。
插入+ 分支向所选的 Parallel、SYNC 或 OR(或其分支被选中的那个)添加一个分支。OR 的概率会重新平均分配。否则禁用。
插入+ I/O选择了一个 Action 时,选取接收的 Action(从“…”到…的 Input/Output),然后命名新 I/O。第一个 Action 生成它,第二个 Action 将其作为触发器接收。
编辑撤销、重做⌘Z / Ctrl+Z, ⇧⌘Z / Ctrl+Shift+Z.
编辑连接…用键盘将所选形状连接到另一个形状,选项与拖动其手柄相同(请参阅键盘和屏幕阅读器)。
编辑◀, ▶将所选元素在其序列中向左或向右移动一个位置。
编辑移除从图中移除所选内容;Shift+点击会删除实体(请参阅删除和移除)。
视图−、缩放 %、+、⤢缩小、输入缩放级别(10–400%)、放大、使图适合窗口。
视图带 ‹ › 的搜索图突出显示名称、编号、描述、ID 或属性值匹配的 Action、I/O 和 Resource。↓ / ↑(或 ‹ ›)在匹配项之间移动;Enter 选择当前匹配项。
视图内容图内容:以文本形式显示形状、连接和关系。
视图配置在属性面板中显示根和图类型,以便就地切换其中任一项(请参阅配置:根和类型)。
视图排列 ▾请参阅下文的排列 ▾。
视图图检查徽章孤立项和循环以及 Action 图检查(请参阅消息),列在属性面板中并带有显示。
视图I/O、Resource、资产、父 I/O显示或隐藏 Input/Output、Resource、执行 Asset 和父 Input/Output。该选择随图一起保存,并成为新 Action 图的默认设置。
类型操作分解 / 分解(分组)选择了一个 Action:打开其子 Action 图。多个元素:将它们分组到一个新的子 Action 中。
类型操作展平用其子流程替换所选的已分解 Action。
类型操作打开打开所选实体或根的条目视图。
类型操作▶ 仿真 ▾离散事件或蒙特卡洛:以此根打开仿真器。
输出导出…图 (PNG)(可选透明背景和缩放比例)、图 (SVG)、图 (HTML)、图 (Word)、图(打印)。
更多⋯溢出的条目,然后是打开条目视图、所有图、Action 图帮助和删除图…。

排列 ▾

项功能
恢复默认值清除手动设置的 I/O 和 Resource 位置。
显示 / 隐藏隐藏 Resource、隐藏所有 Input/Output、隐藏父项的 Input/Output、隐藏执行 Asset和隐藏选项板;当该部分隐藏时,每项显示为显示 …(例如显示执行 Asset)。
重置 Input/Output 和 Resource 的位置将每个已移动的 I/O 和 Resource 恢复到自动布局。
生成 Asset 图创建“root performers”,请参阅生成 Asset 图。
以 FFBD 打开将同一流程作为功能流程框图打开。
图设置属性面板中的根及重新编号子项…(旧编号 → 新编号;子项顺序为大纲或流程,来自项目偏好设置 → 编号;一次撤销即可全部撤回)。
隐藏“添加”面板 / 显示“添加”面板在每个图中隐藏左侧边栏(选项板和注释)。

生成 Asset 图

排列 ▾ → 生成 Asset 图根据流程的执行者构建其物理上下文。

  • 它创建 Asset“root performers”。该 Asset 执行根 Action。
  • 新 Asset decomposed by 每个执行 Asset。执行者来自根以下所有层级的 performed by 和分支执行者。
  • 对于每一对其 Action 交换 I/O 的 Asset,它会复用或创建一个 Conduit。Conduit 命名为“A to B”,当 I/O 双向传递时命名为“A / B”,并且它 transfers 这些 I/O。
  • 然后它打开 Asset 图。

调色板

添加面板(提示拖到线或形状上,或按 Enter)列出:

项放置位置创建
Action一条线一个新 Action“New Action”
并行一条线并行分支(无实体)
或一条线一个带 Yes/No 分支的 OR Action 实体
Sync一条线一个 SYNC Action 实体
循环一条线一个 LOOP Action 实体(主体为空,2 次迭代)
退出一条线一个 EXIT
Input/Output一个 Action,或任意位置一个名为“I/O”的新 I/O,放到 Action 上时由该 Action 生成
Resource一个 Action,或任意位置一个名为“Resource”的新 Resource,放到 Action 上时被消耗(Amount 1)
执行者Parallel 或 SYNC 分支线询问 Asset(此分支的执行者),该 Asset 随后执行该分支

在添加或查找…中输入名称:创建提供将“名称”创建为 Action、Or、Sync、Loop、Input/Output 或 Resource,在项目中列出匹配的 Action、Input/Output、Resource 和 Asset(最多 60 个;不含根和结构实体)。将一行拖入,或在其上按 Enter。

选项板下方是所有图共享的注释部分。“添加”面板标题中的 × 会隐藏它。排列 ▾ → 显示选项板可将其恢复。

画布手势

手势结果
点击形状选择它;属性面板会显示它
Shift+点击在所选内容中添加或移除一个元素
点击一条线选择它所属的分支(在主线上则清除选择)
点击背景清除选择
将 Action 或结构拖到一条线上将其(连同其中的所有内容)移到那里
拖动 I/O 或 Resource自由放置
拖动绿色手柄连接(请参阅连接 Input/Output 和 Resource)
双击 Action已分解时打开其子 Action 图,否则打开其条目视图
双击 I/O 或 Resource打开其条目视图
点击分解图标打开子 Action 图
拖动背景平移
滚动 / ⌘ / Ctrl+滚动平移 / 以指针为中心缩放

每种形状显示的内容

  • Action 框:编号(顶部)、名称,以及下方的一行。该行显示 Duration(例如 1 minute),或在资产打开时显示执行 Asset。
  • 左下角紫色的 { }:该 Action 或结构有仿真脚本。
  • 右上角的分解图标:该 Action 有自己的子流程。点击图标可打开它。
  • OR 分支标签:守卫名称及其概率(Yes (75%))或条件(Low [< 20]、[else])。
  • Parallel 和 SYNC 分支标签:分支名称及其执行者。
  • 返回箭头下方的循环文字:Continue (×4)、Continue (50%)、Continue while Battery Charge > 20、Continue (script) 或 Continue (ask)。Exit 标记出口。
  • 结构名称:以斜体显示在 OR、SYNC 和 LOOP 块旁边。

属性面板

右侧的属性面板显示所选内容。显示什么取决于您选择了什么。

Action、Input/Output、Resource 或 Asset:共享的实体面板。它包含:

  • 带有类、编号和名称的标题,以及打开方式 ▾(条目视图以及此实体的所有其他图);
  • 定义:编号、名称和描述;
  • 形状:下表中的额外操作,以及位置和大小;
  • 属性组(工作流、进度等),然后是追溯、讨论和详细信息。

此图管理的关系在“追溯”部分中被锁定,使图和模型保持一致。它们是 consumed by、decomposed by、generated by、performed by、produced by、received by 和 seized by。

所选内容额外操作
ActionAction 图、编辑脚本…、展平(已分解时)、移除和删除条目…
已移动的 Input/Output 或 Resource重置位置
分解为子 I/O 的父 I/O显示父项的 Input/Output会显示其子项来代替它;隐藏父项的 Input/Output会恢复原状
任意移除和删除条目…

选择了 OR(面板 OR (Decision)):

  • 判断名称:OR 实体的名称。
  • 判断类型:概率、资源数量、脚本或无(运行时询问或随机)。
  • Resource(仅限资源数量):比较其数量的 Resource。
  • 分支:每个分支一个守卫名称。根据类型,每个分支还有一个概率(0–100 %),或一个运算符(==、!=、>、<、>=、<=、else)和一个值。
  • 合计行:显示 Total 100%,或警告分支概率合计为 N %。请将其调整为合计 100 %。
  • 编辑脚本…/添加脚本…(脚本类型):onEnd() 返回要执行分支的守卫名称。
  • “无”类型说明:使用“Prompt”判断时,仿真器会询问走哪条路径;自动运行时,它会随机选取一个分支。
  • + 添加分支、打开条目。

选择了 SYNC:

  • 名称。
  • 时间限制:可选。超过此时间后 SYNC 结束,并停止仍在运行的分支。
  • 说明N 个分支并发运行;全部完成后流程继续。
  • 每个分支一行:分支名称和 + Asset。设置 Asset 后,该行显示 ⟂ Asset 名称和用于移除它的 ×。
  • 编辑脚本…/添加脚本…、+ 添加分支、打开条目。

选择了 Parallel:与 SYNC 相同,但没有实体字段。

选择了一个分支:已选择分支 N — + Action 会添加到其中。

选择了 LOOP:

  • 名称(条件)。
  • 当满足时重复:迭代次数、概率、资源数量、脚本或无(运行时询问或随机)。
  • 按条件:迭代次数(最少 1)、继续的概率 (%),或 Resource 加上 当数量满足时继续,并带有运算符和值。
  • 脚本说明:每次执行前都会调用 onEnd();返回 true 会再次运行循环体。
  • “无”说明:使用“Prompt”判断时,仿真器会询问迭代次数;自动运行时,它随机运行 0–2 轮。
  • 编辑脚本…/添加脚本…、说明循环体中的 EXIT 会提前停止循环。、打开条目。

选择了 EXIT:到达时停止外层 LOOP 或此流程。

选择了多个元素:已选择 N 个元素、Duration (N Actions)(实时字段:更改会在每个所选 Action 上设置 Duration,作为一个撤销步骤;当它们的持续时间不同时保持为空)、分解(分组到新的子 Action)和移除。

图如何映射到 LML

在图上在模型中
图的根父 Action
Action 框子 Action:父项 decomposed by 子项
OR、SYNC、LOOP 块带控制类型的子 Action,decomposed by 父项
顺序、分支、循环随父项保存的流程结构(子项运行的顺序)
从 Action 到 I/O 的线Action generates Input/Output
从 I/O 到 Action 的线Action receives Input/Output,带有关系属性 Trigger(Yes = 触发,No = 可选)
Action 与 Resource 之间的线consumes、produces 或 seizes,各带属性 Amount
⟂ AssetAsset performs Action(反向 performed by)。关系属性 Amount 是该 Action 占用的该 Asset 的数量。
框上的 DurationAction 的 Duration 属性(一个数字或一个分布,带单位)
子流程子 Action 自己的 Action 图

此图上各类的属性:

  • Action:Start(日期和时间)、Duration(值或分布,加上 Seconds、Minutes、Hours、Days、Weeks、Months 或 Years)和 Percent Complete。
  • Resource:Units、Initial Amount、Minimum Amount 和 Maximum Amount。
  • Input/Output:大小、单位、类型和值。

仿真脚本

脚本可添加仅靠图无法表达的行为,例如计算得出的持续时间,或基于模型值的判断。

编辑脚本:

  1. 选择一个 Action、OR、SYNC 或 LOOP。
  2. 点击编辑脚本…(Action)或编辑脚本…/添加脚本…(OR、SYNC、LOOP)。
  3. 点击添加 onStart()、添加 prompt()、添加 onEnd() 或添加 duration(),插入一个空的钩子函数。
  4. 编写代码。Tab 插入两个空格。
  5. 点击保存。空脚本会移除脚本。

钩子:

  • onStart() 在元素开始时运行。
  • prompt(p) 为用户构建一个问题:p.setTitle()、p.addEnumInput(title, name, choices, default)、addTextInput、addNumberInput、addBooleanInput。
  • onEnd(response) 在结束时运行。OR 返回要执行的分支名称。LOOP 返回 true 以再次运行主体。
  • 当 Action 的 Duration 为 =script() 时,duration() 返回其持续时间。

脚本可以调用:

  • Sim.getEntityByName(n), Sim.getAmount(name), Sim.setResourceByName(name, v);
  • Sim.getCurrentTime(), Sim.getCurrentCost();
  • print(x);
  • globals.put(k, v) / globals.get(k).

顶层变量在整个运行期间保留。Math.random 使用该运行的带种子生成器。完整的 API、沙箱和信任提示请参阅仿真。

删除和移除

Delete 或移除会立即将所选内容从图中移除并保留实体;说明已从图中移除。提供撤销和删除条目…。⇧Delete / Shift+Delete 或删除条目…会先询问,然后同时删除实体。两者中任一项都可通过一次撤销撤回(请参阅移除和删除)。

所选内容“移除”从图中移除⇧Delete / Shift+Delete 还会删除
Action、OR、SYNC 或 LOOP该元素及其内部的元素该元素的实体
Parallel 或 EXIT该结构及其内部的元素其内部的实体
一个分支该分支及其元素;移除最后一个分支或循环主体会移除整个结构该分支上的实体
多个元素所有所选元素它们的实体
Input/Output、Resource 或 Asset它与此处所显示 Action 的关联该实体
执行者(属性面板中的 ×)移除执行者:“名称”执行此分支上的 N 个 Action。是否同时移除这些 performed by 关系?保留关系、移除关系

移除还会移除该 Action 到根的 decomposed by 关联,因此它不再是子项。实体及其其他关系保留。

键盘快捷键

按键Action
Delete 或 Backspace将所选内容从图上移除(实体保留)
⇧Delete / Shift+Delete确认后,从项目中删除所选实体
Esc清除选择
Shift+点击添加到所选内容或从中移除
⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+Z撤销 / 重做
在选项板条目上按 Enter 或 Space插入它(结构插入主流程末尾,I/O 和 Resource 放在中心)
⌘ / Ctrl+滚动缩放
在缩放字段中按 Enter应用输入的缩放级别
在搜索图中按 ↓ / ↑下一个 / 上一个匹配项;Enter 选择它,Esc 清除搜索

选项和设置

  • 显示/隐藏(工具栏开关和排列 ▾):I/O、Resource、资产、父 I/O 和选项板。按图保存,并在此浏览器中记住,作为新 Action 图的默认设置。默认:I/O、Resource、父 I/O 和选项板打开;资产关闭。
  • I/O 和 Resource 位置:按图保存。用重置位置或重置 Input/Output 和 Resource 的位置重置。
  • 缩放和位置:按图保存。图打开时会适合窗口,但不小于 70%。
  • 只读显示:具有查看者角色的人看到的图没有工具栏编辑组、选项板、手柄或选择面板。他们可以平移、缩放、搜索和导出。

消息

留言含义
请将该结构拖放到流程线上。结构和 Action 只能插入到箭头上。
元素不能放在自身内部。请将其拖放到外部。您将一个结构放到了它自己的分支内,或尝试添加根或其某个祖先。
“名称”已在此图中。该 Action 已在流程中。
选择 Parallel、SYNC 或 OR 以添加分支+ 分支需要选择其中之一(或其某个分支)。
请先选择产生该 Input/Output 的 Action+ I/O 需要选择一个 Action。
选择要分解的 Action,或按住 Shift 点击多个以分组分解需要一个 Action(而不是结构)。
无法分组:这些元素位于不同的分支上。请选择同一序列中的元素。被分组的元素必须位于同一序列中。
无法分组:这些元素不相邻。请选择前后相接的元素。被分组的元素必须是连续的。
已分组到新的子 Action。请在属性面板中为其命名。分解(分组)成功。
选择一个有子图的 Action 以展平展平需要一个有子流程的 Action。
子图为空。请先添加 Action 再展平。子 Action 没有子项。
无法展平:子控制流格式错误。子流程引用了已删除的实体;请打开它进行修复。
无法展平此组:其某个子项已出现在此层级。展平会使一个 Action 出现两次。
迭代次数必须为 1 或更大。请输入至少为 1 的整数。小于 1 的迭代次数会被拒绝。
分支概率合计为 N %。请将其调整为合计 100 %。更正 OR 概率。
“名称”现在执行此分支上的 Action。已设置执行者。
此处没有 Action 有执行者。请将 Action 关联到 Asset(performed by),或将执行者拖放到分支上。生成 Asset 图没有可放置的内容。
已创建“名称 performers”,包含 N 个 Asset 和 M 个 Conduit。生成 Asset 图成功。
将元素拖到此处或点击 + Action流程为空。
此 Action 已删除。根已被删除。
图检查徽章上的 ✓ 检查检查未发现任何问题。
… 与此图上的其他任何内容都没有关系。… 请连接或移除它。图检查的发现项(孤立项和循环),并附原因:Input/Output“名称”未被此图中的任何 Action 生成或接收。、Resource“名称”未被此图中的任何 Action 消耗、产生或占用。或Action“名称”没有 Duration(按 0 仿真)。
分解形成了循环:… 请移除其中一个 decomposed by 关系。某个 Action(间接地)是它自己的子项。
仅查看:请向所有者申请编辑权限。您在此项目中的角色是查看者。

限制

  • 每个父 Action 一个流程。
  • 一个 Action 在给定流程中只能出现一次。使用 LOOP 来重复它。
  • 添加或查找…列出项目中的前 60 个匹配项。输入更多名称以缩小范围。
  • OR 概率是 0 到 100 的整数百分比。
  • 循环迭代次数是至少为 1 的整数。
  • 仿真中的持续时间永远不会为负:采样到的负值会重新抽取。
  • 框选只选择注释。对流程元素使用 Shift+点击。