Houdini 20.5 Nodes Dynamics nodes

Group Relationship dynamics node

On this page

The Group Relationship DOP is used to create a simple object group. In a relationship of this type, only the affected objects matter. The contents of the affector object list is ignored. Relationships of this type do not affect the solve order of the simulation objects even if the affector object list is not empty.

Object groups can also be created by the Group DOP, which also creates relationships like this node. It just provides a different interface. This node used in conjunction with an Apply Relationship DOP can provide a more powerful way of creating groups than the Group DOP.

Parameters

Data Sharing

Controls the way in which the data created by this node is shared among multiple objects in the simulation.

Data sharing can greatly reduce the memory footprint of a simulation, but at the expense of requiring all objects to have exactly the same data associated with them.

Do Not Share Data

No data sharing is used. Each object has its own copy of the data attached.

This is appropriate for situations where the data needs to be customized on a per-object basis, such as setting up initial positions and velocities for objects.

Share Data Across All Time

This node only creates a single piece of data for the whole simulation. This data is created the first time it is needed, so any expressions will be evaluated only for the first object.

All subsequent objects will have the data attached with the same values that were calculated from the expressions for the first object. It is important to note that expressions are not stored with the data, so they cannot be evaluated after the data is created.

Expressions are evaluated by the DOP node before creating the data. Expressions involving time will also only be evaluated when this single piece of data is created. This option is appropriate for data that does not change over time, and is the same for all objects, such as a Gravity DOP.

Share Data In One Timestep

A new piece of data is created for each timestep in the simulation. Within a timestep though, all objects have the same data attached to them. So expressions involving time will cause this data to animate over time, but expressions involving the object will only evaluate for the first object to which the data is attached.

This option is appropriate for data that changes over time, but is the same for all objects such as a Fan Force DOP, where the fan may move or rotate over time.

Activation

Determines if this node should do anything on a given timestep and for a particular relationship. If this parameter is an expression, it is evaluated for each relationship.

If it evaluates to a non-zero value, then the data is attached to that relationship. If it evaluates to zero, no data is attached, and data previously attached by this node is removed.

Group

When used in conjunction with an Apply Relationship node, this parameter is used to determine which relationships are acceptable to this node.

If the relationship is not recognized as part of this group, this data will not be attached to the relationship.

Data Name

Indicates the name that should be used to attach the data to the relationship.

Unlike the case of attaching data to simulation objects or other data, the Data Name here is not very important because a relationship can only have a single piece of data attached to it at a time. This Data Name can thus be used simply to help identify the purpose of the relationship.

Affected Objects

If objects are connected to the first input of this node, this parameter specified the set of input objects that will be the affected objects in the relationship.

If used in conjunction with an Apply Relationship node, this parameter is not used because that node defines the actual relationship.

Affector Objects

If objects are connected to the first input of this node, this parameter specified the set of input objects that will be the affector objects in the relationship.

Relationship Name

If objects are connected to the first input of this node, this parameter specifies the name of the relationship. If this parameter value matches the name of an existing relationship, that relationship will be replaced.

Unique Relationship Name

If objects are connected to the first input of this node, this parameter can be turned on to ensure that a unique relationship name is generated by this node.

This ensures that no existing relationship will be overwritten by the one defined by this node.

Make All Objects Mutual Affectors

If objects are connected to the first input of this node, turning this parameter on causes the union of the affector and affected object parameters to be placed into both the affector and affected object lists for the relationship.

This is often used as a shortcut to specifying the same list of objects in both the Affector and Affected Objects parameters.

Inputs

First Input

This optional input can be used to control which simulation objects may be involved in the relationship created by this node.

If this input is not connected, this node can be used in conjunction with an Apply Relationship node to create many relationships at the same time.

All Other Inputs

If this node has more input connectors, data nodes can be attached to act as modifiers for the relationship described by this node.

The specific types of subdata that are meaningful vary from node to node. Click an input connector to see a list of available data nodes that can be meaningfully attached.

Outputs

