Holarch

培训 · 课程 9. SysML v2 基础

课程 9. SysML v2 基础:练习单

面向初次接触 SysML v2 的学生和工程师。每章一项练习任务和几个问题,供您在观看每个视频后完成。可从浏览器打印此页面,也可在屏幕上作答。答案从末尾的新页开始。

开始之前

先修课程
应用内教程 SysML v2:入门(帮助 → 教程)。
方案
Free
项目
应用内 SysML v2 教程的起始项目;在 Hybrid Car 演示项目上练习。

9.1 定义和属性

观看第 9.1 章 (4:33)

练习

基于 Hybrid Car 演示项目 (SysML v2):

  1. 创建 Hybrid Car 演示项目:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)。打开 模型 → 编辑器 和包 Vehicles。
  2. 在 enum def FuelKind 下方添加 enum def CoolingMode { enum passive; enum active; }。
  3. 在 part def Body 下方选择 插入 ▾ → 部件定义,并将 part def Radiator :> Component 补充完整,包含 attribute redefines mass = 8 [kg];、attribute coolantVolume : VolumeValue;(输入 Volu 并按 Enter 从补全列表中接受 VolumeValue)和 attribute mode : CoolingMode;。
  4. 将质量改为 8 [W],将指针指向下划线阅读消息,然后将其改回 8 [kg]。
  5. 在 part def Powertrain 中添加 part radiator : Radiator;。然后将光标放在 coolantVolume 上,按 F2 并将其重命名为 coolantCapacity。
  6. 如需带检查的分步演练,请运行 SysML v2 教程“定义和属性”(帮助 → 教程)。

当编辑器下方的状态报告没有问题,且浏览器在 Vehicles 下显示带有 coolantCapacity 和 mode 的 Radiator 时,即完成练习。

常见问题

  1. 在 part def Battery :> Component { attribute redefines mass = 45 [kg]; } 中,:> 和 redefines 各起什么作用?
  2. 为什么 Component 被声明为 abstract part def?
  3. 为什么 attribute redefines power = 60 [kg]; 会报错?
  4. doc /* … */ 与 // 行有什么区别?

9.2 端口和接口

观看第 9.2 章 (3:44)

练习

基于 Hybrid Car 演示项目 (SysML v2):

  1. 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包 Vehicles。
  2. 在 interface def HighVoltageBus 下方添加 interface def ControlLink { end commander : ~ControlPort; end unit : ControlPort; }。
  3. 在 part def Powertrain 中,将 connect controller.engineCtl to engine.ecu; 替换为 interface engineControl : ControlLink connect controller.engineCtl to engine.ecu;,并在 part battery : Battery; 之后添加 part auxBattery : Battery;。
  4. 打开 架构 → Interconnection Views 和视图 powertrainConnections。从 auxBattery 的端口 powerOut 的手柄拖到电机的端口 powerIn,然后选择 Interface : HighVoltageBus。
  5. 选择新连线,在属性面板中将其 名称 设为 auxBus。然后打开 模型 → 编辑器,找到 Holarch 在 Powertrain 中写入的那一行。

当 Powertrain 包含 interface engineControl : ControlLink … 以及来自视图的 auxBus 接口,且编辑器下方的状态报告没有问题时,即完成练习。

常见问题

  1. 发动机有 port fuelIn : ~FuelPort;。波浪号改变了什么?
  2. bind output = transmission.output; 与 interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn; 有什么区别?
  3. 为什么从电池的 powerOut 拖到电机的 powerIn 时,视图会提供 Interface : HighVoltageBus?

9.3 动作和流

观看第 9.3 章 (4:31)

练习

基于 Hybrid Car 演示项目 (SysML v2):

  1. 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包 VehicleBehavior。
  2. 在 action def <'F.3'> DriveWheels 下方添加 action def <'F.4'> Refuel { in attribute fuelDemand : Real; out item fuel : Fuel; }。
  3. 打开 行为 → FFBD,单击 + 新建图,选择 Refuel,然后单击 创建。在 添加 面板中输入 Open Filler Door 并按 Enter,然后依次输入 Pump Fuel 和 Close Filler Door。
  4. 打开 模型 → 编辑器,找到 Refuel:FFBD 已写入其三个步骤以及它们之间的 succession。
  5. 打开 行为 → 动作流 和视图 driveCycleFlow。找到包含 brake 的泳道,然后在 DrivenCar 中找到将其放在那里的 perform 行。
  6. 打开 行为 → 功能分析,单击 选择… 并选择 DriveCycle。确认其功能按短名称编号。

当 Refuel 在编辑器中显示其参数、三个步骤及其 succession,且您能说出哪个部件的泳道包含 brake 时,即完成练习。

