HMINE(1)																  HMINE(1)

NAME

       hypex - computes the Chernoff exponent between two simple categories.

SYNOPSIS

       hypex [-hH size] [-s stepsize] CATDUMP1 CATDUMP2

       hmine -V

DESCRIPTION

       hypex  reads  two  category  dumps produced by dbacl(1) after learning.	A category dump is obtained using the -d and -l switches, and is a
       textual representation of the feature weights which exist in the binary category files.

       Given two such category dumps for simple unigram categories, hypex calculates the Kullback Leibler divergence between the probability  mod-
       els, and prints out exponential error exponents for Neyman-Pearson hypothesis tests under a range of threshold values. See Cover and Thomas
       (1991) Elements of Information Theory, Chap. 12.

       Note that only simple categories are supported, and the output only makes sense under appropriate theoretical conditions. This  is  a  very
       specialized calculator.

EXIT STATUS

       hypex returns 0 on success, 1 if an error occurs.

OPTIONS

       -h

       -H     Same as dbacl(1). Selects the hash sizes in powers of two.

       -s     Stepsize	for the threshold.  hypex outputs exponents for different values of the threshold, within an interval bounded by the Kull-
	      back Leibler divergences between the categories.

       -V     Print the program version number and exit.

SOURCE

       The source code for the latest version of this program is available at the following locations:

       http://www.lbreyer.com/gpl.html
       http://dbacl.sourceforge.net

BUGS

       Doesn't work with complex categories, and theoretical assumptions are unrealistic in practice.

AUTHOR

       Laird A. Breyer <laird@lbreyer.com>

SEE ALSO

       dbacl(1), mailcross(1), mailfoot(1), mailinspect(1), mailtoe(1), regex(7)

Version 1.12						   Bayesian Classification Tools						  HMINE(1)