OriginPro
 
Loading...
Searching...
No Matches
originpro.base.BaseObject Class Reference
Inheritance diagram for originpro.base.BaseObject:
originpro.base.BaseLayer originpro.base.BasePage originpro.base.GObject originpro.graph.Plot originpro.notes.Notes originpro.pe.Folder originpro.base.DSheet originpro.graph.GLayer originpro.base.DBook originpro.graph.GPage originpro.image.IPage originpro.base.Label originpro.base.Line originpro.matrix.MSheet originpro.worksheet.WSheet originpro.matrix.MBook originpro.worksheet.WBook

Public Member Functions

 __init__ (self, obj)
 
 __del__ (self)
 
 __str__ (self)
 
 __bool__ (self)
 
 index (self)
 
 get_str (self, prop)
 
 get_int (self, prop)
 
 get_float (self, prop)
 
 set_str (self, prop, value)
 
 set_int (self, prop, value)
 
 set_float (self, prop, value)
 
 method_int (self, name, arg='')
 
 method_float (self, name, arg='')
 
 method_str (self, name, arg='')
 
 lt_exec (self, labtalk)
 
 name (self)
 
 name (self, value)
 
 lname (self)
 
 lname (self, value)
 
 comments (self)
 
 comments (self, value)
 
 show (self)
 
 show (self, value)
 
 usertree (self)
 
 usertree (self, tr)
 
 userprops (self)
 

Public Attributes

 obj = obj
 

Detailed Description

base class for all Origin objects

Member Function Documentation

◆ comments() [1/2]

originpro.base.BaseObject.comments ( self)
Property getter returns long name of object.
Parameters:
    none
Returns:
    long name of object.
Examples:
    wb.comments='My labs data'
    print(wb.comments)

◆ comments() [2/2]

originpro.base.BaseObject.comments ( self,
value )
Property setter sets the comments of an object.
Parameters:
    value(string):content of comments
Returns:
    none
Examples:
    wb.comments='My labs data'
    print(wb.comments)

◆ get_float()

originpro.base.BaseObject.get_float ( self,
prop )
Get object's LabTalk float property
Parameters:
    prop(string): float prop like symbol.size, details on Origin objects' reference pages
Returns:
    object's float property
Examples:
    p=op.find_graph()[0].plot_list()[0]
    print(p.get_float('symbol.size'))

◆ get_int()

originpro.base.BaseObject.get_int ( self,
prop )
Get object's LabTalk int property
Parameters:
    prop(string):int prop line
    [cmap.stretchpal, cmap.linkpal symbol.kind], details on Origin objects' reference pages
Returns:
    object's int property
Examples:
    wks1 = op.new_sheet()
    print(wks1.get_int('nrows'))

◆ get_str()

originpro.base.BaseObject.get_str ( self,
prop )
Get object's LabTalk string property
Parameters:
    prop(string): string prop like
    [cmap.palette, colorlist,  name], details on Origin objects' reference pages
Returns:
    object's string property
Examples:
    wks1 = op.new_sheet()
    print(wks1.get_str('name'))

◆ index()

originpro.base.BaseObject.index ( self)
interal index in corresponding collection of the object
Parameters:
    none
Returns:
    interal index
Examples:
    wks1 = op.new_sheet()
    print(wks1.index())

◆ lname() [1/2]

originpro.base.BaseObject.lname ( self)
Property getter returns long name of object.

Parameters:

Returns:
    (str)

Examples:
    print(wb.lname)

◆ lname() [2/2]

originpro.base.BaseObject.lname ( self,
value )
Property setter sets long name of object.

Parameters:
    value (str): long name

Returns:
    None

Examples:
    wb.lname = 'My Data'

◆ lt_exec()

originpro.base.BaseObject.lt_exec ( self,
labtalk )
executes a LabTalk statement.

Parameters:
    labtalk (str): LabTalk statement

Returns:
    None

Examples:
    wb.lt_exec('page.longname$="lt_exec example"')
    wks.lt_exec(r'expASC path:="c:\test\signal.csv";') #you can execute X-Function here

◆ method_float()

originpro.base.BaseObject.method_float ( self,
name,
arg = '' )
execute object's LabTalk method that has a float return
Parameters:
    name(string):prop string, details on Origin objects' reference pages
    arg:property value
Returns:
    (float)LabTalk method's return value