常见问题

  1. 在 first start then split; fork split; then supply; then produce; 中,哪些步骤并行运行?什么使它们重新汇合?
  2. first supply then ready; 与 flow of Fuel from supply.fuel to produce.fuel; 有什么区别?
  3. Action Flow 视图的泳道从何而来?

9.4 状态和转换

观看第 9.4 章 (3:51)

练习

基于 Hybrid Car 演示项目 (SysML v2):

  1. 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包 VehicleBehavior。
  2. 在 attribute def Unplug; 之后添加 attribute def FaultDetected;。
  3. 在 state def PowertrainStates 的右花括号之前,添加 state limpHome { entry action warnDriver; do action driveLimited; } 和 transition limpStop first limpHome accept StopRequest then off;。
  4. 打开 行为 → 状态机,单击 + 新建图,在 显示 下选择 PowertrainStates,然后单击 创建。
  5. 选择 electric,从其手柄拖到 limpHome;在 转换 上松开。在转换面板中输入 名称 electricFault 和 触发器 FaultDetected,然后单击 在文本中显示。

当 PowertrainStates 包含 limpHome、limpStop 以及接受 FaultDetected 的转换 electricFault,且编辑器下方的状态报告没有问题时,即完成练习。

常见问题

  1. 是什么使 off 成为 PowertrainStates 的初始状态?
  2. 在 state off; 之后是 accept StartRequest if charge > 20 then electric;。说出其触发器、守卫、源和目标。
  3. 状态的 entry、do 和 exit 动作分别在何时运行?
  4. DrivenCar 中的 exhibit state powertrainStates : PowertrainStates; 表达了什么?

9.5 需求

观看第 9.5 章 (4:15)

练习

基于 Hybrid Car 演示项目 (SysML v2):

  1. 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包 VehicleRequirements。
  2. 在 attribute minElectricRange 之后添加 attribute minTopSpeed : SpeedValue = 180 [km/h];。
  3. 在 requirement def <'VR-5'> ChargeTime 下方选择 插入 ▾ → 需求定义,编写 <'VR-8'> TopSpeed,其陈述为 The sports car shall reach at least the minimum top speed.,主题为 car : SportCar,并包含 require constraint { car.topSpeed >= minTopSpeed }。
  4. 在其他 satisfy 行之后添加 satisfy requirement roadsterSpeed : TopSpeed by fleet.roadster;。
  5. 将 minTopSpeed 改为 220 [km/h]。将指针指向编辑器在 satisfy 上放置的标记,查看它比较的数值,然后按 ⌘Z / Ctrl+Z。
  6. 打开 需要与需求 → 需求 并找到 VR-8,然后打开 需要与需求 → 质量 并单击 检查质量。

当 VR-8 出现在需求表中、satisfy 在 180 km/h 时没有标记,且“检查质量”已为其陈述评分时,即完成练习。

常见问题

  1. 为什么要将 maxCurbMass 等限值保留为命名属性,而不是在每个约束中写入数字?
  2. 在 requirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; } 中,:>> 起什么作用?
  3. satisfy carSpec by fleet.sedan; 让 Holarch 能够检查什么?
  4. 您在需求页面上设置了需求的 Status 和 Priority。SysML 文本会改变吗?

9.6 验证和可追溯性

观看第 9.6 章 (3:32)

练习

基于 Hybrid Car 演示项目 (SysML v2):

  1. 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包 VehicleRequirements。
  2. 在 verification <'VC-1.1'> sedanWeighing 之后添加 verification def <'VC-2'> BatteryWeighing { subject battery : Battery; objective { verify batteryMassLimit; } return verdict : Boolean = battery.mass <= 50 [kg]; } 和 verification <'VC-2.1'> sedanBatteryWeighing : BatteryWeighing { subject battery = fleet.sedan.powertrain.battery; }。
  3. 打开 验证 → 验证用例。在新用例所在行中单击 + 步骤,然后单击 + 添加步骤,在 操作 下输入 Weigh the battery on a bench scale,单击 应用,再单击其状态按钮中的 通过。
  4. 打开 验证 → RVTM,找到 VR-6 batteryMassLimit 及新用例和其状态。
  5. 打开 验证 → 可追溯性矩阵,以需求为行、以类 Action 为列,单击 sedanAcceleration 与 accelerate 交叉的单元格,然后选择 satisfied by。
  6. 在包的末尾添加 requirement <'VR-9'> tankVolume { doc /* The fuel tank shall hold at least 40 L. */ subject tank : FuelTank; } 和 connection tankDerivation : Derivation connect carSpec.sedanRange to tankVolume;。然后打开 验证 → 模型检查。

