Next: Physical Subcircuits
Up: Extraction Functions
Previous: Physical Conductor Groups
Contents
Index
- (device_handle) ListPhysDevs(name, pref, index,
l, b, r, t)
This function returns a handle to a list of devices extracted from the
physical part of the current cell. The first two arguments are
strings which match the Name and Prefix fields from the
technology file Device block of the device to extract. Either or both
of these arguments can be null or empty, in which case no devices are
excluded by the comparison. The third argument is the device index,
which can be used to select a particular device. If this value is -1,
any device index will be matched. The remaining four arguments set
the corners, in microns, of the rectangular area in the cell to
search. If all four values are zero, the entire cell is searched. On
success, a handle is returned, otherwise 0 is returned. The handle
can be used in the functions that take a device handle as an argument.
This is not an object handle. The returned device handle can be
manipulated with the generic handle functions, and like other handles
should be iterated through or explicitly closed when no longer needed.
- (string) GetPdevName(device_handle)
This function returns a string containing the name of the device
referenced by the handle. The name string is composed of the Name field for the device (from the Device Block), followed by
an underscore, followed by the device index number. If the handle is
defunct or some other error occurs, a null string is returned.
- (int) GetPdevIndex(device_handle)
This function returns the index of the device referenced by the handle
passed as an argument. The index is an integer which is unique among
the devices of a given type. If the handle is defunct or an error
occurs, -1 is returned.
- (object_handle) GetPdevDual(device_handle)
This function returns an object handle which references the dual
device in the electrical database to the physical device referenced by
the argument. If association failed for the device, 0 is returned.
The dual device is a subcell obtained from the device library.
- (int) GetPdevBB(device_handle, array)
This function obtains the bounding box of the device referenced by the
first argument. The coordinates, in microns using the origin of the
current physical cell, are returned in the array, which must
have size 4 or larger. If the function succeeds, 1 is returned,
otherwise the returned value is 0. The saved order is L, B, R, T.
- (real) GetPdevMeasure(device_handle, mname)
This function returns a device parameter corresponding to a Measure line given in the Device block for the device referenced by
the first argument. The second argument is a string giving the name
from a Measure line. The returned value is the measured
parameter, or 0 if there was an error.
- (stringlist_handle) ListPdevMeasures(device_handle)
This function returns a string list handle corresponding to a list of
the names associated with Measure lines in the Device block for
the device referenced by the handle. These are the names that can be
passed to GetPdevMeasure to perform the measurement. If an error
occurs, 0 is returned.
- (dev_contact_handle) ListPdevContacts(device_handle)
This function returns a handle to a list of contact descriptors for
the device referenced by the argument. The returned handle can be
passed to the functions below to obtain information about the device
contacts. If there is an error, 0 is returned. The returned handle
can be manipulated with the generic handle functions, and like other
handles should be iterated through or closed explicitly when no longer
needed.
- (string) GetPdevContactName(dev_contact_handle)
This function returns the name string of the contact referenced by the
argument. Contact names are assigned in the Device block for the
device containing the contact. If an error occurs, a null string is
returned.
- (int) GetPdevContactBB(dev_contact_handle, array)
This function returns the bounding box of the contact referenced by
the first argument. The coordinates, in microns relative to the
origin of the physical current cell, are returned in the array,
which must have size 4 or larger. If the operation is successful, 1
is returned, otherwise 0 is returned.
- (int) GetPdevContactGroup(dev_contact_handle)
This function returns the conductor group index to which the contact
referenced by the argument is assigned. If there is an error, -1 is
returned.
- (string) GetPdevContactLayer(dev_contact_handle)
This function returns the name string of the layer to which the
contact referenced by the argument is assigned. All contacts are
assigned to layers which have the Conductor attribute. If there
is an error, a null string is returned.
- (device_handle) GetPdevContactDev(dev_contact_handle)
This function returns a handle to the device containing the contact
referenced by the argument. If an error occurs, 0 is returned. The
returned handle should be closed (for example, with the Close
function) when no longer needed.
- (string) GetPdevContactDevName(dev_contact_handle)
This function returns the name of the device containing the contact
referenced by the argument. A null string is returned on error.
- (int) GetPdevContactDevIndex(dev_contact_handle)
This returns the index number of the device to which the contact,
referenced by the passed handle, is associated. Each device of a
given type has an index number assigned, which is unique in the
containing cell. On error, -1 is returned. A valid index is 0 or
larger.
Next: Physical Subcircuits
Up: Extraction Functions
Previous: Physical Conductor Groups
Contents
Index
Stephen R. Whiteley
2006-10-23