Houdini 18.0 ノード TOPノード

HDA Processor TOP node

デジタルアセットをクックするワークアイテムを生成します。

On this page

This node generates work items that cook an HDA using Hython. The values of the HDA’s parameters can be specified in the HDA Parameters tab of the node, which will then be applied as attributes on the work item and used in the job environment to configure the HDA before cooking.

HDA Processor currently supports Object, Sop, and Cop2 type HDAs.

TOP Attributes

HDA Processorは、このノードの HDA Parameters フォルダに追加されたすべてのSpareパラメータからワークアイテム上にアトリビュートを作成します。 さらに、以下のビルトインのアトリビュートを作成します:

batchmode

integer

Indicates the Batch Mode selection (0 = Off, 1 = All Items in One Batch, 2 = Custom Batch Size).

connectiontimeout

integer

Indicates the connection timeout limit (ms) when using the HDA Processor service.

cookwhen

integer

Indicates the Cook Batch When selection (0 = All Items are Ready, 1 = First Item is Ready).

hda

string

ワークアイテムのジョブでクックされるデジタルアセットのパス。

operatortype

string

デジタルアセット内のオペレータタイプ。 Operator Type パラメータを使ってオペレータタイプを指定しなかった場合、このアトリビュートには空っぽの文字列が設定され、そのワークアイテムは.hda内の最初のオペレータを使用するようになります。

createfileinput

integer

Indicates the Create File Inputs choice (0 = Do not create file inputs, 1 = Create file inputs).

fileinputs

integer

Specifies the number of file inputs that will be inputted to the HDA.

writeoutput

integer

Indicates the Write Outputs selection ( 0 = Do not write outputs, 1 = Write outputs).

dumpdebug

integer

Indicates whether to save a debug .hip file (0 = Do not save .hip file, 1 = Save .hip file)

inputpath

string

A list of paths to the file inputs that will be inputted to the HDA.

outputfiles

integer

Specifies the number of output files that will be written from the HDA.

hdasopname

string

When cooking an Object level HDA, this specifies the name of the SOP that is the source of the output file(s) to write out. If this empty, the HDA Processor job will attempt to find a valid node to output and issue a warning in the job log.

outputpath

string

A list of paths that specify the files to be written out.

outputtag

string

A list of file tags that specify the result tag for each output file.

hdaparms_floats

string

A list of names of all the float attributes that specify an HDA Parameter float value.

hdaparms_ints

string

A list of names of all the integer attributes that specifify an HDA Parameter integer value.

hdaparms_strings

string

A list of names of all the string attributes that specify an HDA Parameter string value.

hdaparms_buttons

string

A list of names of all the integer attributes that specify an HDA Parameter button value. Note that buttons get converted to a toggle within the HDA Parameters tab. When that toggle is enabled, it means that HDA Processor will press the button before cooking.

パラメータ

Generation

Asset

Template Node

This parameter can be used to select an instance of a digital asset within the current Houdini session. All of the template node’s non-default parameter values will be applied to the HDA Processor’s HDA Parameters.

HDA File

クックするHDAのパス。このパスには、絶対パスまたはHOUDINI_PATHを基準とした相対パスを指定することができます。

例えば、myasset.hdaアセットがhou.homeHoudiniDirectory()otlsサブディレクトリ下にあった場合、そのHDAをotls/myasset.hdaとして指定することができます。

Any HDAs that are added to this node’s File Dependencies will automatically be copied to the $PDG_TEMP/otls directory. Any nested HDAs that are required by the HDA being cooked should be added as a File Dependency if they are not otherwise available on the user’s HOUDINI_PATH.

Operator Type

デジタルアセットから選択するオペレータタイプ。 Operator Type を指定しなかった場合、HDA Processorはアセットをクックした時に最初に見つかったタイプを取得します。

Update HDA Parameters

このボタンを押すと、 HDA Parameters セクションが更新されます。

Filter HDA Parameters