当 RVTM 将新用例列为针对 VR-6 已通过、编辑器包含新的 satisfy 和 tankDerivation,且状态报告没有问题时,即完成练习。

常见问题

  1. 在 objective massObjective { verify carSpec.sedanMass; } 中,verify 表达了什么?您在哪里能看到它?
  2. 验证用例的 verdict 与“验证用例”页面上的状态有什么区别?
  3. 什么时候使用 satisfy,什么时候使用 Derivation?
  4. 在可追溯性矩阵单元格中选择 satisfied by 时会发生什么?

9.7 约束和计算

观看第 9.7 章 (4:26)

练习

基于 Hybrid Car 演示项目 (SysML v2):

  1. 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包 VehicleRequirements。
  2. 在 constraint def SpeedLimit 之后添加 constraint sedanBatteryCheck : MassLimit { in mass = fleet.sedan.powertrain.battery.mass; in limit = 50 [kg]; }。
  3. 在 图 页面上单击 + 新建图,选择 参数视图,并在 显示 下选择 VehicleRequirements,然后单击 创建。新的检查通过:48 kg 在 50 kg 以内。
  4. 在包 Vehicles 中将轿车电池的质量改为 52 [kg];视图显示检查失败。按 ⌘Z / Ctrl+Z,然后单击 全部求解 再次检查所有约束。
  5. 在 requirement def <'VR-2'> Acceleration 中,将 attribute zeroToHundred : TimeValue; 替换为 attribute zeroToHundred : TimeValue { @TBD { owner = "Test lead"; rationale = "The test track is not booked yet."; } }。打开 需要与需求 → TBD/TBR,找到该需求及其负责人。
  6. 打开 架构 → 预算和 TPM,单击 选择根部件… 并选择 sedan。在 量 下选择 Mass,找到电池的 48 kg。

当 sedanBatteryCheck 在参数视图中显示“通过”,且 TBD/TBR 登记册列出负责人为 Test lead 的 Acceleration 需求时,即完成练习。

常见问题

  1. constraint def 与 calc def 有什么区别?
  2. 参数视图中的某个约束显示“需要输入”。缺少什么?
  3. 为什么要用 #TBD 或 @TBD { … } 标记未定数值,而不是将 TBD 写成数值?
  4. 分析用例为计算增加了什么?

9.8 变体和配置

观看第 9.8 章 (3:42)

练习

基于 Hybrid Car 演示项目 (SysML v2):

  1. 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包 Vehicles。它已经导入了 HolarchVariability。
  2. 在 part def CarLine 中,在 charger 变体点之后添加 variation part rims : Wheel { variant part steelRims : Wheel; variant part alloyRims : Wheel { attribute :>> mass = 18 [kg]; } }。编辑器会提示三个配置尚未选择 rims。
  3. 在 wallboxNeedsLargePack 之后添加规则 assert constraint alloyNeedsLargePack { rims == rims::alloyRims implies pack == BatteryPack::largePack }。
  4. 打开 模型 → 浏览器 并选择 selfChargingHybrid。在属性面板的 配置 部分,为 rims 选择 steelRims;为 plugInHybrid 和 longRangeHybrid 选择 alloyRims。然后在 selfChargingHybrid 上尝试 alloyRims,阅读判定结果,再按 ⌘Z / Ctrl+Z。
  5. 打开 CarLine 的行菜单(⋯),选择 新建配置…。将其命名为 cityHybrid,选择 standardPack、noCharger 和 steelRims,确认判定结果为“有效”,然后单击 创建。
  6. 单击顶栏中的 查看方式 ▾ 并选择 cityHybrid,然后从 图 列表中打开视图 carLineVariants:未被选择的变体会被隐藏。

当属性面板中 CarLine 的“产品线”部分列出四个均为“有效”的配置以及规则 alloyNeedsLargePack 时,即完成练习。

常见问题

  1. variation part def BatteryPack { … } 与 variation part charger : Component { … } 有什么区别?
  2. plugInHybrid 选择了 BatteryPack::standardPack 和 charger::wallbox。会发生什么?为什么?
  3. 某个配置尚未为每个变体点都选择变体。它的判定结果是什么?
  4. metadata def <safetyCritical> SafetyCritical 让您能够写什么?其他 SysML v2 工具如何看待它?

答案

