Holarch

SysML v2

SysML v2 项目中的仿真元数据

HolarchSimulation 元数据库:SysML v2 模型如何为仿真器携带持续时间、分支概率、循环次数、资源、成本和状态机设置,以及如何编写和移动这些元数据。

使用方法 →

本页内容
  1. 概述
  2. 概念
    1. 标称值和分布
    2. 哪些设置优先
    3. 两种仿真器
  3. 如何使用
    1. 何时使用及原因
    2. 设置持续时间、概率或循环次数
    3. 在文本中编写注解
    4. 将较早的设置移入模型
    5. 仿真状态机
    6. 实例:Hybrid Car 演示
    7. 提示和良好做法
    8. 常见错误
    9. 关联方式
  4. 注解
    1. 分布
    2. 相关输入
    3. 概率和次数
    4. 资源和成本
    5. 需要 SysML 引擎的注解
  5. 消息
  6. 限制
  7. 相关内容

概述

在 SysML v2 项目中,仿真器的设置是模型的一部分。它们是来自库包 HolarchSimulation 的元数据注解,每个 SysML v2 项目都会加载该库包。使用这些注解的模型仍然是有效的 SysML v2:其他工具将这些注解读取为普通元数据,只有仿真器赋予它们含义。

注解要么位于其所注解的元素内部,要么用 about 指明该元素:

succession toCruise first shift if speed > 30 then cruise {
  @HolarchSimulation::Probability { percent = 70; }
}
metadata HolarchSimulation::Cost about DriveCycle::drive { amount = 0.4; unit = "USD"; label = "Energy"; }

概念

标称值和分布

步骤的持续时间是其属性 duration(或类型为 DurationValue 或 TimeValue 的属性)。其值是其他工具和 Holarch 求值所看到的标称持续时间。该属性上的分布注解会使仿真器改为抽取持续时间:

action cruise {
  attribute duration : ISQ::DurationValue = 1 [min] {
    @HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
  }
}

哪些设置优先

  • 分布注解优先于属性自身的值。
  • 模型能够求值的守卫、if 条件或循环条件会自行决定。只有在无法求值时才使用 Probability 或 LoopCount(LoopCount 始终计算通过次数)。
  • 在仿真设置移入模型之前所做的设置会作为 Holarch 数据保留在模型旁边。在您将其移入之前,它们仍然优先,因此运行结果保持不变(请参阅将较早的设置移入模型)。

两种仿真器

仿真器页面在设置右侧显示运行模型的仿真器:SysML 引擎(Holarch Language Engine 的仿真器)或 JavaScript 仿真器。两者读取相同的注解。状态机、激励、来自 Resource、Consumes、Produces 和 Seizes 的资源、来自 Cost 的成本,以及需要 SysML 引擎的注解下的其他注解,只能使用 SysML 引擎运行。

如何使用

何时使用及原因

当模型是设计的记录时,请将仿真设置写入模型:这些数值会随 .sysml 文件一起传递,出现在文本评审中,并与模型的其余部分一起进行版本管理。在分析运行场景(时间线、分支占比、资源使用)时,以及在对照蒙特卡洛研究检查需求之前,使用这些设置。

设置持续时间、概率或循环次数

  1. 在动作流视图、浏览器或编辑器中选择步骤、后继、决策、循环或 if 动作。
  2. 在属性面板的仿真部分中,设置持续时间(固定值或分布)、概率 (%)、迭代次数或then 的概率(%)。
  3. Holarch 会将注解写入模型:持续时间会将属性的值设为均值并添加分布注解(如果该步骤没有持续时间属性,则写入 attribute duration : ISQ::DurationValue);概率 (%)写入 Probability;迭代次数写入 LoopCount。每次更改都可通过一次撤销撤回,并会立即显示在文本中。
  4. 清空某个字段即可移除其注解。

Holarch 在写入每项更改之前都会用 SysML 检查器对其进行检查。会增加错误的更改不会被写入,并会有一条消息指出问题。

在文本中编写注解

  1. 打开编辑器。
  2. 将注解添加到元素的正文中,写作 @HolarchSimulation::Kind { field = value; };或添加到元素之后,写作 metadata HolarchSimulation::Kind about element { … }。
  3. 对于 Consumes、Produces 和 Seizes,先指明步骤,再指明资源:metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }。

将较早的设置移入模型

仿真设置在移入模型之前就已设定的项目,会在仿真器的设置上方显示 此项目的部分仿真设置属于 Holarch 数据,不属于模型。

  1. 点击将仿真设置移入模型…。
  2. 预览会列出每项设置以及替换它的注解。
  3. 点击移入模型。所有设置都会移入,一次撤销即可全部撤回;运行结果保持不变。

仿真状态机

