Machine learning models have hyperparameters that you must set in order to customize the model to your dataset.

Often the general effects of hyperparameters on a model are known, but how to best set a hyperparameter and combinations of interacting hyperparameters for a given dataset is challenging.

There are often general heuristics or rules of thumb for configuring hyperparameters.

A better approach is to objectively search different values for model hyperparameters and choose a subset that results in a model that achieves the best performance on a given dataset.

This is called hyperparameter optimization or hyperparameter tuning and is available in the scikit-learn Python machine learning library.

The result of a hyperparameter optimization is a single set of well-performing hyperparameters that you can use to configure your model.

In this tutorial, you will discover hyperparameter optimization for machine learning in Python.

After completing this tutorial, you will know:Let’s get started.

Hyperparameter Optimization With Random Search and Grid SearchPhoto by James St.

John, some rights reserved.

This tutorial is divided into five parts; they are:Machine learning models have hyperparameters.

Hyperparameters are points of choice or configuration that allow a machine learning model to be customized for a specific task or dataset.

Machine learning models also have parameters, which are the internal coefficients set by training or optimizing the model on a training dataset.

Parameters are different from hyperparameters.

Parameters are learned automatically; hyperparameters are set manually to help guide the learning process.

For more on the difference between parameters and hyperparameters, see the tutorial:Typically a hyperparameter has a known effect on a model in the general sense, but it is not clear how to best set a hyperparameter for a given dataset.

Further, many machine learning models have a range of hyperparameters and they may interact in nonlinear ways.

As such, it is often required to search for a set of hyperparameters that result in the best performance of a model on a dataset.

This is called hyperparameter optimization, hyperparameter tuning, or hyperparameter search.

An optimization procedure involves defining a search space.

This can be thought of geometrically as an n-dimensional volume, where each hyperparameter represents a different dimension and the scale of the dimension are the values that the hyperparameter may take on, such as real-valued, integer-valued, or categorical.

A point in the search space is a vector with a specific value for each hyperparameter value.

The goal of the optimization procedure is to find a vector that results in the best performance of the model after learning, such as maximum accuracy or minimum error.

A range of different optimization algorithms may be used, although two of the simplest and most common methods are random search and grid search.

Grid search is great for spot-checking combinations that are known to perform well generally.

Random search is great for discovery and getting hyperparameter combinations that you would not have guessed intuitively, although it often requires more time to execute.

More advanced methods are sometimes used, such as Bayesian Optimization and Evolutionary Optimization.

Now that we are familiar with hyperparameter optimization, let’s look at how we can use this method in Python.

The scikit-learn Python open-source machine learning library provides techniques to tune model hyperparameters.

Specifically, it provides the RandomizedSearchCV for random search and GridSearchCV for grid search.

Both techniques evaluate models for a given hyperparameter vector using cross-validation, hence the “CV” suffix of each class name.

Both classes require two arguments.

The first is the model that you are optimizing.

This is an instance of the model with values of hyperparameters set that you do not want to optimize.

The second is the search space.

This is defined as a dictionary where the names are the hyperparameter arguments to the model and the values are discrete values or a distribution of values to sample in the case of a random search.

Both classes provide a “cv” argument that allows either an integer number of folds to be specified, e.

g.

5, or a configured cross-validation object.

I recommend defining and specifying a cross-validation object to gain more control over model evaluation and make the evaluation procedure obvious and explicit.

In the case of classification tasks, I recommend using the RepeatedStratifiedKFold class, and for regression tasks, I recommend using the RepeatedKFold with an appropriate number of folds and repeats, such as 10 folds and three repeats.

Both hyperparameter optimization classes also provide a “scoring” argument that takes a string indicating the metric to optimize.

The metric must be maximizing, meaning better models result in larger scores.

For classification, this may be ‘accuracy‘.

For regression, this is a negative error measure, such as ‘neg_mean_absolute_error‘ for a negative version of the mean absolute error, where values closer to zero represent less prediction error by the model.

You can see a list of build-in scoring metrics here:Finally, the search can be made parallel, e.

g.

use all of the CPU cores by specifying the “n_jobs” argument as an integer with the number of cores in your system, e.

g.

8.

Or you can set it to be -1 to automatically use all of the cores in your system.

Once defined, the search is performed by calling the fit() function and providing a dataset used to train and evaluate model hyperparameter combinations using cross-validation.

Running the search may take minutes or hours, depending on the size of the search space and the speed of your hardware.

