| On this page |
このノードを使用することで、エクスプレッションによって生成されるコマンドラインを持ったワークアイテムを生成することができます。 場合によっては、ネットワークを開始した時点では何もしない(コマンドラインが空っぽのままの)特定の数のワークアイテムを単に生成して、それらのワークアイテムにアトリビュートを追加して、それらのアトリビュートを使って下流のノードを駆動させるのにも役立ちます。
もっと高度な機能が必要であれば、代わりに
Python Processorノードを使用してください。
このノードは、入力がなくても Item Count ワークアイテムを生成し、入力があれば、上流のワークアイテム毎に Item Count ワークアイテムを生成します。
パラメータ
Work Item Generation
このノードが静的または動的なワークアイテムのどちらを生成するかどうか。 このノードのワークアイテムが静的に計算可能かどうか、もしくは、動的に生成させる必要があるかどうか分からないのであれば、通常では、これを"Automatic"のままに設定してください。
Dynamic
このノードが常に動的なワークアイテムを生成します。つまり、上流のワークアイテムが判明するまで待機し、その上流のワークアイテムから新しいワークアイテムを生成します。
Static
このノードが常に静的なワークアイテムを生成します。つまり、ネットワークを実行する前にパラメータ(と上流の静的なワークアイテム)に基づいて必要だと思われるだけの数のワークアイテムを生成します。
Automatic
入力が静的(静的なプロセッサ、静的な入力のみを使ったパーティショナー、マッパー)な場合、このノードは静的なワークアイテムを生成し、そうでない場合、動的なワークアイテムを生成します。
Processor
Sequential
これを有効にすると、このノードから生成されるワークアイテムはお互いに依存するように作成されるので、それらのワークアイテムは同時ではなく順々に実行されます。 例えば、インデックス1のワークアイテムはインデックス0に依存し、インデックス2はインデックス1に依存します。
Copy Inputs to Outputs
このオプションを有効にすると、このノード内のワークアイテムは、入力ファイルを出力ファイルリストに自動的にコピーします。 無効にすると、このノードは、コマンドラインで出力ファイルをワークアイテムに添付するものと想定します。
Item Count
入力のワークアイテム毎に生成する出力ワークアイテムの数。入力のワークアイテムが存在しなければ、このノードは、この数だけの出力ワークアイテムを生成します。
Index
デフォルトでは、このノードは、生成したワークアイテムに対して順々に0から始まるindexアトリビュートを付けます。
エクスプレッションを使って独自のindex値を生成したいのであれば、これを有効にして、テキストフィールドにエクスプレッションを入力してください。
Frame
デフォルトでは、生成されたワークアイテムは、それに該当する入力のワークアイテムからframeアトリビュートを継承します。
エクスプレッションを使って独自のframe値を生成したいのであれば、これを有効にして、テキストフィールドにエクスプレッションを入力してください。
Specify Command Using
コマンドライン実行可能ファイルの指定方法を決めます。 ここでは、カスタム文字列を定義したり、遅延時間を指定したり、コマンドライン引数のマルチパラメータを使用することができます。
Command
Specify Command Using パラメータが Custom String に設定されている時、このパラメータが評価されて、このノード内のワークアイテムのコマンド文字列が決まります。
Delay Time
Specifiy Command Using オプションが Delay に設定されている時、このパラメータは、使用する遅延の長さ(秒)を決定します。 このノード内のワークアイテムは、 カスタムのコマンドラインを実行するのではなくて 、汎用sleep/waitコマンドラインを実行します。 場合によっては、これは、遅い作業負荷をシミュレーションして残りのネットワークへの影響を確認するのに役立ちます。 例えば、ノードが処理を進める前に正しく結果を待機できるかどうかをチェックすることができます。
Interactive Command Builder
単一エクスプレッションでコマンドライン文字列を指定するのではなくて、マルチパラメータのコマンドビルダーを使用することで、もっと簡単に実行可能ファイルの引数を構成することができます。 これらの引数は、上流のファイルまたはワークアイテムアトリビュートで駆動させることができます。 この引数データが配列であれば、指定したセパレータを使用してその配列値が自動的に文字列に展開されます。 引数をコマンド出力としてマークすることもできます。 その場合、その引数の値(s)はワークアイテム上に出力ファイルとして追加されます。
Base Command
ベースコマンドライン。 このベースコマンドラインの末尾に Extra Arguments の追加引数が追加されます。 このパラメータには、実行可能ファイルと、マルチパラメータで利用可能な追加機能を必要としない単純な引数を含めてください。
Extra Arguments
コマンドの末尾に足す追加引数の数。
Argument Name
-oや--outputなどの引数の名前。
この名前には必要に応じて-を入れてください。
Argument Source
引数に渡されるデータのソース。 この値には、上流の出力ファイル、アトリビュート名、カスタムエクスプレッションを指定することができます。
Input File Tag
Argument Source が Upstream Output Files に設定されている時、このパラメータは、ファイルをフィルタリングする際に使用するタグを決めます。
Attribute Name
Argument Source が Attribute Name に設定されている時、このパラメータには、引数データを設定する際に使用するアトリビュートの 名前 を設定してください。 PDGは配列長に関係なく配列アトリビュートを読み込んで文字列に変換することができるので、このオプションは、配列データを照会する時に役立ちます。
Attribute Value
Argument Source が Custom Value に設定されている時、このパラメータはワークアイテム毎に評価されて、その引数値を決めます。
Collapse Arrays To
ファイルまたはアトリビュート値の配列をコマンドラインに追加する時に、その配列の制御方法を決めます。 配列は、スペース区切りの値のリスト、カンマ区切りの値のリスト、独自セパレータで区切った値のリストとして追加することができます。 別の方法として、引数全体を配列内のエントリー毎にコピーすることができます。 このパラメータは、引数データに Custom Value を指定した時には利用不可です。
例えば、["example", "example1", "example2"]のエントリーを含んだ入力データ配列と"–input"の引数名を渡すと、以下の展開が行なわれます:
Space-Separated String
executable --input "example" "example1" "example2"
Comma-Separated String
executable --input "example","example1","example2"
String with Custom Separator, set to "#"
executable --input "example"#"example1"#"example2"
Multiple Arguments
executable --input "example" --input "example1" --input "example2"
Array Separator
Collapse Arrays To が String with Custom Separator に設定されている時、このパラメータは、配列内のエントリー間で使用するセパレータを決めます。
Attach Argument as Output File
このトグルを有効にすると、この引数からの値(s)がワークアイテム上に出力ファイルとして追加されます。
Output File Tag
出力ファイルをワークアイテムに追加する時に使用するファイルタグ。
Schedulers
TOP Scheduler Override
このパラメータは、このノードのTOPスケジューラを上書きします。
Work Item Priority
このパラメータは、現行スケジューラがこのノード内のワークアイテムの優先度を設定する方法を決めます。
Inherit From Upstream Item
ワークアイテムは、親ワークアイテムの優先度を継承します。ワークアイテムに親ワークアイテムがなければ、その優先度は0に設定されます。
Custom Expression
ワークアイテムの優先度は、 Priority Expression の値に設定されます。
Node Defines Priority
ワークアイテムの優先度は、このノード自身の内部優先度計算に基づいて設定されます。
このオプションは、 Python Processor TOP, 
ROP Fetch TOP, ROP Output TOPのノードでのみ利用可能です。
これらのノードは、各自のノードロジックで実装された優先度設定スキームを定義しています。
Priority Expression
このパラメータは、 Work Item Priority が Custom Expression に設定されている時にのみ利用可能です。
このパラメータには、ワークアイテムの優先度を設定するためのエクスプレッションを指定します。 このエクスプレッションは、ノード内のワークアイム毎に評価されます。
Examples
example_top_genericgenerator Example for Generic Generator TOP node
このサンプルでは、汎用ジェネレータを使って、セットアップの試行と独自コマンドラインの実行の両方を行なう方法について説明しています。
| See also |
