Creates a new simulation, which is not associated with a node. Use hou.DopNode.simulation to access a DOP network’s simulation.

Return the DOP data with the given name. Note that the name may also be a slash-separated path to nested subdata.

If the data path refers to a DOP object, this method returns a hou.DopObject instance. If it refers to a DOP relationship, it returns a hou.DopRelationship instance. Otherwise, it returns a hou.DopData instance.

Note this method implicitly uses the simulation data from the current frame.

See also hou.DopData.findSubData.

Given a pattern, return a tuple of DOP data whose names match the pattern. See also hou.DopSimulation.findData.

Return a tuple of all the DOP objects in the simulation.

You cannot index into this list using the object ID (see hou.DopObject.objid). To create a dictionary mapping object IDs to hou.DopObjects, do this:

id_dict = dict((obj.objid(), obj) for obj in simulation.objects())

Return the DOP object with the given name, or None if no object exists with that name. See also hou.DopSimulation.findData and hou.DopSimulation.objects.

Given a pattern, return a tuple of DOP objects whose names match the pattern.

>>> simulation = hou.node("/obj/AutoDopNetwork").simulation()
>>> [obj.name() for obj in simulation.findAllObjects("box_object?")]
['box_object1', 'box_object2']
>>> [obj.name() for obj in simulation.findAllObjects("o* b*")]
['obj1', 'obj2', 'box_object1', 'box_object2']

Return a tuple of hou.DopRelationship objects for all the DOP relationships in the simulation.

# The following example assumes you have created two box objects and made
# them rigid bodies.
>>> simulation = hou.node("/obj/AutoDopNetwork").simulation()
>>> relationship = simulation.relationships()[1]
>>> affecting_objects = [
...     simulation.objects()[record.field("objid")]
...     for record in relationship.records("ObjInAffectors")]
>>> [obj.name() for obj in affecting_objects]
['box_object1']
>>> affected_objects = [
...     simulation.objects()[record.field("objid")]
...     for record in relationship.records("ObjInGroup")]
>>> [obj.name() for obj in affected_objects]
['box_object2']

Find a DOP relationship by name. Return None if no such relationship with that name exists. See also hou.DopSimulation.relationships.

Return a tuple of hou.DopRelationship objects whose names match a pattern. See also hou.DopSimulation.relationships and hou.DopSimulation.findRelationship.

Return the DOP network node containing this simulation.

Return the simulation’s current time. This value is often the same as hou.time(), unless it is called from a Python solver DOP or the Time Scale or Offset Time parameters of the DOP network have been changed from their default values.

Sets the simulation’s current time.

Raises hou.PermissionError if the simulation cannot be modified. If the simulation is owned by a DOP network, the simulation time should be changed through the playbar.

Returns the length of a simulation timestep.

Sets the length of a simulation timestep.

Raises hou.PermissionError if the simulation cannot be modified. If the simulation is owned by a DOP network, the timestep should be set through the node’s parameters.

Return the simulation’s total memory usage.

Create and return a new DOP object, or return None if the object was not created successfully.

Raises hou.PermissionError if the simulation cannot be modified (e.g. called from outside a Python DOP).

Use hou.DopData.copyContentsFrom to clone data from an existing object.

Remove the given DOP object from the simulation.

Raises hou.PermissionError if the simulation cannot be modified (e.g. called from outside a Python DOP).

Create and return a new DOP relationship, or return None if the relationship was not created successfully.

Raises hou.PermissionError if the simulation cannot be modified (e.g. called from outside a Python DOP).

Use hou.DopData.copyContentsFrom to clone data from an existing relationship, and use hou.DopRelationship.setGroup and hou.DopRelationship.setAffectorGroup to update the “ObjInGroup” and “ObjInAffectors” records.

Remove the given DOP relationship from the simulation.

Raises hou.PermissionError if the simulation cannot be modified (e.g. called from outside a Python DOP).