Youâ€™ll often want to tailor the search to how much time you have rather than the possibility of what could be searched.

At the end of the search, you can access all of the results via attributes on the class.

Perhaps the most important attributes are the best score observed and the hyperparameters that achieved the best score.

Once you know the set of hyperparameters that achieve the best result, you can then define a new model, set the values of each hyperparameter, then fit the model on all available data.

This model can then be used to make predictions on new data.

Now that we are familiar with the hyperparameter optimization API in scikit-learn, let’s look at some worked examples.

In this section, we will use hyperparameter optimization to discover a well-performing model configuration for the sonar dataset.

The sonar dataset is a standard machine learning dataset comprising 208 rows of data with 60 numerical input variables and a target variable with two class values, e.

g.

binary classification.

Using a test harness of repeated stratified 10-fold cross-validation with three repeats, a naive model can achieve an accuracy of about 53 percent.

A top-performing model can achieve accuracy on this same test harness of about 88 percent.

This provides the bounds of expected performance on this dataset.

The dataset involves predicting whether sonar returns indicate a rock or simulated mine.

No need to download the dataset; we will download it automatically as part of our worked examples.

The example below downloads the dataset and summarizes its shape.

Running the example downloads the dataset and splits it into input and output elements.

As expected, we can see that there are 208 rows of data with 60 input variables.

Next, let’s use random search to find a good model configuration for the sonar dataset.

To keep things simple, we will focus on a linear model, the logistic regression model, and the common hyperparameters tuned for this model.

In this section, we will explore hyperparameter optimization of the logistic regression model on the sonar dataset.

First, we will define the model that will be optimized and use default values for the hyperparameters that will not be optimized.

We will evaluate model configurations using repeated stratified k-fold cross-validation with three repeats and 10 folds.

Next, we can define the search space.

This is a dictionary where names are arguments to the model and values are distributions from which to draw samples.

We will optimize the solver, the penalty, and the C hyperparameters of the model with discrete distributions for the solver and penalty type and a log-uniform distribution from 1e-5 to 100 for the C value.

Log-uniform is useful for searching penalty values as we often explore values at different orders of magnitude, at least as a first step.

Next, we can define the search procedure with all of these elements.

Importantly, we must set the number of iterations or samples to draw from the search space via the “n_iter” argument.

In this case, we will set it to 500.

Finally, we can perform the optimization and report the results.

Tying this together, the complete example is listed below.

Running the example may take a minute.

It is fast because we are using a small search space and a fast model to fit and evaluate.

You may see some warnings during the optimization for invalid configuration combinations.

These can be safely ignored.

At the end of the run, the best score and hyperparameter configuration that achieved the best performance are reported.

Your specific results will vary given the stochastic nature of the optimization procedure.

Try running the example a few times.

In this case, we can see that the best configuration achieved an accuracy of about 78.

9 percent, which is fair, and the specific values for the solver, penalty, and C hyperparameters used to achieve that score.

Next, let’s use grid search to find a good model configuration for the sonar dataset.

Using the grid search is much like using the random search for classification.

The main difference is that the search space must be a discrete grid to be searched.

This means that instead of using a log-uniform distribution for C, we can specify discrete values on a log scale.

Additionally, the GridSearchCV class does not take a number of iterations, as we are only evaluating combinations of hyperparameters in the grid.

Tying this together, the complete example of grid searching logistic regression configurations for the sonar dataset is listed below.

Running the example may take a moment.

It is fast because we are using a small search space and a fast model to fit and evaluate.

Again, you may see some warnings during the optimization for invalid configuration combinations.

These can be safely ignored.

At the end of the run, the best score and hyperparameter configuration that achieved the best performance are reported.

Your specific results will vary given the stochastic nature of the optimization procedure.

Try running the example a few times.

In this case, we can see that the best configuration achieved an accuracy of about 78.

2% which is also fair and the specific values for the solver, penalty and C hyperparameters used to achieve that score.

Interestingly, the results are very similar to those found via the random search.

In this section we will use hyper optimization to discover a top-performing model configuration for the auto insurance dataset.

The auto insurance dataset is a standard machine learning dataset comprising 63 rows of data with 1 numerical input variable and a numerical target variable.

Using a test harness of repeated stratified 10-fold cross-validation with 3 repeats, a naive model can achieve a mean absolute error (MAE) of about 66.

A top performing model can achieve a MAE on this same test harness of about 28.

This provides the bounds of expected performance on this dataset.

The dataset involves predicting the total amount in claims (thousands of Swedish Kronor) given the number of claims for different geographical regions.

No need to download the dataset, we will download it automatically as part of our worked examples.

The example below downloads the dataset and summarizes its shape.

Running the example downloads the dataset and splits it into input and output elements.

As expected, we can see that there are 63 rows of data with 1 input variable.

Next, we can use hyperparameter optimization to find a good model configuration for the auto insurance dataset.

To keep things simple, we will focus on a linear model, the linear regression model and the common hyperparameters tuned for this model.

Configuring and using the random search hyperparameter optimization procedure for regression is much like using it for classification.

In this case, we will configure the important hyperparameters of the linear regression implementation, including the solver, alpha, fit_intercept, and normalize.

We will use a discrete distribution of values in the search space for all except the “alpha” argument which is a penalty term, in which case we will use a log-uniform distribution as we did in the previous section for the “C” argument of logistic regression.

The main difference in regression compared to classification is the choice of the scoring method.

For regression, performance is often measured using an error, which is minimized, with zero representing a model with perfect skill.

The hyperparameter optimization procedures in scikit-learn assume a maximizing score.

Therefore a version of each error metric is provided that is made negative.

This means that large positive errors become large negative errors, good performance are small negative values close to zero and perfect skill is zero.

The sign of the negative MAE can be ignored when interpreting the result.

In this case we will mean absolute error (MAE) and a maximizing version of this error is available by setting the “scoring” argument to “neg_mean_absolute_error“.

Tying this together, the complete example is listed below.

Running the example may take a moment.

It is fast because we are using a small search space and a fast model to fit and evaluate.

You may see some warnings during the optimization for invalid configuration combinations.

These can be safely ignored.

At the end of the run, the best score and hyperparameter configuration that achieved the best performance are reported.

Your specific results will vary given the stochastic nature of the optimization procedure.

Try running the example a few times.

In this case, we can see that the best configuration achieved a MAE of about 29.

2, which is very close to the best performance on the model.

We can then see the specific hyperparameter values that achieved this result.

Next, let’s use grid search to find a good model configuration for the auto insurance dataset.

As a grid search, we cannot define a distribution to sample and instead must define a discrete grid of hyperparameter values.

As such, we will specify the “alpha” argument as a range of values on a log-10 scale.

Grid search for regression requires that the “scoring” be specified, much as we did for random search.

In this case, we will again use the negative MAE scoring function.

Tying this together, the complete example of grid searching linear regression configurations for the auto insurance dataset is listed below.

Running the example may take a minute.

It is fast because we are using a small search space and a fast model to fit and evaluate.

Again, you may see some warnings during the optimization for invalid configuration combinations.

These can be safely ignored.

Your specific results will vary given the stochastic nature of the optimization procedure.

Try running the example a few times.

In this case, we can see that the best configuration achieved a MAE of about 29.

2, which is nearly identical to what we achieved with the random search in the previous section.

Interestingly, the hyperparameters are also nearly identical, which is good confirmation.

This section addresses some common questions about hyperparameter optimization.

Choose the method based on your needs.

I recommend starting with grid and doing a random search if you have the time.

Grid search is appropriate for small and quick searches of hyperparameter values that are known to perform well generally.

Random search is appropriate for discovering new hyperparameter values or new combinations of hyperparameters, often resulting in better performance, although it may take more time to complete.

Ensure that you set the “n_jobs” argument to the number of cores on your machine.

After that, more suggestions include:Most algorithms have a subset of hyperparameters that have the most influence over the search procedure.

These are listed in most descriptions of the algorithm.

For example, here are some algorithms and their most important hyperparameters:If you are unsure:Define a new model and set the hyperparameter values of the model to the values found by the search.

Then fit the model on all available data and use the model to start making predictions on new data.

This is called preparing a final model.

See more here:First, fit a final model (previous question).

Then call the predict() function to make a prediction.

For examples of making a prediction with a final model, see the tutorial:Do you have another question about hyperparameter optimization? Let me know in the comments below.

This section provides more resources on the topic if you are looking to go deeper.

In this tutorial, you discovered hyperparameter optimization for machine learning in Python.

Specifically, you learned:Do you have any questions? Ask your questions in the comments below and I will do my best to answer.

with just a few lines of scikit-learn codeLearn how in my new Ebook: Machine Learning Mastery With PythonCovers self-study tutorials and end-to-end projects like: Loading data, visualization, modeling, tuning, and much more.

Skip the Academics.

Just Results.

.