Holarch

教师资料包 · v1.0

使用 Holarch 教学:教师资料包

面向一学期系统工程或 MBSE 课程的课程学习成果以及六项附评分标准的作业,全部基于 EO-1 开放 MBSE 参考模型 v1.1(一颗虚构的 6U 对地观测 CubeSat)构建。依据 CC BY 4.0 免费提供。

下载教师资料包 v1.0

全部文件(.zip,17 KB)

可在任何编辑器中打开的 Markdown 文件。使用 EO-1 参考模型 v1.1。许可:CC BY 4.0,署名“Holarch”。

本页内容
  1. 包含的内容
  2. 如何使用
  3. 答案说明
  4. 学习成果
    1. 与作业的对应关系
  5. A1 · 追溯一项需要
  6. A2 · 需求返工与评审
  7. A3 · 找出覆盖缺口
  8. A4 · 扩展架构
  9. A5 · 处理变更
  10. A6 · 确认计划
  11. 使用 Holarch 讲授 SysML v2:它检查什么,以及只保留什么
  12. 下载
  13. 版本
  14. 如何引用
  15. 许可

包含的内容

文件适用对象包含的内容
learning-outcomes.md教师、认证记录课程学习成果、评估每项成果的作业,以及所用的 Holarch 功能。
assignments/A1-trace-a-need.md 至 A6-validation-plan.md学生(分发)基于 EO-1 的六项作业,每项都包括背景、任务、提交内容和评分标准。
sysml-v2-teaching-boundaries.md教师Holarch 的 SysML v2 项目检查什么、保留但不解释什么,以及尚不提供什么。

如何使用

  1. 为每个小组提供一份独立的 EO-1 v1.1 副本。在 Holarch 中:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat EO-1,或从 holarch.app/reference-models/eo-1/ 下载 eo-1-v1.1.holarch.json,并通过 管理项目 → 项目文件 ▾ → 导入项目… 导入。每项作业都从发布状态的模型开始。
  2. 在课程组织中开设课程。在 组织设置 → 班级评审 → + 新建作业 中添加每项作业及其截止日期。班级评审会在每个截止日期保存每个小组项目的一个版本,并显示每位学生的作业。
  3. 对于 A2,以评审者身份加入每个小组项目:您可以评论、审批、拒绝和重新打开需求,除此之外不能执行其他操作。
  4. 对于 A6,学生从内置的验证和确认计划模板开始。如需提供附有您自己说明的精简版本,请将其另存为组织模板(编写 ▾ → 模板 ▸ 另存为模板…,保存到:组织),并将其设为测试计划文档的默认模板。
  5. 为您的课程设置权重、小组规模和截止日期。所给的权重仅为建议。

作业中提到了 Holarch 页面,但每个问题也都可以根据 EO-1 CSV 文件作答,因此使用其他工具的学生也可以参与。

答案说明

A1 至 A6 的答案说明(包括预期发现、参考答案和常见错误)不公开发布,因此学生无法下载答案。教师可在 Holarch 中下载:组织设置 → 班级评审 → 下载答案说明。该按钮向具有课程状态的组织的管理员(教师和助教)显示。

学习成果

课程:基于模型的系统工程,一学期,高年级本科或研究生一年级。

课程结束时,学生能够:

#成果评估方式使用的 Holarch 功能
LO1区分利益相关者需要与系统需求,并将每项需要追溯到将其形式化的需求。A1、期中Statement、traced to 关系、条目视图的追溯部分、可追溯性矩阵
LO2编写必要、单一、无歧义且可验证的需求,并附验证方法和成功标准。A2、期中需求属性、质量、TBD/TBR
LO3对需求执行评审和审批周期,并通过修改模型来响应评审意见。A2、参与评审评审者角色、审批(审批、拒绝…、重新打开)、带提及的评论
LO4分析可追溯性和验证覆盖率,并针对每个缺口判断是模型有误还是需求有误。A3可追溯性矩阵、RVTM、模型检查
LO5分解功能,定义逻辑架构,将功能分配给逻辑元素和物理元素,并推导由此产生的接口。A4、期末Action 图和 FFBD、Asset、分配、接口登记册
LO6通过模型评估需求变更的影响,并为每个受影响的条目记录一项决策。A5、期末待评审的关联、影响分析、变更请求、基线和版本
LO7规划验证和确认:区分两者、选择方法、用正确的术语编写测试和确认规程,并解读 RVTM。A6、期末测试用例和测试套件、测试中心、RVTM 和 VCRM、文档模板
LO8根据模型生成工程交付物并使其与模型保持一致:导出纳入基线的文档和矩阵以供评审。A2、A6、期末文档、实时矩阵、基线、Word 和 Excel 导出
LO9(可选)阅读和编写子系统的 SysML v2 文本表示法,并说明工具检查了哪些属性、哪些仅被保留。A6 的可选部分SysML v2 项目、编辑器的检查、SysML v2 教学说明

