SysML v2
SysML v2 项目中的仿真元数据
HolarchSimulation 元数据库:SysML v2 模型如何为仿真器携带持续时间、分支概率、循环次数、资源、成本和状态机设置,以及如何编写和移动这些元数据。
本页内容
概述
在 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 文件一起传递,出现在文本评审中,并与模型的其余部分一起进行版本管理。在分析运行场景(时间线、分支占比、资源使用)时,以及在对照蒙特卡洛研究检查需求之前,使用这些设置。
设置持续时间、概率或循环次数
- 在动作流视图、浏览器或编辑器中选择步骤、后继、决策、循环或
if动作。 - 在属性面板的仿真部分中,设置持续时间(固定值或分布)、概率 (%)、迭代次数或then 的概率(%)。
- Holarch 会将注解写入模型:持续时间会将属性的值设为均值并添加分布注解(如果该步骤没有持续时间属性,则写入
attribute duration : ISQ::DurationValue);概率 (%)写入 Probability;迭代次数写入 LoopCount。每次更改都可通过一次撤销撤回,并会立即显示在文本中。 - 清空某个字段即可移除其注解。
Holarch 在写入每项更改之前都会用 SysML 检查器对其进行检查。会增加错误的更改不会被写入,并会有一条消息指出问题。
在文本中编写注解
- 打开编辑器。
- 将注解添加到元素的正文中,写作
@HolarchSimulation::Kind { field = value; };或添加到元素之后,写作metadata HolarchSimulation::Kind about element { … }。 - 对于 Consumes、Produces 和 Seizes,先指明步骤,再指明资源:
metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }。
将较早的设置移入模型
仿真设置在移入模型之前就已设定的项目,会在仿真器的设置上方显示 此项目的部分仿真设置属于 Holarch 数据,不属于模型。
- 点击将仿真设置移入模型…。
- 预览会列出每项设置以及替换它的注解。
- 点击移入模型。所有设置都会移入,一次撤销即可全部撤回;运行结果保持不变。
仿真状态机
状态机使用 SysML 引擎运行。
- 打开行为 → 仿真器,选择一个状态定义或一个展示状态的部件作为根。
- 可选:在一起运行下,选择一个向该部件发送信号的场景动作,例如演示中的 TestDrive。
- 在激励下,点击+ 添加激励,并设置于(时间和单位)、信号和到(一个状态机,或接受它的每个状态机)。
- 按▶ 播放、⏭ 单步或⏩ 运行到结束。运行中的状态机会点亮活动状态并标记触发的转换;状态标签页显示 States over time(状态随时间变化)和 Transitions fired(已触发的转换)。
- 在蒙特卡洛中,状态标签页显示状态停留时间和 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;
driveConsumes 其中的 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 %。”
- 持续时间注解放在步骤本身上:分布应放在持续时间属性上,而不是动作上。
关联方式
- SysML v2 项目中的求值、单位和分析:仿真器如何读取步骤、后继和持续时间。
- 仿真:仿真器页面、其面板和蒙特卡洛统计信息。
- SysML v2 文本表示法:文本中的元数据和
about。
注解
分布
将分布放在持续时间属性上。位置和尺度字段接受带单位的量(45 [s]、2 [min]);形状字段接受数字。
| 注解 | 字段 | 含义 |
|---|---|---|
| 正态分布 | mean, sd | 正态分布。 |
| 三角分布 | low, mode, high | 三角分布,low ≤ mode ≤ high。 |
| 均匀分布 | low, high | low 与 high 之间的均匀分布。 |
| Exponential | mean | 具有给定均值的指数分布。 |
| Gamma | shape, scale | 伽马分布;均值为 shape × scale。 |
| LogNormal | median, sigma | 其对数围绕中位数的对数呈正态分布。 |
| Weibull | scale, shape | 威布尔分布。 |
| Beta | alpha, beta, scale | 0..1 上的贝塔分布,乘以 scale。 |
| Poisson | mean, scale | 具有给定均值的计数,乘以 scale。 |
| Binomial | trials, p, scale | 若干次试验中的成功次数,乘以 scale。 |
抽取到小于零的持续时间会重新抽取。
相关输入
没有相关性时,从分布中抽取的每个值都与其他值相互独立。Correlation 使其中两个值一起变动:
metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
| 注解 | 作用对象 | 含义 |
|---|---|---|
Correlation coefficient | about 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 amount | about step, pool | 在步骤开始时取用。 |
Produces amount | about step, pool | 在步骤结束时添加。 |
Seizes amount | about 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、points | Holarch 保留:运行会在列出的点暂停以等待输入。 |
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. 在美国和其他国家/地区的注册商标。