bionic (1) hypex.1.gz

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 models, 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 Kullback 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)