Opens a dialog that can be used to configure which parameters from the asset should be included in the HDA Parameters tab of this node. Any parameters that are included in the HDA Parameters section of the node will have their values set when HDA Processor cooks the HDA.

Work Items

Work Item Generation

このノードが静的または動的なワークアイテムのどちらを生成するかどうか。 このノードのワークアイテムが静的に計算可能かどうか、もしくは、動的に生成させる必要があるかどうか分からないのであれば、通常では、これを"Automatic"のままに設定してください。

Dynamic

このノードが常に動的なワークアイテムを生成します。つまり、上流のワークアイテムが判明するまで待機し、その上流のワークアイテムから新しいワークアイテムを生成します。

Static

このノードが常に静的なワークアイテムを生成します。つまり、ネットワークを実行する前にパラメータ(と上流の静的なワークアイテム)に基づいて必要だと思われるだけの数のワークアイテムを生成します。

Automatic

入力が静的(静的なプロセッサ、静的な入力のみを使ったパーティショナー、マッパー)な場合、このノードは静的なワークアイテムを生成し、そうでない場合、動的なワークアイテムを生成します。

Cache Mode

ワークアイテムから目的のファイル結果がレポートされるように、プロセッサノードがそのワークアイテムを制御する方法。

Automatic

目的の結果ファイルがディスク上に存在すれば、そのワークアイテムはスケジュールに組まれずにクック済みとマークされます。 そのファイルが存在しなければ、そのワークアイテムは通常どおりにスケジュールに組まれます。

Read Files

目的の結果ファイルがディスク上に存在すれば、そのワークアイテムはスケジュールに組まれずにクック済みとマークされます。 そのファイルが存在しなければ、そのワークアイテムは失敗とマークされます。

Write Files

目的の結果ファイルがディスク上に存在していても、ワークアイテムが常にスケジュールに組まれ、その目的の結果ファイルを無視します。

Batch Mode

Off

No batching is performed. Each work item is submitted as its own inidivdual job.

All Items in One Batch

All work items will be submitted as a single batch job and take place in a single Hython session. This option can significantly increase the speed at which the node finishes cooking, especially if the HDA has a relatively quick cooking time such that the time to start up a Hython process is longer than the time it takes to cook the HDA.

Custom Batch Size

Work items will be submitted as batch jobs that are the size specified by the Batch Size parameter. This option can significantly increase the performance of the node since it allows for various optimizations to be performed (such as only having to instantiate the HDA once per batch job).

Batch Size

When Batch Mode is set to Custom Batch Size, this specifies the size of each batch. If there is underflow in the last batch, the size of the last batch will be the remaining work items.

Cook Batch When

Determines when batches of work items are scheduled. By default, the batch will be scheduled once the dependencies for all work items are cooked. However, it is possible to schedule the batch as soon as the first work item can run.

All Items are Ready

The batch will only be scheduled once all dependencies on all work items in the batch are satisfied.

First Item is Ready

The batch will be scheduled as soon as the dependencies for its first work item are ready. The HDA Processor wrapper script used by PDG will communicate back to PDG as the job is running to check the status of the dependencies before cooking each work item in the batch. This incurs slightly more network overhead, and requires ongoing communication between the job and PDG.

Asset Inputs

Create File Inputs

このパラメータを有効にすると、複数のファイルノードがインスタンス化され、それらが入力としてアセットに接続されます。 これを使用することで、複数のHDA Processorノードを簡単にチェーン接続することができます。 When this option is enabled, the HDA type must be able to support file inputs (for example, OBJ level HDAs will not work with this option).

Input File Source

When Create File Inputs is enabled, this selects the source of the input files.

Upstream Output Files

The upstream output files with the tag specified in the File Tag parameter will be used as inputs to the HDA. This option is particularly useful when the number of inputs potentially vary.

Custom File Paths

When this mode is selected, the input files to the HDA must be manually specified using the Number of Inputs multiparameter.

File Tag

When the file source is set to Upstream Output Files, this specifies the file tag of the upstream output files to use.

Number of Inputs

