DFT-GEN:  Generate parameters randomly from the prior, or fix them.

Dft-gen writes a series of independently-generated values for the
overall hyperparameters and diffusion tree parameters to a log file.

Usage:

    dft-gen log-file [ max-index ] [ "fix" [ SD-value ] ]

Records of parameters with indexes from zero up to the indicated index
are generated (the default is max-index of zero).  If the log file
already contains records with some of these indexes, only records with
indexes greater than the last existing record are generated.

If just max-index is specified, the parameters are generated randomly
from the prior, using the random number seed taken from the log file
(eg, as specified by rand-seed).

The "fix" option is useful for initializing iterative programs.  If it
is given, the parameters are not generated at random, but are instead
set to fixed values.  The noise standard deviation hyperparameters and
the diffusion tree standard deviations will be fixed to the value
given after "fix", or at the location parameter of their prior
distribution, if no such value is specified.  The parameters of the
divergence function are fixed at the location parameter of their prior
distribution.

No data model is required to use dft-gen, but if a model is specified,
the hyperparameters associated with it are generated as well.

Note that dft-gen does not generate any actual diffusion trees to go
with the training cases, nor does it generate latent values for
training cases.

            Copyright (c) 1995-2004 by Radford M. Neal