ML0101EN-Clas-K-Nearest-neighbors-CustCat-py-v1.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "<center>\n",
    "    <img src=\"https://s3-api.us-geo.objectstorage.softlayer.net/cf-courses-data/CognitiveClass/Logos/organization_logo/organization_logo.png\" width=\"300\" alt=\"cognitiveclass.ai logo\"  />\n",
    "</center>\n",
    "\n",
    "# K-Nearest Neighbors\n",
    "\n",
    "Estimated time needed: **25** minutes\n",
    "\n",
    "## Objectives\n",
    "\n",
    "After completing this lab you will be able to:\n",
    "\n",
    "-   Use K Nearest neighbors to classify data\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "In this Lab you will load a customer dataset, fit the data, and use K-Nearest Neighbors to predict a data point. But what is **K-Nearest Neighbors**?\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "**K-Nearest Neighbors** is an algorithm for supervised learning. Where the data is 'trained' with data points corresponding to their classification. Once a point is to be predicted, it takes into account the 'K' nearest points to it to determine it's classification.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "### Here's an visualization of the K-Nearest Neighbors algorithm.\n",
    "\n",
    "<img src=\"https://ibm.box.com/shared/static/mgkn92xck0z05v7yjq8pqziukxvc2461.png\">\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "In this case, we have data points of Class A and B. We want to predict what the star (test data point) is. If we consider a k value of 3 (3 nearest data points) we will obtain a prediction of Class B. Yet if we consider a k value of 6, we will obtain a prediction of Class A.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "In this sense, it is important to consider the value of k. But hopefully from this diagram, you should get a sense of what the K-Nearest Neighbors algorithm is. It considers the 'K' Nearest Neighbors (points) when it predicts the classification of the test point.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<h1>Table of contents</h1>\n",
    "\n",
    "<div class=\"alert alert-block alert-info\" style=\"margin-top: 20px\">\n",
    "    <ol>\n",
    "        <li><a href=\"#about_dataset\">About the dataset</a></li>\n",
    "        <li><a href=\"#visualization_analysis\">Data Visualization and Analysis</a></li>\n",
    "        <li><a href=\"#classification\">Classification</a></li>\n",
    "    </ol>\n",
    "</div>\n",
    "<br>\n",
    "<hr>\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Lets load required libraries\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [],
   "source": [
    "import numpy as np\n",
    "import matplotlib.pyplot as plt\n",
    "import pandas as pd\n",
    "import numpy as np\n",
    "from sklearn import preprocessing\n",
    "%matplotlib inline"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "<div id=\"about_dataset\">\n",
    "    <h2>About the dataset</h2>\n",
    "</div>\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Imagine a telecommunications provider has segmented its customer base by service usage patterns, categorizing the customers into four groups. If demographic data can be used to predict group membership, the company can customize offers for individual prospective customers. It is a classification problem. That is, given the dataset,  with predefined labels, we need to build a model to be used to predict class of a new or unknown case. \n",
    "\n",
    "The example focuses on using demographic data, such as region, age, and marital, to predict usage patterns. \n",
    "\n",
    "The target field, called **custcat**, has four possible values that correspond to the four customer groups, as follows:\n",
    "  1- Basic Service\n",
    "  2- E-Service\n",
    "  3- Plus Service\n",
    "  4- Total Service\n",
    "\n",
    "Our objective is to build a classifier, to predict the class of unknown cases. We will use a specific type of classification called K nearest neighbour.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Lets download the dataset. To download the data, we will use !wget to download it from IBM Object Storage.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "--2020-12-20 02:46:25--  https://cf-courses-data.s3.us.cloud-object-storage.appdomain.cloud/IBMDeveloperSkillsNetwork-ML0101EN-SkillsNetwork/labs/Module%203/data/teleCust1000t.csv\n",
      "Resolving cf-courses-data.s3.us.cloud-object-storage.appdomain.cloud (cf-courses-data.s3.us.cloud-object-storage.appdomain.cloud)... 169.63.118.104\n",
      "Connecting to cf-courses-data.s3.us.cloud-object-storage.appdomain.cloud (cf-courses-data.s3.us.cloud-object-storage.appdomain.cloud)|169.63.118.104|:443... connected.\n",
      "HTTP request sent, awaiting response... 200 OK\n",
      "Length: 36047 (35K) [text/csv]\n",
      "Saving to: ‘teleCust1000t.csv’\n",
      "\n",
      "teleCust1000t.csv   100%[===================>]  35.20K  --.-KB/s    in 0.02s   \n",
      "\n",
      "2020-12-20 02:46:26 (1.88 MB/s) - ‘teleCust1000t.csv’ saved [36047/36047]\n",
      "\n"
     ]
    }
   ],
   "source": [
    "!wget -O teleCust1000t.csv https://cf-courses-data.s3.us.cloud-object-storage.appdomain.cloud/IBMDeveloperSkillsNetwork-ML0101EN-SkillsNetwork/labs/Module%203/data/teleCust1000t.csv"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Did you know?** When it comes to Machine Learning, you will likely be working with large datasets. As a business, where can you host your data? IBM is offering a unique opportunity for businesses, with 10 Tb of IBM Cloud Object Storage: [Sign up now for free](http://cocl.us/ML0101EN-IBM-Offer-CC)\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "### Load Data From CSV File\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>region</th>\n",
       "      <th>tenure</th>\n",
       "      <th>age</th>\n",
       "      <th>marital</th>\n",
       "      <th>address</th>\n",
       "      <th>income</th>\n",
       "      <th>ed</th>\n",
       "      <th>employ</th>\n",
       "      <th>retire</th>\n",
       "      <th>gender</th>\n",
       "      <th>reside</th>\n",
       "      <th>custcat</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>2</td>\n",
       "      <td>13</td>\n",
       "      <td>44</td>\n",
       "      <td>1</td>\n",
       "      <td>9</td>\n",
       "      <td>64.0</td>\n",
       "      <td>4</td>\n",
       "      <td>5</td>\n",
       "      <td>0.0</td>\n",
       "      <td>0</td>\n",
       "      <td>2</td>\n",
       "      <td>1</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>3</td>\n",
       "      <td>11</td>\n",
       "      <td>33</td>\n",
       "      <td>1</td>\n",
       "      <td>7</td>\n",
       "      <td>136.0</td>\n",
       "      <td>5</td>\n",
       "      <td>5</td>\n",
       "      <td>0.0</td>\n",
       "      <td>0</td>\n",
       "      <td>6</td>\n",
       "      <td>4</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>3</td>\n",
       "      <td>68</td>\n",
       "      <td>52</td>\n",
       "      <td>1</td>\n",
       "      <td>24</td>\n",
       "      <td>116.0</td>\n",
       "      <td>1</td>\n",
       "      <td>29</td>\n",
       "      <td>0.0</td>\n",
       "      <td>1</td>\n",
       "      <td>2</td>\n",
       "      <td>3</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>2</td>\n",
       "      <td>33</td>\n",
       "      <td>33</td>\n",
       "      <td>0</td>\n",
       "      <td>12</td>\n",
       "      <td>33.0</td>\n",
       "      <td>2</td>\n",
       "      <td>0</td>\n",
       "      <td>0.0</td>\n",
       "      <td>1</td>\n",
       "      <td>1</td>\n",
       "      <td>1</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>2</td>\n",
       "      <td>23</td>\n",
       "      <td>30</td>\n",
       "      <td>1</td>\n",
       "      <td>9</td>\n",
       "      <td>30.0</td>\n",
       "      <td>1</td>\n",
       "      <td>2</td>\n",
       "      <td>0.0</td>\n",
       "      <td>0</td>\n",
       "      <td>4</td>\n",
       "      <td>3</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   region  tenure  age  marital  address  income  ed  employ  retire  gender  \\\n",
       "0       2      13   44        1        9    64.0   4       5     0.0       0   \n",
       "1       3      11   33        1        7   136.0   5       5     0.0       0   \n",
       "2       3      68   52        1       24   116.0   1      29     0.0       1   \n",
       "3       2      33   33        0       12    33.0   2       0     0.0       1   \n",
       "4       2      23   30        1        9    30.0   1       2     0.0       0   \n",
       "\n",
       "   reside  custcat  \n",
       "0       2        1  \n",
       "1       6        4  \n",
       "2       2        3  \n",
       "3       1        1  \n",
       "4       4        3  "
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "df = pd.read_csv('teleCust1000t.csv')\n",
    "df.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "<div id=\"visualization_analysis\">\n",
    "    <h2>Data Visualization and Analysis</h2> \n",
    "</div>\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "#### Let’s see how many of each class is in our data set\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "3    281\n",
       "1    266\n",
       "4    236\n",
       "2    217\n",
       "Name: custcat, dtype: int64"
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "df['custcat'].value_counts()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "#### 281 Plus Service, 266 Basic-service, 236 Total Service, and 217 E-Service customers\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You can easily explore your data using visualization techniques:\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[<AxesSubplot:title={'center':'income'}>]], dtype=object)"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "df.hist(column='income', bins=50)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "### Feature set\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Lets define feature sets, X:\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Index(['region', 'tenure', 'age', 'marital', 'address', 'income', 'ed',\n",
       "       'employ', 'retire', 'gender', 'reside', 'custcat'],\n",
       "      dtype='object')"
      ]
     },
     "execution_count": 6,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "df.columns"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "To use scikit-learn library, we have to convert the Pandas data frame to a Numpy array:\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[  2.,  13.,  44.,   1.,   9.,  64.,   4.,   5.,   0.,   0.,   2.],\n",
       "       [  3.,  11.,  33.,   1.,   7., 136.,   5.,   5.,   0.,   0.,   6.],\n",
       "       [  3.,  68.,  52.,   1.,  24., 116.,   1.,  29.,   0.,   1.,   2.],\n",
       "       [  2.,  33.,  33.,   0.,  12.,  33.,   2.,   0.,   0.,   1.,   1.],\n",
       "       [  2.,  23.,  30.,   1.,   9.,  30.,   1.,   2.,   0.,   0.,   4.]])"
      ]
     },
     "execution_count": 8,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "X = df[['region', 'tenure','age', 'marital', 'address', 'income', 'ed', 'employ','retire', 'gender', 'reside']] .values.astype(float)\n",
    "X[0:5]\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "What are our labels?\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([1, 4, 3, 1, 3])"
      ]
     },
     "execution_count": 9,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "y = df['custcat'].values\n",
    "y[0:5]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "## Normalize Data\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Data Standardization give data zero mean and unit variance, it is good practice, especially for algorithms such as KNN which is based on distance of cases:\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[-0.02696767, -1.055125  ,  0.18450456,  1.0100505 , -0.25303431,\n",
       "        -0.12650641,  1.0877526 , -0.5941226 , -0.22207644, -1.03459817,\n",
       "        -0.23065004],\n",
       "       [ 1.19883553, -1.14880563, -0.69181243,  1.0100505 , -0.4514148 ,\n",
       "         0.54644972,  1.9062271 , -0.5941226 , -0.22207644, -1.03459817,\n",
       "         2.55666158],\n",
       "       [ 1.19883553,  1.52109247,  0.82182601,  1.0100505 ,  1.23481934,\n",
       "         0.35951747, -1.36767088,  1.78752803, -0.22207644,  0.96655883,\n",
       "        -0.23065004],\n",
       "       [-0.02696767, -0.11831864, -0.69181243, -0.9900495 ,  0.04453642,\n",
       "        -0.41625141, -0.54919639, -1.09029981, -0.22207644,  0.96655883,\n",
       "        -0.92747794],\n",
       "       [-0.02696767, -0.58672182, -0.93080797,  1.0100505 , -0.25303431,\n",
       "        -0.44429125, -1.36767088, -0.89182893, -0.22207644, -1.03459817,\n",
       "         1.16300577]])"
      ]
     },
     "execution_count": 10,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "X = preprocessing.StandardScaler().fit(X).transform(X.astype(float))\n",
    "X[0:5]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "### Train Test Split\n",
    "\n",
    "Out of Sample Accuracy is the percentage of correct predictions that the model makes on data that that the model has NOT been trained on. Doing a train and test on the same dataset will most likely have low out-of-sample accuracy, due to the likelihood of being over-fit.\n",
    "\n",
    "It is important that our models have a high, out-of-sample accuracy, because the purpose of any model, of course, is to make correct predictions on unknown data. So how can we improve out-of-sample accuracy? One way is to use an evaluation approach called Train/Test Split.\n",
    "Train/Test Split involves splitting the dataset into training and testing sets respectively, which are mutually exclusive. After which, you train with the training set and test with the testing set. \n",
    "\n",
    "This will provide a more accurate evaluation on out-of-sample accuracy because the testing dataset is not part of the dataset that have been used to train the data. It is more realistic for real world problems.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Train set: (800, 11) (800,)\n",
      "Test set: (200, 11) (200,)\n"
     ]
    }
   ],
   "source": [
    "from sklearn.model_selection import train_test_split\n",
    "X_train, X_test, y_train, y_test = train_test_split( X, y, test_size=0.2, random_state=4)\n",
    "print ('Train set:', X_train.shape,  y_train.shape)\n",
    "print ('Test set:', X_test.shape,  y_test.shape)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "<div id=\"classification\">\n",
    "    <h2>Classification</h2>\n",
    "</div>\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "<h3>K nearest neighbor (KNN)</h3>\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "#### Import library\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Classifier implementing the k-nearest neighbors vote.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [],
   "source": [
    "from sklearn.neighbors import KNeighborsClassifier"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "### Training\n",
    "\n",
    "Lets start the algorithm with k=4 for now:\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "KNeighborsClassifier(algorithm='auto', leaf_size=30, metric='minkowski',\n",
       "           metric_params=None, n_jobs=None, n_neighbors=4, p=2,\n",
       "           weights='uniform')"
      ]
     },
     "execution_count": 13,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "k = 4\n",
    "#Train Model and Predict  \n",
    "neigh = KNeighborsClassifier(n_neighbors = k).fit(X_train,y_train)\n",
    "neigh"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "### Predicting\n",
    "\n",
    "we can use the model to predict the test set:\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([1, 1, 3, 2, 4])"
      ]
     },
     "execution_count": 14,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "yhat = neigh.predict(X_test)\n",
    "yhat[0:5]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "### Accuracy evaluation\n",
    "\n",
    "In multilabel classification, **accuracy classification score** is a function that computes subset accuracy. This function is equal to the jaccard_similarity_score function. Essentially, it calculates how closely the actual labels and predicted labels are matched in the test set.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Train set Accuracy:  0.5475\n",
      "Test set Accuracy:  0.32\n"
     ]
    }
   ],
   "source": [
    "from sklearn import metrics\n",
    "print(\"Train set Accuracy: \", metrics.accuracy_score(y_train, neigh.predict(X_train)))\n",
    "print(\"Test set Accuracy: \", metrics.accuracy_score(y_test, yhat))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Practice\n",
    "\n",
    "Can you build the model again, but this time with k=6?\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Train set Accuracy:  0.51625\n",
      "Test set Accuracy:  0.31\n"
     ]
    }
   ],
   "source": [
    "# write your code here\n",
    "\n",
    "k = 6\n",
    "neigh6 = KNeighborsClassifier(n_neighbors = k).fit(X_train,y_train)\n",
    "yhat6 = neigh6.predict(X_test)\n",
    "print(\"Train set Accuracy: \", metrics.accuracy_score(y_train, neigh6.predict(X_train)))\n",
    "print(\"Test set Accuracy: \", metrics.accuracy_score(y_test, yhat6))\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<details><summary>Click here for the solution</summary>\n",
    "\n",
    "```python\n",
    "k = 6\n",
    "neigh6 = KNeighborsClassifier(n_neighbors = k).fit(X_train,y_train)\n",
    "yhat6 = neigh6.predict(X_test)\n",
    "print(\"Train set Accuracy: \", metrics.accuracy_score(y_train, neigh6.predict(X_train)))\n",
    "print(\"Test set Accuracy: \", metrics.accuracy_score(y_test, yhat6))\n",
    "\n",
    "```\n",
    "\n",
    "</details>\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "#### What about other K?\n",
    "\n",
    "K in KNN, is the number of nearest neighbors to examine. It is supposed to be specified by the User. So, how can we choose right value for K?\n",
    "The general solution is to reserve a part of your data for testing the accuracy of the model. Then chose k =1, use the training part for modeling, and calculate the accuracy of prediction using all samples in your test set. Repeat this process, increasing the k, and see which k is the best for your model.\n",
    "\n",
    "We can calculate the accuracy of KNN for different Ks.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([0.3  , 0.29 , 0.315, 0.32 , 0.315, 0.31 , 0.335, 0.325, 0.34 ,\n",
       "       0.33 , 0.315, 0.34 , 0.33 , 0.315])"
      ]
     },
     "execution_count": 20,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "Ks = 15\n",
    "mean_acc = np.zeros((Ks-1))\n",
    "std_acc = np.zeros((Ks-1))\n",
    "\n",
    "for n in range(1,Ks):\n",
    "    \n",
    "    #Train Model and Predict  \n",
    "    neigh = KNeighborsClassifier(n_neighbors = n).fit(X_train,y_train)\n",
    "    yhat=neigh.predict(X_test)\n",
    "    mean_acc[n-1] = metrics.accuracy_score(y_test, yhat)\n",
    "\n",
    "    \n",
    "    std_acc[n-1]=np.std(yhat==y_test)/np.sqrt(yhat.shape[0])\n",
    "\n",
    "mean_acc"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "#### Plot  model accuracy  for Different number of Neighbors\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.plot(range(1,Ks),mean_acc,'g')\n",
    "plt.fill_between(range(1,Ks),mean_acc - 1 * std_acc,mean_acc + 1 * std_acc, alpha=0.10)\n",
    "plt.fill_between(range(1,Ks),mean_acc - 3 * std_acc,mean_acc + 3 * std_acc, alpha=0.10,color=\"green\")\n",
    "plt.legend(('Accuracy ', '+/- 1xstd','+/- 3xstd'))\n",
    "plt.ylabel('Accuracy ')\n",
    "plt.xlabel('Number of Neighbors (K)')\n",
    "plt.tight_layout()\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "The best accuracy was with 0.34 with k= 9\n"
     ]
    }
   ],
   "source": [
    "print( \"The best accuracy was with\", mean_acc.max(), \"with k=\", mean_acc.argmax()+1) "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "<h2>Want to learn more?</h2>\n",
    "\n",
    "IBM SPSS Modeler is a comprehensive analytics platform that has many machine learning algorithms. It has been designed to bring predictive intelligence to decisions made by individuals, by groups, by systems – by your enterprise as a whole. A free trial is available through this course, available here: <a href=\"https://www.ibm.com/analytics/spss-statistics-software\">SPSS Modeler</a>\n",
    "\n",
    "Also, you can use Watson Studio to run these notebooks faster with bigger datasets. Watson Studio is IBM's leading cloud solution for data scientists, built by data scientists. With Jupyter notebooks, RStudio, Apache Spark and popular libraries pre-packaged in the cloud, Watson Studio enables data scientists to collaborate on their projects without having to install anything. Join the fast-growing community of Watson Studio users today with a free account at <a href=\"https://www.ibm.com/cloud/watson-studio\">Watson Studio</a>\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Thank you for completing this lab!\n",
    "\n",
    "## Author\n",
    "\n",
    "Saeed Aghabozorgi\n",
    "\n",
    "### Other Contributors\n",
    "\n",
    "<a href=\"https://www.linkedin.com/in/joseph-s-50398b136/\" target=\"_blank\">Joseph Santarcangelo</a>\n",
    "\n",
    "## Change Log\n",
    "\n",
    "| Date (YYYY-MM-DD) | Version | Changed By | Change Description                 |\n",
    "| ----------------- | ------- | ---------- | ---------------------------------- |\n",
    "| 2020-11-20        | 2.3     | Lakshmi    | Removed unused imports             |\n",
    "| 2020-11-17        | 2.2     | Lakshmi    | Changed plot function of KNN       |\n",
    "| 2020-11-03        | 2.1     | Lakshmi    | Changed URL of csv                 |\n",
    "| 2020-08-27        | 2.0     | Lavanya    | Moved lab to course repo in GitLab |\n",
    "|                   |         |            |                                    |\n",
    "|                   |         |            |                                    |\n",
    "\n",
    "## <h3 align=\"center\"> © IBM Corporation 2020. All rights reserved. <h3/>\n"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python",
   "language": "python",
   "name": "conda-env-python-py"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.6.12"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}