9.1 定义和属性

  1. :> 使 Battery 成为 Component 的特化,因此它继承 mass、partNumber 和 power。redefines 用 Battery 自己的特征替换继承的 mass,这里绑定为 45 kg。
  2. 不存在泛指的组件,只有各种具体的组件。抽象定义汇集了所有组件的共同之处,只有其特化(例如 Battery 或 Engine)才描述实际的部件。
  3. power 的类型为 PowerValue,而千克是质量单位。检查器会对单位进行求值,因此会在该数值下标出下划线,直到单位改为功率单位(例如 [W])为止。
  4. doc 注释是属于该元素的文档,是模型的一部分。// 注释只保留在文本中,不属于模型。

9.2 端口和接口

  1. 它对端口进行共轭:发动机的端口具有与 FuelPort 相同的特征,但方向相反,因此 FuelPort 的 out attribute flowRate 到达发动机时成为输入。
  2. 绑定表示两个特征是同一个:动力总成的边界端口就是变速器的输出。接口用法连接两个不同的端口,其接口定义说明其两端接受哪些端口。
  3. Holarch 提供两端都适合这两个端口的接口定义。HighVoltageBus 的两端为 source : PowerPort 和 load : ~PowerPort,与这两个端口匹配。

9.3 动作和流

  1. 在 fork split 之后,supply 和 produce 作为并行分支开始;fork 之后的每个 then 都开始一个分支。join ready 等待两者都完成后再进入下一步。
  2. 前者是 succession:它在时间上排列步骤的顺序。后者是流:它将一个 Fuel 项从一个步骤的输出参数传递到另一个步骤的输入,其本身并不排列步骤的顺序。
  3. 来自 perform:每个执行某一步骤的部件(例如 part redefines tank { perform trip.supply; })都会得到一条包含其所执行步骤的泳道。

9.4 状态和转换

  1. entry; then off;:entry 之后接一个到 off 的 succession,因此状态机从那里开始。视图将其绘制为圆点。
  2. 触发器:信号 StartRequest。守卫:charge > 20。目标:electric。这种简写形式以它所跟随的状态 off 为源。
  3. entry 动作在进入状态时运行,do 动作在状态处于活动期间运行,exit 动作在离开状态时运行。
  4. 表示汽车展现此状态机:汽车拥有一个 PowertrainStates 的用法,因此其状态就是汽车的状态。

9.5 需求

  1. 使用该名称的每条需求都随一次编辑而更新,并且限值带有单位,因此检查器会比较带单位的数值。
  2. 它重定义 sedanMass 从 CurbMass 继承的 limit 属性,为此用法赋予自己的值。
  3. 轿车的数值是否满足 carSpec 的约束。如果轿车的整备质量超过限值,编辑器会标记该 satisfy 并显示所比较的数值。
  4. 不会。状态、优先级和验证方法是保存在模型旁边的 Holarch 数据;它们从不更改文本。

9.6 验证和可追溯性

  1. 表示此验证用例验证需求 sedanMass。RVTM 会将该用例列在该需求下。
  2. verdict 是模型的一部分:一个表达式,这里是整备质量是否在限值以内。步骤、结果和测试运行的状态是保存在模型旁边的 Holarch 数据。
  3. satisfy 表示某个设计元素(例如部件或动作)满足一条需求。Derivation 将原始需求连接到由其派生的需求;它需要 private import RequirementDerivation::*;。
  4. Holarch 会在 SysML 文本中写入一条 satisfy,因此该追溯是模型的一部分,并显示在编辑器中。

9.7 约束和计算

  1. 约束定义陈述一个关于其参数、成立或不成立的条件,例如 mass <= limit。计算定义计算并返回一个值,例如 return ratio = power / mass;。
  2. 某个参数尚无值。将每个参数绑定到一个值,例如 in mass = fleet.sedan.curbMass;。
  3. 在数值位置写 TBD 不是有效的 SysML。Holarch 的 HolarchMetadata 包中的元数据可保持文本有效;TBD 和 TBR 特化了标准的 StatusInfo 元数据,因此其他 SysML v2 工具会将它们读取为状态注解。
  4. 它将计算应用于一个主题(例如轿车),返回结果,并带有一个目标,Holarch 会像评估其他约束一样评估其中的 require 约束。

9.8 变体和配置

  1. 前者是变体定义,即一组可重用的选择:以它为类型的用法(例如 part pack : BatteryPack;)就是一个变体点。后者是变体用法,即在某一个设计内部声明的变体点。
  2. 违反了规则 wallboxNeedsLargePack:它规定 wallbox 意味着大电池组。判定结果会指出该规则,编辑器会报告断言失败。
  3. 不完整,并指出未选择的变体点。当某个变体点没有选择时,涉及它的规则既不算满足也不算违反。
  4. 短名称会成为一个关键字,例如 #safetyCritical part controller : Controller;。它是一个普通的元数据用法,因此其他 SysML v2 工具会将其视为该部件上的元数据。

由 Holarch发布