Main Content

Train Nearest Neighbor Classifiers Using Classification Learner App

This example shows how to construct nearest neighbors classifiers in the Classification Learner app.

  1. In MATLAB®, load the fisheriris data set and define some variables from the data set to use for a classification.

    fishertable = readtable("fisheriris.csv");
    
  2. On the Apps tab, in the Machine Learning and Deep Learning group, click Classification Learner.

  3. On the Learn tab, in the File section, click New Session > From Workspace.

    Learn tab

    In the New Session from Workspace dialog box, select the table fishertable from the Data Set Variable list (if necessary). Observe that the app has selected response and predictor variables based on their data type. Petal and sepal length and width are predictors, and species is the response that you want to classify. For this example, do not change the selections.

  4. Click Start Session.

    The app creates a scatter plot of the data.

  5. Use the scatter plot to investigate which variables are useful for predicting the response. To visualize the distribution of species and measurements, select different options in the X- and Y-axis controls. Observe which variables separate the species colors most clearly.

  6. To train a selection of nearest neighbor models, on the Learn tab, in the Models section, click the arrow to expand the list of classifiers, and under Nearest Neighbor Classifiers, click All KNNs. Then, in the Train section, click Train All and select Train All.

    Note

    • If you have Parallel Computing Toolbox™, then the Use Parallel button is selected by default. After you click Train All and select Train All or Train Selected, the app opens a parallel pool of workers. During this time, you cannot interact with the software. After the pool opens, you can continue to interact with the app while models train in parallel.

    • If you do not have Parallel Computing Toolbox, then the Use Background Training check box in the Train All menu is selected by default. After you select an option to train models, the app opens a background pool. After the pool opens, you can continue to interact with the app while models train in the background.

    Classification Learner trains one of each nearest neighbor classification option in the gallery, as well as the default fine tree model. The app outlines in a box the Accuracy (Validation) score of the best model. Classification Learner also displays a validation confusion matrix for the first KNN model (Fine KNN).

    Validation confusion matrix of the iris data modeled by a KNN classifier. Blue values indicate correct classifications, and red values indicate incorrect classifications.

    Note

    Validation introduces some randomness into the results. Your model validation results can vary from the results shown in this example.

  7. To view the results for a model, select the model in the Models pane, and inspect the Summary tab. To open this tab, right-click the model and select Summary. The Summary tab displays the Training Results metrics, calculated on the validation set.

  8. For the selected model, inspect the accuracy of the predictions in each class. On the Learn tab, in the Plots and Results section, click the arrow to open the gallery, and then click Confusion Matrix (Validation) in the Validation Results group. View the matrix of true class and predicted class results.

  9. For each remaining model, select the model in the Models pane, open the validation confusion matrix, and then compare the results across the models.

  10. Choose the best model in the Models pane (the best score is highlighted in a box). To improve the model, try including different features in the model. See if you can improve the model by removing features with low predictive power.

    First, duplicate the best model by right-clicking the model and selecting Duplicate.

  11. Investigate features to include or exclude using one of these methods.

    • Use the parallel coordinates plot. On the Learn tab, in the Plots and Results section, click the arrow to open the gallery, and then click Parallel Coordinates in the Validation Results group. Keep predictors that separate classes well.

      In the model Summary tab, you can specify the predictors to use during training. Click Feature Selection to expand the section, and specify predictors to remove from the model.

    • Use a feature ranking algorithm. On the Learn tab, in the Options section, click Feature Selection. In the Default Feature Selection tab, specify the feature ranking algorithm you want to use, and the number of features to keep among the highest ranked features. The bar graph can help you decide how many features to use.

      Click Save and Apply to save your changes. The new feature selection is applied to the existing draft model in the Models pane and will be applied to new draft models that you create using the gallery in the Models section of the Learn tab.

  12. Train the model. On the Learn tab, in the Train section, click Train All and select Train Selected to train the model using the new options. Compare results among the classifiers in the Models pane.

  13. Choose the best model in the Models pane. To try to improve the model further, try changing its hyperparameters. First, duplicate the best model by right-clicking the model and selecting Duplicate. Then, try changing a hyperparameter setting in the model Summary tab. Train the new model by clicking Train All and selecting Train Selected in the Train section. For information on settings and the strengths of different nearest neighbor model types, see Nearest Neighbor Classifiers.

  14. You can export a full version of the trained model to the workspace. On the Learn tab, click Export, click Export Model and select Export Model. In the Export Classification Model dialog box, the check box to include the training data is selected and disabled, because nearest neighbor approximation models always store training data. Click OK in the dialog box to accept the default variable name.

  15. To examine the code for training this classifier, click Generate Function.

Use the same workflow to evaluate and compare the other classifier types you can train in Classification Learner.

To try all the nonoptimizable classifier model presets available for your data set:

  1. On the Learn tab, in the Models section, click the arrow to open the gallery of classification models.

  2. In the Get Started group, click All.

    Option selected for training all available classifier types

  3. In the Train section, click Train All and select Train All.

To learn about other classifier types, see Train Classification Models in Classification Learner App.

Related Topics