Holarch

SysML v2

SysML v2 プロジェクトのシミュレーションメタデータ

HolarchSimulation メタデータライブラリ:SysML v2 モデルが、シミュレーター向けの所要時間、分岐確率、ループ回数、リソース、コスト、ステートマシンの設定をどのように保持するか、そしてそれらをどのように書き、移動するかを説明します。

使い方 →

このページの内容
  1. 概要
  2. 概念
    1. 公称値と分布
    2. どの設定が優先されるか
    3. 2 つのシミュレーター
  3. 使い方
    1. 使う場面と理由
    2. 所要時間、確率、ループ回数を設定する
    3. テキストで注釈を書く
    4. 古い設定をモデルに移動する
    5. ステートマシンをシミュレートする
    6. 作業例:Hybrid Car デモ
    7. ヒントとよい進め方
    8. よくある間違い
    9. 他の機能とのつながり
  4. 注釈
    1. 分布
    2. 相関のある入力
    3. 確率と回数
    4. リソースとコスト
    5. SysML エンジンが必要な注釈
  5. メッセージ
  6. 制限事項
  7. 関連

概要

SysML v2 プロジェクトでは、シミュレーターの設定はモデルの一部です。これらは、すべての SysML v2 プロジェクトが読み込むライブラリパッケージ HolarchSimulation のメタデータ注釈です。これらを使うモデルは有効な SysML v2 のままです:他のツールは注釈を通常のメタデータとして読み取り、意味を与えるのはシミュレーターだけです。

注釈は、注釈対象の要素の中に置くか、about でその要素を指定します。

succession toCruise first shift if speed > 30 then cruise {
  @HolarchSimulation::Probability { percent = 70; }
}
metadata HolarchSimulation::Cost about DriveCycle::drive { amount = 0.4; unit = "USD"; label = "Energy"; }

概念

公称値と分布

ステップの所要時間は、その属性 duration(または DurationValue か TimeValue を型とする属性)です。その値は、他のツールと Holarch の評価が参照する公称の所要時間です。その属性に分布の注釈を付けると、シミュレーターは代わりに所要時間を抽出します。

action cruise {
  attribute duration : ISQ::DurationValue = 1 [min] {
    @HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
  }
}

どの設定が優先されるか

  • 分布の注釈は、属性自身の値より優先されます。
  • モデルが評価できるガード、if の条件、ループの条件は、それ自体で決まります。ProbabilityまたはLoopCountは、評価できない場合にのみ使われます(LoopCountは常に繰り返し回数を数えます)。
  • シミュレーション設定がモデルに移る前に行った設定は、モデルの隣に Holarch のデータとして保持されます。移動するまではそれらが優先されるため、実行結果は変わりません(古い設定をモデルに移動するを参照)。

2 つのシミュレーター

シミュレーターページには、設定の右側に、モデルを実行するシミュレーターが表示されます:SysML エンジン(Holarch Language Engine のシミュレーター)またはJavaScript シミュレーター。どちらも同じ注釈を読み取ります。ステートマシン、刺激、Resource、Consumes、Produces、Seizes によるリソース、Cost によるコスト、およびSysML エンジンが必要な注釈にあるその他の注釈は、SysML エンジンでのみ実行されます。

使い方

使う場面と理由

モデルが設計の記録である場合は、シミュレーション設定をモデルに書き込みます:数値は .sysml ファイルと一緒に移動し、テキストのレビューに現れ、モデルの他の部分と一緒にバージョン管理されます。運用シナリオ(タイムライン、分岐の割合、リソースの使用)を分析する間や、モンテカルロスタディに照らして要求をチェックする前に使います。

所要時間、確率、ループ回数を設定する

  1. Action Flow ビュー、ブラウザー、またはエディターで、ステップ、サクセッション、判断、ループ、if アクションを選択します。
  2. インスペクターのシミュレーションセクションで、Duration(固定値または分布)、確率 (%)、反復回数、then の確率(%)を設定します。
  3. Holarch は注釈をモデルに書き込みます:Durationは属性の値を平均値に設定して分布の注釈を追加し(ステップに属性がない場合は attribute duration : ISQ::DurationValue を書き込み)、確率 (%)はProbabilityを、反復回数はLoopCountを書き込みます。各変更は 1 回の元に戻すで取り消せ、すぐにテキストに表示されます。
  4. 注釈を除去するには、フィールドを空にします。

