Package Overview
The Ets_Topo package provides an API for accessing the objects in a model or the objects related somehow to another object. Currently, this package only supports accessing the objects in a network model and accessing the sub-objects of a compound object.
The top object of a network model is a special subnet object that has no parent and cannot be removed. For all other objects in a network, the parent object is the subnet into which the object was installed. Subnets are the only network objects that have children. All types of links in a network model, except buses, connect one network object (node, subnet, or bus) to another. The type of link determines whether the connection is directed in one way or in both ways and what types of objects are allowable at the ends. The Ets_Topo API has functions to discover these various relationships.
One type of attribute supported by the Ets_Obj API is the compound object attribute. The value of this attribute type is a compound object, which is essentially an array of homogenous generic objects. The child functions in the Ets_Topo API can be used to access these generic objects, after which the attribute functions of the Ets_Obj API can be used to access the attributes of each generic object. In general, the parent function in the Ets_Topo API cannot be used to retrieve the containing compound object from a generic object. However, as a special case, it will work for the generic objects passed as the “copy” object to active attribute callback functions. None of the association or connection functions in the Ets_Topo API work for compound or generic objects.