教師套件 · v1.0
用 Holarch 教學:教師套件
適用於一學期系統工程或 MBSE 課程的課程學習成果與六項附評分量表的作業,全部以 EO-1 Open MBSE Reference Model v1.1(一顆虛構的 6U 地球觀測 CubeSat)為基礎。依 CC BY 4.0 免費提供。
下載教師套件 v1.0
可用任何編輯器開啟的 Markdown 檔案。使用 EO-1 Reference Model v1.1。授權:CC BY 4.0,署名「Holarch」。
本頁內容
內容
| 檔案 | 對象 | 內容 |
|---|---|---|
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 中:Manage Projects → Project Files ▾ → New Demo Project → CubeSat EO-1,或從 holarch.app/reference-models/eo-1/ 下載
eo-1-v1.1.holarch.json,再以 Manage Projects → Project Files ▾ → Import Project… 匯入。每項作業都從出廠狀態的模型開始。 - 在課程組織中進行課程。在 Organization Settings → Class Review → + New Assignment 之下新增每項作業及其到期日。Class Review 會在每個到期日保留每個小組專案的一個版本,並顯示每位學生的作業。
- A2 請以 審查者 身分加入每個小組專案:您可以對需求留言、核准、駁回與重新開啟,除此之外無法進行其他操作。
- A6 的學生從內建的 Verification and Validation Plan 範本開始。若要提供附您自己說明的精簡版本,請將其儲存為組織範本(Write ▾ → Templates ▸ Save as Template…,Save to: Organization),並設為 Test Plan Document 的預設範本。
- 依您的課程設定權重、分組人數與到期日。所列權重僅供參考。
作業中提到 Holarch 的頁面,但每個問題也都能用 EO-1 CSV 檔案回答,因此使用其他工具的學生也能參與。
解答說明
含 A1 到 A6 預期發現、範例答案與常見錯誤的解答說明不公開,因此學生無法下載答案。教師在 Holarch 中下載:Organization Settings → Class Review → Download Solution Notes。此按鈕會對具課程身分組織的組織管理員(教師與助教)顯示。
學習成果
課程:Model-Based Systems Engineering,一學期,大學高年級或研究所一年級。
課程結束時,學生能夠:
| # | 成果 | 評量方式 | 使用的 Holarch 功能 |
|---|---|---|---|
| LO1 | 區分利害關係人需要與系統需求,並將每項需要追溯到將其形式化的需求。 | A1、期中考 | Statement、traced to 關係、Item View 的 Trace 區段、Traceability Matrix |
| LO2 | 撰寫必要、單一、明確且可驗證的需求,並附驗證方法與成功準則。 | A2、期中考 | 需求屬性、Quality、TBD/TBR |
| LO3 | 對需求執行審查與核准循環,並以模型變更回應審查留言。 | A2、審查參與 | Reviewer 角色、Approvals(Approve、Reject…、Reopen)、含提及的留言 |
| LO4 | 分析可追溯性與驗證涵蓋範圍,並針對每個缺口判斷錯的是模型還是需求。 | A3 | Traceability Matrix、RVTM、Model Checks |
| LO5 | 分解功能、定義邏輯架構、將功能配置到邏輯與實體元素,並推導出隨之而來的介面。 | A4、期末 | Action 圖與 FFBD、Asset、配置、Interface Register |
| LO6 | 透過模型評估需求變更的影響,並為每個受影響的項目記錄決策。 | A5、期末 | Links to Review、影響分析、Change Requests、Baselines & Versions |
| LO7 | 規劃驗證與確認:區分兩者、選擇方法、以正確的用語撰寫測試與確認程序,並解讀 RVTM。 | A6、期末 | 測試案例與測試套件、Test Center、RVTM 與 VCRM、文件範本 |
| LO8 | 從模型產出工程交付物並維持與模型一致:建立基準線的文件,以及匯出供審查的矩陣。 | A2、A6、期末 | 文件、即時矩陣、基準線、Word 與 Excel 匯出 |
| LO9(選做) | 閱讀並撰寫子系統的 SysML v2 文字表示法,並說明工具檢查了哪些性質、哪些只是保留。 | A6 的選做部分 | SysML v2 專案、Editor 的檢查、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 中:在 Item View 中開啟 N2 並閱讀其 追溯 區段,接著使用 Verification → Traceability Matrix、Verification → RVTM 與 Verification → Test Center。不使用 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。
- 為每一項填入 Verification Method、驗證等級 與 成功準則。
- 將每一項追溯到其來源(一項需要、上層需求或來源),以及滿足它的功能。若沒有這樣的功能,請指出缺少的功能。
- 將每一項設為 In Review。教師以 Reviewer 身分審查。在模型中回應每則留言(修改需求,或回覆理由),然後將留言標記為已解決。
- 儲存文件 EO-1 System Requirements Specification(SRS-001)的基準線,命名為「A2 handed in」,並匯出為 Word。
在 Holarch 中:Needs & Requirements → Quality、需求的屬性面板、Needs & Requirements → Approvals,以及文件中的 Version ▾ → Save Baseline… 與 Deliver ▾ → Specification (Word)。
繳交內容
Word 匯出檔,另加半頁說明您在步驟 1 找到的弱點。到期日當時的模型也一併評分。
評分量表
| 準則 | 4 優秀 | 3 精熟 | 2 發展中 | 1 起步 |
|---|---|---|---|---|
| 改寫後的需求(40 %) | 三項都單一、可量測且可驗證;已註明條件與起點;數值有依據。 | 有一項需求仍含模糊用語或缺少條件。 | 已加入數值,但缺少條件或理由。 | 改了措辭,但仍無法驗證。 |
| 驗證屬性(20 %) | 方法、層級與成功準則符合每項需求,且能照所寫內容執行。 | 一處不符,例如只能用 Analysis 卻選了 Test。 | 已設定方法,但成功準則模糊。 | 未提出。 |
| 可追溯性(15 %) | 每項都追溯到其來源與滿足它的功能,或指出缺少的功能。 | 缺少一個追溯。 | 只有來源。 | 沒有。 |
| 審查循環(15 %) | 每則審查留言都在模型中回應並已解決;被駁回的需求已修訂並重新提交。 | 有一則留言仍未解決。 | 回應了留言,但未修改模型。 | 忽略留言。 |
| 弱點分析(10 %) | 精確:指出每個模糊用語以及它為何無法驗證。 | 籠統但正確。 | 只是重述品質分數。 | 未提出。 |
A3 · 找出涵蓋缺口
成果:LO4(主要)、LO1、LO2、LO7 · 分組人數:小組 · 建議權重:10 %
背景
EO-1 正處於關鍵設計審查階段。模型刻意不完美:有些需求沒有滿足它的功能,有些沒有測試,有些測試失敗,還有一個方程式沒有連結到任何項目。
任務
從 v1.1 出廠狀態 的模型開始作業。若小組專案已有變更,請使用新的副本。
- 列出 沒有任何功能滿足 的每項需求。
- 列出 沒有任何測試案例驗證 的每項需求,以及測試 失敗 的需求,並附上針對它們記錄的未結問題與偏離。
- 列出 沒有滿足元件 的需求。判斷其中哪些需要元件,哪些在任務或區段層級滿足才是正確的。
- 找出 沒有任何項目追溯到 的模型項目。提示:看看電力方程式。
- 針對每個缺口判斷:是模型缺少了某些內容(功能、元件、測試、關聯),還是 需求不必要或寫錯了?每個缺口用一句話說明理由。
- 在小組專案中補足您選擇的三個缺口,每個缺口都是一項可在 Control & Reviews → Activity 中指出的變更。
在 Holarch 中:Verification → Traceability Matrix、Verification → RVTM、Verification → Model Checks 與 Risks, Issues & Decisions → Issues & Actions。不使用 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 中:Architecture → Assets、Behavior → Action Diagrams(F4)、屬性面板中用於配置的 追溯 區段、Interfaces → Interface Register,以及階層圖的 配置階層 預設集。不使用 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 中:Needs & Requirements → Links to Review、從 3.1 進行的影響分析(Open in ▾ → Spider,然後 影響)、屬性面板的 追溯 區段、電力方程式 EQ-1.1 到 EQ-1.4 與 TPM-2(Architecture → Budgets & TPMs)、Control & Reviews → Change Requests 與 Control & Reviews → Baselines & Versions。不使用 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,已通過)。
在 Needs & Requirements → Documents → + New Document 中開始撰寫計畫。在 範本 之下,將 範本適用於 設為 Test Plan Document,並選擇內建的 Verification and Validation Plan 且勾選 包含撰寫指引,或選擇教師為本作業發布的組織範本。
任務
- 5.1 Operational Scenarios:以客戶的用語撰寫 VAL-01 的情境:誰在哪一天做什麼,得到什麼結果。指出它所檢驗的需要。
- 5.2 Users and Participants:列出代表性使用者,以及每個人要做的決定。
- 5.3 Validation Environment:描述環境、它與實際運作的差異,以及這項差異對結果的意義。
- 撰寫 VAL-01 的 允收準則,讓客戶不需工程判斷就能回答是或否,並記錄在測試案例的 預期結果 中。
- 8 Verification Status:閱讀即時矩陣。挑出失敗的測試 TC-04 Pointing Accuracy Test,並說明若試行時 TC-04 仍為失敗,VAL-01 的結果代表什麼。
- 將計畫匯出為 Word。
選做:SysML v2 加分題(LO9,最多額外 10 %)
從 eo-1-v1.1-power-subsystem.sysml 建立 SysML v2 專案(Manage Projects → Project Files ▾ → Import SysML v2 Files…)。這個檔案中的需求 3.1 仍是 28 W。將所需的軌道平均功率改為 30 W(即 A5 中的變更),並閱讀 Editor 的回報。這是建模錯誤,還是設計上的發現?接著修改設計數值而非需求,直到 Editor 的狀態列顯示 無問題,並說明您的新數值在物理上是否可信。以半頁說明您的主張中,哪些經過工具檢查、哪些只是被保留;教師提供的 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 %) | 說明了發現;以可信的數值達到 No problems;精確說明哪些經過檢查、哪些被保留。 | No problems;說明較籠統。 | 放寬了需求而非修改設計,或仍有問題。 | 不給分。 |
用 Holarch 教授 SysML v2:它檢查什麼、只保留什麼
Holarch 的 SysML v2 專案支援 OMG SysML v2 規格的一個子集。各領域的目前狀態列在 SysML v2 語言涵蓋範圍頁面(holarch.app/sysml-v2-coverage/);每學期開始前請先查看。用 Holarch 教授這個語言時,請區分三種陳述,讓學生既不會把工具限制當成語言規則,也不會把工具只保留的構造誤認為已檢查:
- 已檢查:Editor 會剖析這個構造並在您輸入時檢查,檢視與頁面也會使用它。當 Editor 的狀態列顯示 No problems 時,表示這些檢查已通過。
- 保留,不解讀:會被剖析並完全依照所寫內容保留(包括文字與匯出),但不賦予任何意義。No problems 並不代表它正確。
- Holarch 尚未支援:Holarch 尚未提供這個構造或功能,但它仍是有效的 SysML v2。
已檢查:可放心用工具教學與評量
| 領域 | 學生可依賴 Editor 抓出的問題 |
|---|---|
| 語法 | 字元、註解、字串、大括號、;、預期的名稱與語彙單元。 |
| 名稱與匯入 | 無法解析、模稜兩可、重複與私有的名稱;成員、命名空間、遞迴與篩選匯入。 |
| 定義、使用、特化 | part、attribute、port、action、state、requirement 及其他種類與其定義;型別、子集、重新定義與共軛;循環以及錯誤種類的定義。 |
| 多重性、數值與單位 | 有效的界限;使用 ISQ 量種類以及 SI 與美制單位的量;因次檢查:在預期質量處出現功率會被視為錯誤。 |
| 約束與計算 | 運算元型別、計算引數、布林條件,以及 求值:對目前數值不成立的約束、需求與目標會被回報。 |
| 結構 | 連接端點;埠、流與訊息的方向;介面與繫結連接器。 |
| 動作與狀態 | 接續目標、控制節點、for 迴圈所迭代的值、初始轉換、平行區域、轉換觸發與 do 效果。 |
| 需求與使用案例 | subject、actor、stakeholder、require 與 assume constraint、satisfy、verify 與 frame 目標位於正確位置。 |
| 配置 | allocate … to …、配置定義、相依性。 |
| 變異性 | 變異只擁有同種類的變體,選擇必須是其變異點的變體,且選擇的值會被求值。 |
| 個體、快照與時間切片 | 每個都具有其所屬事件的特徵;會先讀取它自己的值。 |
部分檢查:教學時需說明限制
| 領域 | 已檢查或可執行 | 需告知學生的限制 |
|---|---|---|
| 動作 | Simulator 可執行動作流,包括 Monte Carlo 執行。 | 步驟持續時間、分支機率與迴圈次數是保存在 Holarch 中的 Simulator 設定,不在文字中,因此 .sysml 匯出不會包含它們。 |
| 狀態 | Simulator 以刺激執行狀態機,並顯示作用中的狀態。 | 同上:Simulator 設定不屬於文字的一部分。 |
| 分析與驗證案例 | 主體、目標、回傳結果;verify 與判定結果。 | 分析案例只有在每個輸入都有值時才會求值;沒有求解器。在 Parametric View 中,Solve 每個約束只求一個未知數。標準庫中的權衡研究分析不會求值。 |
| 檢視 | view、view def、expose、篩選、觀點與標準檢視定義;Sequence View 可繪製 alt、opt、loop 與 par 片段。 | 版面配置屬於 Holarch,而不屬於模型。 |
| 變異性 | 變異、變體與組態會被檢查與求值。 | Holarch 尚無法搜尋或列出所有有效組合。 |
| Metadata 與關鍵字 | @Name、#Name、metadata … about、來自語意 metadata 的使用者定義關鍵字。 | 其他使用者定義的 metadata 除了其值之外沒有其他意義;以 about 撰寫的 metadata 不會加入基底型別。 |
| 文字表示 | 以 SysML 與 KerML 撰寫的 rep … language 主體會被檢查,SysML 約束主體也會被求值。 | 以其他語言(例如 Python、OCL 或 MATLAB)撰寫的主體以文字保留,永遠不會執行。 |
| SysML v2 JSON 交換 | 匯入與匯出 Systems Modeling API 元素格式,並保留元素 id。 | Holarch 不解讀的元素種類會依匯入時的樣子保留並原樣寫回;它們沒有文字,也無法編輯。 |
保留,不解讀:No problems 在此不證明任何事
- 以 SysML 與 KerML 以外語言撰寫的文字表示主體。
- 使用者定義 metadata 的值(語意 metadata 除外)。
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 中套用。
如何在課程中使用
- 只有在已檢查的領域才說「工具檢查過了」。例如,No problems 代表單位一致,且需求對目前數值成立。它不代表
doc文字與數值相符,也不代表 Python 主體正確。 - 透過閱讀來評估被保留的構造。以檢視內容評分,而不是看問題數。
- 行為在 Simulator 中執行,包括動作流與狀態機。Simulator 使用的持續時間與機率是 Holarch 的設定:若學生只繳交
.sysml檔案,請一併要求提供設定。 - 語言規則來自規格,而非任何工具。Holarch 尚未實作的部分,請說「Holarch 尚未支援」,而不是「不允許」。
- A6 加分題以本說明為基礎:學生在 EO-1 電力子系統中將 3.1 改為 30 W,看到求值檢查回報它、修正設計,並寫下哪些經過檢查、哪些只是被保留。
下載
套件是一個 zip 檔案。檔名中含版本號,因此課程可以明確指出所用的副本。作業所用的 CSV 與專案檔案是 EO-1 頁面 上 EO-1 Reference Model 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 檔中;請參閱 解答說明。
版本
這是 Teaching with Holarch 教師套件 v1.0,為 EO-1 Reference Model v1.1 撰寫。新版本會使用新的檔名;舊版本仍可在原網址取得。
- v1.0:首次發行:課程學習成果與附評分量表的作業 A1 到 A6,適用於 EO-1 Reference Model v1.1。
引用方式
請引用您使用的版本:
Holarch. Teaching with Holarch: instructor package, version 1.0. https://holarch.app/academic/instructor-package/. Licensed under CC BY 4.0.
授權
教師套件檔案採用 Creative Commons Attribution 4.0 International License (CC BY 4.0) 授權。您可以為任何目的(包括商業用途)複製、分享與改作,但須適當署名、連結至授權條款,並說明是否有修改。署名:「Teaching with Holarch instructor package v1.0, Holarch, CC BY 4.0」。每個下載檔案都附有此聲明。
EO-1 Reference Model 保有自己的署名行:「EO-1 Reference Model v1.1, Holarch, CC BY 4.0」。EO-1 中的所有名稱、人物與結果皆為虛構。
本授權僅涵蓋套件檔案。解答說明不屬於套件,Holarch 軟體也不在本授權範圍內。