在執行XGboost之前，必須設定三種類型成熟：general parameters，booster parameters和task parameters：

• General parameters：引數控制在提升（boosting）過程中使用哪種booster，常用的booster有樹模型（tree）和線性模型（linear model）。
• Booster parameters：這取決於使用哪種booster。
• Task parameters：控制學習的場景，例如在迴歸問題中會使用不同的引數控制排序。
• 除了以上引數還可能有其它引數，在命令列中使用

Parameters in R Package

In R-package, you can use .(dot) to replace under score in the parameters, for example, you can use max.depth as max_depth. The underscore parameters are also valid in R.

General Parameters

• booster [default=gbtree]
  • 有兩中模型可以選擇gbtree和gblinear。gbtree使用基於樹的模型進行提升計算，gblinear使用線性模型進行提升計算。預設值為gbtree
• silent [default=0]
  • 取0時表示打印出執行時資訊，取1時表示以緘默方式執行，不列印執行時資訊。預設值為0
• nthread [default to maximum number of threads available if not set]
  • XGBoost執行時的執行緒數。預設值是當前系統可以獲得的最大執行緒數
• num_pbuffer [set automatically by xgboost, no need to be set by user]
  • size of prediction buffer, normally set to number of training instances. The buffers are used to save the prediction results of last boosting step.
• num_feature [set automatically by xgboost, no need to be set by user]
  • boosting過程中用到的特徵維數，設定為特徵個數。XGBoost會自動設定，不需要手工設定

Booster Parameters

From xgboost-unity, the bst: prefix is no longer needed for booster parameters. Parameter with or without bst: prefix will be equivalent(i.e. both bst:eta and eta will be valid parameter setting) .

Parameter for Tree Booster

• eta [default=0.3]
  • 為了防止過擬合，更新過程中用到的收縮步長。在每次提升計算之後，演算法會直接獲得新特徵的權重。 eta通過縮減特徵的權重使提升計算過程更加保守。預設值為0.3
  • 取值範圍為：[0,1]
• gamma [default=0]
  • minimum loss reduction required to make a further partition on a leaf node of the tree. the larger, the more conservative the algorithm will be.
  • range: [0,∞]
• max_depth [default=6]
  • 數的最大深度。預設值為6
  • 取值範圍為：[1,∞]
• min_child_weight [default=1]
  • 孩子節點中最小的樣本權重和。如果一個葉子節點的樣本權重和小於min_child_weight則拆分過程結束。在現行迴歸模型中，這個引數是指建立每個模型所需要的最小樣本數。該成熟越大演算法越conservative
  • 取值範圍為: [0,∞]
• max_delta_step [default=0]
  • Maximum delta step we allow each tree’s weight estimation to be. If the value is set to 0, it means there is no constraint. If it is set to a positive value, it can help making the update step more conservative. Usually this parameter is not needed, but it might help in logistic regression when class is extremely imbalanced. Set it to value of 1-10 might help control the update
  • 取值範圍為：[0,∞]
• subsample [default=1]
  • 用於訓練模型的子樣本佔整個樣本集合的比例。如果設定為0.5則意味著XGBoost將隨機的衝整個樣本集合中隨機的抽取出50%的子樣本建立樹模型，這能夠防止過擬合。
  • 取值範圍為：(0,1]
• colsample_bytree [default=1]
  • 在建立樹時對特徵取樣的比例。預設值為1
  • 取值範圍：(0,1]

Parameter for Linear Booster

• lambda [default=0]
  • L2 正則的懲罰係數
• alpha [default=0]
  • L1 正則的懲罰係數
• lambda_bias
  • 在偏置上的L2正則。預設值為0（在L1上沒有偏置項的正則，因為L1時偏置不重要）

Task Parameters

• objective [ default=reg:linear ]
  • 定義學習任務及相應的學習目標，可選的目標函式如下：
  • “reg:linear” –線性迴歸。
  • “reg:logistic” –邏輯迴歸。
  • “binary:logistic” –二分類的邏輯迴歸問題，輸出為概率。
  • “binary:logitraw” –二分類的邏輯迴歸問題，輸出的結果為wTx。
  • “count:poisson” –計數問題的poisson迴歸，輸出結果為poisson分佈。
  • 在poisson迴歸中，max_delta_step的預設值為0.7。(used to safeguard optimization)
  • “multi:softmax” –讓XGBoost採用softmax目標函式處理多分類問題，同時需要設定引數num_class（類別個數）
  • “multi:softprob” –和softmax一樣，但是輸出的是ndata * nclass的向量，可以將該向量reshape成ndata行nclass列的矩陣。沒行資料表示樣本所屬於每個類別的概率。
  • “rank:pairwise” –set XGBoost to do ranking task by minimizing the pairwise loss
• base_score [ default=0.5 ]
  • the initial prediction score of all instances, global bias
• eval_metric [ default according to objective ]
  • 校驗資料所需要的評價指標，不同的目標函式將會有預設的評價指標（rmse for regression, and error for classification, mean average precision for ranking）
  • 使用者可以新增多種評價指標，對於Python使用者要以list傳遞引數對給程式，而不是map引數list引數不會覆蓋’eval_metric’
  • The choices are listed below:
  • “error”: Binary classification error rate. It is calculated as #(wrong cases)/#(all cases). For the predictions, the evaluation will regard the instances with prediction value larger than 0.5 as positive instances, and the others as negative instances.
  • “merror”: Multiclass classification error rate. It is calculated as #(wrong cases)/#(all cases).
  • “mlogloss”: Multiclass logloss
  • “auc”: Area under the curve for ranking evaluation.
  • “[email protected]”,”[email protected]”: n can be assigned as an integer to cut off the top positions in the lists for evaluation.
  • “ndcg-“,”map-“,”[email protected]“,”[email protected]“: In XGBoost, NDCG and MAP will evaluate the score of a list without any positive samples as 1. By adding “-” in the evaluation metric XGBoost will evaluate these score as 0 to be consistent under some conditions. training repeatively
• seed [ default=0 ]
  • 隨機數的種子。預設值為0

Console Parameters

The following parameters are only used in the console version of xgboost * use_buffer [ default=1 ] - 是否為輸入建立二進位制的快取檔案，快取檔案可以加速計算。預設值為1 * num_round - boosting迭代計算次數。 * data - 輸入資料的路徑 * test:data - 測試資料的路徑 * save_period [default=0] - 表示儲存第i*save_period次迭代的模型。例如save_period=10表示每隔10迭代計算XGBoost將會儲存中間結果，設定為0表示每次計算的模型都要保持。 * task [default=train] options: train, pred, eval, dump - train：訓練明顯 - pred：對測試資料進行預測 - eval：通過eval[name]=filenam定義評價指標 - dump：將學習模型儲存成文字格式 * model_in [default=NULL] - 指向模型的路徑在test, eval, dump都會用到，如果在training中定義XGBoost將會接著輸入模型繼續訓練 * model_out [default=NULL] - 訓練完成後模型的保持路徑，如果沒有定義則會輸出類似0003.model這樣的結果，0003是第三次訓練的模型結果。 * model_dir [default=models] - 輸出模型所儲存的路徑。 * fmap - feature map, used for dump model * name_dump [default=dump.txt] - name of model dump file * name_pred [default=pred.txt] - 預測結果檔案 * pred_margin [default=0] - 輸出預測的邊界，而不是轉換後的概率