PLOT_BINTREE(1)

NAME
plot_bintree -- Plot the structure of a binary tree classifier.

SYNOPSIS
Plot structure and some node information for a pruned binary tree classifier.

plot_bintree [-fparam file] [-fplot file]
[-fdescribe file]
[-autoscale] [-no_text] [-no_graphics] [-max_nodes n]
[-prune_tree]

DESCRIPTION
Displays tree structure for a previously trained binary tree classifier. The graph can be scaled to display the whole tree or the scale can be left at a default value. Text describing certain node parameters is also displayed. For a non-terminal node the split value is printed inside the circle representing the node. The input parameter number used in the test is displayed below the circle. Lines are drawn to each node's left and right children and the number patterns to each child during training is displayed. For terminal nodes a square is displayed to represent the node. The classification error rate for the patterns assigned to the node is displayed inside the square. The name or number of the terminal node's class is displayed below the square.

EXAMPLE
bintree -train -create -pathdata $LNKHOME/data/class \
-finput disjoint.train -fdescribe disjoint.defaults \
-fparam bintree.param

plot_bintree -fparam bintree.param

OPTIONS

--  Prints a list of all flags and arguments.

-fparam file
    Parameter file for previously trained bintree classifier.

-fplot file
    File to store generated bintree structure plot.

-fdescribe file
    Defaults file containing the class labels for the data base used to train the bintree classifier. If this flag is set, the terminal node classes will be indicated by the class labels. Otherwise, the class numbers will be used.

-autoscale
    Scale the plot vertically and horizontally so that all the nodes in the tree are visible and the tree fills the plotting window.

-no_text
    Only print the tree structure. Do not print node parameters.

-no_graphics
    Create the plot file, /fIfplot/fR, but do not display it in an olxplot window.

-prune_tree
    Prune the binary tree before plotting. The default is to display the whole tree.

-max_nodes n
    If prune_tree is set, cut non-terminal nodes from the tree until at most n nodes remain.

SEE ALSO
bintree_lnk(1)

HISTORY
First written July 1993.
Modified 22 June 1994, replaced height and width with autoscale.
Modified 19 April 1995, added no_graphics flag

BUGS
When plot2ps is used to generate a postscript file from the bintree plot file, the font for the node text may have to be scaled to match the scale of the plot.
Send bug reports to Linda Kukolich (kukolich@sst.ll.mit.edu)