Source code for pykst

 import sys
-import math
-import ctypes
+#import math
+#import ctypes
 import atexit
 import os
-
+import tempfile
+import time
+import subprocess
+import getpass
 from ast import literal_eval
 
+import numpy as np
+
 try:
-  from PySide import QtCore, QtNetwork, QtGui
+    from PySide import QtNetwork, QtGui
 except ImportError as err1:
-  try:
-    from PyQt4 import QtCore, QtNetwork, QtGui
-  except ImportError as err2:
-    print("ImportError: {} and {}. One of the two is required.".format(err1, err2))
-    sys.exit()
+    try:
+        from PyQt4 import QtNetwork, QtGui
+    except ImportError as err2:
+        print "ImportError: {} and {}. One of the two is required.".format(err1, err2)
+        sys.exit()
 
 QtGui.QApplication([""])
 
-from numpy import *
-import tempfile
-import time
-import subprocess
 
-def cleanTmpFile(file):
-	os.remove(file.name)
+def clean_tmp_file(tmp_file):
+    os.remove(tmp_file.name)
 
 def b2str(val):
-  if isinstance(val, bool):
-    return "True" if val else "False"
-  else:
+    if isinstance(val, bool):
+        return "True" if val else "False"
     return str(val)
 
 
-[docs]class Client:
-  """ An interface to a running kst session. 
+[docs]class Client(object):
+    """ An interface to a running kst session.
 
