振る舞い
シミュレーション
Action フローを離散事象シミュレーションまたはモンテカルロスタディとして実行し、時間、コスト、リソース、稼働率の結果を読み取り、判断をスクリプト化し、要求に対する検証結果を記録します。
概要
シミュレーターは、Action のフローを、その Action 図が描くとおりに、シミュレーション上の時間で実行します。2 つのモードがあります。
- 離散イベント:時間付きの 1 回の実行で、見守ったり、ステップごとに進めたり、判断に答えたりできます。どのアクションがいつ実行されるか、何を待っているか、Resource がどう増減するか、どの Asset が稼働中か、実行のコストがいくらかを示します。
- モンテカルロ:所要時間と判断をサンプリングした多数の独立した実行です。合計時間とコストのばらつき、パーセンタイル、累積確率曲線、選ばれた判断のパス、しきい値を満たす確率を示します。
シミュレーターはモデルを読み取り、実行中にモデルを変更することはありません。プロジェクトへの書き込みは 3 つの方法で行われます:ルートのアクションの設定(変更すると保存)、完了した各実行の実行記録、結果を記録…です。
概念
シミュレーターが読み取るもの
シミュレーターは、必要なものをすべてモデルから取得します。実行する前に、Action 図とエンティティの属性でこれらを設定します。
| モデル要素 | 取得元 | シミュレーションでの扱い |
|---|---|---|
| フロー | ルートの Action の Action 図:シーケンス、Parallel、SYNC、OR、LOOP、EXIT | 要素を順に実行します。分岐は並列に実行されるか、1 つが選ばれます。 |
| 所要時間 | 各 Action の Duration 属性(数値または分布と単位) | アクションにかかる時間。分解されたアクションは、その子フローと同じだけ時間がかかります。 |
| 分解 | 独自のフローを持つ子の Action | 親自身の所要時間の代わりに子フローを実行します |
| トリガー | アクションが receives する Input/Output(関係の属性 トリガー。false に設定しない限りオン) | アクションは、各トリガー I/O が生成されるまで待ちます |
| I/O の生成 | アクションが generates する Input/Output | アクションの終了時に、Conduit の遅延の後で利用可能になります |
| Conduit の遅延 | I/O を transfers する Conduit:Latency + サイズ ÷ Capacity | I/O の配信を遅らせます |
| Resource | Resource への consumes、seizes、produces の関係(Amount 付き、既定値 1) | 開始時に消費および占有されます。占有された量は終了時に解放されます。生産は終了時です。 |
| Asset の容量 | Amount 付きの performed by と、親の下での Asset の多重度 | アクションは、Asset に空き容量ができるまで待ちます |
| Asset の稼働時間 | アクションを実行するすべての Asset(performed by) | 稼働率(%)と稼働率のグラフ |
| コスト | Action または実行する Asset に incurred by される Cost エンティティ | 累積の総コストに加算されます |
| Calendar | ルートと各 Action の Start 属性 | カレンダーの日付でのみ使用されます |
| スクリプト | アクションまたは構造のシミュレーションのスクリプト | 所要時間の設定、分岐の決定、ユーザーへの確認、値の追跡を行うフック |
時間は秒単位で保持され、最も読みやすい単位(ms、sec、min、hr、days、months、years)で表示されます。
所要時間、判断、Resource、Asset、コスト、シードの詳しいルールは、下のシミュレーションのルールにあります。
使い方
使う場面と理由
機能フローが存在し、そのアクションに所要時間、実行者、Resource が設定されたらシミュレーションします。通常は機能分析の後、割り当てとアーキテクチャのトレードの段階です。
シミュレーションは次の問いに答えます。
- 運用にはどれくらい時間がかかり、その時間はどれくらい変動するか。
- どのアクションがクリティカルパス上にあるか。データ、Resource、Asset の容量を、どこで待っているか。
- バッテリー残量やデータストレージなどの Resource が制限内に収まるか。
- どの Asset が過負荷か。
- 性能要求(時間、コスト、Resource のレベル)が満たされる確率はどれくらいか。これは要求にリンクされた、分析による検証の結果になります。
離散イベントシミュレーションを実行する
- 運用の Action 図を開きます。
- ▶ シミュレーション ▾ → 離散イベントを選びます。
その Action をルート Actionとしてシミュレーターが開きます。
ほかの開き方:ナビゲーションレールの振る舞い → シミュレーター(シミュレーターの設定が保存されている Action、なければフローを持つ最初の Action で開きます。必要に応じて別のルート Actionを選びます)、または Action の開く場所 ▾ → シミュレーター。マウスで別のルート Actionを選ぶとすぐに開きます。キーボードでは、選んでから Enter を押します(または開くをクリックします)。
- 設定を確認します:上部のバーの設定をクリックします(そのツールチップに現在の設定が表示されます)。主な設定は、判断、速度、± % 付きの固定の所要時間を変動させる、乱数シード、カレンダーの日付です(設定を参照)。
- ▶ 再生を押します。
クロックが進み、Action の時間推移(タイムラインタブ)が伸びていきます。実行中の Action 図では、各アクションが実行中は緑、待機中はオレンジ、終了すると灰色になります。
- ⏸ 一時停止を押すと、停止して調べられます。
- ⏭ ステップを押すと次のイベントに進み、⏩ 最後まで実行を押すとアニメーションなしで完了します。
- Input for … というタイトルのダイアログが表示されたら、パスを選ぶか値を入力します。
- OK をクリックします。
実行は、再生、ステップ実行、最後まで実行のいずれか、それまでと同じ状態で続きます。
- 実行が終わったら結果を読みます。
- ステータス:100% 完了、デッドロック、停止のいずれか。デッドロックの後は、実行が停止した時点と、待機中の各アクションが何を待っているかが表示されます。たとえば 0 ms で停止: F1 Separate and Detumble は ADCS Sensor Data を待っていますが、それより前のアクションはこれを生成しません。 です。アクションの名前をクリックすると調べられます。
- 合計時間と総コスト
- Resource と稼働率のパネル
- 警告を確認するコンソール
- 任意のバーやグラフの要素をクリックすると詳細が表示されます。
エンティティがインスペクターに開き、この実行での実行回数と実行時間が表示されます。開く場所 ▾ → 項目ビューでそのページが開きます。
- ⟲ リセットを押すと、実行がクリアされ、最初からやり直せます。
モンテカルロ分析を実行する
- ヘッダーをモンテカルロに切り替えます。Action 図からは、代わりに ▶ シミュレーション ▾ → モンテカルロを選びます。
- 実行(1~20,000、既定値 100)を設定します。
- 固定の所要時間にばらつきを持たせる場合は、固定の所要時間を変動させるを設定します。
- 分析を再現可能にする必要がある場合は、乱数シードを入力します。
- ▶ モンテカルロを実行を押します。
確率や回数のない OR や LOOP がある場合は、指定されていない判断ダイアログにそれらが一覧表示されます。
- そのダイアログで等確率を使用をクリックすると続行します。またはキャンセルをクリックし、Action 図で設定します。
進捗バーと、実行中のテキスト
k / n · mean … · mean cost …が表示されます。キャンセルをクリックすると停止し、トーストに「モンテカルロの実行を停止しました」と表示されます。分析が終わると、テキストにシミュレーションの件数と経過時間が表示されます。
- 完了した実行を読み、続いて分布タブ(統計、所要時間の分布、累積確率(S カーブ))と、要因タブの分岐の組み合わせを読みます。
デッドロックした実行や失敗した実行がある場合は、赤いボックスにその件数と P(failure) が 95% 信頼区間付きで表示されます。
- 実行が失敗した理由を見るには、失敗した実行を開いて実行を表示をクリックします。
その実行が、独自のシードで離散イベントモードで再生されます。
- モンテカルロの結果に戻るをクリックして戻ります。
要求をチェックして結果を記録する
モンテカルロ分析の後で、結果を検証の結果に変えるときに使います。
- 要求に照らしてチェック…をクリックします。
- 出力を選びます:合計時間、総コスト、各 Resource の最小量または最終量、あるいはスクリプトの数値のグローバル変数(グローバル: …)。
- しきい値は次の 2 つの方法のどちらかで設定します。
- Measure から:指標と使用(しきい値または目的)を選びます。フィールドは Measure から入力されます(下記参照)。
- 手動で:基準(≤ 以下または ≥ 以上)、値、単位を設定し、Requirement を選びます。
- 必要な確率(%)(既定値 90)を設定します。
結果の表が表示されます。
- 基準と実行
- 平均(95% CI)と P5 / P50 / P95
- P(meet)(95% 信頼区間付き)
- マージン(平均値としきい値)
- 結果:合格または不合格。
- 結果を記録…をクリックします。
結果を記録のプレビューに、行われる変更が一覧表示されます。
- Measure の Projected Value(または Value)が平均値に設定されます。
- Test Case が要求を検証します。「Simulation check: <output> <criterion>」という名前の新しい Test Case、または選んだ既存の Test Case です。その Status は Passed または Failed になり、Actual Result には結果のテキストが設定されます。
- スキップしたい行のチェックを外します。
- 適用をクリックします。
1 回の元に戻すですべて取り消せます。
手順 3 で Measure を選ぶと、フィールドは次のように入力されます。
- その値が値と単位に入ります。
- その Improvement Direction で基準が決まります:Negative なら ≤、Positive なら ≥ です。
- その Measure が specifies する Requirement が Requirement に入ります。
保存された実行
完了したすべての実行は自動的に保存されます。保存の操作はありません。
- 離散イベントの実行は、終了したとき(完了、デッドロック、停止)に保存されます。モンテカルロ分析は、すべての実行が終わったときに保存されます。キャンセルした分析は保存されません。
- 記録は Simulation Run のラベルが付いた Artifact で、
.simファイルを持ちます。名前は「<root> run <date> seed <n>」、たとえば「Perform Delivery Mission run 2026-10-14 09.30 seed 48213」、分析の場合は「<root> Monte Carlo <date> seed <n>」です。その説明に結果の概要が記載されます。 - 乱数シードのない実行にはシードが割り当てられるため、名前から再現方法がわかります。そのシードを入力して、もう一度実行します。
- トースト「<name> として保存しました。」は記録へのリンクです。
- モンテカルロの実行の再生と、開いた記録は再保存されません。閲覧者は記録を保存できません。
- 不要な記録は、データベースで削除します(ラベル Simulation Run で絞り込みます)。
古いプロジェクトではラベル名 Simulation Output が使われています。プロジェクトを開くと Simulation Run になり、インポートではどちらの名前も受け付けます。
保存された結果を再び開くには:
- ページヘッダーの保存された結果 ▾を開きます。
- 結果を選びます。
バナーに「保存された結果を表示中: …」と表示されます。その現在のモデルで再実行リンクは、現在のモデルを同じモードで実行します。
実例:CubeSat EO-1 の撮像パス
デモプロジェクトには、運用 OPS Run Nominal Imaging Pass があります。また、要求 6.5 Planning Cycle Time「The mission shall complete each planning cycle, from target list uplink to product delivery, within 100 minutes.」もあります。プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクトでデモを作成します。
OPS のフロー:
- 順に実行される 3 つのステップ:
- OPS.1 Transmit Imaging Plan(三角分布 4~9 分、ピーク 6、Ground Station)
- OPS.2 Receive Imaging Plan(1 分)
- OPS.3 Load Command Schedule(2 分)
- Parallel:OPS.4 Rotate to Target(正規分布、3 ± 0.5 分)と OPS.5 Prepare Camera(5 分)。どちらも、OPS.3 が生成する Command Schedule の I/O によってトリガーされます。
- LOOP Each target、4 回の反復:OPS.6 Capture Image Strip(正規分布、40 ± 6 秒)、続いて OPS.7 Encode and Store Image(一様分布 20~40 秒)。
- OR Contact in view?:
- Yes(75%)は OPS.8 Transmit Image Data(正規分布、8 ± 1.5 分)を実行します。
- No(25%)は OPS.9 Hold Data Onboard を実行します。
- Parallel:一方の分岐で OPS.10 Recharge Battery in Sunlight(35 分)。もう一方で OPS.11 Receive Downlink(9 分)、続いて OPS.12 Process Image Products(正規分布、45 ± 10 分)。
Resource:
- Battery Charge(初期値 62 Wh、最小値 23、最大値 77)。OPS.4~OPS.8 がこれを消費し、OPS.10 が生産します(+30 Wh)。
- Data Storage(初期値 1.5 GB)。OPS.7 ごとに 2.5 GB 増え、OPS.8 で 8 GB 減ります。
デモには OPS の設定が保存されています:シード 42、固定の所要時間に ±10% の一様な変動を加えた 200 回のモンテカルロ反復です。
実行します。
- 振る舞い → シミュレーターを開きます。
- ルート Actionとして OPS Run Nominal Imaging Pass を選び、離散イベントのままにします。
- ⏩ 最後まで実行を押します。
次のように表示されます。
- Action の時間推移には、OPS.4 と OPS.5 が並んで表示され、OPS.6 と OPS.7 の番号付きの 4 回の反復(
#2、#3、#4)が表示されます。 - 長い OPS.11 → OPS.12 の分岐が終了時刻を決めます。
- Resource タブの Resource のレベルの時間推移には、撮像中に Battery Charge が段階的に減り、OPS.10 の間に回復する様子が表示されます。
- デモには Cost エンティティがないため、総コストには「コストなし」と表示されます。
- Action の時間推移には、OPS.4 と OPS.5 が並んで表示され、OPS.6 と OPS.7 の番号付きの 4 回の反復(
- モンテカルロに切り替えます。
- ▶ モンテカルロを実行(200 回の実行)を押します。
分岐の組み合わせ(要因タブ)には、実行のおよそ 4 分の 3 が Yes に進んだことが表示されます。
- 要求に照らしてチェック…をクリックし、合計時間のままにします。
- Measure MOE-7 Planning Cycle Time と、使用にしきい値を選びます。
値は 100、単位は Minutes、基準は ≤、Requirement は 6.5 Planning Cycle Time になります。
- 90% のままにして、P(meet) と判定を読みます。
- 結果を記録…をクリックし、適用をクリックします。
MOE-7 の Projected Value に平均値が入ります。6.5 を検証する Test Case の Status が Passed または Failed になります。これで RVTM に、その Test Case が 6.5 に対して表示されます。
ヒントとよい進め方
- すべての末端のアクションに Duration を設定します。Duration のないアクションは時間がかからず、時間軸上に表示されません。
- 確信の持てない所要時間には分布を使います。固定の所要時間を変動させるは、簡単な感度チェックとしてのみ使います。
- モンテカルロの前に、すべての OR に確率を、すべての LOOP に反復回数を設定します。そうしないと各実行がランダムに選ぶことになり、結果にもその旨が示されます。
- 検証の結果を記録する前に乱数シードを設定し、結果を再現できるようにします。シードは記録されるテキストに含まれます。
- 十分な回数を実行します。必要な確率が信頼区間内にある場合、チェックに「より確かな判定のため、反復回数を増やしてください。」と表示されます。
- 設定は変更するとルートのアクションとともに保存されるため、プロジェクトと一緒に移動します。
よくある間違い
| 症状 | 原因 | 対処 |
|---|---|---|
| ステータスにデッドロックと表示され、コンソールに「I/O … を待機中(生成されない)」と表示される | アクションが、たどったパス上で何も生成しない I/O をトリガーとして受信している(たとえば OR の後) | すべてのパスで I/O を生成するか、receives 関係のトリガーを false に設定します |
| デッドロック「… を待機中(利用できない)」 | Resource がアクションに必要な量を二度と上回らないか、Asset の容量が 1 つのアクションの Amount より小さい | Initial Amount を増やすか、生産するアクションを追加するか、Amount と多重度を確認します |
| すべての実行の合計時間が同じになる | すべての所要時間が固定で、変動がなしになっている | 分布を使うか、固定の所要時間を変動させるを設定します |
| 「シミュレーションを中止しました:ステップ数が多すぎます(LOOP の回数または再帰的な分解を確認してください)。」 | LOOP の実行回数が多すぎるか、アクションが自身の分解の中にある | LOOP の回数を減らすか、分解を修正します |
| コンソールに「… でスクリプトエラー」と表示される | スクリプトが例外を投げた | アクションのスクリプト(Action 図のインスペクターのスクリプトを編集…)を開き、示された行を修正します |
| Asset の稼働率が空になっている | どのアクションも Asset に performed by されていない | アクションを、それを実行する Asset に関連付けます |
他の機能とのつながり
- 入力元:Action 図のフローと、そのアクション、I/O、Resource、Conduit、Asset、コストの属性と関係。機能分析で構築したフローも同じフローです。
- 出力先:
- Measure(Projected Value または Value)
- 要求を検証する Test Case、ひいては RVTM とテストセンター
- 保存された結果を持つ Artifact
- MS Project XML のスケジュールと CSV レポート。
シミュレーションのルール
このセクションでは、シミュレーターが所要時間、判断、Resource、Asset、コスト、乱数をどのように扱うかを正確に説明します。
所要時間と分布
- Duration は値と単位です:Milliseconds、Seconds、Minutes、Hours、Days、Weeks、Months、Years。単位のない値は時間(hours)として読み取られます。
- 値は固定の数値か、
=norm.dist(40, 6)や=triang.dist(4, 9, 6)などの分布です。 - 分布は実行のたびにサンプリングされます。
- サンプリングされた負の所要時間は、もう一度抽出されます。そのため正規分布は 0 で打ち切られたかのように振る舞います。
- 使える分布は 10 種類です:ベータ、二項、指数、ガンマ、対数正規、正規、ポアソン、三角、一様、ワイブル。属性の型と分布を参照してください。
- Duration が
=script()の場合は、実行のたびにアクションのduration()フックが呼び出されます。Duration の値に=script()と入力します。フックは Duration の単位で所要時間を返します(数値でない場合は 0 とみなされます)。
固定の所要時間を変動させるは、固定の数値にだけばらつきを加える設定です。分布にさらに変動が加わることはありません。
- Uniform ±% は、± その割合の範囲内で均等にサンプリングします。
- Triangular ±% は、固定値でピークになる三角分布からサンプリングします。
制御構造
| 構成要素 | シミュレーションでの振る舞い |
|---|---|
| Parallel(エンティティなし) | すべての分岐を一度に開始します。すべての分岐が終わると続行します。 |
| SYNC | Parallel と同じです。その Duration はタイムアウトです。期限が切れると、終わっていない分岐が停止され(ガントバーが赤くなり、「stopped by SYNC timed out」と表示)、フローが続行します。 |
| OR | 判断の種類(下記)で選ばれた、ちょうど 1 つの分岐に進みます |
| LOOP | 各回の前に次の間は繰り返すをチェックし、成り立つ間は本体を再実行します |
| EXIT | 囲んでいる LOOP を終了します。最上位ではフローを終了します。 |
OR の判断の種類:
- 確率:各分岐に確率(%)があります。空欄の分岐は、100% の残りを均等に分け合います。すべての確率が 0 の場合は、各分岐が等確率です。
- リソース量:各分岐は、選んだ Resource の現在の量を比較します(
==、!=、>、<、>=、<=)。条件が成り立つ最初の分岐に進み、どれも成り立たない場合は else の印が付いた分岐に進みます。 - スクリプト:構造の
onEnd()が、進む分岐の名前(またはそのインデックス)を返します。不明な名前の場合は警告が記録され、ランダムな分岐に進みます。 - なし(実行中に確認、またはランダム):判断が Ask (when no script) に設定されている場合は、どのパスに進むかをダイアログで尋ねます。それ以外の場合は、分岐がランダムに選ばれます。
LOOP の継続条件:
- 反復回数:決まった回数(1 以上)。
- 確率:各回の前に、この確率(%)で継続します。
- リソース量:Resource の量が比較条件を満たす間、継続します。
- スクリプト:各回の前に
onEnd()が呼び出されます。trueで本体を再実行し、falseで停止し、数値で残りの実行回数を設定します。 - なし(実行中に確認、またはランダム):プロンプトモードでは、ダイアログで How many iterations?(既定値 3)を尋ねます。それ以外の場合は、ランダムに 0、1、2 回実行します。
Resource
Resource には Initial Amount、Minimum Amount、Maximum Amount、Units があります。初期量は最小値と最大値の範囲に収められます。
- consumes:量はアクションの開始時に取られ、返却されません。
- seizes:量はアクションの開始時に取られ、終了時に解放されます。
- produces:量はアクションの終了時に加算されます。最大値を超える量は上限で切り捨てられます。
アクションは、利用可能な量より多くを必要とするときに待ちます。「利用できない」とは、量が Minimum Amount を下回る(最小値が設定されていない場合は 0 を下回る)ことを意味します。アクションは、ほかのアクションが十分な量を解放または生産するまで待ちます。そのガントバーには、紫のハッチングで待機が表示されます。
Asset と稼働率
- アクションを実行するすべての Asset(performed by)は、アクションの実行中は稼働中です。
- Busy (%) は、シミュレーション上の時間のうち、その Asset のアクションが少なくとも 1 つ実行されていた時間の割合です。
容量をモデル化するには、performed by 関係に Amount を設定します。
- Asset の容量は、親の decomposed by 関係にある多重度の上限です。たとえば
0..2なら 2 です。 - Asset に空き容量がない間、アクションは待ちます(オレンジのハッチングで待機を表示)。
- 多重度がない場合、容量は無制限です。
コスト
- Cost エンティティには Amount、Rate、Units があります。
- Rate が Per Hour の場合、量にアクションの所要時間(時間単位)が掛けられます。それ以外の場合は、アクションの終了時に 1 回だけ計上されます。
- 実行する Asset に発生する Cost は、その Asset が実行するアクションごとに計上されます。performed by の Amount(未設定の場合は 1)が掛けられます。
- 最初に見つかった Cost の単位が、すべてのコストの数値のラベルになります。
乱数とシード
- 乱数シードを設定すると実行を再現できます。毎回新しい乱数列にするには空欄にします。
- モンテカルロでは、各実行が分析のシードから独自のシードを抽出します。そのため、実行タブの再生(失敗した実行の場合は実行を表示)で、任意の 1 回の実行を離散イベントモードで再生できます。
- スクリプト内の
Math.random()も同じシード付き乱数生成器を使います。
シミュレーターのページ
ページヘッダーと実行バー
ページヘッダーの下のバーには、左から順に、ルート Action、モードの実行コントロール(下記)、設定、モードの切り替えがあります。最初の実行の前は、ページに 1 行の説明と Action 図が表示されます。概要カード(ステータス、合計時間、総コスト、またはモンテカルロのカード)は最初の実行とともに表示されます。
- ルート Action:フローを実行するアクション。一覧には、Action フローを持つすべての Action が表示されます。フローのないアクションは「(フローなし)」と表示されます。別のルートを選ぶと、そのルートでページが開き直します。
- 離散イベント / モンテカルロ:モード。切り替えても、各モードの設定は保持されます。
- ページヘッダー:保存された結果 ▾(保存された実行、または「保存された実行はまだありません。完了した実行はここに保存されます。」)とAction 図を開く。
設定
設定は、バーの下の実行の設定を表示または非表示にします(最初は非表示。選択はこのブラウザーで記憶されます)。そのツールチップには現在の設定が表示されます。たとえば「自動の判断、100× 速度、固定の所要時間、シード 42」です。
| 設定 | モード | 値 | 既定 |
|---|---|---|---|
| 実行 | モンテカルロ | 1~20,000 | 100 |
| 意思決定 | 離散イベント | Automatic (when no script)、Ask (when no script) | Automatic (when no script) |
| 速度 | 離散イベント | 1×、10×、100×、1,000×、10,000×、100,000×(実時間 1 秒あたりのシミュレーション秒数) | 100× |
| 固定の所要時間を変動させる | 両方(モードごとに別々に保持) | なし、Uniform ±%、Triangular ±% | なし |
| ± % | 両方 | 0~100 | 10 |
| 乱数シード | 両方 | 数値、またはランダムにする場合は空欄 | 空欄 |
| カレンダーの日付 | 離散イベント | ルートの Action の Start の日付でクロックを開始します。Start を持つ Action はその日時まで待ちます | オフ |
| 一時停止状態で開始(ステップ実行) | 離散イベント | ページを開いたときに実行を作成し、⏭ ステップですぐに進められるようにします | オフ |
- 設定は、変更すると、プロジェクト内のルートのアクションとともに保存され、それを開くすべてのユーザーに適用されます。各変更は 1 回の元に戻すで取り消せます。また、このブラウザーでは他のルートのアクションのためにも記憶されます。
- 既定値にリセット(「設定はこの Action と一緒に保存されます。」の後にあります)は、既定値に戻し、グラフのエンティティの選択をクリアします。
- 閲覧者は自分の実行の設定を変更できますが、プロジェクトには保存されません。
離散イベントのコントロール
- ▶ 再生 / ⏸ 一時停止:選んだ速度で実行をアニメーション表示します。イベントのない長い区間は一気に飛ばします。
- ⏭ ステップ:次のイベントに進みます。
- ⏩ 最後まで実行:アニメーションなしで最後まで実行します。プロンプトでは止まります。
- ⟲ リセット:実行を破棄します。
- クロック:現在のシミュレーション上の時刻(カレンダーの日付では日時)。
モンテカルロのコントロール
- ▶ モンテカルロを実行、キャンセル、進捗バー、進捗テキスト。
- 要求に照らしてチェック…(完了した実行のある分析の後に有効になります)。
- どの実行も、実行タブから再生したり、MS Project のスケジュールとしてダウンロードしたりできます。
パネルの上の注記
保存された結果を表示中など、注意が必要な通知は、設定を非表示にしても表示されたままです。
- 変動がオンのとき:「固定の所要時間に ±n% の一様な変動を加えました。」(または三角)。
- 等確率を使用の後:「n 個の指定されていない構造に等確率を使用しました:…」。
- 失敗した実行のボックス(モンテカルロ)と、再生のバナー「モンテカルロの実行 n(デッドロックまたはエラー)を、シード s と分析の設定で再生しています。」
パネル
結果は固定のレイアウトで表示されます:上部に概要のストリップ、その下にタブがあります。各タブには 2 列のパネルがあり、幅の広いパネル(ダイアグラム、ガント、イベントログ、統計、実行)は両方の列にまたがります。実行の前は、各パネルに説明が表示されます。開いているタブはこのブラウザーで記憶されます。
パネルのメニュー
各パネルにはタイトルと 1 つの ⋯ メニューがあります。
- データをダウンロード…は、パネルのデータを含むエクスポートダイアログを開きます:すべての列を含む CSV ファイル、Action の時間推移ではさらにスケジュール(MS Project XML)。ファイル名は「<root> <panel title>」です。
- 画像をダウンロード…は、<panel title> (PNG)(透明な背景と拡大率付き)と <panel title> (SVG) を含むエクスポートダイアログを開きます。画像はライトテーマの色を使います。
- Choose entities…(コスト、Resource、Asset のグラフ)は Choose Entities を開きます:名前または番号で一覧を絞り込み、エンティティにチェックを入れて(すべて、なし)、適用をクリックします。何もチェックしない場合、グラフにはすべてのエンティティが表示されます。コストのグラフには合計を表示が加わります。色は一覧の順にグラフのパレットに従います。選択はルートのアクションとともに保存されます。
グラフ、ステータスの一覧、イベントログでエンティティをクリックすると、インスペクターに開き、実行回数と実行時間が表示されます。
離散イベントのタブ
概要のストリップ:ステータス、合計時間、総コスト。
| タブ | パネル | 表示するもの | データ |
|---|---|---|---|
| — | ステータス | 現在実行中のアクションと進捗。黄:Input/Output を待機中、紫:Resource を待機中、オレンジ:Asset の容量を待機中。終了時:100% 完了、デッドロック、停止のいずれかと、アクションの実行回数と合計時間 | — |
| — | 合計時間 | シミュレーションのクロック(カレンダーの日付では日付と経過時間) | — |
| — | 総コスト | 累積の総コストと、コストのあるエンティティの数 | — |
| タイムライン | 実行中の Action 図 | ルートの Action 図(読み取り専用)。アクションは実行中(緑)、待機中(オレンジ)、終了(灰色)で色分けされます | — |
| タイムライン | Action の時間推移 | 実行されたアクションのガントチャート。ハッチングの部分は待機です。分解されたアクションは、クリックで折りたためる括弧です(▸/▾)。繰り返しの実行には #2、#3 の番号が付きます。赤いバーは SYNC のタイムアウトで停止されたものです。赤い破線がクロックを示します。ツール:+、−(ズーム)、リセット、線の矢印を非表示 / 線の矢印を表示、線の色を非表示 / 線の色を表示 | タイムライン(CSV)、スケジュール(MS Project XML) |
| コスト | コストの時間推移 | 選んだエンティティごとの累積コストと合計 | コストの時間推移(CSV) |
| コスト | エンティティ別のコスト | 選んだエンティティごとの総コスト(棒グラフ) | 項目別のコスト(CSV) |
| Resource | Resource のレベルの時間推移 | 選んだ Resource の量の時間推移 | Resource のレベルの時間推移(CSV) |
| Resource | Resource の量 | Resource ごとの初期量、最小量、最大量、最終量、消費量、生産量 | Resource の変化(CSV) |
| Resource | Asset の稼働時間 | 実行する Asset ごとの稼働率(%)と、使用中のユニット(または実行中のアクション)の時間推移 | Asset の使用状況(CSV) |
| ログ | コンソール | print() の出力、スクリプトのエラー(行番号付き)、警告、デッドロック | コンソール(CSV) |
| ログ | イベントログ | エンジンのすべてのイベント:start、end、wait、resume、io、transfer、resource、decision、loop、exit、sync、killed、cost、deadlock、error | イベントログ(CSV) |
| ログ | スクリプト変数 | スクリプトのグローバル変数(globals.put)とその現在の値。値を展開すると履歴が表示されます | グローバル値(CSV) |
実行の再生中は、概要のストリップと開いているタブだけが再描画されます。他のタブは、開いたときか実行が終わったときに追いつきます。
モンテカルロのタブ
概要のストリップ:完了した実行。
| タブ | パネル | 表示するもの | データ |
|---|---|---|---|
| — | 完了した実行 | 完了したシミュレーション、所要時間とコストの平均値と標準偏差。デッドロックやエラーになった実行は別に数えられ、除外されます | モンテカルロの概要(CSV) |
| 分布 | 統計 | 所要時間、コスト、各数値のスクリプトのグローバル変数についての平均値、平均値の 95% CI、標準偏差、最小値、P5、中央値(P50)、P95、最大値(完了した実行のみ) | — |
| 分布 | 所要時間の分布 | 実行ごとの合計所要時間のヒストグラム | 実行の所要時間(CSV) |
| 分布 | コストの分布 | 実行ごとの総コストのヒストグラム(コストがない場合は「コストが発生した実行はありません。」) | 実行のコスト(CSV) |
| 分布 | 累積確率(S カーブ) | 選んだ出力の累積分布。x フィールドと P(X ≤ x) の読み取り値付き | — |
| 要因 | Action 別の時間 | 全実行におけるアクションの所要時間の合計 | Action の所要時間(CSV) |
| 要因 | Action 別のコスト | 全実行におけるアクションまたは Asset ごとのコストの合計 | Action のコスト(CSV) |
| 要因 | 分岐の組み合わせ | OR の分岐の各組み合わせと、実行とShare | 分岐の組み合わせ(CSV) |
| Resource | Resource のレベル | Resource ごとの最小量、最大量、最終量の平均 | 実行全体の Resource(CSV) |
| Resource | Asset の稼働時間 | 実行する Asset ごとの平均稼働率(%)(Asset が 3 つ未満の場合は棒グラフ) | 実行全体の Asset 使用状況(CSV) |
| 実行 | 実行 | すべての実行が、実行、シード、結果(Completed、Deadlock、Error)、Duration、コストとともに表示されます。列見出しをクリックすると並べ替えます(もう一度クリックすると逆順)。P10、P50、P90 は、所要時間の分布のその位置にある実行を選んで強調表示します。再生は 1 つの実行をそのシードで離散イベントモードで再実行し、MS Project はそれを MS Project XML のスケジュール「<root> run <n>.xml」としてダウンロードします。最初の 500 件の実行が表示されます | 実行(CSV)(すべての実行:シード、結果、所要時間、コスト、パス、グローバル変数) |
分析では実行ごとのコンソールメッセージは保持されません。見るには実行を再生します。
スクリプト
スクリプトは、Action、OR、SYNC、LOOP に付ける JavaScript のフックです。Resource のレベルに基づく判断など、ダイアグラムだけでは表現できない振る舞いがある場合に使います。
スクリプトを書くには:
- Action 図で要素を選択します。
- インスペクターで、スクリプトを編集…(アクションの場合)、または OR、SYNC、LOOP のパネルでスクリプトを編集… / スクリプトを追加…をクリックします。
エディターのダイアログが開きます。たとえば Script: Capture Image Strip や OR Script: … です。
- Add onStart()、Add prompt()、Add onEnd()、Add duration() のいずれかをクリックすると、空のフックが挿入されます。
- コードを書きます。Tab で空白が 2 つ入ります。
- 保存(またはキャンセル)をクリックします。
フック
| フック | 呼び出されるタイミング | 戻り値 |
|---|---|---|
onStart() | アクションまたは構造の開始時 | — |
prompt(p) | onStart の後、入力ダイアログを組み立てるため | —(p を設定) |
onEnd(response) | アクションの終了時。OR では判断するとき、LOOP では各回の前 | OR:分岐の名前またはインデックス。LOOP:継続するなら true、停止するなら false、または残りの実行回数 |
duration() | アクションの Duration が =script() のとき | Duration の単位での所要時間 |
response には、プロンプトのダイアログの回答が入力名をキーとして入っています。
Automatic (when no script) の場合とモンテカルロでは、プロンプトは表示されません。代わりに既定値が使われます:数値の値または 0、チェックボックスの値、または最初の選択肢です。
プロンプトビルダー
p.setTitle(text):ダイアログのタイトル(既定値「Input for <name>」)。p.addEnumInput(title, name, choices, default):選択リスト。p.addTextInput(title, name, default)、p.addBigtitleTextInput(title, name, default)(複数行)、p.addNumberInput(title, name, default)、p.addBooleanInput(title, name, default)(チェックボックス)。
ダイアログには「シミュレーションを <time> で一時停止しました。」と表示され、OK で閉じます。
スクリプトで使えるもの
print(x, …):コンソールに書き込みます。オブジェクトは JSON として出力されます。globals.put(key, value)、globals.get(key):スクリプト変数で時間を追って追跡される値。数値のグローバル変数は、統計、S カーブ、要求に照らしてチェック…で、モンテカルロの出力(グローバル: key)になります。Sim.getEntityById(id)、Sim.getEntityByGlobalId(id)、Sim.getEntityByName(name)、Sim.getEntityByNumber(number)、Sim.getEntitiesByName(name)、Sim.getEntitiesByNumber(number):エンティティのラッパーを返します。- プロパティ:
id、name、number、description、className。 - メソッド:
getId()、getGlobalId()、getName()、getNumber()、getDescription()、getAttribute(name)(属性名で指定、大文字と小文字は区別しない)、attributes().get(name)。
- プロパティ:
Sim.getIOValueById(id)、Sim.getIOValueByGlobalId(id)、Sim.getIOValueByName(name)、Sim.getIOValueByNumber(number):Input/Output の Value 属性。Sim.getAmount(name)、Sim.getAmountById(id)、Sim.getAmountByGlobalId(id):Resource の現在の量。Sim.getResourceByName(name)は{id, name, amount, units}を返します。Sim.setResourceById(id, value)、Sim.setResourceByGlobalId(id, value)、Sim.setResourceByName(name, value):Resource の量を設定します(スクリプトによる変更として記録)。Sim.getCurrentTime()(開始からのミリ秒)とSim.getCurrentCost()。
各スクリプトは実行ごとに 1 回コンパイルされるため、トップレベルの変数はループの各回をまたいで値を保持します。スクリプトから見てモデルは読み取り専用で、例外は Resource の量だけです。
例:バッテリー残量で分岐を決める
function onEnd() {
const wh = Sim.getAmount('Battery Charge');
globals.put('Battery at decision', wh);
return wh > 40 ? 'Yes' : 'No';
}
これを、判断の種類がスクリプトの OR Contact in view? に設定します。分岐の名前は Yes と No である必要があります。
サンドボックスと信頼
- 各実行は、モデルの読み取り専用のコピーを持つ別々のサンドボックスで実行されます。スクリプトは、ページ、他のプロジェクト、ファイル、ブラウザーのストレージ、ネットワークにアクセスできません。
- 8 秒より長く実行されるスクリプトの呼び出しは実行を停止させます:「<name> のスクリプトが 8 秒を超えて実行されたため停止しました。無限ループがないか確認してください。」
- このブラウザーで自分が書いた、または承認したスクリプトは信頼されます。
実行には、インポートしたファイルや他のメンバーの編集など、ほかから来たスクリプトが含まれる場合があります。そのような実行の前に、Holarch は承認を求めます。この確認は、▶ 再生、⏭ ステップ、⏩ 最後まで実行、▶ モンテカルロを実行の前に表示されます。
- 実行を開始します。
ダイアログ別の作成者のスクリプトを実行しますか?に、スクリプトの数が表示されます。スクリプトは、プロジェクト、ファイル、ネットワークにアクセスできないサンドボックスで実行されることも説明されます。
- スクリプトを表示を開いてレビューします。
- スクリプトを実行をクリックして実行するか、キャンセルをクリックします。
スクリプトを実行をクリックすると、それらのスクリプトは以後このブラウザーで信頼されます。
キーボードとマウス
| Action | 効果 |
|---|---|
| ガントバー、グラフの点、ツリーマップのセル、ステータスの行をクリック | エンティティをインスペクターで開きます |
| 分解されたガントの行ラベルをクリック | その子を折りたたむか展開します |
| スクリプトエディターで Tab | 空白を 2 つ挿入します |
メッセージ
| メッセージ | 意味と対処法 |
|---|---|
| 「シミュレーションする Action がありません」/「Action に子の Action を与え、その Action 図でフローを描いてください。」 | プロジェクトにフローを持つ Action がない |
| 詳細付きの「シミュレーションエラー」 | 実行を開始できなかったか、サンドボックスが失敗した。詳細を読みます |
| 「ルートの Action が存在しなくなりました。別のルート Action を選択してください。」 | ルートが削除された |
| 「<name> でスクリプトエラー(<hook>):<message>」 | スクリプトが例外を投げ、実行が停止する。コンソールに行番号が表示されます |
| 「<name>:スクリプトが『x』を返しましたが、どの分岐とも一致しないため、ランダムに選びました。」 | OR のスクリプトが不明な分岐名を返した |
| 「<name>:10000 回を超える反復 — LOOP の条件を確認してください。」 | LOOP が止まらない |
| 終わらないループ(実行の前) | 100 % で繰り返すループを終わらせる EXIT がない(Action.19)。修正するか、このまま実行を選びます。 |
| 「無限の階層があります(A → B → A)。ダイアグラムでこれらの分解のリンクのいずれかを除去してください。」 | アクションが自分自身に分解されている |
| 「シミュレーションを中止しました:ステップ数が多すぎます(LOOP の回数または再帰的な分解を確認してください)。」 | 1 回の実行でアクションの実行回数が 20,000 を超えた |
| 「シミュレーションを中止しました:イベントの上限に達しました。」 | 1 回の実行でイベントが 500,000 を超えた |
| 「デッドロック:<action> が I/O <name> を待機中(生成されない)」 | トリガー I/O が生成されなかった |
| 「デッドロック:<action> が <amount> <resource> を待機中(利用できない)」/「Asset の容量を待機中:…」 | Resource または容量が利用可能にならなかった |
| 「Asset <name> には複数の親があります。容量には最初の親を使います。」 | Asset の容量は最初の親の多重度から決まる |
| 「<I/O> は複数の Conduit で運ばれています。シミュレーターは <conduit> を使用しました。」 | 最初の Conduit の遅延だけが適用される |
| 「シミュレーションのスクリプトはネットワークにアクセスできません(Sim.httpGet、httpPost、httpPut は使用できません)。」 | スクリプトはネットワークを呼び出せない |
| 「名前 <name> のエンティティが見つかりませんでした」/「ID <id> の Resource が見つかりませんでした」 | Sim の検索で何も見つからなかった |
| 「シミュレーションのスクリプトは実行時にコードをコンパイルできません。」/「シミュレーションのスクリプトでは import() を使用できません。」 | スクリプトがコードを作成または読み込もうとした |
| 「<name> のスクリプトが 8 秒を超えて実行されたため停止しました。無限ループがないか確認してください。」 | スクリプトのウォッチドッグ |
| 「シミュレーションが応答しなくなったため停止しました。」 | サンドボックスがスクリプトの外で応答しなくなった |
| 「モンテカルロの実行を停止しました」 | キャンセルをクリックした |
| 「N 件中 n 件の実行が失敗しました(デッドロック d 件、エラー e 件)。P(failure) = …」 | 失敗した実行は統計から除外される。実行を表示を使います |
| 「完了した実行がありません。先にモンテカルロを実行してください。」 | 要求に照らしてチェック…には完了した実行が必要 |
| 「しきい値を入力するか、Measure を選択してください。」/「先にしきい値を入力してください。」 | チェックに値がない |
| 「<Measure> には数値の Threshold Value がありません。しきい値を入力してください。」 | Measure のしきい値または目的が数値ではない |
| 「結果を記録するには、Measure または Requirement を選択してください。」 | 結果を記録…には対象が必要 |
| 「少なくとも 1 つの変更を選択してください。」 | 結果を記録のすべての行のチェックが外れている |
| 「結果を記録しました」 | Measure と Test Case が更新された |
| 「必要な確率が信頼区間内にあります。より確かな判定のため、反復回数を増やしてください。」 | 実行を増やすと判定が変わる可能性がある |
| 「保存された結果を読み取れませんでした:<reason>。シミュレーションをもう一度実行してください。」 | 保存された .sim ファイルがないか、無効である。再実行をクリックします |
| 「このパネルはもう一方のシミュレーションモード用です。」 | もう一方のモードのパネル |
| 「閲覧のみ:編集権限をオーナーに依頼してください。」 | 閲覧者はシミュレーションを実行できますが、設定、結果、記録したチェックは保存できません |
制限事項
- モンテカルロ:分析ごとに 1~20,000 回の反復。
- 1 回の実行:アクションの実行は最大 20,000 回、イベントは最大 500,000 件、1 つの LOOP の反復は最大 10,000 回。
- スクリプトの呼び出し:それぞれ 8 秒。
- 失敗した実行の表:最初の 50 件の失敗した実行が表示されます。実行 ⋯ → データをダウンロード… → 実行(CSV)にはすべての実行が含まれます。
- 実行タブ:最初の 500 件の実行が表示されます。実行(CSV)にはすべてが含まれます。
- モンテカルロの統計には、完了した実行だけが使われます。
- I/O の遅延は、それを転送する最初の Conduit だけで決まります。Asset の容量は、最初の親だけで決まります。
関連
- ガイド:システムズエンジニアリングにおけるモンテカルロシミュレーション。点推定から確率までを解説しています。
- Action 図:フロー、構造、I/O、Resource、スクリプトを構築します。
- 機能分析:要求から機能とフローを導出します。
- ヘルプのシミュレーター、シミュレーションのスクリプト、シミュレーションして要求に照らしてチェックする。
- 属性の型と分布と検証を設定し、スイートを実行し、RVTM を作成する。