Holarch は、各変更を書き込む前に SysML チェッカーでチェックします。エラーが増える変更は書き込まれず、メッセージに問題が示されます。

テキストで注釈を書く

  1. エディターを開きます。
  2. 要素の本体の中に @HolarchSimulation::Kind { field = value; } として、またはその後に metadata HolarchSimulation::Kind about element { … } として注釈を追加します。
  3. Consumes、Produces、Seizesでは、最初にステップ、次にリソースを指定します:metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }。

古い設定をモデルに移動する

シミュレーション設定がモデルに移る前に設定を行ったプロジェクトでは、シミュレーターの設定の上に Some simulation settings of this project are Holarch data, not part of the model. と表示されます。

  1. シミュレーション設定をモデルに移動…をクリックします。
  2. プレビューに、各設定とそれを置き換える注釈が一覧表示されます。
  3. モデルに移動をクリックします。すべての設定が移動し、1 回の元に戻すですべて取り消せます。実行結果は変わりません。

ステートマシンをシミュレートする

ステートマシンは SysML エンジンで実行されます。

  1. 振る舞い → シミュレーターを開き、ルートとして状態定義、または状態を exhibit するパートを選択します。
  2. 任意:同時に実行で、パートにシグナルを送るシナリオアクション(デモの TestDrive など)を選択します。
  3. 刺激で+ 刺激を追加をクリックし、時点(時刻と単位)、シグナル、To(マシン、またはそれを受け付けるすべてのマシン)を設定します。
  4. ▶ 再生、⏭ ステップ、または⏩ 最後まで実行を押します。実行中のステートマシンはアクティブな状態を点灯させ、発火した遷移に印を付けます。状態タブにはStates over timeとTransitions firedが表示されます。
  5. モンテカルロでは、状態タブに状態での滞在時間とTransition countsが表示されます。要求に照らしてチェック…では、各状態の滞在時間と実行に占める割合が出力として提示されます。

状態遷移ビューでは、▶ シミュレートで▶ 再生、⏭ ステップ、⏩ 最後まで実行、リセット、シミュレーターで開くを含むバーが開きます。実行には、シミュレーターでその状態定義に保存された刺激が使われます。

作業例:Hybrid Car デモ

Hybrid Car デモ(プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト)はこのライブラリを使っています。

  • DriveCycle:shift の後のサクセッション toCruise のProbabilityは 70 で、else 分岐が残りの 30 % を取ります。cruise は公称 1 min で、Triangular 分布(45 s、1 min、2 min)から抽出されます。
  • DrivenCar:パワートレインのバッテリーは 62 Wh のResourceです。drive はそのうち 1.5 Wh をConsumesし、1 回あたり 0.4 USD のCostがあります。
  • PowertrainStates:遷移 startElectric のガードにはProbability 80 があります。accept when charge < 15 は充電量が下がるとハイブリッドに切り替え、accept after 30 [min] は充電を終了します。
  • TestDrive:StartRequest を送り、1 時間待ってから、StopRequest と PlugIn を demoCar に送るシナリオです。Demo CarをTest Driveと同時に実行すると、パワートレインの状態の変化を確認できます。

デモのチェック結果は診断 0 件です。

ヒントとよい進め方

  • 公称値には意味を持たせます:インスペクターと同様に、分布の期待値に設定します。
  • 注釈を付けるサクセッションには名前を付けます(succession toCruise first …)。そうすればテキストで注釈を見つけやすくなります。
  • 確率より、モデルが評価できる条件を優先します。Probabilityは、モデルが記述していないものに使います。

