simetrix.GraphObject¶

class simetrix.GraphObject¶

Bases: object

Base class for objects contained within a Graph. See simetrix.GraphObjectType for the range of GraphObjects types.

All Graph objects have a unique integer id for the program running time and this is used to reference the object within SIMetrix. The id is not required to use any of the native Python classes and methods but may be required if interfacing using direct calls to SIMetrix script language functions.

All Graph objects have a range of properties that describe their function. Unlike schematic properties, the property names and their function is built into the system and user defined properties are not available. For full details refer to Graph Objects in the SIMetrix Script Reference Manual.

Methods

`prop`(propertyName)	Returns the property with the name given.
`properties`()	Returns the set of properties for this object.
`setPropertyValue`(propertyName, propertyValue)	Sets a property value for an object.

Attributes

`id`	Returns the ID of the object.
`type`	Returns the object type.
`valid`	Returns True if the GraphObject is valid.

property id: int¶: Returns the ID of the object. This can be used to pass to a native SIMetrix script function.

prop(propertyName: str) → GraphProperty¶

Returns the property with the name given. Can also use property().

Some properties have a symbolic value denoted by enclosing the value with ‘%’ characters. The property method will return the resolved value instead of the symbolic value if the name is prefixed with the ‘@’ character. For example:

print(curve.prop('@Label').Value)

The Label property usually has the value %DefaultLabel% which is what would be returned by the method if the ‘@’ character were omitted. The resolved value is the value of the DefaultLabel property.

properties() → list[GraphProperty]¶

Returns the set of properties for this object.

Example

Print the name and data type for all properties belonging to the current graph.

import simetrix as sx

graph = sx.currentGraph()

props= graph.properties()

for p in props :
    print(p.name, p.type)

setPropertyValue(propertyName: str, propertyValue: str | float)¶

Sets a property value for an object.

As explained in GraphProperty GraphProperty obejcts can have one of five data types. However, writeable properties can only be scalar string or scalar real valued. Hence this method can only accept real or string data for the property value.

Example

import simetrix as sx

# Get the current graph
graph = sx.currentGraph()

# Get the first curve available
curve = graph.curves()[0]

# Change the curve colour to green
curve.setPropertyValue('RGBColour', 32768)

property type: GraphObjectType¶: Returns the object type.

property valid: bool¶

Returns True if the GraphObject is valid.

A GraphObject obtained from the GraphProperty of another GraphObject will not necessarily be valid. The following example obtains the MainCursor property of the current graph. This will be an invalid object if cursors are not enabled.

import simetrix as sx

graph = sx.currentGraph()

mainCursor = graph.prop('MainCursor')

if mainCursor.value.valid :
    print("Cursors are enabled")
else :
    print("Cursors are not enabled")