状态机使用 SysML 引擎运行。

  1. 打开行为 → 仿真器,选择一个状态定义或一个展示状态的部件作为根。
  2. 可选:在一起运行下,选择一个向该部件发送信号的场景动作,例如演示中的 TestDrive。
  3. 在激励下,点击+ 添加激励,并设置于(时间和单位)、信号和到(一个状态机,或接受它的每个状态机)。
  4. 按▶ 播放、⏭ 单步或⏩ 运行到结束。运行中的状态机会点亮活动状态并标记触发的转换;状态标签页显示 States over time(状态随时间变化)和 Transitions fired(已触发的转换)。
  5. 在蒙特卡洛中,状态标签页显示状态停留时间和 Transition counts(转换次数)。对照需求检查…会将每个状态的停留时间及其在运行中的占比作为输出提供。

在状态转换视图上,▶ 仿真会打开一个工具条,含▶ 播放、⏭ 单步、⏩ 运行到结束、重置和在仿真器中打开。运行使用仿真器上为该状态定义保存的激励。

实例:Hybrid Car 演示

Hybrid Car 演示(管理项目 → 项目文件 ▾ → 新建演示项目)使用了该库:

  • DriveCycle:shift 之后的后继 toCruise 的 Probability 为 70;else 分支占其余的 30%。cruise 的标称时间为 1 min,从 Triangular 分布(45 s、1 min、2 min)中抽取。
  • DrivenCar:动力系统的电池是一个 62 Wh 的 Resource;drive Consumes 其中的 1.5 Wh,并且每次使用的 Cost 为 0.4 USD。
  • PowertrainStates:转换 startElectric 的守卫的 Probability 为 80;accept when charge < 15 在电量下降时切换到混合动力;accept after 30 [min] 结束充电。
  • TestDrive:一个场景,向 demoCar 发送 StartRequest,等待一小时,然后发送 StopRequest 和 PlugIn。将 Demo Car 与 Test Drive 一起运行,即可看到动力系统切换状态。

该演示的检查结果为 0 条诊断信息。

提示和良好做法

  • 让标称值保持有意义:像属性面板那样,将其设为分布的期望值。
  • 为您要注解的后继命名(succession toCruise first …),这样在文本中很容易找到注解。
  • 优先使用模型能够求值的条件,而不是概率;对模型未描述的内容使用 Probability。

常见错误

  • 概率不起作用:守卫可以求值,因此由守卫决定。属性面板会显示“求值为 true:始终会被选择。”或“求值为 false:永远不会被选择。”
  • 分支概率总和不为 100%:没有 Probability 的分支平分剩余部分;当给定的概率超过 100% 时,警告显示“分支概率合计为 N %。请将其调整为合计 100 %。”
  • 持续时间注解放在步骤本身上:分布应放在持续时间属性上,而不是动作上。

关联方式

注解

分布

将分布放在持续时间属性上。位置和尺度字段接受带单位的量(45 [s]、2 [min]);形状字段接受数字。

注解字段含义
正态分布mean, sd正态分布。
三角分布low, mode, high三角分布,low ≤ mode ≤ high。
均匀分布low, highlow 与 high 之间的均匀分布。
Exponentialmean具有给定均值的指数分布。
Gammashape, scale伽马分布;均值为 shape × scale。
LogNormalmedian, sigma其对数围绕中位数的对数呈正态分布。
Weibullscale, shape威布尔分布。
Betaalpha, beta, scale0..1 上的贝塔分布,乘以 scale。
Poissonmean, scale具有给定均值的计数,乘以 scale。
Binomialtrials, p, scale若干次试验中的成功次数,乘以 scale。

抽取到小于零的持续时间会重新抽取。

相关输入

没有相关性时,从分布中抽取的每个值都与其他值相互独立。Correlation 使其中两个值一起变动:

metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
注解作用对象含义
Correlation coefficientabout a, b:两个属性,各自带有一个分布其值的秩(Spearman)相关系数,范围为 -1 到 1。0 表示独立,1 表示两者排序始终相同,-1 表示相反。
  • 每个属性保留自己的分布。仿真器将所有成对关系合并为一个相关矩阵(高斯 copula):一次运行中为某个属性抽取的第 n 个值,与其相关的每个属性的第 n 个值相对应。
  • 一组相关属性的系数必须相互协调:a 与 b 强相关、b 与 c 强相关,而 a 与 c 却相反,这是不可能的。检查会报告此类组;请减弱其中一个系数。
  • 持续时间和数量(Consumes、Produces、Seizes)以相同方式相关。使用相同种子的运行会给出相同的值。
  • 在仿真器上,使用 SysML 引擎的蒙特卡洛模式下,相关输入会列出根的成对关系。选择两个属性和一个系数并点击+ 添加相关性,更改某个系数,或点击 × 移除一个;每次更改都可通过一次撤销撤回。研究完成后,已达成会显示各次运行所抽取值的秩相关系数。
  • Hybrid Car 演示中的 ChargeStop 将等待空闲充电器的时间与充电时间相关联(0.6)。