与作业的对应关系

成果A1 追溯一项需要A2 需求返工A3 覆盖缺口A4 架构A5 变更影响A6 确认计划
LO1●○○
LO2●○
LO3●
LO4○●○
LO5●
LO6●
LO7○○○●
LO8○●

● 主要评估的成果,○ 也有贡献。

给教师的说明

  • 这些成果描述的是系统工程能力,而不是工具技能。Holarch 是学生练习的场所;借助 EO-1 CSV 文件,学生不使用 Holarch 也能展示每项成果。
  • 这些成果遵循通行的系统工程实践,例如 ISO/IEC/IEEE 15288 的技术过程:利益相关者需要和需求定义、系统需求定义、架构定义、验证和确认。请按照您学校的要求,将其对应到您专业的认证标准。

A1 · 追溯一项需要

成果:LO1(主要)、LO4、LO7 · 小组规模:个人 · 建议权重:8%

背景

EO-1 的客户是一家农业分析公司,提出了三项需要。N2 Twice-Weekly Revisit 的内容是:“农场客户在生长季节需要每周至少两次获得其田地的最新图像。”只有当将某项需要形式化的需求被设计满足并经过验证,且该需要本身经客户确认后,这项需要才算得到满足。

任务

  1. 沿着 N2 在模型中追溯:它追溯到的需求、这些需求的子需求、满足每条需求的功能和组件,以及验证它们的测试用例,并注明每个测试的状态。
  2. 以表格或小图的形式画出这条链:每个条目一行或一个框,注明其编号、名称、状态以及连接它的关系。
  3. 找出 N2 的确认活动及其状态。
  4. 回答:在 N2 被视为已确认之前,还缺少哪些证据?列出每项缺失的内容、它所属的条目,以及如何补齐。
  5. 查找支持 N2 但未追溯到它的需求。指出一个候选需求,并论证是否应添加该追溯。不要将其添加到模型中。

在 Holarch 中:在条目视图中打开 N2 并阅读其追溯部分,然后使用验证 → 可追溯性矩阵、验证 → RVTM 和验证 → 测试中心。不使用 Holarch:eo-1-v1.1-traceability.csv 和 eo-1-v1.1-rvtm.csv。

提交内容

一份一到两页的说明(Word 或 PDF),包含这条链、缺失的证据以及对第 5 步的回答。本作业不要修改模型。

评分标准

标准4 优秀3 熟练2 发展中1 起步
链条完整且正确(40%)从 N2 到测试的每个条目,关系和状态正确,包括两个子需求和确认活动。有一个条目或状态缺失或有误。链条止于需求,或遗漏了一项子需求。列出了条目但没有关系。
缺失的证据(35%)指出每个缺口(未运行的测试、没有自身验证的父需求、尚未审批的需求、未运行的确认、没有功能的子需求)以及弥补每个缺口的方法。指出大部分缺口及其补齐方式。列出了缺口,但未说明如何补齐。只说了“缺少测试”。
验证与确认 (15 %)始终区分二者:需求被验证,需要被确认。有一处混淆。将通过的测试视为确认了需要。没有区分。
候选追溯(10%)给出一项具体需求,并附有合理的正反论证。给出候选需求,但论证单薄。给出候选需求,但没有论证。缺失。

A2 · 需求返工与评审

成果:LO2(主要)、LO3、LO8 · 小组规模:小组 · 建议权重:10%

背景

EO-1 有三项需求仍为草稿,在 Holarch 的质量检查中得分为 44%:

  • 2.5 Safe Mode Recovery(安全模式恢复):“The spacecraft should recover from safe mode quickly and resume imaging as appropriate”
  • 3.5 Battery Thermal Control(电池热控制):“The thermal design shall keep the battery warm enough (TBD).”
  • 6.4 Operator Interface(操作员界面):“The operator interface shall be user friendly and/or easy to use.”

