{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Decision trees, overarching aims\n", "\n", "\n", "We start here with the most basic algorithm, the so-called decision\n", "tree. With this basic algorithm we can in turn build more complex\n", "networks, spanning from homogeneous and heterogenous forests (bagging,\n", "random forests and more) to one of the most popular supervised\n", "algorithms nowadays, the extreme gradient boosting, or just\n", "XGBoost. But let us start with the simplest possible ingredient.\n", "\n", "Decision trees are supervised learning algorithms used for both,\n", "classification and regression tasks.\n", "\n", "\n", "The main idea of decision trees\n", "is to find those descriptive features which contain the most\n", "**information** regarding the target feature and then split the dataset\n", "along the values of these features such that the target feature values\n", "for the resulting underlying datasets are as pure as possible.\n", "\n", "The descriptive features which reproduce best the target/output features are normally said\n", "to be the most informative ones. The process of finding the **most\n", "informative** feature is done until we accomplish a stopping criteria\n", "where we then finally end up in so called **leaf nodes**. \n", "\n", "## Basics of a tree\n", "\n", "A decision tree is typically divided into a **root node**, the **interior nodes**,\n", "and the final **leaf nodes** or just **leaves**. These entities are then connected by so-called **branches**.\n", "\n", "The leaf nodes\n", "contain the predictions we will make for new query instances presented\n", "to our trained model. This is possible since the model has \n", "learned the underlying structure of the training data and hence can,\n", "given some assumptions, make predictions about the target feature value\n", "(class) of unseen query instances.\n", "\n", "\n", "## General Features\n", "\n", "The overarching approach to decision trees is a top-down approach.\n", "\n", "* A leaf provides the classification of a given instance.\n", "\n", "* A node specifies a test of some attribute of the instance.\n", "\n", "* A branch corresponds to a possible values of an attribute.\n", "\n", "* An instance is classified by starting at the root node of the tree, testing the attribute specified by this node, then moving down the tree branch corresponding to the value of the attribute in the given example.\n", "\n", "This process is then repeated for the subtree rooted at the new\n", "node.\n", "\n", "\n", "\n", "In simplified terms, the process of training a decision tree and\n", "predicting the target features of query instances is as follows:\n", "\n", "1. Present a dataset containing of a number of training instances characterized by a number of descriptive features and a target feature\n", "\n", "2. Train the decision tree model by continuously splitting the target feature along the values of the descriptive features using a measure of information gain during the training process\n", "\n", "3. Grow the tree until we accomplish a stopping criteria create leaf nodes which represent the *predictions* we want to make for new query instances\n", "\n", "4. Show query instances to the tree and run down the tree until we arrive at leaf nodes\n", "\n", "Then we are essentially done!" ] }, { "cell_type": "code", "execution_count": 1, "metadata": { "collapsed": false, "editable": true }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "2nd degree coefficients:\n", "zero power: 0.3156929654100207\n", "first power: 0.07744472306026946\n", "second power: 0.00015921913736794912\n" ] }, { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": { "filenames": { "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter6_1_1.png" }, "needs_background": "light" }, "output_type": "display_data" }, { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": { "filenames": { "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter6_1_2.png" }, "needs_background": "light" }, "output_type": "display_data" } ], "source": [ "%matplotlib inline\n", "\n", "import numpy as np\n", "import matplotlib.pyplot as plt\n", "from sklearn.preprocessing import PolynomialFeatures\n", "from sklearn.linear_model import LinearRegression\n", "\n", "steps=250\n", "\n", "distance=0\n", "x=0\n", "distance_list=[]\n", "steps_list=[]\n", "while x\u001b[0m in \u001b[0;36m\u001b[0;34m\u001b[0m\n\u001b[1;32m 7\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 8\u001b[0m \u001b[0;32mfrom\u001b[0m \u001b[0mIPython\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mdisplay\u001b[0m \u001b[0;32mimport\u001b[0m \u001b[0mImage\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m----> 9\u001b[0;31m \u001b[0;32mfrom\u001b[0m \u001b[0mpydot\u001b[0m \u001b[0;32mimport\u001b[0m \u001b[0mgraph_from_dot_data\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 10\u001b[0m \u001b[0;32mimport\u001b[0m \u001b[0mpandas\u001b[0m \u001b[0;32mas\u001b[0m \u001b[0mpd\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 11\u001b[0m \u001b[0;32mimport\u001b[0m \u001b[0mnumpy\u001b[0m \u001b[0;32mas\u001b[0m \u001b[0mnp\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", "\u001b[0;31mModuleNotFoundError\u001b[0m: No module named 'pydot'" ] } ], "source": [ "import os\n", "from sklearn.datasets import load_breast_cancer\n", "from sklearn.tree import DecisionTreeClassifier\n", "from sklearn.model_selection import train_test_split\n", "from sklearn.metrics import confusion_matrix\n", "from sklearn.tree import export_graphviz\n", "\n", "from IPython.display import Image \n", "from pydot import graph_from_dot_data\n", "import pandas as pd\n", "import numpy as np\n", "\n", "\n", "cancer = load_breast_cancer()\n", "X = pd.DataFrame(cancer.data, columns=cancer.feature_names)\n", "print(X)\n", "y = pd.Categorical.from_codes(cancer.target, cancer.target_names)\n", "y = pd.get_dummies(y)\n", "print(y)\n", "X_train, X_test, y_train, y_test = train_test_split(X, y, random_state=1)\n", "tree_clf = DecisionTreeClassifier(max_depth=5)\n", "tree_clf.fit(X_train, y_train)\n", "\n", "export_graphviz(\n", " tree_clf,\n", " out_file=\"DataFiles/cancer.dot\",\n", " feature_names=cancer.feature_names,\n", " class_names=cancer.target_names,\n", " rounded=True,\n", " filled=True\n", ")\n", "cmd = 'dot -Tpng DataFiles/cancer.dot -o DataFiles/cancer.png'\n", "os.system(cmd)" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false, "editable": true }, "outputs": [], "source": [ "# Common imports\n", "import numpy as np\n", "from sklearn.model_selection import train_test_split \n", "from sklearn.tree import DecisionTreeClassifier\n", "from sklearn.datasets import make_moons\n", "from sklearn.tree import export_graphviz\n", "from pydot import graph_from_dot_data\n", "import pandas as pd\n", "import os\n", "\n", "np.random.seed(42)\n", "X, y = make_moons(n_samples=100, noise=0.25, random_state=53)\n", "X_train, X_test, y_train, y_test = train_test_split(X,y,random_state=0)\n", "tree_clf = DecisionTreeClassifier(max_depth=5)\n", "tree_clf.fit(X_train, y_train)\n", "\n", "export_graphviz(\n", " tree_clf,\n", " out_file=\"DataFiles/moons.dot\",\n", " rounded=True,\n", " filled=True\n", ")\n", "cmd = 'dot -Tpng DataFiles/moons.dot -o DataFiles/moons.png'\n", "os.system(cmd)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Other ways of visualizing the trees\n", "\n", "**Scikit-Learn** has also another way to visualize the trees which is very useful, here with the Iris data." ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false, "editable": true }, "outputs": [], "source": [ "from sklearn.datasets import load_iris\n", "from sklearn import tree\n", "X, y = load_iris(return_X_y=True)\n", "tree_clf = tree.DecisionTreeClassifier()\n", "tree_clf = tree_clf.fit(X, y)\n", "# and then plot the tree\n", "tree.plot_tree(tree_clf)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Alternatively, the tree can also be exported in textual format with the function exporttext.\n", "This method doesn’t require the installation of external libraries and is more compact:" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false, "editable": true }, "outputs": [], "source": [ "from sklearn.datasets import load_iris\n", "from sklearn.tree import DecisionTreeClassifier\n", "from sklearn.tree import export_text\n", "iris = load_iris()\n", "decision_tree = DecisionTreeClassifier(random_state=0, max_depth=2)\n", "decision_tree = decision_tree.fit(iris.data, iris.target)\n", "r = export_text(decision_tree, feature_names=iris['feature_names'])\n", "print(r)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Algorithms for Setting up Decision Trees\n", "\n", "Two algorithms stand out in the set up of decision trees:\n", "1. The CART (Classification And Regression Tree) algorithm for both classification and regression\n", "\n", "2. The ID3 algorithm based on the computation of the information gain for classification\n", "\n", "We discuss both algorithms with applications here. The popular library\n", "**Scikit-Learn** uses the CART algorithm. For classification problems\n", "you can use either the **gini** index or the **entropy** to split a tree\n", "in two branches.\n", "\n", "### The CART algorithm for Classification\n", "\n", "For classification, the CART algorithm splits the data set in two subsets using a single feature $k$ and a threshold $t_k$.\n", "This could be for example a threshold set by a number below a certain circumference of a malign tumor.\n", "\n", "How do we find these two quantities?\n", "We search for the pair $(k,t_k)$ that produces the purest subset using for example the **gini** factor $G$.\n", "The cost function it tries to minimize is then" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "C(k,t_k) = \\frac{m_{\\mathrm{left}}}{m}G_{\\mathrm{left}}+ \\frac{m_{\\mathrm{right}}}{m}G_{\\mathrm{right}},\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "where $G_{\\mathrm{left/right}}$ measures the impurity of the left/right subset and $m_{\\mathrm{left/right}}$\n", " is the number of instances in the left/right subset\n", "\n", "Once it has successfully split the training set in two, it splits the subsets using the same logic, then the subsubsets\n", "and so on, recursively. It stops recursing once it reaches the maximum depth (defined by the\n", "$max\\_depth$ hyperparameter), or if it cannot find a split that will reduce impurity. A few other\n", "hyperparameters control additional stopping conditions such as the $min\\_samples\\_split$,\n", "$min\\_samples\\_leaf$, $min\\_weight\\_fraction\\_leaf$, and $max\\_leaf\\_nodes$.\n", "\n", "\n", "### The CART algorithm for Regression\n", "\n", "The CART algorithm for regression works is similar to the one for classification except that instead of trying to split the\n", "training set in a way that minimizes say the **gini** or **entropy** impurity, it now tries to split the training set in a way that minimizes our well-known mean-squared error (MSE). The cost function is now" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "C(k,t_k) = \\frac{m_{\\mathrm{left}}}{m}\\mathrm{MSE}_{\\mathrm{left}}+ \\frac{m_{\\mathrm{right}}}{m}\\mathrm{MSE}_{\\mathrm{right}}.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Here the MSE for a specific node is defined as" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\mathrm{MSE}_{\\mathrm{node}}=\\frac{1}{m_\\mathrm{node}}\\sum_{i\\in \\mathrm{node}}(\\overline{y}_{\\mathrm{node}}-y_i)^2,\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "with" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\overline{y}_{\\mathrm{node}}=\\frac{1}{m_\\mathrm{node}}\\sum_{i\\in \\mathrm{node}}y_i,\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "the mean value of all observations in a specific node.\n", "\n", "Without any regularization, the regression task for decision trees, \n", "just like for classification tasks, is prone to overfitting.\n", "\n", "\n", "\n", "### Computing the Gini index\n", "\n", "The example we will look at is a classical one in many Machine\n", "Learning applications. Based on various meteorological features, we\n", "have several so-called attributes which decide whether we at the end\n", "will do some outdoor activity like skiing, going for a bike ride etc\n", "etc. The table here contains the feautures **outlook**, **temperature**,\n", "**humidity** and **wind**. The target or output is whether we ride\n", "(True=1) or whether we do something else that day (False=0). The\n", "attributes for each feature are then sunny, overcast and rain for the\n", "outlook, hot, cold and mild for temperature, high and normal for\n", "humidity and weak and strong for wind.\n", "\n", "The table here summarizes the various attributes and\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "
Day Outlook Temperature Humidity Wind Ride
1 Sunny Hot High Weak 0
2 Sunny Hot High Strong 1
3 Overcast Hot High Weak 1
4 Rain Mild High Weak 1
5 Rain Cool Normal Weak 1
6 Rain Cool Normal Strong 0
7 Overcast Cool Normal Strong 1
8 Sunny Mild High Weak 0
9 Sunny Cool Normal Weak 1
10 Rain Mild Normal Weak 1
11 Sunny Mild Normal Strong 1
12 Overcast Mild High Strong 1
13 Overcast Hot Normal Weak 1
14 Rain Mild High Strong 0
\n", "\n", "### Simple Python Code to read in Data and perform Classification" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false, "editable": true }, "outputs": [], "source": [ "# Common imports\n", "import numpy as np\n", "import pandas as pd\n", "import matplotlib.pyplot as plt\n", "from sklearn.tree import DecisionTreeClassifier\n", "from sklearn.model_selection import train_test_split\n", "from sklearn.tree import export_graphviz\n", "from sklearn.preprocessing import StandardScaler, OneHotEncoder\n", "from sklearn.compose import ColumnTransformer\n", "from IPython.display import Image \n", "from pydot import graph_from_dot_data\n", "import os\n", "\n", "# Where to save the figures and data files\n", "PROJECT_ROOT_DIR = \"Results\"\n", "FIGURE_ID = \"Results/FigureFiles\"\n", "DATA_ID = \"DataFiles/\"\n", "\n", "if not os.path.exists(PROJECT_ROOT_DIR):\n", " os.mkdir(PROJECT_ROOT_DIR)\n", "\n", "if not os.path.exists(FIGURE_ID):\n", " os.makedirs(FIGURE_ID)\n", "\n", "if not os.path.exists(DATA_ID):\n", " os.makedirs(DATA_ID)\n", "\n", "def image_path(fig_id):\n", " return os.path.join(FIGURE_ID, fig_id)\n", "\n", "def data_path(dat_id):\n", " return os.path.join(DATA_ID, dat_id)\n", "\n", "def save_fig(fig_id):\n", " plt.savefig(image_path(fig_id) + \".png\", format='png')\n", "\n", "infile = open(data_path(\"rideclass.csv\"),'r')\n", "\n", "# Read the experimental data with Pandas\n", "from IPython.display import display\n", "ridedata = pd.read_csv(infile,names = ('Outlook','Temperature','Humidity','Wind','Ride'))\n", "ridedata = pd.DataFrame(ridedata)\n", "\n", "# Features and targets\n", "X = ridedata.loc[:, ridedata.columns != 'Ride'].values\n", "y = ridedata.loc[:, ridedata.columns == 'Ride'].values\n", "\n", "# Create the encoder.\n", "encoder = OneHotEncoder(handle_unknown=\"ignore\")\n", "# Assume for simplicity all features are categorical.\n", "encoder.fit(X) \n", "# Apply the encoder.\n", "X = encoder.transform(X)\n", "print(X)\n", "# Then do a Classification tree\n", "tree_clf = DecisionTreeClassifier(max_depth=2)\n", "tree_clf.fit(X, y)\n", "print(\"Train set accuracy with Decision Tree: {:.2f}\".format(tree_clf.score(X,y)))\n", "#transfer to a decision tree graph\n", "export_graphviz(\n", " tree_clf,\n", " out_file=\"DataFiles/ride.dot\",\n", " rounded=True,\n", " filled=True\n", ")\n", "cmd = 'dot -Tpng DataFiles/cancer.dot -o DataFiles/cancer.png'\n", "os.system(cmd)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The above functions (gini, entropy and misclassification error) are\n", "important components of the so-called CART algorithm. We will discuss\n", "this algorithm below after we have discussed the information gain\n", "algorithm ID3.\n", "\n", "In the example here we have converted all our attributes into numerical values $0,1,2$ etc." ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false, "editable": true }, "outputs": [], "source": [ "# Split a dataset based on an attribute and an attribute value\n", "def test_split(index, value, dataset):\n", "\tleft, right = list(), list()\n", "\tfor row in dataset:\n", "\t\tif row[index] < value:\n", "\t\t\tleft.append(row)\n", "\t\telse:\n", "\t\t\tright.append(row)\n", "\treturn left, right\n", " \n", "# Calculate the Gini index for a split dataset\n", "def gini_index(groups, classes):\n", "\t# count all samples at split point\n", "\tn_instances = float(sum([len(group) for group in groups]))\n", "\t# sum weighted Gini index for each group\n", "\tgini = 0.0\n", "\tfor group in groups:\n", "\t\tsize = float(len(group))\n", "\t\t# avoid divide by zero\n", "\t\tif size == 0:\n", "\t\t\tcontinue\n", "\t\tscore = 0.0\n", "\t\t# score the group based on the score for each class\n", "\t\tfor class_val in classes:\n", "\t\t\tp = [row[-1] for row in group].count(class_val) / size\n", "\t\t\tscore += p * p\n", "\t\t# weight the group score by its relative size\n", "\t\tgini += (1.0 - score) * (size / n_instances)\n", "\treturn gini\n", "\n", "# Select the best split point for a dataset\n", "def get_split(dataset):\n", "\tclass_values = list(set(row[-1] for row in dataset))\n", "\tb_index, b_value, b_score, b_groups = 999, 999, 999, None\n", "\tfor index in range(len(dataset[0])-1):\n", "\t\tfor row in dataset:\n", "\t\t\tgroups = test_split(index, row[index], dataset)\n", "\t\t\tgini = gini_index(groups, class_values)\n", "\t\t\tprint('X%d < %.3f Gini=%.3f' % ((index+1), row[index], gini))\n", "\t\t\tif gini < b_score:\n", "\t\t\t\tb_index, b_value, b_score, b_groups = index, row[index], gini, groups\n", "\treturn {'index':b_index, 'value':b_value, 'groups':b_groups}\n", " \n", "dataset = [[0,0,0,0,0],\n", " [0,0,0,1,1],\n", " [1,0,0,0,1],\n", " [2,1,0,0,1],\n", " [2,2,1,0,1],\n", " [2,2,1,1,0],\n", " [1,2,1,1,1],\n", " [0,1,0,0,0],\n", " [0,2,1,0,1],\n", " [2,1,1,0,1],\n", " [0,1,1,1,1],\n", " [1,1,0,1,1],\n", " [1,0,1,0,1],\n", " [2,1,0,1,0]]\n", "\n", "split = get_split(dataset)\n", "print('Split: [X%d < %.3f]' % ((split['index']+1), split['value']))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Entropy and the ID3 algorithm\n", "\n", "The ID3 algorithm learns decision trees by constructing\n", "them in a top down way, beginning with the question **which attribute should be tested at the root of the tree**?\n", "\n", "1. Each instance attribute is evaluated using a statistical test to determine how well it alone classifies the training examples.\n", "\n", "2. The best attribute is selected and used as the test at the root node of the tree.\n", "\n", "3. A descendant of the root node is then created for each possible value of this attribute.\n", "\n", "4. Training examples are sorted to the appropriate descendant node.\n", "\n", "5. The entire process is then repeated using the training examples associated with each descendant node to select the best attribute to test at that point in the tree.\n", "\n", "6. This forms a greedy search for an acceptable decision tree, in which the algorithm never backtracks to reconsider earlier choices. \n", "\n", "The ID3 algorithm selects which attribute to test at each node in the\n", "tree.\n", "\n", "We would like to select the attribute that is most useful for classifying\n", "examples.\n", "\n", "What is a good quantitative measure of the worth of an attribute?\n", "\n", "Information gain measures how well a given attribute separates the\n", "training examples according to their target classification.\n", "\n", "The ID3 algorithm uses this information gain measure to select among the candidate\n", "attributes at each step while growing the tree.\n", "\n", "\n", "### Cancer Data again now with Decision Trees and other Methods" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false, "editable": true }, "outputs": [], "source": [ "import matplotlib.pyplot as plt\n", "import numpy as np\n", "from sklearn.model_selection import train_test_split \n", "from sklearn.datasets import load_breast_cancer\n", "from sklearn.svm import SVC\n", "from sklearn.linear_model import LogisticRegression\n", "from sklearn.tree import DecisionTreeClassifier\n", "\n", "# Load the data\n", "cancer = load_breast_cancer()\n", "\n", "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", "print(X_train.shape)\n", "print(X_test.shape)\n", "# Logistic Regression\n", "logreg = LogisticRegression(solver='lbfgs')\n", "logreg.fit(X_train, y_train)\n", "print(\"Test set accuracy with Logistic Regression: {:.2f}\".format(logreg.score(X_test,y_test)))\n", "# Support vector machine\n", "svm = SVC(gamma='auto', C=100)\n", "svm.fit(X_train, y_train)\n", "print(\"Test set accuracy with SVM: {:.2f}\".format(svm.score(X_test,y_test)))\n", "# Decision Trees\n", "deep_tree_clf = DecisionTreeClassifier(max_depth=None)\n", "deep_tree_clf.fit(X_train, y_train)\n", "print(\"Test set accuracy with Decision Trees: {:.2f}\".format(deep_tree_clf.score(X_test,y_test)))\n", "#now scale the data\n", "from sklearn.preprocessing import StandardScaler\n", "scaler = StandardScaler()\n", "scaler.fit(X_train)\n", "X_train_scaled = scaler.transform(X_train)\n", "X_test_scaled = scaler.transform(X_test)\n", "# Logistic Regression\n", "logreg.fit(X_train_scaled, y_train)\n", "print(\"Test set accuracy Logistic Regression with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", "# Support Vector Machine\n", "svm.fit(X_train_scaled, y_train)\n", "print(\"Test set accuracy SVM with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", "# Decision Trees\n", "deep_tree_clf.fit(X_train_scaled, y_train)\n", "print(\"Test set accuracy with Decision Trees and scaled data: {:.2f}\".format(deep_tree_clf.score(X_test_scaled,y_test)))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Another example, the moons again" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false, "editable": true }, "outputs": [], "source": [ "from __future__ import division, print_function, unicode_literals\n", "\n", "# Common imports\n", "import numpy as np\n", "import os\n", "\n", "# to make this notebook's output stable across runs\n", "np.random.seed(42)\n", "\n", "# To plot pretty figures\n", "import matplotlib\n", "import matplotlib.pyplot as plt\n", "from matplotlib.colors import ListedColormap\n", "plt.rcParams['axes.labelsize'] = 14\n", "plt.rcParams['xtick.labelsize'] = 12\n", "plt.rcParams['ytick.labelsize'] = 12\n", "\n", "\n", "from sklearn.svm import SVC\n", "from sklearn import datasets\n", "from sklearn.tree import DecisionTreeClassifier\n", "from sklearn.datasets import make_moons\n", "from sklearn.tree import export_graphviz\n", "\n", "Xm, ym = make_moons(n_samples=100, noise=0.25, random_state=53)\n", "\n", "deep_tree_clf1 = DecisionTreeClassifier(random_state=42)\n", "deep_tree_clf2 = DecisionTreeClassifier(min_samples_leaf=4, random_state=42)\n", "deep_tree_clf1.fit(Xm, ym)\n", "deep_tree_clf2.fit(Xm, ym)\n", "\n", "\n", "def plot_decision_boundary(clf, X, y, axes=[0, 7.5, 0, 3], iris=True, legend=False, plot_training=True):\n", " x1s = np.linspace(axes[0], axes[1], 100)\n", " x2s = np.linspace(axes[2], axes[3], 100)\n", " x1, x2 = np.meshgrid(x1s, x2s)\n", " X_new = np.c_[x1.ravel(), x2.ravel()]\n", " y_pred = clf.predict(X_new).reshape(x1.shape)\n", " custom_cmap = ListedColormap(['#fafab0','#9898ff','#a0faa0'])\n", " plt.contourf(x1, x2, y_pred, alpha=0.3, cmap=custom_cmap)\n", " if not iris:\n", " custom_cmap2 = ListedColormap(['#7d7d58','#4c4c7f','#507d50'])\n", " plt.contour(x1, x2, y_pred, cmap=custom_cmap2, alpha=0.8)\n", " if plot_training:\n", " plt.plot(X[:, 0][y==0], X[:, 1][y==0], \"yo\", label=\"Iris-Setosa\")\n", " plt.plot(X[:, 0][y==1], X[:, 1][y==1], \"bs\", label=\"Iris-Versicolor\")\n", " plt.plot(X[:, 0][y==2], X[:, 1][y==2], \"g^\", label=\"Iris-Virginica\")\n", " plt.axis(axes)\n", " if iris:\n", " plt.xlabel(\"Petal length\", fontsize=14)\n", " plt.ylabel(\"Petal width\", fontsize=14)\n", " else:\n", " plt.xlabel(r\"$x_1$\", fontsize=18)\n", " plt.ylabel(r\"$x_2$\", fontsize=18, rotation=0)\n", " if legend:\n", " plt.legend(loc=\"lower right\", fontsize=14)\n", "plt.figure(figsize=(11, 4))\n", "plt.subplot(121)\n", "plot_decision_boundary(deep_tree_clf1, Xm, ym, axes=[-1.5, 2.5, -1, 1.5], iris=False)\n", "plt.title(\"No restrictions\", fontsize=16)\n", "plt.subplot(122)\n", "plot_decision_boundary(deep_tree_clf2, Xm, ym, axes=[-1.5, 2.5, -1, 1.5], iris=False)\n", "plt.title(\"min_samples_leaf = {}\".format(deep_tree_clf2.min_samples_leaf), fontsize=14)\n", "plt.show()" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false, "editable": true }, "outputs": [], "source": [ "np.random.seed(6)\n", "Xs = np.random.rand(100, 2) - 0.5\n", "ys = (Xs[:, 0] > 0).astype(np.float32) * 2\n", "\n", "angle = np.pi/4\n", "rotation_matrix = np.array([[np.cos(angle), -np.sin(angle)], [np.sin(angle), np.cos(angle)]])\n", "Xsr = Xs.dot(rotation_matrix)\n", "\n", "tree_clf_s = DecisionTreeClassifier(random_state=42)\n", "tree_clf_s.fit(Xs, ys)\n", "tree_clf_sr = DecisionTreeClassifier(random_state=42)\n", "tree_clf_sr.fit(Xsr, ys)\n", "\n", "plt.figure(figsize=(11, 4))\n", "plt.subplot(121)\n", "plot_decision_boundary(tree_clf_s, Xs, ys, axes=[-0.7, 0.7, -0.7, 0.7], iris=False)\n", "plt.subplot(122)\n", "plot_decision_boundary(tree_clf_sr, Xsr, ys, axes=[-0.7, 0.7, -0.7, 0.7], iris=False)\n", "\n", "plt.show()" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false, "editable": true }, "outputs": [], "source": [ "# Quadratic training set + noise\n", "np.random.seed(42)\n", "m = 200\n", "X = np.random.rand(m, 1)\n", "y = 4 * (X - 0.5) ** 2\n", "y = y + np.random.randn(m, 1) / 10" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false, "editable": true }, "outputs": [], "source": [ "from sklearn.tree import DecisionTreeRegressor\n", "\n", "tree_reg = DecisionTreeRegressor(max_depth=2, random_state=42)\n", "tree_reg.fit(X, y)" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false, "editable": true }, "outputs": [], "source": [ "from sklearn.tree import DecisionTreeRegressor\n", "\n", "tree_reg1 = DecisionTreeRegressor(random_state=42, max_depth=2)\n", "tree_reg2 = DecisionTreeRegressor(random_state=42, max_depth=3)\n", "tree_reg1.fit(X, y)\n", "tree_reg2.fit(X, y)\n", "\n", "def plot_regression_predictions(tree_reg, X, y, axes=[0, 1, -0.2, 1], ylabel=\"$y$\"):\n", " x1 = np.linspace(axes[0], axes[1], 500).reshape(-1, 1)\n", " y_pred = tree_reg.predict(x1)\n", " plt.axis(axes)\n", " plt.xlabel(\"$x_1$\", fontsize=18)\n", " if ylabel:\n", " plt.ylabel(ylabel, fontsize=18, rotation=0)\n", " plt.plot(X, y, \"b.\")\n", " plt.plot(x1, y_pred, \"r.-\", linewidth=2, label=r\"$\\hat{y}$\")\n", "\n", "plt.figure(figsize=(11, 4))\n", "plt.subplot(121)\n", "plot_regression_predictions(tree_reg1, X, y)\n", "for split, style in ((0.1973, \"k-\"), (0.0917, \"k--\"), (0.7718, \"k--\")):\n", " plt.plot([split, split], [-0.2, 1], style, linewidth=2)\n", "plt.text(0.21, 0.65, \"Depth=0\", fontsize=15)\n", "plt.text(0.01, 0.2, \"Depth=1\", fontsize=13)\n", "plt.text(0.65, 0.8, \"Depth=1\", fontsize=13)\n", "plt.legend(loc=\"upper center\", fontsize=18)\n", "plt.title(\"max_depth=2\", fontsize=14)\n", "\n", "plt.subplot(122)\n", "plot_regression_predictions(tree_reg2, X, y, ylabel=None)\n", "for split, style in ((0.1973, \"k-\"), (0.0917, \"k--\"), (0.7718, \"k--\")):\n", " plt.plot([split, split], [-0.2, 1], style, linewidth=2)\n", "for split in (0.0458, 0.1298, 0.2873, 0.9040):\n", " plt.plot([split, split], [-0.2, 1], \"k:\", linewidth=1)\n", "plt.text(0.3, 0.5, \"Depth=2\", fontsize=13)\n", "plt.title(\"max_depth=3\", fontsize=14)\n", "\n", "plt.show()" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false, "editable": true }, "outputs": [], "source": [ "tree_reg1 = DecisionTreeRegressor(random_state=42)\n", "tree_reg2 = DecisionTreeRegressor(random_state=42, min_samples_leaf=10)\n", "tree_reg1.fit(X, y)\n", "tree_reg2.fit(X, y)\n", "\n", "x1 = np.linspace(0, 1, 500).reshape(-1, 1)\n", "y_pred1 = tree_reg1.predict(x1)\n", "y_pred2 = tree_reg2.predict(x1)\n", "\n", "plt.figure(figsize=(11, 4))\n", "\n", "plt.subplot(121)\n", "plt.plot(X, y, \"b.\")\n", "plt.plot(x1, y_pred1, \"r.-\", linewidth=2, label=r\"$\\hat{y}$\")\n", "plt.axis([0, 1, -0.2, 1.1])\n", "plt.xlabel(\"$x_1$\", fontsize=18)\n", "plt.ylabel(\"$y$\", fontsize=18, rotation=0)\n", "plt.legend(loc=\"upper center\", fontsize=18)\n", "plt.title(\"No restrictions\", fontsize=14)\n", "\n", "plt.subplot(122)\n", "plt.plot(X, y, \"b.\")\n", "plt.plot(x1, y_pred2, \"r.-\", linewidth=2, label=r\"$\\hat{y}$\")\n", "plt.axis([0, 1, -0.2, 1.1])\n", "plt.xlabel(\"$x_1$\", fontsize=18)\n", "plt.title(\"min_samples_leaf={}\".format(tree_reg2.min_samples_leaf), fontsize=14)\n", "\n", "plt.show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Pros and cons of trees, pros\n", "\n", "* White box, easy to interpret model. Some people believe that decision trees more closely mirror human decision-making than do the regression and classification approaches discussed earlier (think of support vector machines)\n", "\n", "* Trees are very easy to explain to people. In fact, they are even easier to explain than linear regression!\n", "\n", "* No feature normalization needed\n", "\n", "* Tree models can handle both continuous and categorical data (Classification and Regression Trees)\n", "\n", "* Can model nonlinear relationships\n", "\n", "* Can model interactions between the different descriptive features\n", "\n", "* Trees can be displayed graphically, and are easily interpreted even by a non-expert (especially if they are small)\n", "\n", "### Disadvantages\n", "\n", "* Unfortunately, trees generally do not have the same level of predictive accuracy as some of the other regression and classification approaches\n", "\n", "* If continuous features are used the tree may become quite large and hence less interpretable\n", "\n", "* Decision trees are prone to overfit the training data and hence do not well generalize the data if no stopping criteria or improvements like pruning, boosting or bagging are implemented\n", "\n", "* Small changes in the data may lead to a completely different tree. This issue can be addressed by using ensemble methods like bagging, boosting or random forests\n", "\n", "* Unbalanced datasets where some target feature values occur much more frequently than others may lead to biased trees since the frequently occurring feature values are preferred over the less frequently occurring ones. \n", "\n", "* If the number of features is relatively large (high dimensional) and the number of instances is relatively low, the tree might overfit the data\n", "\n", "* Features with many levels may be preferred over features with less levels since for them it is *more easy* to split the dataset such that the sub datasets only contain pure target feature values. This issue can be addressed by preferring for instance the information gain ratio as splitting criteria over information gain\n", "\n", "However, by aggregating many decision trees, using methods like\n", "bagging, random forests, and boosting, the predictive performance of\n", "trees can be substantially improved." ] } ], "metadata": { "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.8.5" } }, "nbformat": 4, "nbformat_minor": 4 }