On this page |
概要 ¶
ワークアイテムは、output
アトリビュートの項目から生成された結果を追跡します。
その結果は文字列、通常ではワークアイテムが生成したファイルのファイルパスです。
すべての結果には、その結果のタイプを示した“タグ”文字列が付きます。このタグ文字列は、幅広いタイプから特定のタイプまでの階層をスラッシュで区切った文字列です(MIMEタイプと同様ですが、完全に自由形式になっています)。例:
タグ |
説明 |
---|---|
|
ジオメトリファイル |
|
地形ジオメトリファイル |
|
ビルを含んだジオメトリファイル |
一部のノードとAPI関数は、このタグによってファイルのマッチングを行なうことができます。
タグのマッチングに接頭辞を使用すると、file/geo/terrain
のタグが付いたファイルは、file/geo
とfile
の両方の接頭辞にマッチしますが、file/geo/building
の接頭辞にはマッチしません。
一般的にはワークアイテムはファイルを出力しますが、他のタイプの情報を結果としてレポートさせることも可能です。
例えば、ROP Fetchを使って分散シミュレーションをクックすると、そのシミュレーショントラッカーのワークアイテムはsocket/ip
とsocket/port
の結果をレポートします。
他のワークアイテムは、その結果を使用することで、そのシミュレーショントラッカーに接続することができます。
結果にタグを付ける方法 ¶
-
通常では、ファイルを生成するノードには、ワークアイテムの結果にタグを付ける方法を指定するためのパラメータがあります。デフォルトのタグは、通常ではそのノードの意図した用途に基づいて設定されています。
例えば、Geometry Importノードは、SOPネットワークをクックして、その結果をディスク上のジオメトリファイルに書き出すことができます。 このノードには、生成されたファイルにタグを設定するための Result Tag パラメータがあります。 デフォルトのタグは
file/geo
です。
タグを使用する方法 ¶
-
ワークアイテムのInfoウィンドウやTask Graph Tableウィンドウでは、結果に割り当てられたタグを確認することができます。
-
タグは、ワークアイテムに複数のファイルを関連付ける時に役立ちます。
例えば、Partition by Boundsノードは、地形タイル、そのタイルに交差した道路ジオメトリからパーティションを作成することができます。 このパーティションには最終的に複数のファイル(地形ファイル、0個以上の道路ファイル)が関連付けられます。 地形ファイルに
file/geo/terrain
タグ、道路ファイルにfile/geo/road
タグを付ければ、それらのファイルが扱いやすくなります。 -
PythonスクリプトAPIを使えば、タグによって結果を照会することができます。pdg.input()関数の
tag
パラメータに接頭辞を指定することで、その接頭辞でタグがマッチした結果のみを返すことができます。# 入力のワークアイテムからfile/imageというタグが付いた入力ファイルすべてが返されます。 pdg.input(tag='file/image')