SALE! Use code blackfriday for 40% off everything!
Hurry, sale ends soon! Click to see the full catalog.

Tune Learning Rate for Gradient Boosting with XGBoost in Python

Last Updated on August 27, 2020

A problem with gradient boosted decision trees is that they are quick to learn and overfit training data.

One effective way to slow down learning in the gradient boosting model is to use a learning rate, also called shrinkage (or eta in XGBoost documentation).

In this post you will discover the effect of the learning rate in gradient boosting and how to tune it on your machine learning problem using the XGBoost library in Python.

After reading this post you will know:

  • The effect learning rate has on the gradient boosting model.
  • How to tune learning rate on your machine learning on your problem.
  • How to tune the trade-off between the number of boosted trees and learning rate on your problem.

Kick-start your project with my new book XGBoost With Python, including step-by-step tutorials and the Python source code files for all examples.

Let’s get started.

  • Update Jan/2017: Updated to reflect changes in scikit-learn API version 0.18.1.
Tune Learning Rate for Gradient Boosting with XGBoost in Python

Tune Learning Rate for Gradient Boosting with XGBoost in Python
Photo by Robert Hertel, some rights reserved.

Need help with XGBoost in Python?

Take my free 7-day email course and discover xgboost (with sample code).

Click to sign-up now and also get a free PDF Ebook version of the course.

Start Your FREE Mini-Course Now!

Slow Learning in Gradient Boosting with a Learning Rate

Gradient boosting involves creating and adding trees to the model sequentially.

New trees are created to correct the residual errors in the predictions from the existing sequence of trees.

The effect is that the model can quickly fit, then overfit the training dataset.

A technique to slow down the learning in the gradient boosting model is to apply a weighting factor for the corrections by new trees when added to the model.

This weighting is called the shrinkage factor or the learning rate, depending on the literature or the tool.

Naive gradient boosting is the same as gradient boosting with shrinkage where the shrinkage factor is set to 1.0. Setting values less than 1.0 has the effect of making less corrections for each tree added to the model. This in turn results in more trees that must be added to the model.

It is common to have small values in the range of 0.1 to 0.3, as well as values less than 0.1.

Let’s investigate the effect of the learning rate on a standard machine learning dataset.

Problem Description: Otto Dataset

In this tutorial we will use the Otto Group Product Classification Challenge dataset.

This dataset is available for free from Kaggle (you will need to sign-up to Kaggle to be able to download this dataset). You can download the training dataset from the Data page and place the unzipped train.csv file into your working directory.

This dataset describes the 93 obfuscated details of more than 61,000 products grouped into 10 product categories (e.g. fashion, electronics, etc.). Input attributes are counts of different events of some kind.

The goal is to make predictions for new products as an array of probabilities for each of the 10 categories and models are evaluated using multiclass logarithmic loss (also called cross entropy).

This competition was completed in May 2015 and this dataset is a good challenge for XGBoost because of the nontrivial number of examples, the difficulty of the problem and the fact that little data preparation is required (other than encoding the string class variables as integers).

Tuning Learning Rate in XGBoost

When creating gradient boosting models with XGBoost using the scikit-learn wrapper, the learning_rate parameter can be set to control the weighting of new trees added to the model.

We can use the grid search capability in scikit-learn to evaluate the effect on logarithmic loss of training a gradient boosting model with different learning rate values.

We will hold the number of trees constant at the default of 100 and evaluate of suite of standard values for the learning rate on the Otto dataset.

There are 6 variations of learning rate to be tested and each variation will be evaluated using 10-fold cross validation, meaning that there is a total of 6×10 or 60 XGBoost models to be trained and evaluated.

The log loss for each learning rate will be printed as well as the value that resulted in the best performance.

Note: Your results may vary given the stochastic nature of the algorithm or evaluation procedure, or differences in numerical precision. Consider running the example a few times and compare the average outcome.

Running this example prints the best result as well as the log loss for each of the evaluated learning rates.

Interestingly, we can see that the best learning rate was 0.2.

This is a high learning rate and it suggest that perhaps the default number of trees of 100 is too low and needs to be increased.

We can also plot the effect of the learning rate of the (inverted) log loss scores, although the log10-like spread of chosen learning_rate values means that most are squashed down the left-hand side of the plot near zero.

