PLOT_PERR(1)

NAME
plot_perr - Plot program for error rate results during iterative training of LNKnet classifiers.

SYNOPSIS
Plots average error rate every n trials during training for iterativly trained LNKet classifiers. The error file verbosity flag, verror, must be greater than or equal to 1 during training to generate a percent error plot.

plot_perr [ -pathexp directory ] [ -ferror file ]
[ -fplot file ] [ -autoscale ] [ -xmin x ] [ -xmax x ]
[ -xstep x ] [ -ymin x ] [ -ymax x ] [ -ystep x ]
[ -trials n ] [ -title string ] [ -mac ]
[ -fmaclines file ]

EXAMPLE
This example trains a Multi-Layer Perceptron classifier for 40 epochs, presenting all 338 patterns in the vowel training file 40 times. The pattern by pattern classification results are stored in X1mlp.err.train. plot_perr then plots the error rate over the training, averaging the number of errors during each epoch.

mlp -epochs 40 -train -create -nodes 2,25,10 -etta .1 \
-pathdata $LNKHOME/data/class -finput vowel.train \
-fdescribe vowel.defaults -npatterns 338 \
-ferror mlp.err.train -verror 1

plot_perr -pathexp ./ -ferror mlp.err.train -autoscale \
-trials 338

OPTIONS

--  Prints a list of all flags and arguments.

-pathexp directory
    Directory where ferror and fplot are stored.

-ferror file
    File where pattern by pattern classification results during training are stored.

-fplot file
    File for storing plot.

-autoscale
    If this flag is set, the values in the parameter file ferror will be used to set the scales for the X and Y axes.

-xmin x
    If autoscale is not set, the lower limit of the N_patterns axis for the plot.

-xmax x
    If autoscale is not set, the upper limit of the N_patterns axis for the plot.

-xstep x
    If autoscale is not set, the space between tic marks on the N_patterns axis for the plot.

-ymin x
    If autoscale is not set, the lower limit of the error rate axis for the plot.

-ymax x
    If autoscale is not set, the upper limit of the error rate axis for the plot.

-ystep x
    If autoscale is not set, the space between tic marks on the error rate axis for the plot.

-title string
    Title for plot.

-trials n
    The number of pattern results to average to generate each point on the plot.

-mac
    If this flag is set, the points in the plot will be written to the file -fmaclines.

-fmaclines file
    This is an ASCII file containing the data used to create the error plot. Each line contains the number of patterns presented so far and the error rate for the last trials patterns. This file can be used to generate plots on a MacIntosh or other PC using a spread-sheet graphing program such as Excel or DeltaGraph.

SEE ALSO
classifier(1), cknn_lnk(1), gmix_lnk(1), hyper_lnk(1), irbf_lnk(1), lvq_lnk(1), mlp_lnk(1)

HISTORY
First written 5 July 1993 by Linda Kukolich
Modified 22 June 1994, took out line_type

BUGS
Send bug reports to Linda Kukolich (kukolich@sst.ll.mit.edu)