SysML v2
LML と SysML v2 の間の変換
LML プロジェクトの SysML v2 コピー、または SysML v2 プロジェクトの LML コピーを作成し、変換される内容とされない内容のレポートを確認します。
このページの内容
概要
プロジェクトの種類(LML または SysML v2)は、作成時に固定されます。LML モデルを SysML v2 で扱う場合や、SysML v2 モデルを LML のページで扱う場合は、変換したコピーを作成します:
- LML プロジェクトのSysML v2 のコピーを作成…は、そのモデルを SysML v2 テキストとして新しい SysML v2 プロジェクトに書き込みます。
- SysML v2 プロジェクトのLML のコピーを作成…は、そのモデルを新しい LML プロジェクトの LML エンティティと関係に変換します。
元のプロジェクトが変更されることはありません。コピーを作成する前に、変換されるもの(件数付き)と変換されないもの(理由付き)がレポートに一覧表示されます。同じレポートが新しいプロジェクトに保存されます。
概念
種類の変更ではなく、コピー
変換は常に新しいプロジェクトを作成します。元のプロジェクトで作業を続け、後で再度変換できます。変換するたびに、新しいプロジェクトがもう 1 つ作成されます。コピーを元のプロジェクトに結び付けるものはありません。
2 つの言語の対応
LML と SysML v2 は、多くの同じものを異なる方法で記述します。変換では、この対応を双方向に使います:
| LML | SysML v2 |
|---|---|
| Asset | パート定義。使用される場所ごとにパート使用を持ちます |
| Asset の分解(decomposed by) | 親の定義内のパート使用 |
| Port | ポート使用 |
| Asset の Characteristic | 属性使用 |
| Conduit | 接続使用。両端がポートの場合はインターフェース使用 |
| Input/Output | in と out のアイテムパラメーターとフローを持つアイテム定義 |
| Requirement(Number、Name、Description) | 要求使用(ショートネーム、名前、doc) |
| satisfied by | satisfy |
| Test Case | verify 目的を持つ検証使用 |
| Test Suite | 検証ケースのパッケージ |
| Action とそのフロー | サクセッションを持つアクション使用 |
| SYNC と並列ブロック | フォークとジョイン |
| OR | デシジョンとマージ |
| LOOP | ループアクション |
| performed by | perform |
| 状態の Characteristic と遷移 | 遷移を持つ状態定義(パートがそれを示します) |
| Equation とその変数 | パラメーターを持つ制約定義 |
Holarch のデータも一緒に移る
どちらの言語にも置き場所のないデータもあります。それは Holarch のデータであり、リンクとともにコピーされます:
- リスク、判断、タスク、コスト、スケジュール、課題、ドキュメント、ホワイトボードはコピーされ、変換された要素にリンクされたまま残ります。
- 要求のステータスと検証方法は各要求に、テスト結果は各テストケースに残ります。クラスのワークフローのカスタム状態も保持されます。
- スキーマの変更は、状態、廃止された状態、遷移、承認者を含むクラスのワークフローも含め、双方向に引き継がれます。
- ディスカッションのコメントは、その要素に付いていきます。
- 判断の分岐確率は、シミュレーターのためにそれぞれの分岐に残ります。
- SysML v2 コピーから作成した LML コピーには、最初の変換で保持された LML の属性とラベルが戻ります。
変換されないもの
- ダイアグラムのレイアウト。ビューとダイアグラムは、コピーで新たに描画されます。
- 履歴、ベースライン、変更要求。コピーはそれらを持たずに始まります。
- LML の Measure や Resource、SysML v2 の列挙、計算、解析ケースなど、一方の言語に置き場所のない要素。
レポートには、そのような項目がすべて理由とともに示されます。レポートのリファレンスを参照してください。
使い方
使う場面と理由
プロジェクトの言語が作業に合わなくなったら、変換します:
- LML から SysML v2 へ:チームや顧客が SysML v2 で作業するようになった場合、またはモデルを SysML v2 ツールと交換する必要がある場合。変換してから、
.sysmlまたは JSON をエクスポートします(SysML v2 モデルの交換を参照)。 - SysML v2 から LML へ:SysML v2 プロジェクトにはない LML のページやダイアグラムが必要な場合、またはレビューのためにモデルを Holarch のライフサイクル形式にしたい場合。
モデルが安定してから変換し、コピーに頼る前にレポートを読みます。
変換したコピーを作成する
- プロジェクトを管理で、プロジェクトの行の⋯をクリックします。
- SysML v2 のコピーを作成…(LML プロジェクトの場合)またはLML のコピーを作成…(SysML v2 プロジェクトの場合)を選択します。
Holarch が変換をチェックします。大きなプロジェクトでは、ウィンドウ下部の進行状況バーに「Checking the conversion…」と表示されます。その後、レポートとともにダイアログが開きます。
- レポートを読みます:
- 変換済みには、項目の種類ごとに、その数と変換後のものが一覧表示されます(例:「Requirements 24 requirement usages」)。
- 変換されていませんには、変換されない項目の種類ごとに、その数と理由が一覧表示されます。
- Holarch の外でレポートが必要な場合は、レポートをダウンロード(CSV)をクリックすると、項目ごとに 1 行のレポートが保存されます。
- 新しいプロジェクト名を入力します。既定値は、元の名前の後に「(SysML v2)」または「(LML)」を付けたものです。
- コピーを作成をクリックします。
トーストには「Created "<name>"」と表示されます。コピーはそのホームページで開きます。
- コピーでドキュメントConversion reportを開きます。変換されなかったすべての項目が、番号と名前で一覧表示されます。
コピーを確認する
- SysML v2 コピーで、モデル → エディターを開きます。
モデルは、プロジェクトの名前を付けた 1 つの最上位パッケージです。その中に Architecture、System、Items、Requirements、Verification、Behavior、Constraints、Views の各パッケージ(内容のあるものだけ)があります。
- ガターで問題のマークを探します。変換されたテキストに問題がある場合は、コピーを作成する前にダイアログでそのことが示されています:「The converted text has N problems. The copy shows them in its Editor.」
- ビューでビュー(Architecture Overview、System Connections)を開くと、新たに描画された構造が表示されます。
- LML コピーでは、データベースとダイアグラムを開いて、Asset、Requirement、アクションフローを確認します。
作業例:Hybrid Car デモの LML コピー
まずデモを作成します:プロジェクトを管理で、プロジェクトファイル ▾ → 新しいデモプロジェクト → Hybrid Car (SysML v2)をクリックします。
- プロジェクトを管理で、Hybrid Car (SysML v2 demo)の⋯をクリックし、LML のコピーを作成…を選択します。コピーの名前は「Hybrid Car (SysML v2 demo) (LML)」になります。
- レポートを読みます。
変換済みの下:パート使用は Asset に、ポート使用は Port に、属性は Characteristic に、接続使用とインターフェース使用は Conduit に、要求使用と要求定義は Requirement に、検証使用は Test Case に、アクションは Action に、状態と遷移は LML の対応するものになります。
変換されていませんの下には、特に次のものがあります:
- 特化:LML には特化がありません。パートには、その一般定義のフィーチャーがコピーされます。
SportCar :> Carがその一例です。 - 再定義:コピーされた各パートで、再定義するフィーチャーが継承したものを置き換えます。セダンのバッテリーは 48 kg でコピーされます。
- 列挙(
DriveMode、FuelKind):属性値はテキストとして保持されます。 - 計算(
PowerToWeight、ElectricRange)と解析ケース(PowerToWeightAnalysis)。 - バインディングコネクター(
bind output = transmission.output;):LML にはフィーチャー間のバインディングがありません。 - 属性値:各 Characteristic の Value にテキストとして保持されます。単位と式は評価されません。
- ビュー:ダイアグラムは LML コピーで新たに描画されます。
- 特化:LML には特化がありません。パートには、その一般定義のフィーチャーがコピーされます。
- コピーを作成をクリックします。
LML コピーが開きます。
fleet.sedanとそのパートは Asset です。要求Sedan Mass(VR-1.1)は、セダンの Asset によって満足される Requirement です。デモのリスク、判断、タスクもコピーされ、変換された要素にリンクされます。
逆方向を試すには、CubeSat EO-1 デモ(LML プロジェクト)を作成し、そこでSysML v2 のコピーを作成…を選択します。
ヒントとよい進め方
- 変換する前に LML プロジェクトを整理します。各 Conduit をちょうど 2 つの Asset または Port に接続し、各 Characteristic を Asset または Equation に関連付け、空の Test Suite を除去します。そうしないと、それらは変換されていないものとして報告されます。
- LML では、OR 分岐のラベルをガードにしたい場合は、モデルの値に対するブール式(
speed > 3など)として書きます。その他のラベルは、サクセッションの doc コメントになります。 - SysML v2 では、アクターにパート定義の型を、アイテムパラメーターにアイテム定義の型を付けます。型のないものは変換されません。
- 元のプロジェクトを残しておきます。大きな変更の後は、両方のプロジェクトを並行して編集するのではなく、元のプロジェクトから再度変換します。
よくある間違い
- 元のプロジェクトが変わると思っている。変わりません。コピーは別のプロジェクトです。
- ダイアグラムのレイアウトが保持されると思っている。レイアウトは変換されません。新しいビューやダイアグラムを配置し直してください。
- LML コピーでパートが足りない。LML にはインスタンスしかないため、どのパートにも使われていないパート定義には LML の Asset がありません。その定義をパートで使ってから、再度変換します。
- レポートに「does not resolve」の項目がある。SysML v2 テキスト内の名前が何も指していません。エディターで名前を修正してから、再度変換します。
レポートのリファレンス
LML から SysML v2 へ
変換される項目には、Asset(パート定義とそのパート使用)、Characteristic(属性)、Port、Conduit(接続またはインターフェース)、Input/Output(アイテム定義)、Requirement、Action とユースケース、アクション間のアイテムフロー、State、Transition、Equation(制約定義)、Performs、Test Suite、Test Case、Verifies、Satisfies、および Holarch の項目(リンクとともにコピー):成果物、ステートメント、タスク、リスク、スケジュール項目、コスト、課題、判断、ハザード、故障モードがあります。クラスのワークフロー(プロジェクトのスキーマ変更)はカスタム状態、遷移、承認者とともに引き継がれるため、要求とテストケースはカスタムの Status 値を保持します。コピーには、プロジェクトの Formal program と Safety & Reliability のスイッチも引き継がれます。
| 変換されていません | 理由 |
|---|---|
| 分解のループ内にある Asset | 自分自身を含む Asset は、パートツリーに置き場所がありません。そのパート定義は変換されますが、パートとしては使用されません。 |
| 端がちょうど 2 つではない Conduit | SysML の接続は 2 つの端を結びます。Conduit を 2 つの Asset または Port に接続してから、再度変換します。 |
| Conduit が転送する項目 | この変換の接続はアイテムを運びません。項目は、アイテム定義とアクション間のフローとして変換されます。 |
| 他の Conduit に分解された Conduit | ここでは SysML の接続は入れ子になりません。各 Conduit はそれぞれ独立した接続になります。 |
| ループの回数とループスクリプト | ここでの SysML のループは条件を満たすまで繰り返します。回数は Holarch のデータとして保持され、LML のコピーを作成するときに復元されます。 |
| 判断の分岐ラベルと確率 | 判断のすべてのラベルがモデルの値に対するブール式である場合、ラベルはそのガードになります。そうでない場合は、サクセッションの doc コメントになります。確率はシミュレーターのために Holarch のデータとして保持され、どちらも LML のコピーを作成するときに復元されます。 |
| OR、SYNC、LOOP の項目 | これらの構成は、decide/merge、fork/join、ループのノードとして変換されます。それらを名付けていた項目は保持されません。 |
| 状態の entry、do、exit アクション | アクションはアクションとして変換されます。この変換では、SysML の状態の本体は埋められません。 |
| 1 つのマシンの 2 つの状態を結ばない遷移 | SysML の遷移は、同じ状態定義の 2 つの状態を結びます。 |
| 遷移のガードとトリガー | これらは LML では自由記述のテキストで書かれます。SysML の式としてではなく Holarch のデータとして保持され、LML のコピーを作成するときに復元されます。 |
| Asset によって規定されていない状態 | 状態には、その振る舞いを記述する対象の Asset が必要です。 |
| Equation の式 | 式は SysML のフィーチャーではない名前を使っています。それぞれが、その制約定義内のコメントとして保持されます。 |
| テストケースのない Test Suite | スイートは、その検証ケースのパッケージになります。空のスイートには入れるものがありません。 |
| 要求以外のものを検証するテストケース | SysML の検証ケースは要求だけを検証します。 |
| テストサイクル | スイートに記録されたテストの実行はモデルの一部ではありません。各ケースの最新の結果が保持されます。 |
| 他の種類の項目によって満足される要求 | たとえば、SysML では要求が別の要求を満足することはありません。テキストで派生を使います。 |
| その他の関係 | この変換には、それらに対応する SysML の関係がありません。レポートにはそれぞれが示されます。 |
| Measure | この変換では、有効性の尺度に対応する SysML の要素がありません。 |
| Resource | リソースの量(consumes、produces)は LML のシミュレーターに属するもので、ここでは SysML の要素がありません。 |
| Asset にも Equation にも関連付けられていない Characteristic | 属性には所有者が必要です。Asset で規定するか、Equation の変数にします。 |
| その他のクラスの項目 | このクラスには、SysML v2 プロジェクトにおける SysML の要素も Holarch の置き場所もありません。 |
| フィーチャーと構成 | まだ対応していません:プロダクトラインのフィーチャーと構成は、SysML v2 の可変点、バリアント、構成になりません。レポートでは、それらが Feature 項目と Configuration 項目として一覧表示されます。コピーでバリアントをモデル化し直してください(SysML v2 のバリアントと構成を参照)。 |
| ベースライン | LML プロジェクトのベースラインは新しいモデルには適用されません。コピーはベースラインなしで始まります。 |
| 履歴 | 変更履歴は、コピーで新たに始まります。 |
| 変更要求 | LML の変更要求は LML の項目への変更を提案するもので、コピーにはそれらの項目がありません。 |
| ダイアグラムのレイアウト | ダイアグラムは SysML v2 のビューとして新たに描画されます。位置は引き継がれません。 |
| ドキュメントのアウトライン内の変換された項目 | ドキュメントはコピーされます。そのアウトライン内の要求やその他のモデル項目は SysML の要素になり、アウトラインではなくモデルに表示されます。 |
SysML v2 から LML へ
各パート使用は Asset になり、その定義(およびそれが特化する定義)のパート、ポート、属性がコピーされます。再定義は、再定義対象を置き換えます。接続とインターフェースは、それらの Asset 間の Conduit になります。要求、検証ケース、satisfy、verify、perform、アイテムパラメーター、状態、遷移は、上の表のとおりに逆変換されます。サクセッションはアクションフローになります。判断のガード(またはそのサクセッションの doc コメント)は、確率とともに OR 分岐のラベルになります。プロジェクトのスキーマ変更は、カスタム状態、遷移、承認者を含むクラスのワークフローも含めて引き継がれるため、要求とテストケースはカスタムの Status 値を保持します。
| 変換されていません | 理由 |
|---|---|
| 端が解決されない接続 | テキストで端の名前を修正してから、再度変換します。 |
| どのパートにも使われていない定義内の接続 | 各接続は、それを持つすべてのパートのパート間の Conduit になります。この定義を使っているものはありません。 |
| バインディングコネクター | LML には、フィーチャー間のバインディング(等価)がありません。 |
| 解決されない verify 関係 | 検証目的内の要求名を修正してから、再度変換します。 |
| アイテム定義のないアイテムパラメーター | 変換するには、パラメーターに item def で型を付けます。 |
| モデル内にパート定義のないアクター | 変換するには、アクターに part def で型を付けます。 |
| アクションとパートに解決されない perform 使用 | パート定義またはパート使用からアクションを perform してから、再度変換します。 |
| 解決されない satisfy 関係 | satisfy 文の名前を修正してから、再度変換します。 |
| 構造化されたフローではないサクセッション | LML のアクションフローは、並列、判断、ループのブロックを持つ順序です。その他のサクセッションのグラフは直線化されます。 |
| どのパートも示していない状態定義 | 状態は、その振る舞いを記述する対象の Asset なしで変換されます。 |
| 2 つの状態に解決されない遷移 | 状態の名前を修正してから、再度変換します。 |
| 遷移のトリガー(accept) | LML の遷移は、トリガーを自由記述のテキストとしてのみ保持します。受け付けるシグナルはリンクされません。 |
| ポート、インターフェース、接続の定義 | パートがそれらを使っている箇所では Port と Conduit として変換されます。LML にはポート、インターフェース、接続の型がありません。 |
| 属性定義(値型) | LML の Characteristic には型がありません。 |
| 列挙と列挙値 | LML には列挙がありません。属性値はテキストとして保持されます。 |
| 計算、解析ケース、関心事 | LML には、計算、解析ケース、ステークホルダーの関心事がありません。 |
| ビューとビューポイント | ダイアグラムは LML コピーで新たに描画されます。 |
| 代入、if、send、accept アクション | LML のアクションには文がありません。 |
| 依存関係 | LML には汎用の依存関係がありません。 |
| 割り当て | パートが実行するアクションには、テキストで perform を使います。 |
| メタデータ | LML にはメタデータがありません。 |
| オカレンス | LML にはオカレンスがありません。 |
| 包含されたユースケース | ユースケース間の包含関係は変換されません。 |
| エイリアス | LML のエンティティはそれぞれ 1 つの名前を持ちます。 |
| 参照使用(計算とケースのパラメーター) | LML には、Equation の変数以外のパラメーターがありません。 |
| 特化 | LML には特化がありません。パートには、その一般定義のフィーチャーがコピーされます。 |
| 再定義 | コピーされた各パートで、再定義するフィーチャーが継承したものを置き換えます。 |
| サブセット化 | LML にはサブセット化がありません。 |
| インポート | LML には名前空間がありません。すべてのエンティティがプロジェクト内で参照できます。 |
| 使用と区別される定義 | LML にはインスタンスしかありません。パート定義はそれを使うパートの Asset になり、そのテキストはそれらの説明に入ります。 |
| パート以外の多重度 | LML に置き場所があるのはパートの多重度(decomposed by の Multiplicity)だけです。 |
| 属性値 | 値は各 Characteristic の Value にテキストとして保持されます。単位と式は評価されません。 |
| ベースライン | SysML v2 プロジェクトのベースラインは LML コピーには適用されません。コピーはベースラインなしで始まります。 |
| 履歴 | 変更履歴は、コピーで新たに始まります。 |
| 変更要求 | SysML の変更要求はテキストの変更を提案するもので、LML のエンティティには適用されません。 |
レポート CSV
レポートをダウンロード(CSV)は、変換された項目の種類ごとに 1 行、変換されなかった項目ごとに 1 行を書き出します。列は結果(Converted または Not converted)、What、Count、Becomes or reason、Number、名前です。
メッセージ
| メッセージ | 意味と対処法 |
|---|---|
| Checking the conversion…(進行状況バー) | レポートを準備しています。 |
| これはすでに SysML v2 プロジェクトです。代わりに「LML のコピーを作成…」を選択してください。 | 誤った方向が選択されました。 |
| これはすでに LML プロジェクトです。代わりに「SysML v2 のコピーを作成…」を選択してください。 | 誤った方向が選択されました。 |
| 変換されたテキストに N 件の問題があります。コピーのエディターにそれらが表示されます。 | コピーは作成できます。そのエディターで問題を修正してください。 |
| 変換されたテキストを解析できません(…)。プロジェクトはコピーされませんでした。プロジェクトファイルを添えて報告してください。 | 変換が失敗しました。プロジェクトファイルを添えてサポートに連絡してください。 |
| SysML チェッカーが起動しませんでした。ページを再読み込みして、もう一度お試しください。 | 再読み込みして、もう一度試します。 |
| プロジェクトを読み取れませんでした。ページを再読み込みして、もう一度お試しください。 | 再読み込みして、もう一度試します。 |
| コピーは作成されませんでした:… ページを再読み込みして、もう一度お試しください。 | 再読み込みして、もう一度試します。 |
| 「<name>」を作成しました | コピーが作成され、開かれました。 |
制限事項
- ダイアグラムのレイアウト、履歴、ベースライン、変更要求は変換されません。
- まだ対応していません:LML のプロダクトライン(フィーチャーと構成)から SysML v2 のバリアントへの変換。
- レポートのドキュメントには、種類ごとに最大 500 件の項目が一覧表示されます。
関連ページ
SysML® および OMG® は、米国およびその他の国における Object Management Group, Inc. の登録商標です。