Tune Learning Rate in XGBoost

Tune Learning Rate in XGBoost

Next, we will look at varying the number of trees whilst varying the learning rate.

Tuning Learning Rate and the Number of Trees in XGBoost

Smaller learning rates generally require more trees to be added to the model.

We can explore this relationship by evaluating a grid of parameter pairs. The number of decision trees will be varied from 100 to 500 and the learning rate varied on a log10 scale from 0.0001 to 0.1.

There are 5 variations of n_estimators and 4 variations of learning_rate. Each combination will be evaluated using 10-fold cross validation, so that is a total of 4x5x10 or 200 XGBoost models that must be trained and evaluated.

The expectation is that for a given learning rate, performance will improve and then plateau as the number of trees is increased. The full code listing is provided below.

Note: Your results may vary given the stochastic nature of the algorithm or evaluation procedure, or differences in numerical precision. Consider running the example a few times and compare the average outcome.

Running the example prints the best combination as well as the log loss for each evaluated pair.

We can see that the best result observed was a learning rate of 0.1 with 300 trees.

It is hard to pick out trends from the raw data and small negative log loss results. Below is a plot of each learning rate as a series showing log loss performance as the number of trees is varied.

Tuning Learning Rate and Number of Trees in XGBoost

Tuning Learning Rate and Number of Trees in XGBoost

We can see that the expected general trend holds, where the performance (inverted log loss) improves as the number of trees is increased.

Performance is generally poor for the smaller learning rates, suggesting that a much larger number of trees may be required. We may need to increase the number of trees to many thousands which may be quite computationally expensive.

The results for learning_rate=0.1 are obscured due the large y-axis scale of the graph. We can extract the performance measure for just learning_rate=0.1 and plot them directly.

Running this code shows the increased performance as the number of trees are added, followed by a plateau in performance across 400 and 500 trees.

Plot of Learning Rate=0.1 and varying the Number of Trees in XGBoost

Plot of Learning Rate=0.1 and varying the Number of Trees in XGBoost


In this post you discovered the effect of weighting the addition of new trees to a gradient boosting model, called shrinkage or the learning rate.

Specifically, you learned:

  • That adding a learning rate is intended to slow down the adaptation of the model to the training data.
  • How to evaluate a range of learning rate values on your machine learning problem.
  • How to evaluate the relationship of varying both the number of trees and the learning rate on your problem.

Do you have any questions regarding shrinkage in gradient boosting or about this post? Ask your questions in the comments and I will do my best to answer them.

Discover The Algorithm Winning Competitions!

XGBoost With Python

Develop Your Own XGBoost Models in Minutes

...with just a few lines of Python

Discover how in my new Ebook:
XGBoost With Python

It covers self-study tutorials like:
Algorithm Fundamentals, Scaling, Hyperparameters, and much more...

Bring The Power of XGBoost To Your Own Projects

Skip the Academics. Just Results.

See What's Inside

