课程 9. SysML v2 基础:练习单
面向初次接触 SysML v2 的学生和工程师。每章一项练习任务和几个问题,供您在观看每个视频后完成。可从浏览器打印此页面,也可在屏幕上作答。答案从末尾的新页开始。
开始之前
- 先修课程
- 应用内教程 SysML v2:入门(帮助 → 教程)。
- 方案
- Free
- 项目
- 应用内 SysML v2 教程的起始项目;在 Hybrid Car 演示项目上练习。
9.1 定义和属性
观看第 9.1 章 (4:33)
练习
基于 Hybrid Car 演示项目 (SysML v2):
- 创建 Hybrid Car 演示项目:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)。打开 模型 → 编辑器 和包
Vehicles。 - 在
enum def FuelKind下方添加enum def CoolingMode { enum passive; enum active; }。 - 在
part def Body下方选择 插入 ▾ → 部件定义,并将part def Radiator :> Component补充完整,包含attribute redefines mass = 8 [kg];、attribute coolantVolume : VolumeValue;(输入Volu并按 Enter 从补全列表中接受VolumeValue)和attribute mode : CoolingMode;。 - 将质量改为
8 [W],将指针指向下划线阅读消息,然后将其改回8 [kg]。 - 在
part def Powertrain中添加part radiator : Radiator;。然后将光标放在coolantVolume上,按 F2 并将其重命名为coolantCapacity。 - 如需带检查的分步演练,请运行 SysML v2 教程“定义和属性”(帮助 → 教程)。
当编辑器下方的状态报告没有问题,且浏览器在 Vehicles 下显示带有 coolantCapacity 和 mode 的 Radiator 时,即完成练习。
常见问题
- 在
part def Battery :> Component { attribute redefines mass = 45 [kg]; }中,:>和redefines各起什么作用? - 为什么 Component 被声明为
abstract part def? - 为什么
attribute redefines power = 60 [kg];会报错? doc /* … */与//行有什么区别?
9.2 端口和接口
观看第 9.2 章 (3:44)
练习
基于 Hybrid Car 演示项目 (SysML v2):
- 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包
Vehicles。 - 在
interface def HighVoltageBus下方添加interface def ControlLink { end commander : ~ControlPort; end unit : ControlPort; }。 - 在
part def Powertrain中,将connect controller.engineCtl to engine.ecu;替换为interface engineControl : ControlLink connect controller.engineCtl to engine.ecu;,并在part battery : Battery;之后添加part auxBattery : Battery;。 - 打开 架构 → Interconnection Views 和视图
powertrainConnections。从auxBattery的端口powerOut的手柄拖到电机的端口powerIn,然后选择 Interface : HighVoltageBus。 - 选择新连线,在属性面板中将其 名称 设为
auxBus。然后打开 模型 → 编辑器,找到 Holarch 在Powertrain中写入的那一行。
当 Powertrain 包含 interface engineControl : ControlLink … 以及来自视图的 auxBus 接口,且编辑器下方的状态报告没有问题时,即完成练习。
常见问题
- 发动机有
port fuelIn : ~FuelPort;。波浪号改变了什么? bind output = transmission.output;与interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;有什么区别?- 为什么从电池的
powerOut拖到电机的powerIn时,视图会提供 Interface : HighVoltageBus?
9.3 动作和流
观看第 9.3 章 (4:31)
练习
基于 Hybrid Car 演示项目 (SysML v2):
- 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包
VehicleBehavior。 - 在
action def <'F.3'> DriveWheels下方添加action def <'F.4'> Refuel { in attribute fuelDemand : Real; out item fuel : Fuel; }。 - 打开 行为 → FFBD,单击 + 新建图,选择
Refuel,然后单击 创建。在 添加 面板中输入Open Filler Door并按 Enter,然后依次输入Pump Fuel和Close Filler Door。 - 打开 模型 → 编辑器,找到
Refuel:FFBD 已写入其三个步骤以及它们之间的 succession。 - 打开 行为 → 动作流 和视图
driveCycleFlow。找到包含brake的泳道,然后在DrivenCar中找到将其放在那里的perform行。 - 打开 行为 → 功能分析,单击 选择… 并选择
DriveCycle。确认其功能按短名称编号。
当 Refuel 在编辑器中显示其参数、三个步骤及其 succession,且您能说出哪个部件的泳道包含 brake 时,即完成练习。
常见问题
- 在
first start then split; fork split; then supply; then produce;中,哪些步骤并行运行?什么使它们重新汇合? first supply then ready;与flow of Fuel from supply.fuel to produce.fuel;有什么区别?- Action Flow 视图的泳道从何而来?
9.4 状态和转换
观看第 9.4 章 (3:51)
练习
基于 Hybrid Car 演示项目 (SysML v2):
- 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包
VehicleBehavior。 - 在
attribute def Unplug;之后添加attribute def FaultDetected;。 - 在
state def PowertrainStates的右花括号之前,添加state limpHome { entry action warnDriver; do action driveLimited; }和transition limpStop first limpHome accept StopRequest then off;。 - 打开 行为 → 状态机,单击 + 新建图,在 显示 下选择
PowertrainStates,然后单击 创建。 - 选择
electric,从其手柄拖到limpHome;在 转换 上松开。在转换面板中输入 名称electricFault和 触发器FaultDetected,然后单击 在文本中显示。
当 PowertrainStates 包含 limpHome、limpStop 以及接受 FaultDetected 的转换 electricFault,且编辑器下方的状态报告没有问题时,即完成练习。
常见问题
- 是什么使
off成为PowertrainStates的初始状态? - 在
state off;之后是accept StartRequest if charge > 20 then electric;。说出其触发器、守卫、源和目标。 - 状态的 entry、do 和 exit 动作分别在何时运行?
DrivenCar中的exhibit state powertrainStates : PowertrainStates;表达了什么?
9.5 需求
观看第 9.5 章 (4:15)
练习
基于 Hybrid Car 演示项目 (SysML v2):
- 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包
VehicleRequirements。 - 在
attribute minElectricRange之后添加attribute minTopSpeed : SpeedValue = 180 [km/h];。 - 在
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 }。 - 在其他
satisfy行之后添加satisfy requirement roadsterSpeed : TopSpeed by fleet.roadster;。 - 将
minTopSpeed改为220 [km/h]。将指针指向编辑器在 satisfy 上放置的标记,查看它比较的数值,然后按 ⌘Z / Ctrl+Z。 - 打开 需要与需求 → 需求 并找到 VR-8,然后打开 需要与需求 → 质量 并单击 检查质量。
当 VR-8 出现在需求表中、satisfy 在 180 km/h 时没有标记,且“检查质量”已为其陈述评分时,即完成练习。
常见问题
- 为什么要将
maxCurbMass等限值保留为命名属性,而不是在每个约束中写入数字? - 在
requirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; }中,:>>起什么作用? satisfy carSpec by fleet.sedan;让 Holarch 能够检查什么?- 您在需求页面上设置了需求的 Status 和 Priority。SysML 文本会改变吗?
9.6 验证和可追溯性
观看第 9.6 章 (3:32)
练习
基于 Hybrid Car 演示项目 (SysML v2):
- 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包
VehicleRequirements。 - 在
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; }。 - 打开 验证 → 验证用例。在新用例所在行中单击 + 步骤,然后单击 + 添加步骤,在 操作 下输入
Weigh the battery on a bench scale,单击 应用,再单击其状态按钮中的 通过。 - 打开 验证 → RVTM,找到 VR-6
batteryMassLimit及新用例和其状态。 - 打开 验证 → 可追溯性矩阵,以需求为行、以类 Action 为列,单击
sedanAcceleration与accelerate交叉的单元格,然后选择 satisfied by。 - 在包的末尾添加
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,且状态报告没有问题时,即完成练习。
常见问题
- 在
objective massObjective { verify carSpec.sedanMass; }中,verify表达了什么?您在哪里能看到它? - 验证用例的 verdict 与“验证用例”页面上的状态有什么区别?
- 什么时候使用
satisfy,什么时候使用Derivation? - 在可追溯性矩阵单元格中选择 satisfied by 时会发生什么?
9.7 约束和计算
观看第 9.7 章 (4:26)
练习
基于 Hybrid Car 演示项目 (SysML v2):
- 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包
VehicleRequirements。 - 在
constraint def SpeedLimit之后添加constraint sedanBatteryCheck : MassLimit { in mass = fleet.sedan.powertrain.battery.mass; in limit = 50 [kg]; }。 - 在 图 页面上单击 + 新建图,选择 参数视图,并在 显示 下选择
VehicleRequirements,然后单击 创建。新的检查通过:48 kg 在 50 kg 以内。 - 在包
Vehicles中将轿车电池的质量改为52 [kg];视图显示检查失败。按 ⌘Z / Ctrl+Z,然后单击 全部求解 再次检查所有约束。 - 在
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,找到该需求及其负责人。 - 打开 架构 → 预算和 TPM,单击 选择根部件… 并选择
sedan。在 量 下选择 Mass,找到电池的 48 kg。
当 sedanBatteryCheck 在参数视图中显示“通过”,且 TBD/TBR 登记册列出负责人为 Test lead 的 Acceleration 需求时,即完成练习。
常见问题
constraint def与calc def有什么区别?- 参数视图中的某个约束显示“需要输入”。缺少什么?
- 为什么要用
#TBD或@TBD { … }标记未定数值,而不是将 TBD 写成数值? - 分析用例为计算增加了什么?
9.8 变体和配置
观看第 9.8 章 (3:42)
练习
基于 Hybrid Car 演示项目 (SysML v2):
- 打开您的 Hybrid Car 演示项目(如有需要,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)),打开 模型 → 编辑器 和包
Vehicles。它已经导入了HolarchVariability。 - 在
part def CarLine中,在charger变体点之后添加variation part rims : Wheel { variant part steelRims : Wheel; variant part alloyRims : Wheel { attribute :>> mass = 18 [kg]; } }。编辑器会提示三个配置尚未选择rims。 - 在
wallboxNeedsLargePack之后添加规则assert constraint alloyNeedsLargePack { rims == rims::alloyRims implies pack == BatteryPack::largePack }。 - 打开 模型 → 浏览器 并选择
selfChargingHybrid。在属性面板的 配置 部分,为 rims 选择 steelRims;为plugInHybrid和longRangeHybrid选择 alloyRims。然后在selfChargingHybrid上尝试 alloyRims,阅读判定结果,再按 ⌘Z / Ctrl+Z。 - 打开
CarLine的行菜单(⋯),选择 新建配置…。将其命名为cityHybrid,选择 standardPack、noCharger 和 steelRims,确认判定结果为“有效”,然后单击 创建。 - 单击顶栏中的 查看方式 ▾ 并选择
cityHybrid,然后从 图 列表中打开视图carLineVariants:未被选择的变体会被隐藏。
当属性面板中 CarLine 的“产品线”部分列出四个均为“有效”的配置以及规则 alloyNeedsLargePack 时,即完成练习。
常见问题
variation part def BatteryPack { … }与variation part charger : Component { … }有什么区别?plugInHybrid选择了BatteryPack::standardPack和charger::wallbox。会发生什么?为什么?- 某个配置尚未为每个变体点都选择变体。它的判定结果是什么?
metadata def <safetyCritical> SafetyCritical让您能够写什么?其他 SysML v2 工具如何看待它?
答案
9.1 定义和属性
:>使 Battery 成为 Component 的特化,因此它继承 mass、partNumber 和 power。redefines用 Battery 自己的特征替换继承的mass,这里绑定为 45 kg。- 不存在泛指的组件,只有各种具体的组件。抽象定义汇集了所有组件的共同之处,只有其特化(例如 Battery 或 Engine)才描述实际的部件。
power的类型为PowerValue,而千克是质量单位。检查器会对单位进行求值,因此会在该数值下标出下划线,直到单位改为功率单位(例如[W])为止。doc注释是属于该元素的文档,是模型的一部分。//注释只保留在文本中,不属于模型。
9.2 端口和接口
- 它对端口进行共轭:发动机的端口具有与 FuelPort 相同的特征,但方向相反,因此 FuelPort 的
out attribute flowRate到达发动机时成为输入。 - 绑定表示两个特征是同一个:动力总成的边界端口就是变速器的输出。接口用法连接两个不同的端口,其接口定义说明其两端接受哪些端口。
- Holarch 提供两端都适合这两个端口的接口定义。HighVoltageBus 的两端为
source : PowerPort和load : ~PowerPort,与这两个端口匹配。
9.3 动作和流
- 在 fork
split之后,supply和produce作为并行分支开始;fork 之后的每个then都开始一个分支。joinready等待两者都完成后再进入下一步。 - 前者是 succession:它在时间上排列步骤的顺序。后者是流:它将一个 Fuel 项从一个步骤的输出参数传递到另一个步骤的输入,其本身并不排列步骤的顺序。
- 来自
perform:每个执行某一步骤的部件(例如part redefines tank { perform trip.supply; })都会得到一条包含其所执行步骤的泳道。
9.4 状态和转换
entry; then off;:entry 之后接一个到off的 succession,因此状态机从那里开始。视图将其绘制为圆点。- 触发器:信号 StartRequest。守卫:
charge > 20。目标:electric。这种简写形式以它所跟随的状态off为源。 - entry 动作在进入状态时运行,do 动作在状态处于活动期间运行,exit 动作在离开状态时运行。
- 表示汽车展现此状态机:汽车拥有一个 PowertrainStates 的用法,因此其状态就是汽车的状态。
9.5 需求
- 使用该名称的每条需求都随一次编辑而更新,并且限值带有单位,因此检查器会比较带单位的数值。
- 它重定义 sedanMass 从 CurbMass 继承的
limit属性,为此用法赋予自己的值。 - 轿车的数值是否满足 carSpec 的约束。如果轿车的整备质量超过限值,编辑器会标记该 satisfy 并显示所比较的数值。
- 不会。状态、优先级和验证方法是保存在模型旁边的 Holarch 数据;它们从不更改文本。
9.6 验证和可追溯性
- 表示此验证用例验证需求 sedanMass。RVTM 会将该用例列在该需求下。
- verdict 是模型的一部分:一个表达式,这里是整备质量是否在限值以内。步骤、结果和测试运行的状态是保存在模型旁边的 Holarch 数据。
satisfy表示某个设计元素(例如部件或动作)满足一条需求。Derivation 将原始需求连接到由其派生的需求;它需要private import RequirementDerivation::*;。- Holarch 会在 SysML 文本中写入一条
satisfy,因此该追溯是模型的一部分,并显示在编辑器中。
9.7 约束和计算
- 约束定义陈述一个关于其参数、成立或不成立的条件,例如
mass <= limit。计算定义计算并返回一个值,例如return ratio = power / mass;。 - 某个参数尚无值。将每个参数绑定到一个值,例如
in mass = fleet.sedan.curbMass;。 - 在数值位置写
TBD不是有效的 SysML。Holarch 的HolarchMetadata包中的元数据可保持文本有效;TBD 和 TBR 特化了标准的StatusInfo元数据,因此其他 SysML v2 工具会将它们读取为状态注解。 - 它将计算应用于一个主题(例如轿车),返回结果,并带有一个目标,Holarch 会像评估其他约束一样评估其中的 require 约束。
9.8 变体和配置
- 前者是变体定义,即一组可重用的选择:以它为类型的用法(例如
part pack : BatteryPack;)就是一个变体点。后者是变体用法,即在某一个设计内部声明的变体点。 - 违反了规则
wallboxNeedsLargePack:它规定 wallbox 意味着大电池组。判定结果会指出该规则,编辑器会报告断言失败。 - 不完整,并指出未选择的变体点。当某个变体点没有选择时,涉及它的规则既不算满足也不算违反。
- 短名称会成为一个关键字,例如
#safetyCritical part controller : Controller;。它是一个普通的元数据用法,因此其他 SysML v2 工具会将其视为该部件上的元数据。
由 Holarch发布