Houdini 20.5 Nodes APEX nodes

sim::CreateSubData

Attaches data to a simulation object or relationship.

On this page
Since 20.0

The engine ports of this node are in-place ports. This means that the simulation engine is updated without creating a copy.

Inputs

*engine: ApexSimEngine Required

The simulation engine to modify.

rootdata: ApexSimRootDataId

The unique ID of the object or relationship to attach data to.

dataname: String

The name of the new data. This may contain slashes to create nested subdata, for example, Forces/Gravity.

datatype: String

The name of the data type to create, for example, SIM_ForceGravity. If this value is empty, SIM_EmptyData is used to create an empty data record.

Tip

In a DOP network, you can use the geometry spreadsheet to inspect the datatype property of any data in the simulation.

avoidnamecollisions: Bool

If set to True, and data with the specified name already exists, a unique name is automatically created.

replaceexistingdata: Bool

If set to True, and data with the specified name already exists, the existing data is replaced, and any options that are not in the parms dictionary are reset to their default values.

parms: Dict

A dictionary containing key-value pairs to assign to the data’s Options record.

Outputs

*engine: ApexSimEngine

The modified simulation engine.

See also

APEX nodes