First Output

The operation of this output depends on what inputs are connected to this node.

If an object stream is input to this node, the output is also an object stream containing the same objects as the input (but with the additional relationship created by this node).

If no object stream is connected to this node, the output is a relationship data output. This data output can be connected to an Apply Relationship node to create many relationships at once.

Locals

ST

The simulation time for which the node is being evaluated.

Depending on the settings of the DOP Network Offset Time and Scale Time parameters, this value may not be equal to the current Houdini time represented by the variable T.

ST is guaranteed to have a value of zero at the start of a simulation, so when testing for the first timestep of a simulation, it is best to use a test like $ST == 0, rather than $T == 0 or $FF == 1.

SF

The simulation frame (or more accurately, the simulation time step number) for which the node is being evaluated.

Depending on the settings of the DOP Network parameters, this value may not be equal to the current Houdini frame number represented by the variable F. Instead, it is equal to the simulation time (ST) divided by the simulation timestep size (TIMESTEP).

TIMESTEP

The size of a simulation timestep. This value is useful for scaling values that are expressed in units per second, but are applied on each timestep.

SFPS

The inverse of the TIMESTEP value. It is the number of timesteps per second of simulation time.

SNOBJ

The number of objects in the simulation. For nodes that create objects such as the Empty Object DOP, SNOBJ increases for each object that is evaluated.

A good way to guarantee unique object names is to use an expression like object_$SNOBJ.

NOBJ

The number of objects that are evaluated by the current node during this timestep. This value is often different from SNOBJ, as many nodes do not process all the objects in a simulation.

NOBJ may return 0 if the node does not process each object sequentially (such as the Group DOP).

OBJ

The index of the specific object being processed by the node. This value always runs from zero to NOBJ-1 in a given timestep. It does not identify the current object within the simulation like OBJID or OBJNAME; it only identifies the object’s position in the current order of processing.

This value is useful for generating a random number for each object, or simply splitting the objects into two or more groups to be processed in different ways. This value is -1 if the node does not process objects sequentially (such as the Group DOP).

OBJID

The unique identifier for the object being processed. Every object is assigned an integer value that is unique among all objects in the simulation for all time. Even if an object is deleted, its identifier is never reused. This is very useful in situations where each object needs to be treated differently, for example, to produce a unique random number for each object.

This value is also the best way to look up information on an object using the dopfield expression function.

OBJID is -1 if the node does not process objects sequentially (such as the Group DOP).

ALLOBJIDS

This string contains a space-separated list of the unique object identifiers for every object being processed by the current node.

ALLOBJNAMES

This string contains a space-separated list of the names of every object being processed by the current node.

OBJCT

The simulation time (see variable ST) at which the current object was created.

To check if an object was created on the current timestep, the expression $ST == $OBJCT should always be used.

This value is zero if the node does not process objects sequentially (such as the Group DOP).

OBJCF

The simulation frame (see variable SF) at which the current object was created. It is equivalent to using the dopsttoframe expression on the OBJCT variable.

This value is zero if the node does not process objects sequentially (such as the Group DOP).

OBJNAME

A string value containing the name of the object being processed.

Object names are not guaranteed to be unique within a simulation. However, if you name your objects carefully so that they are unique, the object name can be a much easier way to identify an object than the unique object identifier, OBJID.

The object name can also be used to treat a number of similar objects (with the same name) as a virtual group. If there are 20 objects named “myobject”, specifying strcmp($OBJNAME, "myobject") == 0 in the activation field of a DOP will cause that DOP to operate on only those 20 objects.

This value is the empty string if the node does not process objects sequentially (such as the Group DOP).

DOPNET

A string value containing the full path of the current DOP network. This value is most useful in DOP subnet digital assets where you want to know the path to the DOP network that contains the node.

Note

Most dynamics nodes have local variables with the same names as the node’s parameters. For example, in a Position DOP, you could write the expression:

$tx + 0.1

…to make the object move 0.1 units along the X axis at each timestep.

Dynamics nodes