講師パッケージ · v1.0
Teaching with Holarch:講師パッケージ
1 学期のシステムズエンジニアリングまたは MBSE の授業のための、授業の学習成果とルーブリック付きの 6 つの課題。すべて、架空の 6U 地球観測 CubeSat である EO-1 オープン MBSE リファレンスモデル v1.1 に基づいています。CC BY 4.0 のもとで無料です。
講師パッケージ v1.0 をダウンロード
どのエディターでも開ける Markdown ファイルです。EO-1 リファレンスモデル v1.1 を使用します。ライセンス:CC BY 4.0、クレジット表記「Holarch」。
このページの内容
内容
| ファイル | 対象 | 内容 |
|---|---|---|
learning-outcomes.md | 講師、認定審査の記録 | 授業の学習成果、それぞれを評価する課題、使用する Holarch の機能。 |
assignments/A1-trace-a-need.md から A6-validation-plan.md | 学生(配布用) | EO-1 を使う 6 つの課題。それぞれに背景、課題内容、提出物、ルーブリックがあります。 |
sysml-v2-teaching-boundaries.md | 講師 | Holarch の SysML v2 プロジェクトがチェックするもの、解釈せずに保持するもの、まだ利用できないもの。 |
使い方
- 各グループに EO-1 v1.1 のコピーを 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 で組織設定 → クラスレビュー → 解答メモをダウンロードからダウンロードします。このボタンは、クラスステータスを持つ組織の組織管理者(講師とティーチングアシスタント)に表示されます。
学習成果
授業:モデルベースシステムズエンジニアリング、1 学期、学部上級または大学院 1 年。
授業の終わりまでに、学生は次のことができるようになります:
| # | 成果 | 評価方法 | 使用する 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 の顧客である農業分析企業は、3 つのニーズを示しました。N2 週 2 回の再訪の内容は「農場の顧客は、生育期に少なくとも週 2 回、自分の圃場の新しい画像を必要とする。」です。ニーズが満たされるのは、それを形式化した要求が設計によって満たされて検証され、ニーズ自体が顧客とともに妥当性確認されたときに限られます。
タスク
- N2 をモデルの中でたどります:それがトレースする要求、その子要求、それぞれを満たす機能とコンポーネント、それらを検証するテストケースと各テストのステータス。
- その連鎖を表または小さな図として描きます。項目ごとに 1 行または 1 つの箱とし、番号、名前、ステータス、それをつなぐ関係を記します。
- N2 の妥当性確認の活動とそのステータスを見つけます。
- 次の問いに答えます:N2 が妥当性確認済みとみなされるまでに、まだ不足している証拠は何か。不足している各要素、それが属する項目、それを解消するものを挙げます。
- N2 を支えているがそれにトレースされていない要求を探します。候補を 1 つ挙げ、トレースを追加すべきかどうかを論じます。モデルには追加しないでください。
Holarch では:項目ビューで N2 を開いてそのトレースセクションを読み、次に検証 → トレーサビリティマトリックス、検証 → RVTM、検証 → テストセンターを使います。Holarch なしでは:eo-1-v1.1-traceability.csv と eo-1-v1.1-rvtm.csv。
提出物
つながり、不足している証拠、手順 5 への回答をまとめた 1~2 ページのメモ(Word または PDF)。この課題ではモデルを変更しません。
ルーブリック
| 基準 | 4 模範的 | 3 熟達 | 2 発展途上 | 1 初歩 |
|---|---|---|---|---|
| つながりが完全で正確(40 %) | N2 からテストまでのすべての項目が、正しい関係とステータスで、両方の子要求と妥当性確認の活動を含めて示されている。 | 項目またはステータスが 1 つ欠けているか誤っている。 | つながりが要求で止まっているか、子要求が欠けている。 | 関係なしに項目が列挙されている。 |
| 不足している証拠(35 %) | すべてのギャップ(未実行のテスト、独自の検証を持たない親要求、未承認の要求、未実行の妥当性確認、機能のない子要求)と、それぞれを解消するものが挙げられている。 | ほとんどのギャップを、埋める方法とともに挙げている。 | ギャップを挙げているが、埋める方法を述べていない。 | 「テストが不足している」とだけ述べている。 |
| 検証と妥当性確認(15 %) | 全体を通じて両者を区別している:要求は検証され、ニーズは妥当性確認される。 | 誤りが 1 つある。 | 合格したテストをニーズの妥当性確認として扱っている。 | 区別がない。 |
| トレースの候補(10 %) | 具体的な要求を挙げ、賛否いずれかについて筋の通った論拠を示している。 | 候補はあるが論拠が弱い。 | 候補はあるが論拠がない。 | なし。 |
A2 · 要求の手直しとレビュー
成果:LO2(主)、LO3、LO8 · グループ人数:グループ · 推奨の重み:10 %
背景
EO-1 の 3 つの要求はまだ草案で、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)."(熱設計はバッテリーを十分に暖かく保つこと(TBD)。)
- 6.4 Operator Interface:"The operator interface shall be user friendly and/or easy to use."(オペレーターインターフェースはユーザーフレンドリーであること、および/または使いやすいこと。)
3.5 には、未解決の課題 ISS-3「バッテリーヒーターの設定点が未決定」と、設計レビューボードからのレビューコメント RID-1「バッテリーヒーターの低温ケース解析がない」もあります。
タスク
- 3 つそれぞれについて、何が弱点なのかを、重要な箇所では語句ごとに挙げます。
- グループプロジェクトでそれぞれを書き直します:「shall」を 1 つ、測定可能な条件を 1 つとし、時間や範囲が関わる場合は起点または条件を明記します。すべての TBD を値に置き換えて根拠を記録するか、担当者と日付を付けて TBR を残します。3.5 については、書き直しが ISS-3 と RID-1 にどう応えるかを述べます。
- それぞれについて検証方法、検証レベル、成功基準を記入します。
- それぞれを出所(ニーズ、親要求、またはソース)と、それを満たす機能にトレースします。機能が存在しない場合は、欠けている機能を挙げます。
- それぞれをレビュー中に設定します。講師がレビュー担当者としてそれらをレビューします。すべてのコメントにモデル内で応え(要求を変更するか、理由を添えて返信する)、その後コメントを解決します。
- ドキュメント EO-1 System Requirements Specification(SRS-001)のベースラインを「A2 提出」という名前で保存し、Word にエクスポートします。
Holarch では:ニーズと要求 → 品質、要求のインスペクター、ニーズと要求 → 承認、そしてドキュメントのバージョン ▾ → ベースラインを保存…と納品 ▾ → 仕様書(Word)。
提出物
Word のエクスポートと、手順 1 で見つけた弱点についての半ページのメモ。期限時点のモデルも合わせて採点されます。
ルーブリック
| 基準 | 4 模範的 | 3 熟達 | 2 発展途上 | 1 初歩 |
|---|---|---|---|---|
| 書き直した要求(40 %) | 3 つとも単一で、測定可能で、検証可能。条件と起点が明記され、値に根拠がある。 | 1 つの要求に曖昧な用語が残っているか、条件が欠けている。 | 値は追加されているが、条件または根拠が欠けている。 | 言い回しは変わったが、まだ検証できない。 |
| 検証の属性(20 %) | 方法、レベル、成功基準が各要求に合っており、書かれたとおりに実施できる。 | 不一致が 1 つある。たとえば、分析しかできない箇所にテストを指定している。 | 方法は設定されているが、成功基準が曖昧。 | なし。 |
| トレーサビリティ(15 %) | それぞれが出所と満たす機能にトレースされているか、不足している機能が示されている。 | トレースが 1 つ欠けている。 | 出所のみ。 | なし。 |
| レビューサイクル(15 %) | すべてのレビューコメントにモデル内で応えて解決している。却下された要求は手直しして再提出している。 | コメントが 1 つ未解決のまま。 | モデルを変更せずにコメントに回答している。 | コメントを無視している。 |
| 弱点の分析(10 %) | 正確:曖昧な用語をそれぞれ挙げ、なぜ検証できないかを説明している。 | 一般的だが正しい。 | 品質スコアを繰り返しているだけ。 | なし。 |
A3 · カバレッジのギャップを見つける
成果:LO4(主)、LO1、LO2、LO7 · グループ人数:グループ · 推奨の重み:10 %
背景
EO-1 は詳細設計審査の段階にあります。モデルは意図的に不完全です。一部の要求にはそれを満たす機能がなく、一部にはテストがなく、一部のテストは不合格で、1 つの式は何にもリンクされていません。
タスク
v1.1 の配布状態のモデルから作業します。グループプロジェクトが変更されている場合は、新しいコピーを使ってください。
- どの機能も満たしていない要求をすべて挙げます。
- どのテストケースも検証していない要求と、テストが不合格になった要求を、それに対して記録された未解決の課題や逸脱とともにすべて挙げます。
- 満たすコンポーネントがない要求を挙げます。そのうちどれにコンポーネントが必要で、どれがミッションやセグメントのレベルで満たされるのが正しいかを判断します。
- 何もトレースしていないモデル項目を見つけます。ヒント:電力の式を見てください。
- 各ギャップについて、モデルに何かが欠けている(機能、コンポーネント、テスト、リンク)のか、要求が不要または誤って書かれているのかを判断します。ギャップごとに 1 文で理由を述べます。
- グループプロジェクトで、選んだ 3 つのギャップを解消します。それぞれを管理とレビュー → アクティビティで示せる 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 で、さらに実施した 3 つの変更の一覧。
ルーブリック
| 基準 | 4 模範的 | 3 熟達 | 2 発展途上 | 1 初歩 |
|---|---|---|---|---|
| 見つけたギャップ(35 %) | 機能、テスト、コンポーネント、孤立項目のすべてのギャップを、不合格のテストとその課題および逸脱を含めて挙げている。 | ギャップを 1~2 つ見落としている。 | 明らかな草案しか見つけていない。 | 半分未満。 |
| 判断(35 %) | 各ギャップに妥当な判断が下されている。欠けている設計と、不要または範囲の誤った要求、そしてミッションレベルでの充足を区別している。 | ほとんどの判断が妥当。 | すべてのギャップを「リンクを追加する」として扱っている。 | 判断なし。 |
| 実施した変更(20 %) | 実際にギャップを解消する 3 つの変更で、それぞれが記録上の明確な 1 ステップになっている。 | 良い変更が 2 つ。 | ギャップを隠す変更(理由なしに追加したリンクなど)。 | なし。 |
| 表現(10 %) | 表が並べ替え可能で完全である。 | 軽微な抜けがある。 | わかりにくい。 | なし。 |
A4 · アーキテクチャを拡張する
成果:LO5(主)、LO4 · グループ人数:グループ · 推奨の重み:12 %
背景
EO-1 の論理アーキテクチャ(L0)は、電源とデータ処理の範囲、すなわち L1 発電から L6 故障管理だけを対象としています。各論理要素は機能をまとめ(allocated to)、物理パートによって実現されます(related to)。たとえば F3.1 太陽光を電力に変換は L1 に割り当てられ、1.3.1 太陽電池アレイが L1 を実現します。姿勢決定・制御には、機能 F4.1 姿勢を推定、F4.2 制御トルクを計算、F4.3 リアクションホイールを駆動、F4.4 ホイールの角運動量をアンロードと、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。
提出物
短いアーキテクチャ記述(2~3 ページ、Word または PDF):目的を記した論理要素、割り当て表(機能 → 論理要素 → 物理パート)、F4 の Action 図、インターフェースの比較。
ルーブリック
| 基準 | 4 模範的 | 3 熟達 | 2 発展途上 | 1 初歩 |
|---|---|---|---|---|
| 論理要素(25 %) | ソリューションに依存せず、凝集性があり、それぞれに明確な目的がある。ハードウェアの名前を含まない。 | 1 つの要素がハードウェア名を挙げているか、目的が混在している。 | 要素が物理パートの写しになっている。 | 欠けているか不明確。 |
| 割り当て(30 %) | すべてのサブ機能が正しい要素に 1 回ずつ割り当てられ、要素はパートによって実現され、モデル内で一貫している。 | 疑問のある割り当てが 1 つある。 | 論理層を飛ばして、パートにのみ割り当てている。 | 不完全。 |
| フローとインターフェース(30 %) | 境界を越えるフローからインターフェースを導出している。IF-06、IF-16、IF-17、IF-18 との正確な比較があり、双方向のギャップを含む。 | 比較はおおむね正しい。 | インターフェースを列挙しているが、導出していない。 | なし。 |
| 要求の責任(15 %) | 2.1 から 2.4 のそれぞれが、その機能を通じて論理要素までトレースされ、不整合が挙げられている。 | 1 つ欠けている。 | 確認せずに列挙している。 | なし。 |
A5 · 変更に取り組む
成果:LO6(主)、LO7 · グループ人数:グループ · 推奨の重み:10 %
背景
設計レビューの後、要求 3.1 軌道平均電力は、寿命末期の軌道平均電力 28 W から 30 W に変更されました。テストケース TC-06 太陽電池アレイ電力テストは古い値に対して合格していました。Holarch は 3.1 のリンクに確認が必要というマークを付けました。
タスク
- 変更が及ぶすべての項目を挙げます。3.1 からのリンクを順方向に、3.1 の導出元へ逆方向にたどり、さらに 3.1 へのリンクなしに旧値に言及している項目も含めます。それぞれをどのように見つけたかを述べます。
- 各項目について、変更が提起する問い、所見(モデルに数値がある場合は数値を含む)、決定(変更なし(コメントを付けてリンクを確認済みにする)、更新、または変更管理ボードへのエスカレーション)を書きます。
- TC-06 をどう扱うかを決めます:28 W で合格したテストは、30 W をまだ証明しているでしょうか。モデルの式から計算を示してください。
- リンクに基づく分析で見落とされる項目を 1 つ見つけ、それが重要な理由を述べます。
- グループプロジェクトに決定を記録します:確認済みにする各リンクへのコメント、ボードが決定すべきことについての変更要求、そして前後のベースライン。
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。まず自分で分析し、その後で比較してください。
提出物
影響記録(項目、到達経路、問い、所見、決定、ステータスの表)と、変更管理ボードへの 1 段落の推奨。
ルーブリック
| 基準 | 4 模範的 | 3 熟達 | 2 発展途上 | 1 初歩 |
|---|---|---|---|---|
| 到達範囲(30 %) | 順方向、逆方向、テキスト検索による項目を見つけている。どのリンクからも到達しない項目を含む。 | リンクのみだが、すべて。 | 一部の順方向のリンク。 | 3.1 と TC-06 のみ。 |
| 数値に基づく発見事項(30 %) | モデルの値と式を使っている。TC-06 の不足分が計算され、説明されている。 | 数値はおおむね正しい。 | 定性的な説明のみ。 | 結論が誤っている。 |
| 判断(25 %) | 各項目に発見事項に合った判断がある。リンクは理由がある場合にのみ確認済みにしている。委員会案件を区別している。 | 弱い判断が 1 つある。 | 理由なしにリンクを確認済みにしている。 | 判断なし。 |
| モデル内の記録(15 %) | コメント、変更要求、ベースラインがそろっており、記録と整合している。 | 1 つ欠けている。 | ドキュメントのみ。 | モデルには何もない。 |
A6 · 妥当性確認計画
学習成果:LO7(主)、LO8、LO1 · グループの人数:グループ · 推奨配点:10 %
背景
検証は、EO-1 がその要求に照らして正しく作られたかを問い、妥当性確認は、それが農場の顧客にとって正しいシステムかを問います。EO-1 の妥当性確認スイート TS-3 ミッション妥当性確認には、VAL-01 顧客アラートパイロット(N1 用、未実行)、VAL-02 生育期の再訪シミュレーション(N2 用、未実行)、VAL-03 農学者による地図レビュー(N3 用、合格)があります。
ニーズと要求 → ドキュメント → + 新しいドキュメントで計画を始めます。テンプレートで、対象のテンプレートをテスト計画ドキュメントに設定し、組み込みの検証および妥当性確認計画を記述ガイダンスを含める付きで選ぶか、講師がこの課題用に公開した組織のテンプレートを選びます。
タスク
- 5.1 運用シナリオ:VAL-01 のシナリオを顧客の言葉で書きます。誰が、どの日に、何をして、どのような結果になるか。それが確かめるニーズを挙げます。
- 5.2 ユーザーと参加者:代表的なユーザーと、それぞれが決定することを挙げます。
- 5.3 妥当性確認の環境:環境と、それが運用とどう異なるか、その違いが結果にとって何を意味するかを記述します。
- VAL-01 の受け入れ基準を、顧客がエンジニアリングの判断なしに可否を言えるように書き、テストケースの期待される結果に記録します。
- 8 検証ステータス:ライブマトリクスを読みます。不合格のテスト TC-04 指向精度テストを取り上げ、パイロットの時点で TC-04 がまだ不合格の場合、VAL-01 の結果が何を意味するかを述べます。
- 計画を Word にエクスポートします。
任意:SysML v2 ボーナス(LO9、最大 10 % の加点)
eo-1-v1.1-power-subsystem.sysml から SysML v2 プロジェクトを作成します(プロジェクトを管理 → プロジェクトファイル ▾ → SysML v2 ファイルをインポート…)。このファイルでは、要求 3.1 はまだ 28 W のままです。要求される軌道平均電力を A5 の変更である 30 W に変更し、エディターが報告する内容を読みます。それはモデリングの誤りでしょうか、それとも設計上の所見でしょうか。次に、要求ではなく設計値を、エディターのステータス行に問題なしと表示されるまで変更し、新しい値が物理的に妥当かどうかを述べます。半ページで、自分の主張のうちツールがチェックしたものと保持しただけのものを述べます。講師が共有する SysML v2 の教育用メモに、その両方が記載されています。
提出物
- 計画の Word エクスポート。
- SysML v2 ボーナスについては:
.sysmlファイルと半ページの記述。
ルーブリック
| 基準 | 4 模範的 | 3 熟達 | 2 発展途上 | 1 初歩 |
|---|---|---|---|---|
| 顧客の言葉で書かれたシナリオ(30 %) | 具体的で、日常の一日を描き、エンジニアリングの専門用語がない。N1 を明確に検証している。 | 明確だが、一部に専門用語がある。 | シナリオではなくテスト手順になっている。 | 欠けているか一般的。 |
| 受け入れ基準(25 %) | 観察可能で、可否で答えられ、顧客が判定する。N1 の「上空通過の当日に」と結び付いている。 | おおむね観察可能。 | エンジニアリング上のしきい値のみ。 | 曖昧。 |
| 参加者と環境(20 %) | 代表的なユーザーとその判断が挙げられ、運用との違いとその影響が述べられている。 | 1 つ欠けている。 | 影響を述べずに列挙している。 | なし。 |
| 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 で言語を教える際は、学生がツールの制限を言語の規則として学んだり、ツールが保持しただけの構文をチェック済みと受け取ったりしないよう、3 種類の記述を区別してください:
- チェック済み:エディターがその構文を解析し、入力中にチェックし、ビューとページがそれを使います。エディターのステータス行に問題なしと表示されていれば、これらのチェックは合格しています。
- 保持されるが解釈されない:解析され、テキストとエクスポートで書かれたとおりに保持されますが、意味は与えられません。問題なしは、それが正しいかどうかについて何も示しません。
- 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 ビューでは、「解く」で制約ごとに 1 つの未知数を求めます。標準ライブラリのトレードスタディ解析は評価されません。 |
| ビュー | view、view def、expose、フィルター、ビューポイント、標準のビュー定義。Sequence ビューは alt、opt、loop、par のフラグメントを描きます。 | レイアウトはモデルではなく Holarch に属します。 |
| 可変性 | バリエーション、バリアント、構成はチェックされ、評価されます。 | Holarch はまだ、有効なすべての組み合わせを探索・一覧表示しません。 |
| メタデータとキーワード | @Name、#Name、metadata … about、セマンティックメタデータによるユーザー定義キーワード。 | その他のユーザー定義メタデータは値以上の意味を持ちません。about で書かれたメタデータは基底型を追加しません。 |
| テキスト表現 | SysML と KerML の rep … language の本体はチェックされ、SysML の制約の本体は評価されます。 | Python、OCL、MATLAB など他の言語の本体はテキストとして保持され、実行されることはありません。 |
| SysML v2 JSON 交換 | 要素 ID を保持した、Systems Modeling API の要素形式のインポートとエクスポート。 | 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 に変更し、評価チェックがそれを報告するのを確認し、設計を修正し、何がチェックされ何が保持されただけかを書き留めます。
ダウンロード
パッケージは 1 つの zip ファイルです。名前にバージョンが含まれているため、授業では使用したコピーを正確に示せます。課題で使う CSV ファイルとプロジェクトファイルは、EO-1 のページにある EO-1 リファレンスモデル v1.1 のダウンロードです。
| ファイル | 内容 |
|---|---|
| teaching-with-holarch-v1.0.zip | 以下のすべてのファイルを 1 つのフォルダーに収めたもの。 |
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 に含まれていません。解答メモをご覧ください。
バージョン
これは EO-1 リファレンスモデル v1.1 用に書かれた Teaching with Holarch 講師パッケージ v1.0 です。新しいバージョンには新しいファイル名が付きます。以前のバージョンは引き続き同じアドレスで入手できます。
- v1.0:最初のリリース:EO-1 リファレンスモデル v1.1 用の、授業の学習成果と、ルーブリック付きの課題 A1 から A6。
引用方法
使用したバージョンを引用してください:
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 ソフトウェアも対象外です。