Holarch

SysML v2

SysML v2 プロジェクトを始める

LML プロジェクトと SysML v2 プロジェクトのどちらにするかを選び、SysML v2 プロジェクトまたはデモを作成し、最初のモデルを書いて操作に慣れます。

使い方 →

このページの内容
  1. 概要
  2. 概念
    1. 2 種類のプロジェクト
    2. モデルとテキストは一体
    3. モデルデータと Holarch のデータ
    4. 定義と使用
  3. 使い方
    1. プロジェクトの種類を選択
    2. SysML v2 プロジェクトを作成
    3. Hybrid Car デモを開く
    4. Hybrid Car Battery Pack デモを開く
    5. 地球観測衛星デモを開く
    6. 最初のモデルを書く
    7. 画面の見方
  4. 実例:Hybrid Car を探索する
  5. ヒントとよくある間違い
  6. SysML v2 プロジェクトのレール
  7. シンプルモード
    1. オンまたはオフにする
    2. 表示内容
    3. すべて表示
  8. ホーム
  9. AI に質問
  10. まだ利用できません
  11. メッセージ
  12. 制限事項
  13. 関連ページ

概要

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 の間の変換を参照)。

LMLSysML 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 テキスト表記で説明しています。

使い方

プロジェクトの種類を選択

プロジェクトを作成する前に種類を決めます。

  1. Holarch の手法をすべて使うには LML を選択します:データベース、LML のダイアグラム、各ステップでのガイド付きチェック。
  2. モデルを SysML v2 テキストにする必要がある場合(たとえば別の SysML v2 ツールと交換する場合)は SysML v2 を選択します。
  3. まず SysML v2 を試すには、空のプロジェクトの代わりに Hybrid Car デモ(2 つ後のワークフロー)を開きます。

SysML v2 プロジェクトを作成

  1. プロジェクトを管理を開き、+ 新しいプロジェクトをクリックします。
  2. このシステムをどのようにモデル化しますか?で SysML v2 を選択します。
  3. 名前を入力し、プロジェクトを作成をクリックします。

プロジェクトがホームで開きます。トップバーとプロジェクトを管理のプロジェクト名の横に SysML v2 チップが表示されます。新しいモデルは空です。ホームの次のアクションにはエディターで最初のパッケージを書くと表示されます。

Hybrid Car デモを開く

Hybrid Car デモは、探索や編集ができる完成済みの SysML v2 モデルです。

  1. プロジェクトを管理を開きます。
  2. プロジェクトファイル ▾ → 新しいデモプロジェクト → 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 つのプロジェクトのつながりを確認できます。これらのデモのリンクはすべてのプランで機能します。

  1. プロジェクトを管理を開きます。
  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 独自のデータも入力されているため、どのページにも表示する内容があります。

  1. プロジェクトを管理を開きます。
  2. プロジェクトファイル ▾ → 新しいデモプロジェクト → 地球観測衛星 (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;
    }
}
  1. モデル → エディターを開き、+ 新しいパッケージをクリックし、Drone と入力して確定します。エディターに新しいパッケージのテキストが開きます。
  2. 上記のとおり、パッケージの波かっこの中にインポートとメンバーを入力します。
  3. 入力を止めます。少し間を置くと、テキストの下のステータス行に適用済みと表示されます。モデルには、パッケージ、2 つのパート定義、属性、パートが保持されます。1 回の元に戻すですべて取り消せます。
  4. モデル → ブラウザーを開き、Drone を展開すると、同じ要素がツリーとして表示されます。

行にエラーがある場合、ステータス行に未適用:N 行目を修正してください。と表示されます。テキストが再び解析されるまで、モデルは最後の正常な状態を保ちます。エラーと下書きを参照してください。

画面の見方

SysML v2 プロジェクトでも Holarch のライフサイクルレールを使用します。各グループは SysML v2 モデルに対して機能します。

  1. ホームから始めて、要対応の事項、ライフサイクルのグループ、次のアクションを確認します。
  2. テキストを書くにはモデル → エディターを、ツリーを見るにはモデル → ブラウザーを使用します。
  3. 要求、検証ケース、トレーサビリティにはニーズと要求と検証を使用します。
  4. ビューと分析ページには振る舞い、アーキテクチャ、インターフェースを使用します。
  5. すべてのビューを見るには、レールの下部にあるダイアグラムツールを開きます。
  6. ⌘K / Ctrl+K を押すと、名前、ショートネーム、修飾名(Vehicles::Car)、またはドキュメンテーションのテキストで任意の要素を検索できます。
  7. SysML v2 を初めて使う場合は、シンプルモードをオンにすると、よく使われる要素が先に表示されます。

実例:Hybrid Car を探索する

このウォークスルーでは Hybrid Car デモを使用します。

  1. デモを作成します(Hybrid Car デモを開くを参照)。ホームで開きます。モデル → エディターを開き、パッケージ一覧で Vehicles を選択します。
  2. part def Car を探します。これにはパート body、powertrain、frontAxle、rearAxle、spare : Wheel [0..1] があります。
  3. part powertrain : Powertrain; の Powertrain を ⌘ / Ctrl を押しながらクリックします。カーソルが part def Powertrain に移動します。これにはパート tank、engine、motor、battery、transmission、controller と、interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn; などのインターフェースがあります。
  4. attribute mass : MassValue; の MassValue をポイントします。標準ライブラリにおけるその種類と修飾名がカードに表示されます。
  5. モデル → ブラウザーを開きます。名前で絞り込みに sedan と入力します。ツリーには、Vehicles の fleet の下に sedan が表示されます。選択すると、インスペクターに種類 part、型 Car、修飾名 Vehicles::fleet::sedan が表示されます。
  6. ホームを開きます。ニーズと要求のライフサイクルカードはモデルの要求を数え、要対応にはモデルの確認するリンク、期限切れの TBD、高リスクが表示されます。
  7. ニーズと要求 → 要求を開きます。行には VR-1.1 sedanMass が含まれます。これは要求の使用で、その番号はショートネーム <'VR-1.1'> です。
  8. ダイアグラムツールを開き、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. の登録商標です。