NAME

       mlpack_det - density estimation with density estimation trees

SYNOPSIS

        mlpack_det [-f int] [-m unknown] [-L int] [-l int] [-p string] [-s bool] [-T string] [-t string] [-V bool] [-M unknown] [-c string] [-g string] [-E string] [-e string] [-i string] [-h -v]

DESCRIPTION

       This  program  performs  a  number  of  functions related to Density Estimation Trees. The
       optimal Density Estimation Tree (DET) can be trained  on  a  set  of  data  (specified  by
       '--training_file  (-t)')  using  cross-validation (with number of folds specified with the
       '--folds (-f)' parameter). This trained density estimation tree may then be saved with the
       '--output_model_file (-M)' output parameter.

       The  variable  importances (that is, the feature importance values for each dimension) may
       be saved with the '--vi_file (-i)' output parameter, and the density  estimates  for  each
       training   point  may  be  saved  with  the  ’--training_set_estimates_file  (-e)'  output
       parameter.

       Enabling path printing for each node outputs the path from the root node  to  a  leaf  for
       each  entry in the test set, or training set (if a test set is not provided). Strings like
       'LRLRLR' (indicating that traversal went to the left child, then the right child, then the
       left  child,  and  so  forth)  will  be  output.  If  'lr-id'  or 'id-lr' are given as the
       '--path_format (-p)' parameter, then the ID (tag) of every node along  the  path  will  be
       printed  after  or  before  the  L  or  R character indicating the direction of traversal,
       respectively.

       This program also can provide density estimates for a set of test points, specified in the
       '--test_file  (-T)'  parameter. The density estimation tree used for this task will be the
       tree that was trained on the given training points, or  a  tree  given  as  the  parameter
       '--input_model_file  (-m)'.  The  density estimates for the test points may be saved using
       the ’--test_set_estimates_file (-E)' output parameter.

OPTIONAL INPUT OPTIONS

       --folds (-f) [int]
              The number of folds of cross-validation to perform for the estimation (0 is  LOOCV)
              Default value 10.

       --help (-h) [bool]
              Default help info.

       --info [string]
              Print help on a specific option. Default value ''.

       --input_model_file (-m) [unknown]
              Trained density estimation tree to load.

       --max_leaf_size (-L) [int]
              The maximum size of a leaf in the unpruned, fully grown DET. Default value 10.

       --min_leaf_size (-l) [int]
              The minimum size of a leaf in the unpruned, fully grown DET. Default value 5.

       --path_format (-p) [string]
              The format of path printing: 'lr', 'id-lr', or 'lr-id'. Default value 'lr'.

       --skip_pruning (-s) [bool]
              Whether to bypass the pruning process and output the unpruned tree only.

       --test_file (-T) [string]
              A set of test points to estimate the density of.

       --training_file (-t) [string]
              The data set on which to build a density estimation tree.

       --verbose (-v) [bool]
              Display  informational  messages  and the full list of parameters and timers at the
              end of execution.

       --version (-V) [bool]
              Display the version of mlpack.

OPTIONAL OUTPUT OPTIONS

       --output_model_file (-M) [unknown]
              Output to save trained density estimation tree to.

       --tag_counters_file (-c) [string]
              The file to output the number of points that went to each leaf. Default value ''.

       --tag_file (-g) [string]
              The file to output the tags (and possibly paths) for each sample in the  test  set.
              Default value ''.

       --test_set_estimates_file (-E) [string]
              The output estimates on the test set from the final optimally pruned tree.

       --training_set_estimates_file (-e) [string]
              The  output  density  estimates on the training set from the final optimally pruned
              tree.

       --vi_file (-i) [string]
              The output variable importance values for each feature.

ADDITIONAL INFORMATION

       For further information, including relevant papers, citations,  and  theory,  consult  the
       documentation found at http://www.mlpack.org or included with your distribution of mlpack.