よくある間違い

  • 確率が効かない:ガードが評価できるため、ガードで決まります。インスペクターには「Evaluates to true: always taken.」または「Evaluates to false: never taken.」と表示されます。
  • 分岐の確率の合計が 100 % にならない:Probabilityのない分岐が残りを分け合います。指定した確率が 100 % を超える場合、警告は「Branch probabilities add up to N %. Change them to total 100 %.」です。
  • ステップ自体に所要時間の注釈を付ける:分布はアクションではなく、所要時間の属性に付けます。

他の機能とのつながり

注釈

分布

分布は所要時間の属性に付けます。位置と尺度のフィールドには単位付きの量(45 [s]、2 [min])、形状のフィールドには数値を指定します。

注釈フィールド意味
正規分布mean, sd正規分布。
三角分布low, mode, high三角分布。low ≤ mode ≤ high。
一様分布low, highlow と high の間の一様分布。
Exponentialmean指定した平均を持つ指数分布。
Gammashape, scaleガンマ分布。平均は shape × scale です。
LogNormalmedian, sigma対数が中央値の対数を中心とした正規分布になります。
Weibullscale, shapeワイブル分布。
Betaalpha, beta, scale0..1 上のベータ分布に scale を掛けたもの。
Poissonmean, scale指定した平均を持つ回数に scale を掛けたもの。
Binomialtrials, p, scale一定回数の試行での成功数に scale を掛けたもの。

0 未満で抽出された所要時間は抽出し直されます。

相関のある入力

相関がない場合、分布から抽出される値はすべて互いに独立です。Correlationは 2 つの値を連動させます。

metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
注釈対象意味
Correlation coefficientabout a, b:それぞれ分布を持つ 2 つの属性値の順位(スピアマン)相関で、-1 から 1 です。0 は独立、1 は常に同じ順位、-1 は逆の順位です。
  • 各属性は独自の分布を保持します。シミュレーターはすべてのペアを 1 つの相関行列(ガウスコピュラ)にまとめます:1 回の実行で属性に対して n 番目に抽出された値は、それと相関するすべての属性の n 番目の値と組になります。
  • 相関する属性のグループの係数は、互いに整合している必要があります:a が b と強く、b が c と強く相関しながら、a が c と逆相関することはありえません。チェックはそのようなグループを報告します。係数の 1 つを弱めてください。
  • 所要時間と量(Consumes、Produces、Seizes)は同じように相関します。同じシードで実行すると同じ値になります。
  • シミュレーターで、SysML エンジンのモンテカルロモードでは、相関のある入力にルートのペアが一覧表示されます。2 つの属性と係数を選択して+ 相関を追加をクリックするか、係数を変更するか、×をクリックして除去します。各変更は 1 回の元に戻すで取り消せます。スタディの後、達成には実行で抽出された値の順位相関が表示されます。
  • Hybrid Car デモの ChargeStop は、空いている充電器の待ち時間を充電時間と相関させています(0.6)。

確率と回数

注釈対象意味
Probability percent判断から出るサクセッション分岐の重み。重みのない分岐は 100 の残りを分け合います。
if アクション条件を評価できない場合に then 分岐が選ばれる確率。
ループアクション各回の後に繰り返す確率。
遷移ガードを評価できない場合にガードが成り立つ確率。
LoopCount countループアクション繰り返し回数。ループの条件より優先されます。
LoopExitループ本体内の done へのサクセッションその回だけでなく、ループ全体を終了します。

リソースとコスト

注釈対象意味
Resource initial、minimum、maximum、unitパート使用またはアイテム使用ある量のプール。使用が attribute level : Real を宣言している場合、シミュレーターはそれを量と等しく保つため、ガードから読み取れます。
Consumes amountabout step, poolステップの開始時に取られます。
Produces amountabout step, poolステップの終了時に追加されます。
Seizes amountabout step, poolステップの開始時に取られ、終了時に返されます。
Utilization amountperform アクション使用ステップが実行パートをどれだけ占有するか。
Cost amount、rate、unit、labelステップまたは実行パート1 回あたり(CostRate::perUse)または 1 時間あたり(CostRate::perHour)のコスト。

