SysML v2
SysML v2 言語の対応範囲
Holarch の SysML v2 プロジェクトは OMG SysML v2 仕様に基づき、言語のサブセットに対応しています。このページでは、テキスト表記の各領域、Holarch の対応の程度、既知の未対応箇所を一覧にしています。
レベルの意味
- 対応:エディターが構文を解析してチェックし、モデルがそれを保持し、それを使うビューやページが読み書きします。
- 一部対応:対応していますが、行に記載した制限があります。
- 保持のみ(解釈なし):解析され、テキストとエクスポートで書いたとおりに保持されますが、独自の意味は与えられません。
- 未対応:利用できません。
エディター、ビュー、チェックは同じ言語エンジンで動作するため、エディターが受け付ける構文はどのビューでも同じです。Holarch Language Engine もご覧ください。
移動先:言語構文 · ファイルと交換 · チェック · 既知の未対応箇所
言語構文
| 領域 | レベル | 構文 | 制限 |
|---|---|---|---|
| パッケージと名前空間 | 対応 | package、入れ子のパッケージ、library package、doc、comment … about、注記 // と //* */、alias … for …、public・private・protected、短縮名 <'1.2'>、引用符付きの名前。 | 標準ライブラリを含むライブラリパッケージは読み取り専用です。 |
| インポート | 対応 | メンバーシップインポートと名前空間インポート、::*、再帰的な ::**、可視性付きのインポート、フィルター付きインポート [@Kind]。 | インポートフィルターはメタクラスで選択します。 |
| 定義と使用 | 対応 | part、attribute、item、port、connection、interface、flow、action、state、requirement、constraint、calc、use case、analysis、verification、view、viewpoint、concern、enum、occurrence、allocation、metadata。ref、abstract、in、out、inout、end。 | 既知の制限はありません。 |
| 特化、型付け、再定義 | 対応 | 特化 :> と specializes、型付け : と defined by、サブセット化 :> と subsets、再定義 :>> と redefines、共役 ~、disjoint、フィーチャーチェーン a.b.c。 | 既知の制限はありません。 |
| 多重度 | 対応 | [n]、[n..m]、[*]、[0..*]、ordered、nonunique、境界としての式。 | 既知の制限はありません。 |
| 値と単位 | 対応 | =、:=、default、5 [kg] などの量、[m/s^2] などの単位式、標準ライブラリの ISQ の量の種類と SI 単位・米国慣用単位、次元のチェック。 | 既知の制限はありません。 |
| 制約と計算 | 対応 | 制約と計算の定義と使用、return、assert constraint、呼び出し、算術・比較・論理・if ? else・シーケンス操作を含む KerML の式、単位付きの評価。 | 既知の制限はありません。 |
| 構造 | 対応 | ポートと共役ポート、connect、端を持つインターフェース、多重度付きの名前付き接続端(connect [1] driver ::> a to [1] driven ::> b)、バインディングコネクター bind、アイテムフロー flow of T from … to …、message。 | 既知の制限はありません。ポート、フロー、message の方向をチェックします。Interconnection View は名前付きの端に多重度のラベルを付け、インスペクターで編集できます。 |
| アクション | 一部対応 | パラメーター、perform、サクセッション first … then … と then、fork、join、decide、merge、ガード、accept、send、assign、if、while、for、loop、start、done、terminate。 | シミュレーターは、モデルの所要時間、分岐確率、ループ回数を使って、モンテカルロ実行を含むアクションフローを実行します。 |
| 状態 | 一部対応 | entry・do・exit アクション、トリガー・ガード・エフェクト付きの遷移(状態遷移ビューとインスペクターで編集し、ブラウザーでは遷移の下に表示)、parallel 状態、入れ子の状態、exhibit。 | シミュレーターは SysML エンジンでステートマシンを刺激付きで実行し、実行中はアクティブな状態を強調表示します。あらゆる種類の do エフェクトをチェックし、トリガーのペイロードをそのポートに照らしてチェックします。モデルの他の部分から遷移のトリガーとエフェクトを名前で参照できます(plugIn.effect.sentMessage)。 |
| 要求 | 対応 | subject、actor、stakeholder、require constraint、assume constraint、frame concern、satisfy … by …、verify、要求 ID としての短縮名、要求テキストとしての doc。 | 既知の制限はありません。 |
| ユースケース | 対応 | ユースケースの定義と使用、subject、actor、objective、include use case。 | 既知の制限はありません。 |
| 分析ケースと検証ケース | 一部対応 | 主題、目的、return の結果を持つ分析ケース。verify と判定を持つ検証ケース。 | 分析ケースは、すべての入力に値がある場合にのみ評価されます。標準ライブラリのトレードスタディ分析は評価されません。代わりに、Holarch のトレードスタディページがモデルの値を使って代替案を採点します。 |
| ビュー | 一部対応 | view、view def、::*・::**・フィルター付きの expose、filter、viewpoint、frame、render、標準のビュー定義。 | シーケンスビューはライフライン間のメッセージを描き、if/else、ループ、フォーク、判断の中のメッセージを、ガード付きの alt、opt、loop、par フラグメントとして描きます。 |
| 割り当てと依存関係 | 対応 | allocate a to b、割り当て定義、dependency from … to …。 | 既知の制限はありません。 |
| メタデータ | 一部対応 | @Name { … }、#Name 接頭辞、metadata Name about …、ユーザー定義の metadata def、TBD・TBR 値や DoDAF・UAF の概念のための Holarch のメタデータパッケージ、ユーザー定義キーワード(#safetyCritical part controller)、セマンティックメタデータ(#fault def BatteryOverheat;)、独自の意味を持つメタデータ。必須値、宣言された型の値、定義の制約は、使用のたびにチェックされます。 | メタデータ定義の制約は、注釈対象の要素ではなく自身の値を読み取ります。about で書いたメタデータは基底型を追加しません。 |
| 可変性 | 対応 | variation の定義と使用、variant メンバーとバリアント参照(variant plugInHybrid;)、値による選択(part :>> pack = BatteryPack::largePack;)、@HolarchConfiguration を付けた構成。チェックと評価の内容:バリアントは可変点のフィーチャーを持ち、選択は可変点のバリアントのいずれかでなければならず、選択のない可変点は値が不明となるため、それに対するアサーションは満たされも違反もされません。 | 構成はテキストで記述します。Holarch のページではまだ有効な組み合わせを探索しません。 |
| 個体とタイムスライス | 対応 | individual の定義と使用(individual part def Car_VIN1234 :> Car)、snapshot と timeslice(then の後も可)、それらの値とサクセッション。チェックと評価の内容:スナップショットやタイムスライスは所属するオカレンスのフィーチャーを持ち、自身の値が優先して読み取られます。インスペクターのオカレンスフィールド、ブラウザーの Individuals フィルターと新しいスナップショット…/新しいタイムスライス…、«individual»・«snapshot»・«timeslice» とタイムラインとして配置を備えた General View。 | 個体、スナップショット、タイムスライスになれるのはオカレンスだけです。 |
| テキスト表現 | 一部対応 | rep language "…" /* … */。SysML と KerML の本体はコードとしてチェック・ハイライトされ、SysML の制約本体は評価されます。インスペクターで表現を追加・編集でき、Action Flow ビューでは表現を持つアクションに {Python} のように言語が表示されます。 | Python、OCL、MATLAB など他の言語の本体はテキストとして保持され、実行されることはありません。本体に */ を含めることはできません。 |
| KerML | 一部対応 | 標準ライブラリの KerML テキスト:カーネルライブラリは KerML で読み込まれます。テキスト表現の KerML 本体はチェックされます。 | .kerml ファイルはプロジェクトにインポートされず、KerML で書かれたモデルはチェックされません。 |
| 言語拡張 | 一部対応 | セマンティックメタデータによるユーザー定義キーワード:#fault def BatteryOverheat; はメタデータの基底型を特化するため、基底型のフィーチャーを持ちます。注釈対象を制限するメタデータ(annotatedElement)。 | 基底型は名前として読み取られます(faults meta SysML::Usage)。その他の言語拡張は利用できず、標準ライブラリは編集できません。 |
ファイルと交換
| 形式 | レベル | 対応内容 | 制限 |
|---|---|---|---|
| SysML v2 テキスト(.sysml) | 対応 | インポートとエクスポート(ファイルの .zip も可)。インポートを適用する前にプレビューが表示されます。 | エクスポート時に要素 ID を含めるにチェックを入れると要素 ID が保持されます。ID がない場合、再インポートでは要素を名前で照合します。 |
| SysML v2 JSON | 一部対応 | Systems Modeling API の要素形式のインポートとエクスポート。要素 ID は保持されます。 | Holarch が解釈しない要素の種類はインポートしたとおりに保持され、エクスポート時に変更なく書き戻されます。テキストを持たず、編集できません。 |
| SysML v1 モデル(XMI、.mdzip) | 一部対応 | Cameo または MagicDraw(.mdzip または XMI)、Enterprise Architect、Rhapsody、Papyrus(XMI、.uml、.xml)から SysML v2 プロジェクトへのインポート。モデルは SysML v2 テキストに変換されてチェックされ、変換レポートが各要素を変換、近似、除外に分類して理由とともに一覧表示します(CSV も可)。インポートは 1 回の元に戻す操作で取り消せます。 | インポートのみ。フロー終了ノード、アクティビティパーティション、ユースケースの拡張、インスタンス仕様など、SysML v2 に対応するもののない要素は除外され、ダイアグラムとそのレイアウトは変換されません。1 ファイル最大 64 MB、250,000 要素まで。Enterprise Architect のプロジェクトファイル(.eap、.qea)は読み込めません。 |
| モデルリポジトリ | 対応 | Systems Modeling API を提供するリポジトリの 1 つのブランチとの間でプルとプッシュができます。 | プロジェクトごとに 1 ブランチ。 |
| Holarch の Systems Modeling API | 一部対応 | 他の SysML v2 ツールがプロジェクトの現在のモデルを読み取り、変更要求のブランチにコミットできます。 | main は読み取り専用です。コミットは変更要求に入り、承認者が Holarch で適用します。 |
| KerML ファイル(.kerml) | 未対応 | インポートされません。インポート時にスキップされます。 | .sysml ファイルを使用してください。 |
サイズの上限とその他の形式はインポートとエクスポートに掲載しています。
チェック
エディターは入力中にテキストをチェックし、問題をその場所に表示します。チェックの対象:
- 構文:文字、コメント、文字列、波括弧、
;、必要な名前とトークン。 - 名前:未解決、あいまい、重複、プライベートの名前。
- 型付けと特化:循環、正しい種類の定義、継承したフィーチャーのサブセット化と再定義。
- 多重度と単位:有効な境界、次元の一致、単位の欠落や不明な単位。
- 式:オペランドの型、計算の引数、ブール条件。
- 構造、アクション、状態:接続端、ポート・フロー・
messageの方向、サクセッションの対象、制御ノード、forループが反復する値、初期遷移、並行領域、遷移のトリガー(ポート経由のペイロード、atの時刻)、doエフェクト(sendの送信先を含む)。 - ユーザー定義キーワード:
#Nameがメタデータを指すこと、メタデータが許可された種類だけに付けられていること、セマンティック基底型が付けられた要素に合う定義または使用であること。 - メタデータの値:メタデータ定義の各使用が必須値を持つこと、すべての値がフィーチャーの型に合うこと、定義の制約が成り立つこと。
- 可変性:可変点がその種類のバリアントだけを所有すること、選択が可変点のバリアントであること、構成の未決定の可変点が通知されること。
- 要求、ケース、ビュー:メンバーが正しい場所にあること、
satisfy・verify・expose・frameの対象。 - テキスト表現:SysML と KerML の本体が解析でき、表現する要素を宣言していること。Holarch が認識しない言語は通知されます。
- 評価:現在の値で成り立たない制約、要求、目的。
すべてのチェックとメッセージの例:チェック。
既知の未対応箇所
- 分析ケースのソルバーはありません。分析ケースは、すべての入力に値がある場合に評価されます。パラメトリックビューでは、「解く」で制約ごとに 1 つの未知数を求めます。
- ページ上でのバリアント探索はありません。可変点、バリアント、構成はチェック・評価されますが、Holarch のページではまだすべての有効な組み合わせを一覧表示しません。
- KerML ファイルには対応していません。KerML は標準ライブラリでのみ読み込まれます。
- 言語拡張はユーザー定義キーワードとメタデータに限られます。セマンティックメタデータは基底型を適用し、その他のメタデータは定義が示す意味(必須値、値の型、制約)を持ちます。標準ライブラリは読み取り専用です。
- SysML と KerML 以外の言語によるテキスト表現はテキストとして保持され、Holarch が実行することはありません。
- Systems Modeling API:main へのコミット、タグ、マージには対応していません。他のツールは変更要求のブランチにコミットし、承認者が Holarch で適用します。
Holarch は、このページに記載した仕様のサブセットを実装しています。新機能に各変更を掲載しています。