Houdini 17.5 Nodes TOP nodes

HDA Processor TOP node

Creates work items that cook a digital asset

On this page

This node generates work items that are cooked using the HDAProcessor executable that ships with Houdini. The attributes of the work item are applied as parameters to the asset.

TOP Attributes

HDA Processor will create attributes on work items for all spare parms added to the HDA Parameters folder on the node. Additionally, it will create the following built-in attributes:

hda

string

The path to the digital asset that will be cooked by the work item

operatortype

string

The operator type within the digital asset. If an operator type is not specified using the Operator Type parameter this attribute will be set to empty string, and the work item will use the first operator in the .hda.

fileinputs

integer

The number of input files, as specified in the Number of Inputs parameter.

inputpath

string array

The input file(s) that should be passed to file SOP inputs wired into the .hda. The length of the string array will match the value of the Number of Inputs parameter and the fileinputs attribute.

writegeo

integer

Set to 1 if Write Geometry is turned on, else 0.

outputpath

string

The output path where geometry will be written, if Write Geometry is turned on.

outputtag

string

The result data tag associated with the output path.

dumpdebug

integer

Set to 1 if Save Debug .hip File is turned on, else 0.

Parameters

Generation

Asset

Template Node

An instance of a digital asset in the current Houdini session. The HDA Processor will cook instances of that asset and use its parameter values as defaults.

HDA File

The path of the HDA to cook. This path can be absolute or it can be relative to HOUDINI_PATH.

For example an asset myasset.hda is in a sub-directory otls in hou.homeHoudiniDirectory(), you can specify it as otls/myasset.hda in this parm and in the File Dependencies folder.

You should also add this path to File Dependencies if it should be copied to the working directory before the HDA Processor executes.

Operator Type

The operator type to select from within the digital asset. If no operator type is specified, HDA Processor will pick the first type it finds when cooking the asset.

Update HDA Parameters

When pressed, this button updates the HDA Parameters section

Filter HDA Parameters

Opens a dialog that can be used to configure which parameters from the asset should be promoted onto this node.

Auto Enabled HDA Parameter Expressions

When this parameter is enabled, empty expressions will automatically be set on the HDA Parameters

Work Items

Work Item Generation

Whether this node generates static or dynamic work items. You should generally leave this set to "Automatic" unless you know the node’s work items can be computed statically, or that they need to be generated dynamically.

Dynamic

This node always creates dynamic work items: it waits until the upstream work items are known, and generates new work items from the upstream work items.

Static

This node always creates static work items: it creates the number of work items it thinks it needs based on the parameters (and any upstream static items) before the network runs.

Automatic

If the input is static (a static processor, or a partitioner with only static inputs, or a mapper), this node generates static work items, otherwise it generates dynamic work items.

Cache Mode

How the processor node handles work items that report expected file results.

Automatic

If the expected result file exists on disk, the work item is marked as cooked without being scheduled. If the file does not exist, the item is scheduled as normal.

Read Files

If the expected result file exists on disk, the work item is marked as cooked without being scheduled. Otherwise the work item is marked as failed.

Write Files

Work items are always scheduled and the excepted result file is ignored, even if it exists on disk.

Iterations

The number of work items to create

Priority

When enabled, the priority of the work items created by this node. The default priority is 0.

Sequential

When this toggle is enabled, the work items generated by this node will be sequentially dependent on each other.

Asset Input

Create File SOP Inputs

When this parameter is enabled, one or more file SOPs will be instantiated and wired as inputs to the asset. This can be used to chain multiple HDA Processor nodes together more easily.

Number of Inputs

The number of input file SOPs to create. By default, the file SOP will use the nth input file to the work item.

Custom Input File #

By default, the input file that corresponds to this file’s number will be used as the input to the file SOP. This parameter can be enabled to provide a custom input file path.

Asset Output

Write Geometry

When this toggle is turned on, HDA Processor will output geometry to disk from the display node in the asset. If the asset contains a COP network or a ROP network, it may be useful to turn this off.

Output File Name

When writing geometry, this is the name of the output file.

Output Tag

When writing geometry, this is the tag assigned to the result file

Save Debug .hip File

When this toggle is enabled, a debug .hip file containing the instantiated asset, the file SOP and all parameter values will be written to disk. This is useful for tracking down problems with the asset. Be careful not to leave this on because it will significantly slow down execution.

HDA Parameters

This section of the node is filled in automatically based on the parm interface of the selected digital asset. Parameters set here will be copied to work item attributes and applied to the asset when its cooked.

Files

File Dependencies

A list of files that should be copied to the PDG working directory before the first work item in this node is executed. This can be used to ensure that supporting files like digital assets and custom scripts are available for the work item job.

The specified paths can be absolute or relative to HOUDINI_PATH.

Examples

example_top_hdaprocessor Example for HDA Processor TOP node

This example demonstrates how to use HDA Processor to distribute HDAs using PDG/TOPs.

The following examples include this node.

example_top_errorhandler Example for Error Handler TOP node

This example demonstrates how to use the Error Handler node in PDG / TOPs.

example_top_hdaprocessor Example for HDA Processor TOP node

This example demonstrates how to use HDA Processor to distribute HDAs using PDG/TOPs.

example_top_topfetch Example for TOP Fetch TOP node

This example demonstrates how to use Top Fetch to fetch results from other top networks.

example_top_topfetchinput Example for TOP Fetch Input TOP node

This example demonstrates how to use Top Fetch to fetch results from other top networks (using Top Fetch Input).

See also

TOP nodes