SysML エンジンが必要な注釈

注釈意味
Transfer latency、capacity、per接続またはインターフェース上:それを通じて送られるアイテムとシグナルを遅延させます。
Size sizeアイテム上:転送遅延のためのサイズ。
Timeout limit結合上:上限に達すると、終わっていない分岐を停止します。
NotBefore timeステップ上:この実行時刻より前には開始しません。
ForkTargets、JoinSources並行状態に入る、または並行状態から出る遷移上:入るサブ状態、またはアクティブである必要があるサブ状態。
History deep複合状態上:再び入ると、出たときにアクティブだったサブ状態から再開します。
HostHook key、pointsHolarch 用に予約:実行は、一覧にあるポイントで入力のために一時停止します。

JavaScript シミュレーターは、Probability、LoopCount、分布を読み取ります。

メッセージ

メッセージ意味
このプロジェクトのシミュレーション設定の一部は、モデルの一部ではなく Holarch のデータです。古い設定がまだモデルの隣に保存されています。シミュレーション設定をモデルに移動…をクリックしてください。
シミュレーション設定がモデルに移る前の Holarch のデータで、モデルより優先されます。インスペクターのシミュレーションセクションに表示されます。フィールドを変更してモデルに書き込むか、シミュレーターですべての設定を移動します。
モデルに所要時間がありません。ここで設定する(attribute duration : ISQ::DurationValue が書き込まれます)か、テキストに書いてください。ステップに所要時間の属性がありません。
@Normal: sd must be greater than zero. Change sd.(他の分布とパラメーターでも同様)分布のパラメーターがないか、範囲外です。SysML エンジンでは、モデルチェックがエディターで報告し、修正されるまでシミュレーターは実行を拒否します。
@Normal: sd has another unit dimension than …位置または尺度のパラメーターが、属性とは別の単位を持っています。例えば、所要時間にメートルを使っています。
@LoopCount does not apply to a part …注釈が、適用されない種類の要素に付いています。移動するか削除してください。
metadata Consumes … about needs an action and a part or item annotated @Resource.about の後の要素の数または種類が正しくありません。
N % の確率は 0~100 の範囲外です。0~100 のパーセントを入力してください。
この判断の分岐の確率の合計は N % です。シミュレーターはそれを 100 % に換算します。警告:すべての分岐に重みがあり、合計が 100 になっていません。
A correlation needs two different attributes …、… is not an attribute …、または … has no distribution, so nothing is drawn to correlate …Correlationが、1 つの属性を 2 回指定しているか、属性でないものを指定しているか、分布のない属性を指定しています。
The coefficient N is outside -1 to 1. または The correlation has no coefficient.-1 から 1 の係数を入力してください。
“a” and “b” are already correlated; the first correlation is used. …警告:同じペアの 2 つ目のCorrelationは無視されます。2 つのうち 1 つを除去してください。
The correlations of … contradict each other: no joint distribution has them …グループの係数が両立しません(行列が半正定値ではありません)。1 つを弱めてください。修正されるまでシミュレーターは実行を拒否します。
Deadlock at <time>: N steps wait for something that never comes.SysML エンジンで、待機中の各ステップとともに結果の上に表示されます。送信者のない accept、生成されないアイテム、解放されないリソースは実行を停止させます。

制限事項

  • 所要時間は秒、分、時間、日(SI::s、SI::min、SI::h、SI::d)で書かれます。ミリ秒は秒として、週、月、年は日として書かれます。
  • ステートマシン、刺激、同時に実行には SysML エンジンが必要です。
  • 相関のある入力には SysML エンジンが必要です。JavaScript シミュレーターはすべての値を独立に抽出します。1 つのグループで相関させられる属性は最大 200 個です。
  • 矛盾する係数のチェックは、1 つの名前空間に書かれた相関を対象とします。シミュレーターは実行のすべての相関をチェックします。

SysML® および OMG® は、米国およびその他の国における Object Management Group, Inc. の登録商標です。