Using Learning Rate Schedules for Deep Learning Models in Python with Keras

Last Updated on

Training a neural network or large deep learning model is a difficult optimization task.

The classical algorithm to train neural networks is called stochastic gradient descent. It has been well established that you can achieve increased performance and faster training on some problems by using a learning rate that changes during training.

In this post you will discover how you can use different learning rate schedules for your neural network models in Python using the Keras deep learning library.

After reading this post you will know:

  • How to configure and evaluate a time-based learning rate schedule.
  • How to configure and evaluate a drop-based learning rate schedule.

Discover how to develop deep learning models for a range of predictive modeling problems with just a few lines of code in my new book, with 18 step-by-step tutorials and 9 projects.

Let’s get started.

  • Update Mar/2017: Updated for Keras 2.0.2, TensorFlow 1.0.1 and Theano 0.9.0.
  • Update Sep/2019: Updated for Keras 2.2.5 API.
Using Learning Rate Schedules for Deep Learning Models in Python with Keras

Using Learning Rate Schedules for Deep Learning Models in Python with Keras
Photo by Columbia GSAPP, some rights reserved.

Learning Rate Schedule For Training Models

Adapting the learning rate for your stochastic gradient descent optimization procedure can increase performance and reduce training time.

Sometimes this is called learning rate annealing or adaptive learning rates. Here we will call this approach a learning rate schedule, were the default schedule is to use a constant learning rate to update network weights for each training epoch.

The simplest and perhaps most used adaptation of learning rate during training are techniques that reduce the learning rate over time. These have the benefit of making large changes at the beginning of the training procedure when larger learning rate values are used, and decreasing the learning rate such that a smaller rate and therefore smaller training updates are made to weights later in the training procedure.

This has the effect of quickly learning good weights early and fine tuning them later.

Two popular and easy to use learning rate schedules are as follows:

  • Decrease the learning rate gradually based on the epoch.
  • Decrease the learning rate using punctuated large drops at specific epochs.

Next, we will look at how you can use each of these learning rate schedules in turn with Keras.

Need help with Deep Learning in Python?

Take my free 2-week email course and discover MLPs, CNNs and LSTMs (with code).

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

Start Your FREE Mini-Course Now!

Time-Based Learning Rate Schedule

Keras has a time-based learning rate schedule built in.

The stochastic gradient descent optimization algorithm implementation in the SGD class has an argument called decay. This argument is used in the time-based learning rate decay schedule equation as follows:

When the decay argument is zero (the default), this has no effect on the learning rate.

When the decay argument is specified, it will decrease the learning rate from the previous epoch by the given fixed amount.

For example, if we use the initial learning rate value of 0.1 and the decay of 0.001, the first 5 epochs will adapt the learning rate as follows:

Extending this out to 100 epochs will produce the following graph of learning rate (y axis) versus epoch (x axis):

Time-Based Learning Rate Schedule

Time-Based Learning Rate Schedule

You can create a nice default schedule by setting the decay value as follows:

The example below demonstrates using the time-based learning rate adaptation schedule in Keras.

It is demonstrated on the Ionosphere binary classification problem. This is a small dataset that you can download from the UCI Machine Learning repository. Place the data file in your working directory with the filename ionosphere.csv.

The ionosphere dataset is good for practicing with neural networks because all of the input values are small numerical values of the same scale.

A small neural network model is constructed with a single hidden layer with 34 neurons and using the rectifier activation function. The output layer has a single neuron and uses the sigmoid activation function in order to output probability-like values.

The learning rate for stochastic gradient descent has been set to a higher value of 0.1. The model is trained for 50 epochs and the decay argument has been set to 0.002, calculated as 0.1/50. Additionally, it can be a good idea to use momentum when using an adaptive learning rate. In this case we use a momentum value of 0.8.

The complete example is listed below.

The model is trained on 67% of the dataset and evaluated using a 33% validation dataset.

Running the example shows a classification accuracy of 99.14%. This is higher than the baseline of 95.69% without the learning rate decay or momentum.

Drop-Based Learning Rate Schedule

Another popular learning rate schedule used with deep learning models is to systematically drop the learning rate at specific times during training.

Often this method is implemented by dropping the learning rate by half every fixed number of epochs. For example, we may have an initial learning rate of 0.1 and drop it by 0.5 every 10 epochs. The first 10 epochs of training would use a value of 0.1, in the next 10 epochs a learning rate of 0.05 would be used, and so on.

If we plot out the learning rates for this example out to 100 epochs you get the graph below showing learning rate (y axis) versus epoch (x axis).

Drop Based Learning Rate Schedule

Drop Based Learning Rate Schedule

We can implement this in Keras using a the LearningRateScheduler callback when fitting the model.