3.5 还有一个未关闭的问题 ISS-3 Battery heater set point not chosen,以及设计评审委员会的一条评审意见 RID-1 No cold-case analysis for the battery heater。

任务

  1. 针对这三项需求,分别列出其薄弱之处,必要时逐词说明。
  2. 在小组项目中改写每条需求:一个“shall”、一个可度量的条件,在涉及时间或范围时说明起点或条件。将每个 TBD 替换为一个值并记录其理由,或保留 TBR 并指定负责人和日期。对于 3.5,说明您的改写如何回应 ISS-3 和 RID-1。
  3. 为每一项填写验证方法、验证级别和成功标准。
  4. 将每条需求追溯到其来源(需要、父需求或来源)以及满足它的功能。如果不存在相应功能,请指出缺少的功能。
  5. 将每条需求设为评审中。您的教师以评审者身份评审这些需求。在模型中回应每条评论(修改需求,或附理由回复),然后解决该评论。
  6. 保存文档 EO-1 System Requirements Specification (SRS-001) 的一个基线,命名为“A2 handed in”,并将其导出为 Word。

在 Holarch 中:需要与需求 → 质量、需求的属性面板、需要与需求 → 审批,以及文档中的 版本 ▾ → 保存基线… 和 交付 ▾ → 规格说明 (Word)。

提交内容

Word 导出文件,以及一份半页的说明,记述您在第 1 步中发现的缺陷。截止日期时的模型状态将一并评分。

评分标准

标准4 优秀3 熟练2 发展中1 起步
重写的需求(40%)三项需求均为单一、可测量且可验证;说明了条件和起点;数值有依据。有一项需求仍含模糊用语或缺少条件。添加了数值,但缺少条件或理由。措辞已修改,但仍不可验证。
验证属性(20%)方法、级别和成功准则与每条需求相符,并且可以按所写内容执行。有一处不匹配,例如只能进行 Analysis(分析)时选择了 Test(测试)。设置了方法,但成功标准模糊。缺失。
可追溯性(15%)每项都追溯到其来源和满足它的功能,或指出了缺少的功能。缺少一处追溯。仅有来源。没有。
评审周期(15%)每条评审意见都在模型中得到回应并已解决;被拒绝的需求已修改并重新提交。有一条评论未关闭。回应了评论但未修改模型。忽略了评论。
薄弱之处分析(10%)准确:指出每个模糊用语以及它为何无法验证。笼统但正确。只是复述质量得分。缺失。

A3 · 找出覆盖缺口

成果:LO4(主要)、LO1、LO2、LO7 · 小组规模:小组 · 建议权重:10%

背景

EO-1 正处于关键设计评审阶段。该模型有意不完美:有些需求没有满足它的功能,有些没有测试,有些测试失败,还有一个方程没有关联到任何内容。

任务

基于v1.1 发布状态的模型工作。如果您的小组项目已有改动,请使用一份新副本。

  1. 列出没有任何功能满足的每条需求。
  2. 列出没有任何测试用例验证的每条需求,以及测试失败的需求,并注明针对它们记录的未关闭问题和任何偏离。
  3. 列出没有满足组件的需求。判断其中哪些需要组件,哪些应当在任务级或分段级得到满足。
  4. 找出没有任何内容追溯到的模型条目。提示:查看功率方程。
  5. 对于每个缺口,判断:是模型缺少某些内容(功能、组件、测试、关联),还是该需求并不必要或写得不对?每个缺口用一句话说明理由。
  6. 在小组项目中弥补您选择的三个缺口,每个都作为一项可以在控制与评审 → 活动中指出的更改。

在 Holarch 中:验证 → 可追溯性矩阵、验证 → RVTM、验证 → 模型检查和风险、问题与决策 → 问题与行动。不使用 Holarch:eo-1-v1.1-traceability.csv(其覆盖率列)、eo-1-v1.1-rvtm.csv、eo-1-v1.1-issues-actions.csv 和 eo-1-v1.1-deviations-waivers.csv。

提交内容

一份缺口表(缺口、条目、决策、理由、是否已补齐),格式为 Excel 或 Word,以及您所做三项更改的列表。

评分标准

