振る舞い
Action 図
順次、並列、判断、ループ、終了の構文、アクション間を流れるアイテム、使用するリソース、実行するアセットを使って機能フローをモデル化し、シミュレーションします。
このページの内容
概要
Action 図は、親の Action がどのように実行されるかを示します。LML の振る舞い図であり、シミュレーターは図に示されたとおりに実行します。
ダイアグラムには次のものが示されます。
- 実行される順序に並んだ子の Action
- フローが並列のパスや代替に分かれる箇所と、ループする箇所
- ある Action から別の Action へ渡される Input/Output(I/O)
- 各 Action が使う Resource
- 作業を実行する Asset
ダイアグラムは単なる絵ではなく、モデルのビューです。図形を追加、移動、削除するたびに、プロジェクト内のエンティティと関係が変わります。どの変更も 1 回の元に戻すで取り消せます。
同じフローは、機能フローブロック図(FFBD)、SysML のアクティビティ図、タイムライン図も動かします。どれかでフローを編集すると、ほかも追随します。
概念
フロー
フローは、左の緑の開始ピルから右の赤い終了ピルへ進みます。その間の要素は矢印でつながります。各要素は次のいずれかです。
| 要素 | 形 | 意味 | エンティティ |
|---|---|---|---|
| Action(直列のステップ) | 番号と名前のある青い角丸のボックス | 前の要素が終わると開始するステップ | ルートの子の Action(decomposed by) |
| 並列 | parallel とラベルの付いた分岐バーと、閉じるバー | 同時に実行される 2 つ以上の分岐。すべての分岐が終わるとフローが続きます。 | なし |
| SYNC | 右側に尖りがある SYNC の印の付いたブロックと、閉じるバー | 独自のエンティティを持つ並列の分岐。その Duration は、終わっていない分岐を停止させるタイムアウトです。 | 「Sync Action」という名前の Action(制御タイプ SYNC) |
| OR | 左側に尖りがある OR の印の付いたブロックと、閉じる円 | 判断:ちょうど 1 つの分岐が実行されます | 「Or Action」という名前の Action(制御タイプ OR) |
| LOOP | 入口の円、ループの本体、LOOP の印の付いたブロック、破線の戻り矢印 | 継続条件が成り立つ間、本体が繰り返されます。条件は各回の前にチェックされます。 | 「Loop Action」という名前の Action(制御タイプ LOOP) |
| EXIT | EXIT の印の付いた赤いボックス | 到達すると、囲んでいる LOOP(またはそれが置かれているフロー)を終了します | なし |
分岐は、Parallel、SYNC、OR の中の 1 つのパスです。各分岐はそれ自身がシーケンスであり、さらに別の構造を含め、どの要素でも保持できます。LOOP は 1 つのシーケンスを保持し、これを本体と呼びます。
OR、SYNC、LOOP は、独自のエンティティを持つ構造です。そのエンティティはステップと同じくルートの子なので、構造は名前、スクリプト、(SYNC の場合)タイムアウトを持てます。構造はステップではありません。Action のボックスとして表示されることはなく、タイムラインなどのビューでは飛ばされます。
フローを取り巻く項目
| アイテム | 形 | 関係 | 意味 |
|---|---|---|---|
| Input/Output | フローの上の平行四辺形。Action をトリガーする場合は緑、それ以外は灰色。 | Action が I/O を generates、Action が I/O を receives | Action 間で渡される情報、データ、材料 |
| 親の Input/Output | parent input(開始の左)または parent output(終了の右)のラベルが付いた平行四辺形 | ルートの Action がそれを receives または generates | 親の Action のインターフェース。子の Action が使っていない間は破線で描かれます。 |
| Resource | フローの下の紫の六角形 | Action が Resource を consumes、produces、seizes(Amount 付き) | Action が使い切る、返却する、または生成する量 |
| 実行する Asset | Action 名の下の ⟂ と Asset 名 | Asset が Action を performs | Action を実行する人またはもの。アセットがオンのときに表示されます。 |
| 実行者 | Parallel または SYNC の分岐上の ⟂ と Asset 名 | Asset が分岐上のすべての Action を performs | 分岐全体の実行者。編集のたびに同期が保たれます。 |
シミュレーションでは 2 つの用語が重要です。
- トリガー:トリガーが設定された(既定)受信 I/O があると、受信する Action はその I/O が存在するまで待ちます。
- 任意:トリガーがオフの受信 I/O。Action はそれを待たずに開始します。
Resource の線には、関係と量のラベルが付きます。たとえば consumes 1.5 です。占有されるだけの Resource は薄く描かれます。
使い方
使う場面と理由
Action 図は、機能の一式がそろった後、それを物理アーキテクチャに割り当てる前に作成します。機能は通常、要求の機能分析から得られます。
ダイアグラムは次の問いに答えます。
- 機能はどの順序で実行され、どれが並列に実行されるか。
- システムはどこで判断を下すか。
- 各機能は何を必要とし、何を生成するか。
- シーケンス全体にどれくらい時間がかかるか。
分解のレベルごとに 1 つのダイアグラムを使います。ミッションのタイムラインやユースケースなど、最上位の運用シナリオから始めます。その後、独自の詳細が必要な機能ごとにダイアグラムを追加します。
ダイアグラムは実行可能です。シミュレーターと組み合わせて、ハードウェアができる前の早い段階でタイミングと Resource の要求をチェックします。
フローを一から構築する
ダイアグラムを作成します。
- レールの下部にあるダイアグラムを開きます。
- + 新しいダイアグラムをクリックします。
- ダイアグラムの種類で Action 図(振る舞いグループ、LML タグ付き)を選びます。
- ルートに新しい Action の名前を入力します。たとえば
Run Nominal Imaging Passです。(OPSなどの番号は後でインスペクターで付けます。) - 作成をクリックします。
開始と終了、およびヒント ここに要素をドラッグするか、+ Action をクリック が表示されます。
ステップを順に追加します。
- + 追加 ▾ → + Action ▾ → 新しい Action… をクリックします。
- Action を追加に名前を入力します。
- OK をクリックします(または Enter を押します)。
フローに番号付きの Action のボックスが表示されます。番号は親の番号に続きます:OPS.1、OPS.2 などです。新しい Action はルートの子です。
- 新しい Action を選択したまま、次のステップについて手順 1~3 を繰り返します。+ Action は常に、選択した要素の後に挿入します。
同時に実行されるステップを追加します。
- 並列のステップを開始する直前のステップを選択します。
- + 追加 ▾ → + Sync をクリックします。
2 つの空の分岐を持つ SYNC が表示されます。
- 分岐線をクリックして選択します。
- + 追加 ▾ → + Action ▾ → 新しい Action… をクリックして、その分岐にステップを追加します。
- 3 つ目の分岐が必要な場合は + 分岐をクリックします。
タイムアウト、名前、スクリプトが不要な場合は、+ Sync の代わりに + 追加 ▾ → + Action ▾ → Parallel branches (no entity) を使います。
判断を追加します。
- 判断の直前のステップを選択します。
- + またはをクリックします。
- 質問を入力します。たとえば
Contact in view?です。それぞれ 50% の 2 つの分岐 はい と いいえ が表示されます。
- OR を選択し、インスペクターでガードの名前と確率を設定します。
ステップを繰り返します。
- ステップを選択します。
- + 追加 ▾ → + ループをクリックします。
- ループの名前を入力します。
ステップが、2 回実行されるループで囲まれて表示されます。
- インスペクターで反復回数、または別の条件を設定します。
所要時間を設定し、結果を確認します。
- Action を選択します。
- インスペクターのスケジュールグループで Duration を入力します。
- 複数の Action に同じ Duration を設定するには、それらを Shift+クリックし、インスペクターで期間(Action N 件)を設定します。
- ツールバーのダイアグラムのチェックバッジ(✓ チェック、または ⚠ と数字)をクリックします。
インスペクターに、Duration のない Action と、接続されていない項目が一覧表示されます。
パレットからドラッグしてフローを構築する
左側のパレットには、構造と項目の種類があります。ツールバーを使う代わりに、それらをキャンバスにドラッグします。
- Action をフローの任意の線にドラッグします。項目が有効な場所の上にある間、ドロップ先の線が強調表示されます。
その位置に「新しいアクション」が表示されます。インスペクターの名前フィールドが選択され、すぐに入力できます。
- 名前を入力します。
- Parallel、または、Sync、ループ、終了も同じように線にドラッグします。
- Input/Output を Action にドラッグします。その Action が生成する I/O が作成されます。空のキャンバスにドロップすると、接続されていない I/O が配置されます。
- Resource を Action にドラッグします。その Action が消費する Resource(Amount 1)が作成されます。空のキャンバスにドロップすると、接続されていない状態で配置されます。
- 実行者を Parallel または SYNC の分岐線にドラッグし、Asset を選びます。
これで、その Asset が分岐上のすべての Action を実行します。
モデルにすでにある項目を再利用するには:
- 追加または検索…に名前を入力します。プロジェクト内に、一致する Action、Input/Output、Resource、Asset が一覧表示されます。
- 一致した項目をダイアグラムにドラッグします。
- Action は線に
- I/O や Resource は Action またはキャンバスに
- Asset は Parallel または SYNC の分岐線に
キーボードでは、パレットの項目にフォーカスを置いて Enter または Space を押します。構造はメインフローの末尾に、Input/Output と Resource はビューの中央に入ります。
Input/Output と Resource を接続する
ある図形から別の図形へハンドルをドラッグして、項目を接続します。
ある Action から別の Action へ I/O を渡します。
- 最初の Action を選択します。
その上に緑のハンドルが表示されます。
- ハンドルを 2 つ目の Action にドラッグします。
ポインターを合わせている間、ターゲットのボックスが 2 つに分かれて表示されます。
- トリガーする入力にするにはトリガー(上)の半分で、任意の入力にするには任意(下)の半分で離します。
Holarch が新しい Input/Output を作成します。最初の Action がそれを生成し、2 つ目の Action が受信します。新しい I/O が選択され、名前フィールドにすぐ入力できます。
- I/O の名前を入力します。
Action のハンドルは、ほかの場所にもドラッグできます。
- 既存の Input/Output へ:Action がそれを生成します。
- Resource へ:Action がそれを生産します(Amount 1)。
- 空のキャンバスへ:Holarch が Action の新しい出力を作成します。
Action に既存の I/O を受信させます。
- Input/Output を選択します。
- そのハンドル(図形の下)を Action にドラッグします。
- Action の上で離し、接続の選択肢から Input(トリガー)または Input(任意)を選びます。
Action がすでにその I/O を受信している場合は、トリガーの設定だけが変わります。
Action に Resource を使わせます。
- Resource を選択します。
- そのハンドル(図形の上)を Action にドラッグします。
- 消費(上)の半分、または占有(下)の半分で離します。
消費と占有を切り替えても、量は保持されます。
Resource のリンクの量を設定します。
- Action を選択します。
- インスペクターのトレースセクションで、consumes、produces、seizes の下にある Resource を見つけ、属性をクリックします。
- 関係の属性 Amount を編集します。
I/O と Resource を手動で配置します。
- Input/Output または Resource の図形を、置きたい場所にドラッグします。位置はダイアグラムとともに保存されます。
- そのインスペクターで位置をリセットをクリックすると、それを使う Action の上または下の自動レイアウトに戻ります。
- 整列 ▾ → Input/Output と Resource の位置をリセットを選ぶと、すべてがリセットされます。
実行者を割り当てる
1 つの Action に Asset を割り当てます。
- Action を選択し、開く場所 ▾ → 項目ビューを選びます。(ダイアグラム上では、ダイアグラムが管理しているため、インスペクターの performed by はロックされています。)
- トレースセクションで、+ → 既存をリンク…を使って performed by を追加します。
- Asset を選びます。
Parallel または SYNC の分岐全体に Asset を割り当てるには、次の 2 つの方法があります。
- 追加パネルから実行者を分岐線にドラッグします。
- Parallel または SYNC を選択し、インスペクターで分岐の横にある + Asset をクリックします。
ツールバーのアセットをオンにすると、各 Action 名の下に実行者が表示されます。
分解してドリルダウンする
1 つの Action に独自の子フローを与えます。
- Action を選択します。
- 分解をクリックします。
その Action 自身の Action 図が開きます。
- そこで子フローを構築します。
- ページヘッダーの ▲ 親をクリックして戻ります。
分解された Action をダブルクリックするか、その分解アイコンをクリックしても、子フローを開けます。
複数のステップを新しい子の Action にまとめます。
- 同じ線上で隣り合う 2 つ以上の要素を Shift+クリックします。
- 分解(グループ化)をクリックします。
要素は、独自のフローを持つ「New Action」という名前の新しい子の Action に移ります。トースト 新しい子 Action にグループ化しました。インスペクターで名前を付けてください。 が表示され、名前フィールドが選択されます。
- 新しい名前を入力します。
子フローをこのダイアグラムに平坦化して戻します。
- 分解された Action を選択します。
- (ツールバーまたはインスペクターの)平坦化をクリックします。
このダイアグラムで、その子フローが Action に置き換わります。
- 空になった Action をモデルに(このダイアグラムの外に)残すには Action を保持を、削除するには項目を削除を選びます。
シミュレーターでは、分解された Action はその子フローを実行します。その Action 自身の Duration は使われません。
シミュレーションして妥当性を確認する
- 最初の実行の前にダイアグラムのチェックバッジを開き、表示された内容を修正します。
シミュレーターが欠けているとみなすものが表示されます。
- Duration のない Action は 0 としてシミュレーションされます。
- どの Action も生成しない I/O があると、その受信側は待ち続けます(デッドロック)。
- 何も使っていない Resource が一覧表示されます。
- チェックで報告された内容を修正します。
- ▶ シミュレーション ▾ をクリックし、時間付きの 1 回の実行を見るには離散イベントを、多数の実行にはモンテカルロを選びます。
この Action をルートとしてシミュレーターが開きます。
- シミュレーションを実行します。
いつまでも待ち続ける実行は、デッドロックとして報告されます。シミュレーターのステータスに理由が表示され、ログタブに記録されます。
- I/O … を待機中(生成されない)
- … を待機中(利用できない)
ダイアグラムを修正して、もう一度実行します。たとえば、トリガーを任意の入力に変えます。
実例:CubeSat EO-1 の撮像パス
デモプロジェクトには Action 図 OPS Run Nominal Imaging Pass があります。
- プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクトでデモプロジェクトを作成します。
- 振る舞い → Action 図からダイアグラムを開きます。
フローは次のように実行されます。
- 3 つのステップが順に実行されます。
- OPS.1 Transmit Imaging Plan(Ground Station、三角分布 4~9 分、最頻値 6)
- OPS.2 Receive Imaging Plan(UHF Transceiver、1 分)
- OPS.3 Load Command Schedule(C&DH、2 分)
- Parallel が、OPS.4 Rotate to Target(ADCS、正規分布 3 ± 0.5 分)と OPS.5 Prepare Camera(Payload Camera、5 分)を同時に実行します。どちらも Command Schedule をトリガーとして受信します。
- Each target という名前の LOOP が、OPS.6 Capture Image Strip と OPS.7 Encode and Store Image を 4 回実行します(Continue (×4))。
- Contact in view? という名前の OR が次のステップを選びます。
- Yes (75%):OPS.8 Transmit Image Data
- No (25%):OPS.9 Hold Data Onboard
- 最後の Parallel は、地上がデータを受信して処理する(OPS.11、OPS.12)間にバッテリーを充電します(OPS.10)。
フローは 2 つの Resource を使います。
- Battery Charge(Wh、初期値 62、最小値 23、最大値 77)。OPS.4(1.5)、OPS.5(0.8)、OPS.6(2)、OPS.7(0.3)、OPS.8(6)がこれを消費し、OPS.10(30)が生産します。
- Data Storage(GB)。OPS.7(2.5)が生産し、OPS.8(8)が消費します。
Image Data Package は OPS.11 の任意の入力です。そのため、コンタクトのないパスでも地上セグメントはデッドロックしません。
次の変更を試します。
- OR を選択し、Yes を 60、No を 40 に変更します。
分岐のラベルが Yes (60%) と No (40%) になります。インスペクターに 合計 100% と表示されます。
- LOOP を選択し、反復回数を 6 に設定します。
ループのテキストが Continue (×6) になります。
- ▶ シミュレーション ▾ → モンテカルロを選んで実行します。
パスあたりのターゲットが増えると、バッテリーの消費が増えます。概要のストリップと 分布タブに、長くなったパスの時間が表示されます。
- アセットをオンにすると、各実行者が表示されます。
- 整列 ▾ → Asset 図を生成を選びます。
Holarch が Asset「Run Nominal Imaging Pass performers」を作成します。その子は実行する Asset で、そのうち 2 つの間を渡されるすべての I/O について Conduit が付きます。その Asset 図が開きます。
ヒントとよい進め方
- Action には動詞と目的語(Capture Image Strip)、I/O には名詞(Image Strip)で名前を付けます。OR のガードには、OR の質問への答えとなる名前を付けます。
- 各ダイアグラムの要素は 7~12 個程度にとどめます。詳細は分解(グループ化)で子の Action にまとめます。
- 既定では Parallel(エンティティなし)を使います。タイムアウト、名前、スクリプトが必要な場合に限り SYNC を使います。
- 確率モードの OR は合計 100% にする必要があります。確率がわからない場合はなし(実行中に確認、またはランダム)を選びます。その場合、シミュレーターが確認するか、モンテカルロが等確率を使います。
- シミュレーションの前に、すべての末端の Action に Duration を設定します。時間が変動する場合は分布を使います。たとえば
=norm.dist(40,6)秒です。 - Action がそれなしで開始できる場合は、受信 I/O を任意にします。そうしないと、それを生成しない分岐で実行がデッドロックします。
- ルートのインスペクター(整列 ▾ → ダイアグラムの設定)の子の番号を振り直す…で、子の順序をフロー順にして、フロー順に子の番号を振ります。
よくある間違い
| 症状 | 原因 | 対処 |
|---|---|---|
| 構造をフローの線にドロップしてください。 | 構造または Action が、図形の上または空のキャンバスで離された | 要素間の矢印の上で離します |
| 分岐の確率の合計が 90 % です。合計が 100 % になるように変更してください。 | OR の確率の合計が合わない | 割合を修正するか、分岐を追加します |
| シミュレーションが終わらない(デッドロック) | Action が、このパス上で何も生成しないトリガー I/O を待っている | 入力を任意にするか、すべてのパスで生成します |
| シミュレーションで Action に時間がかからない | Duration がないか、Action が分解されている(代わりにその子フローが実行される) | Duration を設定するか、子に所要時間を追加します |
| ステップが消えたように見える | ダイアグラムからは除去されたが、モデルには残っている | 追加または検索…に名前を入力し、線の上にドラッグして戻します |
| Asset 図の生成で No Action here has a performer… と報告される | どの Action にも performed by の Asset がなく、どの分岐にも実行者がない | 先に実行者を割り当てます |
他の機能との関係
- 入力元:機能分析が機能(子の Action)とそのフローを作成します。要求は satisfied by を通じて Action に届きます。Asset と Resource はアーキテクチャから得られます。
- シミュレーターへの入力:時間、コスト、Resource のレベル、Asset の稼働率、要求のチェック。シミュレーションを参照してください。
- 同じフローの他のビューへの入力:FFBD とアクティビティ図。
- 派生ビューへの入力:
- タイムライン図(開始と Duration によるスケジュール)
- シーケンス図(ライフラインは実行する Asset、メッセージは I/O)
- Asset 図を生成(物理的なコンテキストと Conduit)
- N² 図(機能間の I/O)
- IDEF0(入力と出力)
- トレーサビリティ:インスペクターのトレースセクションに、各 Action の要求(satisfies)が表示されます。RVTM とトレーサビリティマトリックスも同じ関係を読み取ります。
エディター
Action 図は共通のダイアグラムエディターを使います(ダイアグラムを参照)。ツールバーの行、左側のパレット、キャンバス、右側のインスペクターがあります。
ページヘッダー
- ダイアグラムの種類セレクター:同じルートの Action を、Action に適用できる別のダイアグラムの種類で表示します。種類は、Hierarchy、Spider、Tree、Risk、Timeline、Action、Sequence、Use Case、N2、IDEF0、ICOM (A0)、Activity、FFBD です。
- ▲ 親:親の Action の Action 図を開きます。ルートに親の Action がある場合にのみ表示されます。
ツールバー
ツールバーはグループが並んだ 1 行です。挿入グループの追加操作(+ Action ▾、+ Sync、+ または、+ ループ、+ 終了、+ 分岐、+ I/O)は 1 つの + 追加 ▾ の一覧にまとめられています。これらは選択位置(その後、その周り、その分岐)で動作し、左側の追加パネルはドラッグまたは Enter で追加します。一覧では、↓ と ↑ で追加操作の間を移動し、Esc で閉じます。ウィンドウが狭いと、項目は ⋯(その他の操作)に移ります。+ 追加 ▾ は行に残り、分解と ▶ シミュレーション ▾ だけが長い表記のまま残ります。図形を選択するとインスペクターが開きますが、ツールバーのボタンは動きません。
| グループ | コントロール | 機能 |
|---|---|---|
| モード | パン | 背景をドラッグしてビューを移動します(既定)。 |
| モード | 範囲選択 | Action 図では注釈だけを選択します。フローの要素は Shift+クリックで選択します。 |
| 挿入 | + 追加 ▾ | 下にある追加操作の一覧(「選択位置に追加」)を開きます。 |
| 挿入 | + Action ▾ | 新しい Action…は名前を尋ねます(既定値 New Action)。既存の Action…は、ルート、その祖先、このダイアグラムにすでにあるもの以外の Action を選びます。Parallel branches (no entity) は並列の分岐を追加します。選択位置の後、選択した分岐の末尾、またはフローの末尾に挿入します。 |
| 挿入 | + Sync | 2 つの空の分岐を持つ SYNC を追加します。 |
| 挿入 | + または | 判断名(質問)(既定値 Or Action)を尋ね、それぞれ 50% の分岐 Yes と No を持つ OR を追加します。 |
| 挿入 | + ループ | ループ名(繰り返し条件)(既定値 Loop Action)を尋ねます。要素を選択している場合は、その要素をループで囲みます(選択した要素を LOOP の中に入れる)。それ以外の場合は、空のループを追加します(空の LOOP を追加)。新しいループは 2 回反復します。 |
| 挿入 | + 終了 | 選択位置の後に EXIT を追加します。 |
| 挿入 | + 分岐 | 選択した Parallel、SYNC、OR(または分岐が選択されているもの)に分岐を追加します。OR の確率は均等に分け直されます。それ以外の場合は無効です。 |
| 挿入 | + I/O | Action を選択した状態で、受信する Action を選び(Input/Output from "…" to…)、新しい I/O に名前を付けます。最初の Action がそれを生成し、2 つ目の Action がトリガーとして受信します。 |
| 編集 | 元に戻す、やり直す | ⌘Z / Ctrl+Z, ⇧⌘Z / Ctrl+Shift+Z. |
| 編集 | 接続… | 選択した図形を、キーボードから別の図形に接続します。選択肢はハンドルをドラッグする場合と同じです(キーボードとスクリーンリーダーを参照)。 |
| 編集 | ◀, ▶ | 選択した要素を、そのシーケンス内で 1 つ左または右に移動します。 |
| 編集 | 除去 | 選択範囲をダイアグラムから除去します。Shift+クリックではエンティティを削除します(削除と除去を参照)。 |
| ビュー | −、ズーム %、+、⤢ | 縮小、ズームレベルの入力(10~400%)、拡大、ダイアグラムの全体表示。 |
| ビュー | ‹ › 付きのダイアグラムを検索 | 名前、番号、説明、ID、属性値が一致する Action、I/O、Resource を強調表示します。↓ / ↑(または ‹ ›)で一致箇所の間を移動し、Enter で現在の一致箇所を選択します。 |
| ビュー | 内容 | Diagram Contents:図形、接続、関係をテキストで表示します。 |
| ビュー | 構成 | ルートとダイアグラムの種類をインスペクターに表示し、その場でどちらも切り替えられるようにします(構成:ルートと種類を参照)。 |
| ビュー | 整列 ▾ | 下の整列 ▾を参照してください。 |
| ビュー | ダイアグラムのチェックバッジ | 孤立項目と循環、および Action 図のチェック(メッセージを参照)。インスペクターに表示付きで一覧表示されます。 |
| ビュー | I/O、Resource、アセット、Parent I/O | Input/Output、Resource、実行する Asset、親の Input/Output の表示と非表示を切り替えます。選択はダイアグラムとともに保存され、新しい Action 図の既定になります。 |
| 種類の操作 | 分解 / 分解(グループ化) | Action を 1 つ選択している場合:その子の Action 図を開きます。複数の要素を選択している場合:それらを新しい子の Action にまとめます。 |
| 種類の操作 | 平坦化 | 選択した分解済みの Action を、その子フローで置き換えます。 |
| 種類の操作 | 開く | 選択したエンティティ、またはルートの項目ビューを開きます。 |
| 種類の操作 | ▶ シミュレーション ▾ | 離散イベントまたはモンテカルロ:このルートでシミュレーターを開きます。 |
| 出力 | エクスポート… | Diagram (PNG)(透明な背景と拡大率を指定可能)、Diagram (SVG)、Diagram (HTML)、Diagram (Word)、Diagram (Print)。 |
| その他 | ⋯ | あふれた項目、続いて項目ビューを開く、すべてのダイアグラム、Help for Action Diagram、ダイアグラムを削除…。 |
整列 ▾
| アイテム | 機能 |
|---|---|
| 既定値に戻す | 手動で配置した I/O と Resource の位置をクリアします。 |
| 表示 / 非表示 | Hide Resources、Hide All Input/Outputs、親の Input/Output を非表示、Hide Performing Assets、Hide Palette。その部分が非表示の間は、各項目が Show … と表示されます(たとえば Show Performing Assets)。 |
| Input/Output と Resource の位置をリセット | 移動したすべての I/O と Resource を自動レイアウトに戻します。 |
| Asset 図を生成 | 「root performers」を作成します。Asset 図を生成を参照してください。 |
| FFBD として開く | 同じフローを機能フローブロック図として開きます。 |
| ダイアグラムの設定 | インスペクターのルートと子の番号を振り直す…(旧番号 → 新番号。子の順序(アウトラインまたはフロー)はプロジェクトの環境設定 → 番号付けで決まります。1 回の元に戻すですべて取り消せます)。 |
| 追加パネルを非表示 / 追加パネルを表示 | すべてのダイアグラムで左のサイドバー(パレットと注釈)を非表示にします。 |
Asset 図を生成
整列 ▾ → Asset 図を生成は、フローの実行者からフローの物理的なコンテキストを構築します。
- Asset「root performers」を作成します。その Asset がルートの Action を実行します。
- 新しい Asset は、実行するすべての Asset によって decomposed by されます。実行者は、ルートより下のすべてのレベルの performed by と分岐の実行者から得られます。
- Action が I/O をやり取りする Asset のペアごとに、Conduit を再利用または作成します。Conduit の名前は「A to B」、I/O が双方向の場合は「A / B」で、それらの I/O を transfers します。
- その後、Asset 図を開きます。
パレット
追加パネル(ヒント 線または図形の上にドラッグするか、Enter を押す)には次のものがあります。
| アイテム | ドロップ先 | 作成されるもの |
|---|---|---|
| Action | 線 | 新しい Action「New Action」 |
| 並列 | 線 | Parallel branches (no entity) |
| または | 線 | Yes/No の分岐を持つ OR の Action エンティティ |
| Sync | 線 | SYNC の Action エンティティ |
| ループ | 線 | LOOP の Action エンティティ(空の本体、2 回の反復) |
| 出口 | 線 | EXIT |
| Input/Output | Action、またはどこでも | 「I/O」という名前の新しい I/O。Action 上にドロップした場合は、その Action が生成します |
| Resource | Action、またはどこでも | 「Resource」という名前の新しい Resource。Action 上にドロップした場合は消費されます(Amount 1) |
| 実行者 | Parallel または SYNC の分岐線 | Asset(この分岐の実行者)を尋ね、その Asset が分岐を実行します |
追加または検索…に名前を入力します:作成には "name" as Action、Or、Sync、Loop、Input/Output、Resource が表示され、プロジェクト内には一致する Action、Input/Output、Resource、Asset が一覧表示されます(最大 60 件。ルートと構造のエンティティを除く)。行をドラッグするか、行の上で Enter を押します。
パレットの下には、すべてのダイアグラムで共通の注釈セクションがあります。追加パネルのヘッダーの × で非表示にし、整列 ▾ → Show Palette で元に戻します。
キャンバスでの操作
| ジェスチャー | 結果 |
|---|---|
| 図形をクリック | 選択します。インスペクターに表示されます |
| Shift+クリック | 要素を選択に追加、または選択から除去します |
| 線をクリック | それが属する分岐を選択します(メインの線では選択を解除します) |
| 背景をクリック | 選択を解除する |
| Action または構造を線の上にドラッグ | (中身ごと)そこに移動します |
| I/O または Resource をドラッグ | 自由に配置します |
| 緑のハンドルをドラッグ | 接続します(Input/Output と Resource を接続するを参照) |
| Action をダブルクリック | 分解されている場合はその子の Action 図を、それ以外の場合は項目ビューを開きます |
| I/O または Resource をダブルクリック | その項目ビューを開きます |
| 分解アイコンをクリック | 子の Action 図を開きます |
| 背景をドラッグ | パン |
| スクロール / ⌘ / Ctrl+スクロール | パン / ポインター位置でズーム |
各図形が示すもの
- Action のボックス:番号(上)、名前、その下の 1 行。その行には Duration(たとえば 1 minute)、またはアセットがオンのときは実行する Asset が表示されます。
- 左下の紫の { }:Action または構造にシミュレーションのスクリプトがあります。
- 右上の分解アイコン:Action に独自の子フローがあります。アイコンをクリックすると開きます。
- OR の分岐ラベル:ガードの名前と、その確率(Yes (75%))または条件(Low [< 20]、[else])。
- Parallel と SYNC の分岐ラベル:分岐の名前とその実行者。
- 戻り矢印の下のループのテキスト:Continue (×4)、Continue (50%)、Continue while Battery Charge > 20、Continue (script)、Continue (ask)。Exit は出口を示します。
- 構造の名前:OR、SYNC、LOOP のブロックの横に斜体で表示されます。
インスペクター
右側のインスペクターには選択内容が表示されます。表示される内容は、選択したものによって異なります。
Action、Input/Output、Resource、Asset:共通のエンティティパネル。次のものがあります。
- クラス、番号、名前のあるヘッダーと開く場所 ▾(項目ビューと、このエンティティの他のすべてのダイアグラム)
- 定義:番号、名前、説明
- 図形:下の表にある追加の操作と位置とサイズ
- 属性グループ(ワークフロー、スケジュールなど)、続いてトレース、ディスカッション、詳細
このダイアグラムが管理する関係は、ダイアグラムとモデルの同期を保つため、トレースセクションでロックされています。対象は consumed by、decomposed by、generated by、performed by、produced by、received by、seized by です。
| 選択 | 追加の操作 |
|---|---|
| Action | Action 図、スクリプトを編集…、平坦化(分解されている場合)、除去、項目を削除… |
| 移動した Input/Output または Resource | 位置をリセット |
| 子の I/O に分解された親の I/O | 親の Input/Output を表示は、その代わりに子を表示します。親の Input/Output を非表示で元に戻ります |
| 任意 | 除去と項目を削除… |
OR を選択した場合(パネル OR (Decision)):
- 判断名:OR エンティティの名前。
- 判断の種類:確率、リソース量、スクリプト、なし(実行中に確認、またはランダム)。
- Resource(リソース量の場合のみ):量を比較する Resource。
- Branches:分岐ごとのガードの名前。種類に応じて、各分岐には確率(0~100 %)、または演算子(
==、!=、>、<、>=、<=、else)と値もあります。 - 合計の行:合計 100%、または警告 分岐の確率の合計が N % です。合計が 100 % になるように変更してください。 と表示されます。
- スクリプトを編集…/スクリプトを追加…(スクリプトの種類):onEnd() は、進む分岐のガード名を返します。
- 「なし」の種類の注記:「Prompt」の判断では、シミュレーターがどのパスに進むかを尋ねます。自動化されている場合は、分岐をランダムに選びます。
- + 分岐を追加、項目を開く。
SYNC を選択した場合:
- 名前。
- 制限時間:任意。この時間が経過すると SYNC が終了し、まだ実行中の分岐を停止します。
- 注記 N 個の分岐が同時に実行されます。すべてが終了するとフローが続きます。
- 分岐ごとに 1 行:分岐の名前と + Asset。Asset を設定すると、行に ⟂ Asset 名と、それを除去する × が表示されます。
- スクリプトを編集…/スクリプトを追加…、+ 分岐を追加、項目を開く。
Parallel を選択した場合:SYNC と同じですが、エンティティのフィールドはありません。
分岐を選択した場合:分岐 N を選択中 — + Action でこの分岐に追加します。
LOOP を選択した場合:
- 名前(条件)。
- 次の間は繰り返す:反復回数、確率、リソース量、スクリプト、なし(実行中に確認、またはランダム)。
- 条件に応じて:反復回数(最小 1)、続行する確率 (%)、または Resource と、演算子と値を指定した continue while amount。
- スクリプトの注記:各回の前に onEnd() が呼び出されます。true を返すと本体がもう一度実行されます。
- 「なし」の注記:「Prompt」の判断では、シミュレーターが反復回数を尋ねます。自動化されている場合は、ランダムに 0~2 回実行します。
- スクリプトを編集…/スクリプトを追加…、注記 ループ本体内の EXIT はループを早期に終了します。、項目を開く。
EXIT を選択した場合:到達すると、囲んでいる LOOP またはこのフローを終了します。
複数の要素を選択した場合:N 個の要素を選択中、期間(Action N 件)(ライブフィールド:変更すると、選択したすべての Action の Duration が 1 回の元に戻す単位で設定されます。所要時間が異なる場合は空のままです)、分解(新しい子 Action にグループ化)、除去。
ダイアグラムと LML の対応
| ダイアグラム上 | モデル内 |
|---|---|
| ダイアグラムのルート | 親の Action |
| Action のボックス | 子の Action:親が子に decomposed by |
| OR、SYNC、LOOP のブロック | 制御タイプを持つ子の Action。親に decomposed by される |
| 順序、分岐、ループ | 親とともに保存されるフローの構造(子が実行される順序) |
| Action から I/O への線 | Action が Input/Output を generates |
| I/O から Action への線 | Action が Input/Output を receives。関係の属性 トリガー付き(Yes = トリガー、No = 任意) |
| Action と Resource の間の線 | consumes、produces、seizes。それぞれ属性 Amount 付き |
| ⟂ Asset | Asset が Action を performs(逆は performed by)。関係の属性 Amount は、Action が占有するその Asset の数です。 |
| ボックス上の Duration | Action の Duration 属性(数値または分布と単位) |
| 子フロー | 子の Action 自身の Action 図 |
このダイアグラムに登場するクラスの属性:
- Action:Start(日時)、Duration(値または分布と、Seconds、Minutes、Hours、Days、Weeks、Months、Years のいずれか)、Percent Complete。
- Resource:Units、Initial Amount、Minimum Amount、Maximum Amount。
- Input/Output:サイズ、単位、Type、値。
シミュレーションのスクリプト
スクリプトは、計算された所要時間やモデルの値に基づく判断など、ダイアグラムだけでは表現できない振る舞いを追加します。
スクリプトを編集するには:
- Action、OR、SYNC、LOOP のいずれかを選択します。
- スクリプトを編集…(Action)、またはスクリプトを編集…/スクリプトを追加…(OR、SYNC、LOOP)をクリックします。
- Add onStart()、Add prompt()、Add onEnd()、Add duration() のいずれかをクリックすると、空のフック関数が挿入されます。
- コードを書きます。Tab で空白が 2 つ入ります。
- 保存をクリックします。空のスクリプトはスクリプトを除去します。
フック:
onStart()は要素の開始時に実行されます。prompt(p)はユーザーへの質問を組み立てます:p.setTitle()、p.addEnumInput(title, name, choices, default)、addTextInput、addNumberInput、addBooleanInput。onEnd(response)は終了時に実行されます。OR は進む分岐の名前を返します。LOOP は本体をもう一度実行する場合にtrueを返します。duration()は、Action の Duration が=script()のときに、その Action の所要時間を返します。
スクリプトから呼び出せるもの:
Sim.getEntityByName(n),Sim.getAmount(name),Sim.setResourceByName(name, v);Sim.getCurrentTime(),Sim.getCurrentCost();print(x);globals.put(k, v)/globals.get(k).
トップレベルの変数は実行中ずっと保持されます。Math.random は、実行のシード付き乱数生成器を使います。API の全体、サンドボックス、信頼の確認についてはシミュレーションを参照してください。
削除と除去
Delete または除去は、選択範囲をただちにダイアグラムから外し、エンティティは残します。注記 ダイアグラムから除去しました。 には元に戻すと項目を削除…があります。⇧Delete / Shift+Delete または項目を削除…は、最初に確認したうえでエンティティも削除します。どちらも 1 回の元に戻すで取り消せます(除去と削除を参照)。
| 選択 | 除去でダイアグラムから外れるもの | ⇧Delete / Shift+Delete でさらに削除されるもの |
|---|---|---|
| Action、OR、SYNC、LOOP | その要素と、その中の要素 | その要素のエンティティ |
| Parallel または EXIT | その構造と、その中の要素 | その中のエンティティ |
| 分岐 | 分岐とその要素。最後の分岐、またはループの本体の場合は、構造全体が除去されます | 分岐上のエンティティ |
| 複数の要素 | 選択したすべての要素 | それらのエンティティ |
| Input/Output、Resource、Asset | ここに表示されている Action へのリンク | そのエンティティ |
| 実行者(インスペクターの ×) | 実行者を除去:「name」はこの分岐上の N 個の Action を実行しています。それらの performed by 関係も除去しますか? | 関係を保持、関係を削除 |
除去は、Action からルートへの decomposed by リンクも除去するため、その Action は子ではなくなります。エンティティとその他の関係は残ります。
キーボードショートカット
| キー | Action |
|---|---|
| Delete または Backspace | 選択をダイアグラムから除去する(エンティティは残る) |
| ⇧Delete / Shift+Delete | 確認の後、選択したエンティティをプロジェクトから削除します |
| Esc | 選択を解除する |
| Shift+クリック | 選択に追加する、または選択から外す |
| ⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+Z | 元に戻す / やり直す |
| パレットの項目で Enter または Space | 挿入します(構造はメインフローの末尾に、I/O と Resource は中央に) |
| ⌘ / Ctrl+スクロール | ズーム |
| ズームのフィールドで Enter | 入力したズームレベルを適用します |
| ダイアグラムを検索で ↓ / ↑ | 次 / 前の一致箇所。Enter で選択し、Esc で検索をクリアします |
オプションと設定
- 表示/非表示(ツールバーの切り替えと整列 ▾):I/O、Resource、アセット、Parent I/O、パレット。ダイアグラムごとに保存され、このブラウザーでは新しい Action 図の既定として記憶されます。既定値:I/O、Resource、Parent I/O、パレットはオン、アセットはオフ。
- I/O と Resource の位置:ダイアグラムごとに保存されます。位置をリセットまたは Input/Output と Resource の位置をリセットでリセットします。
- ズームと位置:ダイアグラムごとに保存されます。ダイアグラムは全体表示で開きますが、70% 未満にはなりません。
- 読み取り専用の表示:閲覧者のロールを持つユーザーには、ツールバーの編集グループ、パレット、ハンドル、選択パネルのないダイアグラムが表示されます。パン、ズーム、検索、エクスポートはできます。
メッセージ
| メッセージ | 意味 |
|---|---|
| 構造をフローの線にドロップしてください。 | 構造と Action は矢印の上にしか挿入できません。 |
| 要素をそれ自身の中に入れることはできません。外側にドロップしてください。 | 構造をそれ自身の分岐内にドロップしたか、ルートまたはその祖先を追加しようとした。 |
| 「name」はすでにこのダイアグラムにあります。 | その Action はすでにフロー内にある。 |
| 分岐を追加する Parallel、SYNC、OR を選択してください | + 分岐には、それらのいずれか(またはその分岐の 1 つ)の選択が必要。 |
| 先に Input/Output を生成する Action を選択してください | + I/O には Action の選択が必要。 |
| 分解する Action を選択するか、複数を Shift+クリックしてグループ化してください | 分解には Action(構造ではない)が必要。 |
| グループ化できません:要素が別々の分岐にあります。1 つのシーケンス内の要素を選択してください。 | グループ化する要素は 1 つのシーケンスを共有している必要がある。 |
| グループ化できません:要素が隣り合っていません。連続する要素を選択してください。 | グループ化する要素は連続している必要がある。 |
| 新しい子 Action にグループ化しました。インスペクターで名前を付けてください。 | 分解(グループ化)が成功した。 |
| 平坦化する、子のダイアグラムを持つ Action を選択してください | 平坦化には、子フローを持つ Action が必要。 |
| 子のダイアグラムが空です。平坦化する前に Action を追加してください。 | 子の Action に子がない。 |
| 平坦化できません:子の制御フローの形式が正しくありません。 | 子フローが削除済みのエンティティを参照している。開いて修復します。 |
| このグループは平坦化できません:子の 1 つがすでにこのレベルにあります。 | 平坦化すると、Action が 2 か所に配置されることになる。 |
| 反復回数は 1 以上にする必要があります。1 以上の整数を入力してください。 | 1 未満の反復回数は受け付けられない。 |
| 分岐の確率の合計が N % です。合計が 100 % になるように変更してください。 | OR の確率を修正します。 |
| 「name」がこの分岐上の Action を実行するようになりました。 | 実行者が設定された。 |
| ここにある Action には実行者がありません。Action を Asset に関連付ける(performed by)か、分岐に実行者をドロップしてください。 | Asset 図の生成で、配置するものがない。 |
| N 個の Asset と M 個の Conduit を持つ「name performers」を作成しました。 | Asset 図の生成が成功した。 |
| ここに要素をドラッグするか、+ Action をクリック | フローが空である。 |
| この Action は削除されました。 | ルートが削除された。 |
| ダイアグラムのチェックバッジの ✓ チェック | チェックで何も見つからなかった。 |
| … はこのダイアグラム上の他の何とも関係がありません。… 接続するか除去してください。 | ダイアグラムのチェックの指摘事項(孤立項目と循環)と、その理由:Input/Output「name」は、このダイアグラムのどの Action にも生成も受信もされていません。、Resource「name」は、このダイアグラムのどの Action にも消費、生産、占有されていません。、Action「name」に Duration がありません(0 としてシミュレーションされます)。 |
| 分解が循環しています:… これらの decomposed by 関係のいずれかを除去してください。 | Action が(間接的に)自身の子になっている。 |
| 表示のみ:オーナーに編集アクセスを依頼してください。 | このプロジェクトでのあなたのロールは閲覧者です。 |
制限事項
- 親の Action ごとにフローは 1 つです。
- Action は 1 つのフロー内に 1 回しか登場できません。繰り返すには LOOP を使います。
- 追加または検索…には、プロジェクト内で一致した最初の 60 件が表示されます。絞り込むには名前の続きを入力します。
- OR の確率は 0~100 の整数のパーセントです。
- ループの反復回数は 1 以上の整数です。
- シミュレーションでは所要時間が負になることはありません。サンプリングした値が負の場合は、もう一度抽出されます。
- 範囲選択では注釈だけが選択されます。フローの要素には Shift+クリックを使います。
関連ページ
- ダイアグラム:共通のエディター、エクスポート、注釈。
- 機能分析:機能、FFBD、その表。
- シミュレーション:離散イベントとモンテカルロの実行、スクリプト、結果。
- SysML ダイアグラム:同じ Action に基づくアクティビティ図とシーケンス図。
- その他のダイアグラム:Asset 図、タイムライン図、IDEF0、N² 図。
- ヘルプ:Action 図を作成する、Action 図、シミュレーションのスクリプト。