-  A client provides a connection to a running kst session.
-  The constructor creates a connection to either a running
-  kst session with name <server_name>, or if none exists, a new one.
-  If server_name is not specified, it creates a connection to either the
-  kst session with the name ``kstScript``, or if none exists, a new one.
-
-  The Client provides functions which effect the entire kst session,
-  provides convenience functions to create objects within kst (eg,
-  ``client.new_generated_vector(0, 1, 6)``), and provides
-  convenience functions to access objects already within kst (eg,
-  ``client.vector("V2")``.  This is the suggested method.
+    A client provides a connection to a running kst session.
+    The constructor creates a connection to either a running
+    kst session with name <server_name>, or if none exists, a new one.
+    If server_name is not specified, it creates a connection with an
+    unnamed kst session, or if none exists, a new unnamed session.
+
+    The Client provides functions which effect the entire kst session,
+    provides convenience functions to create objects within kst (eg,
+    ``client.new_generated_vector(0, 1, 6)``), and provides
+    convenience functions to access objects already within kst (eg,
+    ``client.vector("V2")``.  This is the suggested method.
 
-  Alternatively, the constructor for every class inside pykst accepts
-  an instance of Client which it uses to interact with a kst session.
+    Alternatively, the constructor for every class inside pykst accepts
+    an instance of Client which it uses to interact with a kst session.
 
-  To connect to a kst session named ``kstSession`` (starting kst if necessary)::
+    To connect to a kst session named ``kstSession`` (starting kst if necessary)::
 
-      import pykst as kst
-      client = kst.Client("kstSession")
+        import pykst as kst
+        client = kst.Client("kstSession")
 
-  """
-  
-  def __init__(self,server_name="kstScript"):
-    self.ls=QtNetwork.QLocalSocket()
-    self.ls.connectToServer(server_name)
-    self.ls.waitForConnected(300)
-    self.server_name=server_name
-
-    if self.ls.state() == QtNetwork.QLocalSocket.UnconnectedState:
-      subprocess.Popen(["kst2","--serverName="+str(server_name)])
-      time.sleep(.5)
-
-      while self.ls.state()==QtNetwork.QLocalSocket.UnconnectedState:
-        self.ls.connectToServer(server_name)
-        self.ls.waitForConnected(300)
-    
-  def send(self,command):
-    """ Sends a command to kst and returns a response. 
-    
-    You should never use 
-    this directly, as there is no guarantee that the internal command
-    list kst uses won't change. Instead use the convenience classes 
-    included with pykst. 
-    """
-    self.ls.write(command)
-    self.ls.flush()
-    self.ls.waitForReadyRead(300000)
-    x=self.ls.readAll()
-    return x
-    
-  def send_si(self, handle, command):
-    self.send(b2str("beginEdit("+handle+")"))
-    x = self.send(command)
-    self.send(b2str("endEdit()"))
-    return x
-
-  def testCommand(self):
-    self.send("testCommand()")
-
-[docs]  def clear(self):
-    """ Clears all objects from kst.
-    
-    Equivalent to file->close from the menubar inside kst.  
     """
-    self.send("clear()")
-    
-[docs]  def open_kst_file(self, filename):
-    """ open a .kst file in kst. """
-    self.send("fileOpen("+b2str(filename)+")")
 
-[docs]  def save_kst_file(self, filename):
-    """ save a .kst file in kst. """
-    self.send("fileSave("+b2str(filename)+")")
+    def __init__(self, server_name=""):
 
-[docs]  def export_graphics_file(self, filename, format=None, width=1280, height=1024, display = 2, all_tabs = False, autosave_period = 0):
-      """
-      export the kst session as a set of graphics files.
+        user_name = getpass.getuser()
 
-      :param filename: the name of the file to be saved
-      :param format: the format to be used.  if None, the format is determined from the filename extension.
-      :param width: width of the plot, in pixels, if required by the display setting.
-      :param height: the height of the plot, in pixels, if required by the display setting.
-      :param display: how the dimensions are interpreted.
-      :param all_tabs: if True, all tabs are exported as <filename>_<tabname>.<ext>
-      :param autosave_period: save the image every <autosave_period> seconds.  If 0, only save once.
+        if server_name:
+            self.server_name = server_name + "--" + user_name
+        else:
+            self.server_name = user_name
+
+        self.local_socket = QtNetwork.QLocalSocket()
+        self.local_socket.connectToServer(self.server_name)
+        self.local_socket.waitForConnected(300)
+
+        if self.local_socket.state() == QtNetwork.QLocalSocket.UnconnectedState:
+            subprocess.Popen(["kst2", "--serverName="+str(self.server_name)])
+            time.sleep(.5)
+
+            while self.local_socket.state() == QtNetwork.QLocalSocket.UnconnectedState:
+                self.local_socket.connectToServer(self.server_name)
+                self.local_socket.waitForConnected(300)
+
+    def send(self, command):
+        """ Sends a command to kst and returns a response.
+
+        You should never use
+        this directly, as there is no guarantee that the internal command
+        list kst uses won't change. Instead use the convenience classes
+        included with pykst.
+        """
+        self.local_socket.write(command)
+        self.local_socket.flush()
+        self.local_socket.waitForReadyRead(300000)
+        return_message = self.local_socket.readAll()
+        return return_message
+
+    def send_si(self, handle, command):
+        self.send(b2str("beginEdit("+handle+")"))
+        return_message = self.send(command)
+        self.send(b2str("endEdit()"))
+        return return_message
 
-      *display* determines the shape of the plot.  Values are ::
+    def test_command(self):
+        self.send("testCommand()")
 
-          0   Width set by user, maintain aspect ratio
-          1   Height set by user, maintain aspect ratio
-          2   Width and Height set by user.
-          3   a Width x Width square plot.
+[docs]    def clear(self):
+        """ Clears all objects from kst.
 
-      """
+        Equivalent to file->close from the menubar inside kst.
+        """
+        self.send("clear()")
 
-      if format is None:
-          format = os.path.splitext(filename)[1][1:].strip().lower()
+[docs]    def open_kst_file(self, filename):
+        """ open a .kst file in kst. """
+        self.send("fileOpen("+b2str(filename)+")")
 
-      self.send("exportGraphics("+str(filename)+","+str(format)+","+str(width)+","+
-                str(height)+","+str(display)+","+str(all_tabs)+","+str(autosave_period) + ")")
+[docs]    def save_kst_file(self, filename):
+        """ save a .kst file in kst. """
+        self.send("fileSave("+b2str(filename)+")")
 
+[docs]    def export_graphics_file(self, filename, graphics_format=None, width=1280, height=1024,
+                             display=2, all_tabs=False, autosave_period=0):
+        """
+        export the kst session as a set of graphics files.
 
-[docs]  def screen_back(self):
-    """ Equivalent to "Range>Back One Screen" from the menubar inside kst. """
-    self.send("screenBack()")
-    
-[docs]  def screen_forward(self):
-    """ Equivalent to "Range>Forward One Screen" from the menubar inside kst. """
-    self.send("screenForward()")
-    
-[docs]  def count_from_end(self):
-    """ Equivalent to "Range>Count From End" from the menubar inside kst. """
-    self.send("countFromEnd()")
-    
-[docs]  def read_to_end(self):
-    """ Equivalent to "Range>Read To End" from the menubar inside kst. """
-    self.send("readToEnd()")
-    
-[docs]  def set_paused(self):
-    """ Equivalent to checking "Range>Pause" from the menubar inside kst."""
-    self.send("setPaused()")
-    
-[docs]  def unset_paused(self):
-    """ Equivalent to unchecking "Range>Pause" from the menubar inside kst."""
-    self.send("unsetPaused()")
+        :param filename: the name of the file to be saved
+        :param graphics_format: the format to be used.  if None, the format is determined from
+                                the filename extension.
+        :param width: width of the plot, in pixels, if required by the display setting.
+        :param height: the height of the plot, in pixels, if required by the display setting.
+        :param display: how the dimensions are interpreted.
+        :param all_tabs: if True, all tabs are exported as <filename>_<tabname>.<ext>
+        :param autosave_period: save the image every <autosave_period> seconds.
+                                If 0, only save once.
 
-[docs]  def hide_window(self):
-    """
-    Hide the kst window.
+        *display* determines the shape of the plot.  Values are ::
 
-    pyKst operations which effect the display are far faster when the window is hidden.
+            0   Width set by user, maintain aspect ratio
+            1   Height set by user, maintain aspect ratio
+            2   Width and Height set by user.
+            3   a Width x Width square plot.
 
-    Restore with show_window() or maximize_window()."""
+        """
 
-    self.send("hide()")
+        if graphics_format is None:
+            graphics_format = os.path.splitext(filename)[1][1:].strip().lower()
 
-[docs]  def quit(self):
-      """
-      Tell the kst window to terminate
+        self.send("exportGraphics("+str(filename)+","+str(graphics_format)+","+str(width)+","+
+                  str(height)+","+str(display)+","+str(all_tabs)+","+str(autosave_period) + ")")
 
-      After this, client will no longer be valid."""
 
-      self.send("quit()")
+[docs]    def screen_back(self):
+        """ Equivalent to "Range>Back One Screen" from the menubar inside kst. """
+        self.send("screenBack()")
 
-[docs]  def minimize_window(self):
-    """ Minimize the kst window. """
-    self.send("minimize()")
+[docs]    def screen_forward(self):
+        """ Equivalent to "Range>Forward One Screen" from the menubar inside kst. """
+        self.send("screenForward()")
 
-[docs]  def maximize_window(self):
-    """ Maximize the kst window. """
-    self.send("maximize()")
+[docs]    def count_from_end(self):
+        """ Equivalent to "Range>Count From End" from the menubar inside kst. """
+        self.send("countFromEnd()")
 
-[docs]  def show_window(self):
-    """ unminimize and show the kst window. """
-    self.send("show()")
+[docs]    def read_to_end(self):
+        """ Equivalent to "Range>Read To End" from the menubar inside kst. """
+        self.send("readToEnd()")
 
-[docs]  def tab_count(self):
-    """ Get the number of tabs open in the current document. """
-    return self.send("tabCount()")
-  
-[docs]  def new_tab(self):
-    """ Create a new tab in the current document and switch to it. """
-    return self.send("newTab()")
-  
-[docs]  def set_tab(self,tab):
-    """ Set the index of the current tab. 
-    
-    tab must be greater or equal to 0 and less than tabCount(). 
-    """
-    self.send("setTab("+b2str(tab)+")")
+[docs]    def set_paused(self):
+        """ Equivalent to checking "Range>Pause" from the menubar inside kst."""
+        self.send("setPaused()")
 
-[docs]  def set_tab_text(self,new_name):
-    """ Set the text of the current tab.
+[docs]    def unset_paused(self):
+        """ Equivalent to unchecking "Range>Pause" from the menubar inside kst."""
+        self.send("unsetPaused()")
 
-    """
-    self.send("renameTab("+new_name+")")
+[docs]    def hide_window(self):
+        """
+        Hide the kst window.
 
-[docs]  def cleanup_layout(self, columns="Auto"):
-    """ Cleanup layout in the current tab.
-    
-     If columns is not set, use auto-layout.
-     
-    """
-    self.send("cleanupLayout("+b2str(columns)+")")
-  
-[docs]  def get_scalar_list(self):
-    """ returns the scalar names from kst """
-    
-    x = self.send("getScalarList()")
-    name_list=x.data().split('|')
-    return [Scalar(self, name=n) for n in name_list]
+        pyKst operations which effect the display are far faster when the window is hidden.
 
-[docs]  def new_generated_string(self, string, name=""):
-    """ Create a new generated string in kst.
-    
-    See :class:`GeneratedString`
-    """
-    return GeneratedString(self, string, name)
+        Restore with show_window() or maximize_window()."""
 
-[docs]  def generated_string(self, name):
-    """ Returns a generated string from kst given its name.
-    
-    See :class:`GeneratedString`
-    """
-    return GeneratedString(self, "", name, new=False)
-  
-[docs]  def new_datasource_string(self, filename, field, name=""):
-    """ Create a New Data Source String in kst.
-    
-    See :class:`DataSourceString`
-    """
-    return DataSourceString(self, filename, field, name)
+        self.send("hide()")
 
-[docs]  def datasource_string(self, name):
-    """ Returns a datasource string from kst given its name.
-    
-    See :class:`DataSourceString`
-    """
-    return DataSourceString(self, "", "", name, new=False)
-  
-[docs]  def new_generated_scalar(self, value, name=""):
-    """ Create a New Generated Scalar in kst.
-    
-    See :class:`GeneratedScalar`
-    """
-    return GeneratedScalar(self, value, name)
+[docs]    def quit(self):
+        """
+        Tell the kst window to terminate
 
-[docs]  def generated_scalar(self, name):
-    """ Returns a Generated Scalar from kst given its name.
-    
-    See :class:`GeneratedScalar`
-    """
-    return GeneratedScalar(self, "", name, new=False)
+        After this, client will no longer be valid."""
 
-[docs]  def new_datasource_scalar(self, filename, field, name=""):
-    """ Create a New DataSource Scalar in kst.
-    
-    See :class:`DataSourceScalar`
-    """
-    return DataSourceScalar(self, filename, field, name)
+        self.send("quit()")
 
-[docs]  def datasource_scalar(self, name):
-    """ Returns a DataSource Scalar from kst given its name.
-    
-    See :class:`DataSourceScalar`
-    """
-    return DataSourceScalar(self, "", "", name, new=False)
+[docs]    def minimize_window(self):
+        """ Minimize the kst window. """
+        self.send("minimize()")
 
-[docs]  def new_vector_scalar(self, filename, field, frame=-1, name=""):
-    """ Create a New VectorScalar in kst.
-    
-    See :class:`VectorScalar`
-    """
-    return VectorScalar(self, filename, field, frame, name)
+[docs]    def maximize_window(self):
+        """ Maximize the kst window. """
+        self.send("maximize()")
 
-[docs]  def vector_scalar(self, name):
-    """ Returns a VectorScalar from kst given its name.
-    
-    See :class:`VectorScalar`
-    """
-    return VectorScalar(self, "", "", 0, name, new=False)
+[docs]    def show_window(self):
+        """ unminimize and show the kst window. """
+        self.send("show()")
 
-[docs]  def new_data_vector(self, filename, field, start=0, num_frames=-1,
-                 skip=0, boxcarFirst=False, name="") :
-    """ Create a New DataVector in kst.
-    
-    See :class:`DataVector`
-    """
-    return DataVector(self, filename, field, start, num_frames,
-                      skip, boxcarFirst, name)
-  
-[docs]  def data_vector(self, name):
-    """ Returns a DataVector from kst given its name.
-    
-    See :class:`DataVector`
-    """
-    return DataVector(self, "", "", name=name, new=False)
+[docs]    def tab_count(self):
+        """ Get the number of tabs open in the current document. """
+        return self.send("tabCount()")
 
-[docs]  def new_generated_vector(self, x0, x1, n, name=""):
-    """ Create a New GeneratedVector in kst.
-    
-    See :class:`GeneratedVector`
-    """
-    return GeneratedVector(self, x0, x1, n, name)
+[docs]    def new_tab(self):
+        """ Create a new tab in the current document and switch to it. """
+        return self.send("newTab()")
 
-[docs]  def generated_vector(self, name):
-    """ Returns a GeneratedVector from kst given its name.
-    
-    See :class:`GeneratedVector`
-    """
-    return GeneratedVector(self, 0, 0, 0, name, new=False)
-  
-[docs]  def new_editable_vector(self, np_array = None, name=""):
-    """ Create a New Editable Vector in kst.
-    
-    See :class:`EditableVector`
-    """
-    return EditableVector(self, np_array, name)
+[docs]    def set_tab(self, tab):
+        """ Set the index of the current tab.
 
-[docs]  def editable_vector(self, name):
-    """ Returns an Editable Vector from kst given its name.
-    
-    See :class:`EditableVector`
-    """
-    return EditableVector(self, None, name, new=False)
+        tab must be greater or equal to 0 and less than tabCount().
+        """
+        self.send("setTab("+b2str(tab)+")")
 
+[docs]    def set_tab_text(self, new_name):
+        """ Set the text of the current tab.
 
-[docs]  def get_vector_list(self):
-    """ returns vectors from kst. """
+        """
+        self.send("renameTab("+new_name+")")
 
-    x = self.send("getVectorList()")
-    name_list=x.data().split('|')
-    return [VectorBase(self, name=n) for n in name_list]
+[docs]    def cleanup_layout(self, columns="Auto"):
+        """ Cleanup layout in the current tab.
 
-[docs]  def get_data_vector_list(self):
-    """ returns data vectors from kst. """
+         If columns is not set, use auto-layout.
 
-    x = self.send("getDataVectorList()")
-    name_list=x.data().split('|')
-    return [DataVector(self, "", "", name=n, new=False) for n in name_list]
+        """
+        self.send("cleanupLayout("+b2str(columns)+")")
 
-[docs]  def get_generated_vector_list(self):
-    """ returns generated vectors from kst. """
+[docs]    def get_scalar_list(self):
+        """ returns the scalar names from kst """
 
-    x = self.send("getGeneratedVectorList()")
-    name_list=x.data().split('|')
-    return [GeneratedVector(self, name=n, new=False) for n in name_list]
+        return_message = self.send("getScalarList()")
+        name_list = return_message.data().split('|')
+        return [Scalar(self, name=n) for n in name_list]
 
-[docs]  def get_editable_vector_list(self):
-    """ returns editable vectors from kst. """
+[docs]    def new_generated_string(self, string, name=""):
+        """ Create a new generated string in kst.
 
-    x = self.send("getEditableVectorList()")
-    name_list=x.data().split('|')
-    return [EditableVector(self, name=n, new=False) for n in name_list]
+        See :class:`GeneratedString`
+        """
+        return GeneratedString(self, string, name)
 
-  
-[docs]  def new_data_matrix(self, filename, field, start_x=0, start_y=0, num_x=-1, num_y=-1, 
-                 min_x=0, min_y=0, dx=1, dy=1,name="") :
-    """ Create a New DataMatrix in kst.
-    
-    See :class:`DataMatrix`
-    """
-    return DataMatrix(self, filename, field, start_x, start_y, num_x, num_y, 
-                 min_x, min_y, dx, dy,name)
+[docs]    def generated_string(self, name):
+        """ Returns a generated string from kst given its name.
 
-[docs]  def data_matrix(self, name):
-    """ Returns a DataMatrix from kst given its name.
-    
-    See :class:`DataMatrix`
-    """
-    return DataMatrix(self, "", "", name=name, new=False)
+        See :class:`GeneratedString`
+        """
+        return GeneratedString(self, "", name, new=False)
 
-[docs]  def new_editable_matrix(self, np_array = None, name=""):
-    """ Create a New Editable Matrix in kst.
-    
-    See :class:`EditableMatrix`
-    """
-    return EditableMatrix(self, np_array, name)
+[docs]    def new_datasource_string(self, filename, field, name=""):
+        """ Create a New Data Source String in kst.
 
-[docs]  def editable_matrix(self, name):
-    """ Returns an Editable Matrix from kst given its name.
-    
-    See :class:`EditableMatrix`
-    """
-    return EditableMatrix(self, None, name, new=False)
+        See :class:`DataSourceString`
+        """
+        return DataSourceString(self, filename, field, name)
 
-[docs]  def get_matrix_list(self):
-    """ returns matrixes from kst. """
+[docs]    def datasource_string(self, name):
+        """ Returns a datasource string from kst given its name.
 
-    x = self.send("getMatrixList()")
-    name_list=x.data().split('|')
-    return [Matrix(self, name=n) for n in name_list]
+        See :class:`DataSourceString`
+        """
+        return DataSourceString(self, "", "", name, new=False)
 
+[docs]    def new_generated_scalar(self, value, name=""):
+        """ Create a New Generated Scalar in kst.
 
-[docs]  def new_curve(self, x_vector, y_vector, name=""):
-    """ Create a New Curve in kst.
-    
-    See :class:`Curve`
-    """
-    return Curve(self, x_vector, y_vector, name)
+        See :class:`GeneratedScalar`
+        """
+        return GeneratedScalar(self, value, name)
 
-[docs]  def curve(self, name):
-    """ Returns a Curve from kst given its name.
-    
-    See :class:`Curve`
-    """
-    return Curve(self, "", "", name, new=False)
+[docs]    def generated_scalar(self, name):
+        """ Returns a Generated Scalar from kst given its name.
 
-[docs]  def new_image(self, matrix, name=""):
-    """ Create a new Image in kst.
-    
-    See :class:`Image`
-    """
-    return Image(self, matrix, name)
+        See :class:`GeneratedScalar`
+        """
+        return GeneratedScalar(self, "", name, new=False)
 
-[docs]  def image(self, name):
-    """ Returns an Image from kst given its name.
-    
-    See :class:`Image`
-    """
-    return Image(self, "", "", name, new=False)
+[docs]    def new_datasource_scalar(self, filename, field, name=""):
+        """ Create a New DataSource Scalar in kst.
 
-[docs]  def new_equation(self, x_vector, equation, interpolate=True, name=""):
-    """ Create a new Equation in kst.
-    
-    See :class:`Equation`
-    """
-    return Equation(self, x_vector, equation, interpolate, name)
+        See :class:`DataSourceScalar`
+        """
+        return DataSourceScalar(self, filename, field, name)
 
+[docs]    def datasource_scalar(self, name):
+        """ Returns a DataSource Scalar from kst given its name.
 
-[docs]  def equation(self, name):
-    """ Returns an Equation from kst given its name.
-    
-    See :class:`Equation`
-    """
-    return Equation(self, "", "", name, new=False)
+        See :class:`DataSourceScalar`
+        """
+        return DataSourceScalar(self, "", "", name, new=False)
 
-[docs]  def new_histogram(self, vector, bin_min=0, bin_max=1, num_bins=60, 
-                    normalization = 0, auto_bin = True,  name=""):
-    """ Create a new histogram in kst.
-    
-    See :class:`Histogram`
-    """
-    return Histogram(self, vector, bin_min, bin_max, num_bins, 
-                     normalization, auto_bin, name)
+[docs]    def new_vector_scalar(self, filename, field, frame=-1, name=""):
+        """ Create a New VectorScalar in kst.
 
+        See :class:`VectorScalar`
+        """
+        return VectorScalar(self, filename, field, frame, name)
 
-[docs]  def histogram(self, name):
-    """ Returns a histogram from kst given its name.
-    
-    See :class:`Histogram`
-    """
-    return Histogram(self, "", 0,0,0, name=name, new=False)
+[docs]    def vector_scalar(self, name):
+        """ Returns a VectorScalar from kst given its name.
 
-[docs]  def new_cross_spectrum(self,
-                         V1, V2,
-                         fft_size=10,
-                         sample_rate = 1.0,
-                         name = ""):
-    """ Create a cross spectrum object in kst.
+        See :class:`VectorScalar`
+        """
+        return VectorScalar(self, "", "", 0, name, new=False)
 
-    See :class:`CrossSpectrum`
-    """
-    return CrossSpectrum(self, V1,V2, fft_size, sample_rate, name)
+[docs]    def new_data_vector(self, filename, field, start=0, num_frames=-1,
+                        skip=0, boxcarFirst=False, name=""):
+        """ Create a New DataVector in kst.
 
+        See :class:`DataVector`
+        """
+        return DataVector(self, filename, field, start, num_frames,
+                          skip, boxcarFirst, name)
 
-[docs]  def new_spectrum(self, 
-                   vector, 
-                   sample_rate = 1.0, 
-                   interleaved_average = False,
-                   fft_length = 10,
-                   apodize = True, 
-                   remove_mean = True, 
-                   vector_units = "",
-                   rate_units = "Hz",
-                   apodize_function = 0,
-                   sigma = 1.0,
-                   output_type = 0,
-                   name=""):
-    """ Create a new Spectrum in kst.
-    
-    See :class:`Spectrum`
-    """
-    return Spectrum(self, 
-                    vector, 
-                    sample_rate, 
-                    interleaved_average,
-                    fft_length,
-                    apodize,
-                    remove_mean,
-                    vector_units,
-                    rate_units,
-                    apodize_function,
-                    sigma,
-                    output_type,
-                    name)
+[docs]    def data_vector(self, name):
+        """ Returns a DataVector from kst given its name.
 
-[docs]  def spectrum(self, name):
-    """ Returns a spectrum from kst given its name.
-    
-    See :class:`Spectrum`
-    """
-    return Spectrum(self, "", name=name, new=False)
+        See :class:`DataVector`
+        """
+        return DataVector(self, "", "", name=name, new=False)
 
-[docs]  def new_linear_fit(self, x_vector, y_vector, weightvector = 0, name = ""):
-    """ Create a New Linear Fit in kst.
-    
-    See :class:`LinearFit`
-    """
-    return LinearFit(self, x_vector, y_vector, weightvector, name)
+[docs]    def new_generated_vector(self, x0, x1, n, name=""):
+        """ Create a New GeneratedVector in kst.
 
-[docs]  def linear_fit(self, name):
-    """ Returns a linear fit from kst given its name.
-    
-    See :class:`LinearFit`
-    """
-    return LinearFit(self, "", "", 0, name, new=False)
+        See :class:`GeneratedVector`
+        """
+        return GeneratedVector(self, x0, x1, n, name)
 
+[docs]    def generated_vector(self, name):
+        """ Returns a GeneratedVector from kst given its name.
 
-[docs]  def new_polynomial_fit(self, order, x_vector, y_vector, weightvector = 0, name = ""):
-    """ Create a New Polynomial Fit in kst.
-    
-    See :class:`PolynomialFit`
-    """
-    return PolynomialFit(self, order, x_vector, y_vector, weightvector, name)
+        See :class:`GeneratedVector`
+        """
+        return GeneratedVector(self, 0, 0, 0, name, new=False)
 
-[docs]  def polynomial_fit(self, name):
-    """ Returns a polynomial fit from kst given its name.
-    
-    See :class:`PolynomialFit`
-    """
-    return PolynomialFit(self, 0, "", "", 0, name, new=False)
+[docs]    def new_editable_vector(self, np_array=None, name=""):
+        """ Create a New Editable Vector in kst.
 
+        See :class:`EditableVector`
+        """
+        return EditableVector(self, np_array, name)
 
-[docs]  def new_sum_filter(self, y_vector, step_dX, name = ""):
-    """ Create a cumulative sum filter inside kst.
+[docs]    def editable_vector(self, name):
+        """ Returns an Editable Vector from kst given its name.
 
-    See :class:`SumFilter`
-    """
-    return SumFilter(self, y_vector, step_dX, name)
+        See :class:`EditableVector`
+        """
+        return EditableVector(self, None, name, new=False)
 
 
-[docs]  def new_flag_filter(self, y_vector, flag, mask="0xffffff", valid_is_zero=True, name = ""):
-    """ Create a flag filter inside kst.
+[docs]    def get_vector_list(self):
+        """ returns vectors from kst. """
 
-    See :class:`FlagFilter`
-    """
-    return FlagFilter(self, y_vector, flag, mask, valid_is_zero, name)
+        return_message = self.send("getVectorList()")
+        name_list = return_message.data().split('|')
+        return [VectorBase(self, name=n) for n in name_list]
 
-[docs]  def flag_filter(self, name):
-    """ Returns a flag_filter from kst given its name.
+[docs]    def get_data_vector_list(self):
+        """ returns data vectors from kst. """
 
-    See :class:`FlagFilter`
-    """
-    return FlagFilter(self, "", "", name, new=False)
+        return_message = self.send("getDataVectorList()")
+        name_list = return_message.data().split('|')
+        return [DataVector(self, "", "", name=n, new=False) for n in name_list]
 
+[docs]    def get_generated_vector_list(self):
+        """ returns generated vectors from kst. """
 
-[docs]  def new_label(self, text, pos=(0.5,0.5), rot=0, font_size=12, 
-            bold=False, italic=False, font_color="black", 
-            font_family="Serif", name="") :
-    """ Create a New Label in kst.
-    
-    See :class:`Label`
-    """
-    return Label(self, text, pos, rot, font_size, bold, italic, 
-                 font_color, font_family, name)
+        return_message = self.send("getGeneratedVectorList()")
+        name_list = return_message.data().split('|')
+        return [GeneratedVector(self, name=n, new=False) for n in name_list]
 
-[docs]  def label(self, name):
-    """ Returns a Label from kst given its name.
-    
-    See :class:`Label`
-    """
-    return Label(self, "", name=name, new=False)
-    
-[docs]  def get_label_list(self):
-    """ Get a list of all labels in kst.
+[docs]    def get_editable_vector_list(self):
+        """ returns editable vectors from kst. """
 
-    See :class:`Label`
-    """
-    x=self.send("getLabelList()")
-    name_list = x.data()[1:-1].split("][")
-    return [Label(self, name=n, new=False) for n in name_list]
+        return_message = self.send("getEditableVectorList()")
+        name_list = return_message.data().split('|')
+        return [EditableVector(self, name=n, new=False) for n in name_list]
 
 
-[docs]  def new_box(self, pos=(0.1,0.1), size=(0.1,0.1), rot=0,
-          fill_color="white", fill_style=1, stroke_style=1, stroke_width=1,
-          stroke_brush_color="black", stroke_brush_style=1, 
-          strokeJoinStyle=1, stroke_cap_style=1, fix_aspect=False, name="") :
-    """ Create a New Box in kst.
-    
-    See :class:`Box`
-    """
-    return Box(self, pos, size, rot, fill_color, fill_style, stroke_style, 
-               stroke_width, stroke_brush_color, stroke_brush_style, 
-               strokeJoinStyle, stroke_cap_style, fix_aspect, name)
+[docs]    def new_data_matrix(self, filename, field, start_x=0, start_y=0, num_x=-1, num_y=-1,
+                        min_x=0, min_y=0, dx=1, dy=1, name=""):
+        """ Create a New DataMatrix in kst.
 
-[docs]  def box(self, name):
-    """ Returns a Box from kst given its name.
-    
-    See :class:`Box`
-    """
-    return Box(self, name=name, new=False)
-  
-[docs]  def get_box_list(self):
-    """ Get a list of all boxes in kst.
+        See :class:`DataMatrix`
+        """
+        return DataMatrix(self, filename, field, start_x, start_y, num_x, num_y,
+                          min_x, min_y, dx, dy, name)
 
-    See :class:`Box`
-    """
-    x=self.send("getBoxList()")
-    name_list = x.data()[1:-1].split("][")
-    return [Box(self, name=n, new=False) for n in name_list]
+[docs]    def data_matrix(self, name):
+        """ Returns a DataMatrix from kst given its name.
 
+        See :class:`DataMatrix`
+        """
+        return DataMatrix(self, "", "", name=name, new=False)
 
-[docs]  def new_legend(self, plot, name = "") :
-    """ Create a new Legend in a plot in kst.
+[docs]    def new_editable_matrix(self, np_array=None, name=""):
+        """ Create a New Editable Matrix in kst.
 
-    See :class:'Legend'
-    """
-    return Legend(self, plot, name)
+        See :class:`EditableMatrix`
+        """
+        return EditableMatrix(self, np_array, name)
 
-[docs]  def legend(self, name):
-    """ Returns a Legend from kst given its name.
+[docs]    def editable_matrix(self, name):
+        """ Returns an Editable Matrix from kst given its name.
 
-    See :class:`Legend`
-    """
-    return Legend(self, name=name, new=False)
+        See :class:`EditableMatrix`
+        """
+        return EditableMatrix(self, None, name, new=False)
 
-[docs]  def get_legend_list(self):
-    """ Get a list of all legends in kst.
+[docs]    def get_matrix_list(self):
+        """ returns matrixes from kst. """
 
-    See :class:`Legend`
-    """
-    x=self.send("getLegendList()")
-    name_list = x.data()[1:-1].split("][")
-    return [Legend(self, name=n, new=False) for n in name_list]
+        return_message = self.send("getMatrixList()")
+        name_list = return_message.data().split('|')
+        return [Matrix(self, name=n) for n in name_list]
 
 
-[docs]  def new_circle(self, pos=(0.1, 0.1), diameter=0.1,
-             fill_color="white",fill_style=1,stroke_style=1,
-             stroke_width=1,stroke_brush_color="grey",stroke_brush_style=1, name="") :
-    """ Create a New Circle in kst.
-    
-    See :class:`Circle`
-    """
-    return Circle(self, pos, diameter, fill_color, fill_style, stroke_style, 
-                  stroke_width, stroke_brush_color, stroke_brush_style, name)
-  
-[docs]  def circle(self, name):
-    """ Returns a Circle from kst given its name.
-    
-    See :class:`Circle`
-    """
-    return Circle(self, name=name, new=False)
-  
-[docs]  def get_circle_list(self):
-    """ Get a list of all ciircles in kst.
+[docs]    def new_curve(self, x_vector, y_vector, name=""):
+        """ Create a New Curve in kst.
 
-    See :class:`Circle`
-    """
-    x=self.send("getCircleList()")
-    name_list = x.data()[1:-1].split("][")
-    return [Circle(self, name=n, new=False) for n in name_list]
+        See :class:`Curve`
+        """
+        return Curve(self, x_vector, y_vector, name)
 
-[docs]  def new_ellipse(self,pos=(0.1,0.1), size=(0.1,0.1),
-               rot=0, fill_color="white", fill_style=1, stroke_style=1,
-               stroke_width=1, stroke_brush_color="black", stroke_brush_style=1,
-               fix_aspect=False, name="") :
-    """ Create a New Ellipse in kst.
-    
-    See :class:`Ellipse`
-    """
-    return Ellipse(self,pos, size, rot, fill_color, fill_style, stroke_style, 
-                   stroke_width, stroke_brush_color, stroke_brush_style, 
-                   fix_aspect, name)
+[docs]    def curve(self, name):
+        """ Returns a Curve from kst given its name.
 
-[docs]  def ellipse(self, name):
-    """ Returns an ellipse from kst given its name.
-    
-    See :class:`Ellipse`
-    """
-    return Ellipse(self, name=name, new=False)
-  
-[docs]  def get_ellipse_list(self):
-    """ Get a list of all ellipse in kst.
+        See :class:`Curve`
+        """
+        return Curve(self, "", "", name, new=False)
 
-    See :class:`Ellipse`
-    """
-    x=self.send("getEllipseList()")
-    name_list = x.data()[1:-1].split("][")
-    return [Ellipse(self, name=n, new=False) for n in name_list]
+[docs]    def new_image(self, matrix, name=""):
+        """ Create a new Image in kst.
 
-[docs]  def new_line(self,start=(0,0),end = (1,1),
-           stroke_style=1,stroke_width=1,stroke_brush_color="black",
-           stroke_brush_style=1,stroke_cap_style=1, name="") :
-    """ Create a New Line in kst.
-    
-    See :class:`Line`
-    """
-    return Line(self,start,end, stroke_style, stroke_width,
-                stroke_brush_color, stroke_brush_style, stroke_cap_style, name)
-  
-[docs]  def line(self, name):
-    """ Returns a Line from kst given its name.
-    
-    See :class:`Line`
-    """
-    return Line(self, name=name, new=False)
+        See :class:`Image`
+        """
+        return Image(self, matrix, name)
 
-[docs]  def get_line_list(self):
-    """ Get a list of all lines in kst.
+[docs]    def image(self, name):
+        """ Returns an Image from kst given its name.
 
-    See :class:`Line`
-    """
-    x=self.send("getLineList()")
-    name_list = x.data()[1:-1].split("][")
-    return [Line(self, name=n, new=False) for n in name_list]
+        See :class:`Image`
+        """
+        return Image(self, "", "", name, new=False)
 
+[docs]    def new_equation(self, x_vector, equation, interpolate=True, name=""):
+        """ Create a new Equation in kst.
 
-[docs]  def new_arrow(self,start=(0,0),end = (1,1),
-            arror_at_start = False, arrow_at_end = True, arrow_size = 12.0, 
-            stroke_style=1, stroke_width=1, stroke_brush_color="black",
-            stroke_brush_style=1, stroke_cap_style=1, name="") :
-    """ Create a New Arrow in kst.
-    
-    See :class:`Arrow`
-    """
-    return Arrow(self,start,end, arror_at_start, arrow_at_end, arrow_size,
-          stroke_style, stroke_width, stroke_brush_color, stroke_brush_style, 
-          stroke_cap_style, name)
-    
-[docs]  def arrow(self, name):
-    """ Returns an Arrow from kst given its name.
-    
-    See :class:`Arrow`
-    """
-    return Arrow(self, name=name, new=False)
-    
-[docs]  def get_arrow_list(self):
-    """ Get a list of all arrows in kst.
+        See :class:`Equation`
+        """
+        return Equation(self, x_vector, equation, interpolate, name)
 
-    See :class:`Arrow`
-    """
-    x=self.send("getArrowList()")
-    name_list = x.data()[1:-1].split("][")
-    return [Arrow(self, name=n, new=False) for n in name_list]
-
-[docs]  def new_picture(self,filename,pos=(0.1,0.1), width=0.1,rot=0, name="") :
-    """ Create a New Picture in kst.
-    
-    See :class:`Picture`
-    """
-    return Picture(self,filename, pos, width, rot, name)
-  
-[docs]  def picture(self, name):
-    """ Returns a Picture from kst given its name.
-    
-    See :class:`Picture`
-    """
-    return Picture(self, "", name = name, new=False)
-  
-[docs]  def get_picture_list(self):
-    """ Get a list of all pictures in kst.
-
-    See :class:`Picture`
-    """
-    x=self.send("getPictureList()")
-    name_list = x.data()[1:-1].split("][")
-    return [Picture(self, name=n, new=False) for n in name_list]
-
-[docs]  def new_SVG(self, filename, pos=(0.1,0.1), width=0.1, rot=0, name="") :
-    """ Create a New SVG in kst.
-    
-    See :class:`SVG`
-    """
-    return SVG(self, filename, pos, width, rot, name)
-  
-[docs]  def SVG(self, name):
-    """ Returns a SVG from kst given its name.
-    
-    See :class:`SVG`
-    """
-    return SVG(self, "", name = name, new=False)
-
-[docs]  def get_SVG_list(self):
-    """ Get a list of all SVGs in kst.
-
-    See :class:`SVG`
-    """
-    x=self.send("getSVGList()")
-    name_list = x.data()[1:-1].split("][")
-    return [SVG(self, name=n, new=False) for n in name_list]
-
-[docs]  def new_plot(self,pos=(0.1,0.1),size=(0,0),rot=0,font_size = 0, columns=0,
-           fill_color="white", fill_style=1, stroke_style=1, stroke_width=1,
-           stroke_brush_color="black", stroke_brush_style=1, 
-           strokeJoinStyle=1, stroke_cap_style=1, fix_aspect=False, auto_position = True, name="") :
-    """ Create a New Plot in kst.
-    
-    See :class:`Plot`
-    """
-    return Plot(self, pos, size, rot, font_size, columns, fill_color, fill_style, stroke_style,
-                stroke_width, stroke_brush_color, stroke_brush_style, 
-                strokeJoinStyle, stroke_cap_style, fix_aspect, auto_position, name)
-  
-[docs]  def plot(self, name):
-    """ Returns a Plot from kst given its name.
-    
-    See :class:`Plot`
-    """
-    return Plot(self, name = name, new=False)
-
-[docs]  def get_plot_list(self):
-    """ Get a list of all plots in kst.
-
-    See :class:`Plot`
-    """
-    x=self.send("getPlotList()")
-    name_list = x.data()[1:-1].split("][")
-    return [Plot(self, name=n, new=False) for n in name_list]
-
-[docs]  def set_datasource_option(self, option, value, filename, data_source="Ascii File"):
-    """ Sets the value of a data source configuration option.
-
-    :param option: the name of the option - eg ""Data Start"
-    :param value: True or False
-    :param filename: the name of the file or 0 to set global default
-    :param data_source: the type of data source
 
-    Examples:
+[docs]    def equation(self, name):
+        """ Returns an Equation from kst given its name.
 
-    Tell kst that trial1.csv is a file with the field names in row 1 and units in row 2::
+        See :class:`Equation`
+        """
+        return Equation(self, "", "", name, new=False)
 
-        import pykst as kst
-        client = kst.Client()
-        client.set_datasource_option("Column Delimiter", ",", "trial1.csv")
-        client.set_datasource_option("Column Type", 2, "trial1.csv")
-        client.set_datasource_option("Data Start", 3-1, "trial1.csv")
-        client.set_datasource_option("Fields Line", 1-1, "trial1.csv")
-        client.set_datasource_option("Read Fields", True, "trial1.csv")
-        client.set_datasource_option("Units Line", 2-1, "trial1.csv")
-        client.set_datasource_option("Read Units", True, "trial1.csv")
-
-    Configuration options supported by the ASCII data source (default) are::
-
-        "ASCII Time format"
-        "Column Delimiter"
-        "Column Type"
-        "Column Width"
-        "Column Width is const"
-        "Comment Delimiters"
-        "Data Rate for index"
-        "Data Start"
-        "Default INDEX Interpretation"
-        "Fields Line"
-        "Filename Pattern"
-        "Index"
-        "Limit file buffer size"
-        "NaN value"
-        "Read Fields"
-        "Read Units"
-        "Size of limited file buffer"
-        "Units Line"
-        "Use Dot"
-        "Use threads when parsing Ascii data"
-        "date/time offset"
-        "relative offset"
-        "updateType"
-        "use an explicit date/time offset"
-        "use file time/date as offset"
-        "use relative file time offset"
+[docs]    def new_histogram(self, vector, bin_min=0, bin_max=1, num_bins=60,
+                      normalization=0, auto_bin=True, name=""):
+        """ Create a new histogram in kst.
 
+        See :class:`Histogram`
+        """
+        return Histogram(self, vector, bin_min, bin_max, num_bins,
+                         normalization, auto_bin, name)
 
-    """
 
-    if (filename == 0):
-      filename = "$DEFAULT"
-
-    if isinstance(value, bool):
-      self.send("setDatasourceBoolConfig("+data_source+","+filename+","+option+","+b2str(value)+")")
-    elif isinstance(value, int):
-      self.send("setDatasourceIntConfig("+data_source+","+filename+","+option+","+str(value)+")")
-    else:
-      v = value
-      v.replace(',', '`')
-      self.send("setDatasourceStringConfig("+data_source+","+filename+","+option+","+str(v)+")")
+[docs]    def histogram(self, name):
+        """ Returns a histogram from kst given its name.
+
+        See :class:`Histogram`
+        """
+        return Histogram(self, "", 0, 0, 0, name=name, new=False)
+
+[docs]    def new_cross_spectrum(self,
+                           V1, V2,
+                           fft_size=10,
+                           sample_rate=1.0,
+                           name=""):
+        """ Create a cross spectrum object in kst.
+
+        See :class:`CrossSpectrum`
+        """
+        return CrossSpectrum(self, V1, V2, fft_size, sample_rate, name)
+
+
+[docs]    def new_spectrum(self,
+                     vector,
+                     sample_rate=1.0,
+                     interleaved_average=False,
+                     fft_length=10,
+                     apodize=True,
+                     remove_mean=True,
+                     vector_units="",
+                     rate_units="Hz",
+                     apodize_function=0,
+                     sigma=1.0,
+                     output_type=0,
+                     name=""):
+        """ Create a new Spectrum in kst.
+
+        See :class:`Spectrum`
+        """
+        return Spectrum(self,
+                        vector,
+                        sample_rate,
+                        interleaved_average,
+                        fft_length,
+                        apodize,
+                        remove_mean,
+                        vector_units,
+                        rate_units,
+                        apodize_function,
+                        sigma,
+                        output_type,
+                        name)
+
+[docs]    def spectrum(self, name):
+        """ Returns a spectrum from kst given its name.
+
+        See :class:`Spectrum`
+        """
+        return Spectrum(self, "", name=name, new=False)
+
+[docs]    def new_linear_fit(self, x_vector, y_vector, weightvector=0, name=""):
+        """ Create a New Linear Fit in kst.
+
+        See :class:`LinearFit`
+        """
+        return LinearFit(self, x_vector, y_vector, weightvector, name)
+
+[docs]    def linear_fit(self, name):
+        """ Returns a linear fit from kst given its name.
+
+        See :class:`LinearFit`
+        """
+        return LinearFit(self, "", "", 0, name, new=False)
+
+
+[docs]    def new_polynomial_fit(self, order, x_vector, y_vector, weightvector=0, name=""):
+        """ Create a New Polynomial Fit in kst.
+
+        See :class:`PolynomialFit`
+        """
+        return PolynomialFit(self, order, x_vector, y_vector, weightvector, name)
+
+[docs]    def polynomial_fit(self, name):
+        """ Returns a polynomial fit from kst given its name.
+
+        See :class:`PolynomialFit`
+        """
+        return PolynomialFit(self, 0, "", "", 0, name, new=False)
+
+
+[docs]    def new_sum_filter(self, y_vector, step_dX, name=""):
+        """ Create a cumulative sum filter inside kst.
+
+        See :class:`SumFilter`
+        """
+        return SumFilter(self, y_vector, step_dX, name)
+
+
+[docs]    def new_flag_filter(self, y_vector, flag, mask="0xffffff", valid_is_zero=True, name=""):
+        """ Create a flag filter inside kst.
+
+        See :class:`FlagFilter`
+        """
+        return FlagFilter(self, y_vector, flag, mask, valid_is_zero, name)
+
+[docs]    def flag_filter(self, name):
+        """ Returns a flag_filter from kst given its name.
+
+        See :class:`FlagFilter`
+        """
+        return FlagFilter(self, "", "", name, new=False)
+
+
+[docs]    def new_label(self, text, pos=(0.5, 0.5), rot=0, font_size=12,
+                  bold=False, italic=False, font_color="black",
+                  font_family="Serif", name=""):
+        """ Create a New Label in kst.
+
+        See :class:`Label`
+        """
+        return Label(self, text, pos, rot, font_size, bold, italic,
+                     font_color, font_family, name)
+
+[docs]    def label(self, name):
+        """ Returns a Label from kst given its name.
+
+        See :class:`Label`
+        """
+        return Label(self, "", name=name, new=False)
+
+[docs]    def get_label_list(self):
+        """ Get a list of all labels in kst.
+
+        See :class:`Label`
+        """
+        return_message = self.send("getLabelList()")
+        name_list = return_message.data()[1:-1].split("][")
+        return [Label(self, "", name=n, new=False) for n in name_list]
 
 
+[docs]    def new_box(self, pos=(0.1, 0.1), size=(0.1, 0.1), rot=0,
+                fill_color="white", fill_style=1, stroke_style=1, stroke_width=1,
+                stroke_brush_color="black", stroke_brush_style=1,
+                stroke_join_style=1, stroke_cap_style=1, fix_aspect=False, name=""):
+        """ Create a New Box in kst.
 
-class NamedObject:
+        See :class:`Box`
+        """
+        return Box(self, pos, size, rot, fill_color, fill_style, stroke_style,
+                   stroke_width, stroke_brush_color, stroke_brush_style,
+                   stroke_join_style, stroke_cap_style, fix_aspect, name)
+
+[docs]    def box(self, name):
+        """ Returns a Box from kst given its name.
+
+        See :class:`Box`
+        """
+        return Box(self, name=name, new=False)
+
+[docs]    def get_box_list(self):
+        """ Get a list of all boxes in kst.
+
+        See :class:`Box`
+        """
+        return_message = self.send("getBoxList()")
+        name_list = return_message.data()[1:-1].split("][")
+        return [Box(self, name=n, new=False) for n in name_list]
+
+
+[docs]    def new_legend(self, plot, name=""):
+        """ Create a new Legend in a plot in kst.
+
+        See :class:'Legend'
+        """
+        return Legend(self, plot, name)
+
+[docs]    def legend(self, name):
+        """ Returns a Legend from kst given its name.
+
+        See :class:`Legend`
+        """
+        return Legend(self, 0, name=name, new=False)
+
+[docs]    def get_legend_list(self):
+        """ Get a list of all legends in kst.
+
+        See :class:`Legend`
+        """
+        return_message = self.send("getLegendList()")
+        name_list = return_message.data()[1:-1].split("][")
+        return [Legend(self, 0, name=n, new=False) for n in name_list]
+
+
+[docs]    def new_circle(self, pos=(0.1, 0.1), diameter=0.1,
+                   fill_color="white", fill_style=1, stroke_style=1,
+                   stroke_width=1, stroke_brush_color="grey", stroke_brush_style=1, name=""):
+        """ Create a New Circle in kst.
+
+        See :class:`Circle`
+        """
+        return Circle(self, pos, diameter, fill_color, fill_style, stroke_style,
+                      stroke_width, stroke_brush_color, stroke_brush_style, name)
+
+[docs]    def circle(self, name):
+        """ Returns a Circle from kst given its name.
+
+        See :class:`Circle`
+        """
+        return Circle(self, name=name, new=False)
+
+[docs]    def get_circle_list(self):
+        """ Get a list of all ciircles in kst.
+
+        See :class:`Circle`
+        """
+        return_message = self.send("getCircleList()")
+        name_list = return_message.data()[1:-1].split("][")
+        return [Circle(self, name=n, new=False) for n in name_list]
+
+[docs]    def new_ellipse(self, pos=(0.1, 0.1), size=(0.1, 0.1),
+                    rot=0, fill_color="white", fill_style=1, stroke_style=1,
+                    stroke_width=1, stroke_brush_color="black", stroke_brush_style=1,
+                    fix_aspect=False, name=""):
+        """ Create a New Ellipse in kst.
+
+        See :class:`Ellipse`
+        """
+        return Ellipse(self, pos, size, rot, fill_color, fill_style, stroke_style,
+                       stroke_width, stroke_brush_color, stroke_brush_style,
+                       fix_aspect, name)
+
+[docs]    def ellipse(self, name):
+        """ Returns an ellipse from kst given its name.
+
+        See :class:`Ellipse`
+        """
+        return Ellipse(self, name=name, new=False)
+
+[docs]    def get_ellipse_list(self):
+        """ Get a list of all ellipse in kst.
+
+        See :class:`Ellipse`
+        """
+        return_message = self.send("getEllipseList()")
+        name_list = return_message.data()[1:-1].split("][")
+        return [Ellipse(self, name=n, new=False) for n in name_list]
+
+[docs]    def new_line(self, start=(0, 0), end=(1, 1),
+                 stroke_style=1, stroke_width=1, stroke_brush_color="black",
+                 stroke_brush_style=1, stroke_cap_style=1, name=""):
+        """ Create a New Line in kst.
+
+        See :class:`Line`
+        """
+        return Line(self, start, end, stroke_style, stroke_width,
+                    stroke_brush_color, stroke_brush_style, stroke_cap_style, name)
+
+[docs]    def line(self, name):
+        """ Returns a Line from kst given its name.
+
+        See :class:`Line`
+        """
+        return Line(self, name=name, new=False)
+
+[docs]    def get_line_list(self):
+        """ Get a list of all lines in kst.
+
+        See :class:`Line`
+        """
+        return_message = self.send("getLineList()")
+        name_list = return_message.data()[1:-1].split("][")
+        return [Line(self, name=n, new=False) for n in name_list]
+
+
+[docs]    def new_arrow(self, start=(0, 0), end=(1, 1),
+                  arror_at_start=False, arrow_at_end=True, arrow_size=12.0,
+                  stroke_style=1, stroke_width=1, stroke_brush_color="black",
+                  stroke_brush_style=1, stroke_cap_style=1, name=""):
+        """ Create a New Arrow in kst.
+
+        See :class:`Arrow`
+        """
+        return Arrow(self, start, end, arror_at_start, arrow_at_end, arrow_size,
+                     stroke_style, stroke_width, stroke_brush_color, stroke_brush_style,
+                     stroke_cap_style, name)
+
+[docs]    def arrow(self, name):
+        """ Returns an Arrow from kst given its name.
+
+        See :class:`Arrow`
+        """
+        return Arrow(self, name=name, new=False)
+
+[docs]    def get_arrow_list(self):
+        """ Get a list of all arrows in kst.
+
+        See :class:`Arrow`
+        """
+        return_message = self.send("getArrowList()")
+        name_list = return_message.data()[1:-1].split("][")
+        return [Arrow(self, name=n, new=False) for n in name_list]
+
+[docs]    def new_picture(self, filename, pos=(0.1, 0.1), width=0.1, rot=0, name=""):
+        """ Create a New Picture in kst.
+
+        See :class:`Picture`
+        """
+        return Picture(self, filename, pos, width, rot, name)
+
+[docs]    def picture(self, name):
+        """ Returns a Picture from kst given its name.
+
+        See :class:`Picture`
+        """
+        return Picture(self, "", name=name, new=False)
+
+[docs]    def get_picture_list(self):
+        """ Get a list of all pictures in kst.
+
+        See :class:`Picture`
+        """
+        return_message = self.send("getPictureList()")
+        name_list = return_message.data()[1:-1].split("][")
+        return [Picture(self, "", name=n, new=False) for n in name_list]
+
+[docs]    def new_SVG(self, filename, pos=(0.1, 0.1), width=0.1, rot=0, name=""):
+        """ Create a New SVG in kst.
+
+        See :class:`SVG`
+        """
+        return SVG(self, filename, pos, width, rot, name)
+
+[docs]    def SVG(self, name):
+        """ Returns a SVG from kst given its name.
+
+        See :class:`SVG`
+        """
+        return SVG(self, "", name=name, new=False)
+
+[docs]    def get_SVG_list(self):
+        """ Get a list of all SVGs in kst.
+
+        See :class:`SVG`
+        """
+        return_message = self.send("getSVGList()")
+        name_list = return_message.data()[1:-1].split("][")
+        return [SVG(self, "", name=n, new=False) for n in name_list]
+
+[docs]    def new_plot(self, pos=(0.1, 0.1), size=(0, 0), rot=0, font_size=0, columns=0,
+                 fill_color="white", fill_style=1, stroke_style=1, stroke_width=1,
+                 stroke_brush_color="black", stroke_brush_style=1,
+                 stroke_join_style=1, stroke_cap_style=1, fix_aspect=False,
+                 auto_position=True, name=""):
+        """ Create a New Plot in kst.
+
+        See :class:`Plot`
+        """
+        return Plot(self, pos, size, rot, font_size, columns, fill_color, fill_style, stroke_style,
+                    stroke_width, stroke_brush_color, stroke_brush_style,
+                    stroke_join_style, stroke_cap_style, fix_aspect, auto_position, name)
+
+[docs]    def plot(self, name):
+        """ Returns a Plot from kst given its name.
+
+        See :class:`Plot`
+        """
+        return Plot(self, name=name, new=False)
+
+[docs]    def get_plot_list(self):
+        """ Get a list of all plots in kst.
+
+        See :class:`Plot`
+        """
+        return_message = self.send("getPlotList()")
+        name_list = return_message.data()[1:-1].split("][")
+        return [Plot(self, name=n, new=False) for n in name_list]
+
+[docs]    def set_datasource_option(self, option, value, filename, data_source="Ascii File"):
+        """ Sets the value of a data source configuration option.
+
+        :param option: the name of the option - eg ""Data Start"
+        :param value: True or False
+        :param filename: the name of the file or 0 to set global default
+        :param data_source: the type of data source
+
+        Examples:
+
+        Tell kst that trial1.csv is a file with the field names in row 1 and units in row 2::
+
+            import pykst as kst
+            client = kst.Client()
+            client.set_datasource_option("Column Delimiter", ",", "trial1.csv")
+            client.set_datasource_option("Column Type", 2, "trial1.csv")
+            client.set_datasource_option("Data Start", 3-1, "trial1.csv")
+            client.set_datasource_option("Fields Line", 1-1, "trial1.csv")
+            client.set_datasource_option("Read Fields", True, "trial1.csv")
+            client.set_datasource_option("Units Line", 2-1, "trial1.csv")
+            client.set_datasource_option("Read Units", True, "trial1.csv")
+
+        Configuration options supported by the ASCII data source (default) are::
+
+            "ASCII Time format"
+            "Column Delimiter"
+            "Column Type"
+            "Column Width"
+            "Column Width is const"
+            "Comment Delimiters"
+            "Data Rate for index"
+            "Data Start"
+            "Default INDEX Interpretation"
+            "Fields Line"
+            "Filename Pattern"
+            "Index"
+            "Limit file buffer size"
+            "NaN value"
+            "Read Fields"
+            "Read Units"
+            "Size of limited file buffer"
+            "Units Line"
+            "Use Dot"
+            "Use threads when parsing Ascii data"
+            "date/time offset"
+            "relative offset"
+            "updateType"
+            "use an explicit date/time offset"
+            "use file time/date as offset"
+            "use relative file time offset"
+
+
+        """
+
+        if filename == 0:
+            filename = "$DEFAULT"
+
+        if isinstance(value, bool):
+            self.send("setDatasourceBoolConfig("+data_source+","+filename+","+option+","+
+                      b2str(value)+")")
+        elif isinstance(value, int):
+            self.send("setDatasourceIntConfig("+data_source+","+filename+","+option+","+
+                      str(value)+")")
+        else:
+            v = value
+            v.replace(',', '`')
+            self.send("setDatasourceStringConfig("+data_source+","+filename+","+option+","+
+                      str(v)+")")
+
+
+
+class NamedObject(object):
     """ Convenience class. You should not use it directly."""
-    def __init__(self,client):
-      self.client=client
-      
-    def set_name(self,name):
-      """ Set the name of the object inside kst. """
-      self.client.send_si(self.handle, b2str("setName("+b2str(name)+")"))
-      
+    def __init__(self, client):
+        self.client = client
+        self.handle = ""
+
+    def set_name(self, name):
+        """ Set the name of the object inside kst. """
+        self.client.send_si(self.handle, b2str("setName("+b2str(name)+")"))
+
     def name(self):
-      """ Returns the name of the object from inside kst. """
-      return self.client.send_si(self.handle, "name()")
+        """ Returns the name of the object from inside kst. """
+        return self.client.send_si(self.handle, "name()")
 
     def description_tip(self):
-      """  Returns a string describing the object """
-      return self.client.send_si(self.handle, "descriptionTip()")
+        """  Returns a string describing the object """
+        return self.client.send_si(self.handle, "descriptionTip()")
 
     def test_command(self):
-      return self.client.send_si(self.handle, "testCommand()")
+        return self.client.send_si(self.handle, "testCommand()")
+
+
+class Object(NamedObject):
+    """ Convenience class. You should not use it directly."""
+    def __init__(self, client):
+        NamedObject.__init__(self, client)
+
+    def type_str(self):
+        """ Returns the type of the object from inside kst. """
+        return self.client.send_si(self.handle, "type()")
+
+
+class String(Object):
+    """ Convenience class. You should not use it directly."""
+    def __init__(self, client):
+        Object.__init__(self, client)
+
+    def value(self):
+        """ Returns the string. """
+        return self.client.send_si(self.handle, "value()")
+
+[docs]class GeneratedString(String):
+    """ A string constant inside kst.
+
+    This class represents a string you would create via
+    "Create>String>Generated" from the menubar inside kst.
+
+    :param string: The value of the string.
+
+    To import the string "Hello World" into kst::
+
+      import pykst as kst
+      client = kst.Client()
+      s = client.new_generatedString("Hello World")
+
+    """
+    def __init__(self, client, string, name="", new=True):
+        String.__init__(self, client)
+
+        if new:
+            self.client.send("newGeneratedString()")
+            self.handle = self.client.send("endEdit()")
+            self.handle.remove(0, self.handle.indexOf("ing ")+4)
+
+            self.set_value(string)
+            self.set_name(name)
+        else:
+            self.handle = name
+
+[docs]    def set_value(self, val):
+        """ set the value of the string inside kst. """
+        self.client.send_si(self.handle, b2str("setValue("+b2str(val)+")"))
+
+[docs]class DataSourceString(String):
+    """ A string read from a data source inside kst.
+
+    This class represents a string you would create via
+    "Create>String>Read from Data Source" from the menubar inside kst.
 
- 
-class Object(NamedObject) :
-  """ Convenience class. You should not use it directly."""
-  def __init__(self,client) :
-    NamedObject.__init__(self,client)
-
-  def type_str(self):
-    """ Returns the type of the object from inside kst. """
-    return self.client.send_si(self.handle, "type()")
-
-
-class String(Object) :
-  """ Convenience class. You should not use it directly."""
-  def __init__(self,client) :
-    Object.__init__(self,client)
-
-  def value(self) :
-    """ Returns the string. """
-    return self.client.send_si(self.handle, "value()")
-
-[docs]class GeneratedString(String) :
-  """ A string constant inside kst.
-  
-  This class represents a string you would create via 
-  "Create>String>Generated" from the menubar inside kst.
-
-  :param string: The value of the string.
-
-  To import the string "Hello World" into kst::
-
-    import pykst as kst
-    client = kst.Client()
-    s = client.new_generatedString("Hello World")
-    
-  """
-  def __init__(self,client,string,name="", new=True) :
-    String.__init__(self,client)
-
-    if new:
-      self.client.send("newGeneratedString()")
-      self.handle=self.client.send("endEdit()")
-      self.handle.remove(0,self.handle.indexOf("ing ")+4)
-
-      self.set_value(string)
-      self.set_name(name)
-    else:
-      self.handle = name
-
-[docs]  def set_value(self,val):
-    """ set the value of the string inside kst. """
-    self.client.send_si(self.handle, b2str("setValue("+b2str(val)+")"))
-
-[docs]class DataSourceString(String) :
-  """ A string read from a data source inside kst.
-  
-  This class represents a string you would create via 
-  "Create>String>Read from Data Source" from the menubar inside kst.
-  
-  :param filename: The name of the file/data source to read the string from.
-  :param field: the name of the field in the data source.
-
-  To read "File path" from the data source "tmp.dat" into kst::
-  
-    import pykst as kst
-    client = kst.Client()
-    s = client.new_datasource_string("tmp.dat", "File Path")
-    
-  """
-  def __init__(self,client,filename,field,name="", new=True) :
-    String.__init__(self,client)
-    
-    if new:
-      self.client.send("newDataString()")
-      self.handle=self.client.send("endEdit()")
-      self.handle.remove(0,self.handle.indexOf("ing ")+4)
-      self.change(filename, field)
-    else:
-      self.handle = name
-
-[docs]  def change(self,filename,field):
-    """ Change a DataSource String.
-    
-    Change the file and field of a DataSourceString in kst.
-    
     :param filename: The name of the file/data source to read the string from.
     :param field: the name of the field in the data source.
+
+    To read "File path" from the data source "tmp.dat" into kst::
+
+      import pykst as kst
+      client = kst.Client()
+      s = client.new_datasource_string("tmp.dat", "File Path")
+
     """
-    self.client.send_si(self.handle, b2str("change("+b2str(filename)+","+b2str(field)+")"))
+    def __init__(self, client, filename, field, name="", new=True):
+        String.__init__(self, client)
 
+        if new:
+            self.client.send("newDataString()")
+            self.handle = self.client.send("endEdit()")
+            self.handle.remove(0, self.handle.indexOf("ing ")+4)
+            self.change(filename, field)
+        else:
+            self.handle = name
+
+[docs]    def change(self, filename, field):
+        """ Change a DataSource String.
+
+        Change the file and field of a DataSourceString in kst.
+
+        :param filename: The name of the file/data source to read the string from.
+        :param field: the name of the field in the data source.
+        """
+        self.client.send_si(self.handle, b2str("change("+b2str(filename)+","+b2str(field)+")"))
+
+
+class Scalar(Object):
+    """ Convenience class. You should not use it directly."""
+    def __init__(self, client, name=""):
+        Object.__init__(self, client)
+
+        self.handle = name
+
+    def value(self):
+        """ Returns the scalar. """
+        return self.client.send_si(self.handle, "value()")
+
+[docs]class GeneratedScalar(Scalar):
+    """ A scalar constant inside kst.
+
+    This class represents a scalar you would create via
+    "Create>Scalar>Generate" from the menubar inside kst.
+
+    :param value: the value to assign to the scalar constant.
+
+    To import the scalar of value 42 into kst::
+
+      import pykst as kst
+      client = kst.Client()
+      s = client.new_generated_scalar(42)
+
+    """
+    def __init__(self, client, value, name="", new=True):
+        Scalar.__init__(self, client)
+
+        if new:
+            self.client.send("newGeneratedScalar()")
+            self.handle = self.client.send("endEdit()")
+            self.handle.remove(0, self.handle.indexOf("ing ")+4)
+
+            self.set_value(value)
+            self.set_name(name)
+        else:
+            self.handle = name
+
+[docs]    def set_value(self, val):
+        """ set the value of the string inside kst. """
+        self.client.send_si(self.handle, b2str("setValue("+b2str(val)+")"))
+
+
+[docs]class DataSourceScalar(Scalar):
+    """ A scalar read from a data source inside kst.
+
+    This class represents a scalar you would create via
+    "Create>Scalar>Read from Data Source" from the menubar inside kst.
 
-class Scalar(Object) :
-  """ Convenience class. You should not use it directly."""
-  def __init__(self,client, name="") :
-    Object.__init__(self,client)
-
-    self.handle = name
-
-  def value(self) :
-    """ Returns the scalar. """
-    return self.client.send_si(self.handle, "value()")
-
-[docs]class GeneratedScalar(Scalar) :
-  """ A scalar constant inside kst.
- 
-  This class represents a scalar you would create via 
-  "Create>Scalar>Generate" from the menubar inside kst.
-
-  :param value: the value to assign to the scalar constant.
-  
-  To import the scalar of value 42 into kst::
-
-    import pykst as kst
-    client = kst.Client()
-    s = client.new_generated_scalar(42)
-    
-  """
-  def __init__(self, client, value, name="", new=True) :
-    Scalar.__init__(self,client)
-
-    if new:
-      self.client.send("newGeneratedScalar()")
-      self.handle=self.client.send("endEdit()")
-      self.handle.remove(0,self.handle.indexOf("ing ")+4)
-
-      self.set_value(value)
-      self.set_name(name)
-    else:
-      self.handle = name      
-
-[docs]  def set_value(self,val):
-    """ set the value of the string inside kst. """
-    self.client.send_si(self.handle, b2str("setValue("+b2str(val)+")"))
-
-
-[docs]class DataSourceScalar(Scalar) :
-  """ A scalar read from a data source inside kst.
-  
-  This class represents a scalar you would create via 
-  "Create>Scalar>Read from Data Source" from the menubar inside kst.
- 
-  :param filename: The name of the file/data source to read the scalar from.
-  :param field: the name of the field in the data source.
- 
-  To read "CONST1" from the data source "tmp.dat" into kst::
-  
-    import pykst as kst
-    client = kst.Client()
-    x = client.new_datasource_scalar("tmp.dat", "CONST1")
-    
-  """
-  def __init__(self,client,filename,field,name="", new=True) :
-    Scalar.__init__(self,client)
-    
-    if new:
-      self.client.send("newDataScalar()")
-      self.handle=self.client.send("endEdit()")
-      self.handle.remove(0,self.handle.indexOf("ing ")+4)
-
-      self.change(filename, field)
-    else:
-      self.handle = name      
-
-[docs]  def change(self,filename,field):
-    """ Change a DataSource Scalar.
-    
-    Change the file and field of a DataSourceScalar in kst.
-    
     :param filename: The name of the file/data source to read the scalar from.
     :param field: the name of the field in the data source.
+
+    To read "CONST1" from the data source "tmp.dat" into kst::
+
+      import pykst as kst
+      client = kst.Client()
+      x = client.new_datasource_scalar("tmp.dat", "CONST1")
+
     """
-    self.client.send_si(self.handle, "change("+filename+","+field+")")
+    def __init__(self, client, filename, field, name="", new=True):
+        Scalar.__init__(self, client)
+
+        if new:
+            self.client.send("newDataScalar()")
+            self.handle = self.client.send("endEdit()")
+            self.handle.remove(0, self.handle.indexOf("ing ")+4)
+
+            self.change(filename, field)
+        else:
+            self.handle = name
+
+[docs]    def change(self, filename, field):
+        """ Change a DataSource Scalar.
+
+        Change the file and field of a DataSourceScalar in kst.
+
+        :param filename: The name of the file/data source to read the scalar from.
+        :param field: the name of the field in the data source.
+        """
+        self.client.send_si(self.handle, "change("+filename+","+field+")")
+
+[docs]    def file(self):
+        """ Returns the data source file name. """
+        return self.client.send_si(self.handle, "file()")
+
+[docs]    def field(self):
+        """ Returns the field. """
+        return self.client.send_si(self.handle, "field()")
+
+
+[docs]class VectorScalar(Scalar):
+    """ A scalar in kst read from a vector from a data source.
+
+    This class represents a scalar you would create via
+    "Create>Scalar>Read from vector" from the menubar inside kst.
 
-[docs]  def file(self) :
-    """ Returns the data source file name. """
-    return self.client.send_si(self.handle, "file()")
-
-[docs]  def field(self) :
-    """ Returns the field. """
-    return self.client.send_si(self.handle, "field()")
-
-
-[docs]class VectorScalar(Scalar) :
-  """ A scalar in kst read from a vector from a data source.
-  
-  This class represents a scalar you would create via 
-  "Create>Scalar>Read from vector" from the menubar inside kst.
-  
-  :param filename: The name of the file/data source to read the scalar from.
-  :param field: the name of the vector in the data source.  
-  :param frame: which frame of the vector to read the scalar from. 
-                frame = -1 (the default) reads from the end of the file.
-  
-  To read the last value of the vector INDEX from the file "tmp.dat"
-  into kst::
-
-    import pykst as kst
-    client = kst.Client()
-    x = client.new_vector_scalar("tmp.dat", "INDEX", -1)
-
-  """
-  def __init__(self, client, filename, field, frame=-1, name="", new=True) :
-    Scalar.__init__(self,client)
-
-    if new:
-      self.client.send("newVectorScalar()")
-      self.handle=self.client.send("endEdit()")
-      self.handle.remove(0,self.handle.indexOf("ing ")+4)
-
-      self.change(filename, field, frame)
-    else:
-      self.handle = name      
-
-[docs]  def change(self,filename,field,frame):
-    """ Change a Vector Scalar in kst.
-    
-    Change the file, field and frame of a VectorScalar in kst.
-    
     :param filename: The name of the file/data source to read the scalar from.
-    :param field: the name of the vector in the data source.  
-    :param frame: which frame of the vector to read the scalar from.   
-                  frame = -1 reads from the end of the file.
-    """
-    self.client.send_si(self.handle, b2str("change("+b2str(filename)+","+b2str(field)+","+b2str(frame)+")"))
-
-[docs]  def file(self) :
-    """ Returns the data source file name. """
-    return self.client.send_si(self.handle, "file()")
-
-[docs]  def field(self) :
-    """ Returns the field. """
-    return self.client.send_si(self.handle, "field()")
-
-[docs]  def frame(self) :
-    """ Returns the fame. """
-    return self.client.send_si(self.handle, "frame()")
+    :param field: the name of the vector in the data source.
+    :param frame: which frame of the vector to read the scalar from.
+                  frame = -1 (the default) reads from the end of the file.
+
+    To read the last value of the vector INDEX from the file "tmp.dat"
+    into kst::
+
+      import pykst as kst
+      client = kst.Client()
+      x = client.new_vector_scalar("tmp.dat", "INDEX", -1)
+
+    """
+    def __init__(self, client, filename, field, frame=-1, name="", new=True):
+        Scalar.__init__(self, client)
+
+        if new:
+            self.client.send("newVectorScalar()")
+            self.handle = self.client.send("endEdit()")
+            self.handle.remove(0, self.handle.indexOf("ing ")+4)
+
+            self.change(filename, field, frame)
+        else:
+            self.handle = name
+
+[docs]    def change(self, filename, field, frame):
+        """ Change a Vector Scalar in kst.
+
+        Change the file, field and frame of a VectorScalar in kst.
+
+        :param filename: The name of the file/data source to read the scalar from.
+        :param field: the name of the vector in the data source.
+        :param frame: which frame of the vector to read the scalar from.
+                      frame = -1 reads from the end of the file.
+        """
+        self.client.send_si(self.handle, b2str("change("+b2str(filename)+","+
+                                               b2str(field)+","+b2str(frame)+")"))
+
+[docs]    def file(self):
+        """ Returns the data source file name. """
+        return self.client.send_si(self.handle, "file()")
+
+[docs]    def field(self):
+        """ Returns the field. """
+        return self.client.send_si(self.handle, "field()")
+
+[docs]    def frame(self):
+        """ Returns the fame. """
+        return self.client.send_si(self.handle, "frame()")
 
 class VectorBase(Object):
-  """ Convenience class. You should not use it directly."""
-  def __init__(self,client,name="") :
-    Object.__init__(self,client)
-    self.handle = name
-
-  def value(self,index):
-    """  Returns element i of this vector. """
-    return self.client.send_si(self.handle, "value("+b2str(index)+")")
-
-  def length(self):
-    """  Returns the number of samples in the vector. """
-    return self.client.send_si(self.handle, "length()")
-
-  def min(self):
-    """  Returns the minimum value in the vector. """
-    return self.client.send_si(self.handle, "min()")
-
-  def mean(self):
-    """  Returns the mean of the vector. """
-    return self.client.send_si(self.handle, "mean()")
-
-  def max(self):
-    """  Returns the maximum value in the vector. """
-    return self.client.send_si(self.handle, "max()")
-
-  def get_numpy_array(self) :
-    """ get a numpy array which contains the kst vector values """
-    with tempfile.NamedTemporaryFile() as f:
-      self.client.send_si(self.handle, "store(" + f.name + ")")
-      array = fromfile(f.name, dtype = float64)
-      
-    return array
+    """ Convenience class. You should not use it directly."""
+    def __init__(self, client, name=""):
+        Object.__init__(self, client)
+        self.handle = name
+
+    def value(self, index):
+        """  Returns element i of this vector. """
+        return self.client.send_si(self.handle, "value("+b2str(index)+")")
+
+    def length(self):
+        """  Returns the number of samples in the vector. """
+        return self.client.send_si(self.handle, "length()")
+
+    def min(self):
+        """  Returns the minimum value in the vector. """
+        return self.client.send_si(self.handle, "min()")
+
+    def mean(self):
+        """  Returns the mean of the vector. """
+        return self.client.send_si(self.handle, "mean()")
+
+    def max(self):
+        """  Returns the maximum value in the vector. """
+        return self.client.send_si(self.handle, "max()")
+
+    def get_numpy_array(self):
+        """ get a numpy array which contains the kst vector values """
+        with tempfile.NamedTemporaryFile() as f:
+            self.client.send_si(self.handle, "store(" + f.name + ")")
+            array = np.fromfile(f.name, dtype=np.float64)
+
+        return array
 
 
 [docs]class DataVector(VectorBase):
-  """ A vector in kst, read from a data source.
-  
-  This class represents a vector you would create via 
-  "Create>Vector>Read from Data Source" from the menubar inside kst.
-
-  The parameters of this function mirror the parameters within 
-  "Create>Vector>Read from Data Source".
-
-  :param filename: The name of the file/data source to read the scalar from.
-  :param field: the name of the vector in the data source.  
-  :param start: The starting index of the vector.  
-                start = -1 for count from end.
-  :param num_frames: The number of frames to read.  
-                  num_frames = -1 for read to end.
-  :param skip: The number of frames per sample read.  
-               skip = 0 to read every sample.
-  :param boxcarFirst: apply a boxcar filter before skiping.
-  
-  To create a vector from "tmp.dat" with field "INDEX" from 
-  frame 3 to frame 10, reading a sample every other frame without 
-  a boxcar filter::
-
-    import pykst as kst
-    client = kst.Client()
-    v = client.new_data_vector("tmp.dat", "INDEX", 3, 10, 2, False) 
-    
-  """
-  def __init__(self, client, filename, field, start=0, num_frames=-1,
-               skip=0, boxcarFirst=False, name="", new=True) :
-    VectorBase.__init__(self,client)
-
-    if new:
-      self.client.send("newDataVector()")
-      self.handle=self.client.send("endEdit()")
-      self.handle.remove(0,self.handle.indexOf("ing ")+4)
-      self.change(filename, field, start, num_frames, skip, boxcarFirst)
-    else:
-      self.handle = name
-
-[docs]  def change(self, filename, field, start, num_frames, skip, boxcarFirst):
-    """ Change the parameters of a data vector.
-    
-    :param filename: The name of the file/data source to read the scalar from.
-    :param field: the name of the vector in the data source.  
-    :param start: The starting index of the vector.  
-                  start = -1 for count from end.
-    :param num_frames: The number of frames to read.  
-                    num_frames = -1 for read to end.
-    :param skip: The number of frames per sample read.  
-                skip = 0 to read every sample.
-    :param boxcarFirst: apply a boxcar filter before skiping.
-    
-    """
-    self.client.send_si(self.handle, "change("+filename+","+field+","
-                        +b2str(start)+","+b2str(num_frames)+","+b2str(skip)
-                        +","+b2str(boxcarFirst)+")")
+    """ A vector in kst, read from a data source.
+
+    This class represents a vector you would create via
+    "Create>Vector>Read from Data Source" from the menubar inside kst.
 
-[docs]  def change_frames(self, start, num_frames, skip, boxcarFirst):
-    """ Change the parameters of a data vector.
+    The parameters of this function mirror the parameters within
+    "Create>Vector>Read from Data Source".
 
+    :param filename: The name of the file/data source to read the scalar from.
+    :param field: the name of the vector in the data source.
     :param start: The starting index of the vector.
                   start = -1 for count from end.
     :param num_frames: The number of frames to read.
                     num_frames = -1 for read to end.
     :param skip: The number of frames per sample read.
-                skip = 0 to read every sample.
+                 skip = 0 to read every sample.
     :param boxcarFirst: apply a boxcar filter before skiping.
 
+    To create a vector from "tmp.dat" with field "INDEX" from
+    frame 3 to frame 10, reading a sample every other frame without
+    a boxcar filter::
+
+      import pykst as kst
+      client = kst.Client()
+      v = client.new_data_vector("tmp.dat", "INDEX", 3, 10, 2, False)
+
     """
-    self.client.send_si(self.handle, "changeFrames("
-                        +b2str(start)+","+b2str(num_frames)+","+b2str(skip)
-                        +","+b2str(boxcarFirst)+")")
-
-[docs]  def field(self):
-    """  Returns the fieldname. """
-    return self.client.send_si(self.handle, "field()")
-
-[docs]  def filename(self):
-    """  Returns the filename. """
-    return self.client.send_si(self.handle, "filename()")
-
-[docs]  def start(self):
-    """  Returns the index of first frame in the vector.  
-    -1 means count from end. """
-    return self.client.send_si(self.handle, "start()")
-
-[docs]  def n_frames(self):
-    """  Returns the number of frames to be read. -1 means read to end. """
-    return self.client.send_si(self.handle, "NFrames()")
-
-[docs]  def skip(self):
-    """  Returns number of frames to be skipped between samples read. """
-    return self.client.send_si(self.handle, "skip()")
-
-[docs]  def boxcar_first(self):
-    """  True if boxcar filtering has been applied before skipping. """
-    return self.client.send_si(self.handle, "boxcarFirst()")
+    def __init__(self, client, filename, field, start=0, num_frames=-1,
+                 skip=0, boxcarFirst=False, name="", new=True):
+        VectorBase.__init__(self, client)
+
+        if new:
+            self.client.send("newDataVector()")
+            self.handle = self.client.send("endEdit()")
+            self.handle.remove(0, self.handle.indexOf("ing ")+4)
+            self.change(filename, field, start, num_frames, skip, boxcarFirst)
+        else:
+            self.handle = name
+
+[docs]    def change(self, filename, field, start, num_frames, skip, boxcarFirst):
+        """ Change the parameters of a data vector.
+
+        :param filename: The name of the file/data source to read the scalar from.
+        :param field: the name of the vector in the data source.
+        :param start: The starting index of the vector.
+                      start = -1 for count from end.
+        :param num_frames: The number of frames to read.
+                        num_frames = -1 for read to end.
+        :param skip: The number of frames per sample read.
+                    skip = 0 to read every sample.
+        :param boxcarFirst: apply a boxcar filter before skiping.
+
+        """
+        self.client.send_si(self.handle, "change("+filename+","+field+","
+                            +b2str(start)+","+b2str(num_frames)+","+b2str(skip)
+                            +","+b2str(boxcarFirst)+")")
+
+[docs]    def change_frames(self, start, num_frames, skip, boxcarFirst):
+        """ Change the parameters of a data vector.
+
+        :param start: The starting index of the vector.
+                      start = -1 for count from end.
+        :param num_frames: The number of frames to read.
+                        num_frames = -1 for read to end.
+        :param skip: The number of frames per sample read.
+                    skip = 0 to read every sample.
+        :param boxcarFirst: apply a boxcar filter before skiping.
+
+        """
+        self.client.send_si(self.handle, "changeFrames("
+                            +b2str(start)+","+b2str(num_frames)+","+b2str(skip)
+                            +","+b2str(boxcarFirst)+")")
+
+[docs]    def field(self):
+        """  Returns the fieldname. """
+        return self.client.send_si(self.handle, "field()")
+
+[docs]    def filename(self):
+        """  Returns the filename. """
+        return self.client.send_si(self.handle, "filename()")
+
+[docs]    def start(self):
+        """  Returns the index of first frame in the vector.
+        -1 means count from end. """
+        return self.client.send_si(self.handle, "start()")
+
+[docs]    def n_frames(self):
+        """  Returns the number of frames to be read. -1 means read to end. """
+        return self.client.send_si(self.handle, "NFrames()")
+
+[docs]    def skip(self):
+        """  Returns number of frames to be skipped between samples read. """
+        return self.client.send_si(self.handle, "skip()")
+
+[docs]    def boxcar_first(self):
+        """  True if boxcar filtering has been applied before skipping. """
+        return self.client.send_si(self.handle, "boxcarFirst()")

[docs]class GeneratedVector(VectorBase): - """ Create a generated vector in kst. - - This class represents a vector you would create via - "Create>Vector>Generate" from the menubar inside kst. - - :param x0: The first value in the vector. - :param x1: The last value in the vector. - :param n: The number of evenly spaced values in the vector. - - To create the vector {0, 0.2, 0.4, 0.6, 0.8, 1.0}:: - - import pykst as kst - client = kst.Client() - v = client.new_generated_vector(0, 1, 6) - - """ - def __init__(self, client, x0=0, x1=1, n=100, name="", new=True) : - VectorBase.__init__(self,client) - - if new: - self.client.send("newGeneratedVector()") - self.handle=self.client.send("endEdit()") - self.handle.remove(0,self.handle.indexOf("ing ")+4) - - self.change(x0, x1, n) - self.set_name(name) - else: - self.handle = name - -

[docs] def change(self,x0, x1, n): - """ Change the parameters of a Generated Vector inside kst. - + """ Create a generated vector in kst. + + This class represents a vector you would create via + "Create>Vector>Generate" from the menubar inside kst. + :param x0: The first value in the vector. :param x1: The last value in the vector. :param n: The number of evenly spaced values in the vector. + + To create the vector {0, 0.2, 0.4, 0.6, 0.8, 1.0}:: + + import pykst as kst + client = kst.Client() + v = client.new_generated_vector(0, 1, 6) + """ - self.client.send_si(self.handle, "change("+b2str(x0)+","+b2str(x1)+ - ","+b2str(n)+")")

+ def __init__(self, client, x0=0, x1=1, n=100, name="", new=True): + VectorBase.__init__(self, client) + + if new: + self.client.send("newGeneratedVector()") + self.handle = self.client.send("endEdit()") + self.handle.remove(0, self.handle.indexOf("ing ")+4) + + self.change(x0, x1, n) + self.set_name(name) + else: + self.handle = name + +

[docs] def change(self, x0, x1, n): + """ Change the parameters of a Generated Vector inside kst. + + :param x0: The first value in the vector. + :param x1: The last value in the vector. + :param n: The number of evenly spaced values in the vector. + """ + self.client.send_si(self.handle, "change("+b2str(x0)+","+b2str(x1)+ + ","+b2str(n)+")")

PyKst documentation¶

PyKst is a python interface to kst. With PyKst, scripts can control and share data with a kst session.

Installation¶

You will want the version of pykst.py that goes with your version of kst2. Until packaging (and the API) are settled, this may mean compiling kst2 from source.

pykst.py can use either PySide or PyQT4. Make sure one is installed, and edit the begining of pykst.py accordingly (make sure the one you want to use is enabled, and the other is commented out.)

Then run setup.py to install things properly. In linux this is:

sudo python2.7 setup.py install
 

PyKst depends on python2.7 or greater, and modern versions of NumPy and SciPy.

Examples¶

PyKst can be used control kst, as one would with the GUI. The following (minimal) example tells kst to plot sin(x) from -10 to 10. The results are identical to having used create->equation from within kst:

import pykst as kst
 
 # start a kst session with the arbitrary name "TestSinX"
 client=kst.Client("TestSinX")
 
 # inside kst, create the x vector and the equation
 v1 = client.new_generated_vector(-10, 10, 1000)
 e1 = client.new_equation(v1, "sin(x)")
 
 # inside kst, create a curve, a plot, and add the curve to the plot
 c1 = client.new_curve(e1.x(), e1.y())
 p1 = client.new_plot()
 p1.add(c1)
 

kst can be also be used to plot numpy arrays, as in this example:

#!/usr/bin/python2.7
 import pykst as kst
 import numpy as np
 
 # create a pair of numpy arrays
 x = np.linspace( -10, 10, 1000)
 y = np.sin(x)
 
 # start a kst session with the arbitrary name "NumpyVector"
 client=kst.Client("NumpyVector")
 
 # copy the numpy arrays into kst
 V1 = client.new_editable_vector(x, name="X") # the name is for the label
 V2 = client.new_editable_vector(y, name="sin(X)") # the name is for the label
 
 # inside kst, create a curve, a plot, and add the curve to the plot
 c1 = client.new_curve(V1, V2)
 p1 = client.new_plot()
 p1.add(c1)
 

Alternativly, one can use a (tiny) subset of matplotlib.pyplot called pykstplot. This interface is conceptually incompatible with the native interface, and is described at the end of this document. As an example:

#!/usr/bin/python2.7
 import pykstplot as plt
 #import matplotlib.pyplot as plt
 import numpy as np
 
 x = np.linspace( -10, 10, 100)
 y = np.sin(x)
 z = np.cos(x)
 
 plt.subplot(221)
 plt.plot(x,y*y, linewidth=2, color = "green", linestyle="-.", label="greenline")
 plt.subplot(122)
 plt.plot(x,y,"k.")
 plt.subplot(223)
 plt.plot(x,z,"m*", markersize=6, color="blue")
 plt.subplot(221, axisbg="lightblue")
 plt.plot(x,z)
 plt.xlabel("X axis")
 plt.ylabel("Y axis")
 plt.title("Title")
 
 plt.figure()
 plt.plot([1,3,7,15])
 
 plt.show()
 
 #plt.savefig("pltdemo.eps")
 

“

Clients¶

-class pykst.Client(server_name='kstScript')[source]¶

class pykst.Client(server_name='')[source]¶

An interface to a running kst session.

A client provides a connection to a running kst session. The constructor creates a connection to either a running kst session with name <server_name>, or if none exists, a new one. -If server_name is not specified, it creates a connection to either the -kst session with the name kstScript, or if none exists, a new one.

+If server_name is not specified, it creates a connection with an +unnamed kst session, or if none exists, a new unnamed session.

The Client provides functions which effect the entire kst session, provides convenience functions to create objects within kst (eg, client.new_generated_vector(0, 1, 6)), and provides convenience functions to access objects already within kst (eg, client.vector("V2"). This is the suggested method.

Alternatively, the constructor for every class inside pykst accepts an instance of Client which it uses to interact with a kst session.

To connect to a kst session named kstSession (starting kst if necessary):

import pykst as kst
 client = kst.Client("kstSession")
 

SVG(name)[source]¶

Returns a SVG from kst given its name.

See SVG

arrow(name)[source]¶

Returns an Arrow from kst given its name.

See Arrow

box(name)[source]¶

Returns a Box from kst given its name.

See Box

circle(name)[source]¶

Returns a Circle from kst given its name.

See Circle

cleanup_layout(columns='Auto')[source]¶

Cleanup layout in the current tab.

If columns is not set, use auto-layout.

clear()[source]¶

Clears all objects from kst.

Equivalent to file->close from the menubar inside kst.

count_from_end()[source]¶: Equivalent to “Range>Count From End” from the menubar inside kst.

curve(name)[source]¶

Returns a Curve from kst given its name.

See Curve

data_matrix(name)[source]¶

Returns a DataMatrix from kst given its name.

See DataMatrix

data_vector(name)[source]¶

Returns a DataVector from kst given its name.

See DataVector

datasource_scalar(name)[source]¶

Returns a DataSource Scalar from kst given its name.

See DataSourceScalar

datasource_string(name)[source]¶

Returns a datasource string from kst given its name.

See DataSourceString

editable_matrix(name)[source]¶

Returns an Editable Matrix from kst given its name.

See EditableMatrix

editable_vector(name)[source]¶

Returns an Editable Vector from kst given its name.

See EditableVector

ellipse(name)[source]¶

Returns an ellipse from kst given its name.

See Ellipse

equation(name)[source]¶

Returns an Equation from kst given its name.

See Equation

-export_graphics_file(filename, format=None, width=1280, height=1024, display=2, all_tabs=False, autosave_period=0)[source]¶

export_graphics_file(filenamegraphics_format=Nonewidth=1280height=1024display=2all_tabs=Falseautosave_period=0)[source]¶

export the kst session as a set of graphics files.

Parameters:

Parameters:	filename – the name of the file to be saved - format – the format to be used. if None, the format is determined from the filename extension. + graphics_format – the format to be used. if None, the format is determined from +the filename extension. width – width of the plot, in pixels, if required by the display setting. height – the height of the plot, in pixels, if required by the display setting. display – how the dimensions are interpreted. all_tabs – if True, all tabs are exported as <filename>_<tabname>.<ext> - autosave_period – save the image every <autosave_period> seconds. If 0, only save once. + autosave_period – save the image every <autosave_period> seconds. +If 0, only save once.

filename – the name of the file to be saved
format – the format to be used. if None, the format is determined from the filename extension.
graphics_format – the format to be used. if None, the format is determined from +the filename extension.
width – width of the plot, in pixels, if required by the display setting.
height – the height of the plot, in pixels, if required by the display setting.
display – how the dimensions are interpreted.
all_tabs – if True, all tabs are exported as <filename>_<tabname>.<ext>
autosave_period – save the image every <autosave_period> seconds. If 0, only save once.
autosave_period – save the image every <autosave_period> seconds. +If 0, only save once.

display determines the shape of the plot. Values are

 Width set by user, maintain aspect ratio
 Height set by user, maintain aspect ratio
 Width and Height set by user.
 a Width x Width square plot.
 

flag_filter(name)[source]¶

Returns a flag_filter from kst given its name.

See FlagFilter

generated_scalar(name)[source]¶

Returns a Generated Scalar from kst given its name.

See GeneratedScalar

generated_string(name)[source]¶

Returns a generated string from kst given its name.

See GeneratedString

generated_vector(name)[source]¶

Returns a GeneratedVector from kst given its name.

See GeneratedVector

get_SVG_list()[source]¶

Get a list of all SVGs in kst.

See SVG

get_arrow_list()[source]¶

Get a list of all arrows in kst.

See Arrow

get_box_list()[source]¶

Get a list of all boxes in kst.

See Box

get_circle_list()[source]¶

Get a list of all ciircles in kst.

See Circle

get_data_vector_list()[source]¶: returns data vectors from kst.

get_editable_vector_list()[source]¶: returns editable vectors from kst.

get_ellipse_list()[source]¶

Get a list of all ellipse in kst.

See Ellipse

get_generated_vector_list()[source]¶: returns generated vectors from kst.

get_label_list()[source]¶

Get a list of all labels in kst.

See Label

get_legend_list()[source]¶

Get a list of all legends in kst.

See Legend

get_line_list()[source]¶

Get a list of all lines in kst.

See Line

get_matrix_list()[source]¶: returns matrixes from kst.

get_picture_list()[source]¶

Get a list of all pictures in kst.

See Picture

get_plot_list()[source]¶

Get a list of all plots in kst.

See Plot

get_scalar_list()[source]¶: returns the scalar names from kst

get_vector_list()[source]¶: returns vectors from kst.

hide_window()[source]¶

Hide the kst window.

pyKst operations which effect the display are far faster when the window is hidden.

Restore with show_window() or maximize_window().

histogram(name)[source]¶

Returns a histogram from kst given its name.

See Histogram

image(name)[source]¶

Returns an Image from kst given its name.

See Image

label(name)[source]¶

Returns a Label from kst given its name.

See Label

legend(name)[source]¶

Returns a Legend from kst given its name.

See Legend

line(name)[source]¶

Returns a Line from kst given its name.

See Line

linear_fit(name)[source]¶

Returns a linear fit from kst given its name.

See LinearFit

maximize_window()[source]¶: Maximize the kst window.

minimize_window()[source]¶: Minimize the kst window.

new_SVG(filename, pos=(0.1, 0.1), width=0.1, rot=0, name='')[source]¶

Create a New SVG in kst.

See SVG

new_arrow(start=(0, 0), end=(1, 1), arror_at_start=False, arrow_at_end=True, arrow_size=12.0, stroke_style=1, stroke_width=1, stroke_brush_color='black', stroke_brush_style=1, stroke_cap_style=1, name='')[source]¶

Create a New Arrow in kst.

See Arrow

-new_box(pos=(0.1, 0.1), size=(0.1, 0.1), rot=0, fill_color='white', fill_style=1, stroke_style=1, stroke_width=1, stroke_brush_color='black', stroke_brush_style=1, strokeJoinStyle=1, stroke_cap_style=1, fix_aspect=False, name='')[source]¶

new_box(pos=(0.10.1)size=(0.10.1)rot=0fill_color='white'fill_style=1stroke_style=1stroke_width=1stroke_brush_color='black'stroke_brush_style=1stroke_join_style=1stroke_cap_style=1fix_aspect=Falsename='')[source]¶

Create a New Box in kst.

See Box

new_circle(pos=(0.1, 0.1), diameter=0.1, fill_color='white', fill_style=1, stroke_style=1, stroke_width=1, stroke_brush_color='grey', stroke_brush_style=1, name='')[source]¶

Create a New Circle in kst.

See Circle

new_cross_spectrum(V1, V2, fft_size=10, sample_rate=1.0, name='')[source]¶

Create a cross spectrum object in kst.

See CrossSpectrum

new_curve(x_vector, y_vector, name='')[source]¶

Create a New Curve in kst.

See Curve

new_data_matrix(filename, field, start_x=0, start_y=0, num_x=-1, num_y=-1, min_x=0, min_y=0, dx=1, dy=1, name='')[source]¶

Create a New DataMatrix in kst.

See DataMatrix

new_data_vector(filename, field, start=0, num_frames=-1, skip=0, boxcarFirst=False, name='')[source]¶

Create a New DataVector in kst.

See DataVector

new_datasource_scalar(filename, field, name='')[source]¶

Create a New DataSource Scalar in kst.

See DataSourceScalar

new_datasource_string(filename, field, name='')[source]¶

Create a New Data Source String in kst.

See DataSourceString

new_editable_matrix(np_array=None, name='')[source]¶

Create a New Editable Matrix in kst.

See EditableMatrix

new_editable_vector(np_array=None, name='')[source]¶

Create a New Editable Vector in kst.

See EditableVector

new_ellipse(pos=(0.1, 0.1), size=(0.1, 0.1), rot=0, fill_color='white', fill_style=1, stroke_style=1, stroke_width=1, stroke_brush_color='black', stroke_brush_style=1, fix_aspect=False, name='')[source]¶

Create a New Ellipse in kst.

See Ellipse

new_equation(x_vector, equation, interpolate=True, name='')[source]¶

Create a new Equation in kst.

See Equation

new_flag_filter(y_vector, flag, mask='0xffffff', valid_is_zero=True, name='')[source]¶

Create a flag filter inside kst.

See FlagFilter

new_generated_scalar(value, name='')[source]¶

Create a New Generated Scalar in kst.

See GeneratedScalar

new_generated_string(string, name='')[source]¶

Create a new generated string in kst.

See GeneratedString

new_generated_vector(x0, x1, n, name='')[source]¶

Create a New GeneratedVector in kst.

See GeneratedVector

new_histogram(vector, bin_min=0, bin_max=1, num_bins=60, normalization=0, auto_bin=True, name='')[source]¶

Create a new histogram in kst.

See Histogram

new_image(matrix, name='')[source]¶

Create a new Image in kst.

See Image

new_label(text, pos=(0.5, 0.5), rot=0, font_size=12, bold=False, italic=False, font_color='black', font_family='Serif', name='')[source]¶

Create a New Label in kst.

See Label

new_legend(plot, name='')[source]¶

Create a new Legend in a plot in kst.

See :class:’Legend’

new_line(start=(0, 0), end=(1, 1), stroke_style=1, stroke_width=1, stroke_brush_color='black', stroke_brush_style=1, stroke_cap_style=1, name='')[source]¶

Create a New Line in kst.

See Line

new_linear_fit(x_vector, y_vector, weightvector=0, name='')[source]¶

Create a New Linear Fit in kst.

See LinearFit

new_picture(filename, pos=(0.1, 0.1), width=0.1, rot=0, name='')[source]¶

Create a New Picture in kst.

See Picture

-new_plot(pos=(0.1, 0.1), size=(0, 0), rot=0, font_size=0, columns=0, fill_color='white', fill_style=1, stroke_style=1, stroke_width=1, stroke_brush_color='black', stroke_brush_style=1, strokeJoinStyle=1, stroke_cap_style=1, fix_aspect=False, auto_position=True, name='')[source]¶

new_plot(pos=(0.10.1)size=(00)rot=0font_size=0columns=0fill_color='white'fill_style=1stroke_style=1stroke_width=1stroke_brush_color='black'stroke_brush_style=1stroke_join_style=1stroke_cap_style=1fix_aspect=Falseauto_position=Truename='')[source]¶

Create a New Plot in kst.

See Plot

new_polynomial_fit(order, x_vector, y_vector, weightvector=0, name='')[source]¶

Create a New Polynomial Fit in kst.

See PolynomialFit

new_spectrum(vector, sample_rate=1.0, interleaved_average=False, fft_length=10, apodize=True, remove_mean=True, vector_units='', rate_units='Hz', apodize_function=0, sigma=1.0, output_type=0, name='')[source]¶

Create a new Spectrum in kst.

See Spectrum

new_sum_filter(y_vector, step_dX, name='')[source]¶

Create a cumulative sum filter inside kst.

See SumFilter

new_tab()[source]¶: Create a new tab in the current document and switch to it.

new_vector_scalar(filename, field, frame=-1, name='')[source]¶

Create a New VectorScalar in kst.

See VectorScalar

open_kst_file(filename)[source]¶: open a .kst file in kst.

picture(name)[source]¶

Returns a Picture from kst given its name.

See Picture

plot(name)[source]¶

Returns a Plot from kst given its name.

See Plot

polynomial_fit(name)[source]¶

Returns a polynomial fit from kst given its name.

See PolynomialFit

quit()[source]¶

Tell the kst window to terminate

After this, client will no longer be valid.

read_to_end()[source]¶: Equivalent to “Range>Read To End” from the menubar inside kst.

save_kst_file(filename)[source]¶: save a .kst file in kst.

screen_back()[source]¶: Equivalent to “Range>Back One Screen” from the menubar inside kst.

screen_forward()[source]¶: Equivalent to “Range>Forward One Screen” from the menubar inside kst.

set_datasource_option(option, value, filename, data_source='Ascii File')[source]¶

Sets the value of a data source configuration option.

Parameters:	option – the name of the option - eg “”Data Start” value – True or False filename – the name of the file or 0 to set global default data_source – the type of data source

Examples:

Tell kst that trial1.csv is a file with the field names in row 1 and units in row 2:

import pykst as kst
 client = kst.Client()
 client.set_datasource_option("Column Delimiter", ",", "trial1.csv")
 client.set_datasource_option("Column Type", 2, "trial1.csv")
 client.set_datasource_option("Data Start", 3-1, "trial1.csv")
 client.set_datasource_option("Fields Line", 1-1, "trial1.csv")
 client.set_datasource_option("Read Fields", True, "trial1.csv")
 client.set_datasource_option("Units Line", 2-1, "trial1.csv")
 client.set_datasource_option("Read Units", True, "trial1.csv")
 

Configuration options supported by the ASCII data source (default) are:

"ASCII Time format"
 "Column Delimiter"
 "Column Type"
 "Column Width"
 "Column Width is const"
 "Comment Delimiters"
 "Data Rate for index"
 "Data Start"
 "Default INDEX Interpretation"
 "Fields Line"
 "Filename Pattern"
 "Index"
 "Limit file buffer size"
 "NaN value"
 "Read Fields"
 "Read Units"
 "Size of limited file buffer"
 "Units Line"
 "Use Dot"
 "Use threads when parsing Ascii data"
 "date/time offset"
 "relative offset"
 "updateType"
 "use an explicit date/time offset"
 "use file time/date as offset"
 "use relative file time offset"
 

set_paused()[source]¶: Equivalent to checking “Range>Pause” from the menubar inside kst.

set_tab(tab)[source]¶

Set the index of the current tab.

tab must be greater or equal to 0 and less than tabCount().

set_tab_text(new_name)[source]¶: Set the text of the current tab.

show_window()[source]¶: unminimize and show the kst window.

spectrum(name)[source]¶

Returns a spectrum from kst given its name.

See Spectrum

tab_count()[source]¶: Get the number of tabs open in the current document.

unset_paused()[source]¶: Equivalent to unchecking “Range>Pause” from the menubar inside kst.

vector_scalar(name)[source]¶

Returns a VectorScalar from kst given its name.

See VectorScalar

Primitives¶

Scalars, Vectors, Matrices, and Strings (Primitives) can be used in your scripts to share data with kst. All methods are pass-by-value: for example, if you get a value of a scalar and change it, the data inside kst is not changed. You need to explicitly call setValue().

Scalars¶

class pykst.DataSourceScalar(client, filename, field, name='', new=True)[source]¶

A scalar read from a data source inside kst.

This class represents a scalar you would create via +

This class represents a scalar you would create via “Create>Scalar>Read from Data Source” from the menubar inside kst.

Parameters:	filename – The name of the file/data source to read the scalar from. field – the name of the field in the data source.

To read “CONST1” from the data source “tmp.dat” into kst:

import pykst as kst
 client = kst.Client()
 x = client.new_datasource_scalar("tmp.dat", "CONST1")
 

change(filename, field)[source]¶

Change a DataSource Scalar.

Change the file and field of a DataSourceScalar in kst.

Parameters:	filename – The name of the file/data source to read the scalar from. field – the name of the field in the data source.

description_tip()¶: Returns a string describing the object

field()[source]¶: Returns the field.

file()[source]¶: Returns the data source file name.

name()¶: Returns the name of the object from inside kst.

set_name(name)¶: Set the name of the object inside kst.

type_str()¶: Returns the type of the object from inside kst.

value()¶: Returns the scalar.

class pykst.VectorScalar(client, filename, field, frame=-1, name='', new=True)[source]¶

A scalar in kst read from a vector from a data source.

This class represents a scalar you would create via +

This class represents a scalar you would create via “Create>Scalar>Read from vector” from the menubar inside kst.

Parameters:	filename – The name of the file/data source to read the scalar from. field – the name of the vector in the data source. - frame – which frame of the vector to read the scalar from. + frame – which frame of the vector to read the scalar from. frame = -1 (the default) reads from the end of the file.

To read the last value of the vector INDEX from the file “tmp.dat” into kst:

import pykst as kst
 client = kst.Client()
 x = client.new_vector_scalar("tmp.dat", "INDEX", -1)
 

change(filename, field, frame)[source]¶

Change a Vector Scalar in kst.

Change the file, field and frame of a VectorScalar in kst.

Parameters:	filename – The name of the file/data source to read the scalar from. field – the name of the vector in the data source. - frame – which frame of the vector to read the scalar from. + frame – which frame of the vector to read the scalar from. frame = -1 reads from the end of the file.

description_tip()¶: Returns a string describing the object

field()[source]¶: Returns the field.

file()[source]¶: Returns the data source file name.

frame()[source]¶: Returns the fame.

name()¶: Returns the name of the object from inside kst.

set_name(name)¶: Set the name of the object inside kst.

type_str()¶: Returns the type of the object from inside kst.

value()¶: Returns the scalar.

class pykst.GeneratedScalar(client, value, name='', new=True)[source]¶

A scalar constant inside kst.

This class represents a scalar you would create via +

This class represents a scalar you would create via “Create>Scalar>Generate” from the menubar inside kst.

Parameters:	value – the value to assign to the scalar constant.

To import the scalar of value 42 into kst:

import pykst as kst
 client = kst.Client()
 s = client.new_generated_scalar(42)
 

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

set_name(name)¶: Set the name of the object inside kst.

set_value(val)[source]¶: set the value of the string inside kst.

type_str()¶: Returns the type of the object from inside kst.

value()¶: Returns the scalar.

Vectors¶

class pykst.DataVector(client, filename, field, start=0, num_frames=-1, skip=0, boxcarFirst=False, name='', new=True)[source]¶

A vector in kst, read from a data source.

This class represents a vector you would create via +

This class represents a vector you would create via “Create>Vector>Read from Data Source” from the menubar inside kst.

The parameters of this function mirror the parameters within +

The parameters of this function mirror the parameters within “Create>Vector>Read from Data Source”.

Parameters:

Parameters:	filename – The name of the file/data source to read the scalar from. field – the name of the vector in the data source. - start – The starting index of the vector. + start – The starting index of the vector. start = -1 for count from end. - num_frames – The number of frames to read. + num_frames – The number of frames to read. num_frames = -1 for read to end. - skip – The number of frames per sample read. + skip – The number of frames per sample read. skip = 0 to read every sample. boxcarFirst – apply a boxcar filter before skiping.

filename – The name of the file/data source to read the scalar from.
field – the name of the vector in the data source.
start – The starting index of the vector. +
start – The starting index of the vector. start = -1 for count from end.
num_frames – The number of frames to read. +
num_frames – The number of frames to read. num_frames = -1 for read to end.
skip – The number of frames per sample read. +
skip – The number of frames per sample read. skip = 0 to read every sample.
boxcarFirst – apply a boxcar filter before skiping.

To create a vector from “tmp.dat” with field “INDEX” from -frame 3 to frame 10, reading a sample every other frame without +

To create a vector from “tmp.dat” with field “INDEX” from +frame 3 to frame 10, reading a sample every other frame without a boxcar filter:

import pykst as kst
 client = kst.Client()
-v = client.new_data_vector("tmp.dat", "INDEX", 3, 10, 2, False) 
+v = client.new_data_vector("tmp.dat", "INDEX", 3, 10, 2, False)
 

boxcar_first()[source]¶: True if boxcar filtering has been applied before skipping.

change(filename, field, start, num_frames, skip, boxcarFirst)[source]¶

Change the parameters of a data vector.

Parameters:

Parameters:	filename – The name of the file/data source to read the scalar from. field – the name of the vector in the data source. - start – The starting index of the vector. + start – The starting index of the vector. start = -1 for count from end. - num_frames – The number of frames to read. + num_frames – The number of frames to read. num_frames = -1 for read to end. - skip – The number of frames per sample read. + skip – The number of frames per sample read. skip = 0 to read every sample. boxcarFirst – apply a boxcar filter before skiping.

filename – The name of the file/data source to read the scalar from.
field – the name of the vector in the data source.
start – The starting index of the vector. +
start – The starting index of the vector. start = -1 for count from end.
num_frames – The number of frames to read. +
num_frames – The number of frames to read. num_frames = -1 for read to end.
skip – The number of frames per sample read. +
skip – The number of frames per sample read. skip = 0 to read every sample.
boxcarFirst – apply a boxcar filter before skiping.

change_frames(start, num_frames, skip, boxcarFirst)[source]¶

Change the parameters of a data vector.

Parameters:	start – The starting index of the vector. start = -1 for count from end. num_frames – The number of frames to read. num_frames = -1 for read to end. skip – The number of frames per sample read. skip = 0 to read every sample. boxcarFirst – apply a boxcar filter before skiping.

description_tip()¶: Returns a string describing the object

field()[source]¶: Returns the fieldname.

filename()[source]¶: Returns the filename.

get_numpy_array()¶: get a numpy array which contains the kst vector values

length()¶: Returns the number of samples in the vector.

max()¶: Returns the maximum value in the vector.

mean()¶: Returns the mean of the vector.

min()¶: Returns the minimum value in the vector.

n_frames()[source]¶: Returns the number of frames to be read. -1 means read to end.

name()¶: Returns the name of the object from inside kst.

set_name(name)¶: Set the name of the object inside kst.

skip()[source]¶: Returns number of frames to be skipped between samples read.

start()[source]¶: Returns the index of first frame in the vector. +; Returns the index of first frame in the vector. -1 means count from end.

type_str()¶: Returns the type of the object from inside kst.

value(index)¶: Returns element i of this vector.

class pykst.GeneratedVector(client, x0=0, x1=1, n=100, name='', new=True)[source]¶

Create a generated vector in kst.

This class represents a vector you would create via +

This class represents a vector you would create via “Create>Vector>Generate” from the menubar inside kst.

Parameters:	x0 – The first value in the vector. x1 – The last value in the vector. n – The number of evenly spaced values in the vector.

To create the vector {0, 0.2, 0.4, 0.6, 0.8, 1.0}:

import pykst as kst
 client = kst.Client()
-v = client.new_generated_vector(0, 1, 6) 
+v = client.new_generated_vector(0, 1, 6)
 

change(x0, x1, n)[source]¶

Change the parameters of a Generated Vector inside kst.

Parameters:	x0 – The first value in the vector. x1 – The last value in the vector. n – The number of evenly spaced values in the vector.

description_tip()¶: Returns a string describing the object

get_numpy_array()¶: get a numpy array which contains the kst vector values

length()¶: Returns the number of samples in the vector.

max()¶: Returns the maximum value in the vector.

mean()¶: Returns the mean of the vector.

min()¶: Returns the minimum value in the vector.

name()¶: Returns the name of the object from inside kst.

set_name(name)¶: Set the name of the object inside kst.

type_str()¶: Returns the type of the object from inside kst.

value(index)¶: Returns element i of this vector.

class pykst.EditableVector(client, np_array=None, name='', new=True)[source]¶

A vector in kst, which is editable from python.

This vector in kst can be created from a numpy array, (with ‘’load()’‘) or edited point by point (with ‘’setValue()’‘). “Create>Vector>Generate” from the menubar inside kst.

Parameters:	np_array – initialize the vector in kst to this (optional) 1D numpy array.

To create a from the num py array np:

import pykst as kst
 client = kst.Client()
 v = client.new_editable_vector(np)
 

description_tip()¶: Returns a string describing the object

get_numpy_array()¶: get a numpy array which contains the kst vector values

length()¶: Returns the number of samples in the vector.

load(np_array)[source]¶: sets the value of the vector to that of the float64 1D np array

max()¶: Returns the maximum value in the vector.

mean()¶: Returns the mean of the vector.

min()¶: Returns the minimum value in the vector.

name()¶: Returns the name of the object from inside kst.

set_name(name)¶: Set the name of the object inside kst.

type_str()¶: Returns the type of the object from inside kst.

value(index)¶: Returns element i of this vector.

Matrices¶

class pykst.DataMatrix(client, filename, field, start_x=0, start_y=0, num_x=-1, num_y=-1, min_x=0, min_y=0, dx=1, dy=1, name='', new=True)[source]¶

Create a Data Matrix which reads from a data source inside kst.

This class represents a matrix you would create via +

This class represents a matrix you would create via “Create>Vector>Read from Data Source” from the menubar inside kst. -The parameters of this function mirror the parameters within +The parameters of this function mirror the parameters within “Create>Matrix>Read from Data Source”.

Parameters:

Parameters:	filename – The name of the file/data source to read the scalar from. field – the name of the vector in the data source. - start_x/start_y – the x/y index to start reading from. start_x/Y = -1 + start_x/start_y – the x/y index to start reading from. start_x/Y = -1 to count from the right/bottom. num_x/num_y – the number of columns/rows to read. num_x/Y = -1 to read to the end. min_x/min_y – Hint to Images of the coordinates corresponding to the the left/bottom of the Matrix dx/dy – Hint to Images of the spacing between points.

filename – The name of the file/data source to read the scalar from.
field – the name of the vector in the data source.
start_x/start_y – the x/y index to start reading from. start_x/Y = -1 +
start_x/start_y – the x/y index to start reading from. start_x/Y = -1 to count from the right/bottom.
num_x/num_y – the number of columns/rows to read. num_x/Y = -1 to read to the end.
min_x/min_y – Hint to Images of the coordinates corresponding to the the left/bottom of the Matrix
dx/dy – Hint to Images of the spacing between points.

To create a matrix from ‘foo.png’ with field ‘1’:

import pykst as kst
 client = kst.Client()
-v = client.new_data_matrix("foo.png", "1") 
+v = client.new_data_matrix("foo.png", "1")
 

change(filename, field, start_x=0, start_y=0, num_x=-1, num_y=-1, min_x=0, min_y=0, dx=1, dy=1)[source]¶

Change the parameters if a Data Matrix inside kst.

Parameters:

Parameters:	filename – The name of the file/data source to read the scalar from. field – the name of the vector in the data source. - start_x/start_y – the x/y index to start reading from. start_x/y = -1 + start_x/start_y – the x/y index to start reading from. start_x/y = -1 to count from the right/bottom. num_x/num_y – the number of columns/rows to read. num_x/Y = -1 to read to the end. min_x/min_y – Hint to Images of the coordinates corresponding to the the left/bottom of the Matrix dx/dy – Hint to Images of the spacing between points.

filename – The name of the file/data source to read the scalar from.
field – the name of the vector in the data source.
start_x/start_y – the x/y index to start reading from. start_x/y = -1 +
start_x/start_y – the x/y index to start reading from. start_x/y = -1 to count from the right/bottom.
num_x/num_y – the number of columns/rows to read. num_x/Y = -1 to read to the end.
min_x/min_y – Hint to Images of the coordinates corresponding to the the left/bottom of the Matrix
dx/dy – Hint to Images of the spacing between points.

description_tip()¶: Returns a string describing the object

dx()¶: Returns the X spacing of the matrix, for when the matrix is used in an image.

dy()¶: Returns the Y spacing of the matrix, for when the matrix is used in an image.

field()[source]¶: Returns the fieldname.

filename()[source]¶: Returns the filename.

get_numpy_array()¶: get a numpy array which contains the kst matrix values

height()¶: Returns the Y dimension of the matrix.

length()¶: Returns the number of elements in the matrix.

max()¶: Returns the maximum value in the matrix.

mean()¶: Returns the mean of the matrix.

min()¶: Returns the minimum value in the matrix.

min_x()¶: Returns the minimum X location of the matrix, for when the matrix is used in an image.
+; Returns the minimum X location of the matrix, for when the matrix +is used in an image.

min_y()¶: Returns the minimum X location of the matrix, for when the matrix is used in an image.
+; Returns the minimum X location of the matrix, for when the matrix +is used in an image.

name()¶: Returns the name of the object from inside kst.

set_name(name)¶: Set the name of the object inside kst.

start_x()[source]¶: Returns the X index of the matrix in the file

start_y()[source]¶: Returns the Y index of the matrix in the file

type_str()¶: Returns the type of the object from inside kst.

value(i_x, i_y)¶: Returns element (i_x, i_y} of this matrix.

width()¶: Returns the X dimension of the matrix.

Strings¶

class pykst.DataSourceString(client, filename, field, name='', new=True)[source]¶

A string read from a data source inside kst.

This class represents a string you would create via +

This class represents a string you would create via “Create>String>Read from Data Source” from the menubar inside kst.

Parameters:	filename – The name of the file/data source to read the string from. field – the name of the field in the data source.

To read “File path” from the data source “tmp.dat” into kst:

import pykst as kst
 client = kst.Client()
 s = client.new_datasource_string("tmp.dat", "File Path")
 

change(filename, field)[source]¶

Change a DataSource String.

Change the file and field of a DataSourceString in kst.

Parameters:	filename – The name of the file/data source to read the string from. field – the name of the field in the data source.

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

set_name(name)¶: Set the name of the object inside kst.

type_str()¶: Returns the type of the object from inside kst.

value()¶: Returns the string.

class pykst.GeneratedString(client, string, name='', new=True)[source]¶

A string constant inside kst.

This class represents a string you would create via +

This class represents a string you would create via “Create>String>Generated” from the menubar inside kst.

Parameters:	string – The value of the string.

To import the string “Hello World” into kst:

import pykst as kst
 client = kst.Client()
 s = client.new_generatedString("Hello World")
 

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

set_name(name)¶: Set the name of the object inside kst.

set_value(val)[source]¶: set the value of the string inside kst.

type_str()¶: Returns the type of the object from inside kst.

value()¶: Returns the string.

Data Objects¶

Data Objects are objects which transform primitives into other primitives.

Equations¶

class pykst.Equation(client, xvector, equation, interpolate=True, name='', new=True)[source]¶

An equation inside kst.

Parameters:	xvector – the x vector of the equation equation – the equation

Vectors inside kst are refered to as [vectorname] or [scalarname].

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

set_equation(equation)[source]¶: set the equation of an existing equation

set_inpterpolate(interpolate)[source]¶: set whether all vectors are interpolated to the highest resolution vector.

set_name(name)¶: Set the name of the object inside kst.

set_x(xvector)[source]¶: set the x vector of an existing equation. xvector is a kst vector.

type_str()¶: Returns the type of the object from inside kst.

x()[source]¶: a vector containing the x vector

y()[source]¶: a vector containing the equation

Spectra¶

class pykst.Spectrum(client, vector, sample_rate=1.0, interleaved_average=False, fft_length=10, apodize=True, remove_mean=True, vector_units='', rate_units='Hz', apodize_function=0, sigma=1.0, output_type=0, name='', new=True)[source]¶

An spectrum inside kst.

Parameters:

Parameters:	vector – the vector to take the spectrum of sample_rate – the sample rate of the vector interleaved_average – average spectra of length fft_length fft_length – the fft is 2^fft_length long if interleaved_average is true. apodize – if true, apodize the vector first remove_mean – if true, remove mean first vector_unints – units of the input vector - for labels. rate_units – the units of the sample rate - for labels. apodize_function – index of the apodization function - see apodize_function() sigma – only used if gausian apodization is selected. output_type – index for the output type - see output_type()

vector – the vector to take the spectrum of
sample_rate – the sample rate of the vector
interleaved_average – average spectra of length fft_length
fft_length – the fft is 2^fft_length long if interleaved_average is true.
apodize – if true, apodize the vector first
remove_mean – if true, remove mean first
vector_unints – units of the input vector - for labels.
rate_units – the units of the sample rate - for labels.
apodize_function – index of the apodization function - see apodize_function()
sigma – only used if gausian apodization is selected.
output_type – index for the output type - see output_type()

The apodize function is:

default          1: Bartlett
Window           3: Connes
Cosine           5: Gaussian
Hamming          7: Hann
Welch            9: Uniform
 

The output type is:

Amplitude Spectral Density  1: Power Spectral Density
AmplitudeSpectrum           3: Power Spectrum
 

apodize()[source]¶: apodize before taking spectra, if set

apodize_function()[source]¶

the index of the apodize function.

The apodize funcition is:

default          1: Bartlett
Window           3: Connes
Cosine           5: Gaussian
Hamming          7: Hann
Welch            9: Uniform
 

description_tip()¶: Returns a string describing the object

fft_length()[source]¶: ffts are 2^fft_length() long if interleaved_average is set

gaussian_sigma()[source]¶: the width, if apodize_funcion_index() is 5 (gaussian).

interleaved_average()[source]¶: average spectra of length fft_length()

name()¶: Returns the name of the object from inside kst.

output_type()[source]¶

the index of the spectrum output type.

The output type is:

Amplitude Spectral Density  1: Power Spectral Density
AmplitudeSpectrum           3: Power Spectrum
 

rate_units()[source]¶: the units of the sample rate. For labels

remove_mean()[source]¶: remove mean before taking spectra, if set

sample_rate()[source]¶: the sample rate assumed for the spectra.

set_name(name)¶: Set the name of the object inside kst.

set_vector(xvector)[source]¶: set the input vector

type_str()¶: Returns the type of the object from inside kst.

vector_units()[source]¶: the units of the input vector. For labels

x()[source]¶: a vector containing the frequency bins

y()[source]¶: a vector containing the spectrum

Histograms¶

class pykst.Histogram(client, vector, bin_min, bin_max, num_bins, normalization=0, auto_bin=False, name='', new=True)[source]¶

A Histogram inside kst.

Parameters:	vector – the vector to take the histogram of bin_min – the low end of the lowest bin bin_max – the high end of the highest bin num_bins – the number of bins normalization – see below auto_bin – if True, set xmin and xmax based on the vector

The normalization types are:

Number in the bin     1: Percent in the bin
Fraction in the bin   3: Peak is normalized to 1.0
 

auto_bin()[source]¶: if True, xmin and xmax are set based on the vector

bin_max()[source]¶: the high end of the lowest bin

bin_min()[source]¶: the low end of the lowest bin

change(vector, bin_min, bin_max, num_bins, normalization=0, auto_bin=False)[source]¶

Change Histogram parameters.

Parameters:	vector – the vector to take the histogram of bin_min – the low end of the lowest bin bin_max – the high end of the highest bin num_bins – the number of bins normalization – See `Histogram` auto_bin – if True, set xmin and xmax based on the vector

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

normalization()[source]¶

how the bins are normalized

See Histogram

num_bins()[source]¶: the number of bins

set_name(name)¶: Set the name of the object inside kst.

type_str()¶: Returns the type of the object from inside kst.

x()[source]¶: a vector containing the bin centers

y()[source]¶: a vector containing the histogram values

Linear Fit¶

class pykst.LinearFit(client, xvector, yvector, weightvector=0, name='', new=True)[source]¶

A linear fit inside kst.

If weightvector is 0, then the fit is unweighted.

covariance()¶: a vector containing the Covariance of the fit

description_tip()¶: Returns a string describing the object

fit()¶: a vector containing the fit

intercept()[source]¶: The intercept of the fit.

name()¶: Returns the name of the object from inside kst.

parameters()¶: a vector containing the Parameters of the fit

reduced_chi2()¶: a scalar containing the Parameters of the fit

residuals()¶: a vector containing the Parameters of the fit

set_name(name)¶: Set the name of the object inside kst.

slope()[source]¶: The slope of the fit.

type_str()¶: Returns the type of the object from inside kst.

Polynomial Fit¶

class pykst.PolynomialFit(client, order, xvector, yvector, weightvector=0, name='', new=True)[source]¶

A Polynomial fit inside kst.

Parameters:	order – The order of the fit

covariance()¶: a vector containing the Covariance of the fit

description_tip()¶: Returns a string describing the object

fit()¶: a vector containing the fit

name()¶: Returns the name of the object from inside kst.

parameters()¶: a vector containing the Parameters of the fit

reduced_chi2()¶: a scalar containing the Parameters of the fit

residuals()¶: a vector containing the Parameters of the fit

set_name(name)¶: Set the name of the object inside kst.

type_str()¶: Returns the type of the object from inside kst.

Flag Filter¶

class pykst.FlagFilter(client, yvector, flag, mask='0xffffff', valid_is_zero=True, name='', new=True)[source]¶

a flagged vector inside kst

The output is the input when flag == 0, or NaN if flag is non-0.

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

output()¶: a vector containing the output of the filter

set_name(name)¶: Set the name of the object inside kst.

type_str()¶: Returns the type of the object from inside kst.

Relations¶

Relations are objects which can be added to a plot.

Curves¶

class pykst.Curve(client, x_vector, y_vector, name='', new=True)[source]¶

A Curve inside kst.

This class represents a string you would create via -“Create>Curve” from the menubar inside kst. The parameters of this +

This class represents a string you would create via +“Create>Curve” from the menubar inside kst. The parameters of this function mirror the parameters within “Create>Curve”.

Parameters:	x_vector – The vector which specifies the X coordinates of each point. x_vector – The vector which specifies the Y coordinates of each point.

Use the convenience function in client to create a curve in kst session +

Use the convenience function in client to create a curve in kst session “client” of vectors v1 and v2:

c1 = client.new_curve(v1, v2)
 

bar_fill_color()[source]¶: Returns the bar fill color.

color()[source]¶: Returns the curve color.

description_tip()¶: Returns a string describing the object

has_bars()[source]¶: Returns True if the line has historgram bars.

has_head()[source]¶: Returns True if the last point has a special marker.

has_lines()[source]¶: Returns True if the line has lines.

has_points()[source]¶: Returns True if the line has points.

head_color()[source]¶: Returns the curve head color.

head_type()[source]¶: Returns index of the head point type. See set_point_type.

line_style()[source]¶: Returns the index of the line style. See set_line_style.

line_width()[source]¶: Returns the width of the line.

max_x()¶: Returns the max X value of the curve or image.

max_y()¶: Returns the max Y value of the curve or image.

min_x()¶: Returns the min X value of the curve or image.

min_y()¶: Returns the min Y value of the curve or image.

name()¶: Returns the name of the object from inside kst.

point_density()[source]¶: Returns the density of points shown. see set_point_density.

point_size()[source]¶: Returns the size of the points.

point_type()[source]¶: Returns index of the point type. See set_point_type.

set_bar_fill_color(color)[source]¶

Set the fill color of the histogram bars, if any.

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

set_color(color)[source]¶

Set the color of the points and lines.

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

set_has_bars(has=True)[source]¶: Set whether histogram bars are drawn.

set_has_head(has=True)[source]¶: Set whether a point at the head of the line is drawn

set_has_lines(has=True)[source]¶: Set whether lines are drawn.

set_has_points(has=True)[source]¶: Set whether individual points are drawn on the curve

set_head_color(color)[source]¶

Set the color of the Head marker, if any.

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

set_head_type(x)[source]¶: Sets the head point type. See set_point_type for details.

set_line_style(lineStyle)[source]¶

Sets the line type.

0 is SolidLine, 1 is DashLine, 2 is DotLine, 3 is DashDotLine, +

0 is SolidLine, 1 is DashLine, 2 is DotLine, 3 is DashDotLine, and 4 isDashDotDotLine,

set_line_width(x)[source]¶: Sets the width of the curve’s line.

set_name(name)¶: Set the name of the object inside kst.

set_point_density(density)[source]¶

Sets the point density.

When show_points is true, this option can be used to only show a subset of the points, for example, to use point types to discriminate between different curves.. This does not effect ‘lines’, where every point is always connected.

density can be from 0 (all points) to 4.

set_point_size(x)[source]¶: Sets the size of points, if they are drawn.

set_point_type(point_type)[source]¶

Sets the point type.

The available point types are:

0:X1:opensquare 
-2:opencircle,3:filledcircle
+0:  X                       1: open square
+2:  open circle,           3: filled circle
 4:  downward open triangle  5: upward open triangle
-6:  filled square           7: + 
+6:  filled square           7: +
 8:  *                       9: downward filled triangle
 10: upward filled triangle 11: open diamond
 12: filled diamond
 

set_x_error(vector, vectorminus=0)[source]¶

Set the X Error flags for the curve.

The error bars are symetric if vectorminus is not set.

set_y_error(vector, vectorminus=0)[source]¶

Set the Y Error flags for the curve.

The error bars are symetric if vectorminus is not set.

show_edit_dialog()¶: shows the edit dialog for the curve or image.

type_str()¶: Returns the type of the object from inside kst.

x_error_vector()[source]¶

Returns the +x error vector of the curve.

FIXME: should figure out what kind of vector this is and return that.

x_minus_error_vector()[source]¶

Returns the -x error vector of the curve.

FIXME: should figure out what kind of vector this is and return that.

x_vector()[source]¶

Returns the x vector of the curve.

FIXME: should figure out what kind of vector this is and return that.

y_error_vector()[source]¶

Returns the +y error vector of the curve.

FIXME: should figure out what kind of vector this is and return that.

y_minus_error_vector()[source]¶

Returns the -y error vector of the curve.

FIXME: should figure out what kind of vector this is and return that.

y_vector()[source]¶

Returns the y vector of the curve.

FIXME: should figure out what kind of vector this is and return that.

Images¶

class pykst.Image(client, matrix, name='', new=True)[source]¶

An image inside kst.

This class represents an image you would create via -“Create>Image” from the menubar inside kst. The parameters of this +

This class represents an image you would create via +“Create>Image” from the menubar inside kst. The parameters of this function mirror the parameters within “Create>Curve”.

Parameters:	matrix – The matrix which defines the image.

Use the convenience function in client to create an image in kst session +

Use the convenience function in client to create an image in kst session “client” of Matrix m:

i1 = client.new_image(m)
 

description_tip()¶: Returns a string describing the object

max_x()¶: Returns the max X value of the curve or image.

max_y()¶: Returns the max Y value of the curve or image.

max_z()[source]¶: Returns the max Z value of the curve or image.

min_x()¶: Returns the min X value of the curve or image.

min_y()¶: Returns the min Y value of the curve or image.

min_z()[source]¶: Returns the max Z value of the curve or image.

name()¶: Returns the name of the object from inside kst.

set_auto_range(saturated=0)[source]¶

Automatically set the z range of the color map

Parameters:	saturated – The colormap range is set so that this fraction of the points in the matrix are saturated.

Equal numbers of points are saturated at both ends of the color map.

set_matrix(matrix)[source]¶: change the matrix which is the source of the image.

set_name(name)¶: Set the name of the object inside kst.

set_palette(palette)[source]¶

set the palette, selected by index.

The available palettes are:

Grey
-1:  Red 
+1:  Red
 Spectrum
 EOS-A
 EOS-B
 8 colors
 Cyclical Spectrum
 

Note: this is not the same order as the dialog.

set_range(zmin, zmax)[source]¶: sets the z range of the color map.

show_edit_dialog()¶: shows the edit dialog for the curve or image.

type_str()¶: Returns the type of the object from inside kst.

Annotations¶

Annotations along with interactive items (see the next section) can be used to turn kst into a graphing calculator, a tetris client, and maybe even a web browser...

class pykst.Label(client, text, pos=(0.5, 0.5), rot=0, font_size=12, bold=False, italic=False, font_color='black', font_family='Serif', name='', new=True)[source]¶

A floating label inside kst.

A label inside kst.

Parameters:

Parameters:	- text – the text of the label. Supports scalars, equations, and a + text – the text of the label. Supports scalars, equations, and a LaTeX subset. - pos – a 2 element tuple `(x,y)` specifying the position. -(0,0) is top left. (1,1) is bottom right. + pos – a 2 element tuple `(x, y)` specifying the position. +(0, 0) is top left. (1, 1) is bottom right. rot – rotation of the label in degrees. font_size – size of the label in points, when the printed at the reference size. - font_color – Colors are given by a name such as `red` or a + font_color – Colors are given by a name such as `red` or a hex number such as `#FF0000`. font_family – The font family. eg, TimeNewRoman.

text – the text of the label. Supports scalars, equations, and a +
text – the text of the label. Supports scalars, equations, and a LaTeX subset.
pos – a 2 element tuple (x,y) specifying the position. -(0,0) is top left. (1,1) is bottom right.
pos – a 2 element tuple (x, y) specifying the position. +(0, 0) is top left. (1, 1) is bottom right.
rot – rotation of the label in degrees.
font_size – size of the label in points, when the printed at the reference size.
font_color – Colors are given by a name such as red or a +
font_color – Colors are given by a name such as red or a hex number such as #FF0000.
font_family – The font family. eg, TimeNewRoman.

Scalars and scalar equations can be displayed live in labels. +

Scalars and scalar equations can be displayed live in labels. When the scalar is updated, the label is updated.

The format is:

Scalar:         [scalarname]         eg [GYRO1:Mean(X4)]
 Vector Element: [vectorName[index]]  eg [GYRO1 (V2)[4]]
 Equation:       [=equation]          eg [=[GYRO1:Mean(X4)]/[GYRO1:Sigma (X4)]]
 

These numerical fields can be formatted by appending a C printf format embedded in { } immediately after the field. For example:

[GYRO1:Mean(X4)]{%4.2f}
 

Labels in kst support a derrivitive subset of LaTeX. For example, to display -the equation for the area of a circle, you could set the label to A=2\pir^2. -Unlike LaTeX, it is not necessary to enter math mode using $. Also, -unlike LaTeX, variables are not automatically displayed in italic font. -If desired, this must be done explicitly using \textit{}.

Greek letters: \name or \Name. eg: \alpha

Other symbols: \approx, \cdot, \ge, \geq, \inf, \approx, \cdot, -\ge, \geq, \inf, \int, \le, \leq, \ne, \n, \partial, \prod, \pm, -\sum, \sqrt

Font effects: \textcolor{colorname}{colored text}, \textbf{bold text}, -\textit{italicized text}, \underline{underlined text}, -\overline{overlined text}.

Other:x^y, x_y, \t, \n, \[

This class represents a label you would create via “Create>Annotations>Label” +

Labels in kst support a derrivitive subset of LaTeX. For example, to display +the equation for the area of a circle, you could set the label to A=2\pir^2. +Unlike LaTeX, it is not necessary to enter math mode using $. Also, +unlike LaTeX, variables are not automatically displayed in italic font. +If desired, this must be done explicitly using \\textit{}.

Greek letters: \\name or \\Name. eg: \\alpha

Other symbols: \\approx, \\cdot, \\ge, \\geq, \\inf, \\approx, \\cdot, +\\ge, \\geq, \\inf, \\int, \\le, \\leq, \\ne, \\n, \\partial, \\prod, \\pm, +\\sum, \\sqrt

Font effects: \\textcolor{colorname}{colored text}, \\textbf{bold text}, +\\textit{italicized text}, \\underline{underlined text}, +\\overline{overlined text}.

Other:x^y, x_y, \\t, \\n, \\[

This class represents a label you would create via “Create>Annotations>Label” from the menubar inside kst.

Use the convenience function in Client to create a label “Test Label” in kst:

import pykst as kst
 client = kst.Client()
 L = client.new_label("Test Label", (0.25, 0.25), font_size=18)
 

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

remove()¶: This removes the object from Kst.

set_font_bold(bold=True)[source]¶: . . .

set_font_color(color)[source]¶: Colors are given by a name such as red or a hex number such +; Colors are given by a name such as red or a hex number such as #FF0000

set_font_family(family)[source]¶: set the font family. eg, TimeNewRoman.

set_font_italic(italic=True)[source]¶: . . .

set_label_font_size(size)[source]¶: size of the label in points, when the printed at the reference size.

set_lock_pos_to_data(lock=True)¶

if lock is True, and the item is in a plot, then the position of the item will be locked to the data coordinates in the plot. The item will move with zooming and scrolling.

If lock is False, or the item is not in a plot, then the item will be fixed to the geometry of the window, and zooming/scrolling will not change its position.

set_name(name)¶: Set the name of the object inside kst.

set_parent_auto()¶

Set the parent of the viewitem to an existing view item which fully contains it. Once reparented, moving/resizing the parent will also move/resize the child.

By default view items created by pyKst are parented by the toplevel view unless this method is called, or if the item is moved/resized in the GUI.

set_parent_toplevel()¶

Set the parent of the viewitem to the toplevel view.

By default view items created by pyKst are parented by the toplevel view unless set_parent_auto() is called, or if the item is moved/resized in the GUI.

set_pos(pos)¶

Set the center position of the item.

- +

Parameters:	pos – a 2 element tuple `(x,y)` specifying the position. -The Top Left of the parent is (0,0). -The Bottom Right of the parent is (1,1)
Parameters:	pos – a 2 element tuple `(x, y)` specifying the position. +The Top Left of the parent is (0, 0). +The Bottom Right of the parent is (1, 1)

set_rotation(rot)¶

Set the rotation of the item.

This is equivalent to setting Dimensions>Rotation within a view item dialog.

set_text(text)[source]¶

Set text displayed by the label.

Scalars and scalar equations can be displayed live in labels. +

Scalars and scalar equations can be displayed live in labels. When the scalar is updated, the label is updated. The format is:

Scalar:         [scalarname]         eg [GYRO1:Mean(X4)]
 Vector Element: [vectorName[index]]  eg [GYRO1 (V2)[4]]
 Equation:       [=equation]          eg [=[GYRO1:Mean(X4)]/[GYRO1:Sigma (X4)]]
 

Labels in kst support a derrivitive subset of LaTeX. For example, -to display the equation for the area of a circle, you could set the +

Labels in kst support a derrivitive subset of LaTeX. For example, +to display the equation for the area of a circle, you could set the label to A=2\pir^2. Unlike LaTeX, it is not necessary to enter -math mode using $. Also, unlike LaTeX, variables are not -automatically displayed in italic font. If desired, this must be done -explicitly using \textit{}.

Greek letters: \name or \Name. eg: \alpha

Other symbols: \approx, \cdot, \ge, \geq, \inf, \approx, \cdot, -\ge, \geq, \inf, \int, \le, \leq, \ne, \n, \partial, \prod, \pm, -\sum, \sqrt

Font effects: \textcolor{colorname}{colored text}, \textbf{bold text}, -\textit{italicized text}, \underline{underlined text}, -\overline{overlined text}.

Other:x^y, x_y, \t, \n, \[

+math mode using $. Also, unlike LaTeX, variables are not +automatically displayed in italic font. If desired, this must be done +explicitly using \\textit{}.

Greek letters: \\name or \\Name. eg: \\alpha

Other symbols: \\approx, \\cdot, \\ge, \\geq, \\inf, \\approx, \\cdot, +\\ge, \\geq, \\inf, \\int, \\le, \\leq, \\ne, \\n, \\partial, \\prod, \\pm, +\\sum, \\sqrt

Font effects: \\textcolor{colorname}{colored text}, \\textbf{bold text}, +\\textit{italicized text}, \\underline{underlined text}, +\\overline{overlined text}.

Other:x^y, x_y, \\t, \\n, \\[

subplot(*args)¶

Set the item position according to the given grid definition.

Typical call signature:

subplot(nrows, ncols, plot_number)
 

Where nrows and ncols are used to notionally split the figure into nrows * ncols sub-axes, and plot_number is used to identify the particular subplot that this function is to create within the notional grid. plot_number starts at 1, increments across rows first and has a maximum of nrows * ncols.

In the case when nrows, ncols and plot_number are all less than 10, a convenience exists, such that the a 3 digit number can be given instead, where the hundreds represent nrows, the tens represent ncols and the units represent plot_number. For instance:

subplot(211)
 

place the plot in the top grid location (i.e. the first) in a 2 row by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned).

class pykst.Legend(client, plot, name='', new=True)[source]¶

A legend in a plot in kst.

: param plot: a plot in kst. Use the convenience function in Client to create a legend in kst:

 import pykst as kst
  client = kst.Client()
 ...
  P1 = client.new_plot()
  L1 = client.new_legend(P1)
 

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

remove()¶: This removes the object from Kst.

set_fill_color(color)¶

Set the fill/background color.

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

set_fill_style(style)¶

Set the background fill style.

This is equivalent to setting the index of Apperance>Fill>Style within +

This is equivalent to setting the index of Apperance>Fill>Style within a view item dialog in kst.:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_font_bold(bold=True)[source]¶: . . .

set_font_color(color)[source]¶: Colors are given by a name such as red or a hex number such as #FF0000

set_font_family(family)[source]¶: set the font family. eg, TimeNewRoman.

set_font_italic(italic=True)[source]¶: . . .

set_font_size(size)[source]¶: size of the label in points, when the printed at the reference size.

set_lock_pos_to_data(lock=True)¶

if lock is True, and the item is in a plot, then the position of the item will be locked to the data coordinates in the plot. The item will move with zooming and scrolling.

If lock is False, or the item is not in a plot, then the item will be fixed to the geometry of the window, and zooming/scrolling will not change its position.

set_name(name)¶: Set the name of the object inside kst.

set_parent_auto()¶

Set the parent of the viewitem to an existing view item which fully contains it. Once reparented, moving/resizing the parent will also move/resize the child.

By default view items created by pyKst are parented by the toplevel view unless this method is called, or if the item is moved/resized in the GUI.

set_parent_toplevel()¶

Set the parent of the viewitem to the toplevel view.

By default view items created by pyKst are parented by the toplevel view unless set_parent_auto() is called, or if the item is moved/resized in the GUI.

set_pos(pos)¶

Set the center position of the item.

- +

Parameters:	pos – a 2 element tuple `(x,y)` specifying the position. -The Top Left of the parent is (0,0). -The Bottom Right of the parent is (1,1)
Parameters:	pos – a 2 element tuple `(x, y)` specifying the position. +The Top Left of the parent is (0, 0). +The Bottom Right of the parent is (1, 1)

set_rotation(rot)¶

Set the rotation of the item.

This is equivalent to setting Dimensions>Rotation within a view item dialog.

set_stroke_brush_color(color)¶

Set the color for lines for the item.

Colors are given by a name such as red or a hex number +

Colors are given by a name such as red or a hex number such as #FF0000.

set_stroke_brush_style(style)¶

Set the brush style for lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Brush Style +

This is equivalent to setting the index of Apperance>Stroke>Brush Style within a view item dialog in kst.

This sets the brush type for lines in the item, and not for the fill, +

This sets the brush type for lines in the item, and not for the fill, so values other than 1 (SolidPattern) only make sense for wide lines and are rarely used:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_stroke_cap_style(style)¶

Set the cap style for the ends of lines in the item.

This is equivalent to setting the index of Apperance>Stroke>Cap Style +

This is equivalent to setting the index of Apperance>Stroke>Cap Style within a view item dialog in kst.

0 is FlatCap, 1 is SquareCap, and 2 is RoundCap.

set_stroke_join_style(style)¶

Set the style by which lines are joined in the item.

This is equivalent to setting the index of Apperance>Stroke>Join Style +

This is equivalent to setting the index of Apperance>Stroke>Join Style within a view item dialog in kst.

0 is MiterJoin, 1 is BevelJoin, 2 is RoundJoin, and 3 is SvgMiterJoin.

set_stroke_style(style)¶

Set the stroke style of lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Style +

This is equivalent to setting the index of Apperance>Stroke>Style within a view item dialog in kst:

0: SolidLine       1: DashLine
-2: DotLine         3: DashDotLine 
+2: DotLine         3: DashDotLine
 4: DashDotDotLine  5: CustomDashLine
 

set_stroke_width(width)¶: Set the width of lines for the item.

subplot(*args)¶

Set the item position according to the given grid definition.

Typical call signature:

subplot(nrows, ncols, plot_number)
 

subplot(211)
 

place the plot in the top grid location (i.e. the first) in a 2 row by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned).

-class pykst.Box(client, pos=(0.1, 0.1), size=(0.1, 0.1), rot=0, fill_color='white', fill_style=1, stroke_style=1, stroke_width=1, stroke_brush_color='black', stroke_brush_style=1, strokeJoinStyle=1, stroke_cap_style=1, fix_aspect=False, name='', new=True)[source]¶

class pykst.Box(clientpos=(0.10.1)size=(0.10.1)rot=0fill_color='white'fill_style=1stroke_style=1stroke_width=1stroke_brush_color='black'stroke_brush_style=1stroke_join_style=1stroke_cap_style=1fix_aspect=Falsename=''new=True)[source]¶

A floating box inside kst.

Parameters:

pos – a 2 element tuple (x,y) specifying the position. -(0,0) is top left. (1,1) is bottom right.
size – a 2 element tuple (w,h) specifying the size. -(1,1) is the size of the window.
pos – a 2 element tuple (x, y) specifying the position. +(0, 0) is top left. (1, 1) is bottom right.
size – a 2 element tuple (w, h) specifying the size. +(1, 1) is the size of the window.
rotation – rotation of the label in degrees.
fill_color – the background color.
fill_style – the background fill style. See set_fill_style.
stroke_style – see set_stroke_style
stroke_width – the pen width for the box outline.
stroke_brush_color – the box outline color
stroke_brush_style – see set_stroke_brush_style
strokeJoinStyle – see set_stroke_join_style
stroke_join_style – see set_stroke_join_style
stroke_cap_style – see set_stroke_cap_style
fix_aspect – if true, the box will have a fixed aspect ratio.

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

This class represents a box you would create via “Create>Annotations>Box” +

This class represents a box you would create via “Create>Annotations>Box” from the menubar inside kst.

Use the convenience function in Client to create a box in kst:

import pykst as kst
 client = kst.Client()
 ...
 B = client.new_box((0.25, 0.25), (0.2, 0.1), fill_color="blue")
 

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

remove()¶: This removes the object from Kst.

set_fill_color(color)¶

Set the fill/background color.

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

set_fill_style(style)¶

Set the background fill style.

This is equivalent to setting the index of Apperance>Fill>Style within +

This is equivalent to setting the index of Apperance>Fill>Style within a view item dialog in kst.:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_fixed_aspect_ratio(fixed=True)¶

if True, fix the aspect ratio of the item to its current value.

This is equivalent to checking Dimensions>Fix aspect ratio within a +

This is equivalent to checking Dimensions>Fix aspect ratio within a view item dialog in kst.

set_lock_pos_to_data(lock=True)¶

if lock is True, and the item is in a plot, then the position of the item will be locked to the data coordinates in the plot. The item will move with zooming and scrolling.

If lock is False, or the item is not in a plot, then the item will be fixed to the geometry of the window, and zooming/scrolling will not change its position.

set_name(name)¶: Set the name of the object inside kst.

set_parent_auto()¶

Set the parent of the viewitem to an existing view item which fully contains it. Once reparented, moving/resizing the parent will also move/resize the child.

By default view items created by pyKst are parented by the toplevel view unless this method is called, or if the item is moved/resized in the GUI.

set_parent_toplevel()¶

Set the parent of the viewitem to the toplevel view.

By default view items created by pyKst are parented by the toplevel view unless set_parent_auto() is called, or if the item is moved/resized in the GUI.

set_pos(pos)¶

Set the center position of the item.

- +

Parameters:	pos – a 2 element tuple `(x,y)` specifying the position. -The Top Left of the parent is (0,0). -The Bottom Right of the parent is (1,1)
Parameters:	pos – a 2 element tuple `(x, y)` specifying the position. +The Top Left of the parent is (0, 0). +The Bottom Right of the parent is (1, 1)

set_rotation(rot)¶

Set the rotation of the item.

This is equivalent to setting Dimensions>Rotation within a view item dialog.

set_size(size)¶

Set the size of the item.

- +

Parameters:	size – a 2 element tuple `(w,h)` specifying the size.
Parameters:	size – a 2 element tuple `(w, h)` specifying the size.

Elements go from 0 to 1. If the aspect ratio is fixed, then h +

Elements go from 0 to 1. If the aspect ratio is fixed, then h is ignored.

This is equivalent to setting Dimensions>Position within a view +

This is equivalent to setting Dimensions>Position within a view item dialog in kst.

set_stroke_brush_color(color)¶

Set the color for lines for the item.

Colors are given by a name such as red or a hex number +

Colors are given by a name such as red or a hex number such as #FF0000.

set_stroke_brush_style(style)¶

Set the brush style for lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Brush Style +

This is equivalent to setting the index of Apperance>Stroke>Brush Style within a view item dialog in kst.

This sets the brush type for lines in the item, and not for the fill, +

This sets the brush type for lines in the item, and not for the fill, so values other than 1 (SolidPattern) only make sense for wide lines and are rarely used:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_stroke_cap_style(style)¶

Set the cap style for the ends of lines in the item.

This is equivalent to setting the index of Apperance>Stroke>Cap Style +

This is equivalent to setting the index of Apperance>Stroke>Cap Style within a view item dialog in kst.

0 is FlatCap, 1 is SquareCap, and 2 is RoundCap.

set_stroke_join_style(style)¶

Set the style by which lines are joined in the item.

This is equivalent to setting the index of Apperance>Stroke>Join Style +

This is equivalent to setting the index of Apperance>Stroke>Join Style within a view item dialog in kst.

0 is MiterJoin, 1 is BevelJoin, 2 is RoundJoin, and 3 is SvgMiterJoin.

set_stroke_style(style)¶

Set the stroke style of lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Style +

This is equivalent to setting the index of Apperance>Stroke>Style within a view item dialog in kst:

0: SolidLine       1: DashLine
-2: DotLine         3: DashDotLine 
+2: DotLine         3: DashDotLine
 4: DashDotDotLine  5: CustomDashLine
 

set_stroke_width(width)¶: Set the width of lines for the item.

subplot(*args)¶

Set the item position according to the given grid definition.

Typical call signature:

subplot(nrows, ncols, plot_number)
 

subplot(211)
 

place the plot in the top grid location (i.e. the first) in a 2 row by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned).

class pykst.Circle(client, pos=(0.1, 0.1), diameter=0.1, fill_color='white', fill_style=1, stroke_style=1, stroke_width=1, stroke_brush_color='grey', stroke_brush_style=1, name='', new=True)[source]¶

A floating circle inside kst.

Parameters:

pos – a 2 element tuple (x,y) specifying the position. -(0,0) is top left. (1,1) is bottom right.
pos – a 2 element tuple (x, y) specifying the position. +(0, 0) is top left. (1, 1) is bottom right.
diameter – the diameter of the circle. 1 is the width of the window.
fill_color – the background color.
fill_style – the background fill style. See set_fill_style.
stroke_style – see set_stroke_style
stroke_width – the pen width for the circle outline.
stroke_brush_color – the circle outline color
stroke_brush_style – see set_stroke_brush_style

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

This class represents a circle you would create via +

This class represents a circle you would create via “Create>Annotations>Circle” from the menubar inside kst.

Use the convenience function in Client to create a circle in kst:

import pykst as kst
 client = kst.Client()
 ...
 Cr = client.new_circle((0.5, 0.5), 0.2, fill_color="red")
 

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

remove()¶: This removes the object from Kst.

set_diameter(diameter)[source]¶

set the diamter of the circle.

The width of the window is 1.0.

set_fill_color(color)¶

Set the fill/background color.

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

set_fill_style(style)¶

Set the background fill style.

This is equivalent to setting the index of Apperance>Fill>Style within +

This is equivalent to setting the index of Apperance>Fill>Style within a view item dialog in kst.:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_lock_pos_to_data(lock=True)¶

if lock is True, and the item is in a plot, then the position of the item will be locked to the data coordinates in the plot. The item will move with zooming and scrolling.

If lock is False, or the item is not in a plot, then the item will be fixed to the geometry of the window, and zooming/scrolling will not change its position.

set_name(name)¶: Set the name of the object inside kst.

set_parent_auto()¶

Set the parent of the viewitem to an existing view item which fully contains it. Once reparented, moving/resizing the parent will also move/resize the child.

By default view items created by pyKst are parented by the toplevel view unless this method is called, or if the item is moved/resized in the GUI.

set_parent_toplevel()¶

Set the parent of the viewitem to the toplevel view.

By default view items created by pyKst are parented by the toplevel view unless set_parent_auto() is called, or if the item is moved/resized in the GUI.

set_pos(pos)¶

Set the center position of the item.

- +

Parameters:	pos – a 2 element tuple `(x,y)` specifying the position. -The Top Left of the parent is (0,0). -The Bottom Right of the parent is (1,1)
Parameters:	pos – a 2 element tuple `(x, y)` specifying the position. +The Top Left of the parent is (0, 0). +The Bottom Right of the parent is (1, 1)

set_rotation(rot)¶

Set the rotation of the item.

This is equivalent to setting Dimensions>Rotation within a view item dialog.

set_stroke_brush_color(color)¶

Set the color for lines for the item.

Colors are given by a name such as red or a hex number +

Colors are given by a name such as red or a hex number such as #FF0000.

set_stroke_brush_style(style)¶

Set the brush style for lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Brush Style +

This is equivalent to setting the index of Apperance>Stroke>Brush Style within a view item dialog in kst.

This sets the brush type for lines in the item, and not for the fill, +

This sets the brush type for lines in the item, and not for the fill, so values other than 1 (SolidPattern) only make sense for wide lines and are rarely used:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_stroke_style(style)¶

Set the stroke style of lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Style +

This is equivalent to setting the index of Apperance>Stroke>Style within a view item dialog in kst:

0: SolidLine       1: DashLine
-2: DotLine         3: DashDotLine 
+2: DotLine         3: DashDotLine
 4: DashDotDotLine  5: CustomDashLine
 

set_stroke_width(width)¶: Set the width of lines for the item.

subplot(*args)¶

Set the item position according to the given grid definition.

Typical call signature:

subplot(nrows, ncols, plot_number)
 

subplot(211)
 

place the plot in the top grid location (i.e. the first) in a 2 row by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned).

class pykst.Ellipse(client, pos=(0.1, 0.1), size=(0.1, 0.1), rot=0, fill_color='white', fill_style=1, stroke_style=1, stroke_width=1, stroke_brush_color='black', stroke_brush_style=1, fix_aspect=False, name='', new=True)[source]¶

A floating ellipse inside kst.

Parameters:

pos – a 2 element tuple (x,y) specifying the position. -(0,0) is top left. (1,1) is bottom right.
size – a 2 element tuple (w,h) specifying the size. -(1,1) is the size of the window.
pos – a 2 element tuple (x, y) specifying the position. +(0, 0) is top left. (1, 1) is bottom right.
size – a 2 element tuple (w, h) specifying the size. +(1, 1) is the size of the window.
fill_color – the background color.
fill_style – the background fill style. See set_fill_style.
stroke_style – see set_stroke_style
stroke_width – the pen width for the ellipse outline.
stroke_brush_color – the ellipse outline color
stroke_brush_style – see set_stroke_brush_style

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

This class represents an ellipse you would create via +

This class represents an ellipse you would create via “Create>Annotations>Ellipse” from the menubar inside kst.

Use the convenience function in Client to create an Ellipse in kst:

import pykst as kst
 client = kst.Client()
 ...
 E = client.new_ellipse((0.25, 0.25), (0.2, 0.1), fill_color="green")
 

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

remove()¶: This removes the object from Kst.

set_fill_color(color)¶

Set the fill/background color.

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

set_fill_style(style)¶

Set the background fill style.

This is equivalent to setting the index of Apperance>Fill>Style within +

This is equivalent to setting the index of Apperance>Fill>Style within a view item dialog in kst.:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_fixed_aspect_ratio(fixed=True)¶

if True, fix the aspect ratio of the item to its current value.

This is equivalent to checking Dimensions>Fix aspect ratio within a +

This is equivalent to checking Dimensions>Fix aspect ratio within a view item dialog in kst.

set_lock_pos_to_data(lock=True)¶

if lock is True, and the item is in a plot, then the position of the item will be locked to the data coordinates in the plot. The item will move with zooming and scrolling.

If lock is False, or the item is not in a plot, then the item will be fixed to the geometry of the window, and zooming/scrolling will not change its position.

set_name(name)¶: Set the name of the object inside kst.

set_parent_auto()¶

Set the parent of the viewitem to an existing view item which fully contains it. Once reparented, moving/resizing the parent will also move/resize the child.

By default view items created by pyKst are parented by the toplevel view unless this method is called, or if the item is moved/resized in the GUI.

set_parent_toplevel()¶

Set the parent of the viewitem to the toplevel view.

By default view items created by pyKst are parented by the toplevel view unless set_parent_auto() is called, or if the item is moved/resized in the GUI.

set_pos(pos)¶

Set the center position of the item.

- +

Parameters:	pos – a 2 element tuple `(x,y)` specifying the position. -The Top Left of the parent is (0,0). -The Bottom Right of the parent is (1,1)
Parameters:	pos – a 2 element tuple `(x, y)` specifying the position. +The Top Left of the parent is (0, 0). +The Bottom Right of the parent is (1, 1)

set_rotation(rot)¶

Set the rotation of the item.

This is equivalent to setting Dimensions>Rotation within a view item dialog.

set_size(size)¶

Set the size of the item.

- +

Parameters:	size – a 2 element tuple `(w,h)` specifying the size.
Parameters:	size – a 2 element tuple `(w, h)` specifying the size.

Elements go from 0 to 1. If the aspect ratio is fixed, then h +

Elements go from 0 to 1. If the aspect ratio is fixed, then h is ignored.

This is equivalent to setting Dimensions>Position within a view +

This is equivalent to setting Dimensions>Position within a view item dialog in kst.

set_stroke_brush_color(color)¶

Set the color for lines for the item.

Colors are given by a name such as red or a hex number +

Colors are given by a name such as red or a hex number such as #FF0000.

set_stroke_brush_style(style)¶

Set the brush style for lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Brush Style +

This is equivalent to setting the index of Apperance>Stroke>Brush Style within a view item dialog in kst.

This sets the brush type for lines in the item, and not for the fill, +

This sets the brush type for lines in the item, and not for the fill, so values other than 1 (SolidPattern) only make sense for wide lines and are rarely used:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_stroke_style(style)¶

Set the stroke style of lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Style +

This is equivalent to setting the index of Apperance>Stroke>Style within a view item dialog in kst:

0: SolidLine       1: DashLine
-2: DotLine         3: DashDotLine 
+2: DotLine         3: DashDotLine
 4: DashDotDotLine  5: CustomDashLine
 

set_stroke_width(width)¶: Set the width of lines for the item.

subplot(*args)¶

Set the item position according to the given grid definition.

Typical call signature:

subplot(nrows, ncols, plot_number)
 

subplot(211)
 

place the plot in the top grid location (i.e. the first) in a 2 row by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned).

class pykst.Line(client, start=(0, 0), end=(1, 1), stroke_style=1, stroke_width=1, stroke_brush_color='black', stroke_brush_style=1, stroke_cap_style=1, name='', new=True)[source]¶

A floating line inside kst.

Parameters:

start – a 2 element tuple (x,y) specifying the position of the +
start – a 2 element tuple (x, y) specifying the position of the start of the line. -(0,0) is top left of the window, and (1,1) is bottom right.
end – a 2 element tuple (x,y) specifying the position of the +(0, 0) is top left of the window, and (1, 1) is bottom right.
end – a 2 element tuple (x, y) specifying the position of the end of the line. -(0,0) is top left of the window, and (1,1) is bottom right.

(0, 0)

(1, 1)

length – The length of the line. 1 is the width of the window.
rot – rotation of the line in degrees.
stroke_style – see set_stroke_style
stroke_width – the pen width for the ellipse outline.
stroke_brush_color – the ellipse outline color
stroke_brush_style – see set_stroke_brush_style
stroke_cap_style – see set_stroke_cap_style

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

This class represents a line you would create via “Create>Annotations>Line” from the menubar inside kst.

This class represents a line you would create via “Create>Annotations>Line” +from the menubar inside kst.

Colors are given by a name such as red or a hex number such as #FF0000”.

Use the convenience function in Client to create a line in kst:

import pykst as kst
 client = kst.Client()
 ...
 Ln = client.new_line((0.25, 0.25), (0.5, 0.5))
 

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

remove()¶: This removes the object from Kst.

set_endpoints(start=(0, 0), end=(1, 1))[source]¶

set the endpoints of the line.

If lock_pos_to_data has been set True, and the item parent is a plot, then the coordinates are -in terms the data’s coordinates. Otherwise, the coordinates, between 0 and 1, are relative to -the dimensions of the parent object.

If lock_pos_to_data has been set True, and the item parent is a plot, then +the coordinates are in terms the data’s coordinates. Otherwise, the coordinates, +between 0 and 1, are relative to the dimensions of the parent object.

set_length(length)[source]¶

set the length of the line.

The length, between 0 and 1, is as a fraction of the width of the parent item.

set_lock_pos_to_data(lock=True)¶

if lock is True, and the item is in a plot, then the position of the item will be locked to the data coordinates in the plot. The item will move with zooming and scrolling.

If lock is False, or the item is not in a plot, then the item will be fixed to the geometry of the window, and zooming/scrolling will not change its position.

set_name(name)¶: Set the name of the object inside kst.

set_parent_auto()¶

Set the parent of the viewitem to an existing view item which fully contains it. Once reparented, moving/resizing the parent will also move/resize the child.

By default view items created by pyKst are parented by the toplevel view unless this method is called, or if the item is moved/resized in the GUI.

set_parent_toplevel()¶

Set the parent of the viewitem to the toplevel view.

By default view items created by pyKst are parented by the toplevel view unless set_parent_auto() is called, or if the item is moved/resized in the GUI.

set_pos(pos)¶

Set the center position of the item.

- +

Parameters:	pos – a 2 element tuple `(x,y)` specifying the position. -The Top Left of the parent is (0,0). -The Bottom Right of the parent is (1,1)
Parameters:	pos – a 2 element tuple `(x, y)` specifying the position. +The Top Left of the parent is (0, 0). +The Bottom Right of the parent is (1, 1)

set_rotation(rot)¶

Set the rotation of the item.

This is equivalent to setting Dimensions>Rotation within a view item dialog.

set_stroke_brush_color(color)¶

Set the color for lines for the item.

Colors are given by a name such as red or a hex number +

Colors are given by a name such as red or a hex number such as #FF0000.

set_stroke_brush_style(style)¶

Set the brush style for lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Brush Style +

This is equivalent to setting the index of Apperance>Stroke>Brush Style within a view item dialog in kst.

This sets the brush type for lines in the item, and not for the fill, +

This sets the brush type for lines in the item, and not for the fill, so values other than 1 (SolidPattern) only make sense for wide lines and are rarely used:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_stroke_cap_style(style)¶

Set the cap style for the ends of lines in the item.

This is equivalent to setting the index of Apperance>Stroke>Cap Style +

This is equivalent to setting the index of Apperance>Stroke>Cap Style within a view item dialog in kst.

0 is FlatCap, 1 is SquareCap, and 2 is RoundCap.

set_stroke_style(style)¶

Set the stroke style of lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Style +

This is equivalent to setting the index of Apperance>Stroke>Style within a view item dialog in kst:

0: SolidLine       1: DashLine
-2: DotLine         3: DashDotLine 
+2: DotLine         3: DashDotLine
 4: DashDotDotLine  5: CustomDashLine
 

set_stroke_width(width)¶: Set the width of lines for the item.

subplot(*args)¶

Set the item position according to the given grid definition.

Typical call signature:

subplot(nrows, ncols, plot_number)
 

subplot(211)
 

place the plot in the top grid location (i.e. the first) in a 2 row by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned).

class pykst.Arrow(client, start=(0, 0), end=(1, 1), arror_at_start=False, arrow_at_end=True, arrow_size=12.0, stroke_style=1, stroke_width=1, stroke_brush_color='black', stroke_brush_style=1, stroke_cap_style=1, name='', new=True)[source]¶

A floating arrow inside kst.

Parameters:

pos – a 2 element tuple (x,y) specifying the position of the -center of the line. -(0,0) is top left. (1,1) is bottom right.
pos – a 2 element tuple (x, y) specifying the position of the +center of the line. +(0, 0) is top left. (1, 1) is bottom right.
length – The length of the line. 1 is the width of the window.
rot – rotation of the line in degrees.
arror_at_start – if True, draw an arrow at the start of the line.
arrow_at_end – if True, draw an arrow at the end of the line.
arrow_size – the size of the arrow.
stroke_style – see set_stroke_style.
stroke_width – the pen width for the ellipse outline.
stroke_brush_color – the ellipse outline color
stroke_brush_style – see set_stroke_brush_style
stroke_cap_style – see set_stroke_cap_style

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

This class represents an arrow you would create via +

This class represents an arrow you would create via “Create>Annotations>Arrow” from the menubar inside kst.

Use the convenience function in Client to create an arrow in kst:

import pykst as kst
 client = kst.Client()
 ...
 Ln = client.new_arrow((0.25, 0.25), 0.2, rot=15, arror_at_start=True)
 

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

remove()¶: This removes the object from Kst.

set_arrow_at_end(arrow=True)[source]¶: Set whether an arrow head is shown at the end of the line

set_arrow_at_start(arrow=True)[source]¶: Set whether an arrow head is shown at the start of the line

set_endpoints(start=(0, 0), end=(1, 1))[source]¶

set the endpoints of the arrow.

If lock_pos_to_data has been set True, and the item parent is a plot, then the +coordinates are in terms the data’s coordinates. Otherwise, the coordinates, +between 0 and 1, are relative to the dimensions of the parent object.

set_length(length)[source]¶

set the length of the line.

The width of the window is 1.0.

set_lock_pos_to_data(lock=True)¶

if lock is True, and the item is in a plot, then the position of the item will be locked to the data coordinates in the plot. The item will move with zooming and scrolling.

If lock is False, or the item is not in a plot, then the item will be fixed to the geometry of the window, and zooming/scrolling will not change its position.

set_name(name)¶: Set the name of the object inside kst.

set_parent_auto()¶

Set the parent of the viewitem to an existing view item which fully contains it. Once reparented, moving/resizing the parent will also move/resize the child.

By default view items created by pyKst are parented by the toplevel view unless this method is called, or if the item is moved/resized in the GUI.

set_parent_toplevel()¶

Set the parent of the viewitem to the toplevel view.

By default view items created by pyKst are parented by the toplevel view unless set_parent_auto() is called, or if the item is moved/resized in the GUI.

set_pos(pos)¶

Set the center position of the item.

- +

Parameters:	pos – a 2 element tuple `(x,y)` specifying the position. -The Top Left of the parent is (0,0). -The Bottom Right of the parent is (1,1)
Parameters:	pos – a 2 element tuple `(x, y)` specifying the position. +The Top Left of the parent is (0, 0). +The Bottom Right of the parent is (1, 1)

set_rotation(rot)¶

Set the rotation of the item.

This is equivalent to setting Dimensions>Rotation within a view item dialog.

set_stroke_brush_color(color)¶

Set the color for lines for the item.

Colors are given by a name such as red or a hex number +

Colors are given by a name such as red or a hex number such as #FF0000.

set_stroke_brush_style(style)¶

Set the brush style for lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Brush Style +

This is equivalent to setting the index of Apperance>Stroke>Brush Style within a view item dialog in kst.

This sets the brush type for lines in the item, and not for the fill, +

This sets the brush type for lines in the item, and not for the fill, so values other than 1 (SolidPattern) only make sense for wide lines and are rarely used:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_stroke_cap_style(style)¶

Set the cap style for the ends of lines in the item.

This is equivalent to setting the index of Apperance>Stroke>Cap Style +

This is equivalent to setting the index of Apperance>Stroke>Cap Style within a view item dialog in kst.

0 is FlatCap, 1 is SquareCap, and 2 is RoundCap.

set_stroke_style(style)¶

Set the stroke style of lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Style +

This is equivalent to setting the index of Apperance>Stroke>Style within a view item dialog in kst:

0: SolidLine       1: DashLine
-2: DotLine         3: DashDotLine 
+2: DotLine         3: DashDotLine
 4: DashDotDotLine  5: CustomDashLine
 

set_stroke_width(width)¶: Set the width of lines for the item.

subplot(*args)¶

Set the item position according to the given grid definition.

Typical call signature:

subplot(nrows, ncols, plot_number)
 

subplot(211)
 

place the plot in the top grid location (i.e. the first) in a 2 row by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned).

class pykst.Picture(client, filename, pos=(0.1, 0.1), width=0.1, rot=0, name='', new=True)[source]¶

A floating image inside kst.

Parameters:

filename – the file which holds the image to be shown.
pos – a 2 element tuple (x,y) specifying the position of the -center of the picture. -(0,0) is top left. (1,1) is bottom right.
pos – a 2 element tuple (x, y) specifying the position of the +center of the picture. +(0, 0) is top left. (1, 1) is bottom right.
width – The width of the picture. 1 is the width of the window.
rot – rotation of the picture in degrees.

This class represents a picture you would create via +

This class represents a picture you would create via “Create>Annotations>Picture” from the menubar inside kst.

Use the convenience function in Client to create a picture in kst:

import pykst as kst
 client = kst.Client()
 ...
 pic = client.new_picture("image.jpg", (0.25, 0.25), 0.2)
 

BUG: the aspect ratio of the picture is wrong.

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

remove()¶: This removes the object from Kst.

set_fixed_aspect_ratio(fixed=True)¶

if True, fix the aspect ratio of the item to its current value.

This is equivalent to checking Dimensions>Fix aspect ratio within a +

This is equivalent to checking Dimensions>Fix aspect ratio within a view item dialog in kst.

set_lock_pos_to_data(lock=True)¶

if lock is True, and the item is in a plot, then the position of the item will be locked to the data coordinates in the plot. The item will move with zooming and scrolling.

If lock is False, or the item is not in a plot, then the item will be fixed to the geometry of the window, and zooming/scrolling will not change its position.

set_name(name)¶: Set the name of the object inside kst.

set_parent_auto()¶

Set the parent of the viewitem to an existing view item which fully contains it. Once reparented, moving/resizing the parent will also move/resize the child.

By default view items created by pyKst are parented by the toplevel view unless this method is called, or if the item is moved/resized in the GUI.

set_parent_toplevel()¶

Set the parent of the viewitem to the toplevel view.

By default view items created by pyKst are parented by the toplevel view unless set_parent_auto() is called, or if the item is moved/resized in the GUI.

set_picture(pic)[source]¶: BUG: aspect ratio is not changed. There is no parellel for this +; BUG: aspect ratio is not changed. There is no parellel for this function within the kst GUI.

set_pos(pos)¶

Set the center position of the item.

- +

Parameters:	pos – a 2 element tuple `(x,y)` specifying the position. -The Top Left of the parent is (0,0). -The Bottom Right of the parent is (1,1)
Parameters:	pos – a 2 element tuple `(x, y)` specifying the position. +The Top Left of the parent is (0, 0). +The Bottom Right of the parent is (1, 1)

set_rotation(rot)¶

Set the rotation of the item.

This is equivalent to setting Dimensions>Rotation within a view item dialog.

set_size(size)¶

Set the size of the item.

- +

Parameters:	size – a 2 element tuple `(w,h)` specifying the size.
Parameters:	size – a 2 element tuple `(w, h)` specifying the size.

Elements go from 0 to 1. If the aspect ratio is fixed, then h +

Elements go from 0 to 1. If the aspect ratio is fixed, then h is ignored.

This is equivalent to setting Dimensions>Position within a view +

This is equivalent to setting Dimensions>Position within a view item dialog in kst.

set_width(width)[source]¶

set the width of the picture.

The width of the window is 1.0.

subplot(*args)¶

Set the item position according to the given grid definition.

Typical call signature:

subplot(nrows, ncols, plot_number)
 

subplot(211)
 

place the plot in the top grid location (i.e. the first) in a 2 row by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned).

class pykst.SVG(client, filename, pos=(0.1, 0.1), width=0.1, rot=0, name='', new=True)[source]¶

A floating svg image inside kst.

Parameters:

filename – the file which holds the svg image to be shown.
pos – a 2 element tuple (x,y) specifying the position of the -center of the picture. -(0,0) is top left. (1,1) is bottom right.
pos – a 2 element tuple (x, y) specifying the position of the +center of the picture. +(0, 0) is top left. (1, 1) is bottom right.
width – The width of the picture. 1 is the width of the window.
rot – rotation of the picture in degrees.

This class represents a picture you would create via +

This class represents a picture you would create via “Create>Annotations>SVG” from the menubar inside kst.

Use the convenience function in Client to create an SVG picture in kst:

import pykst as kst
 client = kst.Client()
 ...
 svg1 = client.new_SVG("image.svg", (0.25, 0.25), 0.2)
 

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

remove()¶: This removes the object from Kst.

set_fixed_aspect_ratio(fixed=True)¶

if True, fix the aspect ratio of the item to its current value.

This is equivalent to checking Dimensions>Fix aspect ratio within a +

This is equivalent to checking Dimensions>Fix aspect ratio within a view item dialog in kst.

set_lock_pos_to_data(lock=True)¶

if lock is True, and the item is in a plot, then the position of the item will be locked to the data coordinates in the plot. The item will move with zooming and scrolling.

If lock is False, or the item is not in a plot, then the item will be fixed to the geometry of the window, and zooming/scrolling will not change its position.

set_name(name)¶: Set the name of the object inside kst.

set_parent_auto()¶

Set the parent of the viewitem to an existing view item which fully contains it. Once reparented, moving/resizing the parent will also move/resize the child.

By default view items created by pyKst are parented by the toplevel view unless this method is called, or if the item is moved/resized in the GUI.

set_parent_toplevel()¶

Set the parent of the viewitem to the toplevel view.

By default view items created by pyKst are parented by the toplevel view unless set_parent_auto() is called, or if the item is moved/resized in the GUI.

set_pos(pos)¶

Set the center position of the item.

- +

Parameters:	pos – a 2 element tuple `(x,y)` specifying the position. -The Top Left of the parent is (0,0). -The Bottom Right of the parent is (1,1)
Parameters:	pos – a 2 element tuple `(x, y)` specifying the position. +The Top Left of the parent is (0, 0). +The Bottom Right of the parent is (1, 1)

set_rotation(rot)¶

Set the rotation of the item.

This is equivalent to setting Dimensions>Rotation within a view item dialog.

set_size(size)¶

Set the size of the item.

- +

Parameters:	size – a 2 element tuple `(w,h)` specifying the size.
Parameters:	size – a 2 element tuple `(w, h)` specifying the size.

Elements go from 0 to 1. If the aspect ratio is fixed, then h +

Elements go from 0 to 1. If the aspect ratio is fixed, then h is ignored.

This is equivalent to setting Dimensions>Position within a view +

This is equivalent to setting Dimensions>Position within a view item dialog in kst.

set_width(width)[source]¶

set the width of the picture.

The width of the window is 1.0.

subplot(*args)¶

Set the item position according to the given grid definition.

Typical call signature:

subplot(nrows, ncols, plot_number)
 

subplot(211)
 

place the plot in the top grid location (i.e. the first) in a 2 row by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned).

-class pykst.Plot(client, pos=(0, 0), size=(0, 0), rot=0, font_size=0, columns=0, fill_color='white', fill_style=1, stroke_style=1, stroke_width=1, stroke_brush_color='black', stroke_brush_style=1, strokeJoinStyle=1, stroke_cap_style=1, fix_aspect=False, auto_position=True, name='', new=True)[source]¶

class pykst.Plot(clientpos=(00)size=(00)rot=0font_size=0columns=0fill_color='white'fill_style=1stroke_style=1stroke_width=1stroke_brush_color='black'stroke_brush_style=1stroke_join_style=1stroke_cap_style=1fix_aspect=Falseauto_position=Truename=''new=True)[source]¶

A plot inside kst.

Parameters:

pos – a 2 element tuple (x,y) specifying the position. -(0,0) is top left. (1,1) is bottom right.
size – a 2 element tuple (w,h) specifying the size. -(1,1) is the size of the window.
pos – a 2 element tuple (x, y) specifying the position. +(0, 0) is top left. (1, 1) is bottom right.
size – a 2 element tuple (w, h) specifying the size. +(1, 1) is the size of the window.
font_size – font size for labels in the plot. kst default if 0.
rotation – rotation of the label in degrees.
columns – auto-place the plot, reformatting into this many columns.
fill_color – the background color.
fill_style – the background fill style. See set_fill_style.
stroke_style – see set_stroke_style
stroke_width – the pen width for the plot outline.
stroke_brush_color – the plot outline color
stroke_brush_style – see set_stroke_brush_style
strokeJoinStyle – see set_stroke_join_style
stroke_join_style – see set_stroke_join_style
stroke_cap_style – see set_stroke_cap_style
fix_aspect – if true, the plot will have a fixed aspect ratio.
auto_postion – if True (the default) the plot will be auto-placed. Ignored if pos is set.

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

This class represents a Plot you would create via +

This class represents a Plot you would create via “Create>Annotations>Plot” from the menubar inside kst.

To create an plot in kst and plot a curve curve1:

import pykst as kst
 client = kst.Client()
 ...
-P1 = client.new_plot((0.25, 0.25), (0.5,0.5))
+P1 = client.new_plot((0.25, 0.25), (0.5, 0.5))
 P1.add(curve1)
 

add(relation)[source]¶: Add a curve or an image to the plot.

clear_x_axis_interpretation()[source]¶: do not intepret the x axis as time

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

normalize_x_to_y()[source]¶: Adjust the X zoom range so X and Y have the same scale +; Adjust the X zoom range so X and Y have the same scale per unit (square pixels)

remove()¶: This removes the object from Kst.

set_bottom_label(label='')[source]¶: Set the plot bottom label

set_bottom_label_auto()[source]¶: Set the bottom label to auto generated.

set_fill_color(color)¶

Set the fill/background color.

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

set_fill_style(style)¶

Set the background fill style.

This is equivalent to setting the index of Apperance>Fill>Style within +

This is equivalent to setting the index of Apperance>Fill>Style within a view item dialog in kst.:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_fixed_aspect_ratio(fixed=True)¶

if True, fix the aspect ratio of the item to its current value.

This is equivalent to checking Dimensions>Fix aspect ratio within a +

This is equivalent to checking Dimensions>Fix aspect ratio within a view item dialog in kst.

set_global_font(family='', font_size=0, bold=False, italic=False)[source]¶

Set the global plot font.

By default, the axis labels all use this, unless they have been set +

By default, the axis labels all use this, unless they have been set to use their own.

If the parameter ‘family’ is empty, the font family will be unchanged. If the parameter ‘font_size’ is 0, the font size will be unchanged. The font will be bold if parameter ‘bold’ is set to ‘bold’ or ‘True’. -The font will be italic if parameter ‘italic’ is set to ‘italic’ +The font will be italic if parameter ‘italic’ is set to ‘italic’ or ‘True’.

set_left_label(label='')[source]¶: Set the plot left label

set_left_label_auto()[source]¶: Set the left label to auto generated.

set_lock_pos_to_data(lock=True)¶

if lock is True, and the item is in a plot, then the position of the item will be locked to the data coordinates in the plot. The item will move with zooming and scrolling.

If lock is False, or the item is not in a plot, then the item will be fixed to the geometry of the window, and zooming/scrolling will not change its position.

set_log_x(log_mode=True)[source]¶: Set X axis to log mode.

set_log_y(log_mode=True)[source]¶: Set Y axis to log mode.

set_name(name)¶: Set the name of the object inside kst.

set_parent_auto()¶

Set the parent of the viewitem to an existing view item which fully contains it. Once reparented, moving/resizing the parent will also move/resize the child.

By default view items created by pyKst are parented by the toplevel view unless this method is called, or if the item is moved/resized in the GUI.

set_parent_toplevel()¶

Set the parent of the viewitem to the toplevel view.

By default view items created by pyKst are parented by the toplevel view unless set_parent_auto() is called, or if the item is moved/resized in the GUI.

set_pos(pos)¶

Set the center position of the item.

- +

Parameters:	pos – a 2 element tuple `(x,y)` specifying the position. -The Top Left of the parent is (0,0). -The Bottom Right of the parent is (1,1)
Parameters:	pos – a 2 element tuple `(x, y)` specifying the position. +The Top Left of the parent is (0, 0). +The Bottom Right of the parent is (1, 1)

set_right_label(label='')[source]¶: Set the plot right label

set_right_label_auto()[source]¶: Set the right label to auto generated.

set_rotation(rot)¶

Set the rotation of the item.

This is equivalent to setting Dimensions>Rotation within a view item dialog.

set_size(size)¶

Set the size of the item.

- +

Parameters:	size – a 2 element tuple `(w,h)` specifying the size.
Parameters:	size – a 2 element tuple `(w, h)` specifying the size.

Elements go from 0 to 1. If the aspect ratio is fixed, then h +

Elements go from 0 to 1. If the aspect ratio is fixed, then h is ignored.

This is equivalent to setting Dimensions>Position within a view +

This is equivalent to setting Dimensions>Position within a view item dialog in kst.

set_stroke_brush_color(color)¶

Set the color for lines for the item.

Colors are given by a name such as red or a hex number +

Colors are given by a name such as red or a hex number such as #FF0000.

set_stroke_brush_style(style)¶

Set the brush style for lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Brush Style +

This is equivalent to setting the index of Apperance>Stroke>Brush Style within a view item dialog in kst.

This sets the brush type for lines in the item, and not for the fill, +

This sets the brush type for lines in the item, and not for the fill, so values other than 1 (SolidPattern) only make sense for wide lines and are rarely used:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_stroke_cap_style(style)¶

Set the cap style for the ends of lines in the item.

This is equivalent to setting the index of Apperance>Stroke>Cap Style +

This is equivalent to setting the index of Apperance>Stroke>Cap Style within a view item dialog in kst.

0 is FlatCap, 1 is SquareCap, and 2 is RoundCap.

set_stroke_join_style(style)¶

Set the style by which lines are joined in the item.

This is equivalent to setting the index of Apperance>Stroke>Join Style +

This is equivalent to setting the index of Apperance>Stroke>Join Style within a view item dialog in kst.

0 is MiterJoin, 1 is BevelJoin, 2 is RoundJoin, and 3 is SvgMiterJoin.

set_stroke_style(style)¶

Set the stroke style of lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Style +

This is equivalent to setting the index of Apperance>Stroke>Style within a view item dialog in kst:

0: SolidLine       1: DashLine
-2: DotLine         3: DashDotLine 
+2: DotLine         3: DashDotLine
 4: DashDotDotLine  5: CustomDashLine
 

set_stroke_width(width)¶: Set the width of lines for the item.

set_top_label(label='')[source]¶: Set the plot top label

set_top_label_auto()[source]¶: Set the top label to auto generated.

set_x_ac(r)[source]¶

Set X zoom range to fixed range, centered around the mean.

Similar to AC coupling on an oscilloscope.

set_x_auto()[source]¶: Set X zoom range to autoscale

set_x_auto_border()[source]¶: Set X zoom range to autoscale with a small border

set_x_axis_display(display='yyyy/MM/dd h:mm:ss ap')[source]¶

if the x axis has been interpreted as time, set the display.

Display Types:

year:              display the decimal year
 qttextdtehhmmss:   <Qt Text Date> HH:MM:SS.SS
 qtlocaldatehhmmss: <Qt Local Date> HH:MM:SS.SS
 jd:                Julian Date
 mjd:               Modified Julian Date
 All others:        custom format
 

The custom format is defined as:

d         the day as number without a leading zero (1 to 31)
 dd        the day as number with a leading zero (01 to 31)
-ddd       the abbreviated localized day name (e.g. 'Mon' to 'Sun'). Uses the system locale to localize the name, i.e. QLocale::system().
-dddd      the long localized day name (e.g. 'Monday' to 'Qt::Sunday'). Uses the system locale to localize the name, i.e. QLocale::system().
+ddd       the abbreviated localized day name (e.g. 'Mon' to 'Sun').
+          Uses the system locale to localize the name, i.e. QLocale::system().
+dddd      the long localized day name (e.g. 'Monday' to 'Qt::Sunday').
+          Uses the system locale to localize the name, i.e. QLocale::system().
 M         the month as number without a leading zero (1-12)
 MM        the month as number with a leading zero (01-12)
-MMM       the abbreviated localized month name (e.g. 'Jan' to 'Dec'). Uses the system locale to localize the name, i.e. QLocale::system().
-MMMM      the long localized month name (e.g. 'January' to 'December'). Uses the system locale to localize the name, i.e. QLocale::system().
+MMM       the abbreviated localized month name (e.g. 'Jan' to 'Dec').
+          Uses the system locale to localize the name, i.e. QLocale::system().
+MMMM      the long localized month name (e.g. 'January' to 'December').
+          Uses the system locale to localize the name, i.e. QLocale::system().
 yy        the year as two digit number (00-99)
 yyyy      the year as four digit number
 h         the hour without a leading zero (0 to 23 or 1 to 12 if AM/PM display)
 hh        the hour with a leading zero (00 to 23 or 01 to 12 if AM/PM display)
 H         the hour without a leading zero (0 to 23, even with AM/PM display)
 HH        the hour with a leading zero (00 to 23, even with AM/PM display)
 m         the minute without a leading zero (0 to 59)
 mm        the minute with a leading zero (00 to 59)
 s         the second without a leading zero (0 to 59)
 ss        the second with a leading zero (00 to 59)
 z         the milliseconds without leading zeroes (0 to 999)
 zzz       the milliseconds with leading zeroes (000 to 999)
 AP or A   use AM/PM display. A/AP will be replaced by either "AM" or "PM".
 ap or a   use am/pm display. a/ap will be replaced by either "am" or "pm".
 t         the timezone (for example "CEST")
 

set_x_axis_interpretation(interp='ctime')[source]¶

Interpret the x axis as time

Parameters:	interp – interpret the time as follows

interp can be:

ctime: Standard unix C time
 year:  Decimal year
 jd:    Julian Date
 mjd:   Modified Julian Date
 excel: Time as used by MS Excel
 

set_x_axis_reversed(reversed=True)[source]¶: set the X axis to decreasing from left to right.

set_x_no_spike()[source]¶: Set X zoom range to spike insensitive autoscale

set_x_range(x0, x1)[source]¶: Set X zoom range from x0 to x1

set_y_ac(r)[source]¶

Set Y zoom range to fixed range, centered around the mean.

Similar to AC coupling on an oscilloscope.

set_y_auto()[source]¶: Set Y zoom range to autoscale

set_y_auto_border()[source]¶: Set Y zoom range to autoscale with a small border

-set_y_axis_reversed(reversed=True)[source]¶: set the Y axis to decreasing from bottom to top.

set_y_no_spike()[source]¶: Set Y zoom range to spike insensitive autoscale

set_y_range(y0, y1)[source]¶: Set Y zoom range from y0 to y1

subplot(*args)¶

Set the item position according to the given grid definition.

Typical call signature:

subplot(nrows, ncols, plot_number)
 

subplot(211)
 

place the plot in the top grid location (i.e. the first) in a 2 row by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned).

Interactive items¶

Interactive items are controls which are part of a kst view and use QtNetwork.QLocalSocket to notify the script when the user has interacted with them. They can only be created through scripts.

class pykst.Button(client, text, socket, posX=0.1, posY=0.1, sizeX=0.1, sizeY=0.1, rot=0)[source]¶

This represents a button inside a View. When the button is pressed, it sends a message via a socket.

socket is a QtNetwork.QLocalSocket that is not connected to anything. The message “clicked” will be sent -when the button is pressed. See the bonjourMonde example.

This represents a button inside a View. When the button is pressed, it sends a +message via a socket.

socket is a QtNetwork.QLocalSocket that is not connected to anything. The message +“clicked” will be sent when the button is pressed. See the bonjourMonde example.

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

remove()¶: This removes the object from Kst.

set_fill_color(color)¶

Set the fill/background color.

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

set_fill_style(style)¶

Set the background fill style.

This is equivalent to setting the index of Apperance>Fill>Style within +

This is equivalent to setting the index of Apperance>Fill>Style within a view item dialog in kst.:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_fixed_aspect_ratio(fixed=True)¶

if True, fix the aspect ratio of the item to its current value.

This is equivalent to checking Dimensions>Fix aspect ratio within a +

This is equivalent to checking Dimensions>Fix aspect ratio within a view item dialog in kst.

set_lock_pos_to_data(lock=True)¶

if lock is True, and the item is in a plot, then the position of the item will be locked to the data coordinates in the plot. The item will move with zooming and scrolling.

If lock is False, or the item is not in a plot, then the item will be fixed to the geometry of the window, and zooming/scrolling will not change its position.

set_name(name)¶: Set the name of the object inside kst.

set_parent_auto()¶

Set the parent of the viewitem to an existing view item which fully contains it. Once reparented, moving/resizing the parent will also move/resize the child.

By default view items created by pyKst are parented by the toplevel view unless this method is called, or if the item is moved/resized in the GUI.

set_parent_toplevel()¶

Set the parent of the viewitem to the toplevel view.

By default view items created by pyKst are parented by the toplevel view unless set_parent_auto() is called, or if the item is moved/resized in the GUI.

set_pos(pos)¶

Set the center position of the item.

- +

Parameters:	pos – a 2 element tuple `(x,y)` specifying the position. -The Top Left of the parent is (0,0). -The Bottom Right of the parent is (1,1)
Parameters:	pos – a 2 element tuple `(x, y)` specifying the position. +The Top Left of the parent is (0, 0). +The Bottom Right of the parent is (1, 1)

set_rotation(rot)¶

Set the rotation of the item.

This is equivalent to setting Dimensions>Rotation within a view item dialog.

set_size(size)¶

Set the size of the item.

- +

Parameters:	size – a 2 element tuple `(w,h)` specifying the size.
Parameters:	size – a 2 element tuple `(w, h)` specifying the size.

Elements go from 0 to 1. If the aspect ratio is fixed, then h +

Elements go from 0 to 1. If the aspect ratio is fixed, then h is ignored.

This is equivalent to setting Dimensions>Position within a view +

This is equivalent to setting Dimensions>Position within a view item dialog in kst.

set_stroke_brush_color(color)¶

Set the color for lines for the item.

Colors are given by a name such as red or a hex number +

Colors are given by a name such as red or a hex number such as #FF0000.

set_stroke_brush_style(style)¶

Set the brush style for lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Brush Style +

This is equivalent to setting the index of Apperance>Stroke>Brush Style within a view item dialog in kst.

This sets the brush type for lines in the item, and not for the fill, +

This sets the brush type for lines in the item, and not for the fill, so values other than 1 (SolidPattern) only make sense for wide lines and are rarely used:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_stroke_cap_style(style)¶

Set the cap style for the ends of lines in the item.

This is equivalent to setting the index of Apperance>Stroke>Cap Style +

This is equivalent to setting the index of Apperance>Stroke>Cap Style within a view item dialog in kst.

0 is FlatCap, 1 is SquareCap, and 2 is RoundCap.

set_stroke_join_style(style)¶

Set the style by which lines are joined in the item.

This is equivalent to setting the index of Apperance>Stroke>Join Style +

This is equivalent to setting the index of Apperance>Stroke>Join Style within a view item dialog in kst.

0 is MiterJoin, 1 is BevelJoin, 2 is RoundJoin, and 3 is SvgMiterJoin.

set_stroke_style(style)¶

Set the stroke style of lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Style +

This is equivalent to setting the index of Apperance>Stroke>Style within a view item dialog in kst:

0: SolidLine       1: DashLine
-2: DotLine         3: DashDotLine 
+2: DotLine         3: DashDotLine
 4: DashDotDotLine  5: CustomDashLine
 

set_stroke_width(width)¶: Set the width of lines for the item.

set_text(text)[source]¶: Sets the text of the button.

subplot(*args)¶

Set the item position according to the given grid definition.

Typical call signature:

subplot(nrows, ncols, plot_number)
 

subplot(211)
 

place the plot in the top grid location (i.e. the first) in a 2 row by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned).

class pykst.LineEdit(client, text, socket, posX=0.1, posY=0.1, sizeX=0.1, sizeY=0.1, rot=0)[source]¶

This represents a line edit inside a View. When the lineedit’s value is changed, it sends a message via a socket.

socket is a QtNetwork.QLocalSocket that is not connected to anything. The message “valueSet:VAL” where VAL is some text -will be sent when the text is changed. See the ksNspire example.

This represents a line edit inside a View. When the lineedit’s value is changed, +it sends a message via a socket.

socket is a QtNetwork.QLocalSocket that is not connected to anything. The message +“valueSet:VAL” where VAL is some text will be sent when the text is changed. +See the ksNspire example.

description_tip()¶: Returns a string describing the object

name()¶: Returns the name of the object from inside kst.

remove()¶: This removes the object from Kst.

set_fill_color(color)¶

Set the fill/background color.

Colors are given by a name such as red or a hex number such +

Colors are given by a name such as red or a hex number such as #FF0000.

set_fill_style(style)¶

Set the background fill style.

This is equivalent to setting the index of Apperance>Fill>Style within +

This is equivalent to setting the index of Apperance>Fill>Style within a view item dialog in kst.:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_fixed_aspect_ratio(fixed=True)¶

if True, fix the aspect ratio of the item to its current value.

This is equivalent to checking Dimensions>Fix aspect ratio within a +

This is equivalent to checking Dimensions>Fix aspect ratio within a view item dialog in kst.

set_lock_pos_to_data(lock=True)¶

if lock is True, and the item is in a plot, then the position of the item will be locked to the data coordinates in the plot. The item will move with zooming and scrolling.

If lock is False, or the item is not in a plot, then the item will be fixed to the geometry of the window, and zooming/scrolling will not change its position.

set_name(name)¶: Set the name of the object inside kst.

set_parent_auto()¶

Set the parent of the viewitem to an existing view item which fully contains it. Once reparented, moving/resizing the parent will also move/resize the child.

By default view items created by pyKst are parented by the toplevel view unless this method is called, or if the item is moved/resized in the GUI.

set_parent_toplevel()¶

Set the parent of the viewitem to the toplevel view.

By default view items created by pyKst are parented by the toplevel view unless set_parent_auto() is called, or if the item is moved/resized in the GUI.

set_pos(pos)¶

Set the center position of the item.

- +

Parameters:	pos – a 2 element tuple `(x,y)` specifying the position. -The Top Left of the parent is (0,0). -The Bottom Right of the parent is (1,1)
Parameters:	pos – a 2 element tuple `(x, y)` specifying the position. +The Top Left of the parent is (0, 0). +The Bottom Right of the parent is (1, 1)

set_rotation(rot)¶

Set the rotation of the item.

This is equivalent to setting Dimensions>Rotation within a view item dialog.

set_size(size)¶

Set the size of the item.

- +

Parameters:	size – a 2 element tuple `(w,h)` specifying the size.
Parameters:	size – a 2 element tuple `(w, h)` specifying the size.

Elements go from 0 to 1. If the aspect ratio is fixed, then h +

Elements go from 0 to 1. If the aspect ratio is fixed, then h is ignored.

This is equivalent to setting Dimensions>Position within a view +

This is equivalent to setting Dimensions>Position within a view item dialog in kst.

set_stroke_brush_color(color)¶

Set the color for lines for the item.

Colors are given by a name such as red or a hex number +

Colors are given by a name such as red or a hex number such as #FF0000.

set_stroke_brush_style(style)¶

Set the brush style for lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Brush Style +

This is equivalent to setting the index of Apperance>Stroke>Brush Style within a view item dialog in kst.

This sets the brush type for lines in the item, and not for the fill, +

This sets the brush type for lines in the item, and not for the fill, so values other than 1 (SolidPattern) only make sense for wide lines and are rarely used:

 NoBrush          1:  SolidPattern
 Dense1Pattern    3:  Dense2Pattern
 Dense3Pattern    5:  Dense4Pattern
 Dense5Pattern    7:  Dense6Pattern
 Dense7Pattern    9:  HorPattern
-11: VerPattern       12: CrossPattern, 
+11: VerPattern       12: CrossPattern,
BDiagPattern     14: FDiagPattern.
 

set_stroke_cap_style(style)¶

Set the cap style for the ends of lines in the item.

This is equivalent to setting the index of Apperance>Stroke>Cap Style +

This is equivalent to setting the index of Apperance>Stroke>Cap Style within a view item dialog in kst.

0 is FlatCap, 1 is SquareCap, and 2 is RoundCap.

set_stroke_join_style(style)¶

Set the style by which lines are joined in the item.

This is equivalent to setting the index of Apperance>Stroke>Join Style +

This is equivalent to setting the index of Apperance>Stroke>Join Style within a view item dialog in kst.

0 is MiterJoin, 1 is BevelJoin, 2 is RoundJoin, and 3 is SvgMiterJoin.

set_stroke_style(style)¶

Set the stroke style of lines for the item.

This is equivalent to setting the index of Apperance>Stroke>Style +

This is equivalent to setting the index of Apperance>Stroke>Style within a view item dialog in kst:

0: SolidLine       1: DashLine
-2: DotLine         3: DashDotLine 
+2: DotLine         3: DashDotLine
 4: DashDotDotLine  5: CustomDashLine
 

set_stroke_width(width)¶: Set the width of lines for the item.

set_text(text)[source]¶: Sets the text of the line edit.

subplot(*args)¶

Set the item position according to the given grid definition.

Typical call signature:

subplot(nrows, ncols, plot_number)
 

subplot(211)
 

place the plot in the top grid location (i.e. the first) in a 2 row by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned).

Pykstplot¶

pykstplot re-implements a tiny subset of matplotlib.pyplot. It is included by importing pykstplot, and is conceptually incompatible with pykst.

pykstplot.figure()[source]¶: Creates a new tab in kst.

pykstplot.loglog(*args, **kwargs)[source]¶: Add a curve to the current axis (or make a new one) with log-log scaling. All parameters are the same as plot().

pykstplot.plot(*args, **kwargs)[source]¶

Plot lines and/or markers to a kst window. args is a variable length argument, allowing for multiple x, y pairs with an optional format string. For example, each of the following is legal:

plot(x, y)        # plot x and y using default line style and color
 plot(x, y, 'bo')  # plot x and y using blue circle markers
 plot(y)           # plot y using x as index array 0..N-1
 plot(y, 'r+')     # ditto, but with red plusses
 

An arbitrary number of x, y, fmt groups can be specified, as in:

a.plot(x1, y1, 'g^', x2, y2, 'g-')
 

By default, each line is assigned a different color in kst.

The following format string characters are accepted to control the line style or marker:

character description

'-' solid line style

'--' dashed line style

'-.' dash-dot line style

':' dotted line style

'.' point marker

',' pixel marker

'o' circle marker

'v' triangle_down marker

'^' triangle_up marker

's' square marker

'*' star marker

'+' plus marker

'x' x marker

'D' diamond marker

The following color abbreviations are supported:

character color

‘b’ blue

‘g’ green

‘r’ red

‘c’ cyan

‘m’ magenta

‘y’ yellow

‘k’ black

‘w’ white

Line styles and colors are combined in a single format string, as in 'bo' for blue circles.

The kwargs can be used to set the color, the line width, the line type, and the legend label. You can specify colors using full names ('green'), or hex strings ('#008000').

Some examples:

plot([1,2,3], [1,2,3], 'go-', label='line 1', linewidth=2)
 plot([1,2,3], [1,4,9], 'rs',  label='line 2')
 axis([0, 4, 0, 10])
 legend()
 

If you make multiple lines with one plot command, the kwargs apply to all those lines, e.g.:

plot(x1, y1, x2, y2, linewidth=2)
 

Both lines will have a width of 2.

You do not need to use format strings, which are just abbreviations. All of the line properties can be controlled by keyword arguments. For example, you can set the color, marker, linestyle, and markercolor with:

plot(x, y, color='green', linestyle='dashed', marker='o',
 color='blue', markersize=12).
 

Supported kwargs are:

color
 label
 linestyle
 linewidth
 markersize
 

pykstplot.savefig(fname, **kwargs)[source]¶

Export the kst session as a series of graphics files. If there is only 1 tab, then the file will be called fname. If there are multiple tabs, the files will be called, for example, fname_1.png, fname_2.png, etc.

The plot will be have the same aspect ratio as the kst session, and, for pixel based formats, will be 1280 pixels wide.

The format is determined by the format kwarg, or by the fname extension if format is not defined.

All formats supported by kst are supported, including, among many others, png, jpg, eps, svg, and pdf.

pykstplot.semilogx(*args, **kwargs)[source]¶: Add a curve to the current axis (or make a new one) with log scaling on the X axis. All parameters are the same as plot().

pykstplot.semilogy(*args, **kwargs)[source]¶: Add a curve to the current axis (or make a new one) with log scaling on the Y axis. All parameters are the same as plot().

pykstplot.show()[source]¶: This method does nothing, but exists for compatibility with matplotlib scripts.

pykstplot.subplot(*args, **kwargs)[source]¶

Return a subplot axes positioned by the given grid definition.

Typical call signature:

subplot(nrows, ncols, plot_number)
 

subplot(211)
 

produces a subaxes in a figure which represents the top plot (i.e. the first) in a 2 row by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned).

Note

unlike matplotlib.pyplot.subplot(), creating a new subplot with a position which is entirely inside a pre-existing axes will not delete the previous plot.

Keyword arguments:

axisbg:

The background color of the subplot, which can be any valid color specifier.

pykstplot.title(s)[source]¶: Set the top axis label of the current axis.

pykstplot.xlabel(s)[source]¶: Set the x axis label of the current axis.

pykstplot.ylabel(s)[source]¶: Set the y axis label of the current axis.

character	description
`'-'`	solid line style
`'--'`	dashed line style
`'-.'`	dash-dot line style
`':'`	dotted line style
`'.'`	point marker
`','`	pixel marker
`'o'`	circle marker
`'v'`	triangle_down marker
`'^'`	triangle_up marker
`'s'`	square marker
`'*'`	star marker
`'+'`	plus marker
`'x'`	x marker
`'D'`	diamond marker

character	color
‘b’	blue
‘g’	green
‘r’	red
‘c’	cyan
‘m’	magenta
‘y’	yellow
‘k’	black
‘w’	white

All modules for which code is available

Source code for pykst

Source code for pykstplot

' + _('Searching') + '

Index

A

B

C

D

E

F

G

H

I

L

M

N

O

P

Q

R

S

T

U

V

W

X

Y

PyKst documentation¶

Installation¶

Examples¶

Clients¶

Primitives¶

Scalars¶

Vectors¶

Matrices¶

Strings¶

Data Objects¶

Equations¶

Spectra¶

Histograms¶

Linear Fit¶

Polynomial Fit¶

Flag Filter¶

Relations¶

Curves¶

Images¶

Annotations¶

Interactive items¶

Pykstplot¶

Python Module Index

Search