47 Responses to Tune Learning Rate for Gradient Boosting with XGBoost in Python

  1. Juan Agustin January 31, 2017 at 12:54 pm #

    Hi! How long does it take to run the first part “Tuning the Learning Rate” and what system are you running it on? Thanks.

  2. Siva March 16, 2017 at 5:08 pm #

    “Tuning Learning Rate and the Number of Trees in XGBoost” Running this part is taking more time for me (completed 6 hours but still running).

    • Jason Brownlee March 17, 2017 at 8:24 am #

      Ouch, I think I may have run it on a large AWS instance with 32 cores.

  3. karthik January 12, 2018 at 11:43 am #

    What is the use of learning rate and what does it represent? can you please tell me any intuitive explanation?

    • Jason Brownlee January 12, 2018 at 11:51 am #

      The learning rate makes the boosting process more or less conservative, e.g. to correct or boost more or less based on the results of the previously added tree.

  4. Sri August 7, 2018 at 7:37 pm #

    Excellent and userful article. I applied it on my data, It helped me to choose learning rate and n_estimators prefectly because of which Results imporoved a lot.

  5. wsdgh August 30, 2018 at 10:02 pm #

    the first colum of csv is ID, Isn’t this feature useless?
    Thank you

  6. Abhishek Vigg December 30, 2018 at 3:40 pm #

    How to do make predictions on the tuned xg_boost model? Do you just pass the learning rate and number of trees as parameters in XGBClassifier? Could you add that code also to the article?

  7. Azlan faizal March 23, 2019 at 3:40 pm #

    Hi.. Is it possible to show how the tree is built for gradient boosted tree for binary class problem?.. I am curious how exactly the tree is built.. Using what function to determine the split.. And how the results from each tree being added to compute the prediction class. If possible .. Use simple example.. With learning rate 0.1.. . I am familiar with single cart tree… But till now not able to get the understanding for gradient boosted tree.. Only recently i realized that for gradient boosted tree.. The tree is builtbusing regression tree.. And the classification is converted using probability value. I would appreciate a lot if u can show one example as requested … Thanks

  8. Ranjith March 24, 2019 at 8:07 pm #

    Hey, can you please tell me why we are even going for learning rate or shrinkage parameter in GB while we already have number of base learners as hyperparameter and we even having thepre-computed γ m through gradient minimization technique, so how does this learning rate adds more value in this?

    • Jason Brownlee March 25, 2019 at 6:44 am #

      This is a shrinkage factor, it is explained in the post. Perhaps a re-read is in order?

  9. Emin April 12, 2019 at 11:00 am #

    Instead of having discrete values for learning rate, an approach with lower and upper bounds can be tried as well. So, something similar to learning_rate = scipy.stats.uniform(lower_bound, upper_bound)

  10. TQQ May 21, 2019 at 3:32 pm #

    Hi, I have a question here.

    I read some paper and it seems that we need to find the best learning rate (minimize our loss function) after we fit the base learner. Does it mean in Python library, we don’t need to find the best learning rate and we just simply set it as a constant number?

    • TQQ May 21, 2019 at 3:35 pm #

      never mind. I abused notation here.

  11. GOPAL Behera August 29, 2019 at 11:50 pm #

    how evaluate the accuracy,precision and recall after tuning the parameter

  12. GOPAL Behera October 21, 2019 at 11:28 pm #

    after executing grid_search i got the result as mentioned below

    GridSearchCV(cv=StratifiedKFold(n_splits=5, random_state=7, shuffle=True),
    estimator=XGBClassifier(base_score=0.5, booster=’gbtree’, colsample_bylevel=1,
    colsample_bytree=1, gamma=0, learning_rate=0.1, max_delta_step=0,
    max_depth=3, min_child_weight=1, missing=None, n_estimators=100,
    n_jobs=1, nthread=None, objective=’binary:logistic’, random_state=0,
    reg_alpha=0, reg_lambda=1, scale_pos_weight=1, seed=None,
    silent=True, subsample=1),
    fit_params=None, iid=’warn’, n_jobs=-1,
    param_grid={‘learning_rate’: [0.0001, 0.001, 0.01, 0.1, 0.2, 0.3]},
    pre_dispatch=’2*n_jobs’, refit=True, return_train_score=’warn’,
    scoring=’neg_log_loss’, verbose=0)

    but when i am trying to execute “grid_result =, label_encoded_y)” it will shows this error can you suggest the solution

    JoblibValueError Traceback (most recent call last)
    in ()
    —-> 1 grid_result =, label_encoded_y)

    /home/gopal/.local/lib/python2.7/site-packages/sklearn/model_selection/_search.pyc in fit(self, X, y, groups, **fit_params)
    721 return results_container[0]
    –> 723 self._run_search(evaluate_candidates)
    725 results = results_container[0]

    /home/gopal/.local/lib/python2.7/site-packages/sklearn/model_selection/_search.pyc in _run_search(self, evaluate_candidates)
    1190 def _run_search(self, evaluate_candidates):
    1191 “””Search all candidates in param_grid”””
    -> 1192 evaluate_candidates(ParameterGrid(self.param_grid))

    /home/gopal/.local/lib/python2.7/site-packages/sklearn/model_selection/_search.pyc in evaluate_candidates(candidate_params)
    710 for parameters, (train, test)
    711 in product(candidate_params,
    –> 712 cv.split(X, y, groups)))
    714 all_candidate_params.extend(candidate_params)

    /home/gopal/.local/lib/python2.7/site-packages/sklearn/externals/joblib/parallel.pyc in __call__(self, iterable)
    933 with self._backend.retrieval_context():
    –> 934 self.retrieve()
    935 # Make sure that we get a last message telling us we are done
    936 elapsed_time = time.time() – self._start_time

    /home/gopal/.local/lib/python2.7/site-packages/sklearn/externals/joblib/parallel.pyc in retrieve(self)
    860 this_report = format_outer_frames(context=10,
    861 stack_start=1)
    –> 862 raise exception.unwrap(this_report)
    863 else:
    864 raise

    JoblibValueError: JoblibValueError

  13. GOPAL Behera October 25, 2019 at 7:06 pm #

    hi Jason

    For grid search cross validation , i got RMSE=1066 ,MAE=749.49 but for normal cross validation the RMSE =1052 ,MAE= 739.03 so i am confused that after tuning the parameter still the rmse value is more than the normal cross validatio rmse value for big mart dataset. please guide me on this aslo sugesst me how to calculate accuracy based rmse and mae value

    • Jason Brownlee October 26, 2019 at 4:38 am #

      The difference might be due to the stochastic nature of the learning algorithm.

      Perhaps try repeated cross-validation to get a more stable evaluation?

  14. GOPAL Behera December 16, 2019 at 9:06 pm #

    Hi Jason

    As per my knowledge log loss is nothingh but a cross entropy , which ranges 0 to 1 but here your graph showing negative value for log loss in every time i.e log loss vs learning rate and other graph as well as. Also i am getting same negative values for logloss , please clarify me why i got the negative value for log loss?

    • Jason Brownlee December 17, 2019 at 6:35 am #

      Yes, sklearn inverts loss scores to make all scores maximize instead of minimize.

      You see this with negative MSE as well.

  15. GOPAL Behera December 17, 2019 at 8:00 pm #

    why it so sir, if loss score is maximize then the model will not treat as good model i think

  16. Greg Whittle January 18, 2020 at 8:13 am #

    There seems to be a point for the learning rate above which you get a normal range of predictions between 0 and 1 but below which you get a limited range of predictions from XGBoost (e.g., all records are between .49 and .51 for example). Have you noticed this and can you explain what is happening? The lower learning rate with the limited prediction range yields lower precision and recall but has much better capture rate for top 3 deciles in validation results in every case.

    • Jason Brownlee January 18, 2020 at 8:55 am #


      No, I have not seen that before. It maybe the case that the model fails to converge.

  17. Corey March 29, 2020 at 2:09 am #

    Any insights on the math behind the learning rate? Is a value of 0.1 something like a weight?

    • Jason Brownlee March 29, 2020 at 6:02 am #

      It controls the amount of update to the model or contribution of a given tree to the prediction. Smaller means less contribution and more trees will be required most likely.

      Use trial and error to configure for a given dataset.

  18. Add April 3, 2020 at 11:59 pm #

    Does XGBoost perform better than neural networks?

    • Jason Brownlee April 4, 2020 at 6:18 am #

      Depends on the specific dataset.

      For tabular data, yes often it does.

  19. George September 10, 2020 at 10:31 am #

    Hi Jason,

    In Kaggle Competition Notebooks people tuning upto 4 decimals for XGB parameters like

    params = {'classify__estimator__colsample_bytree': 0.6522,
    'classify__estimator__gamma': 3.6975,
    'classify__estimator__learning_rate': 0.0503,
    'classify__estimator__max_delta_step': 2.0706,
    'classify__estimator__max_depth': 10,
    'classify__estimator__min_child_weight': 31.5800,
    'classify__estimator__n_estimators': 166,
    'classify__estimator__subsample': 0.8639

    May i know how it is possible?

    • George September 10, 2020 at 12:26 pm #

      I found some using hyperopt library, but accuracy wise its not good when compared with the tuning results between hyperopt and gridsearch, gridsearch giving more accuracy than hyperopt.

    • Jason Brownlee September 10, 2020 at 1:36 pm #

      Sorry, I don’t understand the problem, it seems fine to me.

      What do you mean exactly, can you please elaborate?

      • George September 11, 2020 at 8:58 am #

        Thanks Jason, Understood

Leave a Reply