The LearningRateScheduler callback allows us to define a function to call that takes the epoch number as an argument and returns the learning rate to use in stochastic gradient descent. When used, the learning rate specified by stochastic gradient descent is ignored.

In the code below, we use the same example before of a single hidden layer network on the Ionosphere dataset. A new step_decay() function is defined that implements the equation:

Where InitialLearningRate is the initial learning rate such as 0.1, the DropRate is the amount that the learning rate is modified each time it is changed such as 0.5, Epoch is the current epoch number and EpochDrop is how often to change the learning rate such as 10.

Notice that we set the learning rate in the SGD class to 0 to clearly indicate that it is not used. Nevertheless, you can set a momentum term in SGD if you want to use momentum with this learning rate schedule.

Running the example results in a classification accuracy of 99.14% on the validation dataset, again an improvement over the baseline for the model on the problem.

Tips for Using Learning Rate Schedules

This section lists some tips and tricks to consider when using learning rate schedules with neural networks.

  • Increase the initial learning rate. Because the learning rate will very likely decrease, start with a larger value to decrease from. A larger learning rate will result in a lot larger changes to the weights, at least in the beginning, allowing you to benefit from the fine tuning later.
  • Use a large momentum. Using a larger momentum value will help the optimization algorithm to continue to make updates in the right direction when your learning rate shrinks to small values.
  • Experiment with different schedules. It will not be clear which learning rate schedule to use so try a few with different configuration options and see what works best on your problem. Also try schedules that change exponentially and even schedules that respond to the accuracy of your model on the training or test datasets.


In this post you discovered learning rate schedules for training neural network models.

After reading this post you learned:

  • How to configure and use a time-based learning rate schedule in Keras.
  • How to develop your own drop-based learning rate schedule in Keras.

Do you have any questions about learning rate schedules for neural networks or about this post? Ask your question in the comments and I will do my best to answer.

Develop Deep Learning Projects with Python!

Deep Learning with Python

 What If You Could Develop A Network in Minutes

...with just a few lines of Python

Discover how in my new Ebook:
Deep Learning With Python

It covers end-to-end projects on topics like:
Multilayer PerceptronsConvolutional Nets and Recurrent Neural Nets, and more...

Finally Bring Deep Learning To
Your Own Projects

Skip the Academics. Just Results.

See What's Inside