作成する入力ファイルノードの数。

Input File #

The path to the input file that will be loaded in by the created file node.

Asset Outputs

HDA Type

This parameter is purely for UI purposes. When an HDA is selected, HDA Processor will attempt to set the HDA type, therefore giving the user more information about what type of asset they are working with, as well as deactivating any of the parameters that are not required to be filled for that type of asset.

Write Outputs

このトグルを有効にすると、HDA Processorはアセット内のディスプレイノードからジオメトリをディスクに出力するようになります。 アセットにCOPネットワークまたはROPネットワークが含めれば、これを無効にするのに役立ちます。

Sop Path

When the HDA is an Object level asset, an operator path or SOP name must be provided so that HDA Processor knows what geometry to output. It is recommended to use an operator path specified relative to the top level node of the HDA. For example, if you have an Object level asset with a geometry node contained within it named geometry_to_export (and you want to write out the geometry of that node to a file), the SOP path should be specified as ./geometry_to_export.

Number of Outputs

Since SOPs can have more than 1 output, this parameter is used to specify the number of outputs.

Output File Name #

出力を書き出す際のその出力ファイルの名前を指定します。

Output Tag #

出力を書き出す時にその結果ファイルに割り当てるResultタグを指定します。

Save Debug .hip File

このトグルを有効にすると、インスタンス化されたアセット、ファイルノード、すべてのパラメータ値を含んだデバッグ.hipファイルがディスクに書き出されます。 これは、アセットによる問題を追跡するのに役立ちます。 これを有効にすると実行が極端に遅くなってしまうので、ずっと有効のままにしないように注意してください。

Job Options

Use HDA Processor Service

With this enabled, HDA Processor will cook using the HDA Processor service. Note that there must be an active HDA Processor service available. See the PDG Service Manager documentation for more information on using services. If the node is unable to connect to the service, HDA Processor will cook in regular mode and add a warning to the node.

Connection Timeout (ms)

Specifies the connection timeout length (in milliseconds) for HDA Processor jobs. If this time is exceeded during the cook of the work item, the connection will time out and the job will fail.

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 PriorityCustom Expression に設定されている時にのみ利用可能です。

このパラメータには、ワークアイテムの優先度を設定するためのエクスプレッションを指定します。 このエクスプレッションは、ノード内のワークアイム毎に評価されます。

HDA Parameters

このノードのセクションは、選択したデジタルアセットのパラメータインターフェースに基づいて自動的に入力されます。 ここで設定したパラメータは、ワークアイテムアトリビュートにコピーされ、アセットがクックされた時にそのアセットに適用されます。

Files

File Dependencies

このノード内の最初のワークアイテムが実行される前にPDG作業ディレクトリにコピーしておきたいファイルのリスト。 これを使用することで、デジタルアセットやカスタムスクリプトなどのサポートファイルをワークアイテムジョブで利用可能にすることができます。

指定可能なパスは、絶対パスまたはHOUDINI_PATHを基準とした相対パスです。

Examples

example_top_hdaprocessor Example for HDA Processor TOP node

このサンプルでは、PDG/TOPでHDA Processorノードを使ってHDAを分布させる方法について説明しています。

See also

