mlpack_adaboost man page

mlpack_adaboost — adaboost

Synopsis

mlpack_adaboost [-h] [-v] [-m string] [-i int] [-l string] [-o string] [-M string] [-T string] [-e double] [-t string] [-V] [-w string]

Description

This program implements the AdaBoost (or Adaptive Boosting) algorithm. The variant of AdaBoost implemented here is AdaBoost.MH. It uses a weak learner, either decision stumps or perceptrons, and over many iterations, creates a strong learner that is a weighted ensemble of weak learners. It runs these iterations until a tolerance value is crossed for change in the value of the weighted training error.

For more information about the algorithm, see the paper "Improved Boosting Algorithms Using Confidence-Rated Predictions", by R.E. Schapire and Y. Singer.

This program allows training of an AdaBoost model, and then application of that model to a test dataset. To train a model, a dataset must be passed with the --training_file (-t) option. Labels can be given with the --labels_file (-l) option; if no labels file is specified, the labels will be assumed to be the last column of the input dataset. Alternately, an AdaBoost model may be loaded with the --input_model_file (-m) option.

Once a model is trained or loaded, it may be used to provide class predictions for a given test dataset. A test dataset may be specified with the --test_file (-T) parameter. The predicted classes for each point in the test dataset will be saved into the file specified by the --output_file (-o) parameter. The AdaBoost model itself may be saved to a file specified by the --output_model_file (-M) parameter.

Options

--help (-h)
Default help info.
--info [string]
Get help on a specific module or option. Default value ''. --input_model_file (-m) [string] File containing input AdaBoost model. Default value ''.
--iterations (-i) [int]
The maximum number of boosting iterations to be run. (0 will run until convergence.) Default value 1000.
--labels_file (-l) [string]
A file containing labels for the training set. Default value ''.
--output_file (-o) [string]
The file in which the predicted labels for the test set will be written. Default value ''. --output_model_file (-M) [string] File to save trained AdaBoost model to. Default value ''.
--test_file (-T) [string]
A file containing the test set. Default value ’'.
--tolerance (-e) [double]
The tolerance for change in values of the weighted error during training. Default value 1e-10. --training_file (-t) [string] A file containing the training set. Default value ''.
--verbose (-v)
Display informational messages and the full list of parameters and timers at the end of execution.
--version (-V)
Display the version of mlpack. --weak_learner (-w) [string] The type of weak learner to use: ’decision_stump', or 'perceptron'. Default value 'decision_stump'.

Additional Information

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

Info