授業向け
教員ガイド:Holarch で授業を行う
Holarch でクラスを設定し、3 つの既製モジュール(要求と検証、機能アーキテクチャと物理アーキテクチャ、SysML v2 の基礎)を実施する方法を説明します。各モジュールには、学生が視聴するトレーニングの章、完了するアプリ内チュートリアル、提出する EO-1 授業課題を記載しています。最後にグループプロジェクトの選択肢を示します。
このページの内容
始める前に
Holarch は学生と教員に無料です(授業向けを参照)。学生は 3 つの教材でツールを学ぶため、授業時間を手法に充てられます。
- /training/ のトレーニングの章:1 本につき 1 つのタスクを扱う短い動画です。
- アプリ内チュートリアル:小さな Weather Station モデルを使ったガイド付きの手順で、作業をチェックするパネルがあります。学生はレールの「ヘルプ」→「チュートリアル」から開始します。チュートリアルのプロジェクトは、学生のアクティブなプロジェクト数に含まれません。
- 演習シート:トレーニングのトラックごとに 1 つ、解答付きです(下記の一覧)。授業外の練習に使えます。
成績評価の対象となる課題には、EO-1 Open MBSE リファレンスモデルを使います。これは架空の CubeSat で、ギャップ、不合格のテスト、未処理の要求変更を意図的に組み込んでいます。ガイドツアー「Holarch で教える」では、教員側の操作を 5 分で紹介しています。
クラス設定のチェックリスト
最初の授業の 1~2 週間前に行います。トレーニングトラック 8「Holarch で教える」がトレーニングページで公開されると、各手順を画面上で確認できます。
- クラスの組織を作成します。「アカウント設定」→「組織」→「組織を作成」で、コース名を付けて作成します。あなたがその組織管理者になります。(トラック 8.1「クラスの組織を設定する」)
- クラスのステータスを申請します。「組織設定」で組織を開き、「クラス」の下にある「クラスのステータスを申請…」をクリックします。コース、学校、学期の終了日を入力し、シラバス(PDF または Word)を添付して送信します。Holarch が申請を審査し、メールでお知らせします。クラスのステータスを取得すると、組織のプロジェクトでは、メンバーのプロジェクトに 6 人、あなたのプロジェクトに 50 人の共同作業者、それぞれ 2,000 項目、および「クラスレビュー」タブが使えるようになり、そのプロジェクトはオーナーのアクティブなプロジェクト数に含まれません。クラスを運営するを参照してください。(トラック 8.2「クラスのステータスとシラバス」)
- メンバーを追加します。「メンバー」で各学生のメールアドレスを入力し、「メンバー」を選択して「メンバーを追加」をクリックします。アカウントのないアドレスには招待が送られます。
- ティーチングアシスタントを組織管理者にします。各 TA を「組織管理者」として追加すると、クラスレビューを閲覧し、名簿を管理できます。組織を管理してもプロジェクトの内容にはアクセスできません。プロジェクトはそれぞれの共有設定を通じて開きます。
- 各グループにプロジェクトを作成させます。グループリーダーが EO-1 モデルを作成し(「プロジェクトを管理」→「プロジェクトファイル ▾」→「新しいデモプロジェクト」→「CubeSat(ガイド付きシステムズエンジニアリング)」)、「共有」→「組織」でクラスの組織を選び、グループを編集者として、あなたと TA を「レビュー担当者」として招待します。レビュー担当者は共同作業者の上限に数えられません。閲覧、エクスポート、コメント、要求とドキュメントレビューの承認または却下はできますが、編集はできません。
- テンプレートを公開します。課題がドキュメントから始まる場合は、組み込みテンプレートから一度作成し、各セクションに指示を追加して、「書く ▾」→「テンプレート ▸」→「テンプレートとして保存…」で、その種類の既定として組織に保存します。すると学生には「+ 新しいドキュメント」で事前に選択された状態で表示されます。ドキュメントをテンプレートとして保存するを参照してください。(トラック 8.3「テンプレートからの課題」)
- 期限を追加します。「組織設定」→「クラスレビュー」→「+ 新しい課題」で、名前と期限の日時を入力します。その時点で Holarch はすべてのグループプロジェクトのバージョンと各メンバーの集計を保持するため、後の作業を期限時点と比較できます。課題の期限を設定するを参照してください。
- AI の扱いを決めます。AI はクラスの組織の設定に従います。試験では「この組織のプロジェクトで AI を許可」をオフにし、「API と MCP のアクセスもオフにする」をオンのままにすると、MCP 経由で接続された AI ツールもオフになります。終了後は AI のチェックボックスを再びオンにし、「API アクセス」を別途オンに戻します。組織の AI をオフにするを参照してください。(トラック 8.5「試験のために AI をオフにする」)
- 学生にコピーを保管するよう伝えます。学生はいつでもプロジェクトをエクスポートできます。各締め切りの前にエクスポートを求めてください。
クラスレビューの使い方
クラスレビューでは、期限時点のグループの作業を確認します。「組織設定」→「クラスレビュー」で開くか、⌘K / Ctrl+K を押して「クラスレビュー」を選択します。
- 作業を確認します。「グループプロジェクト」でプロジェクトをクリックすると、参加せずに閲覧できます。項目名をクリックすると、項目のテキストとコメントのプレビューが開きます。
- 期限時点と比較します。「比較対象」で課題を選択すると、集計は期限時点の値を示し、その後に変更または追加された作業には「期限後に変更」または「期限後に追加」の印が付きます。Holarch は遅れた作業に印を付けるだけで、期限にプロジェクトをロックすることはありません。
- プロジェクト内でコメントと承認を行います。グループプロジェクトのレビュー担当者として、項目にコメントを追加し、レビュー中の要求に「承認」と「却下…」を使います。(トラック 8.4「学生の作業をレビューしコメントする」)
- 成績表用にエクスポートします。「クラスの集計」の「エクスポート(Excel)」で、クラス全体のシート 1 枚、グループごと、学生ごとのシートが作成されます。成績とルーブリックはご自身の成績表で管理します。
評価の対象は、モデルとそこから読み取れる推論です。メンバーごとの集計とアクティビティは、グループ作業におけるメンバーの貢献度が問題になるまれな場合のための証拠であり、品質の尺度でも、すべての学生を監視する理由でもありません。(トラック 8.6「評価の根拠:クラスレビューとアクティビティ」)
モジュール 1:要求と検証(2 週間)
学生は、要求の記述とレビュー、ニーズへのトレース、検証カバレッジの読み方を学びます。
第 1 週:ニーズ、要求、トレース
- 視聴:要求の記述と品質チェック、ニーズから要求へのトレース、未処理の項目と承認。初めてのユーザーは、まずHolarch のワークスペースを視聴します。
- チュートリアル:良い要求を書くと要求をトレースする。
- 提出物:A1 ニーズをトレースする(個人、文書によるメモ)。
- クラスレビュー:A1 はモデルを変更しないため、クラスレビューで期限を設定する必要はありません。グループが締め切りを確認できるよう、この時点で A2 の期限を追加します。
第 2 週:レビュー、ベースライン、検証
- 視聴:ベースラインとレビュー対象のリンク、検証とテストセンター、RVTM と VCRM。
- チュートリアル:要求を検証する。
- 提出物:A2 要求の手直しとレビュー(グループ)。レビューのラウンドは週の中ごろに計画します。グループが 3 つの要求を「レビュー中」に設定し、あなたがレビュー担当者としてコメントして承認または却下し、グループが期限までに回答します。
- クラスレビュー:各グループプロジェクトを A2 の期限時点と比較し、3 つの要求、そのレビューコメント、ベースライン化された仕様書を確認します。任意の追加課題:A3 カバレッジのギャップを見つけるを第 3 週または宿題として出します。
モジュール 2:機能アーキテクチャと物理アーキテクチャ(3 週間)
学生は、機能を分解し、機能とパートの間に論理層を作り、インターフェースを導き出し、変更がアーキテクチャ全体にどう波及するかを追います。
第 1 週:機能とカバレッジ
- 視聴:機能と FFBD、Action 図。
- チュートリアル:機能分析。
- 提出物:A3 カバレッジのギャップを見つける(グループ)。アーキテクチャを拡張する前に、どこが手薄かを学生に示します。
第 2 週:割り当てとインターフェース
- 視聴:割り当て、インターフェース。
- チュートリアル:物理アーキテクチャと割り当てとインターフェース。
- 開始:A4 アーキテクチャを拡張する(グループ、第 3 週末が期限)。
第 3 週:分析と変更
- 視聴:シミュレーション、予算と TPM。
- チュートリアル:機能フローをシミュレーションするとベースライン、変更、影響。
- 提出物:A4。モジュールに第 4 週を設ける余裕があれば、A5 変更に取り組むを追加します。今週の章で扱う電力の式と TPM-2 がその入力になります。
- クラスレビュー:課題ごとに期限を追加します。A4 では期限時点と比較し、各グループのプロジェクトで新しい論理要素とその割り当てを開きます。提出されたアーキテクチャ記述は、モデルの内容と一致している必要があります。
モジュール 3:SysML v2 の基礎(2 週間)
学生は SysML v2 のテキスト記法で小さなモデルを書き、それをビューとして確認し、ツールのチェックが何を証明するかを学びます。各グループは作業用に SysML v2 プロジェクトを作成します。SysML v2 のチュートリアルでは、ハイブリッドカーのパートを作成します。
第 1 週:構造
- 視聴:定義と属性、ポートとインターフェース、アクションとフロー。
- チュートリアル:はじめに、定義と属性、ポートとインターフェース。
- 授業内:SysML v2 の教育上の境界を説明します。エディターがチェックする内容、解釈せずに保持する内容、そして「Holarch ではまだ対応していない」が「許可されていない」を意味しない理由です。
第 2 週:要求と制約
- 視聴:要求、検証とトレーサビリティ、制約と計算。
- チュートリアル:要求と制約と計算。
- 提出物:A6 パート B 単独:SysML v2 による EO-1 の電源サブシステム、30 W の変更、それを満たす設計、そしてチェックされた内容と保持されただけの内容についての半ページの説明。
- クラスレビュー:期限を追加します。ファイルと半ページの説明を合わせて読みます。診断 0 件だけではチェックの対象範囲しか証明されないため、評価は説明に基づきます。
グループプロジェクトの選択肢
学期プロジェクトでは、各グループが EO-1 ではなく自分で選んだシステムを、ニーズから検証までモデル化します。コースの構成はクラス向け機能が支えます。
- クラスの組織にグループごとのプロジェクト。グループリーダーがプロジェクトを作成し(空のプロジェクト、または授業向けにある授業用スターター例から)、「共有」→「組織」でクラスの組織を選び、グループを編集者として、教員スタッフをレビュー担当者として招待します。
- マイルストーンを期限として設定。マイルストーンごとにクラスレビューの課題を 1 つ追加します。たとえば、コンセプトとニーズ、要求レビュー、アーキテクチャ、検証計画です。各期限で、すべてのグループプロジェクトのバージョンが評価用に保持されます。
- レビュー担当者としてのレビューラウンド。要求のマイルストーンの前に、グループは要求を「レビュー中」に設定します。あなたと TA がコメントし、承認または却下し、グループは A2 と同様に手直しして再提出します。ピアレビューも同じ方法で行えます。別のグループのメンバーをレビュー担当者としてプロジェクトに追加します。
- AI なしの試験期間。試験中は組織の AI を API と MCP のアクセスも含めてオフにし、終了後にオンに戻します(チェックリストの手順 8)。
- 最終ベースラインを提出物に。各グループは「管理とレビュー」→「ベースラインとバージョン」→「+ ベースラインを保存…」で、提出物の名前を付けてプロジェクトのベースラインを保存し、成果物をエクスポートします(たとえば仕様書と検証計画を Word に)。評価するのはライブのプロジェクトではなくベースラインです。
- 貢献の証拠は必要なときだけ。グループの評価はモデルとその推論に基づいて行います。メンバーの貢献度が問題になる場合に限り、クラスレビューでそのメンバーの貢献度を開きます。
EO-1 課題のルーブリックを各マイルストーンに合わせて調整します。ルーブリックは項目数ではなく判断力(つながりの完全性、各判断の質、検証と妥当性確認の区別)を評価します。
演習シート
各シートには、1 つのトレーニングトラックに対応する短い練習課題と解答が収録されており、課題以上に練習したい学生向けです。公開されているため、成績評価の対象にはなりません。
サポート
クラスの設定、クラスのステータスに関する質問、A1~A6 の解答メモについては、トピック「Instructor」を選んでお問い合わせください。上記の各手順の詳細は、ドキュメントのクラスを運営すると貢献度のページにあります。