    DFT-CASES:  Generate cases from a Dirichlet diffusion tree model.

    Dft-cases produces a data file containing the target values for cases
    generated from a diffusion tree model.  The diffusion tree(s)
    underlying these cases may optionally be displayed as well.

    Usage:

        dft-cases [ -# ] [ -b ] [ -h ] [ -p ] [ -l ] [ -t ] [ -g ] [ -n | -N ]
          log-file index output-file n-cases [ random-seed ] [ new-log-file ]

    Values for the targets in n-cases cases are generated and stored in
    the specified output file, one per line, overwriting any data it
    previously contained.  If no training data has been specified, the
    generated cases will come from the prior distribution conditional on
    the overall hyperparameters and diffusion tree parameters stored in
    the log file under the specified index.  If training data has been
    supplied, the cases will be generated from the posterior distribution
    given the training data, as represented by the hyperparameters,
    parameters, latent vectors, and diffusion trees(s) for training cases
    that are stored under that index.

    Including a flag of the form -#, where # is a digit from 1 up to the
    number of trees in the model, causes the data written to output-file
    to be the values generated at the terminal nodes for that tree, rather
    than the final values for observable variables.  This allows one to
    examine the contributions of the different trees, since running
    dft-cases more than once with different values for this option, or
    without it, but with other arguments such as the random number seed
    the same, will display components of the same randomly-generated data.

    If one or more other flags are specified, the overall hyperparameters,
    diffusion tree parameters, latent vectors, tree structures, or node
    descriptions will be displayed on standard output, in the format
    documented in dft-display.doc, with the newly generated cases
    following the training cases (if any).  By default, none of this
    information is displayed.  When -l or -N is specified, values for
    latent vectors or node locations are displayed even if they are not
    stored in the log file - they are randomly generated if necessary
    (assuming that this is possible for the model being used).

    The random number seed used for generating the cases may be specified
    at the end of the command line.  If it is omitted, index is used as
    the seed.

    If the final new-log-file argument is present, records of the overall
    hyperparameters, diffusion tree parameters, latent vectors, tree
    structures, and node locations for both the original cases and the
    newly-generated cases will be appended to the log file with this name,
    with an index one greater than the index of the current last record.
    This log file should already contain model and data specifications,
    which must be compatible with the records written (though this is not
    checked).  This facility allows a new chain to be run starting from
    the generated state, which is useful for testing.

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