PCASYSX

Name

pcasysx -- fingerprint classifier demo, graphical version

Synopsis

pcasysx [prsfile]

DESCRIPTION

Pcasysx is the graphical fingerprint classifier demo program. It reads a sequence of image files, each depicting one box as scanned from a fingerprint card, and classifies each fingerprint, using a Multi-Layer Perceptron (MLP) or Probabilistic (PNN) Neural Network, to one of six pattern-level classes: Arch, Left loop, Right loop, Scar, Tented arch, and Whorl. The type of classifier MLP or PNN is chosen in the parameters file pcasys/parms/pcasys.prs. Additional parameters specific to pcasysx are in pcasys/parms/pcasysx.prs.

Pcasysx produces screen graphics illustrating the results of the processing phases (requires X Windows). It optionally makes an output file, containing a results line for each fingerprint and a summary at the end showing the error rate and the "confusion matrix", and it optionally writes progress messages to the standard output.

Pcasysx will look in the default location pcasys/parms for the default parameter files it needs. There are prototype and weights files in pcasys/weights/{mlp|pnn} that are needed by the MLP and PNN classifiers and images needed for the graphics display in pcasys/images. If NFIS was installed in a location other than /usr/local/nfis the INSTALL_DIR in include/little.h will need to be changed and the code recompiled. Also, the current default location for the 2700 sample fingerprint images is test/pcasys/data/images. If the user wants to save disk space, these images could be left on a mounted CDROM and a link made from the images directory on the CDROM to the image directory where the software is installed.

OPTIONS

[prsfile]

A file containing one or more parameter values that are to override the default values. To find out what the parameters are, and as examples of the format of a parameters file, consult the default parameters files that pcasysx reads, namely pcasys/parms/oas.prs, pcasys/parms/pcasys.prs, and pcasys/parms/pcasysx.prs, which are described in the section PARAMETER FILES. Each line, in the parms file consists of a parameter name followed by a value; a pound sign indicates that the rest of its line is a comment. If pcasysx is run with no argument, i.e. not specifying a user parameters file, then it uses the default values of all parameters.

PARAMETER FILES

pcasys/parms/oas.prs

Contains default values of the parameters that affect the making of orientation arrays (oas): these are the parms of the segmentor (sgmnt), the image enhancer (enhnc), the ridge-valley orientation finder (rors), the registration program (r92a), and the registration-implementing pixelwise orientations reaverager (rgar). The values used for these parms when making the oas used in optimizing the classifier should also be used when running the finished classifier. See the mkoas man page for more information about the parameters in this file.

pcasys/parms/pcasys.prs

Contains default values of the parameters for pcasysx. Also look at pcasys.mlp and pcasys.pnn for examples on using each classifier. See the pcasys man page for more information about the parameters in this file.

pcasys/parms/pcasysx.prs

Contains default values of parameters, in addition to pcasys/parms/pcasys.prs, that are specific to pcasysx.

Default settings in pcasys/parms/pcasysx.prs

Parameters for the graphical demo, pcasysx, that control sleeping (pausing) after displaying various intermediate results. Value -1 is also allowed: that means wait for user to type enter key before continuing.

sleeps_titlepage 0

after title page

sleeps_sgmntwork 1

intermediate results of segmentor

sleeps_segras 0

segmented image

sleeps_enhnc 1

enhanced image

sleeps_core_medcore 3

ridge-orientation bars, core, standard core

sleeps_regbars 2

registered ridge-orientation bars

sleeps_featvec 1

bar graph of feature vector input to PNN

sleeps_normacs 2

bar graph of normalized PNN outputs

sleeps_foundconup 1

found a concave-upward pseudoridge (conup)

sleeps_noconup 0

all pseudoridges, if no conup is found

sleeps_lastdisp 2

results display for the fingerprint

Mouse control parameter:

warp_mouse n

If y (yes), then warp the mouse pointer into graphical window so its colormap takes effect. If n (no), no warping.

PCASYS I/O parameters.

outfile pcasysx.out

Output file to be produced. If no output file is wanted, set this to /dev/null.

EXAMPLE(S)

From test/pcasys/execs/pcasys/pcasys.src:

% pcasysx Runs the pcasysx demo using the default settings found in pcasys/parms/pcasysx.prs.

% pcasysx myprsfile Runs the pcasysx demo using parameters set in myprsfile to change the value of the default settings.

SEE ALSO

pcasys (1A)

AUTHOR

NIST/ITL/DIV894/Image Group