COMMAND(1)

NAME
mktree - make a decision tree and optionally prune and test it

SYNOPSIS
mktree [options] stem

DESCRIPTION

mktree is a "csh" script that runs tgen and optionally tprune and tclass on the data set with file stem stem. This assumes an attribute file "stem.attr" exists and a training data file "stem.bld" exists or an encoded file "stem.enc" exists.

Pruned trees (class probability trees) are output to file "stem.tree". The original unpruned trees (counts trees) will be in "stem.treec". Control is given other things like memory and time usage, verbose level, nice level, timing statistics, etc. By default, all IND subroutines and niced, and given time and memory bounds.

A typical command sequence to run on the text version of the "hypo" data set might be:

    # run tgen on hypo.bld, tprune and tclass on hypo.tst in "cart" style
    mktree -e -s cart -v hypo

Alternatively, you could do sampling in mktree if you had earlier encoded the data file (see enc(1).) In this case you do:

    # first select a sample from hypo.enc of 500 using seed 1234
    encsmpl S,500,1234 hypo
    mktree -s cart -v hypo

Some common forms can be set up using the style option (-s). Learn about these using the verbose option (-v). Note that arguments to be passed to tgen, tprune, and tclass should be enclosed in quotes.

OPTIONS

-c clopts
    Run tclass on all trees with options clopts, with output to standard output. The argument clopts should be enclosed in quotes. See tclass (1) for tclass options.

-D  Echo the shell commands issued by mktree. This option is useful for debugging or learning how to use the system.

-e  By default the encoded data file "stem.enc" is sampled for training and test data. With this option, a file "stem.bld" is used for training and a file "stem.tst" is used for testing by tclass.

-H sampleopts
    Pass on this flag to both tgen and tclass. This allows you to sample data from the encoded file for the run.

-i nice
    Automatically nices everything (see the "csh" "nice" command) to this value. Default is 10.

-m datasize
    Never let any program use more than this memory. Only usually a problem with the -J option in tgen. See "limit datasize" in csh. Default is 12Mb (i.e., "-m 12m" or "-m 12000k").

-n tname
    Place tree in file "stem.treetname ("stem.tree" followed by tname).

-o genopts
    Pass argument genopts as options to tgen. The argument genopts should be enclosed in quotes. See tgen(1) for tgen options. Multiple use of this option simply appends the arguents.

-p propts
    Run tprune with options propts on all trees. The argument propts should be enclosed in quotes. See tprune(1) for tprune options.

-s style
    Set up the generation (-o) and pruning (-p) options to produce trees of a particular style. These are described in the user manual in the section on standard option sets. To see the style options set, use the -v option to display IND commands before they are run. The styles are: cart, c4, id3, mml, smml, look, bayes, opt, dgraph, dgraphwan. Subsequent use of the -o, -p or -s flags overlays the style so two styles can be combined together, for instance Bayesian lookahead is generated by "-s bayes -s look". The "look" style combines with all others except cart, c4 and id3.

-t cputime
    Never let any program use more than this many seconds. (See "limit cputime" in "csh" ) Default is 2000 seconds (i.e. "-t 2000").

-T  Time the tgen, tprune and tclass commands called using the "time" command in "csh". This automatically sets the -v option. Timing results are printed.

-v  Verbose option. Prints out calls made to tgen, tprune and tclass. Use to find out what was run. Use twice to set the verbose options recursively in tgen and tprune.

SEE ALSO
attr(1), enc(1), tclass(1), tgen(1), tprune(1), ttest(1).