SysML v2
SysML v2 视图
创建、打开和编辑 SysML v2 项目的视图(General、Interconnection、Action Flow、State Transition、Sequence、Grid、Geometry 以及 Requirement、Use Case、Parametric 和 Package 预设),并在模型上使用 Holarch 的分析图。
概述
视图以图的形式显示模型的一部分。在 SysML v2 项目中,每个视图都是模型中的一个 view 用法,因此它也会出现在文本中。您在视图中所做的每项更改都会立即写入文本,一次撤销即可全部撤回。
视图从与 LML 项目中的图相同的图列表中打开,具有相同的标签页、工具栏、添加面板、属性面板和导出功能。Holarch 支持 OMG SysML v2 规范的标准视图种类:
| 视图种类 | 显示内容 | 类型 |
|---|---|---|
| 一般视图 | 以框表示的定义和用法,以及特化、类型化、组合和需求。 | GeneralView |
| 互连视图 | 嵌套部件(端口位于其边框上)、连接、接口和项流。 | InterconnectionView |
| 动作流视图 | 动作、后继、控制节点以及参数之间的流。 | ActionFlowView |
| 状态转换视图 | 状态、嵌套和并行区域以及转换。 | StateTransitionView |
| 序列视图 | 生命线及其之间按顺序排列的消息。 | SequenceView |
| 网格(表格视图) | 元素表格和关系矩阵。 | GridView |
| 几何视图 | 以其属性给出的位置和大小绘制成二维图形的部件。 | GeometryView |
另有四种种类是一般视图的预设:需求视图、用例视图、参数视图和包视图。每一种都是带有指明其种类的筛选条件的一般视图。
Holarch 自己的分析图(Spider、层级、树、IDEF0、ICOM 和 FFBD)以及功能分析页面也作用于该模型。它们是 Holarch 图,不是 SysML 视图:它们不是文本的一部分。
概念
视图是模型的一部分
视图是由标准视图定义作为类型的视图用法。它公开(expose)其所显示的元素:
view structure : StandardViewDefinitions::GeneralView {
expose Vehicles::**;
}
expose Vehicles::**;显示包Vehicles及其拥有的所有内容。Holarch 为包和定义写入此形式。expose Vehicles::Powertrain;显示一个元素。Holarch 为用法写入此形式。expose VehicleRequirements::**[@SysML::RequirementUsage];仅显示该包中的需求用法。
由于视图是模型元素,它具有所有者、限定名以及在浏览器中的位置。您也可以在编辑器中编写或更改视图;图列表会随之更新。
布局是 Holarch 数据
位置、大小、折叠的分栏、颜色和缩放与模型一起存储在项目中。它们不是 SysML 文本。布局按元素标识保存,因此在文本中重命名或编辑元素时,它在每个视图中的位置都会保留。
预设:带筛选条件的一般视图
SysML v2 的图种类比 SysML 1.x 少。需求图、用例图、参数图或包图是一个筛选条件指明其种类的一般视图:
view requirementTree : GeneralView {
filter @SysML::RequirementDefinition or @SysML::RequirementUsage or @SysML::SatisfyRequirementUsage;
expose VehicleRequirements::**;
}
其他 SysML v2 工具会将它们读取为标准的一般视图。Holarch 会像对应的 LML 图那样绘制它们。在文本中编辑筛选条件即可更改种类。
| SysML 1.x 图(LML 项目) | SysML v2 视图 | 在文本中 |
|---|---|---|
| 需求图 | 需求视图 | filter @SysML::RequirementDefinition or @SysML::RequirementUsage or @SysML::SatisfyRequirementUsage; |
| 用例图 | 用例视图 | filter @SysML::UseCaseDefinition or @SysML::UseCaseUsage; |
| 参数图 | 参数视图 | filter @SysML::ConstraintDefinition or @SysML::ConstraintUsage; |
| 包图 | 包视图 | filter @SysML::Package; |
| 块定义图 | 一般视图 | : GeneralView |
| 内部块图 | 互连视图 | : InterconnectionView |
| 活动图 | 动作流视图 | : ActionFlowView |
| 状态机图 | 状态转换视图 | : StateTransitionView |
| 序列图 | 序列视图 | : SequenceView |
| 表格和矩阵 | 网格(表格视图) | : GridView |
| (无) | 几何视图 | : GeometryView |
视图和分析图
| 视图 | 分析图 | |
|---|---|---|
| 存储形式 | 模型中的视图用法 | 存储在其起始元素(根)下的 Holarch 数据 |
| 在文本中 | 是 | 否 |
| 与其他 SysML v2 工具交换 | 是,作为视图用法 | 否 |
| 显示内容 | 被公开的元素 | 始终根据模型计算 |
如何使用
何时使用及原因
使用视图从问题所需的角度查看模型:
- 结构:用一般视图查看定义及其特化;用互连视图查看一个装配体的部件如何连接。
- 行为:用动作流视图查看步骤的顺序及其执行者;用状态转换视图查看运行模式;用序列视图查看一个场景的消息。
- 需求:用需求视图查看需求树,以及满足和验证每条需求的元素;用用例视图查看参与者和目标;用参数视图根据约束检查值。
- 评审:用网格查看表格和矩阵;用包视图查看模型的组织方式。
在文本更快捷的地方用文本编写模型,再切换到视图来查看和调整。两者编辑的是同一个模型。
创建视图
- 打开导航栏底部的图工具。
- 点击+ 新建图。
- 选择视图种类,例如 General View。
- 在显示下,选择视图所显示的包或元素。列表按限定名排列,先列出包,然后是定义,再然后是部件、动作和状态用法。
- 也可以键入视图名称。如果不键入,Holarch 会选择一个未被使用的名称。
- 点击创建。视图随即打开。文本中会在其所显示的元素旁边增加一个视图用法,例如
view structure : StandardViewDefinitions::GeneralView { expose Vehicles::**; }。
视图由其所显示的包拥有,或由拥有其所显示元素的包拥有。
提示:导航栏中的视图列表会以其种类启动+ 新建图:行为 → 动作流、状态机和序列,以及架构 → 一般视图和互连视图。
打开视图
可使用以下任一方式:
- 在图列表中点击其卡片。卡片会显示视图的缩略图。
- 打开导航栏的某个视图列表,例如行为 → 动作流,然后点击该视图。
- 选择一个元素,然后在属性面板中选择打开方式 ▾。该菜单列出显示该元素的每个视图及其种类。
- 点击顶栏下方该视图的标签页。打开的视图会保留为标签页,与 LML 图相同。
- 在打开的视图中,点击▲ 父级可打开同一种类的、显示此视图所显示内容的所有者的视图。
在视图中编辑模型
每种视图都有自己的手势;常用的有:
- 将条目从左侧的添加面板拖到画布上,或使其获得焦点后按 Enter。模型中会创建一个新元素,并在视图中显示。
- 从一个形状的绿点或手柄拖到另一个形状,即可添加关系。当有多种关系适用时,会出现一个菜单供您选择。
- 将一个形状拖入另一个形状,即可将该元素移到那里(更改其所有者)。
- 双击名称或按 F2 即可重命名。
- 选择形状并按 Delete 即可将其从模型中删除。已删除的元素会连同其成员一起进入项目的回收站。
每项更改都会先经过检查。会使文本无效的更改会被拒绝并显示一条消息,模型保持原样。每项被接受的更改都可通过一次撤销撤回。
实例:Hybrid Car 演示
先创建演示项目:管理项目 → 项目文件 ▾ → 新建演示项目 → Hybrid Car (SysML v2)。它包含每种视图各一个。
- 打开图并点击 vehicleStructure(一个一般视图)。您会看到
Vehicles的部件定义:Component位于FuelTank、Engine、Battery以及其他对其进行特化的组件之上,还有Car及其部件。 - 打开 powertrainConnections(
Vehicles::Powertrain的互连视图)。您会看到tank、engine、motor、battery、transmission和controller及其端口,接口fuel、engineShaft、motorShaft和hvBus,以及output到transmission.output的绑定。motorShaft的两端标注为driver [1]和driven [1]:即它们的名称和多重性。 - 打开 driveCycleFlow(
DriveCycle的动作流视图)。您会看到从分叉split到park的步骤、决策shift,以及执行这些步骤的部件的泳道。 - 选择▶ 仿真 ▾ → 离散事件。仿真器会使用模型中写明的持续时间运行
DriveCycle,例如drive上的attribute duration : DurationValue = 75 [s];。 - 打开 carSpecTree(
carSpec的需求视图)并点击▲ 父级。requirementTree 随即打开:即拥有carSpec的包的视图。 - 打开 sedanParametrics 并点击全部求解。对话框显示
sedanMassCheck为通过:轿车 1580 kg 的curbMass在 1650 kg 的maxCurbMass以内。 - 打开 componentLayout(
sedanLayout的几何视图),将differential稍微向右拖动。sedanLayout的文本中,differential的x现在有了一个新值。
该演示还包含 carLifeline(个体汽车 Car_VIN1234 的一般视图,含其快照 atDelivery 和 atService 以及时间片 firstOwner;排列 ▾ → 排列为时间线会将它们按时间顺序排列)、emergencyShutdownFlow(以 terminate 结束的动作流视图)、startUpAllocation(一般视图:分配给动力系统各部件的启动角色)、powertrainStateView(状态转换)、startUpSequenceView(序列)、driveAwaySequenceView(含 alt、loop 和 par 片段的序列)、requirementsGrid(网格)、driverUseCases(用例)以及 packageStructure(包)。
提示和良好做法
- 保持视图精简。公开一个装配体、一个动作或一棵需求树。超过 12 个框的一般视图会将其分栏折叠为标题。
- 为视图命名。像
powertrainConnections这样的视图名称在图列表、标签页和打开方式 ▾中都易于阅读。 - 将视图放在其所显示内容的旁边。Holarch 创建视图时会这样做;在文本中编写视图时也请保持这一点。
- 评审时使用预设。使用排列 ▾ → 整理布局的需求视图会显示每条需求以及满足和验证它的元素。
- 同时处理大量元素时使用网格。它可在单元格中编辑种类、类型、多重性和值。
常见错误
- 以为“删除图”会删除元素。它只删除视图用法及其布局。它所显示的元素会保留。
- 在文本中查找分析图。Spider 图、层级图、树状图、IDEF0 图、ICOM 图和 FFBD 图是 Holarch 数据,不是视图用法。
- 为整理视图而删除形状。删除会将元素从模型中移除。要在序列视图中隐藏生命线,请改用移除。
- 编写无效的守卫。不是有效表达式的守卫会被拒绝。请将其写成表达式,例如
speed > 30。
与其他功能的关联方式
- 文本和浏览器:每个视图都是一个可用在文本中显示打开的元素;每次视图编辑都会更改文本(文本编辑器和浏览器)。
- 仿真器:动作流视图上的▶ 仿真 ▾会运行该流程(求值、单位和分析)。
- 需求和验证:视图中的 satisfy 和 verify 线与 RVTM 和可追溯性矩阵中显示的关系相同(需求和验证)。
- 文档和演示文稿:插入 → 图的图片…会列出这些视图;插图显示视图的当前状态。
- 框架:DoDAF 和 UAF 图产品是模型的视图(SysML v2 项目中的 Holarch 功能)。
视图编辑器
视图使用 LML 项目的图编辑器(图)。本节列出 SysML v2 项目中的不同之处。
标签页
每个视图和分析图都在顶栏下方以标签页形式打开。标签页按项目保持打开状态。视图被删除时,其标签页会关闭。
▲ 父级
▲ 父级会打开最近的另一个同种类视图,该视图显示此视图所显示内容的某个所有者。仅当存在这样的视图时才会出现。
在演示中,carSpecTree 显示需求 carSpec。其▲ 父级会打开 requirementTree,后者显示拥有 carSpec 的包 VehicleRequirements。
问题按钮
顶栏中的需要处理按钮(带数字的旗帜)与 LML 项目中的作用相同。它统计待评审的关联、逾期的 TBD/TBR 条目、失败的测试、TPM 超限、高风险以及模型检查错误。它不是编辑器的诊断信息:文本编辑器的状态栏统计的是所打开文本的错误和警告。点击该按钮即可列出需要处理的内容;点击某一项即可打开其页面。在 SysML v2 项目中,该列表只包含 SysML v2 项目提供的页面。打开主页位于列表末尾。
添加面板
左侧的添加面板列出视图可以创建的条目。每种视图的条目在下面相应的章节中列出。
- 将条目拖到画布上,或拖入某个形状中以在那里创建它。
- 或使条目获得焦点并按 Enter,将其添加到所选形状。
- 每次添加都可通过一次撤销撤回,并会写入文本。
在分析图和几何视图中,添加面板还可以查找现有元素。在添加或查找…中键入:
- Create “name” as …会以该名称创建一个新元素。
- 下方会列出匹配的模型元素及其种类。每一行的下方显示其所有者路径,例如 Vehicles::Car::body,以便区分同名元素。
- 键入路径的一部分可缩小列表范围,例如
Car::body。
属性面板
选择一个形状或一条线,即可在 SysML v2 属性面板中显示它:种类、名称、短名称、类型、多重性、值、文档说明、所有者和关系。连接或接口还有一个连接部分,显示每一端的名称和多重性;转换有一个转换部分,显示其触发器、守卫条件和效果;terminate 动作有一个终止部分。定义和用法还有事件(个体、快照或时间片)和表示形式(文本表示)。每次编辑都可通过一次撤销撤回,文本随之更新。打开方式 ▾会列出文本、浏览器、显示该元素的每个视图、带流程的动作的仿真器,以及该元素的分析图。有关属性面板,请参阅文本编辑器和浏览器。
复制、导出和删除
- 复制:从卡片菜单中选择。复制对话框会询问副本名称。副本是一个新的视图用法,具有相同的 expose 和相同的布局。
- 导出…:导出对话框,含 Diagram (PNG)、Diagram (SVG)、Diagram (HTML)、Diagram (Word) 和 Diagram (Print),与 LML 图相同(导出和打印)。网格视图则改用数据库表格和可追溯性矩阵的导出功能。
- 删除图:确认后删除视图用法及其布局。它所显示的元素会保留。可从回收站恢复,或撤销。
一般视图
一般视图将被公开的定义和用法绘制为带分栏的框,将包绘制为容器。
显示内容
- 框:每个定义或用法,带有其属性、端口、部件、动作和其他成员的分栏。需求会显示其文本。
- 个体、快照和时间片:标题按书写形式显示关键字,例如 «individual part def»、«snapshot» 或 «timeslice part»。框会在分栏 time slices and snapshots 中列出其快照和时间片,两者之间的后继(
first atDelivery then atService;)是一个从较早者指向较晚者的箭头。 - 线条:特化、类型化、组合、引用、«satisfy»、«verify»、«allocate» 和后继。分配(
allocate StartUp::controller to Powertrain::controller;)是一条带空心箭头的虚线,从显示被分配元素的框指向显示其目标的框,并标注 «allocate» 和该分配的名称。 - 布局:按层级排列。整体位于其部件之上,一般定义位于其特化之上。被许多其他定义特化的定义位于它们下方。从同一个框引出的线共用一条主干。
- 分栏:超过 12 个框时,分栏会折叠为标题。打开工具栏中的分栏可全部显示,或点击某个标题以折叠或显示该分栏。您未移动过的框在其大小改变时会重新布局。
添加面板
包、部件定义、部件、端口定义、端口、属性定义、属性、项定义、接口定义、动作定义、动作、需求定义、需求、验证用例和枚举定义。放到包上即可在该包中创建元素。
关联两个元素
从一个框的绿点拖到另一个框。关联为菜单会列出适用的关系:
| 选项 | 写入文本的内容 |
|---|---|
| 将 A 移入 B | A 成为包 B 的成员。 |
| 特化:A 特化 B | 同一种类的两个定义之间的 :>。 |
| 类型化:A 由 B 定义 | 用法 A 获得类型 B。 |
| 组合:A 拥有 … : B | A 中的一个新用法,类型为 B。 |
| 引用:A 引用 B | A 中的一个新 ref 用法,类型为 B。 |
| 满足:A 满足 B | satisfy B by A; |
| 验证:A 验证 B | 验证用例 A 的目标中的 verify B;。 |
| 分配:A 被分配给 B | 两个既不是需求也不是验证用例的特性之间的 allocate A to B;。 |
工具栏、菜单和手势
- 删除:从模型中删除所选元素;它们会进入回收站。
- 格式工具和对齐,与 LML 图相同。
- 框架:显示带标题的 SysML 框架。
- 分栏:显示或折叠所有分栏。
- 排列 ▾:折叠所有分栏、展开所有分栏、排列为时间线,以及宿主编辑器的整理布局和恢复默认值。排列为时间线会将绘制为框的快照和时间片按所有者各排成一行,按其后继给出的顺序从左到右排列,一次撤销即可全部撤回。
- 右键单击框:重命名(F2)、在文本中显示、展开分栏或折叠分栏、新建快照…和新建时间片…(对于事件)、删除…。
- 右键单击线:移除关系。
- 关系 ▾:选择一条线,然后选择它在同两个框之间所表示的关系。组合线或引用线可变为组合、引用或特化;特化线可变为类型为一般定义的组合或引用特性;satisfy 线或 verify 线可变为满足或验证。文本随之更改,一次撤销即可撤回。无效的种类,或会增加错误的种类,会被拒绝并给出原因,例如 “Attribute features cannot be composite: they are always references.”(属性特性不能是组合的:它们始终是引用。)
- 将框拖入包中即可将该元素移到那里。
互连视图
互连视图显示一个部件定义或用法的内部。它使用 LML 内部块图的引擎。
显示内容
- 框架是被公开部件的边界。该部件自身的端口位于框架上。
- 部件:该部件自身的部件,然后是其定义的部件,嵌套到所选的深度。部件沿其连接分列排布(Holarch 会尝试几种排列方式,例如将电源或数据枢纽放在左侧,将其服务的部件放在右侧,并保留线条交叉最少的那一种),每一层与其所连接的对象放在一起,并按其名称和端口确定大小。仅与框架相连的部件会加入端列。绑定到中间列某个部件的框架端口位于框架的顶部或底部。
- 端口位于部件朝向其所连接对象的一侧。其标签(名称 : 类型)位于部件内部、端口旁边、部件名称下方;框架的端口在框架内部、其连线上方标注。嵌套较深的部件只显示端口名称;将指针指向端口即可查看其类型。
- 线条:连接(标注名称和类型;具名的端会在端旁显示其名称和多重性,例如
driver [1])、接口(较粗)、绑定(虚线,带=)、项流(«flow» 和项,实心箭头)以及视图上部件和端口之间的分配(虚线,«allocate»,空心箭头)。线条绕过不属于它们的部件,各走自己的通道,连接的名称位于其线条的空闲段上。列与列之间的间距会随穿过其中的线条数量而加宽。
添加面板和手势
- 添加面板:部件(放到图上或部件中)、端口(放到部件上)和项。Holarch 会询问名称。
- 连接:从一个端口的手柄拖到另一个端口。放置区域为 Interface : <interface def>(当某个接口定义适用于两个端口时)、连接、绑定和流。流会询问项:选择它并点击添加流。
- 嵌套:将一个部件拖入另一个部件,即可将该用法移到那里。
- 删除:要求确认后删除该元素及其成员。删除继承的部件会将其从其定义中删除,因此它会从该定义的每个用法中消失。
工具栏
- 深度 − n + 和全部:要显示的嵌套部件层数(默认为 3)。
- 视图 ▾:项流、分配和继承的部件和端口,可分别显示或隐藏。
- 接口登记册:视图上的连接和接口及其状态、所有者、项和容量检查,与 LML 内部块图相同。
- 关系 ▾:选择一条线,将其变为具有相同两端的连接、接口、流或绑定。其类型(连接定义或接口定义)以及流的项会被移除。接口两端都需要端口,绑定没有成员;会增加错误的其他种类会被拒绝并给出原因。
- 删除、框架和排列 ▾,与 LML 图相同。排列 ▾ → 整理布局会将所有部件和端口恢复为自动布局;恢复默认值还会重置深度和“视图 ▾”设置。
动作流视图
动作流视图显示一个动作如何运行:其步骤、步骤之间的顺序、在其参数之间流动的项,以及执行每个步骤的部件。它公开一个动作定义或用法。
显示内容
- 框架是被公开的动作。其参数是框架边界上的引脚。
- 动作是圆角框,其参数显示为引脚:输入在左,输出在右。其定义的参数也包括在内。具有文本表示的动作,或其类型定义具有文本表示的动作,会在右上角用花括号显示其语言,例如 {Python}。
- 控制节点:开始(实心圆)、完成(带环的圆)、terminate(带叉的圆;它会立即结束该动作,因此其后没有步骤)、分叉和汇合条、决策和合并菱形、accept 和 send 动作,以及循环(
while)。 - 后继显示为箭头。守卫显示在方括号中;决策之后没有守卫的后继为 [else]。
- 流是引脚之间的绿色箭头,以其项标注。
- 泳道来自
perform(以及allocate):执行该流程中动作的部件会获得一个包含这些动作的泳道。
添加和连接
- 使用+ Action ▾,或从添加面板拖动:动作、accept 动作、发送动作、循环(while)、分叉、汇合、决策、合并或终止。
- 从一个节点的绿点拖到另一个节点,即可添加后继(“先做这个,再做那个”)。
- 从一个引脚拖到另一个引脚即可添加流。
- 选择一个动作,然后选择+ 参数 ▾ → 输入 (in)或输出(out)。未选择任何内容时,参数会添加到被公开的动作。
守卫、循环和泳道
- 选择一个后继即可设置其守卫;双击它即可键入守卫。
- 选择一个循环即可编辑其条件。
- 将动作拖入某条泳道,即可让该部件执行它。将其拖出所有泳道即可移除 perform。
- + 泳道,或添加面板中的泳道,会为一个部件添加一条空泳道。
工具栏
- + 添加 ▾:+ Action ▾、+ 参数 ▾、+ 泳道。
- 删除:移除所选内容,以及指明它的后继、流和 perform。
- 重命名(F2)。
- 格式工具。
- 布局:重新布局该流程(一次撤销即可全部撤回)。
- ▶ 仿真 ▾:离散事件或蒙特卡洛会在仿真器中打开被公开的动作(求值、单位和分析)。
- 生成部件视图:为执行(或被分配了)该流程中动作的部件创建一个视图并将其打开。当一个部件包含所有这些部件时,生成的是最内层的此类部件的互连视图;否则生成这些部件的一般视图。视图以该动作命名,例如
driveCyclePerformers,一次撤销即可将其移除。
编辑文本时,位置会保留。
状态转换视图
状态转换视图显示一个状态定义或用法及其状态和转换。它使用 LML 状态机图的引擎和形状。
显示内容
- 状态是带有 entry / do / exit 分栏的圆角框。
- 复合状态和并行状态包围其子状态。并行状态的子状态是其区域,以虚线边框绘制。
- 初始状态:圆点。它来自
entry; then off;。 - 终止状态:靶心形,用于转到
done的转换。 - 转换是标注为
trigger [guard] / effect的空心箭头。诸如accept StopRequest then off;这样的简写转换从其所跟随的状态开始。
添加面板和手势
- 添加面板:初始状态(放到状态机开始时所处的状态上)、终止状态(放到状态机结束前的状态上)、状态、并行状态、区域(放到并行状态上)、entry 动作、do 动作和 exit 动作(放到状态上)。
- 将一个状态拖入另一个状态即可移动它。跟随它的简写转换会随之移动。
- 从一个状态的手柄拖到另一个状态即可添加转换。
- 选择一个转换即可在侧面板中编辑它:名称、触发器、守卫条件和效果,以及在文本中显示和删除。初始转换只有守卫条件。属性面板的转换部分编辑的是相同的部分,在浏览器中选择该转换的触发器或效果时也是如此。
工具栏
深度 − n + 和全部(默认 3 层)、删除、框架和排列 ▾。
使用 SysML 引擎时,▶ 仿真会在视图上方打开一个工具条:▶ 播放、⏭ 单步、⏩ 运行到结束、重置、时钟、活动状态、在仿真器中打开和 ×。活动状态会点亮,已离开的状态会被标记,触发的转换会高亮显示。运行使用仿真器上为该状态定义保存的激励;请参阅仿真状态机。
序列视图
序列视图按顺序显示一个场景的消息。它公开一个事件、部件或动作的定义或用法。它使用 LML 序列图的绘制方式和手势。
显示内容
- 生命线:被公开元素的部件和端口。
- 消息:生命线之间的
message和flow用法,显示为水平箭头。 - 顺序:消息之间的
first m1 then m2;后继,然后是成员的顺序。 - 组合片段:当被公开的元素是一个动作时,其控制结构中的消息会绘制在一个框中,运算符位于左上角的标签中,操作数之间用虚线分隔,每个守卫显示在方括号中。嵌套在另一个片段中的片段绘制在其框内。
| 在文本中 | 片段 |
|---|---|
if c { … } else if d { … } else { … } | 带 [c]、[d]、[else] 的 alt |
不带 else 的 if c { … } | 带 [c] 的 opt |
while c { … } 或 loop { … } until d; | 带 [while c] 或 [until d] 的 loop |
for i in 1..3 { … } | 带 [i in 1..3] 的 loop(3)(当范围为两个整数时显示次数) |
fork f; then a; then b; … join j; | par,每个分支一个操作数 |
decide d; if g then a; else b; | 带 [g]、[else] 的 alt(只有一个分支时为 opt) |
分叉或决策的分支是一个包含消息的动作,或一条消息。包含消息的普通动作绘制时不带框。
action def DriveAway {
in attribute charge : Real;
part driver : Driver;
part controller : Controller;
part motor : ElectricMotor;
part engine : Engine;
message pressPedal from driver to controller;
then action selectMode if charge > 20 {
message driveElectric from controller to motor;
} else {
message startEngine from controller to engine;
}
}
选择一个框,即可在属性面板中显示其 if、循环、分叉或决策。
添加和编辑
- 从添加面板拖动生命线(部件)或生命线(端口),即可将主体的一个新部件或端口添加为生命线。也可以点击+ 生命线。
- 从添加面板拖动主体的某个部件,即可显示其生命线(✓ 标记已显示的部件)。
- 从一条生命线拖到另一条生命线即可添加消息。也可以将消息放到两条生命线之间:左侧的生命线将其发送给右侧的生命线。文本中会增加
message m1 from a to b;以及将其放到相应位置的后继。 - 上下拖动消息可重新排序。横向拖动生命线头部可重新排列生命线。在含片段的序列中,请在文本中更改消息顺序;新消息会添加在最后一条消息或片段之后。
- 选择一条消息,即可在侧面板中编辑名称、载荷、从和到,并可使用检查、在文本中显示和删除。
工具栏和排列
- + 生命线。
- 移除:在此视图中隐藏所选生命线。该部件仍保留在模型中;从添加面板将其拖入即可再次显示。
- 删除:从模型中删除所选内容。
- 排列 ▾ → 重置生命线顺序和显示所有生命线。
生命线顺序和隐藏的生命线属于 Holarch 数据。
网格视图
网格视图是被公开元素的数据库表格或可追溯性矩阵。使用表格和矩阵切换。该设置随视图保存。
- 范围:视图的 expose。诸如
expose VehicleRequirements::**[@SysML::RequirementUsage];这样的元类筛选条件会成为类筛选条件。 - 表格:数据库的筛选器、列选择器、行内编辑、属性面板、右键菜单和导出功能。种类以类徽章显示元素的种类(Holarch 条目显示其类);所有者是所属元素的限定名,用于区分同名用法。类型、多重性和值列可在单元格中编辑:双击或按 Enter。Individual、部分(portion)和实例(元素定义的个体)是列 ▾ → SysML v2下的只读列。
- 视图窗格:已保存的视图和内置视图:Recently changed、Most connected、Requirements without a verification case、Unsatisfied requirements、Parts without ports、Untyped usages、Unresolved names、Unnamed elements、Links to review、Open TBD/TBR、Model check findings 和 Unresolved comments。Unnamed elements 按种类和所有者列出没有名称的元素,例如后继中的动作;其他列表会略去这些元素。Unnamed redefinitions(
is:redefinition)列出变体中重定义继承项的未命名部件、端口和项(part :>> battery;);除问题视图(待评审的关联、TBD/TBR、发现项、评论)外,其他列表也会略去它们。它们的所有者以:>> battery结尾。属性重定义仍保留在列表中,因为它们承载着变体的值。 - 矩阵:可追溯性矩阵工具(需求和验证)。
需求视图、用例视图、参数视图和包视图
这四种预设是像对应 LML 图那样绘制的一般视图,具有相同的添加面板和连接手柄。排列 ▾ → 整理布局会重新布局预设:
- 需求树,每个满足、验证或派生的元素位于其需求之下;
- 用例在其主体内交错排成两列,参与者位于其大多数用例所在的一侧;
- 每个约束的绑定值位于其下方。
需求视图
- 需求显示其 ID(短名称)、文本(doc)和主体。嵌套需求挂在其所有者之下。属性 ▾用于选择 ID、文本、主体和属性名称。
- 线条:
- «satisfy»:
satisfy carSpec by fleet.sedan; - «verify»:验证用例的目标
verify carSpec.sedanMass; - «deriveReqt»:类型为
RequirementDerivation::Derivation的连接,例如connection batteryMassDerivation : Derivation connect carSpec.sedanMass to batteryMassLimit;(也可写作#derivation connection) - «refine»:
#refinement dependency commute to carSpec.sedanRange;
- «satisfy»:
- 添加面板:需求(放到需求上:嵌套在其下并按其编号)、需求定义、部件(放到需求上:该部件满足此需求)和验证用例(放到需求上:该用例验证此需求)。
- 现有元素:在添加或查找…中键入,即可列出模型的部件和其他特性、需求以及验证用例。将现有部件放到需求上会写入
satisfy <requirement> by <part>;,将验证用例放到需求上会在其目标中添加verify <requirement>;(每项都可通过一次撤销撤回)。将元素放到图上即可在此视图中显示它;模型不会改变。 - 连接:从一个形状拖动手柄到另一个形状,然后选择包含(拥有的成员)、«deriveReqt»(派生连接)、«refine»(细化依赖)、«satisfy»(satisfy … by)或«verify»(验证目标)。
- 关系 ▾:选择一条 «satisfy»、«verify»、«deriveReqt» 或 «refine» 线,然后选择这些种类中的另一种。旧关系会被同两个元素之间的新关系替换,一次撤销即可全部撤回。在它们之间无效的种类会被拒绝并给出原因:satisfy 需要一个不是需求的特性,verify 需要一个验证用例,派生需要两个需求用法。
用例视图
- 用例是位于其主体边界内的椭圆(
subject car : Car;)。用例用法采用其定义的主体。 - 参与者:每个参与者定义是一个人形图标,与其参与的用例相连(
actor driver : Driver;)。 - 线条:«include»(
include use case startCar : StartCar;)和泛化(特化另一个用例定义的用例定义)。SysML v2 没有 extend 关系;特化另一个用例的用例承担这一角色。 - 添加面板:用例(放入主体中:获得该主体)、参与者(放到用例上:参与其中)和主体(放到用例上)。
- 连接:从参与者拖到用例即可添加该参与者,或在用例之间拖动以添加 «include» 或泛化(specializes)。
- 关系 ▾:选择一条 «include» 线或泛化线,将其更改为另一种。«include» 需要以用例定义为目标;泛化关联两个用例定义。
参数视图
- 约束显示其表达式(其自身的或其定义的)。参数是约束底边上的引脚,以其值标注。
- 绑定:值指明某个特性的参数(
in mass = fleet.sedan.curbMass;)会绑定到该特性。该值显示在其部件中;对于包级别的值(例如maxCurbMass),则单独显示。 - 状态:值以及通过 / 失败来自模型带单位的求值。需要输入表示某个参数尚无值。
- 全部求解:带单位地检查每个约束,计算由方程定义的值(
q == s * s),并求解尚无值的值。求解所有约束对话框会预览要写入的值(值、参数、当前、新值、方式:计算值、Solved for input 或 Solved (set n))以及每个约束的状态。点击应用 n 项更改,即可写入这些值,一次撤销即可全部撤回。 - 多个未知量:共享无值数值的约束会被联合求解。Holarch 会找出相互依赖的最小约束集,并用牛顿法求解每个集合;由单个方程组成的链会逐个求解。联合求解列出每个集合:其约束、求得的值、所用的迭代次数以及残差(方程两边之间剩余的最大差值,相对于其大小)。请参阅求解多个未知量。
- 求解:对所选约束以及与其共享未知量的约束执行相同操作(求解约束)。
- 只写入数字(或空)值;表达式形式的值保持不变。
- 添加面板:约束、参数(放到约束上)、部件和值。
- 绑定:从参数拖到值。参数的值会变为该值的名称。在绑定线上使用删除会从参数中移除该值。
求解多个未知量
约束中的方程为 left == right。模型中没有值的数值(attribute capacity : EnergyValue;)是一个未知量。全部求解会求解它能处理的每个方程中的未知量:
- 它将方程拆分为必须联合求解的集合:在循环中共享未知量的方程,例如功率取决于质量,能量取决于功率,而质量又取决于能量。
- 它依次求解每个集合,并使用之前各集合求得的值。
- 它用求得的值检查其他约束,例如
totalMass <= 1700 [kg]。
要试用此功能,请在 Hybrid Car 演示中打开 sedanParametrics 并点击全部求解:packPower、packEnergy 和 packMass 构成一个含三个未知量的集合,即 packSizing.drivePower、packSizing.capacity 和 packSizing.totalMass。
单位必须一致:方程两边具有同一个量纲,未知量采用其类型的量纲(PowerValue、MassValue)。没有类型的未知量是普通数字。诸如 side >= 0 [m] 这样一侧只有一个未知量的比较会约束该未知量的范围,且绝对温度永远不会低于 0 K。
当某个集合无法求解时,对话框会说明原因和处理方法:
| 留言 | 应采取的行动 |
|---|---|
| n 个方程(…)对应 m 个未知量(…),彼此矛盾。 | 方程多于未知量,且相互不一致。请移除一个约束或更改其值。一致的多余方程没有问题。 |
| 未知量 … 未被确定:… | 方程少于未知量。请添加一个约束,或为其中一个数值赋值。 |
| … 的方程相互依赖,因此无法确定 … 的唯一值 | 一个方程可由其他方程推出(x + y == 10 和 2 * x + 2 * y == 20)。请用一个独立的方程替换其中之一。 |
| 没有 … 的值能满足 …(在 n 次迭代后停止)。 | 这些方程没有求解器能找到的解,例如 x * x == -4。请检查方程及其单位,或为某个未知量设定范围。 |
| 在 … 中,左侧的单位为 …,右侧的单位为 …。 | 单位不匹配。请修正方程,或为未知量指定一个量类型。 |
| … unknowns depend on each other, more than one coupled set can hold (100).(… 个未知量相互依赖,超出一个耦合集合可容纳的数量(100)。)/ … unknowns or equations are more than the solver takes at once (1000).(… 个未知量或方程超出求解器一次可处理的数量(1000)。) | 为部分数值赋值,或一次求解较少的约束。 |
| 求解在达到工作量上限时停止。 | 一次求解较少的约束。 |
含未知量的分析用例以相同方式求解;请参阅求值、单位和分析。
包视图
- 包按所有权嵌套并显示其成员。关闭工具栏中的成员即可隐藏成员。
- «import» 线显示每个包导入的内容。
- 将包或成员拖入另一个包即可移动它。
- 从一个包拖动手柄到另一个包,即可添加 «import»(private import ::*)(
private import Other::*;)或包含(拥有的成员)。
几何视图
几何视图以二维形式、按其属性给出的位置和大小绘制一个部件的各部件。它公开一个部件:view componentLayout : GeometryView { expose VehicleViews::sedanLayout; }。
显示内容
- 当一个部件具有属性
x、y、width和height时,会被绘制为矩形。它们是以 m、cm 或 mm 为单位的长度;普通数字表示米。 - 重定义继承的属性同样有效:
attribute :>> x = 1 [m];。 x和y从拥有该部件的最近一个已放置部件的左上角开始测量(否则从视图原点开始),y向下为正。- 在 100% 缩放下,1 m 为 200 px。绘图下方的比例尺显示 1 m。
- 不具备这四个值的部件会在绘图下方的 Not placed (no x, y, width and height)(未放置(无 x、y、width 和 height))下列出。放置会添加它们。
part redefines frontAxle {
attribute x = 1.0 [m]; attribute y = 0 [m]; attribute width = 0.65 [m]; attribute height = 1.8 [m];
}
编辑
- 拖动部件可更改
x和y。拖动角可调整其大小。 - 方向键将所选部件移动 1 cm;按住 Shift 时移动 10 cm。
- 这些值以其已使用的单位写入,一次撤销即可全部撤回。
- 添加面板:将部件拖到绘图上,即可在放置位置(在其所放到的部件内)创建一个带有
x、y、width和height的新部件。也可以按 Enter 将其添加到所选部件。 - 在添加或查找…中键入,即可创建具有该名称的部件、添加类型为现有部件定义的部件,或放置尚无值的部件。
分析图
Holarch 的分析图作用于 SysML v2 项目的模型,其引擎和外观与 LML 项目中相同(其他图)。它们保存在项目中,位于其根元素之下。它们不是视图用法,也不会出现在文本中。其布局由您自行安排;其显示内容始终来自模型。
选择一个节点或块会显示 SysML v2 属性面板。删除节点或块会从模型中删除该元素;它会进入项目的回收站。LML 工具面板以及分解关联的移除(从图中移除)不会显示。▲ 父级会打开该元素所有者(部件的所属部件或其包)的同类图。双击元素,或在其菜单中选择打开条目视图,即可打开其条目视图。
打开分析图
- 在图列表中点击+ 新建图,选择图类型以及其起始元素。
- 或者在视图、浏览器或列表中选择一个元素,然后选择打开方式 ▾ → Spider 图。当元素具有成员时,会列出层次结构图和树形图;当元素具有步骤时,会列出 FFBD 和 IDEF0 图。
- 浏览器行菜单中有在 Spider 图中显示。
- 行为 → FFBD 和架构 → 层级会列出这些图。
- 在您打开或删除之前,图列表还会为每个带成员的定义(由包拥有的部件、动作或需求定义)提供一个派生的层次结构图。
Spider 图
该元素位于中心,与其相关的所有内容向外展开,直到层级所设的范围。
- 关系:owns、typed by、specializes、subsets、redefines、connected to、satisfied by、verified by、performs、allocated to、flows to 和 depends on。关系…用于选择它所追踪的种类。
- 节点上的 + 会显示该节点的相邻节点。
- 添加关系:从一个节点的圆点拖到另一个节点,或使用+ 添加相关项…。只提供模型能容纳的关系:typed by、specializes、satisfy、verify、allocate、依赖、连接和所有权。该关系会写入文本。
- 添加面板:所有种类。新元素或现有元素会与所选节点(或中心)建立关联。请选择关系:owns、typed by、specializes、subsets、satisfied by、verified by、allocated to 或 depends on。
层级图和树状图
它们显示分解结构:部件的部件、动作的动作、需求的需求,以及包的包、定义和顶层用法。
- 自身没有成员的用法会显示其定义的成员。
part powertrain : Powertrain显示Powertrain的部件。 - + 添加子项会添加一个用法。
- 将一个节点拖到另一个节点上,即可将该元素移到那里。
- 层次结构图的分配层次结构预设(分配层次结构预设)作用于部件:部件执行的动作(
perform)或分配给它的动作(allocate)会作为 performs 列出。以动作、需求或包为根时,该预设不可用。 - 添加面板:分解结构的种类(部件:Part;动作:Action;包:Package、定义和用法)。新元素会成为其所放到节点的成员;现有元素会移到那里。在树形图中,请将其放到节点上。
IDEF0 图和 ICOM 图
动作的步骤是框 A1、A2、…。在+ 新建图列表中,ICOM 图为 ICOM (A0) 图。
| 模型 | IDEF0 角色 | 侧边 |
|---|---|---|
in item 参数 | Input | 左侧 |
in attribute 参数 | 控件 | 顶部 |
out 参数 | 输出 | 右侧 |
| 执行该步骤的部件 | Mechanism | 底部 |
| 两个步骤之间的流 | 从一个框指向另一个框的箭头 |
- + Action 会添加一个步骤。
- 生成 ▾ → 生成部件视图…:预览执行该动作及其步骤的部件,然后创建包含所有这些部件的部件的互连视图(否则创建这些部件的一般视图)并将其打开,与 LML 项目中生成 Asset 图的作用相同。
- 生成 ▾ → 生成需求…(在某个步骤的 IDEF0 图上):预览并为每个输入、控制、输出和步骤创建一条需求,措辞针对执行该步骤的部件(“The Engine shall accept Fuel.”)。它们是文档 <part> Requirements 所在包中的需求用法,位于 Input Requirements、Output Requirements 和 Functions 各节之下,由该步骤满足并追溯到该部件。再次运行会更新它们。
- 添加面板:动作(步骤)会添加一个步骤;从搜索中选择的动作定义会成为以其为类型的步骤。参数放到步骤顶边时为 Control(
in attribute),放到左边时为 Input(in item),放到右边时为 Output(out item);从搜索中选择的项定义或属性定义会成为其类型。部件(Mechanism)会添加一个执行该步骤的部件;放入现有部件可让其执行该步骤。
FFBD
该动作的步骤按顺序排列:后继显示为箭头,分叉和汇合显示为 AND,决策显示为 OR(带守卫),循环显示为 LP。编辑方式与 LML 项目中相同(FFBD 图):添加面板、放置点、线条和删除。每项更改都会写入模型和文本,一次撤销即可全部撤回。
- 添加面板:Action、AND、OR 和 LP、该动作的步骤以及动作定义。动作定义会成为以其为类型的步骤;来自其他位置的动作用法会移入该动作。
- AND 添加一个分叉和一个汇合;OR 添加一个决策和一个合并,概率平均分配;LP 添加一个
while循环。 - 回到较早步骤的线是返回该步骤的后继:即一个循环。
- 删除会将步骤移出流程。它会保留在模型中但没有后继,并列在添加面板的 Not in the flow(不在流程中)下。要删除步骤本身,请在属性面板中使用从模型中删除…;它会进入项目的回收站。
- 编辑流程…会打开显示该动作的动作流视图。
FFBD 是 Holarch 图,不是 SysML 视图:它保存在项目中,不会出现在文本中。
功能分析
功能分析页面作用于模型的动作(功能分析)。
- 打开行为 → 功能分析。
- 点击选择…并选取顶层功能:一个动作定义或用法。其功能是其动作用法,按其短名称编号。
- 在功能标签页上,编辑 ID、名称以及每个功能所满足的需求(模型中的
satisfy)。 - 勾选子系统即可查看执行每个功能的部件(
perform或allocate)。 - 打开流程与 FFBD即可以 FFBD 形式查看流程。流程是模型中步骤的顺序:后继、分叉和汇合(AND)、决策(OR)以及循环。要更改它,请点击以文本编辑…或在 Action Flow View 上编辑、编辑 FFBD,或编辑模型文本。LML 项目的结构化流程编辑器不会显示。
表格、覆盖率和 Word 报告的作用与 LML 项目中相同。
以文本形式编辑流程
以文本编辑…会打开 LML 项目的流程对话框,使用相同的表示法(功能分析):步骤用 -> 连接,以及 AND( a | b )、OR( a | b ) 和 LOOP( … ),并带有实时 FFBD 预览。✦ AI ▾ → 使用 AI 建议流程…会打开同一个对话框,显示建议的流程以及对当前流程的更改。
- 点击以文本编辑…。文本显示当前流程;步骤以短名称命名,没有短名称时以名称命名。
- 编辑文本。尚不是步骤的名称会成为顶层功能的一个新动作用法(
"Check health"变为checkHealth)。文本中略去的步骤会离开流程:它会保留在模型中但没有后继,并列在 FFBD 的添加面板中的 Not in the flow(不在流程中)下。 - 点击应用。Holarch 会将流程写入模型,形式为后继、分叉和汇合节点(AND)、决策和合并节点(OR),以及返回循环第一个步骤的后继(LOOP;空循环为
while true)。未更改的部分保留其后继、守卫和else分支;包含相同步骤的门保留其节点以及while和if动作。
一次撤销即可撤回该更改,模型文本会显示新的后继。对于模型无法容纳的文本,应用会拒绝,且不做任何更改:
- 在 SysML v2 项目中,循环不接受选项,且
EXIT没有 SysML v2 形式。 - 带守卫的决策只接受一个不带守卫的分支(其
else)。请在动作流视图中添加另一个分支并为其指定守卫。 - 当从模型读回的流程与文本不同时,请在动作流视图中进行更改。
其他图类型
+ 新建图还提供基于模型的接口图:N² 图 (Action)、N² 图(部件)、物理 I/O 图和接口控制图。请参阅 SysML v2 项目中的 Holarch 功能。
键盘快捷键
| 按键 | Action |
|---|---|
| Delete 或 Backspace | 从模型中删除所选内容(移到回收站)。 |
| F2 | 重命名所选元素(一般视图和动作流视图)。 |
| Escape | 清除所选内容。 |
| 在添加面板条目上按 Enter | 将其添加到所选形状。 |
| 方向键 | 几何视图:将所选部件移动 1 cm。 |
| Shift+方向键 | 几何视图:将所选部件移动 10 cm。 |
| ⌘Z / Ctrl+Z | 撤销上一次更改。 |
其他图快捷键列在图中。
无障碍
视图可以仅用键盘操作,也可以配合屏幕阅读器使用,与 LML 图相同。
- 一个视图只有一个 Tab 停靠点。形状和连接按模型命名,例如“Part def: Component”或“Port: Fuel Out, inside Part: Tank”。
- 方向键在形状之间移动,然后在连接之间移动,并逐个选中。Space 用于选择;Shift+Space 将其添加到所选内容。
- Enter 进入属性面板;在属性面板中按 Esc 返回该形状。Shift+Enter 打开该条目。
- ⌥ / Alt+方向键移动所选形状,每次按键都可通过一次撤销撤回(按住 Shift 移动得更远)。C 打开连接…,将该形状与另一个形状关联。Delete 删除所选内容。
- 网格视图就是数据库表格,键盘用法相同。
限制:在动作流视图中,参数引脚和泳道只能用鼠标操作。使用键盘时,请用连接…连接整个动作,并在属性面板或编辑器中设置参数之间的流和执行者。
消息
| 留言 | 含义和解决方法 |
|---|---|
| 选择视图所显示的元素。如果模型为空,请先创建一个包。 | + 新建图需要在显示下选择一个元素。 |
| 视图未创建。 | 无法将视图添加到模型。请检查名称后重试。 |
| 名称为 1 到 1,000 个字符,且不含换行。 | 缩短视图名称。 |
| 未找到视图 | 该视图已被删除或移动。请从图中打开另一个视图。 |
| 未选择任何内容。请选择要删除的元素。 | 删除需要先选择内容。 |
| 选择一个要重命名的元素。 | 选择单个动作或节点,然后重命名。 |
| 元素不能移入其自身的成员中。请放到其他位置。 | 您将一个框放入了它自己的某个成员中。 |
| 被公开的部件会保留:请在浏览器或编辑器中删除它。 | 无法从视图中删除互连视图的框架。 |
| 初始状态没有传入转换。请连接到一个状态。 | 将转换绘制到一个状态,而不是初始圆点。 |
| 没有可仿真的内容:被公开的动作中没有带后继的动作。 | 在使用▶ 仿真 ▾之前,请添加步骤和后继。 |
| 这条线表示所有权。将形状拖到另一个所有者即可更改。 | 包含不是可删除的关系;请改为移动该元素。 |
| 将主体放到用例上。 / 此用例已有主体。 | 一个用例只有一个主体。 |
| 将参数放到约束上。 | 参数属于约束。 |
| 此值没有可绑定的名称。请先为其命名。 | 为该值命名,然后绑定参数。 |
| 没有任何时间片或快照绘制为框。请先将它们添加到视图中。 | 排列为时间线在视图上未找到快照或时间片。 |
| 没有值发生变化。所有计算值都是最新的。 | 全部求解未找到要写入的内容。 |
| 没有带表达式的约束。请在约束中编写一个表达式,例如“mass <= limit”。 | 该视图的约束没有可检查的表达式。 |
| 单位支持未加载。请重新加载页面。 | 重新加载,然后再次求解。 |
| 所有权不是关联:请在浏览器中移动该元素或将其删除。 | Spider 图:owns 线不能作为关联移除。 |
| <kind> 没有分解结构。请选择部件、动作、需求或包。 | 层次结构图或树形图的根种类错误。 |
| <kind> 不能拥有 <kind>。请选择另一个父级。 | 放入的元素不适合该分解结构。 |
| <name> 没有动作定义。请拖入一个动作定义或一个新的 Action。 | IDEF0:步骤必须以动作定义为类型。 |
| <kind> 不能执行步骤。请选择一个部件。 | IDEF0:只有部件可以作为 Mechanism。 |
| 更改未应用。 | 该更改会使文本无效。其旁边的消息会指出问题。 |
限制
- 序列视图根据文本绘制组合片段(alt、opt、loop、par);请在文本中而不是在视图中添加和更改它们。
- 几何视图是二维的;不绘制三维几何。
- 状态机只能使用 SysML 引擎运行;请参阅仿真状态机。
- 分析图不会与其他 SysML v2 工具交换。
相关页面
SysML® 和 OMG® 是 Object Management Group, Inc. 在美国和其他国家/地区的注册商标。