教师资料包 · v1.0
使用 Holarch 教学:教师资料包
面向一学期系统工程或 MBSE 课程的课程学习成果以及六项附评分标准的作业,全部基于 EO-1 开放 MBSE 参考模型 v1.1(一颗虚构的 6U 对地观测 CubeSat)构建。依据 CC BY 4.0 免费提供。
本页内容
包含的内容
| 文件 | 适用对象 | 包含的内容 |
|---|---|---|
learning-outcomes.md | 教师、认证记录 | 课程学习成果、评估每项成果的作业,以及所用的 Holarch 功能。 |
assignments/A1-trace-a-need.md 至 A6-validation-plan.md | 学生(分发) | 基于 EO-1 的六项作业,每项都包括背景、任务、提交内容和评分标准。 |
sysml-v2-teaching-boundaries.md | 教师 | Holarch 的 SysML v2 项目检查什么、保留但不解释什么,以及尚不提供什么。 |
如何使用
- 为每个小组提供一份独立的 EO-1 v1.1 副本。在 Holarch 中:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat EO-1,或从 holarch.app/reference-models/eo-1/ 下载
eo-1-v1.1.holarch.json,并通过 管理项目 → 项目文件 ▾ → 导入项目… 导入。每项作业都从发布状态的模型开始。 - 在课程组织中开设课程。在 组织设置 → 班级评审 → + 新建作业 中添加每项作业及其截止日期。班级评审会在每个截止日期保存每个小组项目的一个版本,并显示每位学生的作业。
- 对于 A2,以评审者身份加入每个小组项目:您可以评论、审批、拒绝和重新打开需求,除此之外不能执行其他操作。
- 对于 A6,学生从内置的验证和确认计划模板开始。如需提供附有您自己说明的精简版本,请将其另存为组织模板(编写 ▾ → 模板 ▸ 另存为模板…,保存到:组织),并将其设为测试计划文档的默认模板。
- 为您的课程设置权重、小组规模和截止日期。所给的权重仅为建议。
作业中提到了 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 的内容是:“农场客户在生长季节需要每周至少两次获得其田地的最新图像。”只有当将某项需要形式化的需求被设计满足并经过验证,且该需要本身经客户确认后,这项需要才算得到满足。
任务
- 沿着 N2 在模型中追溯:它追溯到的需求、这些需求的子需求、满足每条需求的功能和组件,以及验证它们的测试用例,并注明每个测试的状态。
- 以表格或小图的形式画出这条链:每个条目一行或一个框,注明其编号、名称、状态以及连接它的关系。
- 找出 N2 的确认活动及其状态。
- 回答:在 N2 被视为已确认之前,还缺少哪些证据?列出每项缺失的内容、它所属的条目,以及如何补齐。
- 查找支持 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。
任务
- 针对这三项需求,分别列出其薄弱之处,必要时逐词说明。
- 在小组项目中改写每条需求:一个“shall”、一个可度量的条件,在涉及时间或范围时说明起点或条件。将每个 TBD 替换为一个值并记录其理由,或保留 TBR 并指定负责人和日期。对于 3.5,说明您的改写如何回应 ISS-3 和 RID-1。
- 为每一项填写验证方法、验证级别和成功标准。
- 将每条需求追溯到其来源(需要、父需求或来源)以及满足它的功能。如果不存在相应功能,请指出缺少的功能。
- 将每条需求设为评审中。您的教师以评审者身份评审这些需求。在模型中回应每条评论(修改需求,或附理由回复),然后解决该评论。
- 保存文档 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 发布状态的模型工作。如果您的小组项目已有改动,请使用一份新副本。
- 列出没有任何功能满足的每条需求。
- 列出没有任何测试用例验证的每条需求,以及测试失败的需求,并注明针对它们记录的未关闭问题和任何偏离。
- 列出没有满足组件的需求。判断其中哪些需要组件,哪些应当在任务级或分段级得到满足。
- 找出没有任何内容追溯到的模型条目。提示:查看功率方程。
- 对于每个缺口,判断:是模型缺少某些内容(功能、组件、测试、关联),还是该需求并不必要或写得不对?每个缺口用一句话说明理由。
- 在小组项目中弥补您选择的三个缺口,每个都作为一项可以在控制与评审 → 活动中指出的更改。
在 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 下的物理部件,但没有逻辑层。
任务
- 在 L0 下添加用于姿态确定与控制的逻辑元素。每个元素说明其用途,但不指明硬件。
- 将 F4.1 至 F4.4 分配给这些逻辑元素,并按照 L1 至 L6 的模式,将每个逻辑元素与 1.2 ADCS 下实现它的物理部件建立关系。
- 如果小组项目中还没有 F4 的 Action 图,则绘制一张,包含在其子功能之间流动的项,例如姿态估计值和力矩指令。
- 根据跨越元素边界的流推导接口。将其与现有接口 IF-06、IF-16、IF-17 和 IF-18 进行比较:哪些匹配,哪些缺失,哪些承载了没有功能使用的项?
- 检查 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 的关联标记为待评审。
任务
- 列出该变更涉及的每个条目:沿 3.1 的关联向前,向后追溯到 3.1 派生自的内容,以及提到旧值但未与 3.1 关联的条目。说明每个条目是如何找到的。
- 对于每个条目,写出此变更引发的问题、您的发现(模型中有数值时附上数值)以及决定:不更改(将关联标记为已评审并附评论)、更新,或上报变更委员会。
- 决定如何处理 TC-06:在 28 W 时通过的测试还能证明 30 W 吗?根据模型中的方程列出计算过程。
- 找出一个基于关联的分析遗漏的条目,并说明其重要性。
- 在小组项目中记录您的决定:对每个标记为已评审的关联添加评论,为需要委员会决定的事项创建变更请求,并在前后各保存一个基线。
在 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,已通过)。
在 需要与需求 → 文档 → + 新建文档 中开始编写计划。在模板下,将模板适用于设为测试计划文档,并选择勾选了包括编写指南的内置验证和确认计划,或选择您的教师为此作业发布的组织模板。
任务
- 5.1 Operational Scenarios(运行场景):用客户的语言编写 VAL-01 的场景:谁在哪一天做了什么,得到什么结果。指出它所检验的需要。
- 5.2 用户和参与者:列出有代表性的用户以及每个人所作的决定。
- 5.3 Validation Environment(确认环境):描述环境、它与实际运行有何不同,以及这种差异对结果意味着什么。
- 编写 VAL-01 的验收准则,使客户无需工程判断即可回答是或否,并将其记录在测试用例的预期结果中。
- 8 验证状态:阅读实时矩阵。选择失败的测试 TC-04 Pointing Accuracy Test,说明如果在试点时 TC-04 仍然失败,VAL-01 的结果意味着什么。
- 将计划导出为 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.md | A1 追溯一项需要。 |
assignments/A2-requirements-rework.md | A2 修改和评审需求。 |
assignments/A3-coverage-gaps.md | A3 找出覆盖缺口。 |
assignments/A4-extend-the-architecture.md | A4 扩展架构。 |
assignments/A5-work-the-change.md | A5 处理变更。 |
assignments/A6-validation-plan.md | A6 确认计划。 |
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 软件也不在许可证涵盖范围内。