标准4 优秀3 熟练2 发展中1 起步
发现的缺口(35%)所有功能、测试、组件和孤立条目缺口,包括失败的测试及其问题和偏离。遗漏了一两个缺口。只找出了明显的草稿。不到一半。
决策(35%)每个缺口都有站得住脚的判断;能区分缺失的设计、不必要或范围不当的需求,以及在任务级得到满足的情况。大部分决策合理。将每个缺口都处理为“添加一个关联”。没有决策。
所做的更改(20%)三项更改确实补齐了缺口,每项在记录中都是一个清晰的步骤。两项良好的更改。更改掩盖了缺口,例如无理由地添加关联。没有。
呈现(10%)表格可排序且完整。有少量遗漏。难以理解。缺失。

A4 · 扩展架构

成果:LO5(主要)、LO4 · 小组规模:小组 · 建议权重:12%

背景

EO-1 的逻辑架构 (L0) 只涵盖电源和数据处理部分:L1 Power Generation 至 L6 Fault Management。每个逻辑元素对功能进行分组(allocated to),并由一个物理部件实现(related to);例如 F3.1 Convert Sunlight to Power 分配给 L1,而 1.3.1 Solar Arrays 实现 L1。姿态确定与控制有功能 F4.1 Estimate Attitude、F4.2 Compute Control Torques、F4.3 Drive Reaction Wheels 和 F4.4 Unload Wheel Momentum,以及 1.2 ADCS 下的物理部件,但没有逻辑层。

任务

  1. 在 L0 下添加用于姿态确定与控制的逻辑元素。每个元素说明其用途,但不指明硬件。
  2. 将 F4.1 至 F4.4 分配给这些逻辑元素,并按照 L1 至 L6 的模式,将每个逻辑元素与 1.2 ADCS 下实现它的物理部件建立关系。
  3. 如果小组项目中还没有 F4 的 Action 图,则绘制一张,包含在其子功能之间流动的项,例如姿态估计值和力矩指令。
  4. 根据跨越元素边界的流推导接口。将其与现有接口 IF-06、IF-16、IF-17 和 IF-18 进行比较:哪些匹配,哪些缺失,哪些承载了没有功能使用的项?
  5. 检查 2.1 至 2.4 是否各自由执行相应工作的功能满足,并说明随后由哪个逻辑元素负责每项需求。

在 Holarch 中:架构 → 资产、行为 → Action 图 (F4)、属性面板中用于分配的追溯部分、接口 → 接口登记册,以及层次结构图的分配层次结构预设。不使用 Holarch:eo-1-v1.1-allocation-chain.csv 和 eo-1-v1.1-icd.csv。

提交内容

一份简短的架构描述(两到三页,Word 或 PDF):逻辑元素及其用途、分配表(功能 → 逻辑元素 → 物理部件)、F4 Action 图以及接口比较。

评分标准

标准4 优秀3 熟练2 发展中1 起步
逻辑元素(25%)与解决方案无关、内聚,每个都有明确的用途;不含硬件名称。有一个元素指明了硬件或混合了多种用途。元素照搬了物理部件。缺失或不清楚。
分配(30%)每个子功能都恰好一次分配给正确的元素;元素由部件实现;在模型中保持一致。有一项分配存疑。仅分配给部件,跳过了逻辑层。不完整。
流与接口(30%)接口由跨越边界的流导出;与 IF-06、IF-16、IF-17 和 IF-18 进行了精确比较,包括双向的缺口。比较基本正确。列出了接口,但不是推导出来的。缺失。
需求责任(15%)2.1 至 2.4 中的每一条都经由其功能追溯到逻辑元素,并指出了不一致之处。缺少一项。列出了但未检查。缺失。

A5 · 处理变更

成果:LO6(主要)、LO7 · 小组规模:小组 · 建议权重:10%

背景

设计评审后,需求 3.1 Orbit Average Power 从寿命末期轨道平均功率 28 W 改为 30 W。测试用例 TC-06 Solar Array Power Test 是按旧值通过的。Holarch 将 3.1 的关联标记为待评审。

任务

  1. 列出该变更涉及的每个条目:沿 3.1 的关联向前,向后追溯到 3.1 派生自的内容,以及提到旧值但未与 3.1 关联的条目。说明每个条目是如何找到的。
  2. 对于每个条目,写出此变更引发的问题、您的发现(模型中有数值时附上数值)以及决定:不更改(将关联标记为已评审并附评论)、更新,或上报变更委员会。
  3. 决定如何处理 TC-06:在 28 W 时通过的测试还能证明 30 W 吗?根据模型中的方程列出计算过程。
  4. 找出一个基于关联的分析遗漏的条目,并说明其重要性。
  5. 在小组项目中记录您的决定:对每个标记为已评审的关联添加评论,为需要委员会决定的事项创建变更请求,并在前后各保存一个基线。