概率和次数

注解作用对象含义
Probability percent决策引出的后继该分支的权重。没有权重的分支平分 100 的剩余部分。
一个 if 动作当条件无法求值时,then 分支的概率。
一个循环动作每次通过后重复的概率。
一个转换当守卫无法求值时,其守卫成立的概率。
LoopCount count一个循环动作通过次数;它优先于循环的条件。
LoopExit循环体中指向 done 的后继结束整个循环,而不仅仅是本次通过。

资源和成本

注解作用对象含义
Resource initial、minimum、maximum、unit一个部件或项用法一定数量的资源池。如果该用法声明了 attribute level : Real,仿真器会使其始终等于该数量,以便守卫读取。
Consumes amountabout step, pool在步骤开始时取用。
Produces amountabout step, pool在步骤结束时添加。
Seizes amountabout step, pool在步骤开始时取用,并在步骤结束时归还。
Utilization amount一个 perform 动作用法该步骤占用执行部件的程度。
Cost amount、rate、unit、label一个步骤或一个执行部件每次使用(CostRate::perUse)或每小时(CostRate::perHour)的成本。

需要 SysML 引擎的注解

注解含义
Transfer latency、capacity、per作用于连接或接口:延迟经由其发送的项和信号。
Size size作用于项:其用于计算传输延迟的大小。
Timeout limit作用于汇合:限时到期时停止未完成的分支。
NotBefore time作用于步骤:在此运行时间之前不会开始。
ForkTargets、JoinSources作用于进入或离开并行状态的转换:所进入的子状态,或必须处于活动状态的子状态。
History deep作用于复合状态:重新进入时恢复离开时处于活动状态的子状态。
HostHook key、pointsHolarch 保留:运行会在列出的点暂停以等待输入。

JavaScript 仿真器读取 Probability、LoopCount 和各种分布。

消息

留言含义
此项目的部分仿真设置属于 Holarch 数据,不属于模型。较早的设置仍存储在模型旁边。请点击将仿真设置移入模型…。
仿真设置移入模型之前的 Holarch 数据;它优先于模型。显示在属性面板的仿真部分中。更改该字段即可将其写入模型,或在仿真器上移入所有设置。
模型中没有持续时间。请在此处设置(将写入 attribute duration : ISQ::DurationValue),或在文本中编写。该步骤没有持续时间属性。
@Normal: sd must be greater than zero. Change sd.(@Normal:sd 必须大于零。请更改 sd。)(其他分布和参数的消息与此类似)某个分布参数缺失或超出范围。使用 SysML 引擎时,模型检查会在编辑器中报告该问题,并且在修复之前仿真器会拒绝运行。
@Normal: sd has another unit dimension than …某个位置或尺度参数的单位与属性不同,例如持续时间上使用了米。
@LoopCount does not apply to a part …该注解位于其不适用的元素种类上。请移动或删除它。
metadata Consumes … about needs an action and a part or item annotated @Resource.about 之后的元素在数量或种类上有误。
N% 的概率超出 0 到 100 的范围。输入 0 到 100 之间的百分比。
此决策的分支概率合计为 N %;仿真器会将其按比例缩放到 100 %。警告:每个分支都有权重,但总和不为 100。
A correlation needs two different attributes …、… is not an attribute … 或 … has no distribution, so nothing is drawn to correlate …某个 Correlation 两次指明同一个属性、指明了不是属性的内容,或指明了没有分布的属性。
The coefficient N is outside -1 to 1. 或 The correlation has no coefficient.输入 -1 到 1 之间的系数。
“a” and “b” are already correlated; the first correlation is used. …警告:同一对属性的第二个 Correlation 会被忽略。请移除两者之一。
The correlations of … contradict each other: no joint distribution has them …一组系数无法同时成立(矩阵不是半正定的)。请减弱其中一个。在修复之前,仿真器会拒绝运行。
<time> 时死锁:N 个步骤在等待永远不会到来的东西。使用 SysML 引擎时显示在结果上方,并列出每个等待中的步骤。没有发送方的 accept、从未产生的项或从未释放的资源都会使运行停止。

限制

  • 持续时间以秒、分钟、小时或天为单位书写(SI::s、SI::min、SI::h、SI::d)。毫秒写为秒;周、月和年写为天。
  • 状态机、激励和一起运行需要 SysML 引擎。
  • 相关输入需要 SysML 引擎;JavaScript 仿真器独立抽取每个值。一个组中最多可以有 200 个相关属性。
  • 矛盾系数检查涵盖在同一个命名空间中编写的相关性;仿真器会检查运行中的所有相关性。

SysML® 和 OMG® 是 Object Management Group, Inc. 在美国和其他国家/地区的注册商标。