PLOT_MLP(1)

NAME
plot_mlp -- Plot the structure of a Multi-Layer Perceptron classifier.

SYNOPSIS
plot_mlp [-fparam file] [-fplot file]
[-fdescribe file] [-autoscale] [-threshold x]
[-show_weight_magnitude -max_line_width n -bw]
[-show_bias] [-no_text] [-no_graphics]

DESCRIPTION
Displays node structure for a previously trained Multi-Layer Perceptron classifier. The graph can be scaled to display the whole structure or the scale can be left at a default value. The input nodes are represented by small black circles at the bottom of the graph. The input feature labels are written below these circles. The output nodes are represented by large white circles at the top of the graph. The output class labels are written above these circles. Between the input and output layers are the hidden layers. The hidden layer nodes are represented by large white circles. Each node in a layer is connected to each node in the next layer. These are weighted connections and the magnitudes of the weights can be shown by changing the thickness of the connecting lines. Connections with very small weights can be left off the graph. The input layer and hidden layers all have a bias node which is shown as a black square. Each bias node has no connections to the layer below, but is fully connected to the network layer above.

EXAMPLE
mlp -train -create -pathdata $LNKHOME/data/class \
-finput XOR.train -fdescribe XOR.defaults \
-fparam mlp.param -epochs 100 -nodes 2,4,2

plot_mlp -fparam mlp.param \
-fdescribe $LNKHOME/data/class/XOR.defaults

OPTIONS

--  Prints a list of all flags and arguments.

-fparam file
    Parameter file for previously trained mlp classifier.

-fplot file
    File to store generated mlp structure plot.

-fdescribe file
    Defaults file containing the class labels for the data base used to train the mlp 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 classifier are visible and the classifier fills the plotting window.

-threshold x
    Do not draw lines for weights with a magnitude less than x.

-show_weight_magnitude
    Draw thicker lines for weights with larger magnitudes.

-max_line_width n
    n is the width of the line for the weight with the largest magnitude.

-bw When -show_weight_magnitude is selected, show negative weights as hollow. The default is to show them as orange lines.

-show_bias
    Show the bias node on each layer. If this flag is not set, the bias nodes are not drawn.

-no_text
    Only print the classifier structure. Do not print input or output labels.

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

SEE ALSO
mlp_lnk(1)

HISTORY
First written June 1994
Modified 19 April 1995, added no_graphics and bw flags

BUGS
When plot2ps is used to generate a postscript file from the mlp 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)