TOPノード

  • Attribute Copy

    あるブランチのワークアイテムのアトリビュートを他のブランチのワークアイテムにコピーします。

  • Attribute Create

    入力のワークアイテムすべてに対してアトリビュートを作成または設定します。

  • Attribute Delete

    ワークアイテムからアトリビュートを削除します。

  • Attribute from String

    ファイル名などの文字列からアトリビュート値を解析します。

  • Block Begin Feedback

    For-Loop with Feedbackブロックを開始します。このブロック内のTOPノードは直列で実行され、オプションで入力のワークアイテム毎にループさせることができます。

  • Block End Feedback

    For-Loop with Feedbackブロックを終了します。このブロック内のTOPノードは直列で実行され、オプションで入力のワークアイテム毎にループさせることができます。

  • CSV Input

    CSVファイルのデータをワークアイテムのアトリビュートにコピーします。

  • CSV Output

    ワークアイテムのアトリビュートをCSVファイルに書き出します。

  • Command Send

    実行させたいコードを共有サーバーに送信します。

  • Command Server End

    サーバーブロックを終了します。

  • Deadline Scheduler

    Thinkbox社のDeadlineソフトウェア用PDGスケジューラ。

  • Download File

    1つ以上のURLの内容をファイルにダウンロードします。

  • Environment Edit

    ワークアイテムのコマンドラインが実行する環境下で設定する変数を編集します。

  • Error

    条件を満たした時に警告またはエラーを生成します。

  • Error Handler

    失敗したワークアイテムのエラーハンドル。

  • FFmpeg Encode Video

    静止画像シーケンスを動画に変換します。

  • FFmpeg Extract Images

    動画ファイルから静止画像シーケンスを抽出します。

  • File Compress

    ファイルをアーカイブに圧縮します。

  • File Copy

    実行時またはノードがファイルを生成した時に、ファイルをある場所から別の場所にコピーします。

  • File Decompress

    入力のワークアイテムで指定されたアーカイブファイルを個々のファイルに解凍します。

  • File Pattern

    特定のパターンに合致したファイルに基づいてワークアイテムを生成します。

  • File Range

    特定のファイルパターンに基づいたフレーム範囲からワークアイテムを生成します。

  • File Remove

    指定したパスのファイルを削除します。

  • File Rename

    ファイルを名前変更または移動させます。

  • Filter by Expression

    上流のワークアイテムを条件付きでフィルタリングします。

  • Filter by Range

    指定したフレーム内またはアトリビュート範囲内にある上流のワークアイテムを絞り込みます。

  • Generic Generator

    アトリビュートなしでコマンドラインを実行するワークアイテムを生成します。

  • Geometry Import

    SOPまたはファイルジオメトリのポイントまたはプリミティブをワークアイテムアトリビュートまたは一時ファイルに読み込みます。

  • HDA Processor

    デジタルアセットをクックするワークアイテムを生成します。

  • HQueue Scheduler

    HQueueを使用してワークアイテムのスケジュールを組みます。

  • Houdini Server Begin

    持続型Houdiniコマンドサーバーを起動します。

  • ImageMagick

    一括で画像変換、サイズ変更、画像モザイクなどのImageMagickの機能に簡単にアクセスすることができます。

  • In Process Scheduler

    In-Processワークアイテムのスケジューリングを制御します。

  • Invoke

    入力ジオメトリに対してコンパイルブロックを呼び出します。

  • Json Input

    JSONファイルからデータを抽出してアトリビュートを作成します。

  • Json Output

    JSON出力を生成する色々なオペレーションを実行します。

  • Local Scheduler

    ローカルマシン上でワークアイテムのスケジュールを組みます。

  • Make Directory

    ディレクトリを作成します。

  • Map All

    上流のすべてのワークアイテムを下流のワークアイテムにマップします。

  • Map by Expression

    エクスプレッションを使って、上流のワークアイテムを下流のワークアイテムにマップします。

  • Map by Index

    上流のワークアイテムをインデックスに基づいて下流のワークアイテムにマップします。

  • Map by Range

    範囲を使って上流のワークアイテムを下流のワークアイテムにマップします。

  • Maya Server Begin

    持続型Mayaコマンドサーバーを起動します。

  • Merge

    上流のすべてのワークアイテムを結合します。

  • Nuke Server Begin

    持続型Nukeコマンドサーバーを開始します。

  • Null

    何もしません。

  • OP Notify

    何かしらのTOPワークが完了したことを通知します。

  • Output

    サブネット出力。

  • Partition by Attribute

    アトリビュートに基づいてワークアイテムを区分けします。

  • Partition by Bounds

    境界アイテムを使って、ソースアイテムを空間的に区分けします。

  • Partition by Combination

    ワークアイテムを2個毎、3個毎などに区分けします。

  • Partition by Comparison

    既存の比較を使ってワークアイテムを区分けします。

  • Partition by Expression

    エクスプレッションに基づいてワークアイテムを区分けします。

  • Partition by Frame

    フレームに基づいてワークアイテムを区分けします。

  • Partition by Index

    インデックスに基づいてワークアイテムを区分けします。

  • Partition by Node

    ノードに基づいてワークアイテムを区分けします。

  • Partition by Range

    範囲に基づいてワークアイテムを区分けします。

  • Partition by Tile

    軸に平行な境界ボックスを使ってワークアイテムを空間的に区分けします。

  • Perforce

    PDG経由でPerforceコマンドを実行します。

  • Python Mapper

    Pythonスクリプトを使ってワークアイテムをマップします。

  • Python Partitioner

    Pythonスクリプトを使ってワークアイテムを区分けします。

  • Python Processor

    Pythonスクリプトを使ってワークアイテムを生成します。

  • Python Scheduler

    Pythonベースでプログラミング可能なPDG用スケジューラ。

  • Python Script

    スクリプトを実行するワークアイテムを生成します。

  • Python Server Begin

    Pythonコマンドサーバーを起動します。

  • ROP Alembic Output

    埋め込まれたROP Alembic ROPノードをクックするワークアイテムを生成します。

  • ROP Composite Output

    埋め込まれたComposite ROPノードをクックするワークアイテムを生成します。

  • ROP Fetch

    ROPノードまたはROPネットワークをクックするワークアイテムを生成します。

  • ROP Geometry Output

    埋め込まれたGeometry ROPノードをクックするワークアイテムを生成します。

  • ROP Mantra Render

    埋め込まれたMantra ROPノードをクックするワークアイテムを生成します。

  • ROP USD Output

    組み込まれたUSD ROPノードをクックするワークアイテムを作成します。

  • Range Generate

    指定した範囲のワークアイテムを生成します。

  • Render IFD

    Mantraを使ってIFDファイルをレンダリングするワークアイテムを生成します。

  • SQL Input

    SQLクエリの作成と行毎にワークアイテムを生成する入力ノードです。

  • SQL Output

    SQL INSERTクエリを生成する出力ノードです。

  • Send Email

    電子メールを送信します。

  • Shotgun Create

    Shotgunエンティティを作成します。

  • Shotgun Delete

    Shotgunからエンティティを削除します。

  • Shotgun Download

    ShotgunからAttachmentをダウンロードします。

  • Shotgun Find

    Shotgunエンティティを検索します。

  • Shotgun Server Begin

    持続型Shotgunコマンドサーバーを起動します。

  • Shotgun Update

    Shotgunエンティティを更新します。

  • Shotgun Upload

    Shotgunにファイルをアップロードします。

  • Sort

    アトリビュートのリストからワークアイテムを並べ替えます。

  • Split

    上流のワークアイテムを2つのグループに分けます。

  • Subnetwork

    TOPノード用コンテナ。

  • Switch

    ネットワーク分岐を切り替えます。

  • TOP Fetch

    他のTOPネットワークをクックします。

  • TOP Fetch Input

    TOP Fetchで取得したネットワークの入力。

  • Text Output

    テキストを新しいファイルに書き出したり、既存ファイルに追加します。

  • Tractor Scheduler

    PixarのTractorを使ってワークアイテムのスケジュールを組みます。

  • USD Import

    USDステージで見つかったPrimsからワークアイテムを生成します。

  • USD Import Files

    USDステージで見つかったファイル参照からワークアイテムを作成します。

  • USD Render

    USDファイルを書き出すワークアイテムを作成します。

  • Wait for All

    上流のワークアイテムすべてが完了するのを待ちます。

  • Wedge

    アトリビュート値を色々と変えながらワークアイテムを生成します。

  • Work Item Expand

    ファイルリストまたはパーティションを複数のワークアイテムに展開します。

  • Xml Input

    XMLファイルからデータをワークアイテムアトリビュートに抽出します。