mlpack_adaboost(1)

πŸ’– mlpack_adaboost β€” the manual, but make it make sense πŸ’–

ok bestie, so mlpack_adaboost is the mlpack_adaboost(1) command β€” a User Command, one of the mlpack crew β€” and she is literally here to serve you adaptive boosting realness. no cap. let's go πŸ¦‹


✨ SYNOPSIS ✨

mlpack_adaboost [-m unknown] [-i int] [-l unknown] [-T unknown] [-e double] [-t unknown] [-V bool] [-w string] [-M unknown] [-P unknown] [-p unknown] [-h -v]

that's the whole vibe in one line. keep scrolling for what every single one of those means πŸ’…


🌸 DESCRIPTION 🌸

So this program implements the AdaBoost algorithm β€” aka Adaptive Boosting, she's a legend πŸ‘‘. The specific variant living in here is AdaBoost.MH. It takes a weak learner β€” either decision stumps or perceptrons, you pick β€” and over many iterations it cooks up a strong learner that's a weighted ensemble of all those little weak ones. iconic behavior honestly. It keeps running those iterations until a tolerance value is crossed for change in the value of the weighted training error. periodt.

For more info on the algorithm itself, go read the paper "Improved Boosting Algorithms Using Confidence-Rated Predictions", by R.E. Schapire and Y. Singer. yes bestie, citations, we love to cite πŸ“šβœ¨

This program lets you train an AdaBoost model, and then apply that model to a test dataset. Two paths, main character energy either way:

  • Training from scratch β€” you gotta pass a dataset with the --training_file (-t) option. Labels can come in with the --labels_file (-l) option; and if you don't specify labels, they'll just be assumed to be the last column of the input dataset. lowkey convenient ngl.
  • Loading a model β€” alternately, you can load an existing AdaBoost model with the --input_model_file (-m) option.

Once a model is trained or loaded, it's ready to spit out class predictions for a given test dataset πŸŽ€. A test dataset can be specified with the --test_file (-T) parameter. The predicted classes for each point in the test dataset get output to the --predictions_file (-P) output parameter. And the AdaBoost model itself gets output to the --output_model_file (-M) output parameter. so many files, so little time 😭


🧚 example time, because reading is hard and examples are everything 🧚

Say you wanna run AdaBoost on an input dataset data.csv with labels labels.csv and perceptrons as the weak learner type, storing the trained model in model.bin. You'd do:

$ mlpack_adaboost --training_file data.csv --labels_file labels.csv
--output_model_file model.bin --weak_learner perceptron

and similarly, an already-trained model in model.bin can be used to provide class predictions from test data test_data.csv and store the output in predictions.csv like this:

$ mlpack_adaboost --input_model_file model.bin --test_file test_data.csv
--predictions_file predictions.csv

slay. you did that πŸ’…


πŸŽ€ OPTIONAL INPUT OPTIONS πŸŽ€

one bullet per option, every single one accounted for, no skips, we don't gatekeep here 🫢

  • --help (-h) [bool] β€” Default help info. the classic "help me please" move.
  • --info [string] β€” Print help on a specific option. Default value ''. yes bestie, you can ask about ONE option specifically, very targeted of you ✨
  • --input_model_file (-m) [unknown] β€” Input AdaBoost model. the glow-up you already trained.
  • --iterations (-i) [int] β€” The maximum number of boosting iterations to be run (0 will run until convergence.) Default value 1000. so 0 means "just keep going until it settles," the commitment issues option πŸ”₯
  • --labels_file (-l) [unknown] β€” Labels for the training set. πŸ“
  • --test_file (-T) [unknown] β€” Test dataset. the ~test~ bestie, we love to be evaluated.
  • --tolerance (-e) [double] β€” The tolerance for change in values of the weighted error during training. Default value 1e-10. tiny number, big responsibility πŸ’€
  • --training_file (-t) [unknown] β€” Dataset for training AdaBoost. your whole origin story right here 🌈
  • --verbose (-v) [bool] β€” Display informational messages and the full list of parameters and timers at the end of execution. for when you wanna know everything that happened πŸ™ˆ
  • --version (-V) [bool] β€” Display the version of mlpack. identity check βœ…
  • --weak_learner (-w) [string] β€” The type of weak learner to use: 'decision_stump', or 'perceptron'. Default value 'decision_stump'. pick your fighter πŸ₯Š

πŸ’œ OPTIONAL OUTPUT OPTIONS πŸ’œ

what you get back, bestie. the receipts.

  • --output_model_file (-M) [unknown] β€” Output trained AdaBoost model. your finished masterpiece, saved for later πŸŽ€
  • --predictions_file (-P) [unknown] β€” Predicted labels for the test set. the answers, the tea β˜•
  • --probabilities_file (-p) [unknown] β€” Predicted class probabilities for each point in the test set. not just what, but how sure β€” the confidence, the self-assurance ✨

⭐ 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. go read, she's thorough πŸ“–πŸ’–

quick vibe check reminder: every flag, default, value and file path above is doing exactly what it says. don't freestyle the options, bestie β€” the defaults are there for a reason 🫢

okay that's the whole page, you're officially an AdaBoost girlie now πŸ’…βœ¨ this was mlpack-4.8.0, dated 22 June 2026 β€” no cap, go train something iconic πŸ‘‘πŸ’–

πŸ“¦ where this page comes from