SysML v2
SysML v2 プロジェクトを始める
LML プロジェクトと SysML v2 プロジェクトのどちらにするかを選び、SysML v2 プロジェクトまたはデモを作成し、最初のモデルを書いて操作に慣れます。
このページの内容
概要
Holarch は SysML v2 プロジェクトに対応しています。SysML v2 プロジェクトは 1 つのモデルを保持します。モデルは SysML v2 テキスト表記で記述され、OMG SysML v2 仕様に基づいています。
モデルはエディターでテキストとして記述します。Holarch は同じモデルを要素(パッケージ、定義、使用、関係)として保持します。ブラウザー、ビュー、ライフサイクルのページ(要求、検証、インターフェース、リスク、計画)はすべて、同じ要素を表示します。
このページでは、2 種類のプロジェクト、SysML v2 プロジェクトの始め方、各機能の場所について説明します。言語そのものについては SysML v2 テキスト表記を、エディターとブラウザーについてはテキストエディターとブラウザーを参照してください。
概念
2 種類のプロジェクト
Holarch のすべてのプロジェクトは、LML プロジェクトまたは SysML v2 プロジェクトのどちらかです。種類はプロジェクトの作成時に選択します。種類は固定で、変換したコピーによってのみ変更できます(LML と SysML v2 の間の変換を参照)。
| LML | SysML v2 | |
|---|---|---|
| 用途 | Lifecycle Modeling Language でシステムをモデル化します:要求、機能、物理アーキテクチャ、インターフェース、テスト、リスク、スケジュール。Holarch は各ステップで作業をチェックします。 | 標準的な SysML v2 の概念(パッケージ、定義と使用、ポート、接続、アクション、状態、要求)を使い、SysML v2 言語でテキストとしてモデルを構築します。 |
| モデルの構築方法 | データベース、フォーム、30 種類以上のダイアグラム。 | エディターのテキストに加え、同じテキストに書き込むビューとライフサイクルのページ。 |
| 交換できるもの | Word、Excel、CSV、ReqIF、XMI のインポート。Word、Excel、ダイアグラムのエクスポート。プロジェクトファイル。 | SysML v2 テキスト(.sysml)と SysML v2 JSON(SysML v2 モデルの交換を参照)。XMI および Cameo または MagicDraw の .mdzip ファイルからの SysML v1 のインポート(SysML v1 モデルのインポートを参照)。プロジェクトファイル。 |
迷った場合は LML を選択してください。LML には Holarch のすべてのページとダイアグラムがあり、MBSE を初めて使う人に適しています。チームがすでに SysML v2 でモデル化している場合や、SysML v2 ツールとモデルを交換する場合は SysML v2 を選択します。
モデルとテキストは一体
SysML v2 プロジェクトの中にファイルはありません。モデルは要素の集合であり、エディターはトップレベルのパッケージごとに 1 つのテキストドキュメントを表示します。テキストが解析されると、Holarch はそれをモデルに適用します。モデルを他の場所(ビュー、表、インスペクター)で変更すると、テキストもそれに合わせて変わります。テキストとビューは同期を保つを参照してください。
モデルデータと Holarch のデータ
一部の情報は SysML テキストの一部であり、一部は Holarch がモデルの横に保持します。
- テキスト内:要素名、ショートネーム(要求番号)、ドキュメンテーション、型、多重度、値、および
satisfy、verify、perform、connectなどの関係。 - モデルの横(Holarch のデータ):要求のステータスと承認、検証結果、ラベル、担当者、期限、ディスカッションのコメント、ビューのレイアウト、シミュレーターの設定、バジェット、リスク、判断、タスク。これらは ID でモデル要素にリンクされるため、名前の変更や移動の後もリンクは維持されます。
Holarch のデータは SysML テキストには書き込まれず、.sysml エクスポートにも含まれません。
定義と使用
ほとんどの SysML v2 キーワードには 2 つの形があります。定義(part def Wheel;)はものの種類を記述します。使用(part frontWheel : Wheel;)は、別の要素の中での定義の 1 つの使用です。同じパターンが port def/port、action def/action、requirement def/requirement にも当てはまります。詳しくは SysML v2 テキスト表記で説明しています。
使い方
プロジェクトの種類を選択
プロジェクトを作成する前に種類を決めます。
- Holarch の手法をすべて使うには LML を選択します:データベース、LML のダイアグラム、各ステップでのガイド付きチェック。
- モデルを SysML v2 テキストにする必要がある場合(たとえば別の SysML v2 ツールと交換する場合)は SysML v2 を選択します。
- まず SysML v2 を試すには、空のプロジェクトの代わりに Hybrid Car デモ(2 つ後のワークフロー)を開きます。
SysML v2 プロジェクトを作成
- プロジェクトを管理を開き、+ 新しいプロジェクトをクリックします。
- このシステムをどのようにモデル化しますか?で SysML v2 を選択します。
- 名前を入力し、プロジェクトを作成をクリックします。
プロジェクトがホームで開きます。トップバーとプロジェクトを管理のプロジェクト名の横に SysML v2 チップが表示されます。新しいモデルは空です。ホームの次のアクションにはエディターで最初のパッケージを書くと表示されます。
Hybrid Car デモを開く
Hybrid Car デモは、探索や編集ができる完成済みの SysML v2 モデルです。
- プロジェクトを管理を開きます。
- プロジェクトファイル ▾ → 新しいデモプロジェクト → Hybrid Car (SysML v2) をクリックします。
Holarch はプロジェクトHybrid Car (SysML v2 demo)を作成し、ホームで開きます。テキストを読むには、レールのエディターをクリックします。モデルには 6 つのトップレベルのパッケージがあります:Vehicles、VehicleRequirements、VehicleBehavior、VehicleViews、HolarchFrameworks、HybridCarArchitecture。それぞれがエディターのパッケージ一覧にある 1 つのドキュメントです。
デモはあなた専用のコピーです。自由に変更するか、最初からやり直すには再作成します。
リンクからデモを開くには、https://app.holarch.app/#/?demo=hybrid を使用します。デモが構築されて開きます。ホスト版のアプリでは、サインインした後に開きます。
Hybrid Car Battery Pack デモを開く
Hybrid Car Battery Pack デモは、自動車の駆動用バッテリーパックをサプライヤーがモデル化したもので、独立したプロジェクトになっています。Hybrid Car デモもプロジェクトにある場合(前後どちらに作成しても)、パックの 3 つの要求が自動車のバッテリー要求にリンクされるため(BP-1 から VR-3、BP-2 から VR-6、BP-3 から VR-5)、プロジェクトを管理 → プログラムマップで 2 つのプロジェクトのつながりを確認できます。これらのデモのリンクはすべてのプランで機能します。
- プロジェクトを管理を開きます。
- プロジェクトファイル ▾ → 新しいデモプロジェクト → Hybrid Car Battery Pack (SysML v2) をクリックします。
試してみること:
- 計算値:エディターで、
Pack::massはモジュール(それぞれ 12 個のセルとハウジング)、バッテリー管理システム、ジャンクションボックス、冷却装置、エンクロージャーを合計します。上限 48 kg に対して 43 kg なので、massMarginは 5 kg です。Pack::capacityは 120 個のセルを合計し、1.4 kWh に対して 1.44 kWh です。属性を選択すると、インスペクターにその値が表示されます。 - パラメトリックビュー:packParametrics を開きます。容量、質量、充電時間、セルバランシングの各チェックがパックの値にバインドされ、合格しています。
- RVTM:容量と質量は合格、充電受け入れは不合格(高温充電試験は 30 分に対して 34 分かかりました)、セルバランシングはまだ実行されていません。各検証ケースはモデルから判定を計算します。
- シミュレーター:シミュレーターはpackをHot Day Chargeと一緒に開きます。最後まで実行をクリックし、次に状態をクリックします。セルが過熱すると充電は半分の電力に低下し、冷えると再開します。同時に実行でCell Over Voltage Faultを選択すると、保護のためのシャットダウンとサービスリセットを確認できます。
地球観測衛星デモを開く
地球観測衛星デモはより大規模なモデルです。EO-2 ミッション(地上セグメントを備えた 12U の撮像衛星)を、14 のパッケージにわたる約 3,000 行で記述しています。モデルに加えて Holarch 独自のデータも入力されているため、どのページにも表示する内容があります。
- プロジェクトを管理を開きます。
- プロジェクトファイル ▾ → 新しいデモプロジェクト → 地球観測衛星 (SysML v2) をクリックします。
Holarch はプロジェクトEarth Observation Satellite (SysML v2 demo)を作成し、ホームを開きます。このデモには 1,549 個の項目があり、Free プランのプロジェクトあたり 1,000 項目を超えています。Free プランではそのメニュー項目は無効になり、Individual プランが必要です(1,549 項目)と表示されます。リンク https://app.holarch.app/#/?demo=eosat でも構築できます。試してみること:
- ドキュメント:EO-2 System Requirements Specification を開きます。そのセクションには、EORequirements の要求、ライブ値、検証マトリックスが含まれています。
- バジェット:イメージャーの質量が 4.0 kg の配分を超えています。TPM Imager Mass に傾向が表示されます。
- 確認するリンクと TBD/TBR:変更された要求と、解決すべき未確定の値。
- シミュレーター:imagingPassFlow ビューから撮像パスを実行します。
- ベースライン:PDR Data Freeze ベースラインを現在のモデルと比較します。
- ビュー:宇宙機のモード、相互接続ビュー、タスキングシーケンス。
最初のモデルを書く
このワークフローでは、次のテキストで小さなドローンのモデルを構築します:
package Drone {
private import ISQ::*;
private import SI::*;
part def Battery {
attribute mass : MassValue = 0.4 [kg];
}
part def Quadcopter {
part battery : Battery;
}
}
- モデル → エディターを開き、+ 新しいパッケージをクリックし、
Droneと入力して確定します。エディターに新しいパッケージのテキストが開きます。 - 上記のとおり、パッケージの波かっこの中にインポートとメンバーを入力します。
- 入力を止めます。少し間を置くと、テキストの下のステータス行に適用済みと表示されます。モデルには、パッケージ、2 つのパート定義、属性、パートが保持されます。1 回の元に戻すですべて取り消せます。
- モデル → ブラウザーを開き、Drone を展開すると、同じ要素がツリーとして表示されます。
行にエラーがある場合、ステータス行に未適用:N 行目を修正してください。と表示されます。テキストが再び解析されるまで、モデルは最後の正常な状態を保ちます。エラーと下書きを参照してください。
画面の見方
SysML v2 プロジェクトでも Holarch のライフサイクルレールを使用します。各グループは SysML v2 モデルに対して機能します。
- ホームから始めて、要対応の事項、ライフサイクルのグループ、次のアクションを確認します。
- テキストを書くにはモデル → エディターを、ツリーを見るにはモデル → ブラウザーを使用します。
- 要求、検証ケース、トレーサビリティにはニーズと要求と検証を使用します。
- ビューと分析ページには振る舞い、アーキテクチャ、インターフェースを使用します。
- すべてのビューを見るには、レールの下部にあるダイアグラムツールを開きます。
- ⌘K / Ctrl+K を押すと、名前、ショートネーム、修飾名(
Vehicles::Car)、またはドキュメンテーションのテキストで任意の要素を検索できます。 - SysML v2 を初めて使う場合は、シンプルモードをオンにすると、よく使われる要素が先に表示されます。
実例:Hybrid Car を探索する
このウォークスルーでは Hybrid Car デモを使用します。
- デモを作成します(Hybrid Car デモを開くを参照)。ホームで開きます。モデル → エディターを開き、パッケージ一覧で Vehicles を選択します。
part def Carを探します。これにはパートbody、powertrain、frontAxle、rearAxle、spare : Wheel [0..1]があります。part powertrain : Powertrain;のPowertrainを ⌘ / Ctrl を押しながらクリックします。カーソルがpart def Powertrainに移動します。これにはパートtank、engine、motor、battery、transmission、controllerと、interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;などのインターフェースがあります。attribute mass : MassValue;のMassValueをポイントします。標準ライブラリにおけるその種類と修飾名がカードに表示されます。- モデル → ブラウザーを開きます。名前で絞り込みに
sedanと入力します。ツリーには、Vehicles のfleetの下にsedanが表示されます。選択すると、インスペクターに種類 part、型 Car、修飾名Vehicles::fleet::sedanが表示されます。 - ホームを開きます。ニーズと要求のライフサイクルカードはモデルの要求を数え、要対応にはモデルの確認するリンク、期限切れの TBD、高リスクが表示されます。
- ニーズと要求 → 要求を開きます。行には
VR-1.1sedanMass が含まれます。これは要求の使用で、その番号はショートネーム<'VR-1.1'>です。 - ダイアグラムツールを開き、
DriveCycleのアクションフロービューである driveCycleFlow を開きます。そこでアクションの名前を変更してエディターに戻ると、VehicleBehavior に新しい名前が表示されます。
ヒントとよくある間違い
- デモから始めます。Hybrid Car のテキストからパターンをコピーするのが、表記を覚える最も早い方法です。
- 単位をインポートします。
5 [kg]にはSIが(MassValueにはISQが)見える必要があります。パッケージにprivate import ISQ::*;とprivate import SI::*;を追加します。 - 1 つのプロジェクトには 1 つのモデルにします。大きなモデルは複数のトップレベルのパッケージに分割します。それぞれがエディター内の独立したドキュメントになります。
- 種類の選択を誤った場合。種類をその場で切り替えることはできません。プロジェクトを管理から変換したコピーを作成します(⋯ → LML のコピーを作成…または SysML v2 のコピーを作成…)。
- テキストにステータスがあると思い込むこと。要求のステータス、検証結果、ラベルは Holarch のデータです。テキストや
.sysmlエクスポートには表示されません。
SysML v2 プロジェクトのレール
| グループ | ページ |
|---|---|
| ホーム | 要対応、ライフサイクル、次のアクション、その他のホームのパネル |
| ニーズと要求 | ドキュメント、要求、品質、TBD/TBR、確認するリンク、承認、適合性マトリックス* |
| モデル | エディター、ブラウザー、インポートとエクスポート |
| 振る舞い | 機能分析、アクションフロー、FFBD、ステートマシン、シーケンス、シミュレーター |
| アーキテクチャ | パート、General View、Interconnection View、階層、予算と TPM |
| インターフェース | インターフェースレジスター、ICD、N² 図、項目と入出力 |
| 検証 | RVTM、検証ケース、逸脱と特別採用*、トレーサビリティマトリックス、プログラムカバレッジ、モデルチェック |
| 安全性と信頼性† | ハザードログ、FMECA、フォールトツリー、信頼性ブロック図 |
| リスク、課題、判断 | リスク登録簿、Risk 図、トレードスタディ、判断、課題とアクション |
| プラン | マイワーク、SE プロセス、プロジェクト管理、グラフ、ホワイトボード、プレゼンテーション |
| 管理とレビュー | 変更要求、ベースラインとバージョン、ライブラリ、レビュー、アクティビティ |
| フレームワーク | DoDAF、UAF |
* Formal プログラムがオンの場合。† 安全性と信頼性プログラムがオンの場合。どちらもプロジェクトの環境設定 → プログラム機能で切り替えます。
下部のレールツールは LML プロジェクトと同じです:データベース、ダイアグラム、ゴミ箱、設定、ヘルプ。SysML v2 プロジェクトでは、設定に標準ライブラリも表示されます。SysML v2 プロジェクトに当てはまらないページは表示されません。
各ページの説明は、SysML v2 のビュー、SysML v2 プロジェクトの要求と検証、SysML v2 プロジェクトの評価、単位、分析、SysML v2 プロジェクトでの Holarch の機能にあります。
シンプルモード
シンプルモードは、SysML v2 を初めて使う人向けです。ほとんどのモデルが最初に使う要素を表示し、それぞれを 1 文で説明し、残りは求められるまで隠します。変わるのは表示だけです。モデル、そのテキスト、すべてのエクスポートは変わりません。
オンまたはオフにする
- 環境設定 → SysML v2 → シンプルモード。
- モデル → ブラウザーのページヘッダーにあるシンプルモード(オンの間は押された状態)。
- ⌘K / Ctrl+K → シンプルモードをオンにするまたはシンプルモードをオフにする。
既定ではオフです。この設定はアカウントに属します。サインインしたどのコンピューターでも同じ設定になり、サインインするとアカウントの設定が適用されます。環境設定をリセットでは変わりません。
SysML v2 プロジェクトを初めて開くと、トップバーの下にSysML v2 は初めてですか?シンプルモードをオンにすると、よく使う要素が先に表示されます。というメモが表示されます。オンにするをクリックするとシンプルモードがオンになり、×をクリックするとメモが閉じます。どちらの回答もアカウントに保存され、メモは再表示されません。回答しないままにすると、SysML v2 プロジェクトを開くたびに表示されます。シンプルモードがすでにオンの場合は表示されません。
表示内容
Hybrid Car デモとチュートリアルで最もよく使われる 12 の概念です:パッケージ、パート、属性、ポート、接続とインターフェース、アクション、フローとサクセッション、状態、遷移、要求、satisfy、検証。
| 場所 | シンプルモードで表示 | 「すべて表示」まで非表示 |
|---|---|---|
| General View、追加パネル | パッケージ、パート定義、パート、ポート定義、ポート、属性、インターフェース定義、アクション定義、アクション、要求定義、要求、検証ケース | 属性定義、アイテム定義、列挙定義 |
| Spider 図、追加パネル | パッケージ、パート定義、パート、ポート定義、ポート、属性、アクション定義、アクション、状態、要求定義、要求、検証ケース | アイテム定義、アイテム、属性定義、ユースケース |
| Interconnection View、追加パネル | パート、ポート | アイテム |
| 状態遷移ビュー、追加パネル | 開始状態、終了状態、状態、Entry アクション、Do アクション、Exit アクション | 並行状態、領域 |
| Action Flow ビュー、追加パネルと+ Action ▾ | アクション、フォーク、結合、判断、マージ、スイムレーン | 受理、送信、ループ、終了 |
| エディター、挿入 ▾ | パッケージ、パート定義、パート、属性、ポート定義、ポート、インターフェース、接続、アクション定義、アクション、サクセッション、フロー、状態定義、状態、開始状態、遷移、要求定義、要求、充足、検証定義、検証 | カーソル位置に合うその他すべてのスニペット |
| モデル → ブラウザー | パッケージ、定義、使用、接続、フロー、遷移、要求、satisfy と verify | インポート、エイリアス、expose、コメント、ドキュメント、メタデータ、ライブラリパッケージ、バインディングコネクター、KerML レベルの要素、遷移のトリガー行と効果行 |
追加パネルの項目、またはブラウザーの行の種類にポインターを合わせると、その要素の 1 文の説明が表示されます。
要求、ユースケース、パラメトリック、シーケンス、パッケージ、Geometry の各ビューと、階層、ツリー、IDEF0、FFBD の各パネルは、すべての項目を表示したままです。いずれも追加する種類そのものを扱うためです。+ 新しいダイアグラム、表、検索、インスペクター、エディターでの入力(補完付き)は絞り込まれません。
すべて表示
- 追加パネル:項目の下にあるすべて表示(ほか n 件)。表示を減らすで再び隠れます。
- + Action ▾:末尾のすべて表示…で、すべての種類を含むメニューが開き直ります。
- 挿入 ▾:ヘッダーのすべて表示にチェックを入れます。
- ブラウザー:フィルターバーのすべて表示にチェックを入れます。
「すべて表示」は、ページを再読み込みするかシンプルモードを切り替えるまで続き、その間シンプルモードはオンのままです。ブラウザーでは、別の場所から開いた要素(たとえばインスペクターのブラウザーで表示)は、その種類が非表示でも、所有者とともに常に表示されます。
ホーム
ホームは LML プロジェクトと同じページです(ホームを参照)。要対応(確認が必要なリンク、期限切れの TBD、失敗しているテスト、TPM の超過、高リスク、モデルチェック、保存状態)、レールのグループごとのライフサイクルカード、次のアクション、SE プロセスのゲート、マイルストーンなどのパネルがあります。件数は SysML v2 モデルと、その横にある Holarch のデータから得られます。SysML v2 プロジェクトでは✦ プロジェクト概要を作成は提供されません。
- レールのグループには同じ問題バッジが表示され、各グループの概要ページには対応が必要なものとその件数が一覧表示されます。
- + パネルを追加 → モデルの内容には、パッケージ(最上位パッケージの数)、定義、使用、関係、要求(n 件が未充足 · n 件が未検証)、要素が所有者を失った場合のmisplaced elements、Recent changes(最新のモデル変更:作成、変更、移動、削除、復元。要素の種類と時刻付き)が表示されます。
AI に質問
AI に質問は、SysML v2 言語と Holarch の使い方に関する質問に、ヘルプとドキュメントをもとに答えます。Individual プランと Team プランで、自分または組織の AI キーがある場合は、開いているモデルについての質問にも答え、変更を提案します。提案はレビューのために開かれ、その後に適用されます。AI に質問を参照してください。
まだ利用できません
- Systems Modeling API を通じた
mainへのコミット、タグ、マージ:他のツールは変更要求のブランチにコミットし、承認者がそれを Holarch で適用します(SysML v2 プロジェクトの API と MCPを参照)。 - 言語の編集:標準ライブラリは読み取り専用です。
SysML v2 テキスト表記に、サポートされる言語の詳細が記載されています。
メッセージ
| メッセージ | 意味 |
|---|---|
| モデルが空です | プロジェクトに要素がありません。+ 新しいパッケージをクリックし、エディターでそのメンバーを書きます。 |
| 未適用:N 行目を修正してください。 | テキストの N 行目にエラーがあります。テキストが解析できるまで、モデルは最後の正常な状態を保ちます。 |
| 表示のみ:オーナーに編集アクセスを依頼してください。 | このプロジェクトには閲覧アクセスがあります。テキストとページは読み取り専用です。 |
| このプロジェクトには新しいバージョンの Holarch が必要です。 | 新しいバージョンの Holarch がプロジェクトを保存しましたが、このページはそれより古いバージョンです。プロジェクトは表示のみで開き、上部のバナーにその理由が表示されます。新しいバージョンを読み込むには、バナーの再読み込みをクリックします。 |
制限事項
- プロジェクトの種類は作成時に決まります。
- 1 つのプロジェクトに 1 つのモデル。
- 8 MB を超えるテキストドキュメントはチェックされません。複数のパッケージに分割してください。
関連ページ
SysML® および OMG® は、米国およびその他の国における Object Management Group, Inc. の登録商標です。