Houdini 20.5 Nodes Geometry nodes

APEX Invoke Graph geometry node

Invokes an APEX graph with the connected inputs, and fetches the results.

On this page
Since 20.0
This feature is still under development. The current functionality is unfinished and subject to change, and may have thin or no documentation. Please bear this in mind when using it.

This node invokes an APEX graph with the connected inputs, and fetches the results. For more information on creating and running APEX graphs, see APEX graph basics and graphs for numerical operations.

Parameters

Input Bindings

Dictionary To Bind

When turned on, sets the input graph parameters from the specified dictionary attribute connected to the Graph Inputs.

Bind To Geometry Parameter

When turned on, sets the specified geometry parameter on the graph from the geometry connected to the Graph Inputs.

Bind Named Primitives as Inputs

When turned on, attempts to set the geometry parameters on the graph from packed primitives on the geometry connected to the Graph Inputs, matching parameter names to the s@name primitive attribute.

Apply Transforms

When turned on, applies packed primitive transforms when Bind Named Primitives as Inputs is on.

Output Bindings
Output Dictionary Bindings

Apex Outputs Group

The name of an output node in the APEX Graph input. All of the output ports on that node are included in the dictionary written to the output geometry.

Output Attrib

The name of the dictionary attribute to create on the output geometry.

Bind Output Geometry

When turned on, copies the geometry on the specified output port to this node’s output.

Geometry Output Type

APEX Output

Fetches the geometry specified in Bind Output Geometry from the graph’s evaluation.

Debug Graph

Writes out a copy of the graph including various attributes containing information from the graph’s compilation and evaluation. When Debug Evaluation is turned on, a dictionary point attribute named output is created containing per-node output data.

Debug Evaluation

When turned on, and the Geometry Output Type is set to Debug Graph, writes per-node output data to this node’s output geometry.

Force Reload Graph

When turned on, reloads and recompiles the graph from the APEX Graph input.

Note

This option is useful for debugging, but should not be used in production scenes, as performance will be severely impacted.

Enable Partial Evaluation

When turned on, provides partial evaluation optimizations on the graph by only executing the portions of the graph that:

  • Depend on input parameters that have changed.

    and

  • Contribute to the outputs requested by this node.

When turned off, the evaluation assumes that all input parameters have changed, and does not check the propogation of all the individual parameters through the graph. In some cases, this can actually lead to a performance improvement, especially when there are a large number of animated input parameters, as APEX will skip checking the propagation of the large number of changed graph inputs.

Note

If there are multiple parameters in a dictionary (multiple entries in an Attribute Adjust Dictionary SOP) that is connected to this node, but only one of the parameters is changed, APEX still executes the portions of the graph that are connected to all the parameters in the dictionary. To avoid this, create separate Attribute Adjust Dictionary SOPs for different sets of parameters to isolate the graph evaluation to specific groups of parameters.

Error Handling

Sets the runtime error handling during graph evaluation.

Ignore

Silently continues graph evaluation when a runtime error is encountered.

Report As Warnings

Adds a warning to the APEX Invoke Graph SOP when a runtime error is encountered, but continues evaluation.

Abort

Adds an error to the APEX Invoke Graph SOP and halts evaluation of the graph.

Inputs

APEX Graph

The APEX graph to invoke with the Graph Inputs.

Graph Inputs

The source data for setting the graph input parameters.

Outputs

Output

The result of the graph invocation. These are the results fetched from the graph, specified in Output Dictionary Bindings and Bind Output Geometry.

See also

Geometry nodes