Examples:
    wks1 = op.new_sheet()
    rowid=wks1.method_float('UserParam', '++test') #add user parameter row "test", and return its index on worksheet

◆ method_int()

originpro.base.BaseObject.method_int ( self,
name,
arg = '' )
execute object's LabTalk method that has an int return
Parameters:
    name(string):prop string, details on Origin objects' reference pages
    arg:property value
Returns:
    (int)LabTalk method's return value
Examples:
    wks1 = op.find_sheet()
    issel = wks1.method_int('isColSel', '3') #return if 3rd col is selected

◆ method_str()

originpro.base.BaseObject.method_str ( self,
name,
arg = '' )
execute object's LabTalk method that has a string return
Parameters:
    name(string):prop string, details on Origin objects' reference pages
    arg:property value
Returns:
    (string)LabTalk method's return value
Examples:
    wks = op.new_sheet()
    row, col = 1,1
    wks.set_cell_note(row,col,'test Note')
    cnote = wks.method_str('GetNote',f'{row+1},{col+1}')

◆ name() [1/2]

originpro.base.BaseObject.name ( self)
short name of the object
Parameters:
    none
Returns:
    Origin object name
Examples:
    gl=op.find_graph()[0]
    print(gl.name)

◆ name() [2/2]

originpro.base.BaseObject.name ( self,
value )
change the short name of an object, if there is a conflict,
Origin will change to next available name automatically
Examples:
    gp=op.new_graph()
    gp.name='Test'
    gp=op.new_graph()
    gp.name='Test'
    print(gp)#Test1

◆ set_float()

originpro.base.BaseObject.set_float ( self,
prop,
value )
Set object's LabTalk float property
Parameters:
    prop(string):prop string, details on Origin objects' reference pages
    value:property value
Returns:
    none
Examples:
    p=op.find_graph()[0].plot_list()[0]
    p.set_float('symbol.size', 4.5)

◆ set_int()

originpro.base.BaseObject.set_int ( self,
prop,
value )
Set object's LabTalk int property
Parameters:
    prop(string):prop string, details on Origin objects' reference pages
    value:property value
Returns:
    none
Examples:
    wks1 = op.new_sheet()
    wks1.set_int('nrows', 10)

◆ set_str()

originpro.base.BaseObject.set_str ( self,
prop,
value )
Set object's LabTalk string property
Parameters:
    prop(string):can be int/float/string property, details on Origin objects' reference pages
    value:property value
Returns:
    none
Examples:
    wks1 = op.new_sheet()
    wks1.set_str('name','test_set_str')

◆ show() [1/2]

originpro.base.BaseObject.show ( self)
Property getter returns show state of object.

Parameters:

Returns:
    (bool)

Examples:
    print(wb.show)

◆ show() [2/2]

originpro.base.BaseObject.show ( self,
value )
Property setter sets show state of object.

Parameters:
    value (bool): True to show object

Returns:
    None

Examples:
    wb.show = True

◆ userprops()

originpro.base.BaseObject.userprops ( self)
Parameters:
    none
Returns:
    Return User Tree as dict
Examples:
    wks = op.new_sheet()
    wks.set_str('tree.data.name', 'Larry')
    wks.set_int('tree.data.age', 37)
    wks.set_float('tree.data.mean', 23.56)

    dd = wks.userprops['data']
    print(dd)

◆ usertree() [1/2]

originpro.base.BaseObject.usertree ( self)
    Return User Tree as ElementTree
Parameters:
    none
Returns:
    ElementTree
Examples:
    wks = op.new_sheet()
    wks.set_str('tree.data.name', 'Larry')
    wks.set_int('tree.data.age', 37)
    wks.set_float('tree.data.mean', 23.56)

    trWks = wks.usertree
    trData = trWks.find('data')
    for child in trData:
        print(f'{child.tag} = {child.text}')

◆ usertree() [2/2]

originpro.base.BaseObject.usertree ( self,
tr )
    Set User Tree

Parameters:
    tr (ElementTree): tree to set
Returns:
    none
Examples:
    import xml.etree.ElementTree as ET
    wks = op.new_sheet()
    tr = wks.usertree
    data = ET.SubElement(tr, 'data')
    version = ET.SubElement(data, 'Version')
    version.set('Label', 'Origin Version')
    version.text = '9.8b'
    wks.usertree = tr

The documentation for this class was generated from the following file: