How to Grid Search Hyperparameters for Deep Learning Models in Python With Keras

Hyperparameter optimization is a big part of deep learning.

The reason is that neural networks are notoriously difficult to configure and there are a lot of parameters that need to be set. On top of that, individual models can be very slow to train.

In this post you will discover how you can use the grid search capability from the scikit-learn python machine learning library to tune the hyperparameters of Keras deep learning models.

After reading this post you will know:

  • How to wrap Keras models for use in scikit-learn and how to use grid search.
  • How to grid search common neural network parameters such as learning rate, dropout rate, epochs and number of neurons.
  • How to define your own hyperparameter tuning experiments on your own projects.

Let’s get started.

  • Update Nov/2016: Fixed minor issue in displaying grid search results in code examples.
  • Update Oct/2016: Updated examples for Keras 1.1.0, TensorFlow 0.10.0 and scikit-learn v0.18.
  • Update Mar/2017: Updated example for Keras 2.0.2, TensorFlow 1.0.1 and Theano 0.9.0.
How to Grid Search Hyperparameters for Deep Learning Models in Python With Keras

How to Grid Search Hyperparameters for Deep Learning Models in Python With Keras
Photo by 3V Photo, some rights reserved.


In this post I want to show you both how you can use the scikit-learn grid search capability and give you a suite of examples that you can copy-and-paste into your own project as a starting point.

Below is a list of the topics we are going to cover:

  1. How to use Keras models in scikit-learn.
  2. How to use grid search in scikit-learn.
  3. How to tune batch size and training epochs.
  4. How to tune optimization algorithms.
  5. How to tune learning rate and momentum.
  6. How to tune network weight initialization.
  7. How to tune activation functions.
  8. How to tune dropout regularization.
  9. How to tune the number of neurons in the hidden layer.

How to Use Keras Models in scikit-learn

Keras models can be used in scikit-learn by wrapping them with the KerasClassifier or KerasRegressor class.

To use these wrappers you must define a function that creates and returns your Keras sequential model, then pass this function to the build_fn argument when constructing the KerasClassifier class.

For example:

The constructor for the KerasClassifier class can take default arguments that are passed on to the calls to, such as the number of epochs and the batch size.

For example:

The constructor for the KerasClassifier class can also take new arguments that can be passed to your custom create_model() function. These new arguments must also be defined in the signature of your create_model() function with default parameters.

For example:

You can learn more about the scikit-learn wrapper in Keras API documentation.

How to Use Grid Search in scikit-learn

Grid search is a model hyperparameter optimization technique.

In scikit-learn this technique is provided in the GridSearchCV class.

When constructing this class you must provide a dictionary of hyperparameters to evaluate in the param_grid argument. This is a map of the model parameter name and an array of values to try.

By default, accuracy is the score that is optimized, but other scores can be specified in the score argument of the GridSearchCV constructor.

By default, the grid search will only use one thread. By setting the n_jobs argument in the GridSearchCV constructor to -1, the process will use all cores on your machine. Depending on your Keras backend, this may interfere with the main neural network training process.

The GridSearchCV process when then construct and evaluate one model for each combination of parameters. Cross validation is used to evaluate each individual model and the default of 3-fold cross validation is used, although this can be overridden by specifying the cv argument to the GridSearchCV constructor.

Below is an example of defining a simple grid search:

Once completed, you can access the outcome of the grid search in the result object returned from The best_score_ member provides access to the best score observed during the optimization procedure and the best_params_ describes the combination of parameters that achieved the best results.

You can learn more about the GridSearchCV class in the scikit-learn API documentation.

Problem Description

Now that we know how to use Keras models with scikit-learn and how to use grid search in scikit-learn, let’s look at a bunch of examples.

All examples will be demonstrated on a small standard machine learning dataset called the Pima Indians onset of diabetes classification dataset. This is a small dataset with all numerical attributes that is easy to work with.

  1. Download the dataset and place it in your currently working directly with the name pima-indians-diabetes.csv.

As we proceed through the examples in this post, we will aggregate the best parameters. This is not the best way to grid search because parameters can interact, but it is good for demonstration purposes.

Note on Parallelizing Grid Search

All examples are configured to use parallelism (n_jobs=-1).

If you get an error like the one below:

Kill the process and change the code to not perform the grid search in parallel, set n_jobs=1.

Beat the Math/Theory Doldrums and Start using Deep Learning in your own projects Today, without getting lost in “documentation hell”

Deep Learning With Python Mini-CourseGet my free Deep Learning With Python mini course and develop your own deep nets by the time you’ve finished the first PDF with just a few lines of Python.

Daily lessons in your inbox for 14 days, and a DL-With-Python “Cheat Sheet” you can download right now.   

Download Your FREE Mini-Course  


How to Tune Batch Size and Number of Epochs

In this first simple example, we look at tuning the batch size and number of epochs used when fitting the network.

The batch size in iterative gradient descent is the number of patterns shown to the network before the weights are updated. It is also an optimization in the training of the network, defining how many patterns to read at a time and keep in memory.

The number of epochs is the number of times that the entire training dataset is shown to the network during training. Some networks are sensitive to the batch size, such as LSTM recurrent neural networks and Convolutional Neural Networks.

Here we will evaluate a suite of different mini batch sizes from 10 to 100 in steps of 20.

The full code listing is provided below.

Running this example produces the following output.

We can see that the batch size of 20 and 100 epochs achieved the best result of about 68% accuracy.

How to Tune the Training Optimization Algorithm

Keras offers a suite of different state-of-the-art optimization algorithms.

In this example, we tune the optimization algorithm used to train the network, each with default parameters.

This is an odd example, because often you will choose one approach a priori and instead focus on tuning its parameters on your problem (e.g. see the next example).

Here we will evaluate the suite of optimization algorithms supported by the Keras API.

The full code listing is provided below.

Running this example produces the following output.

The results suggest that the ADAM optimization algorithm is the best with a score of about 70% accuracy.

How to Tune Learning Rate and Momentum

It is common to pre-select an optimization algorithm to train your network and tune its parameters.

By far the most common optimization algorithm is plain old Stochastic Gradient Descent (SGD) because it is so well understood. In this example, we will look at optimizing the SGD learning rate and momentum parameters.

Learning rate controls how much to update the weight at the end of each batch and the momentum controls how much to let the previous update influence the current weight update.

We will try a suite of small standard learning rates and a momentum values from 0.2 to 0.8 in steps of 0.2, as well as 0.9 (because it can be a popular value in practice).

Generally, it is a good idea to also include the number of epochs in an optimization like this as there is a dependency between the amount of learning per batch (learning rate), the number of updates per epoch (batch size) and the number of epochs.

The full code listing is provided below.

Running this example produces the following output.

We can see that relatively SGD is not very good on this problem, nevertheless best results were achieved using a learning rate of 0.01 and a momentum of 0.0 with an accuracy of about 68%.

How to Tune Network Weight Initialization

Neural network weight initialization used to be simple: use small random values.

Now there is a suite of different techniques to choose from. Keras provides a laundry list.

In this example, we will look at tuning the selection of network weight initialization by evaluating all of the available techniques.

We will use the same weight initialization method on each layer. Ideally, it may be better to use different weight initialization schemes according to the activation function used on each layer. In the example below we use rectifier for the hidden layer. We use sigmoid for the output layer because the predictions are binary.

The full code listing is provided below.

Running this example produces the following output.

We can see that the best results were achieved with a uniform weight initialization scheme achieving a performance of about 72%.

How to Tune the Neuron Activation Function

The activation function controls the non-linearity of individual neurons and when to fire.

Generally, the rectifier activation function is the most popular, but it used to be the sigmoid and the tanh functions and these functions may still be more suitable for different problems.

In this example, we will evaluate the suite of different activation functions available in Keras. We will only use these functions in the hidden layer, as we require a sigmoid activation function in the output for the binary classification problem.

Generally, it is a good idea to prepare data to the range of the different transfer functions, which we will not do in this case.

The full code listing is provided below.

Running this example produces the following output.

Surprisingly (to me at least), the ‘linear’ activation function achieved the best results with an accuracy of about 72%.

How to Tune Dropout Regularization

In this example, we will look at tuning the dropout rate for regularization in an effort to limit overfitting and improve the model’s ability to generalize.

To get good results, dropout is best combined with a weight constraint such as the max norm constraint.

For more on using dropout in deep learning models with Keras see the post:

This involves fitting both the dropout percentage and the weight constraint. We will try dropout percentages between 0.0 and 0.9 (1.0 does not make sense) and maxnorm weight constraint values between 0 and 5.

The full code listing is provided below.

Running this example produces the following output.

We can see that the dropout rate of 0.2% and the maxnorm weight constraint of 4 resulted in the best accuracy of about 72%.

How to Tune the Number of Neurons in the Hidden Layer

The number of neurons in a layer is an important parameter to tune. Generally the number of neurons in a layer controls the representational capacity of the network, at least at that point in the topology.

Also, generally, a large enough single layer network can approximate any other neural network, at least in theory.

In this example, we will look at tuning the number of neurons in a single hidden layer. We will try values from 1 to 30 in steps of 5.

A larger network requires more training and at least the batch size and number of epochs should ideally be optimized with the number of neurons.

The full code listing is provided below.

Running this example produces the following output.

We can see that the best results were achieved with a network with 5 neurons in the hidden layer with an accuracy of about 71%.

Tips for Hyperparameter Optimization

This section lists some handy tips to consider when tuning hyperparameters of your neural network.

  • k-fold Cross Validation. You can see that the results from the examples in this post show some variance. A default cross-validation of 3 was used, but perhaps k=5 or k=10 would be more stable. Carefully choose your cross validation configuration to ensure your results are stable.
  • Review the Whole Grid. Do not just focus on the best result, review the whole grid of results and look for trends to support configuration decisions.
  • Parallelize. Use all your cores if you can, neural networks are slow to train and we often want to try a lot of different parameters. Consider spinning up a lot of AWS instances.
  • Use a Sample of Your Dataset. Because networks are slow to train, try training them on a smaller sample of your training dataset, just to get an idea of general directions of parameters rather than optimal configurations.
  • Start with Coarse Grids. Start with coarse-grained grids and zoom into finer grained grids once you can narrow the scope.
  • Do not Transfer Results. Results are generally problem specific. Try to avoid favorite configurations on each new problem that you see. It is unlikely that optimal results you discover on one problem will transfer to your next project. Instead look for broader trends like number of layers or relationships between parameters.
  • Reproducibility is a Problem. Although we set the seed for the random number generator in NumPy, the results are not 100% reproducible. There is more to reproducibility when grid searching wrapped Keras models than is presented in this post.


In this post, you discovered how you can tune the hyperparameters of your deep learning networks in Python using Keras and scikit-learn.

Specifically, you learned:

  • How to wrap Keras models for use in scikit-learn and how to use grid search.
  • How to grid search a suite of different standard neural network parameters for Keras models.
  • How to design your own hyperparameter optimization experiments.

Do you have any experience tuning hyperparameters of large neural networks? Please share your stories below.

Do you have any questions about hyperparameter optimization of neural networks or about this post? Ask your questions in the comments and I will do my best to answer.

Frustrated With Your Progress In Deep Learning?

 What If You Could Develop Your Own Deep Nets in Minutes

...with just a few lines of Python

Discover how in my new Ebook: Deep Learning With Python

It covers self-study tutorials and 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.

Click to learn more.

