Holarch

SysML v2

LML と SysML v2 の間の変換

LML プロジェクトの SysML v2 コピー、または SysML v2 プロジェクトの LML コピーを作成し、変換される内容とされない内容のレポートを確認します。

使い方 →

このページの内容
  1. 概要
  2. 概念
    1. 種類の変更ではなく、コピー
    2. 2 つの言語の対応
    3. Holarch のデータも一緒に移る
    4. 変換されないもの
  3. 使い方
    1. 使う場面と理由
    2. 変換したコピーを作成する
    3. コピーを確認する
    4. 作業例:Hybrid Car デモの LML コピー
    5. ヒントとよい進め方
    6. よくある間違い
  4. レポートのリファレンス
    1. LML から SysML v2 へ
    2. SysML v2 から LML へ
    3. レポート CSV
  5. メッセージ
  6. 制限事項
  7. 関連ページ

概要

プロジェクトの種類(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 は、多くの同じものを異なる方法で記述します。変換では、この対応を双方向に使います:

LMLSysML v2
Assetパート定義。使用される場所ごとにパート使用を持ちます
Asset の分解(decomposed by)親の定義内のパート使用
Portポート使用
Asset の Characteristic属性使用
Conduit接続使用。両端がポートの場合はインターフェース使用
Input/Outputin と out のアイテムパラメーターとフローを持つアイテム定義
Requirement(Number、Name、Description)要求使用(ショートネーム、名前、doc)
satisfied bysatisfy
Test Caseverify 目的を持つ検証使用
Test Suite検証ケースのパッケージ
Action とそのフローサクセッションを持つアクション使用
SYNC と並列ブロックフォークとジョイン
ORデシジョンとマージ
LOOPループアクション
performed byperform
状態の 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 のライフサイクル形式にしたい場合。

モデルが安定してから変換し、コピーに頼る前にレポートを読みます。

変換したコピーを作成する

  1. プロジェクトを管理で、プロジェクトの行の⋯をクリックします。
  2. SysML v2 のコピーを作成…(LML プロジェクトの場合)またはLML のコピーを作成…(SysML v2 プロジェクトの場合)を選択します。

    Holarch が変換をチェックします。大きなプロジェクトでは、ウィンドウ下部の進行状況バーに「Checking the conversion…」と表示されます。その後、レポートとともにダイアログが開きます。

  3. レポートを読みます:
    • 変換済みには、項目の種類ごとに、その数と変換後のものが一覧表示されます(例:「Requirements 24 requirement usages」)。
    • 変換されていませんには、変換されない項目の種類ごとに、その数と理由が一覧表示されます。
  4. Holarch の外でレポートが必要な場合は、レポートをダウンロード(CSV)をクリックすると、項目ごとに 1 行のレポートが保存されます。
  5. 新しいプロジェクト名を入力します。既定値は、元の名前の後に「(SysML v2)」または「(LML)」を付けたものです。
  6. コピーを作成をクリックします。

    トーストには「Created "<name>"」と表示されます。コピーはそのホームページで開きます。

  7. コピーでドキュメントConversion reportを開きます。変換されなかったすべての項目が、番号と名前で一覧表示されます。

コピーを確認する

  1. SysML v2 コピーで、モデル → エディターを開きます。

    モデルは、プロジェクトの名前を付けた 1 つの最上位パッケージです。その中に Architecture、System、Items、Requirements、Verification、Behavior、Constraints、Views の各パッケージ(内容のあるものだけ)があります。

  2. ガターで問題のマークを探します。変換されたテキストに問題がある場合は、コピーを作成する前にダイアログでそのことが示されています:「The converted text has N problems. The copy shows them in its Editor.」
  3. ビューでビュー(Architecture Overview、System Connections)を開くと、新たに描画された構造が表示されます。
  4. LML コピーでは、データベースとダイアグラムを開いて、Asset、Requirement、アクションフローを確認します。

作業例:Hybrid Car デモの LML コピー

まずデモを作成します:プロジェクトを管理で、プロジェクトファイル ▾ → 新しいデモプロジェクト → Hybrid Car (SysML v2)をクリックします。

  1. プロジェクトを管理で、Hybrid Car (SysML v2 demo)の⋯をクリックし、LML のコピーを作成…を選択します。コピーの名前は「Hybrid Car (SysML v2 demo) (LML)」になります。
  2. レポートを読みます。

    変換済みの下:パート使用は 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 コピーで新たに描画されます。
  3. コピーを作成をクリックします。

    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 つではない ConduitSysML の接続は 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. の登録商標です。