在 Holarch 中:需要与需求 → 待审查的关联、从 3.1 出发的影响分析(打开方式 ▾ → Spider,然后选择影响)、属性面板的追溯部分、功率方程 EQ-1.1 至 EQ-1.4 和 TPM-2(架构 → 预算和 TPM)、控制与评审 → 变更请求以及控制与评审 → 基线和版本。不使用 Holarch:eo-1-v1.1-traceability.csv 和已发布的影响记录 eo-1-v1.1-change-impact-3.1.csv;请先自行分析,再进行比较。

提交内容

一份影响记录(表格:条目、到达方式、问题、发现、决定、状态)以及一段给变更委员会的建议。

评分标准

标准4 优秀3 熟练2 发展中1 起步
涉及范围(30%)找出了向前、向后和通过文本搜索得到的条目,包括没有关联可达的条目。仅有关联,但全部找到。部分向前关联。仅有 3.1 和 TC-06。
附数值的发现(30%)使用模型中的值和方程;计算并解释了 TC-06 的不足。数值基本正确。仅为定性分析。结论错误。
决策(25%)每个条目都有与发现相符的决策;仅在有理由时才将关联标记为已检查;委员会事项单独处理。有一项决策薄弱。将关联标记为已评审但未给出理由。没有决策。
在模型中的记录(15%)评论、变更请求和基线均已就位,并与记录一致。缺少一项。只有文档。模型中没有任何记录。

A6 · 确认计划

成果:LO7(主要)、LO8、LO1 · 小组规模:小组 · 建议权重:10 %

背景

验证问的是 EO-1 是否按照其需求被正确地构建;确认问的是它是否是适合农场客户的正确系统。EO-1 的确认套件 TS-3 Mission Validation 包含 VAL-01 Customer Alert Pilot(针对 N1,未运行)、VAL-02 Growing Season Revisit Simulation(针对 N2,未运行)和 VAL-03 Agronomist Map Review(针对 N3,已通过)。

在 需要与需求 → 文档 → + 新建文档 中开始编写计划。在模板下,将模板适用于设为测试计划文档,并选择勾选了包括编写指南的内置验证和确认计划,或选择您的教师为此作业发布的组织模板。

任务

  1. 5.1 Operational Scenarios(运行场景):用客户的语言编写 VAL-01 的场景:谁在哪一天做了什么,得到什么结果。指出它所检验的需要。
  2. 5.2 用户和参与者:列出有代表性的用户以及每个人所作的决定。
  3. 5.3 Validation Environment(确认环境):描述环境、它与实际运行有何不同,以及这种差异对结果意味着什么。
  4. 编写 VAL-01 的验收准则,使客户无需工程判断即可回答是或否,并将其记录在测试用例的预期结果中。
  5. 8 验证状态:阅读实时矩阵。选择失败的测试 TC-04 Pointing Accuracy Test,说明如果在试点时 TC-04 仍然失败,VAL-01 的结果意味着什么。
  6. 将计划导出为 Word。

可选:SysML v2 加分项(LO9,最多额外 10 %)

从 eo-1-v1.1-power-subsystem.sysml 创建一个 SysML v2 项目(管理项目 → 项目文件 ▾ → 导入 SysML v2 文件…)。该文件中的需求 3.1 仍为 28 W。将所需的轨道平均功率改为 30 W(即 A5 中的变更),并查看编辑器报告的内容。这是建模错误还是设计发现?然后修改设计值而不是需求,直到编辑器的状态行显示无问题,并说明您的新值在物理上是否可信。用半页篇幅说明您的哪些主张经过了工具检查、哪些只是被保留;您的教师分享的 SysML v2 教学说明列出了这两类内容。

提交内容

  • 计划的 Word 导出文件。
  • SysML v2 加分项:.sysml 文件和半页说明。

评分标准