53 Responses to Using Learning Rate Schedules for Deep Learning Models in Python with Keras

  1. Hunaina June 22, 2016 at 8:49 pm #


  2. alcajerah June 23, 2016 at 11:18 pm #

    nice post

  3. Shudhan September 7, 2016 at 6:21 pm #

    Hello Jason,

    Interesting post. Can’t we use this learning rate and momentum for optimizers other than SGD? Since ‘adam’ is performing good with most of the datasets, i wanna try learning rate and momentum tuning for ‘adam’ optimizer. Also, I did a quick research on this and found that ‘adam’ already have decaying learning rate. Is it true? and what about other optimizers?

  4. Yuzhen Lu October 27, 2016 at 2:13 pm #

    I want to implement a learning rate that is exponentially decayed with respect to the cost? For example, the learning rate is updated as follows:

    eta = eta0*exp(CostFunction)

    Such that a larger learning rate is employed when the cost is large, vice versa.

    Do you know to achieve that in Keras? Thank you!

    • Jason Brownlee October 28, 2016 at 9:06 am #

      Hi Yuzhen,

      I would advise you to develop your decay function in excel or something to test and plot it. Use the above linear decay function inputs/outputs as a starting point.

      You can then plug your function into one of the examples above.

      Let me know how you go.

  5. Linlin May 25, 2017 at 5:54 am #

    Hi Jason!

    Thanks for your great poster! It does great help!
    One more question: I use the “Drop-Based Learning Rate Schedule”, how can I print out the current learning rate in terminal?


    • Linlin May 25, 2017 at 10:50 am #

      Got the solution! Just print out

    • Jason Brownlee June 2, 2017 at 11:37 am #

      Good question, you might be able to call print() from the custom function. Let me know if that works.

  6. Chong Wang July 25, 2017 at 11:39 am #

    Does the weight decay change once per mini-batch or epoch? According to!topic/keras-users/7KM2AvCurW0, it updates per mini-batch. In my problem, one epoch contains 800 mini-batches.

    • Jason Brownlee July 26, 2017 at 7:43 am #

      If you implement the decay yourself, you can control the schedule, as in the tutorial above (e.g. a function of the epoch not the batch).

  7. Amr August 29, 2017 at 10:06 pm #

    Does it make sense to use these techniques of weight decay with adaptive optimizers like adam or rmsprop rather than sgd? or will it be redundant?

    • Jason Brownlee August 30, 2017 at 6:18 am #

      I’d like to think it is redundant, but test and see on your problem to know for sure. Data wins.

  8. Nicolas October 26, 2017 at 12:08 am #

    Thanks a lot for this guide! Is there a way to see the code you wrote before the update? I have a constraint and need to use Keras 1.2 currently, and when applying the SGD I get:

    File “/usr/lib64/python2.7/site-packages/keras/”, line 924, in fit_generator
    File “/usr/lib64/python2.7/site-packages/keras/engine/”, line 1401, in fit_generator
    File “/usr/lib64/python2.7/site-packages/keras/engine/”, line 713, in _make_train_function
    TypeError: unbound method get_updates() must be called with SGD instance as first argument (got list instance instead)

    I assume this is because of some API change that I fail to see

  9. Tuan November 8, 2017 at 8:05 am #

    Hi Jason, is there an option to specify momentum when using Adam optimizer in Keras? I can only see the momentum option in SGD.

    • Jason Brownlee November 8, 2017 at 9:32 am #

      Not as far as I remember. Double check the API to be sure.

  10. simon January 24, 2018 at 2:36 pm #

    Hi, I have a question here
    I wish to print out the learning rate information during the training but it won’t work with this code below:

    def step_decay(epoch):
    initial_lrate = 0.001
    drop = 0.5
    epochs_drop = 100.0
    lrate = initial_lrate * math.pow(drop, math.floor((1+epoch)/epochs_drop))
    print (‘epoch: ‘ + str(epoch) + ‘, learning rate: ‘ + str(lrate)) # added
    return lrate

    NUM_EPOCHS = 700
    BATCH_SIZE = 128

    for each_epoch in range(0, NUM_EPOCHS):
    lrate = callbacks.LearningRateScheduler(step_decay)
    callbacks_list = [lrate]
    history =, y_train, batch_size=BATCH_SIZE, epochs=1, callbacks=callbacks_list, verbose=2, validation_data=[x_test, y_test])
    prediction_test = model.predict(x_test).flatten()

    Do I have to set ‘epochs’ to NUM_EPOCHS and remove for-loop to display lrate?

    • Jason Brownlee January 24, 2018 at 4:40 pm #

      Does the example in the post work for you?

      Perhaps start with something that works and modify it one piece at a time to achieve your desired outcome?

      • simon January 26, 2018 at 10:50 am #

        The example works but I want to display the learning rate during training.

        • Jason Brownlee January 27, 2018 at 5:51 am #

          I would expect the print in the callback function to work.

          Ensure you’re running from the command line and not in a notebook or ide.

      • simon January 26, 2018 at 11:03 am #

        Oh, never mind, it is displaying changed lrate per epoch without a for-loop.
        There was a lot of displayed information during the training (with verbose=1) and I missed the lrate reports.

  11. Ken February 14, 2018 at 4:19 am #

    Hi Jason,
    I know the learning rate can be adjusted in Keras, but all the options seem to only include some decay or decreasing learning rate. I am wondering if it’s possible to create a custom schedule that works like ReduceLROnPlateau, where it is looking to see if the loss stops decreasing for some number of epochs, and if so then it decreases the LR. But after some number of “decreases” it then increases the learning rate the next time loss stagnates, and then continues decreasing again on loss stagnation after that.

    My thought here is that you may descend into a local minimum that you may not be able to escape from unless you increase the learning rate, before continuing to descend to the global minimum.

    Does it make sense to create a function for learning rate? Would Keras accept that?

    Can anyone give me an idea on how I would write that function?


    • Jason Brownlee February 14, 2018 at 8:24 am #

      Sure, I don’t think it would be a problem. You may need an object rather than just a function to store state. I have not done this, so some experimentation may be required.

  12. kay March 29, 2018 at 4:08 pm #

    Hi Jason,
    This post helped me a lot. How can i tweak the learning rate value after every epoch?

    • Jason Brownlee March 30, 2018 at 6:33 am #

      You can implement this directly as your own method, follow the above tutorial.

  13. Molly May 17, 2018 at 12:21 pm #

    I want to know how to use keras to change the learning rate in every layers?

  14. GeLi May 30, 2018 at 6:23 pm #

    Hi, I want to plot the learning rate curve of the adam optimizer, should I code callbacks=[lr] in the fit function

    • Jason Brownlee May 31, 2018 at 6:14 am #

      Each model parameter (weight) has a learning rate, plotting each would be challenging.

  15. Isaiah Spearman July 4, 2018 at 3:27 am #

    I used the tutorial from this link: and applied it to a 6 input data set. My values always converge to ~0, .5, or 1 depending on the number of hidden layers. This occurs after the first call to train each time. I suspect this is because it does not include learning rate or bias. Where would you apply the learning rate in this code?

    • Jason Brownlee July 4, 2018 at 8:30 am #

      If you have a question about someone else’s tutorial, perhaps ask them directly?

  16. Aayushee July 6, 2018 at 8:39 pm #

    Hello Dr. Jason,

    Thanks for your informative posts on working with Keras.
    I am using Drop based Learning Schedule as per your tutorial which works fine and can print the changing learning rate with every epoch in the step_decay() function.
    Due to shortage of memory, I am saving this model and reloading it in another script.
    The model reloads and optimizes from the previous epoch only so learning keeps happening. But I am not able to see the learning rate from the callback. Perhaps the learning rate scheduler callback state is not saved. Do you have any idea on how I can use the previous callback state also in the reloaded model?

  17. mk January 21, 2019 at 7:13 pm #

    How should we record the learning rate during training in keras?
    tensorboard can plot learning rate in every epochs

    • Jason Brownlee January 22, 2019 at 6:22 am #

      Sorry, I don’t have an example of monitoring learning rate for tensorboard.

      • mk January 22, 2019 at 11:39 am #

        If we want to know the learning rate during training in every epoch,what we can do use the keras

  18. zeinab July 22, 2019 at 3:49 am #

    Many thanks for this very useful tutorial.

    Is there is a way to decrease the learning rate automatically when the accuracy decrease?

    • Jason Brownlee July 22, 2019 at 8:28 am #

      Yes, you can configure a learning rate schedule to achieve this.

  19. zeinab July 22, 2019 at 11:13 am #

    Do you mean “LearningRateScheduler”?

    If yes, to the best of my knowledge about “LearningRateScheduler”,
    I can set the learning rate manually for a set of epochs.

    For example:

    def lr_schedule(epoch):
    lrate = 0.0007
    if epoch > 10:
    lrate = 0.0001
    return lrate

    callbacks_list = [lr_scheduler], Y, epochs=50, batch_size=80,
    callbacks = callbacks_list)

    But, How does the “LearningRateScheduler” set learning rate automatically?

    • Jason Brownlee July 22, 2019 at 2:06 pm #

      When the SGD is used, it will locate the instance of the SGD used by the model and set the lr parameter.

  20. zeinab July 23, 2019 at 1:00 am #

    Can you give me an example, please?

    • Jason Brownlee July 23, 2019 at 8:05 am #

      Sorry, I don’t have the capacity to prepare an example.

  21. voodoo January 2, 2020 at 5:28 pm #

    so when do you set the value for epoch argument in function step_decay? Does it mean overall epochs?

    • Jason Brownlee January 3, 2020 at 7:17 am #

      It is the current epoch number.

      Perhaps I don’t understand the question?

  22. Yogeeshwari February 20, 2020 at 4:02 pm #

    Below is my code for scheular where I want to divide the learning rate by 10 from the initial rate when my epoch is at 50% and by 100 when my epoch is at 75%:

    def lr_schedule(epochs,lr):
    initial_lr = 0.1
    if epochs == epochs*0.5:
    lr = np.float32(initial_lr/10.0)
    return lr
    if epochs == epochs*0.75:
    lr = np.float32(initial_lr/100.0)
    return lr

    from keras.callbacks import ModelCheckpoint

    # checkpoint
    checkpoint = ModelCheckpoint(filepath, monitor=’val_acc’, verbose=1, save_best_only=True, mode=’max’)
    callbacks_list = [checkpoint,learning_scheduler]

    # create data generator
    datagen = ImageDataGenerator(rotation_range=15,width_shift_range=0.1, height_shift_range=0.1, horizontal_flip=True)

    # fit model
    steps = int(X_train.shape[0] / batch_size)
    history = model.fit_generator(datagen.flow(X_train, y_train, batch_size=batch_size), steps_per_epoch=steps, epochs=epochs, validation_data=(X_test, y_test), callbacks=callbacks_list, verbose=1)

    1352 lr = self.schedule(epoch)
    1353 if not isinstance(lr, (float, np.float32, np.float64)):
    -> 1354 raise ValueError(‘The output of the “schedule” function ‘
    1355 ‘should be float.’)
    1356 K.set_value(, lr)

    ValueError: The output of the “schedule” function should be a float.

    I am getting the above error. Kindly help.

    Thanks in advance!

  23. Yogeeshwari February 20, 2020 at 4:05 pm #

    sorry forgot to add in my comment:

    sgd = tf.keras.optimizers.SGD(lr=0.1,momentum=0.9, decay=1e-4,nesterov=True)

  24. jessy March 24, 2020 at 8:26 pm #

    hi jason,
    when i execute above code for another dataset there is no change in loss and accuracy at each epoch.. could you give me suggestion..

    • Jason Brownlee March 25, 2020 at 6:30 am #

      I don’t know why that could be. Perhaps try additional loss values?

Leave a Reply