The GUI

the plt_ panel

graphical objects

adapted from
PLoS supp. material by Hermann Cuntz

← the_ele_panel

The plt_ panel offers a number of ways to create graphical objects relating to the active tree, its nodes and the Nx1 vector values and node index selection determined in the slt_ panel. The various functions result in objects which are addressed as handle packages (see below). Each new handle package is added as a new entity in the popup and can be edited in various ways.

„cla“ of the vis_ panel deletes all plt_ panel handles at once!

A handle for example produced by plot_tree has a number of attributes accessed by the Matlab function „get“:

>> HP = plot_tree (sample_tree)

>> get (HP)

AlphaDataMapping = scaled
Annotation = [ (1 by 1) hg.Annotation array]
CData = [ (4 by 1576 by 3) double array]
CDataMapping = scaled
DisplayName =
FaceVertexAlphaData = []
FaceVertexCData = [ (3152 by 3) double array]
EdgeAlpha = [1]
EdgeColor = [0 0 0]
FaceAlpha = [1]
FaceColor = interp
Faces = [ (1576 by 4) double array]
LineStyle = none
LineWidth = [0.5]
Marker = none
...

Change one of the attributes with the Matlab function „set“. For example make render the handle red:

>> set(HP,'facecolor',[1 0 0])

The examples that follow are different plotting options provided by the TREES toolbox. For the purpose of illustration, the branch order was mapped onto the nodes (BO Nx1 vector in the slt_ panel) and a sub-tree was selected (using the subtree function of the slt_ panel):

Each plotting function creates a handle package. These handle packages can then be browsed post hoc, altered or deleted.

The examples on the previous pages produce handle packages with different attributes. With the plt_ panel some of these attributes can be altered in the active handle package in those handles in which the corresponding attributes are available.