标准4 优秀3 熟练2 发展中1 起步
以客户术语描述的场景 (30 %)具体、贴近日常、不含工程术语;明确地检验 N1。清楚,但有一些术语。是测试规程,而不是场景。缺失或泛泛而谈。
验收准则(25%)可观察、可回答是或否、由客户负责;与 N1 的“在过境当天”相关联。大部分可观察。仅有工程阈值。模糊。
参与者与环境(20%)指出了代表性用户及其决定;说明了与实际运行的差异及其影响。缺少一项。列出但没有说明影响。缺失。
V&V 推理 (15 %)解释为什么确认试点可以独立于 TC-04 而成功或失败,以及每种结果意味着什么。基本合理。混淆了验证与确认。缺失。
交付物(10%)Word 导出整洁,模板中的指南已替换为内容。残留指南文本。仅部分导出。缺失。
SysML v2 加分项(最多 +10 %)解释了发现;无问题,且数值可信;准确说明了哪些内容经过检查、哪些只是被保留。无问题;说明较笼统。削弱了需求而不是修改设计,或仍有问题未解决。不得分。

使用 Holarch 讲授 SysML v2:它检查什么,以及只保留什么

Holarch 的 SysML v2 项目支持 OMG SysML v2 规范的一个子集。各领域的当前状态见 SysML v2 语言覆盖范围页面(holarch.app/sysml-v2-coverage/);请在每学期开始前查看。使用 Holarch 讲授该语言时,请区分三类陈述,以免学生把工具的限制当作语言规则来学,或把工具只是保留的构造误认为已检查的构造:

  • 已检查:编辑器解析该构造并在输入时对其进行检查,视图和页面会使用它。当编辑器的状态行显示无问题时,这些检查已通过。
  • 保留但不解释:按书写原样解析并保留在文本和导出中,但不赋予其含义。无问题并不说明它是否正确。
  • Holarch 中尚未提供:该构造或功能在 Holarch 中不可用。它仍然是有效的 SysML v2。

已检查:可以放心地用该工具讲授和评估

领域学生可以依靠编辑器发现的问题
语法字符、注释、字符串、花括号、;、预期的名称和令牌。
名称和导入未解析、有歧义、重复和私有的名称;成员导入、命名空间导入、递归导入和带筛选的导入。
定义、用法、特化part、attribute、port、action、state、requirement 及其他类型及其定义;类型化、子集化、重定义和共轭;循环和错误的定义类型。
多重性、值和单位有效的界限;采用 ISQ 量种类以及 SI 和美国惯用单位的量;量纲检查:在需要质量的地方出现功率会报错。
约束和计算操作数类型、计算参数、布尔条件,以及计算求值:对于当前值不成立的约束、需求和目标会被报告。
结构连接端;端口、流和消息的方向;接口和绑定连接器。
动作和状态后继目标、控制节点、for 循环遍历的值、初始转换、并行区域、转换触发器和 do 效果。
需求和用例subject、actor、stakeholder、require 和 assume constraint,以及位置正确的 satisfy、verify 和 frame 目标。
分配allocate … to …、分配定义、依赖关系。
可变性变体点只拥有其同类的变体,选择是其变体点的一个变体,并会对选择的值进行计算。
个体、快照和时间切片每个都具有其所属事件的特性;先读取其自身的值。

部分检查:讲授时说明限制

领域已检查或可运行需要向学生说明的限制
动作仿真器可运行动作流程,包括蒙特卡洛运行。步骤持续时间、分支概率和循环次数是保存在 Holarch 中而非文本中的仿真器设置,因此 .sysml 导出不包含它们。
状态仿真器可通过激励运行状态机,并显示活动状态。同上:仿真器设置不属于文本的一部分。
分析用例和验证用例主体、目标、返回结果;verify 和判定。只有当每个输入都有值时才会对分析用例求值;没有求解器。在 Parametric View 中,“求解”为每个约束求出一个未知数。标准库中的权衡研究分析不会被求值。
视图view、view def、expose、筛选器、视点和标准视图定义;Sequence View 可绘制 alt、opt、loop 和 par 片段。布局属于 Holarch,而不属于模型。
可变性变体点、变体和配置会被检查和求值。Holarch 尚不能搜索或列出所有有效组合。
元数据和关键字@Name、#Name、metadata … about、来自语义元数据的用户定义关键字。其他用户定义的元数据除其值之外没有任何含义;用 about 编写的元数据不会添加基类型。
文本表示SysML 和 KerML 中的 rep … language 主体会被检查,SysML 约束主体会被求值。其他语言(例如 Python、OCL 或 MATLAB)的主体以文本形式保留,从不运行。
SysML v2 JSON 交换导入和导出 Systems Modeling API 元素格式,并保留元素 id。Holarch 不解释的元素类型按导入时的原样保留并原样写回;它们没有文本,也无法编辑。

