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.

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 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 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 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 called from outside a Python DOP.