69 Responses to How to Grid Search Hyperparameters for Deep Learning Models in Python With Keras

  1. Yanbo August 9, 2016 at 9:10 am #

    As always excellent post,. I’ve been doing some hyper-parameter optimization by hand, but I’ll definitely give Grid Search a try.

    Is it possible to set up a different threshold for sigmoid output in Keras? Rather then using 0.5 I was thinking of trying 0.7 or 0.8

    • Jason Brownlee August 15, 2016 at 11:10 am #

      Thanks Yanbo.

      I don’t think so, but you could implement your own activation function and do anything you wish.

      • Shudhan September 5, 2016 at 6:20 pm #

        My question is related to this thread. How to get the probablities as the output? I dont want the class output. I read for a regression problem that no activation function is needed in the output layer. Similiar implementation will get me the probabilities ?? or the output will exceed 0 and 1??

        • Jason Brownlee September 6, 2016 at 9:41 am #

          Hi Shudhan, you can use a sigmoid activation and treat the outputs like probabilities (they will be in the range of 0-1).

  2. eclipsedu August 18, 2016 at 5:55 pm #

    Sound awesome!Will this grid search method use the full cpu(which can be 8/16 cores) ?

  3. Reza August 18, 2016 at 6:00 pm #

    Great post,
    Can I use this tips on CNNs in keras as well?

    • Jason Brownlee August 19, 2016 at 5:24 am #

      They can be a start, but remember it is a good idea to use a repeating structure in a large CNN and you will need to tune the number of filters and pool size.

  4. Prashant August 22, 2016 at 4:55 pm #

    Hi Jason, First of all great post! I applied this by dividing the data into train and test and used train dataset for grid fit. Plan was to capture best parameters in train and apply them on test to see accuracy. But it seems and applied with same parameters on same dataset (in this case train) give different accuracy results. Any idea why this happens. I can share the code if it helps.

    • Jason Brownlee August 23, 2016 at 6:00 am #

      You will see small variation in the performance of a neural net with the same parameters from run to run. This is because of the stochastic nature of the technique and how very hard it is to fix the random number seed successfully in python/numpy/theano.

      You will also see small variation due to the data used to train the method.

      Generally, you could use all of your data to grid search to try to reduce the second type of variation (slower). You could store results and use statistical significance tests to compare populations of results to see if differences are significant to sort out the first type or variation.

      I hope that helps.

  5. vinay August 22, 2016 at 9:05 pm #

    hi, I think this will best tutorial i ever found on web….Thanks for sharing….is it possible to use these tips on LSTM, Bilstm cnnlstm

    • Jason Brownlee August 23, 2016 at 5:57 am #

      Thanks Vinay, I’m glad it’s useful.

      Absolutely, you could use these tactics on other algorithm types.

  6. shudhan September 2, 2016 at 3:26 pm #

    Best place to learn the tuning.. my question – is it good to follow the order you mentioned to tune the parameters? I know the most significant parameters should be tuned first

    • Jason Brownlee September 3, 2016 at 6:56 am #

      Thanks. The order is a good start. It is best to focus on areas where you think you will get the biggest improvement first – which is often the structure of the network (layers and neurons).

  7. Satheesh September 27, 2016 at 12:24 am #

    when I am using the categorical_entropy loss function and running the grid search with n_jobs more than 1 its throwing error “cannot pickle object class”, but the same thing is working fine with binary_entropyloss. Can you tell me if I am making any mistake in my code:
    def create_model(optimizer=’adam’):
    # create model
    model.add(Dense(30, input_dim=59, init=’normal’, activation=’relu’))
    model.add(Dense(15, init=’normal’, activation=’sigmoid’))
    model.add(Dense(3, init=’normal’, activation=’sigmoid’))
    # Compile model
    model.compile(loss=’categorical_crossentropy’, optimizer=optimizer, metrics=[‘accuracy’])
    return model

    # Create Keras Classifier
    print “——————— Running Grid Search on Keras Classifier for epochs and batch ——————”
    clf = model = KerasClassifier(build_fn = create_model, verbose=0)
    param_grid = {“batch_size”:range(10, 30, 10), “nb_epoch”:range(50, 150, 50)}
    optimizer = [‘SGD’, ‘RMSprop’, ‘Adagrad’, ‘Adadelta’, ‘Adam’, ‘Adamax’, ‘Nadam’]
    grid = GridSearchCV(estimator=model, param_grid=param_grid, n_jobs=4)
    grid_result =, y_train)
    print(“Best: %f using %s” % (grid_result.best_score_, grid_result.best_params_))

    • Jason Brownlee September 27, 2016 at 7:44 am #

      Strange Satheesh, I have not seen that before.

      Let me know if you figure it out.

  8. L Fenu November 9, 2016 at 7:47 pm #

    excellent post, thanks. It’s been very helpful to get me started on hyperparameterisation.

    One thing I haven’t been able to do yet is to grid search over parameters which are not proper to the NN but to the trainign set. For example, I can fine-tune the input_dim parameter by creating a function generator which takes care of creating the function that will create the model, like this:

    # fp_subset is a subset of columns of my whole training set.

    create_basic_ANN_model = kt.ANN_model_gen( # defined elsewhere
    input_dim=len(fp_subset), output_dim=1, layers_num=2, layers_sizes=[len(fp_subset)/5, len(fp_subset)/10, ],
    loss=’mean_squared_error’, optimizer=’adadelta’, metrics=[‘mean_squared_error’, ‘mean_absolute_error’]

    model = KerasRegressor(build_fn=create_basic_ANN_model, verbose=1)
    # define the grid search parameters
    batch_size = [10, 100]
    epochs = [5, 10]

    param_grid = dict(batch_size=batch_size, nb_epoch=epochs)
    grid = GridSearchCV(estimator=model, param_grid=param_grid, n_jobs=1, cv=7)

    grid_results =, trY)

    this works but only as a for loop over the different fp_subset, which I must define manually.
    I could easily pick the best out of every run but it wuld be great if I could fold them all inside a big grid definition and fit, so as to automatically pick the largest.

    However, until now haven’t been able to figure out a way to get that in my head.
    If the wrapper function is useful to anyone, I can post a generalised version here.

    • Jason Brownlee November 10, 2016 at 7:42 am #

      Good question.

      You might just need to us a loop around the whole lot for different projections/views of your training data.

      • L Fenu November 11, 2016 at 1:05 am #

        Thanks. I ended up coding my own for loop, saving the results of each grid in a dict, sorting the hash by the perofrmance metrics, and picking the best model.

        Now, the next question is: How do I save the model’s architecture and weights to a .json .hdf5 file? I know how to do that for a simple model. But how do I extract the best model out of the gridsearch results?

        • Jason Brownlee November 11, 2016 at 10:04 am #

          Well done.

          No need. Once you know the parameters, you can use them to train a new standalone model on all of your training data and start making predictions.

          • Fenu Luca November 15, 2016 at 3:23 am #

            I may have found a way. How about this?

            best_model = grid_result.best_estimator_.model
            best_model_file_path = ‘your_pick_here’
            model2json = best_model.to_json()
            with open( best_model_file_path+’.json’, ‘w’) as json_file:

  9. volador November 14, 2016 at 6:21 pm #

    Hi Jason, I think this is very best deep learning tutorial on the web. Thanks for your work. I have a question is :how to use the heuristic algorithm to optimize Hyperparameters for Deep Learning Models in Python With Keras, these algorithms like: Genetic algorithm, Particle swarm optimization, and Cuckoo algorithm etc. If the idea could be experimented, could you give an example

    • Jason Brownlee November 15, 2016 at 7:50 am #

      Thanks for your support volador.

      You could search the hyperparameter space using a stochastic optimization algorithm like a genetic algorithm and use the mean performance as the cost function orf fitness function. I don’t have a worked example, but it would be relatively easy to setup.

  10. Jan de Lange November 15, 2016 at 6:50 am #

    Hi Jason, very helpful intro into gridsearch for Keras. I have used your guidance in my code, but rather than using the default ‘accuracy’ to be optimized, my model requires a specific evaluation function to be optimized. You hint at this possibility in the introduction, but there is no example of it. I have followed the SciKit-learn documentation, but I fail to come up with the correct syntax.

    I have posted my question at StackOverflow, but since it is quite specific, it requires understanding of SciKit-learn in combination with Keras.

    Perhaps you can have a look? I think it would nicely extend your tutorial.

    Thanks, Jan

  11. Jan de Lange November 16, 2016 at 7:31 am #

    Yup, same sources as I referenced in my post at Stackoverflow.

  12. Anthony Ohazulike December 6, 2016 at 12:46 am #

    Good tutorial again Jason…keep on the good job!

  13. nrcjea001 December 13, 2016 at 10:48 pm #

    Hi Jason

    First off, thank you for the tutorial. It’s very helpful.

    I was also hoping you would assist on how to adapt the keras grid search to stateful lstms as discussed in

    I’ve coded the following:

    # create model
    model = KerasRegressor(build_fn=create_model, nb_epoch=1, batch_size=bats,
    verbose=2, shuffle=False)

    # define the grid search parameters
    h1n = [5, 10] # number of hidden neurons
    param_grid = dict(h1n=h1n)
    grid = GridSearchCV(estimator=model, param_grid=param_grid, n_jobs=-1, cv=5)

    for i in range(100):, trainY)

    Is grid.reset_states() corrrect? or would you suggest creating function callback for reset states.


    • Jason Brownlee December 14, 2016 at 8:27 am #

      Great question.

      With stateful LSTMs we must control the resetting of states after each epoch. The sklearn framework does not open this capacity to us – at least it looks that way to me off the cuff.

      I think you may have to grid search stateful LSTM params manually with a ton of for loops. Sorry.

      If you discover something different, let me know. i.e. there may be a way in the back door to the sklearn grid search functionality that we can inject our own custom epoch handing.

  14. Thomas Maier December 21, 2016 at 2:53 am #

    Hi Jason

    Thanks a lot for this and all the other great tutorials!

    I tried to combine this gridsearch/keras approach with a pipeline. It works if I tune nb_epoch or batch_size, but I get an error if I try to tune the optimizer or something else in the keras building function (I did not forget to include the variable as an argument):

    def keras_model(optimizer = ‘adam’):
    model = Sequential()
    model.add(Dense(80, input_dim=79, init= ‘normal’))
    model.add(Dense(1, init=’normal’))
    model.compile(optimizer=optimizer, loss=’mse’)
    return model

    kRegressor = KerasRegressor(build_fn=keras_model, nb_epoch=500, batch_size=10, verbose=0)

    estimators = []
    estimators.append((‘imputer’, preprocessing.Imputer(strategy=’mean’)))
    estimators.append((‘scaler’, preprocessing.StandardScaler()))
    estimators.append((‘kerasR’, kRegressor))
    pipeline = Pipeline(estimators)

    param_grid = dict(kerasR__optimizer = [‘adam’,’rmsprop’])

    grid = GridSearchCV(pipeline, param_grid, cv=5, scoring=’neg_mean_squared_error’)

    Do you know this problem?

    Thanks, Thomas

    • Jason Brownlee December 21, 2016 at 8:44 am #

      Thanks Thomas. I’ve not seen this issue.

      I think we’re starting to push the poor Keras sklearn wrapper to the limit.

      Maybe the next step is to build out a few functions to do manual grid searching across network configs.

  15. Jimi December 21, 2016 at 3:26 pm #

    Great resource!

    Any thoughts on how to get the “history” objects out of grid search? It could be beneficial to plot the loss and accuracy to see when a model starts to flatten out.

    • Jason Brownlee December 22, 2016 at 6:30 am #

      Not sure off the cuff Jimi, perhaps repeat the run standalone for the top performing configuration.

  16. DeepLearning January 4, 2017 at 6:08 am #

    Thanks for the post. Can we optimize the number of hidden layers as well on top of number of neurons in each layers?

    • Jason Brownlee January 4, 2017 at 9:00 am #

      Yes, it just may be very time consuming depending on the size of the dataset and the number of layers/nodes involved.

      Try it on some small datasets from the UCI ML Repo.

      • DeepLearning January 4, 2017 at 12:02 pm #

        Thanks. Would you mind looking at below code?

        def create_model(neurons=1, neurons2=1):
        # create model
        model = Sequential()
        model.add(Dense(neurons1, input_dim=8))
        model.add(Dense(1, init=’uniform’, activation=’sigmoid’))
        # Compile model
        model.compile(loss=’binary_crossentropy’, optimizer=’adam’, metrics=[‘accuracy’])
        return model
        # define the grid search parameters
        neurons1 = [1, 3, 5, 7]
        param_grid = dict(neurons1=neurons1, neurons2=neurons2)
        grid = GridSearchCV(estimator=model, param_grid=param_grid, n_jobs=-1)
        grid_result =, Y)

        This code runs without error (I excluded certain X, y parts for brewity) but when I run “, Y), it gives AssertionError.

        I’d appreciate if you can show me where I am wrong.

        • DeepLearning January 4, 2017 at 12:26 pm #

          Update” It worked when I deleted 0 from neurons2. Thanks

        • Jason Brownlee January 5, 2017 at 9:16 am #

          A Dense() with a value of 0 neurons might blow up. Try removing the 0 from your neurons2 array.

          A good debug strategy is to cut code back to the minimum, make it work, then and add complexity. Here. Try searching a grid of 1 and 1 neurons, make it all work, then expand the grid you search.

          Let me know how you go.

  17. DeepLearning January 9, 2017 at 11:04 am #

    I keep getting error messages and I tried a big for loops that scan for all possible combinations of layer numbers, neuron numbers, other optimization stuff within defined limits. It is very time consuming code, but I could not figure it out how to adjust layer structure and other optimization parameters in the same code using GridSearch. If you would provide a code for that in your blog one day, that would be much appreciated. Thanks.

  18. Rajneesh January 11, 2017 at 10:48 am #

    Hi Jason,
    Many thanks for this awesome tutorial !

  19. Andy January 22, 2017 at 1:02 pm #

    Hi Jason,

    Great tutorial! I’m running into a slight issue. I tried running this on my own variation of the code and got the following error:

    TypeError: get_params() got an unexpected keyword argument ‘deep’

    I copied and pasted your code using the given data set and got the same error. The code is showing an error on the grid_result =, Y) line. I looked through the other comments and didn’t see anyone with the same issue. Do you know where this could be coming from?

    Thanks for your help!

    • YechiBechi January 23, 2017 at 2:18 am #

      same issue here,

      great tutorial, life saver.

    • Jason Brownlee January 23, 2017 at 8:35 am #

      Hi Andy, sorry to hear that.

      Is this happening with a specific example or with all of them?

      Are you able to check your version of Python/sklearn/keras/tf/theano?


      I can confirm the first example still works fine with Python 2.7, sklearn 0.18.1, Keras 1.2.0 and TensorFlow 0.12.1.

      • Andy January 25, 2017 at 7:12 am #

        The only differences are I am running Python 3.5 and Keras 1.2.1. The example I ran previously was the grid search for the number of neurons in a layer. But I just ran the first example and got the same error.

        Do you think the issue is due to the next version of Python? If so, what should my next steps be?

        Thanks for your help and quick response!

  20. kono February 8, 2017 at 3:14 am #


    Can you use early_stopping to decide n_epoch?

    • Jason Brownlee February 8, 2017 at 9:36 am #

      Yes, that is a good method to find a generalized model.

  21. Jayant February 23, 2017 at 4:33 am #

    Hi Jason,

    Really great article. I am a big fan of your blog and your books. Can you please explain your following statement?

    “A default cross-validation of 3 was used, but perhaps k=5 or k=10 would be more stable. Carefully choose your cross validation configuration to ensure your results are stable.”

    I didn’t see anywhere cross-validation being used.

    • Jason Brownlee February 23, 2017 at 8:56 am #

      Hi Jayant,

      Grid search uses k-fold cross-validation to evaluate the performance of each combination of parameters on unseen data.

  22. Jing February 28, 2017 at 2:09 am #

    Hi Jason,
    thanks for this awesome tutorial !
    I have two questions: 1. In “model.compile(loss=’binary_crossentropy’, optimizer=’adam’, metrics=[‘accuracy’])”, accuracy is used for evaluate results. But GridSearchCV also has scoring parameter, if I set “scoring=’f1’”,which one is used for evaluate the results of grid search? 2.How to set two evaluate parameters ,e.g. ‘accuracy’and ’f1’ evaluating the results of grid search?

    • Jason Brownlee February 28, 2017 at 8:13 am #

      Hi Jing,

      You can set the “scoring” argument for GridSearchCV with a string of the performance measure to use, or the name of your own scoring function. You can learn about this argument here:

      You can see a full list of supported scoring measures here:

      As far as I know you can only grid search using a single measure.

      • Jing February 28, 2017 at 12:50 pm #

        Thank you so much for your help!

      • Jing February 28, 2017 at 1:54 pm #

        I find no matter what evaluate parameters used in GridSearchCV “scoring”,”metrics” in “model.compile” must be [‘accuracy’],otherwise the program gives “ValueError: The model is not configured to compute accuracy.You should pass ‘metrics=[“accuracy”]’ to the ‘model.compile()’method. So, if I set:
        model.compile(loss=’binary_crossentropy’, optimizer=’adam’, metrics=[‘accuracy’])
        grid = GridSearchCV(estimator=model, param_grid=param_grid, scoring=’recall’)
        the grid_result.best_score_ =0.72.My question is: 0.72 is accuracy or recall ? Thank you!

        • Jason Brownlee March 1, 2017 at 8:31 am #

          Hi Jing,

          When using GridSearchCV with Keras, I would suggest not specifying any metrics when compiling your Keras model.

          I would suggest only setting the “scoring” argument on the GridSearchCV. I would expect the metric reported by GridSearchCV to be the one that you specified.

          I hope that helps.

  23. Dan March 8, 2017 at 4:13 am #

    Great Blogpost. Love it. You are awesome Jason. I got one question to GridsearchCV. As far as i understand the crossvalidation already takes place in there. That’s why we do not need any kfold anymore.
    But with this technique we would have no validation set correct? e.g. with a default value of 3 we would have 2 training sets and one test set.

    That means in kfold as well as in GridsearchCV there is no requirement for creating a validation set anymore?


    • Jason Brownlee March 8, 2017 at 9:44 am #

      Hi Dan,

      Yes, GridSearchCV performs cross validation and you must specify the number of folds. You can hold back a validation set to double check the parameters found by the search if you like. This is optional.

      • Dan March 9, 2017 at 3:25 am #

        Thank you for the quick response Jason. Especially considering the huge amount of questions you get.

  24. Johan Steunenberg March 22, 2017 at 8:25 pm #

    What I’m missing in the tutorial is the info, how to get the best params in the model with KERAS. Do I pickup the best parameters and call ‘create_model’ again with those parameters or can I call the GridSearchCV’s ‘predict’ function? (I will try out for myself but for completeness it would be good to have it in the tutorial as well.)

    • Jason Brownlee March 23, 2017 at 8:49 am #

      I see, but we don’t know the best parameters, we must search for them.

  25. Maycown Miranda April 5, 2017 at 2:09 am #

    Hi, Jason. I am getting
    /usr/local/lib/python2.7/dist-packages/keras/wrappers/ in check_params(self=, params={‘batch_size’: 10, ‘epochs’: 10})
    80 legal_params += inspect.getargspec(fn)[0]
    81 legal_params = set(legal_params)
    83 for params_name in params:
    84 if params_name not in legal_params:
    —> 85 raise ValueError(‘{} is not a legal parameter’.format(params_name))
    params_name = ‘epochs’
    87 def get_params(self, _):
    88 “””Gets parameters for this estimator.

    ValueError: epochs is not a legal parameter

    • Jason Brownlee April 9, 2017 at 2:32 pm #

      It sounds like you need to upgrade to Keras v2.0 or higher.

Leave a Reply