保留但不解释:在这里“无问题”什么也证明不了

  • SysML 和 KerML 以外语言的文本表示主体。
  • 语义元数据以外的用户定义元数据的值。
  • doc 文本和注释:从不与模型进行比较。在 EO-1 电源子系统中,将需求 3.1 改为 30 W 后,其 doc 仍写着 28 W,且不会报告任何问题。这是一个很好的练习。
  • 导入的 SysML v2 JSON 文件中 Holarch 不解释的元素类型。

反过来也同样重要:需求状态、验证结果和标签是 Holarch 数据。它们不在文本中,也不在 .sysml 导出中。

Holarch 中尚未提供

  • .kerml 文件:不能导入,以 KerML 编写的模型也不会被检查。KerML 仅用于读取标准库。
  • 用户定义关键字以外的语言扩展;标准库无法编辑。
  • 分析用例的求解器,以及在 Holarch 页面中搜索有效变体组合的功能。
  • 通过 Systems Modeling API 向 main 提交、标签和合并:其他工具会提交到变更请求分支,再由审批人在 Holarch 中应用。

如何在课程中使用

  • 只对已检查的领域说“工具已检查”。例如,无问题表示单位一致,且需求对于当前值成立。它并不表示 doc 文本与值一致,也不表示 Python 主体是正确的。
  • 通过阅读来评估被保留的构造。通过检查而不是问题计数为其评分。
  • 行为在仿真器中运行,包括动作流程和状态机。仿真器使用的持续时间和概率是 Holarch 设置:如果学生只提交 .sysml 文件,请同时要求提交这些设置。
  • 语言规则来自规范,而不是来自任何工具。对于 Holarch 尚未实现的内容,请说“Holarch 中尚未提供”,而不是“不允许”。
  • A6 加分项以本说明为基础:学生在 EO-1 电源子系统中将 3.1 改为 30 W,看到求值检查报告该问题,修正设计,并写下哪些内容经过了检查、哪些只是被保留。

下载

资料包是一个 zip 文件。文件名中带有版本号,因此课程可以准确指向所用的副本。作业所用的 CSV 和项目文件是 EO-1 页面上的 EO-1 参考模型 v1.1 下载文件。

文件包含的内容
teaching-with-holarch-v1.0.zip以下所有文件,放在一个文件夹中。
README.txt内容、资料包的使用方法、许可声明和变更历史。
LICENSE.txt许可声明。
learning-outcomes.md课程学习成果及其与作业的对应关系。
assignments/A1-trace-a-need.mdA1 追溯一项需要。
assignments/A2-requirements-rework.mdA2 修改和评审需求。
assignments/A3-coverage-gaps.mdA3 找出覆盖缺口。
assignments/A4-extend-the-architecture.mdA4 扩展架构。
assignments/A5-work-the-change.mdA5 处理变更。
assignments/A6-validation-plan.mdA6 确认计划。
sysml-v2-teaching-boundaries.md使用 Holarch 讲授 SysML v2:它检查什么,以及只保留什么。

答案说明不在 zip 文件中;请参阅答案说明。

版本

这是使用 Holarch 教学教师资料包 v1.0,为 EO-1 参考模型 v1.1 编写。新版本会使用新的文件名;早期版本仍可在原地址获取。

  • v1.0:首次发布:课程学习成果以及附评分标准的作业 A1 至 A6,适用于 EO-1 参考模型 v1.1。

如何引用

请引用您使用的版本:

Holarch. Teaching with Holarch: instructor package, version 1.0. https://holarch.app/academic/instructor-package/. Licensed under CC BY 4.0.

许可

教师资料包文件依据知识共享署名 4.0 国际许可协议 (CC BY 4.0) 授权。只要您给予适当署名、提供许可证链接并说明是否作了修改,就可以出于任何目的(包括商业目的)复制、共享和改编这些文件。署名:“Teaching with Holarch instructor package v1.0, Holarch, CC BY 4.0”。每个下载都附带此声明。

EO-1 参考模型保留其自身的署名行:“EO-1 Reference Model v1.1, Holarch, CC BY 4.0”。EO-1 中的所有名称、人员和结果均为虚构。

该许可证仅涵盖资料包文件。答案说明不属于资料包,Holarch 软件也不在许可证涵盖范围内。

由 Holarch发布