From 8aa83adbdcb1544bf9916c0cc0d4de0049dd4668 Mon Sep 17 00:00:00 2001 From: mhjensen Date: Sat, 19 Dec 2020 22:47:17 +0100 Subject: [PATCH] update on book --- doc/src/DimRed/chapter8.dlog | 75 + doc/src/DimRed/chapter8.do.txt | 1264 ++++++ doc/src/DimRed/chapter8.do.txt~ | 1267 ++++++ doc/src/How2ReadData/chapter3.dlog | 22 + doc/src/How2ReadData/chapter3.do.txt | 1341 ++++++ .../How2ReadData/ipynb-chapter3-src.tar.gz | Bin 0 -> 103631 bytes .../_build/.doctrees/chapter1.doctree | Bin 101834 -> 101872 bytes .../_build/.doctrees/chapter2.doctree | Bin 311134 -> 311209 bytes .../_build/.doctrees/chapter3.doctree | Bin 264224 -> 264224 bytes .../_build/.doctrees/chapter4.doctree | Bin 856973 -> 856669 bytes .../_build/.doctrees/chapter7.doctree | Bin 0 -> 384974 bytes .../_build/.doctrees/chapter8.doctree | Bin 0 -> 479124 bytes .../_build/.doctrees/environment.pickle | Bin 333770 -> 365288 bytes .../_build/jupyter_execute/chapter2.doctree | Bin 245821 -> 245821 bytes .../.doctrees/testbook/chapter2.doctree | Bin 245752 -> 245752 bytes .../_build/html/_images/chapter2_178_0.png | Bin 5181 -> 5169 bytes .../_build/html/_images/chapter2_184_1.png | Bin 9823 -> 9817 bytes .../_build/html/_images/chapter4_278_2.png | Bin 9639 -> 9410 bytes .../_build/html/_images/chapter7_109_0.png | Bin 0 -> 5957 bytes .../_build/html/_images/chapter7_129_0.png | Bin 0 -> 8229 bytes .../_build/html/_images/chapter7_129_2.png | Bin 0 -> 13657 bytes .../_build/html/_images/chapter7_129_3.png | Bin 0 -> 23008 bytes .../_build/html/_images/chapter7_129_4.png | Bin 0 -> 28808 bytes .../_build/html/_images/chapter7_129_6.png | Bin 0 -> 53123 bytes .../_build/html/_images/chapter7_1_1.png | Bin 0 -> 28881 bytes .../_build/html/_images/chapter8_77_1.png | Bin 0 -> 26467 bytes .../_build/html/_images/chapter8_7_0.png | Bin 0 -> 64956 bytes .../_build/html/_images/chapter8_7_1.png | Bin 0 -> 104187 bytes .../_build/html/_sources/chapter7.ipynb | 1897 ++++++++ .../_build/html/_sources/chapter8.ipynb | 1923 +++++++++ .../LectureNotes/_build/html/chapter1.html | 10 + .../LectureNotes/_build/html/chapter2.html | 72 +- .../LectureNotes/_build/html/chapter3.html | 14 +- .../LectureNotes/_build/html/chapter4.html | 180 +- .../LectureNotes/_build/html/chapter5.html | 10 + .../LectureNotes/_build/html/chapter6.html | 12 + .../LectureNotes/_build/html/chapter7.html | 1503 +++++++ .../LectureNotes/_build/html/chapter8.html | 2044 +++++++++ .../LectureNotes/_build/html/genindex.html | 10 + doc/src/LectureNotes/_build/html/objects.inv | Bin 1027 -> 1075 bytes .../_build/html/reports/chapter7.log | 41 + .../_build/html/reports/chapter8.log | 29 + doc/src/LectureNotes/_build/html/search.html | 10 + .../LectureNotes/_build/html/searchindex.js | 2 +- .../_build/jupyter_execute/chapter1.html | 10 + .../_build/jupyter_execute/chapter2.html | 14 +- .../_build/jupyter_execute/chapter3.html | 10 + .../_build/jupyter_execute/chapter4.html | 10 + .../_build/jupyter_execute/chapter5.html | 10 + .../_build/jupyter_execute/chapter6.html | 10 + .../_build/jupyter_execute/chapter7.html | 10 + .../lecturenotes/lecturenotes/notebooks.html | 10 + .../_build/jupyter_execute/notebooks.html | 10 + .../_build/html/testbook/chapter1.html | 10 + .../_build/html/testbook/chapter2.html | 14 +- .../_build/html/testbook/chapter3.html | 10 + .../_build/html/testbook/chapter4.html | 10 + .../_build/html/testbook/chapter5.html | 10 + .../_build/html/testbook/chapter6.html | 10 + .../_build/html/testbook/chapter7.html | 10 + .../_build/html/testbook/content.html | 10 + .../_build/html/testbook/intro.html | 10 + .../html/testbook/lecturenotes/CONDUCT.html | 10 + .../testbook/lecturenotes/CONTRIBUTING.html | 10 + .../html/testbook/lecturenotes/README.html | 10 + .../lecturenotes/lecturenotes/content.html | 10 + .../lecturenotes/lecturenotes/intro.html | 10 + .../lecturenotes/lecturenotes/markdown.html | 10 + .../lecturenotes/lecturenotes/notebooks.html | 10 + .../_build/html/testbook/markdown.html | 10 + .../_build/jupyter_execute/chapter1.ipynb | 2 + .../_build/jupyter_execute/chapter1.txt | 2 + .../_build/jupyter_execute/chapter2.ipynb | 66 +- .../_build/jupyter_execute/chapter2_178_0.png | Bin 5181 -> 5169 bytes .../_build/jupyter_execute/chapter2_184_1.png | Bin 9823 -> 9817 bytes .../_build/jupyter_execute/chapter3.ipynb | 4 +- .../_build/jupyter_execute/chapter4.ipynb | 172 +- .../_build/jupyter_execute/chapter4_278_2.png | Bin 9639 -> 9410 bytes .../_build/jupyter_execute/chapter7.ipynb | 2052 +++++++++ .../_build/jupyter_execute/chapter7.py | 1114 +++++ .../_build/jupyter_execute/chapter7_109_0.png | Bin 0 -> 5957 bytes .../_build/jupyter_execute/chapter7_129_0.png | Bin 0 -> 8229 bytes .../_build/jupyter_execute/chapter7_129_2.png | Bin 0 -> 13657 bytes .../_build/jupyter_execute/chapter7_129_3.png | Bin 0 -> 23008 bytes .../_build/jupyter_execute/chapter7_129_4.png | Bin 0 -> 28808 bytes .../_build/jupyter_execute/chapter7_129_6.png | Bin 0 -> 53123 bytes .../_build/jupyter_execute/chapter7_1_1.png | Bin 0 -> 28881 bytes .../_build/jupyter_execute/chapter8.ipynb | 2404 +++++++++++ .../_build/jupyter_execute/chapter8.py | 1198 ++++++ .../_build/jupyter_execute/chapter8_77_1.png | Bin 0 -> 26467 bytes .../_build/jupyter_execute/chapter8_7_0.png | Bin 0 -> 64956 bytes .../_build/jupyter_execute/chapter8_7_1.png | Bin 0 -> 104187 bytes .../_build/jupyter_execute/chapter2.ipynb | 4 +- .../jupyter_execute/testbook/chapter2.ipynb | 4 +- doc/src/LectureNotes/_toc.yml | 2 + doc/src/LectureNotes/chapter7.ipynb | 1897 ++++++++ doc/src/LectureNotes/chapter8.ipynb | 1923 +++++++++ doc/src/LectureNotes/gaussian.pdf | Bin 229813 -> 229813 bytes doc/src/LogisticRegression/chapter5.dlog | 8 + doc/src/LogisticRegression/chapter5.do.txt | 366 ++ doc/src/NeuralNet/chapter6.dlog | 4 + doc/src/NeuralNet/chapter6.do.txt | 2462 +++++++++++ doc/src/NeuralNet/chapter6.do.txt~ | 2466 +++++++++++ doc/src/Regression/chapter4.dlog | 73 + doc/src/Regression/chapter4.do.txt | 3825 +++++++++++++++++ doc/src/Statistics/Statistics.dlog | 4 + doc/src/SupportVMachines/chapter7.dlog | 62 + doc/src/SupportVMachines/chapter7.do.txt | 1138 +++++ doc/src/SupportVMachines/chapter7.do.txt~ | 1143 +++++ 109 files changed, 34141 insertions(+), 248 deletions(-) create mode 100644 doc/src/DimRed/chapter8.dlog create mode 100644 doc/src/DimRed/chapter8.do.txt create mode 100644 doc/src/DimRed/chapter8.do.txt~ create mode 100644 doc/src/How2ReadData/chapter3.dlog create mode 100644 doc/src/How2ReadData/chapter3.do.txt create mode 100644 doc/src/How2ReadData/ipynb-chapter3-src.tar.gz create mode 100644 doc/src/LectureNotes/_build/.doctrees/chapter7.doctree create mode 100644 doc/src/LectureNotes/_build/.doctrees/chapter8.doctree create mode 100644 doc/src/LectureNotes/_build/html/_images/chapter7_109_0.png create mode 100644 doc/src/LectureNotes/_build/html/_images/chapter7_129_0.png create mode 100644 doc/src/LectureNotes/_build/html/_images/chapter7_129_2.png create mode 100644 doc/src/LectureNotes/_build/html/_images/chapter7_129_3.png create mode 100644 doc/src/LectureNotes/_build/html/_images/chapter7_129_4.png create mode 100644 doc/src/LectureNotes/_build/html/_images/chapter7_129_6.png create mode 100644 doc/src/LectureNotes/_build/html/_images/chapter7_1_1.png create mode 100644 doc/src/LectureNotes/_build/html/_images/chapter8_77_1.png create mode 100644 doc/src/LectureNotes/_build/html/_images/chapter8_7_0.png create mode 100644 doc/src/LectureNotes/_build/html/_images/chapter8_7_1.png create mode 100644 doc/src/LectureNotes/_build/html/_sources/chapter7.ipynb create mode 100644 doc/src/LectureNotes/_build/html/_sources/chapter8.ipynb create mode 100644 doc/src/LectureNotes/_build/html/chapter7.html create mode 100644 doc/src/LectureNotes/_build/html/chapter8.html create mode 100644 doc/src/LectureNotes/_build/html/reports/chapter7.log create mode 100644 doc/src/LectureNotes/_build/html/reports/chapter8.log create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter7.ipynb create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter7.py create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter7_109_0.png create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_0.png create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_2.png create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_3.png create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_4.png create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_6.png create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter7_1_1.png create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter8.ipynb create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter8.py create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter8_77_1.png create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter8_7_0.png create mode 100644 doc/src/LectureNotes/_build/jupyter_execute/chapter8_7_1.png create mode 100644 doc/src/LectureNotes/chapter7.ipynb create mode 100644 doc/src/LectureNotes/chapter8.ipynb create mode 100644 doc/src/LogisticRegression/chapter5.dlog create mode 100644 doc/src/LogisticRegression/chapter5.do.txt create mode 100644 doc/src/NeuralNet/chapter6.dlog create mode 100644 doc/src/NeuralNet/chapter6.do.txt create mode 100644 doc/src/NeuralNet/chapter6.do.txt~ create mode 100644 doc/src/Regression/chapter4.dlog create mode 100644 doc/src/Regression/chapter4.do.txt create mode 100644 doc/src/Statistics/Statistics.dlog create mode 100644 doc/src/SupportVMachines/chapter7.dlog create mode 100644 doc/src/SupportVMachines/chapter7.do.txt create mode 100644 doc/src/SupportVMachines/chapter7.do.txt~ diff --git a/doc/src/DimRed/chapter8.dlog b/doc/src/DimRed/chapter8.dlog new file mode 100644 index 000000000..9df8b7980 --- /dev/null +++ b/doc/src/DimRed/chapter8.dlog @@ -0,0 +1,75 @@ +*** error: file has a mako construction ${\mathbb{R}' + but seemingly no definition in <%...%>' + (it is not a command-line given mako variable either). + However, if this is a variable in a Makefile or Bash script + run with --no_mako - and you cannot use mako and Makefile or Bash variables + in the same document! + +*** error: file has a mako construction ${\mathbb{R}' + but seemingly no definition in <%...%>' + (it is not a command-line given mako variable either). + However, if this is a variable in a Makefile or Bash script + run with --no_mako - and you cannot use mako and Makefile or Bash variables + in the same document! + +translating doconce text in chapter8.do.txt to ipynb +*** replacing \bm{...} by \boldsymbol{...} (\bm is not supported by MathJax) +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +Failed to remove ans_at_end environment +Failed to remove sol_at_end environment +output in chapter8.ipynb diff --git a/doc/src/DimRed/chapter8.do.txt b/doc/src/DimRed/chapter8.do.txt new file mode 100644 index 000000000..2335493ec --- /dev/null +++ b/doc/src/DimRed/chapter8.do.txt @@ -0,0 +1,1264 @@ +======= Dimensionality Reduction ======= + + +===== Reducing the number of degrees of freedom, overarching view ===== +!bblock + +Many Machine Learning problems involve thousands or even millions of +features for each training instance. Not only does this make training +extremely slow, it can also make it much harder to find a good +solution, as we will see. This problem is often referred to as the +curse of dimensionality. Fortunately, in real-world problems, it is +often possible to reduce the number of features considerably, turning +an intractable problem into a tractable one. + +Here we will discuss some of the most popular dimensionality reduction +techniques: the principal component analysis (PCA), Kernel PCA, and +Locally Linear Embedding (LLE). Furthermore, we will start by looking +at some simple preprocessing of the data which allow us to rescale the +data. + +Principal component analysis and its various variants deal with the +problem of fitting a low-dimensional "affine +subspace":"https://en.wikipedia.org/wiki/Affine_space" to a set of of +data points in a high-dimensional space. With its family of methods it +is one of the most used tools in data modeling, compression and +visualization. + +!eblock + + + +===== Preprocessing our data ===== +!bblock + +Before we proceed however, we will discuss how to preprocess our +data. Till now and in connection with our previous examples we have +not met so many cases where we are too sensitive to the scaling of our +data. Normally the data may need a rescaling and/or may be sensitive +to extreme values. Scaling the data renders our inputs much more +suitable for the algorithms we want to employ. + +_Scikit-Learn_ has several functions which allow us to rescale the +data, normally resulting in much better results in terms of various +accuracy scores. The _StandardScaler_ function in _Scikit-Learn_ +ensures that for each feature/predictor we study the mean value is +zero and the variance is one (every column in the design/feature +matrix). This scaling has the drawback that it does not ensure that +we have a particular maximum or minimum in our data set. Another +function included in _Scikit-Learn_ is the _MinMaxScaler_ which +ensures that all features are exactly between $0$ and $1$. The + + +===== More preprocessing ===== + + +The _Normalizer_ scales each data +point such that the feature vector has a euclidean length of one. In other words, it +projects a data point on the circle (or sphere in the case of higher dimensions) with a +radius of 1. This means every data point is scaled by a different number (by the +inverse of it’s length). +This normalization is often used when only the direction (or angle) of the data matters, +not the length of the feature vector. + +The _RobustScaler_ works similarly to the StandardScaler in that it +ensures statistical properties for each feature that guarantee that +they are on the same scale. However, the RobustScaler uses the median +and quartiles, instead of mean and variance. This makes the +RobustScaler ignore data points that are very different from the rest +(like measurement errors). These odd data points are also called +outliers, and might often lead to trouble for other scaling +techniques. + +!eblock + + +===== Simple preprocessing examples, Franke function and regression ===== + +!bc pycod +# Common imports +import os +import numpy as np +import pandas as pd +import matplotlib.pyplot as plt +import sklearn.linear_model as skl +from sklearn.metrics import mean_squared_error +from sklearn.model_selection import train_test_split +from sklearn.preprocessing import MinMaxScaler, StandardScaler, Normalizer +from sklearn.svm import SVR + +# Where to save the figures and data files +PROJECT_ROOT_DIR = "Results" +FIGURE_ID = "Results/FigureFiles" +DATA_ID = "DataFiles/" + +if not os.path.exists(PROJECT_ROOT_DIR): + os.mkdir(PROJECT_ROOT_DIR) + +if not os.path.exists(FIGURE_ID): + os.makedirs(FIGURE_ID) + +if not os.path.exists(DATA_ID): + os.makedirs(DATA_ID) + +def image_path(fig_id): + return os.path.join(FIGURE_ID, fig_id) + +def data_path(dat_id): + return os.path.join(DATA_ID, dat_id) + +def save_fig(fig_id): + plt.savefig(image_path(fig_id) + ".png", format='png') + + +def FrankeFunction(x,y): + term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2)) + term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1)) + term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2)) + term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2) + return term1 + term2 + term3 + term4 + + +def create_X(x, y, n ): + if len(x.shape) > 1: + x = np.ravel(x) + y = np.ravel(y) + + N = len(x) + l = int((n+1)*(n+2)/2) # Number of elements in beta + X = np.ones((N,l)) + + for i in range(1,n+1): + q = int((i)*(i+1)/2) + for k in range(i+1): + X[:,q+k] = (x**(i-k))*(y**k) + + return X + + +# Making meshgrid of datapoints and compute Franke's function +n = 5 +N = 1000 +x = np.sort(np.random.uniform(0, 1, N)) +y = np.sort(np.random.uniform(0, 1, N)) +z = FrankeFunction(x, y) +X = create_X(x, y, n=n) +# split in training and test data +X_train, X_test, y_train, y_test = train_test_split(X,z,test_size=0.2) + + +svm = SVR(gamma='auto',C=10.0) +svm.fit(X_train, y_train) + +# The mean squared error and R2 score +print("MSE before scaling: {:.2f}".format(mean_squared_error(svm.predict(X_test), y_test))) +print("R2 score before scaling {:.2f}".format(svm.score(X_test,y_test))) + +scaler = StandardScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) + +print("Feature min values before scaling:\n {}".format(X_train.min(axis=0))) +print("Feature max values before scaling:\n {}".format(X_train.max(axis=0))) + +print("Feature min values after scaling:\n {}".format(X_train_scaled.min(axis=0))) +print("Feature max values after scaling:\n {}".format(X_train_scaled.max(axis=0))) + +svm = SVR(gamma='auto',C=10.0) +svm.fit(X_train_scaled, y_train) + +print("MSE after scaling: {:.2f}".format(mean_squared_error(svm.predict(X_test_scaled), y_test))) +print("R2 score for scaled data: {:.2f}".format(svm.score(X_test_scaled,y_test))) + +!ec + + + + +===== Simple preprocessing examples, breast cancer data and classification, Support Vector Machines ===== + +We show here how we can use a simple regression case on the breast +cancer data using support vector machines (SVM) as algorithm for +classification. + + +!bc pycod +import matplotlib.pyplot as plt +import numpy as np +from sklearn.model_selection import train_test_split +from sklearn.datasets import load_breast_cancer +from sklearn.svm import SVC +cancer = load_breast_cancer() + +X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) +print(X_train.shape) +print(X_test.shape) + +svm = SVC(C=100) +svm.fit(X_train, y_train) +print("Test set accuracy: {:.2f}".format(svm.score(X_test,y_test))) + +from sklearn.preprocessing import MinMaxScaler, StandardScaler +scaler = MinMaxScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) + +print("Feature min values before scaling:\n {}".format(X_train.min(axis=0))) +print("Feature max values before scaling:\n {}".format(X_train.max(axis=0))) + +print("Feature min values before scaling:\n {}".format(X_train_scaled.min(axis=0))) +print("Feature max values before scaling:\n {}".format(X_train_scaled.max(axis=0))) + + +svm.fit(X_train_scaled, y_train) +print("Test set accuracy scaled data with Min-Max scaling: {:.2f}".format(svm.score(X_test_scaled,y_test))) + +scaler = StandardScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) + +svm.fit(X_train_scaled, y_train) +print("Test set accuracy scaled data with Standar Scaler: {:.2f}".format(svm.score(X_test_scaled,y_test))) + +!ec + + +===== More on Cancer Data, now with Logistic Regression ===== + + +!bc pycod +import matplotlib.pyplot as plt +import numpy as np +from sklearn.model_selection import train_test_split +from sklearn.datasets import load_breast_cancer +from sklearn.linear_model import LogisticRegression +cancer = load_breast_cancer() + +# Set up training data +X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) +logreg = LogisticRegression() +logreg.fit(X_train, y_train) +print("Test set accuracy: {:.2f}".format(logreg.score(X_test,y_test))) + +# Scale data +from sklearn.preprocessing import StandardScaler +scaler = StandardScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) +logreg.fit(X_train_scaled, y_train) +print("Test set accuracy scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test))) + +!ec + + + + + +===== Why should we think of reducing the dimensionality ===== + +In addition to the plot of the features, we study now also the covariance (and the correlation matrix). +We use also _Pandas_ to compute the correlation matrix. +!bc pycod +import matplotlib.pyplot as plt +import numpy as np +from sklearn.model_selection import train_test_split +from sklearn.datasets import load_breast_cancer +from sklearn.linear_model import LogisticRegression +cancer = load_breast_cancer() +import pandas as pd +# Making a data frame +cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names) + +fig, axes = plt.subplots(15,2,figsize=(10,20)) +malignant = cancer.data[cancer.target == 0] +benign = cancer.data[cancer.target == 1] +ax = axes.ravel() + +for i in range(30): + _, bins = np.histogram(cancer.data[:,i], bins =50) + ax[i].hist(malignant[:,i], bins = bins, alpha = 0.5) + ax[i].hist(benign[:,i], bins = bins, alpha = 0.5) + ax[i].set_title(cancer.feature_names[i]) + ax[i].set_yticks(()) +ax[0].set_xlabel("Feature magnitude") +ax[0].set_ylabel("Frequency") +ax[0].legend(["Malignant", "Benign"], loc ="best") +fig.tight_layout() +plt.show() + +import seaborn as sns +correlation_matrix = cancerpd.corr().round(1) +# use the heatmap function from seaborn to plot the correlation matrix +# annot = True to print the values inside the square +sns.heatmap(data=correlation_matrix, annot=True) +plt.show() + +#print eigvalues of correlation matrix +EigValues, EigVectors = np.linalg.eig(correlation_matrix) +print(EigValues) +!ec + +In the above example we note two things. In the first plot we display +the overlap of benign and malignant tumors as functions of the various +features in the Wisconsing breast cancer data set. We see that for +some of the features we can distinguish clearly the benign and +malignant cases while for other features we cannot. This can point to +us which features may be of greater interest when we wish to classify +a benign or not benign tumour. + +In the second figure we have computed the so-called correlation +matrix, which in our case with thirty features becomes a $30\times 30$ +matrix. + +We constructed this matrix using _pandas_ via the statements +!bc pycod +cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names) +!ec +and then +!bc pycod +correlation_matrix = cancerpd.corr().round(1) +!ec + +Diagonalizing this matrix we can in turn say something about which +features are of relevance and which are not. But before we proceed we +need to define covariance and correlation matrices. This leads us to +the classical Principal Component Analysis (PCA) theorem with +applications. + + + + +===== Basic ideas of the Principal Component Analysis (PCA) ===== + +The principal component analysis deals with the problem of fitting a +low-dimensional affine subspace $S$ of dimension $d$ much smaller than +the totaldimension $D$ of the problem at hand (our data +set). Mathematically it can be formulated as a statistical problem or +a geometric problem. In our discussion of the theorem for the +classical PCA, we will stay with a statistical approach. This is also +what set the scene historically which for the PCA. + +We have a data set defined by a design/feature matrix $\bm{X}$ (see below for its definition) +* Each data point is determined by $p$ extrinsic (measurement) variables +* We may want to ask the following question: Are there fewer intrinsic variables (say $d << p$) that still approximately describe the data? +* If so, these intrinsic variables may tell us something important and finding these intrinsic variables is what dimension reduction methods do. + + + +===== Introducing the Covariance and Correlation functions ===== + +Before we discuss the PCA theorem, we need to remind ourselves about +the definition of the covariance and the correlation function. These are quantities + +Suppose we have defined two vectors +$\hat{x}$ and $\hat{y}$ with $n$ elements each. The covariance matrix $\bm{C}$ is defined as +!bt +\[ +\bm{C}[\bm{x},\bm{y}] = \begin{bmatrix} \mathrm{cov}[\bm{x},\bm{x}] & \mathrm{cov}[\bm{x},\bm{y}] \\ + \mathrm{cov}[\bm{y},\bm{x}] & \mathrm{cov}[\bm{y},\bm{y}] \\ + \end{bmatrix}, +\] +!et +where for example +!bt +\[ +\mathrm{cov}[\bm{x},\bm{y}] =\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})(y_i- \overline{y}). +\] +!et +With this definition and recalling that the variance is defined as +!bt +\[ +\mathrm{var}[\bm{x}]=\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})^2, +\] +!et +we can rewrite the covariance matrix as +!bt +\[ +\bm{C}[\bm{x},\bm{y}] = \begin{bmatrix} \mathrm{var}[\bm{x}] & \mathrm{cov}[\bm{x},\bm{y}] \\ + \mathrm{cov}[\bm{x},\bm{y}] & \mathrm{var}[\bm{y}] \\ + \end{bmatrix}. +\] +!et + +The covariance takes values between zero and infinity and may thus +lead to problems with loss of numerical precision for particularly +large values. It is common to scale the covariance matrix by +introducing instead the correlation matrix defined via the so-called +correlation function + +!bt +\[ +\mathrm{corr}[\bm{x},\bm{y}]=\frac{\mathrm{cov}[\bm{x},\bm{y}]}{\sqrt{\mathrm{var}[\bm{x}] \mathrm{var}[\bm{y}]}}. +\] +!et + +The correlation function is then given by values $\mathrm{corr}[\bm{x},\bm{y}] +\in [-1,1]$. This avoids eventual problems with too large values. We +can then define the correlation matrix for the two vectors $\bm{x}$ +and $\bm{y}$ as + +!bt +\[ +\bm{K}[\bm{x},\bm{y}] = \begin{bmatrix} 1 & \mathrm{corr}[\bm{x},\bm{y}] \\ + \mathrm{corr}[\bm{y},\bm{x}] & 1 \\ + \end{bmatrix}, +\] +!et + +In the above example this is the function we constructed using _pandas_. + + +===== Correlation Function and Design/Feature Matrix ===== + +In our derivation of the various regression algorithms like _Ordinary Least Squares_ or _Ridge regression_ +we defined the design/feature matrix $\bm{X}$ as + +!bt +\[ +\bm{X}=\begin{bmatrix} +x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ +x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ +x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ +\dots & \dots & \dots & \dots \dots & \dots \\ +x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ +x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ +\end{bmatrix}, +\] +!et +with $\bm{X}\in {\mathbb{R}}^{n\times p}$, with the predictors/features $p$ refering to the column numbers and the +entries $n$ being the row elements. +We can rewrite the design/feature matrix in terms of its column vectors as +!bt +\[ +\bm{X}=\begin{bmatrix} \bm{x}_0 & \bm{x}_1 & \bm{x}_2 & \dots & \dots & \bm{x}_{p-1}\end{bmatrix}, +\] +!et +with a given vector +!bt +\[ +\bm{x}_i^T = \begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \dots & \dots x_{n-1,i}\end{bmatrix}. +\] +!et + +With these definitions, we can now rewrite our $2\times 2$ +correaltion/covariance matrix in terms of a moe general design/feature +matrix $\bm{X}\in {\mathbb{R}}^{n\times p}$. This leads to a $p\times p$ +covariance matrix for the vectors $\bm{x}_i$ with $i=0,1,\dots,p-1$ + +!bt +\[ +\bm{C}[\bm{x}] = \begin{bmatrix} +\mathrm{var}[\bm{x}_0] & \mathrm{cov}[\bm{x}_0,\bm{x}_1] & \mathrm{cov}[\bm{x}_0,\bm{x}_2] & \dots & \dots & \mathrm{cov}[\bm{x}_0,\bm{x}_{p-1}]\\ +\mathrm{cov}[\bm{x}_1,\bm{x}_0] & \mathrm{var}[\bm{x}_1] & \mathrm{cov}[\bm{x}_1,\bm{x}_2] & \dots & \dots & \mathrm{cov}[\bm{x}_1,\bm{x}_{p-1}]\\ +\mathrm{cov}[\bm{x}_2,\bm{x}_0] & \mathrm{cov}[\bm{x}_2,\bm{x}_1] & \mathrm{var}[\bm{x}_2] & \dots & \dots & \mathrm{cov}[\bm{x}_2,\bm{x}_{p-1}]\\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\mathrm{cov}[\bm{x}_{p-1},\bm{x}_0] & \mathrm{cov}[\bm{x}_{p-1},\bm{x}_1] & \mathrm{cov}[\bm{x}_{p-1},\bm{x}_{2}] & \dots & \dots & \mathrm{var}[\bm{x}_{p-1}]\\ +\end{bmatrix}, +\] +!et +and the correlation matrix +!bt +\[ +\bm{K}[\bm{x}] = \begin{bmatrix} +1 & \mathrm{corr}[\bm{x}_0,\bm{x}_1] & \mathrm{corr}[\bm{x}_0,\bm{x}_2] & \dots & \dots & \mathrm{corr}[\bm{x}_0,\bm{x}_{p-1}]\\ +\mathrm{corr}[\bm{x}_1,\bm{x}_0] & 1 & \mathrm{corr}[\bm{x}_1,\bm{x}_2] & \dots & \dots & \mathrm{corr}[\bm{x}_1,\bm{x}_{p-1}]\\ +\mathrm{corr}[\bm{x}_2,\bm{x}_0] & \mathrm{corr}[\bm{x}_2,\bm{x}_1] & 1 & \dots & \dots & \mathrm{corr}[\bm{x}_2,\bm{x}_{p-1}]\\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\mathrm{corr}[\bm{x}_{p-1},\bm{x}_0] & \mathrm{corr}[\bm{x}_{p-1},\bm{x}_1] & \mathrm{corr}[\bm{x}_{p-1},\bm{x}_{2}] & \dots & \dots & 1\\ +\end{bmatrix}, +\] +!et + + + +===== Covariance Matrix Examples ===== + + +The Numpy function _np.cov_ calculates the covariance elements using +the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have +the exact mean values. The following simple function uses the +_np.vstack_ function which takes each vector of dimension $1\times n$ +and produces a $2\times n$ matrix $\bm{W}$ + + +!bt +\[ +\bm{W} = \begin{bmatrix} x_0 & y_0 \\ + x_1 & y_1 \\ + x_2 & y_2\\ + \dots & \dots \\ + x_{n-2} & y_{n-2}\\ + x_{n-1} & y_{n-1} & + \end{bmatrix}, +\] +!et + +which in turn is converted into into the $2\times 2$ covariance matrix +$\bm{C}$ via the Numpy function _np.cov()_. We note that we can also calculate +the mean value of each set of samples $\bm{x}$ etc using the Numpy +function _np.mean(x)_. We can also extract the eigenvalues of the +covariance matrix through the _np.linalg.eig()_ function. + +!bc pycod +# Importing various packages +import numpy as np +n = 100 +x = np.random.normal(size=n) +print(np.mean(x)) +y = 4+3*x+np.random.normal(size=n) +print(np.mean(y)) +W = np.vstack((x, y)) +C = np.cov(W) +print(C) +!ec + + +===== Correlation Matrix ===== + +The previous example can be converted into the correlation matrix by +simply scaling the matrix elements with the variances. We should also +subtract the mean values for each column. This leads to the following +code which sets up the correlations matrix for the previous example in +a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the $2\times 2$ correlation matrix (since we have only two vectors). + +!bc pycod +import numpy as np +n = 100 +# define two vectors +x = np.random.random(size=n) +y = 4+3*x+np.random.normal(size=n) +#scaling the x and y vectors +x = x - np.mean(x) +y = y - np.mean(y) +variance_x = np.sum(x@x)/n +variance_y = np.sum(y@y)/n +print(variance_x) +print(variance_y) +cov_xy = np.sum(x@y)/n +cov_xx = np.sum(x@x)/n +cov_yy = np.sum(y@y)/n +C = np.zeros((2,2)) +C[0,0]= cov_xx/variance_x +C[1,1]= cov_yy/variance_y +C[0,1]= cov_xy/np.sqrt(variance_y*variance_x) +C[1,0]= C[0,1] +print(C) +!ec + +We see that the matrix elements along the diagonal are one as they +should be and that the matrix is symmetric. Furthermore, diagonalizing +this matrix we easily see that it is a positive definite matrix. + +The above procedure with _numpy_ can be made more compact if we use _pandas_. + + +===== Correlation Matrix with Pandas ===== + +We whow here how we can set up the correlation matrix using _pandas_, as done in this simple code +!bc pycod +import numpy as np +import pandas as pd +n = 10 +x = np.random.normal(size=n) +x = x - np.mean(x) +y = 4+3*x+np.random.normal(size=n) +y = y - np.mean(y) +X = (np.vstack((x, y))).T +print(X) +Xpd = pd.DataFrame(X) +print(Xpd) +correlation_matrix = Xpd.corr() +print(correlation_matrix) +!ec + + +We expand this model to the Franke function discussed above. + + +===== Correlation Matrix with Pandas and the Franke function ===== + +!bc pycod +# Common imports +import numpy as np +import pandas as pd + + +def FrankeFunction(x,y): + term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2)) + term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1)) + term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2)) + term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2) + return term1 + term2 + term3 + term4 + + +def create_X(x, y, n ): + if len(x.shape) > 1: + x = np.ravel(x) + y = np.ravel(y) + + N = len(x) + l = int((n+1)*(n+2)/2) # Number of elements in beta + X = np.ones((N,l)) + + for i in range(1,n+1): + q = int((i)*(i+1)/2) + for k in range(i+1): + X[:,q+k] = (x**(i-k))*(y**k) + + return X + + +# Making meshgrid of datapoints and compute Franke's function +n = 4 +N = 100 +x = np.sort(np.random.uniform(0, 1, N)) +y = np.sort(np.random.uniform(0, 1, N)) +z = FrankeFunction(x, y) +X = create_X(x, y, n=n) + +Xpd = pd.DataFrame(X) +# subtract the mean values and set up the covariance matrix +Xpd = Xpd - Xpd.mean() +covariance_matrix = Xpd.cov() +print(covariance_matrix) +!ec + +We note here that the covariance is zero for the first rows and +columns since all matrix elements in the design matrix were set to one +(we are fitting the function in terms of a polynomial of degree $n$). + +This means that the variance for these elements will be zero and will +cause problems when we set up the correlation matrix. We can simply +drop these elements and construct a correlation +matrix without these elements. + + + +===== Rewriting the Covariance and/or Correlation Matrix ===== + +We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix $\bm{X}$ as +!bt +\[ +\bm{C}[\bm{x}] = \frac{1}{n}\bm{X}\bm{X}^T= \mathbb{E}[\bm{X}\bm{X}^T]. +\] +!et + +To see this let us simply look at a design matrix $\bm{X}\in {\mathbb{R}}^{2\times 2}$ +!bt +\[ +\bm{X}=\begin{bmatrix} +x_{00} & x_{01}\\ +x_{10} & x_{11}\\ +\end{bmatrix}=\begin{bmatrix} +\bm{x}_{0} & \bm{x}_{1}\\ +\end{bmatrix}. +\] +!et + +If we then compute the expectation value +!bt +\[ +\mathbb{E}[\bm{X}\bm{X}^T] = \frac{1}{n}\bm{X}\bm{X}^T=\begin{bmatrix} +x_{00}^2+x_{01}^2 & x_{00}x_{10}+x_{01}x_{11}\\ +x_{10}x_{00}+x_{11}x_{01} & x_{10}^2+x_{11}^2\\ +\end{bmatrix}, +\] +!et +which is just +!bt +\[ +\bm{C}[\bm{x}_0,\bm{x}_1] = \bm{C}[\bm{x}]=\begin{bmatrix} \mathrm{var}[\bm{x}_0] & \mathrm{cov}[\bm{x}_0,\bm{x}_1] \\ + \mathrm{cov}[\bm{x}_1,\bm{x}_0] & \mathrm{var}[\bm{x}_1] \\ + \end{bmatrix}, +\] +!et +where we wrote $$\bm{C}[\bm{x}_0,\bm{x}_1] = \bm{C}[\bm{x}]$$ to indicate that this the covariance of the vectors $\bm{x}$ of the design/feature matrix $\bm{X}$. + +It is easy to generalize this to a matrix $\bm{X}\in {\mathbb{R}}^{n\times p}$. + + + +===== Towards the PCA theorem ===== + +We have that the covariance matrix (the correlation matrix involves a simple rescaling) is given as +!bt +\[ +\bm{C}[\bm{x}] = \frac{1}{n}\bm{X}\bm{X}^T= \mathbb{E}[\bm{X}\bm{X}^T]. +\] +!et +Let us now assume that we can perform a series of orthogonal transformations where we employ some orthogonal matrices $\bm{S}$. +These matrices are defined as $\bm{S}\in {\mathbb{R}}^{p\times p}$ and obey the orthogonality requirements $\bm{S}\bm{S}^T=\bm{S}^T\bm{S}=\bm{I}$. The matrix can be written out in terms of the column vectors $\bm{s}_i$ as $\bm{S}=[\bm{s}_0,\bm{s}_1,\dots,\bm{s}_{p-1}]$ and $\bm{s}_i \in {\mathbb{R}}^{p}$. + +Assume also that there is a transformation $\bm{S}\bm{C}[\bm{x}]\bm{S}^T=\bm{C}[\bm{y}]$ such that the new matrix $\bm{C}[\bm{y}]$ is diagonal with elements $[\lambda_0,\lambda_1,\lambda_2,\dots,\lambda_{p-1}]$. + +That is we have +!bt +\[ +\bm{C}[\bm{y}] = \mathbb{E}[\bm{S}\bm{X}\bm{X}^T\bm{S}^T]=\bm{S}\bm{C}[\bm{x}]\bm{S}^T, +\] +!et +since the matrix $\bm{S}$ is not a data dependent matrix. Multiplying with $\bm{S}^T$ from the left we have +!bt +\[ +\bm{S}^T\bm{C}[\bm{y}] = \bm{C}[\bm{x}]\bm{S}^T, +\] +!et +and since $\bm{C}[\bm{y}]$ is diagonal we have for a given eigenvalue $i$ of the covariance matrix that + +!bt +\[ +\bm{S}^T_i\lambda_i = \bm{C}[\bm{x}]\bm{S}^T_i. +\] +!et + +In the derivation of the PCA theorem we will assume that the eigenvalues are ordered in descending order, that is +$\lambda_0 > \lambda_1 > \dots > \lambda_{p-1}$. + + +The eigenvalues tell us then how much we need to stretch the +corresponding eigenvectors. Dimensions with large eigenvalues have +thus large variations (large variance) and define therefore useful +dimensions. The data points are more spread out in the direction of +these eigenvectors. Smaller eigenvalues mean on the other hand that +the corresponding eigenvectors are shrunk accordingly and the data +points are tightly bunched together and there is not much variation in +these specific directions. Hopefully then we could leave it out +dimensions where the eigenvalues are very small. If $p$ is very large, +we could then aim at reducing $p$ to $l << p$ and handle only $l$ +features/predictors. + + +===== The Algorithm before the Theorem ===== + +Here's how we would proceed in setting up the algorithm for the PCA, see also discussion below here. +* Set up the datapoints for the design/feature matrix $\bm{X}$ with $\bm{X}\in {\mathbb{R}}^{n\times p}$, with the predictors/features $p$ referring to the column numbers and the entries $n$ being the row elements. +!bt +\[ +\bm{X}=\begin{bmatrix} +x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ +x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ +x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ +\dots & \dots & \dots & \dots \dots & \dots \\ +x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ +x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ +\end{bmatrix}, +\] +!et +* Center the data by subtracting the mean value for each column. This leads to a new matrix $\bm{X}\rightarrow \overline{\bm{X}}$. +* Compute then the covariance/correlation matrix $\mathbb{E}[\overline{\bm{X}}\overline{\bm{X}}^T]$. +* Find the eigenpairs of $\bm{C}$ with eigenvalues $[\lambda_0,\lambda_1,\dots,\lambda_{p-1}]$ and eigenvectors $[\bm{s}_0,\bm{s}_1,\dots,\bm{s}_{p-1}]$. +* Order the eigenvalue (and the eigenvectors accordingly) in order of decreasing eigenvalues. +* Keep only those $l$ eigenvalues larger than a selected threshold value, discarding thus $p-l$ features since we expect small variations in the data here. + + + +===== Writing our own PCA code ===== + +We will use a simple example first with two-dimensional data +drawn from a multivariate normal distribution with the following mean and covariance matrix: +!bt +\[ +\mu = (-1,2) \qquad \Sigma = \begin{bmatrix} 4 & 2 \\ +2 & 2 +\end{bmatrix} +\] +!et +Note that the mean refers to each column of data. +We will generate $n = 1000$ points $X = \{ x_1, \ldots, x_N \}$ from +this distribution, and store them in the $1000 \times 2$ matrix $\bm{X}$. + +The following Python code aids in setting up the data and writing out the design matrix. +Note that the function _multivariate_ returns also the covariance discussed above and that it is defined by dividing by $n-1$ instead of $n$. +!bc pycod +import numpy as np +import pandas as pd +import matplotlib.pyplot as plt +from IPython.display import display +n = 10000 +mean = (-1, 2) +cov = [[4, 2], [2, 2]] +X = np.random.multivariate_normal(mean, cov, n) +!ec + +Now we are going to implement the PCA algorithm. We will break it down into various substeps. + +=== Compute the sample mean and center the data === + +The first step of PCA is to compute the sample mean of the data and use it to center the data. Recall that the sample mean is +!bt +\[ +\mu_n = \frac{1}{n} \sum_{i=1}^n x_i +\] +!et +and the mean-centered data $\bar{X} = \{ \bar{x}_1, \ldots, \bar{x}_n \}$ takes the form +!bt +\[ +\bar{x}_i = x_i - \mu_n. +\] +!et +When you are done with these steps, print out $\mu_n$ to verify it is +close to $\mu$ and plot your mean centered data to verify it is +centered at the origin! Compare your code with the functionality from _Scikit-Learn_ discussed above. +The following code elements perform these operations using _pandas_ or using our own functionality for doing so. The latter, using _numpy_ is rather simple through the _mean()_ function. +!bc pycod +df = pd.DataFrame(X) +# Pandas does the centering for us +df = df -df.mean() +# we center it ourselves +X_centered = X - X.mean(axis=0) +!ec + +Alternatively, we could use the functions we discussed +earlier for scaling the data set. That is, we could have used the +_StandardScaler_ function in _Scikit-Learn_, a function which ensures +that for each feature/predictor we study the mean value is zero and +the variance is one (every column in the design/feature matrix). You +would then not get the same results, since we divide by the +variance. The diagonal covariance matrix elements will then be one, +while the non-diagonal ones need to be divided by $2\sqrt{2}$ for our +specific case. + +=== Compute the sample covariance === + +Now we are going to use the mean centered data to compute the sample covariance of the data by using the following equation +!bt +\begin{equation*} +\Sigma_n = \frac{1}{n-1} \sum_{i=1}^n \bar{x}_i^T \bar{x}_i = \frac{1}{n-1} \sum_{i=1}^n (x_i - \mu_n)^T (x_i - \mu_n) +\end{equation*} +!et +where the data points $x_i \in \mathbb{R}^p$ (here in this example $p = 2$) are column vectors and $x^T$ is the transpose of $x$. +We can write our own code or simply use either the functionaly of _numpy_ or that of _pandas_, as follows +!bc pycod +print(df.cov()) +print(np.cov(X_centered.T)) +!ec +Note that the way we define the covariance matrix here has a factor $n-1$ instead of $n$. This is included in the _cov()_ function by _numpy_ and _pandas_. +Our own code here is not very elegant and asks for obvious improvements. It is tailored to this specific $2\times 2$ covariance matrix. +!bc pycod +# extract the relevant columns from the centered design matrix of dim n x 2 +x = X_centered[:,0] +y = X_centered[:,1] +Cov = np.zeros((2,2)) +Cov[0,1] = np.sum(x.T@y)/(n-1.0) +Cov[0,0] = np.sum(x.T@x)/(n-1.0) +Cov[1,1] = np.sum(y.T@y)/(n-1.0) +Cov[1,0]= Cov[0,1] +print("Centered covariance using own code") +print(Cov) +plt.plot(x, y, 'x') +plt.axis('equal') +plt.show() +!ec + +Depending on the number of points $n$, we will get results that are close to the covariance values defined above. +The plot shows how the data are clustered around a line with slope close to one. Is this expected? + +=== Diagonalize the sample covariance matrix to obtain the principal components === + +Now we are ready to solve for the principal components! To do so we +diagonalize the sample covariance matrix $\Sigma$. We can use the +function _np.linalg.eig_ to do so. It will return the eigenvalues and +eigenvectors of $\Sigma$. Once we have these we can perform the +following tasks: + +* We compute the percentage of the total variance captured by the first principal component +* We plot the mean centered data and lines along the first and second principal components +* Then we project the mean centered data onto the first and second principal components, and plot the projected data. +* Finally, we approximate the data as + +!bt +\begin{equation*} +x_i \approx \tilde{x}_i = \mu_n + \langle x_i, v_0 \rangle v_0 +\end{equation*} +!et +where $v_0$ is the first principal component. + +Collecting all these steps we can write our own PCA function and +compare this with the functionality included in _Scikit-Learn_. + +The code here outlines some of the elements we could include in the +analysis. Feel free to extend upon this in order to address the above +questions. + +!bc pycod +# diagonalize and obtain eigenvalues, not necessarily sorted +EigValues, EigVectors = np.linalg.eig(Cov) +# sort eigenvectors and eigenvalues +#permute = EigValues.argsort() +#EigValues = EigValues[permute] +#EigVectors = EigVectors[:,permute] +print("Eigenvalues of Covariance matrix") +for i in range(2): + print(EigValues[i]) +FirstEigvector = EigVectors[:,0] +SecondEigvector = EigVectors[:,1] +print("First eigenvector") +print(FirstEigvector) +print("Second eigenvector") +print(SecondEigvector) +#thereafter we do a PCA with Scikit-learn +from sklearn.decomposition import PCA +pca = PCA(n_components = 2) +X2Dsl = pca.fit_transform(X) +print("Eigenvector of largest eigenvalue") +print(pca.components_.T[:, 0]) + +!ec +This code does not contain all the above elements, but it shows how we can use _Scikit-Learn_ to extract the eigenvector which corresponds to the largest eigenvalue. Try to address the questions we pose before the above code. Try also to change the values of the covariance matrix by making one of the diagonal elements much larger than the other. What do you observe then? + + +===== Classical PCA Theorem ===== + +We assume now that we have a design matrix $\bm{X}$ which has been +centered as discussed above. For the sake of simplicity we skip the +overline symbol. The matrix is defined in terms of the various column +vectors $[\bm{x}_0,\bm{x}_1,\dots, \bm{x}_{p-1}]$ each with dimension +$\bm{x}\in {\mathbb{R}}^{n}$. + +We assume also that we have an orthogonal transformation $\bm{W}\in {\mathbb{R}}^{p\times p}$. We define the reconstruction error (which is similar to the mean squared error we have seen before) as +!bt +\[ +J(\bm{W},\bm{Z}) = \frac{1}{n}\sum_i (\bm{x}_i - \overline{\bm{x}}_i)^2, +\] +!et +with $\overline{\bm{x}}_i = \bm{W}\bm{z}_i$, where $\bm{z}_i$ is a row vector with dimension ${\mathbb{R}}^{n}$ of the matrix +$\bm{Z}\in{\mathbb{R}}^{p\times n}$. When doing PCA we want to reduce this dimensionality. + +The PCA theorem states that minimizing the above reconstruction error +corresponds to setting $\bm{W}=\bm{S}$, the orthogonal matrix which +diagonalizes the empirical covariance(correlation) matrix. The optimal +low-dimensional encoding of the data is then given by a set of vectors +$\bm{z}_i$ with at most $l$ vectors, with $l << p$, defined by the +orthogonal projection of the data onto the columns spanned by the +eigenvectors of the covariance(correlations matrix). + +The proof which follows will be updated by mid January 2020. + + +===== Proof of the PCA Theorem ===== + +To show the PCA theorem let us start with the assumption that there is one vector $\bm{w}_0$ which corresponds to a solution which minimized the reconstruction error $J$. This is an orthogonal vector. It means that we now approximate the reconstruction error in terms of $\bm{w}_0$ and $\bm{z}_0$ as +!bt +\[ +J(\bm{w}_0,\bm{z}_0)= \frac{1}{n}\sum_i (\bm{x}_i - z_{i0}\bm{w}_0)^2=\frac{1}{n}\sum_i (\bm{x}_i^T\bm{x}_i - 2z_{i0}\bm{w}_0^T\bm{x}_i+z_{i0}^2\bm{w}_0^T\bm{w}_0), +\] +!et +which we can rewrite due to the orthogonality of $\bm{w}_i$ as +!bt +\[ +J(\bm{w}_0,\bm{z}_0)=\frac{1}{n}\sum_i (\bm{x}_i^T\bm{x}_i - 2z_{i0}\bm{w}_0^T\bm{x}_i+z_{i0}^2). +\] +!et +Minimizing $J$ with respect to the unknown parameters $z_{0i}$ we obtain that +!bt +\[ +z_{i0}=\bm{w}_0^T\bm{x}_i, +\] +!et +where the vectors on the rhs are known. + + + +===== PCA Proof continued ===== + +We have now found the unknown parameters $z_{i0}$. These correspond to the projected coordinates and we can write +!bt +\[ +J(\bm{w}_0)= \frac{1}{p}\sum_i (\bm{x}_i^T\bm{x}_i - z_{i0}^2)=\mathrm{const}-\frac{1}{n}\sum_i z_{i0}^2. +\] +!et + +We can show that the variance of the projected coordinates defined by $\bm{w}_0^T\bm{x}_i$ are given by +!bt +\[ +\mathrm{var}[\bm{w}_0^T\bm{x}_i] = \frac{1}{n}\sum_i z_{i0}^2, +\] +!et +since the expectation value of +!bt +\[ +\mathbb{E}[\bm{w}_0^T\bm{x}_i] = \mathbb{E}[z_{i0}]= \bm{w}_0^T\mathbb{E}[\bm{x}_i]=0, +\] +!et +where we have used the fact that our data are centered. + +Recalling our definition of the covariance as +!bt +\[ +\bm{C}[\bm{x}] = \frac{1}{n}\bm{X}\bm{X}^T=\mathbb{E}[\bm{X}\bm{X}^T], +\] +!et +we have thus that +!bt +\[ +\mathrm{var}[\bm{w}_0^T\bm{x}_i] = \frac{1}{n}\sum_i z_{i0}^2=\bm{w}_0^T\bm{C}[\bm{x}]\bm{w}_0. +\] +!et + +We are almost there, we have obtained a relation between minimizing +the reconstruction error and the variance and the covariance +matrix. Minimizing the error is equivalent to maximizing the variance +of the projected data. + + +===== The final step ===== + +We could trivially maximize the variance of the projection (and +thereby minimize the error in the reconstruction function) by letting +the norm-2 of $\bm{w}_0$ go to infinity. However, this norm since we +want the matrix $\bm{W}$ to be an orthogonal matrix, is constrained by +$\vert\vert \bm{w}_0 \vert\vert_2^2=1$. Imposing this condition via a +Lagrange multiplier we can then in turn maximize + +!bt +\[ +J(\bm{w}_0)= \bm{w}_0^T\bm{C}[\bm{x}]\bm{w}_0+\lambda_0(1-\bm{w}_0^T\bm{w}_0). +\] +!et +Taking the derivative with respect to $\bm{w}_0$ we obtain + +!bt +\[ +\frac{\partial J(\bm{w}_0)}{\partial \bm{w}_0}= 2\bm{C}[\bm{x}]\bm{w}_0-2\lambda_0\bm{w}_0=0, +\] +!et +meaning that +!bt +\[ +\bm{C}[\bm{x}]\bm{w}_0=\lambda_0\bm{w}_0. +\] +!et +_The direction that maximizes the variance (or minimizes the construction error) is an eigenvector of the covariance matrix_! If we left multiply with $\bm{w}_0^T$ we have the variance of the projected data is +!bt +\[ +\bm{w}_0^T\bm{C}[\bm{x}]\bm{w}_0=\lambda_0. +\] +!et + +If we want to maximize the variance (minimize the construction error) +we simply pick the eigenvector of the covariance matrix with the +largest eigenvalue. This establishes the link between the minimization +of the reconstruction function $J$ in terms of an orthogonal matrix +and the maximization of the variance and thereby the covariance of our +observations encoded in the design/feature matrix $\bm{X}$. + +The proof +for the other eigenvectors $\bm{w}_1,\bm{w}_2,\dots$ can be +established by applying the above arguments and using the fact that +our basis of eigenvectors is orthogonal, see "Murphy chapter +12.2":"https://mitpress.mit.edu/books/machine-learning-1". The +discussion in chapter 12.2 of Murphy's text has also a nice link with +the Singular Value Decomposition theorem. For categorical data, see +chapter 12.4 and discussion therein. + +Additional part of the proof for the other eigenvectors will be added by mid January 2020. + + +===== Geometric Interpretation and link with Singular Value Decomposition ===== + +This material will be added by mid January 2020. + + + +===== Principal Component Analysis ===== + +Principal Component Analysis (PCA) is by far the most popular dimensionality reduction algorithm. +First it identifies the hyperplane that lies closest to the data, and then it projects the data onto it. + +The following Python code uses NumPy’s _svd()_ function to obtain all the principal components of the +training set, then extracts the first two principal components. First we center the data using either _pandas_ or our own code +!bc pycod +import numpy as np +import pandas as pd +from IPython.display import display +np.random.seed(100) +# setting up a 10 x 5 vanilla matrix +rows = 10 +cols = 5 +X = np.random.randn(rows,cols) +df = pd.DataFrame(X) +# Pandas does the centering for us +df = df -df.mean() +display(df) + +# we center it ourselves +X_centered = X - X.mean(axis=0) +# Then check the difference between pandas and our own set up +print(X_centered-df) +#Now we do an SVD +U, s, V = np.linalg.svd(X_centered) +c1 = V.T[:, 0] +c2 = V.T[:, 1] +W2 = V.T[:, :2] +X2D = X_centered.dot(W2) +print(X2D) +!ec + +PCA assumes that the dataset is centered around the origin. Scikit-Learn’s PCA classes take care of centering +the data for you. However, if you implement PCA yourself (as in the preceding example), or if you use other libraries, don’t +forget to center the data first. + +Once you have identified all the principal components, you can reduce the dimensionality of the dataset +down to $d$ dimensions by projecting it onto the hyperplane defined by the first $d$ principal components. +Selecting this hyperplane ensures that the projection will preserve as much variance as possible. +!bc pycod +W2 = V.T[:, :2] +X2D = X_centered.dot(W2) +!ec + + +===== PCA and scikit-learn ===== + +Scikit-Learn’s PCA class implements PCA using SVD decomposition just like we did before. The +following code applies PCA to reduce the dimensionality of the dataset down to two dimensions (note +that it automatically takes care of centering the data): +!bc pycod +#thereafter we do a PCA with Scikit-learn +from sklearn.decomposition import PCA +pca = PCA(n_components = 2) +X2D = pca.fit_transform(X) +print(X2D) +!ec +After fitting the PCA transformer to the dataset, you can access the principal components using the +components variable (note that it contains the PCs as horizontal vectors, so, for example, the first +principal component is equal to +!bc pycod +pca.components_.T[:, 0]. +!ec +Another very useful piece of information is the explained variance ratio of each principal component, +available via the $explained\_variance\_ratio$ variable. It indicates the proportion of the dataset’s +variance that lies along the axis of each principal component. + + +===== Back to the Cancer Data ===== +We can now repeat the above but applied to real data, in this case our breast cancer data. +Here we compute performance scores on the training data using logistic regression. +!bc pycod +import matplotlib.pyplot as plt +import numpy as np +from sklearn.model_selection import train_test_split +from sklearn.datasets import load_breast_cancer +from sklearn.linear_model import LogisticRegression +cancer = load_breast_cancer() + +X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) + +logreg = LogisticRegression() +logreg.fit(X_train, y_train) +print("Train set accuracy from Logistic Regression: {:.2f}".format(logreg.score(X_train,y_train))) +# We scale the data +from sklearn.preprocessing import StandardScaler +scaler = StandardScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) +# Then perform again a log reg fit +logreg.fit(X_train_scaled, y_train) +print("Train set accuracy scaled data: {:.2f}".format(logreg.score(X_train_scaled,y_train))) +#thereafter we do a PCA with Scikit-learn +from sklearn.decomposition import PCA +pca = PCA(n_components = 2) +X2D_train = pca.fit_transform(X_train_scaled) +# and finally compute the log reg fit and the score on the training data +logreg.fit(X2D_train,y_train) +print("Train set accuracy scaled and PCA data: {:.2f}".format(logreg.score(X2D_train,y_train))) + +!ec + +We see that our training data after the PCA decomposition has a performance similar to the non-scaled data. + + +===== More on the PCA ===== + +Instead of arbitrarily choosing the number of dimensions to reduce down to, it is generally preferable to +choose the number of dimensions that add up to a sufficiently large portion of the variance (e.g., 95%). +Unless, of course, you are reducing dimensionality for data visualization — in that case you will +generally want to reduce the dimensionality down to 2 or 3. +The following code computes PCA without reducing dimensionality, then computes the minimum number +of dimensions required to preserve 95% of the training set’s variance: +!bc pycod +pca = PCA() +pca.fit(X) +cumsum = np.cumsum(pca.explained_variance_ratio_) +d = np.argmax(cumsum >= 0.95) + 1 +!ec +You could then set $n\_components=d$ and run PCA again. However, there is a much better option: instead +of specifying the number of principal components you want to preserve, you can set $n\_components$ to be +a float between 0.0 and 1.0, indicating the ratio of variance you wish to preserve: +!bc pycod +pca = PCA(n_components=0.95) +X_reduced = pca.fit_transform(X) +!ec + + +===== Incremental PCA ===== + +One problem with the preceding implementation of PCA is that it requires the whole training set to fit in +memory in order for the SVD algorithm to run. Fortunately, Incremental PCA (IPCA) algorithms have +been developed: you can split the training set into mini-batches and feed an IPCA algorithm one minibatch +at a time. This is useful for large training sets, and also to apply PCA online (i.e., on the fly, as new +instances arrive). + + +===== Randomized PCA ===== + +Scikit-Learn offers yet another option to perform PCA, called Randomized PCA. This is a stochastic +algorithm that quickly finds an approximation of the first d principal components. Its computational +complexity is $O(m \times d^2)+O(d^3)$, instead of $O(m \times n^2) + O(n^3)$, so it is dramatically faster than the +previous algorithms when $d$ is much smaller than $n$. + + + + + +===== Kernel PCA ===== +!bblock + +The kernel trick is a mathematical technique that implicitly maps instances into a +very high-dimensional space (called the feature space), enabling nonlinear classification and regression +with Support Vector Machines. Recall that a linear decision boundary in the high-dimensional feature +space corresponds to a complex nonlinear decision boundary in the original space. +It turns out that the same trick can be applied to PCA, making it possible to perform complex nonlinear +projections for dimensionality reduction. This is called Kernel PCA (kPCA). It is often good at +preserving clusters of instances after projection, or sometimes even unrolling datasets that lie close to a +twisted manifold. +For example, the following code uses Scikit-Learn’s KernelPCA class to perform kPCA with an +!bc pycod +from sklearn.decomposition import KernelPCA +rbf_pca = KernelPCA(n_components = 2, kernel="rbf", gamma=0.04) +X_reduced = rbf_pca.fit_transform(X) +!ec + +!eblock + + + +===== LLE ===== + +Locally Linear Embedding (LLE) is another very powerful nonlinear dimensionality reduction +(NLDR) technique. It is a Manifold Learning technique that does not rely on projections like the previous +algorithms. In a nutshell, LLE works by first measuring how each training instance linearly relates to its +closest neighbors (c.n.), and then looking for a low-dimensional representation of the training set where +these local relationships are best preserved (more details shortly). + + + + +===== Other techniques ===== + + +There are many other dimensionality reduction techniques, several of which are available in Scikit-Learn. + +Here are some of the most popular: +* _Multidimensional Scaling (MDS)_ reduces dimensionality while trying to preserve the distances between the instances. +* _Isomap_ creates a graph by connecting each instance to its nearest neighbors, then reduces dimensionality while trying to preserve the geodesic distances between the instances. +* _t-Distributed Stochastic Neighbor Embedding_ (t-SNE) reduces dimensionality while trying to keep similar instances close and dissimilar instances apart. It is mostly used for visualization, in particular to visualize clusters of instances in high-dimensional space (e.g., to visualize the MNIST images in 2D). +* Linear Discriminant Analysis (LDA) is actually a classification algorithm, but during training it learns the most discriminative axes between the classes, and these axes can then be used to define a hyperplane onto which to project the data. The benefit is that the projection will keep classes as far apart as possible, so LDA is a good technique to reduce dimensionality before running another classification algorithm such as a Support Vector Machine (SVM) classifier discussed in the SVM lectures. + + diff --git a/doc/src/DimRed/chapter8.do.txt~ b/doc/src/DimRed/chapter8.do.txt~ new file mode 100644 index 000000000..c6fd2f3c8 --- /dev/null +++ b/doc/src/DimRed/chapter8.do.txt~ @@ -0,0 +1,1267 @@ +TITLE: Data Analysis and Machine Learning: Preprocessing and Dimensionality Reduction +AUTHOR: Morten Hjorth-Jensen {copyright, 1999-present|CC BY-NC} at Department of Physics, University of Oslo & Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University +DATE: today + + +!split +===== Reducing the number of degrees of freedom, overarching view ===== +!bblock + +Many Machine Learning problems involve thousands or even millions of +features for each training instance. Not only does this make training +extremely slow, it can also make it much harder to find a good +solution, as we will see. This problem is often referred to as the +curse of dimensionality. Fortunately, in real-world problems, it is +often possible to reduce the number of features considerably, turning +an intractable problem into a tractable one. + +Here we will discuss some of the most popular dimensionality reduction +techniques: the principal component analysis (PCA), Kernel PCA, and +Locally Linear Embedding (LLE). Furthermore, we will start by looking +at some simple preprocessing of the data which allow us to rescale the +data. + +Principal component analysis and its various variants deal with the +problem of fitting a low-dimensional "affine +subspace":"https://en.wikipedia.org/wiki/Affine_space" to a set of of +data points in a high-dimensional space. With its family of methods it +is one of the most used tools in data modeling, compression and +visualization. + +!eblock + + +!split +===== Preprocessing our data ===== +!bblock + +Before we proceed however, we will discuss how to preprocess our +data. Till now and in connection with our previous examples we have +not met so many cases where we are too sensitive to the scaling of our +data. Normally the data may need a rescaling and/or may be sensitive +to extreme values. Scaling the data renders our inputs much more +suitable for the algorithms we want to employ. + +_Scikit-Learn_ has several functions which allow us to rescale the +data, normally resulting in much better results in terms of various +accuracy scores. The _StandardScaler_ function in _Scikit-Learn_ +ensures that for each feature/predictor we study the mean value is +zero and the variance is one (every column in the design/feature +matrix). This scaling has the drawback that it does not ensure that +we have a particular maximum or minimum in our data set. Another +function included in _Scikit-Learn_ is the _MinMaxScaler_ which +ensures that all features are exactly between $0$ and $1$. The + +!split +===== More preprocessing ===== + + +The _Normalizer_ scales each data +point such that the feature vector has a euclidean length of one. In other words, it +projects a data point on the circle (or sphere in the case of higher dimensions) with a +radius of 1. This means every data point is scaled by a different number (by the +inverse of it’s length). +This normalization is often used when only the direction (or angle) of the data matters, +not the length of the feature vector. + +The _RobustScaler_ works similarly to the StandardScaler in that it +ensures statistical properties for each feature that guarantee that +they are on the same scale. However, the RobustScaler uses the median +and quartiles, instead of mean and variance. This makes the +RobustScaler ignore data points that are very different from the rest +(like measurement errors). These odd data points are also called +outliers, and might often lead to trouble for other scaling +techniques. + +!eblock + +!split +===== Simple preprocessing examples, Franke function and regression ===== + +!bc pycod +# Common imports +import os +import numpy as np +import pandas as pd +import matplotlib.pyplot as plt +import sklearn.linear_model as skl +from sklearn.metrics import mean_squared_error +from sklearn.model_selection import train_test_split +from sklearn.preprocessing import MinMaxScaler, StandardScaler, Normalizer +from sklearn.svm import SVR + +# Where to save the figures and data files +PROJECT_ROOT_DIR = "Results" +FIGURE_ID = "Results/FigureFiles" +DATA_ID = "DataFiles/" + +if not os.path.exists(PROJECT_ROOT_DIR): + os.mkdir(PROJECT_ROOT_DIR) + +if not os.path.exists(FIGURE_ID): + os.makedirs(FIGURE_ID) + +if not os.path.exists(DATA_ID): + os.makedirs(DATA_ID) + +def image_path(fig_id): + return os.path.join(FIGURE_ID, fig_id) + +def data_path(dat_id): + return os.path.join(DATA_ID, dat_id) + +def save_fig(fig_id): + plt.savefig(image_path(fig_id) + ".png", format='png') + + +def FrankeFunction(x,y): + term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2)) + term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1)) + term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2)) + term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2) + return term1 + term2 + term3 + term4 + + +def create_X(x, y, n ): + if len(x.shape) > 1: + x = np.ravel(x) + y = np.ravel(y) + + N = len(x) + l = int((n+1)*(n+2)/2) # Number of elements in beta + X = np.ones((N,l)) + + for i in range(1,n+1): + q = int((i)*(i+1)/2) + for k in range(i+1): + X[:,q+k] = (x**(i-k))*(y**k) + + return X + + +# Making meshgrid of datapoints and compute Franke's function +n = 5 +N = 1000 +x = np.sort(np.random.uniform(0, 1, N)) +y = np.sort(np.random.uniform(0, 1, N)) +z = FrankeFunction(x, y) +X = create_X(x, y, n=n) +# split in training and test data +X_train, X_test, y_train, y_test = train_test_split(X,z,test_size=0.2) + + +svm = SVR(gamma='auto',C=10.0) +svm.fit(X_train, y_train) + +# The mean squared error and R2 score +print("MSE before scaling: {:.2f}".format(mean_squared_error(svm.predict(X_test), y_test))) +print("R2 score before scaling {:.2f}".format(svm.score(X_test,y_test))) + +scaler = StandardScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) + +print("Feature min values before scaling:\n {}".format(X_train.min(axis=0))) +print("Feature max values before scaling:\n {}".format(X_train.max(axis=0))) + +print("Feature min values after scaling:\n {}".format(X_train_scaled.min(axis=0))) +print("Feature max values after scaling:\n {}".format(X_train_scaled.max(axis=0))) + +svm = SVR(gamma='auto',C=10.0) +svm.fit(X_train_scaled, y_train) + +print("MSE after scaling: {:.2f}".format(mean_squared_error(svm.predict(X_test_scaled), y_test))) +print("R2 score for scaled data: {:.2f}".format(svm.score(X_test_scaled,y_test))) + +!ec + + + +!split +===== Simple preprocessing examples, breast cancer data and classification, Support Vector Machines ===== + +We show here how we can use a simple regression case on the breast +cancer data using support vector machines (SVM) as algorithm for +classification. + + +!bc pycod +import matplotlib.pyplot as plt +import numpy as np +from sklearn.model_selection import train_test_split +from sklearn.datasets import load_breast_cancer +from sklearn.svm import SVC +cancer = load_breast_cancer() + +X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) +print(X_train.shape) +print(X_test.shape) + +svm = SVC(C=100) +svm.fit(X_train, y_train) +print("Test set accuracy: {:.2f}".format(svm.score(X_test,y_test))) + +from sklearn.preprocessing import MinMaxScaler, StandardScaler +scaler = MinMaxScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) + +print("Feature min values before scaling:\n {}".format(X_train.min(axis=0))) +print("Feature max values before scaling:\n {}".format(X_train.max(axis=0))) + +print("Feature min values before scaling:\n {}".format(X_train_scaled.min(axis=0))) +print("Feature max values before scaling:\n {}".format(X_train_scaled.max(axis=0))) + + +svm.fit(X_train_scaled, y_train) +print("Test set accuracy scaled data with Min-Max scaling: {:.2f}".format(svm.score(X_test_scaled,y_test))) + +scaler = StandardScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) + +svm.fit(X_train_scaled, y_train) +print("Test set accuracy scaled data with Standar Scaler: {:.2f}".format(svm.score(X_test_scaled,y_test))) + +!ec + +!split +===== More on Cancer Data, now with Logistic Regression ===== + + +!bc pycod +import matplotlib.pyplot as plt +import numpy as np +from sklearn.model_selection import train_test_split +from sklearn.datasets import load_breast_cancer +from sklearn.linear_model import LogisticRegression +cancer = load_breast_cancer() + +# Set up training data +X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) +logreg = LogisticRegression() +logreg.fit(X_train, y_train) +print("Test set accuracy: {:.2f}".format(logreg.score(X_test,y_test))) + +# Scale data +from sklearn.preprocessing import StandardScaler +scaler = StandardScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) +logreg.fit(X_train_scaled, y_train) +print("Test set accuracy scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test))) + +!ec + + + + +!split +===== Why should we think of reducing the dimensionality ===== + +In addition to the plot of the features, we study now also the covariance (and the correlation matrix). +We use also _Pandas_ to compute the correlation matrix. +!bc pycod +import matplotlib.pyplot as plt +import numpy as np +from sklearn.model_selection import train_test_split +from sklearn.datasets import load_breast_cancer +from sklearn.linear_model import LogisticRegression +cancer = load_breast_cancer() +import pandas as pd +# Making a data frame +cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names) + +fig, axes = plt.subplots(15,2,figsize=(10,20)) +malignant = cancer.data[cancer.target == 0] +benign = cancer.data[cancer.target == 1] +ax = axes.ravel() + +for i in range(30): + _, bins = np.histogram(cancer.data[:,i], bins =50) + ax[i].hist(malignant[:,i], bins = bins, alpha = 0.5) + ax[i].hist(benign[:,i], bins = bins, alpha = 0.5) + ax[i].set_title(cancer.feature_names[i]) + ax[i].set_yticks(()) +ax[0].set_xlabel("Feature magnitude") +ax[0].set_ylabel("Frequency") +ax[0].legend(["Malignant", "Benign"], loc ="best") +fig.tight_layout() +plt.show() + +import seaborn as sns +correlation_matrix = cancerpd.corr().round(1) +# use the heatmap function from seaborn to plot the correlation matrix +# annot = True to print the values inside the square +sns.heatmap(data=correlation_matrix, annot=True) +plt.show() + +#print eigvalues of correlation matrix +EigValues, EigVectors = np.linalg.eig(correlation_matrix) +print(EigValues) +!ec + +In the above example we note two things. In the first plot we display +the overlap of benign and malignant tumors as functions of the various +features in the Wisconsing breast cancer data set. We see that for +some of the features we can distinguish clearly the benign and +malignant cases while for other features we cannot. This can point to +us which features may be of greater interest when we wish to classify +a benign or not benign tumour. + +In the second figure we have computed the so-called correlation +matrix, which in our case with thirty features becomes a $30\times 30$ +matrix. + +We constructed this matrix using _pandas_ via the statements +!bc pycod +cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names) +!ec +and then +!bc pycod +correlation_matrix = cancerpd.corr().round(1) +!ec + +Diagonalizing this matrix we can in turn say something about which +features are of relevance and which are not. But before we proceed we +need to define covariance and correlation matrices. This leads us to +the classical Principal Component Analysis (PCA) theorem with +applications. + + + +!split +===== Basic ideas of the Principal Component Analysis (PCA) ===== + +The principal component analysis deals with the problem of fitting a +low-dimensional affine subspace $S$ of dimension $d$ much smaller than +the totaldimension $D$ of the problem at hand (our data +set). Mathematically it can be formulated as a statistical problem or +a geometric problem. In our discussion of the theorem for the +classical PCA, we will stay with a statistical approach. This is also +what set the scene historically which for the PCA. + +We have a data set defined by a design/feature matrix $\bm{X}$ (see below for its definition) +* Each data point is determined by $p$ extrinsic (measurement) variables +* We may want to ask the following question: Are there fewer intrinsic variables (say $d << p$) that still approximately describe the data? +* If so, these intrinsic variables may tell us something important and finding these intrinsic variables is what dimension reduction methods do. + + +!split +===== Introducing the Covariance and Correlation functions ===== + +Before we discuss the PCA theorem, we need to remind ourselves about +the definition of the covariance and the correlation function. These are quantities + +Suppose we have defined two vectors +$\hat{x}$ and $\hat{y}$ with $n$ elements each. The covariance matrix $\bm{C}$ is defined as +!bt +\[ +\bm{C}[\bm{x},\bm{y}] = \begin{bmatrix} \mathrm{cov}[\bm{x},\bm{x}] & \mathrm{cov}[\bm{x},\bm{y}] \\ + \mathrm{cov}[\bm{y},\bm{x}] & \mathrm{cov}[\bm{y},\bm{y}] \\ + \end{bmatrix}, +\] +!et +where for example +!bt +\[ +\mathrm{cov}[\bm{x},\bm{y}] =\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})(y_i- \overline{y}). +\] +!et +With this definition and recalling that the variance is defined as +!bt +\[ +\mathrm{var}[\bm{x}]=\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})^2, +\] +!et +we can rewrite the covariance matrix as +!bt +\[ +\bm{C}[\bm{x},\bm{y}] = \begin{bmatrix} \mathrm{var}[\bm{x}] & \mathrm{cov}[\bm{x},\bm{y}] \\ + \mathrm{cov}[\bm{x},\bm{y}] & \mathrm{var}[\bm{y}] \\ + \end{bmatrix}. +\] +!et + +The covariance takes values between zero and infinity and may thus +lead to problems with loss of numerical precision for particularly +large values. It is common to scale the covariance matrix by +introducing instead the correlation matrix defined via the so-called +correlation function + +!bt +\[ +\mathrm{corr}[\bm{x},\bm{y}]=\frac{\mathrm{cov}[\bm{x},\bm{y}]}{\sqrt{\mathrm{var}[\bm{x}] \mathrm{var}[\bm{y}]}}. +\] +!et + +The correlation function is then given by values $\mathrm{corr}[\bm{x},\bm{y}] +\in [-1,1]$. This avoids eventual problems with too large values. We +can then define the correlation matrix for the two vectors $\bm{x}$ +and $\bm{y}$ as + +!bt +\[ +\bm{K}[\bm{x},\bm{y}] = \begin{bmatrix} 1 & \mathrm{corr}[\bm{x},\bm{y}] \\ + \mathrm{corr}[\bm{y},\bm{x}] & 1 \\ + \end{bmatrix}, +\] +!et + +In the above example this is the function we constructed using _pandas_. + +!split +===== Correlation Function and Design/Feature Matrix ===== + +In our derivation of the various regression algorithms like _Ordinary Least Squares_ or _Ridge regression_ +we defined the design/feature matrix $\bm{X}$ as + +!bt +\[ +\bm{X}=\begin{bmatrix} +x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ +x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ +x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ +\dots & \dots & \dots & \dots \dots & \dots \\ +x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ +x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ +\end{bmatrix}, +\] +!et +with $\bm{X}\in {\mathbb{R}}^{n\times p}$, with the predictors/features $p$ refering to the column numbers and the +entries $n$ being the row elements. +We can rewrite the design/feature matrix in terms of its column vectors as +!bt +\[ +\bm{X}=\begin{bmatrix} \bm{x}_0 & \bm{x}_1 & \bm{x}_2 & \dots & \dots & \bm{x}_{p-1}\end{bmatrix}, +\] +!et +with a given vector +!bt +\[ +\bm{x}_i^T = \begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \dots & \dots x_{n-1,i}\end{bmatrix}. +\] +!et + +With these definitions, we can now rewrite our $2\times 2$ +correaltion/covariance matrix in terms of a moe general design/feature +matrix $\bm{X}\in {\mathbb{R}}^{n\times p}$. This leads to a $p\times p$ +covariance matrix for the vectors $\bm{x}_i$ with $i=0,1,\dots,p-1$ + +!bt +\[ +\bm{C}[\bm{x}] = \begin{bmatrix} +\mathrm{var}[\bm{x}_0] & \mathrm{cov}[\bm{x}_0,\bm{x}_1] & \mathrm{cov}[\bm{x}_0,\bm{x}_2] & \dots & \dots & \mathrm{cov}[\bm{x}_0,\bm{x}_{p-1}]\\ +\mathrm{cov}[\bm{x}_1,\bm{x}_0] & \mathrm{var}[\bm{x}_1] & \mathrm{cov}[\bm{x}_1,\bm{x}_2] & \dots & \dots & \mathrm{cov}[\bm{x}_1,\bm{x}_{p-1}]\\ +\mathrm{cov}[\bm{x}_2,\bm{x}_0] & \mathrm{cov}[\bm{x}_2,\bm{x}_1] & \mathrm{var}[\bm{x}_2] & \dots & \dots & \mathrm{cov}[\bm{x}_2,\bm{x}_{p-1}]\\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\mathrm{cov}[\bm{x}_{p-1},\bm{x}_0] & \mathrm{cov}[\bm{x}_{p-1},\bm{x}_1] & \mathrm{cov}[\bm{x}_{p-1},\bm{x}_{2}] & \dots & \dots & \mathrm{var}[\bm{x}_{p-1}]\\ +\end{bmatrix}, +\] +!et +and the correlation matrix +!bt +\[ +\bm{K}[\bm{x}] = \begin{bmatrix} +1 & \mathrm{corr}[\bm{x}_0,\bm{x}_1] & \mathrm{corr}[\bm{x}_0,\bm{x}_2] & \dots & \dots & \mathrm{corr}[\bm{x}_0,\bm{x}_{p-1}]\\ +\mathrm{corr}[\bm{x}_1,\bm{x}_0] & 1 & \mathrm{corr}[\bm{x}_1,\bm{x}_2] & \dots & \dots & \mathrm{corr}[\bm{x}_1,\bm{x}_{p-1}]\\ +\mathrm{corr}[\bm{x}_2,\bm{x}_0] & \mathrm{corr}[\bm{x}_2,\bm{x}_1] & 1 & \dots & \dots & \mathrm{corr}[\bm{x}_2,\bm{x}_{p-1}]\\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\mathrm{corr}[\bm{x}_{p-1},\bm{x}_0] & \mathrm{corr}[\bm{x}_{p-1},\bm{x}_1] & \mathrm{corr}[\bm{x}_{p-1},\bm{x}_{2}] & \dots & \dots & 1\\ +\end{bmatrix}, +\] +!et + + +!split +===== Covariance Matrix Examples ===== + + +The Numpy function _np.cov_ calculates the covariance elements using +the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have +the exact mean values. The following simple function uses the +_np.vstack_ function which takes each vector of dimension $1\times n$ +and produces a $2\times n$ matrix $\bm{W}$ + + +!bt +\[ +\bm{W} = \begin{bmatrix} x_0 & y_0 \\ + x_1 & y_1 \\ + x_2 & y_2\\ + \dots & \dots \\ + x_{n-2} & y_{n-2}\\ + x_{n-1} & y_{n-1} & + \end{bmatrix}, +\] +!et + +which in turn is converted into into the $2\times 2$ covariance matrix +$\bm{C}$ via the Numpy function _np.cov()_. We note that we can also calculate +the mean value of each set of samples $\bm{x}$ etc using the Numpy +function _np.mean(x)_. We can also extract the eigenvalues of the +covariance matrix through the _np.linalg.eig()_ function. + +!bc pycod +# Importing various packages +import numpy as np +n = 100 +x = np.random.normal(size=n) +print(np.mean(x)) +y = 4+3*x+np.random.normal(size=n) +print(np.mean(y)) +W = np.vstack((x, y)) +C = np.cov(W) +print(C) +!ec + +!split +===== Correlation Matrix ===== + +The previous example can be converted into the correlation matrix by +simply scaling the matrix elements with the variances. We should also +subtract the mean values for each column. This leads to the following +code which sets up the correlations matrix for the previous example in +a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the $2\times 2$ correlation matrix (since we have only two vectors). + +!bc pycod +import numpy as np +n = 100 +# define two vectors +x = np.random.random(size=n) +y = 4+3*x+np.random.normal(size=n) +#scaling the x and y vectors +x = x - np.mean(x) +y = y - np.mean(y) +variance_x = np.sum(x@x)/n +variance_y = np.sum(y@y)/n +print(variance_x) +print(variance_y) +cov_xy = np.sum(x@y)/n +cov_xx = np.sum(x@x)/n +cov_yy = np.sum(y@y)/n +C = np.zeros((2,2)) +C[0,0]= cov_xx/variance_x +C[1,1]= cov_yy/variance_y +C[0,1]= cov_xy/np.sqrt(variance_y*variance_x) +C[1,0]= C[0,1] +print(C) +!ec + +We see that the matrix elements along the diagonal are one as they +should be and that the matrix is symmetric. Furthermore, diagonalizing +this matrix we easily see that it is a positive definite matrix. + +The above procedure with _numpy_ can be made more compact if we use _pandas_. + +!split +===== Correlation Matrix with Pandas ===== + +We whow here how we can set up the correlation matrix using _pandas_, as done in this simple code +!bc pycod +import numpy as np +import pandas as pd +n = 10 +x = np.random.normal(size=n) +x = x - np.mean(x) +y = 4+3*x+np.random.normal(size=n) +y = y - np.mean(y) +X = (np.vstack((x, y))).T +print(X) +Xpd = pd.DataFrame(X) +print(Xpd) +correlation_matrix = Xpd.corr() +print(correlation_matrix) +!ec + + +We expand this model to the Franke function discussed above. + +!split +===== Correlation Matrix with Pandas and the Franke function ===== + +!bc pycod +# Common imports +import numpy as np +import pandas as pd + + +def FrankeFunction(x,y): + term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2)) + term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1)) + term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2)) + term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2) + return term1 + term2 + term3 + term4 + + +def create_X(x, y, n ): + if len(x.shape) > 1: + x = np.ravel(x) + y = np.ravel(y) + + N = len(x) + l = int((n+1)*(n+2)/2) # Number of elements in beta + X = np.ones((N,l)) + + for i in range(1,n+1): + q = int((i)*(i+1)/2) + for k in range(i+1): + X[:,q+k] = (x**(i-k))*(y**k) + + return X + + +# Making meshgrid of datapoints and compute Franke's function +n = 4 +N = 100 +x = np.sort(np.random.uniform(0, 1, N)) +y = np.sort(np.random.uniform(0, 1, N)) +z = FrankeFunction(x, y) +X = create_X(x, y, n=n) + +Xpd = pd.DataFrame(X) +# subtract the mean values and set up the covariance matrix +Xpd = Xpd - Xpd.mean() +covariance_matrix = Xpd.cov() +print(covariance_matrix) +!ec + +We note here that the covariance is zero for the first rows and +columns since all matrix elements in the design matrix were set to one +(we are fitting the function in terms of a polynomial of degree $n$). + +This means that the variance for these elements will be zero and will +cause problems when we set up the correlation matrix. We can simply +drop these elements and construct a correlation +matrix without these elements. + + +!split +===== Rewriting the Covariance and/or Correlation Matrix ===== + +We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix $\bm{X}$ as +!bt +\[ +\bm{C}[\bm{x}] = \frac{1}{n}\bm{X}\bm{X}^T= \mathbb{E}[\bm{X}\bm{X}^T]. +\] +!et + +To see this let us simply look at a design matrix $\bm{X}\in {\mathbb{R}}^{2\times 2}$ +!bt +\[ +\bm{X}=\begin{bmatrix} +x_{00} & x_{01}\\ +x_{10} & x_{11}\\ +\end{bmatrix}=\begin{bmatrix} +\bm{x}_{0} & \bm{x}_{1}\\ +\end{bmatrix}. +\] +!et + +If we then compute the expectation value +!bt +\[ +\mathbb{E}[\bm{X}\bm{X}^T] = \frac{1}{n}\bm{X}\bm{X}^T=\begin{bmatrix} +x_{00}^2+x_{01}^2 & x_{00}x_{10}+x_{01}x_{11}\\ +x_{10}x_{00}+x_{11}x_{01} & x_{10}^2+x_{11}^2\\ +\end{bmatrix}, +\] +!et +which is just +!bt +\[ +\bm{C}[\bm{x}_0,\bm{x}_1] = \bm{C}[\bm{x}]=\begin{bmatrix} \mathrm{var}[\bm{x}_0] & \mathrm{cov}[\bm{x}_0,\bm{x}_1] \\ + \mathrm{cov}[\bm{x}_1,\bm{x}_0] & \mathrm{var}[\bm{x}_1] \\ + \end{bmatrix}, +\] +!et +where we wrote $$\bm{C}[\bm{x}_0,\bm{x}_1] = \bm{C}[\bm{x}]$$ to indicate that this the covariance of the vectors $\bm{x}$ of the design/feature matrix $\bm{X}$. + +It is easy to generalize this to a matrix $\bm{X}\in {\mathbb{R}}^{n\times p}$. + + +!split +===== Towards the PCA theorem ===== + +We have that the covariance matrix (the correlation matrix involves a simple rescaling) is given as +!bt +\[ +\bm{C}[\bm{x}] = \frac{1}{n}\bm{X}\bm{X}^T= \mathbb{E}[\bm{X}\bm{X}^T]. +\] +!et +Let us now assume that we can perform a series of orthogonal transformations where we employ some orthogonal matrices $\bm{S}$. +These matrices are defined as $\bm{S}\in {\mathbb{R}}^{p\times p}$ and obey the orthogonality requirements $\bm{S}\bm{S}^T=\bm{S}^T\bm{S}=\bm{I}$. The matrix can be written out in terms of the column vectors $\bm{s}_i$ as $\bm{S}=[\bm{s}_0,\bm{s}_1,\dots,\bm{s}_{p-1}]$ and $\bm{s}_i \in {\mathbb{R}}^{p}$. + +Assume also that there is a transformation $\bm{S}\bm{C}[\bm{x}]\bm{S}^T=\bm{C}[\bm{y}]$ such that the new matrix $\bm{C}[\bm{y}]$ is diagonal with elements $[\lambda_0,\lambda_1,\lambda_2,\dots,\lambda_{p-1}]$. + +That is we have +!bt +\[ +\bm{C}[\bm{y}] = \mathbb{E}[\bm{S}\bm{X}\bm{X}^T\bm{S}^T]=\bm{S}\bm{C}[\bm{x}]\bm{S}^T, +\] +!et +since the matrix $\bm{S}$ is not a data dependent matrix. Multiplying with $\bm{S}^T$ from the left we have +!bt +\[ +\bm{S}^T\bm{C}[\bm{y}] = \bm{C}[\bm{x}]\bm{S}^T, +\] +!et +and since $\bm{C}[\bm{y}]$ is diagonal we have for a given eigenvalue $i$ of the covariance matrix that + +!bt +\[ +\bm{S}^T_i\lambda_i = \bm{C}[\bm{x}]\bm{S}^T_i. +\] +!et + +In the derivation of the PCA theorem we will assume that the eigenvalues are ordered in descending order, that is +$\lambda_0 > \lambda_1 > \dots > \lambda_{p-1}$. + + +The eigenvalues tell us then how much we need to stretch the +corresponding eigenvectors. Dimensions with large eigenvalues have +thus large variations (large variance) and define therefore useful +dimensions. The data points are more spread out in the direction of +these eigenvectors. Smaller eigenvalues mean on the other hand that +the corresponding eigenvectors are shrunk accordingly and the data +points are tightly bunched together and there is not much variation in +these specific directions. Hopefully then we could leave it out +dimensions where the eigenvalues are very small. If $p$ is very large, +we could then aim at reducing $p$ to $l << p$ and handle only $l$ +features/predictors. + +!split +===== The Algorithm before the Theorem ===== + +Here's how we would proceed in setting up the algorithm for the PCA, see also discussion below here. +* Set up the datapoints for the design/feature matrix $\bm{X}$ with $\bm{X}\in {\mathbb{R}}^{n\times p}$, with the predictors/features $p$ referring to the column numbers and the entries $n$ being the row elements. +!bt +\[ +\bm{X}=\begin{bmatrix} +x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ +x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ +x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ +\dots & \dots & \dots & \dots \dots & \dots \\ +x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ +x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ +\end{bmatrix}, +\] +!et +* Center the data by subtracting the mean value for each column. This leads to a new matrix $\bm{X}\rightarrow \overline{\bm{X}}$. +* Compute then the covariance/correlation matrix $\mathbb{E}[\overline{\bm{X}}\overline{\bm{X}}^T]$. +* Find the eigenpairs of $\bm{C}$ with eigenvalues $[\lambda_0,\lambda_1,\dots,\lambda_{p-1}]$ and eigenvectors $[\bm{s}_0,\bm{s}_1,\dots,\bm{s}_{p-1}]$. +* Order the eigenvalue (and the eigenvectors accordingly) in order of decreasing eigenvalues. +* Keep only those $l$ eigenvalues larger than a selected threshold value, discarding thus $p-l$ features since we expect small variations in the data here. + + +!split +===== Writing our own PCA code ===== + +We will use a simple example first with two-dimensional data +drawn from a multivariate normal distribution with the following mean and covariance matrix: +!bt +\[ +\mu = (-1,2) \qquad \Sigma = \begin{bmatrix} 4 & 2 \\ +2 & 2 +\end{bmatrix} +\] +!et +Note that the mean refers to each column of data. +We will generate $n = 1000$ points $X = \{ x_1, \ldots, x_N \}$ from +this distribution, and store them in the $1000 \times 2$ matrix $\bm{X}$. + +The following Python code aids in setting up the data and writing out the design matrix. +Note that the function _multivariate_ returns also the covariance discussed above and that it is defined by dividing by $n-1$ instead of $n$. +!bc pycod +import numpy as np +import pandas as pd +import matplotlib.pyplot as plt +from IPython.display import display +n = 10000 +mean = (-1, 2) +cov = [[4, 2], [2, 2]] +X = np.random.multivariate_normal(mean, cov, n) +!ec + +Now we are going to implement the PCA algorithm. We will break it down into various substeps. + +=== Compute the sample mean and center the data === + +The first step of PCA is to compute the sample mean of the data and use it to center the data. Recall that the sample mean is +!bt +\[ +\mu_n = \frac{1}{n} \sum_{i=1}^n x_i +\] +!et +and the mean-centered data $\bar{X} = \{ \bar{x}_1, \ldots, \bar{x}_n \}$ takes the form +!bt +\[ +\bar{x}_i = x_i - \mu_n. +\] +!et +When you are done with these steps, print out $\mu_n$ to verify it is +close to $\mu$ and plot your mean centered data to verify it is +centered at the origin! Compare your code with the functionality from _Scikit-Learn_ discussed above. +The following code elements perform these operations using _pandas_ or using our own functionality for doing so. The latter, using _numpy_ is rather simple through the _mean()_ function. +!bc pycod +df = pd.DataFrame(X) +# Pandas does the centering for us +df = df -df.mean() +# we center it ourselves +X_centered = X - X.mean(axis=0) +!ec + +Alternatively, we could use the functions we discussed +earlier for scaling the data set. That is, we could have used the +_StandardScaler_ function in _Scikit-Learn_, a function which ensures +that for each feature/predictor we study the mean value is zero and +the variance is one (every column in the design/feature matrix). You +would then not get the same results, since we divide by the +variance. The diagonal covariance matrix elements will then be one, +while the non-diagonal ones need to be divided by $2\sqrt{2}$ for our +specific case. + +=== Compute the sample covariance === + +Now we are going to use the mean centered data to compute the sample covariance of the data by using the following equation +!bt +\begin{equation*} +\Sigma_n = \frac{1}{n-1} \sum_{i=1}^n \bar{x}_i^T \bar{x}_i = \frac{1}{n-1} \sum_{i=1}^n (x_i - \mu_n)^T (x_i - \mu_n) +\end{equation*} +!et +where the data points $x_i \in \mathbb{R}^p$ (here in this example $p = 2$) are column vectors and $x^T$ is the transpose of $x$. +We can write our own code or simply use either the functionaly of _numpy_ or that of _pandas_, as follows +!bc pycod +print(df.cov()) +print(np.cov(X_centered.T)) +!ec +Note that the way we define the covariance matrix here has a factor $n-1$ instead of $n$. This is included in the _cov()_ function by _numpy_ and _pandas_. +Our own code here is not very elegant and asks for obvious improvements. It is tailored to this specific $2\times 2$ covariance matrix. +!bc pycod +# extract the relevant columns from the centered design matrix of dim n x 2 +x = X_centered[:,0] +y = X_centered[:,1] +Cov = np.zeros((2,2)) +Cov[0,1] = np.sum(x.T@y)/(n-1.0) +Cov[0,0] = np.sum(x.T@x)/(n-1.0) +Cov[1,1] = np.sum(y.T@y)/(n-1.0) +Cov[1,0]= Cov[0,1] +print("Centered covariance using own code") +print(Cov) +plt.plot(x, y, 'x') +plt.axis('equal') +plt.show() +!ec + +Depending on the number of points $n$, we will get results that are close to the covariance values defined above. +The plot shows how the data are clustered around a line with slope close to one. Is this expected? + +=== Diagonalize the sample covariance matrix to obtain the principal components === + +Now we are ready to solve for the principal components! To do so we +diagonalize the sample covariance matrix $\Sigma$. We can use the +function _np.linalg.eig_ to do so. It will return the eigenvalues and +eigenvectors of $\Sigma$. Once we have these we can perform the +following tasks: + +* We compute the percentage of the total variance captured by the first principal component +* We plot the mean centered data and lines along the first and second principal components +* Then we project the mean centered data onto the first and second principal components, and plot the projected data. +* Finally, we approximate the data as + +!bt +\begin{equation*} +x_i \approx \tilde{x}_i = \mu_n + \langle x_i, v_0 \rangle v_0 +\end{equation*} +!et +where $v_0$ is the first principal component. + +Collecting all these steps we can write our own PCA function and +compare this with the functionality included in _Scikit-Learn_. + +The code here outlines some of the elements we could include in the +analysis. Feel free to extend upon this in order to address the above +questions. + +!bc pycod +# diagonalize and obtain eigenvalues, not necessarily sorted +EigValues, EigVectors = np.linalg.eig(Cov) +# sort eigenvectors and eigenvalues +#permute = EigValues.argsort() +#EigValues = EigValues[permute] +#EigVectors = EigVectors[:,permute] +print("Eigenvalues of Covariance matrix") +for i in range(2): + print(EigValues[i]) +FirstEigvector = EigVectors[:,0] +SecondEigvector = EigVectors[:,1] +print("First eigenvector") +print(FirstEigvector) +print("Second eigenvector") +print(SecondEigvector) +#thereafter we do a PCA with Scikit-learn +from sklearn.decomposition import PCA +pca = PCA(n_components = 2) +X2Dsl = pca.fit_transform(X) +print("Eigenvector of largest eigenvalue") +print(pca.components_.T[:, 0]) + +!ec +This code does not contain all the above elements, but it shows how we can use _Scikit-Learn_ to extract the eigenvector which corresponds to the largest eigenvalue. Try to address the questions we pose before the above code. Try also to change the values of the covariance matrix by making one of the diagonal elements much larger than the other. What do you observe then? + +!split +===== Classical PCA Theorem ===== + +We assume now that we have a design matrix $\bm{X}$ which has been +centered as discussed above. For the sake of simplicity we skip the +overline symbol. The matrix is defined in terms of the various column +vectors $[\bm{x}_0,\bm{x}_1,\dots, \bm{x}_{p-1}]$ each with dimension +$\bm{x}\in {\mathbb{R}}^{n}$. + +We assume also that we have an orthogonal transformation $\bm{W}\in {\mathbb{R}}^{p\times p}$. We define the reconstruction error (which is similar to the mean squared error we have seen before) as +!bt +\[ +J(\bm{W},\bm{Z}) = \frac{1}{n}\sum_i (\bm{x}_i - \overline{\bm{x}}_i)^2, +\] +!et +with $\overline{\bm{x}}_i = \bm{W}\bm{z}_i$, where $\bm{z}_i$ is a row vector with dimension ${\mathbb{R}}^{n}$ of the matrix +$\bm{Z}\in{\mathbb{R}}^{p\times n}$. When doing PCA we want to reduce this dimensionality. + +The PCA theorem states that minimizing the above reconstruction error +corresponds to setting $\bm{W}=\bm{S}$, the orthogonal matrix which +diagonalizes the empirical covariance(correlation) matrix. The optimal +low-dimensional encoding of the data is then given by a set of vectors +$\bm{z}_i$ with at most $l$ vectors, with $l << p$, defined by the +orthogonal projection of the data onto the columns spanned by the +eigenvectors of the covariance(correlations matrix). + +The proof which follows will be updated by mid January 2020. + +!split +===== Proof of the PCA Theorem ===== + +To show the PCA theorem let us start with the assumption that there is one vector $\bm{w}_0$ which corresponds to a solution which minimized the reconstruction error $J$. This is an orthogonal vector. It means that we now approximate the reconstruction error in terms of $\bm{w}_0$ and $\bm{z}_0$ as +!bt +\[ +J(\bm{w}_0,\bm{z}_0)= \frac{1}{n}\sum_i (\bm{x}_i - z_{i0}\bm{w}_0)^2=\frac{1}{n}\sum_i (\bm{x}_i^T\bm{x}_i - 2z_{i0}\bm{w}_0^T\bm{x}_i+z_{i0}^2\bm{w}_0^T\bm{w}_0), +\] +!et +which we can rewrite due to the orthogonality of $\bm{w}_i$ as +!bt +\[ +J(\bm{w}_0,\bm{z}_0)=\frac{1}{n}\sum_i (\bm{x}_i^T\bm{x}_i - 2z_{i0}\bm{w}_0^T\bm{x}_i+z_{i0}^2). +\] +!et +Minimizing $J$ with respect to the unknown parameters $z_{0i}$ we obtain that +!bt +\[ +z_{i0}=\bm{w}_0^T\bm{x}_i, +\] +!et +where the vectors on the rhs are known. + + +!split +===== PCA Proof continued ===== + +We have now found the unknown parameters $z_{i0}$. These correspond to the projected coordinates and we can write +!bt +\[ +J(\bm{w}_0)= \frac{1}{p}\sum_i (\bm{x}_i^T\bm{x}_i - z_{i0}^2)=\mathrm{const}-\frac{1}{n}\sum_i z_{i0}^2. +\] +!et + +We can show that the variance of the projected coordinates defined by $\bm{w}_0^T\bm{x}_i$ are given by +!bt +\[ +\mathrm{var}[\bm{w}_0^T\bm{x}_i] = \frac{1}{n}\sum_i z_{i0}^2, +\] +!et +since the expectation value of +!bt +\[ +\mathbb{E}[\bm{w}_0^T\bm{x}_i] = \mathbb{E}[z_{i0}]= \bm{w}_0^T\mathbb{E}[\bm{x}_i]=0, +\] +!et +where we have used the fact that our data are centered. + +Recalling our definition of the covariance as +!bt +\[ +\bm{C}[\bm{x}] = \frac{1}{n}\bm{X}\bm{X}^T=\mathbb{E}[\bm{X}\bm{X}^T], +\] +!et +we have thus that +!bt +\[ +\mathrm{var}[\bm{w}_0^T\bm{x}_i] = \frac{1}{n}\sum_i z_{i0}^2=\bm{w}_0^T\bm{C}[\bm{x}]\bm{w}_0. +\] +!et + +We are almost there, we have obtained a relation between minimizing +the reconstruction error and the variance and the covariance +matrix. Minimizing the error is equivalent to maximizing the variance +of the projected data. + +!split +===== The final step ===== + +We could trivially maximize the variance of the projection (and +thereby minimize the error in the reconstruction function) by letting +the norm-2 of $\bm{w}_0$ go to infinity. However, this norm since we +want the matrix $\bm{W}$ to be an orthogonal matrix, is constrained by +$\vert\vert \bm{w}_0 \vert\vert_2^2=1$. Imposing this condition via a +Lagrange multiplier we can then in turn maximize + +!bt +\[ +J(\bm{w}_0)= \bm{w}_0^T\bm{C}[\bm{x}]\bm{w}_0+\lambda_0(1-\bm{w}_0^T\bm{w}_0). +\] +!et +Taking the derivative with respect to $\bm{w}_0$ we obtain + +!bt +\[ +\frac{\partial J(\bm{w}_0)}{\partial \bm{w}_0}= 2\bm{C}[\bm{x}]\bm{w}_0-2\lambda_0\bm{w}_0=0, +\] +!et +meaning that +!bt +\[ +\bm{C}[\bm{x}]\bm{w}_0=\lambda_0\bm{w}_0. +\] +!et +_The direction that maximizes the variance (or minimizes the construction error) is an eigenvector of the covariance matrix_! If we left multiply with $\bm{w}_0^T$ we have the variance of the projected data is +!bt +\[ +\bm{w}_0^T\bm{C}[\bm{x}]\bm{w}_0=\lambda_0. +\] +!et + +If we want to maximize the variance (minimize the construction error) +we simply pick the eigenvector of the covariance matrix with the +largest eigenvalue. This establishes the link between the minimization +of the reconstruction function $J$ in terms of an orthogonal matrix +and the maximization of the variance and thereby the covariance of our +observations encoded in the design/feature matrix $\bm{X}$. + +The proof +for the other eigenvectors $\bm{w}_1,\bm{w}_2,\dots$ can be +established by applying the above arguments and using the fact that +our basis of eigenvectors is orthogonal, see "Murphy chapter +12.2":"https://mitpress.mit.edu/books/machine-learning-1". The +discussion in chapter 12.2 of Murphy's text has also a nice link with +the Singular Value Decomposition theorem. For categorical data, see +chapter 12.4 and discussion therein. + +Additional part of the proof for the other eigenvectors will be added by mid January 2020. + +!split +===== Geometric Interpretation and link with Singular Value Decomposition ===== + +This material will be added by mid January 2020. + + +!split +===== Principal Component Analysis ===== + +Principal Component Analysis (PCA) is by far the most popular dimensionality reduction algorithm. +First it identifies the hyperplane that lies closest to the data, and then it projects the data onto it. + +The following Python code uses NumPy’s _svd()_ function to obtain all the principal components of the +training set, then extracts the first two principal components. First we center the data using either _pandas_ or our own code +!bc pycod +import numpy as np +import pandas as pd +from IPython.display import display +np.random.seed(100) +# setting up a 10 x 5 vanilla matrix +rows = 10 +cols = 5 +X = np.random.randn(rows,cols) +df = pd.DataFrame(X) +# Pandas does the centering for us +df = df -df.mean() +display(df) + +# we center it ourselves +X_centered = X - X.mean(axis=0) +# Then check the difference between pandas and our own set up +print(X_centered-df) +#Now we do an SVD +U, s, V = np.linalg.svd(X_centered) +c1 = V.T[:, 0] +c2 = V.T[:, 1] +W2 = V.T[:, :2] +X2D = X_centered.dot(W2) +print(X2D) +!ec + +PCA assumes that the dataset is centered around the origin. Scikit-Learn’s PCA classes take care of centering +the data for you. However, if you implement PCA yourself (as in the preceding example), or if you use other libraries, don’t +forget to center the data first. + +Once you have identified all the principal components, you can reduce the dimensionality of the dataset +down to $d$ dimensions by projecting it onto the hyperplane defined by the first $d$ principal components. +Selecting this hyperplane ensures that the projection will preserve as much variance as possible. +!bc pycod +W2 = V.T[:, :2] +X2D = X_centered.dot(W2) +!ec + +!split +===== PCA and scikit-learn ===== + +Scikit-Learn’s PCA class implements PCA using SVD decomposition just like we did before. The +following code applies PCA to reduce the dimensionality of the dataset down to two dimensions (note +that it automatically takes care of centering the data): +!bc pycod +#thereafter we do a PCA with Scikit-learn +from sklearn.decomposition import PCA +pca = PCA(n_components = 2) +X2D = pca.fit_transform(X) +print(X2D) +!ec +After fitting the PCA transformer to the dataset, you can access the principal components using the +components variable (note that it contains the PCs as horizontal vectors, so, for example, the first +principal component is equal to +!bc pycod +pca.components_.T[:, 0]. +!ec +Another very useful piece of information is the explained variance ratio of each principal component, +available via the $explained\_variance\_ratio$ variable. It indicates the proportion of the dataset’s +variance that lies along the axis of each principal component. + +!split +===== Back to the Cancer Data ===== +We can now repeat the above but applied to real data, in this case our breast cancer data. +Here we compute performance scores on the training data using logistic regression. +!bc pycod +import matplotlib.pyplot as plt +import numpy as np +from sklearn.model_selection import train_test_split +from sklearn.datasets import load_breast_cancer +from sklearn.linear_model import LogisticRegression +cancer = load_breast_cancer() + +X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) + +logreg = LogisticRegression() +logreg.fit(X_train, y_train) +print("Train set accuracy from Logistic Regression: {:.2f}".format(logreg.score(X_train,y_train))) +# We scale the data +from sklearn.preprocessing import StandardScaler +scaler = StandardScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) +# Then perform again a log reg fit +logreg.fit(X_train_scaled, y_train) +print("Train set accuracy scaled data: {:.2f}".format(logreg.score(X_train_scaled,y_train))) +#thereafter we do a PCA with Scikit-learn +from sklearn.decomposition import PCA +pca = PCA(n_components = 2) +X2D_train = pca.fit_transform(X_train_scaled) +# and finally compute the log reg fit and the score on the training data +logreg.fit(X2D_train,y_train) +print("Train set accuracy scaled and PCA data: {:.2f}".format(logreg.score(X2D_train,y_train))) + +!ec + +We see that our training data after the PCA decomposition has a performance similar to the non-scaled data. + +!split +===== More on the PCA ===== + +Instead of arbitrarily choosing the number of dimensions to reduce down to, it is generally preferable to +choose the number of dimensions that add up to a sufficiently large portion of the variance (e.g., 95%). +Unless, of course, you are reducing dimensionality for data visualization — in that case you will +generally want to reduce the dimensionality down to 2 or 3. +The following code computes PCA without reducing dimensionality, then computes the minimum number +of dimensions required to preserve 95% of the training set’s variance: +!bc pycod +pca = PCA() +pca.fit(X) +cumsum = np.cumsum(pca.explained_variance_ratio_) +d = np.argmax(cumsum >= 0.95) + 1 +!ec +You could then set $n\_components=d$ and run PCA again. However, there is a much better option: instead +of specifying the number of principal components you want to preserve, you can set $n\_components$ to be +a float between 0.0 and 1.0, indicating the ratio of variance you wish to preserve: +!bc pycod +pca = PCA(n_components=0.95) +X_reduced = pca.fit_transform(X) +!ec + +!split +===== Incremental PCA ===== + +One problem with the preceding implementation of PCA is that it requires the whole training set to fit in +memory in order for the SVD algorithm to run. Fortunately, Incremental PCA (IPCA) algorithms have +been developed: you can split the training set into mini-batches and feed an IPCA algorithm one minibatch +at a time. This is useful for large training sets, and also to apply PCA online (i.e., on the fly, as new +instances arrive). + +!split +===== Randomized PCA ===== + +Scikit-Learn offers yet another option to perform PCA, called Randomized PCA. This is a stochastic +algorithm that quickly finds an approximation of the first d principal components. Its computational +complexity is $O(m \times d^2)+O(d^3)$, instead of $O(m \times n^2) + O(n^3)$, so it is dramatically faster than the +previous algorithms when $d$ is much smaller than $n$. + + + + +!split +===== Kernel PCA ===== +!bblock + +The kernel trick is a mathematical technique that implicitly maps instances into a +very high-dimensional space (called the feature space), enabling nonlinear classification and regression +with Support Vector Machines. Recall that a linear decision boundary in the high-dimensional feature +space corresponds to a complex nonlinear decision boundary in the original space. +It turns out that the same trick can be applied to PCA, making it possible to perform complex nonlinear +projections for dimensionality reduction. This is called Kernel PCA (kPCA). It is often good at +preserving clusters of instances after projection, or sometimes even unrolling datasets that lie close to a +twisted manifold. +For example, the following code uses Scikit-Learn’s KernelPCA class to perform kPCA with an +!bc pycod +from sklearn.decomposition import KernelPCA +rbf_pca = KernelPCA(n_components = 2, kernel="rbf", gamma=0.04) +X_reduced = rbf_pca.fit_transform(X) +!ec + +!eblock + + +!split +===== LLE ===== + +Locally Linear Embedding (LLE) is another very powerful nonlinear dimensionality reduction +(NLDR) technique. It is a Manifold Learning technique that does not rely on projections like the previous +algorithms. In a nutshell, LLE works by first measuring how each training instance linearly relates to its +closest neighbors (c.n.), and then looking for a low-dimensional representation of the training set where +these local relationships are best preserved (more details shortly). + + + +!split +===== Other techniques ===== + + +There are many other dimensionality reduction techniques, several of which are available in Scikit-Learn. + +Here are some of the most popular: +* _Multidimensional Scaling (MDS)_ reduces dimensionality while trying to preserve the distances between the instances. +* _Isomap_ creates a graph by connecting each instance to its nearest neighbors, then reduces dimensionality while trying to preserve the geodesic distances between the instances. +* _t-Distributed Stochastic Neighbor Embedding_ (t-SNE) reduces dimensionality while trying to keep similar instances close and dissimilar instances apart. It is mostly used for visualization, in particular to visualize clusters of instances in high-dimensional space (e.g., to visualize the MNIST images in 2D). +* Linear Discriminant Analysis (LDA) is actually a classification algorithm, but during training it learns the most discriminative axes between the classes, and these axes can then be used to define a hyperplane onto which to project the data. The benefit is that the projection will keep classes as far apart as possible, so LDA is a good technique to reduce dimensionality before running another classification algorithm such as a Support Vector Machine (SVM) classifier discussed in the SVM lectures. + + diff --git a/doc/src/How2ReadData/chapter3.dlog b/doc/src/How2ReadData/chapter3.dlog new file mode 100644 index 000000000..ed18adf7b --- /dev/null +++ b/doc/src/How2ReadData/chapter3.dlog @@ -0,0 +1,22 @@ +translating doconce text in chapter3.do.txt to ipynb +*** replacing \bm{...} by \boldsymbol{...} (\bm is not supported by MathJax) +collected all required additional files in ipynb-chapter3-src.tar.gz which must be distributed with the notebook +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{cases} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +Failed to remove ans_at_end environment +Failed to remove sol_at_end environment +output in chapter3.ipynb diff --git a/doc/src/How2ReadData/chapter3.do.txt b/doc/src/How2ReadData/chapter3.do.txt new file mode 100644 index 000000000..a5d332464 --- /dev/null +++ b/doc/src/How2ReadData/chapter3.do.txt @@ -0,0 +1,1341 @@ + +======= Getting started, our first data and Machine Learning encounters ======= + +===== Introduction ===== + +Our emphasis throughout this series of lectures +is on understanding the mathematical aspects of +different algorithms used in the fields of data analysis and machine learning. + +However, where possible we will emphasize the +importance of using available software. We start thus with a hands-on +and top-down approach to machine learning. The aim is thus to start with +relevant data or data we have produced +and use these to introduce statistical data analysis +concepts and machine learning algorithms before we delve into the +algorithms themselves. The examples we will use in the beginning, start with simple +polynomials with random noise added. We will use the Python +software package "Scikit-Learn":"http://scikit-learn.org/stable/" and +introduce various machine learning algorithms to make fits of +the data and predictions. We move thereafter to more interesting +cases such as data from say experiments (below we will look at experimental nuclear binding energies as an example). +These are examples where we can easily set up the data and +then use machine learning algorithms included in for example +_Scikit-Learn_. + +These examples will serve us the purpose of getting +started. Furthermore, they allow us to catch more than two birds with +a stone. They will allow us to bring in some programming specific +topics and tools as well as showing the power of various Python +libraries for machine learning and statistical data analysis. + +Here, we will mainly focus on two +specific Python packages for Machine Learning, Scikit-Learn and +Tensorflow (see below for links etc). Moreover, the examples we +introduce will serve as inputs to many of our discussions later, as +well as allowing you to set up models and produce your own data and +get started with programming. + + + +===== What is Machine Learning? ===== + +Statistics, data science and machine learning form important fields of +research in modern science. They describe how to learn and make +predictions from data, as well as allowing us to extract important +correlations about physical process and the underlying laws of motion +in large data sets. The latter, big data sets, appear frequently in +essentially all disciplines, from the traditional Science, Technology, +Mathematics and Engineering fields to Life Science, Law, education +research, the Humanities and the Social Sciences. + +It has become more +and more common to see research projects on big data in for example +the Social Sciences where extracting patterns from complicated survey +data is one of many research directions. Having a solid grasp of data +analysis and machine learning is thus becoming central to scientific +computing in many fields, and competences and skills within the fields +of machine learning and scientific computing are nowadays strongly +requested by many potential employers. The latter cannot be +overstated, familiarity with machine learning has almost become a +prerequisite for many of the most exciting employment opportunities, +whether they are in bioinformatics, life science, physics or finance, +in the private or the public sector. This author has had several +students or met students who have been hired recently based on their +skills and competences in scientific computing and data science, often +with marginal knowledge of machine learning. + +Machine learning is a subfield of computer science, and is closely +related to computational statistics. It evolved from the study of +pattern recognition in artificial intelligence (AI) research, and has +made contributions to AI tasks like computer vision, natural language +processing and speech recognition. Many of the methods we will study are also +strongly rooted in basic mathematics and physics research. + +Ideally, machine learning represents the science of giving computers +the ability to learn without being explicitly programmed. The idea is +that there exist generic algorithms which can be used to find patterns +in a broad class of data sets without having to write code +specifically for each problem. The algorithm will build its own logic +based on the data. You should however always keep in mind that +machines and algorithms are to a large extent developed by humans. The +insights and knowledge we have about a specific system, play a central +role when we develop a specific machine learning algorithm. + +Machine learning is an extremely rich field, in spite of its young +age. The increases we have seen during the last three decades in +computational capabilities have been followed by developments of +methods and techniques for analyzing and handling large date sets, +relying heavily on statistics, computer science and mathematics. The +field is rather new and developing rapidly. Popular software packages +written in Python for machine learning like +"Scikit-learn":"http://scikit-learn.org/stable/", +"Tensorflow":"https://www.tensorflow.org/", +"PyTorch":"http://pytorch.org/" and "Keras":"https://keras.io/", all +freely available at their respective GitHub sites, encompass +communities of developers in the thousands or more. And the number of +code developers and contributors keeps increasing. Not all the +algorithms and methods can be given a rigorous mathematical +justification, opening up thereby large rooms for experimenting and +trial and error and thereby exciting new developments. However, a +solid command of linear algebra, multivariate theory, probability +theory, statistical data analysis, understanding errors and Monte +Carlo methods are central elements in a proper understanding of many +of algorithms and methods we will discuss. + + + +===== Types of Machine Learning ===== + + +The approaches to machine learning are many, but are often split into +two main categories. In *supervised learning* we know the answer to a +problem, and let the computer deduce the logic behind it. On the other +hand, *unsupervised learning* is a method for finding patterns and +relationship in data sets without any prior knowledge of the system. +Some authours also operate with a third category, namely +*reinforcement learning*. This is a paradigm of learning inspired by +behavioral psychology, where learning is achieved by trial-and-error, +solely from rewards and punishment. + +Another way to categorize machine learning tasks is to consider the +desired output of a system. Some of the most common tasks are: + + * Classification: Outputs are divided into two or more classes. The goal is to produce a model that assigns inputs into one of these classes. An example is to identify digits based on pictures of hand-written ones. Classification is typically supervised learning. + + * Regression: Finding a functional relationship between an input data set and a reference data set. The goal is to construct a function that maps input data to continuous output values. + + * Clustering: Data are divided into groups with certain common traits, without knowing the different groups beforehand. It is thus a form of unsupervised learning. + + +The methods we cover have three main topics in common, irrespective of +whether we deal with supervised or unsupervised learning. The first +ingredient is normally our data set (which can be subdivided into +training and test data), the second item is a model which is normally a +function of some parameters. The model reflects our knowledge of the system (or lack thereof). As an example, if we know that our data show a behavior similar to what would be predicted by a polynomial, fitting our data to a polynomial of some degree would then determin our model. + +The last ingredient is a so-called _cost_ +function which allows us to present an estimate on how good our model +is in reproducing the data it is supposed to train. +At the heart of basically all ML algorithms there are so-called minimization algorithms, often we end up with various variants of _gradient_ methods. + + + + + + + +===== Software and needed installations ===== + +We will make extensive use of Python as programming language and its +myriad of available libraries. You will find +Jupyter notebooks invaluable in your work. You can run _R_ +codes in the Jupyter/IPython notebooks, with the immediate benefit of +visualizing your data. You can also use compiled languages like C++, +Rust, Julia, Fortran etc if you prefer. The focus in these lectures will be +on Python. + + +If you have Python installed (we strongly recommend Python3) and you feel +pretty familiar with installing different packages, we recommend that +you install the following Python packages via _pip_ as + +o pip install numpy scipy matplotlib ipython scikit-learn mglearn sympy pandas pillow + +For Python3, replace _pip_ with _pip3_. + +For OSX users we recommend, after having installed Xcode, to +install _brew_. Brew allows for a seamless installation of additional +software via for example + +o brew install python3 + +For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution, +you can use _pip_ as well and simply install Python as + +o sudo apt-get install python3 (or python for pyhton2.7) + +etc etc. + + + +===== Python installers ===== + +If you don't want to perform these operations separately and venture +into the hassle of exploring how to set up dependencies and paths, we +recommend two widely used distrubutions which set up all relevant +dependencies for Python, namely + +* "Anaconda":"https://docs.anaconda.com/", + +which is an open source +distribution of the Python and R programming languages for large-scale +data processing, predictive analytics, and scientific computing, that +aims to simplify package management and deployment. Package versions +are managed by the package management system _conda_. + +* "Enthought canopy":"https://www.enthought.com/product/canopy/" + +is a Python +distribution for scientific and analytic computing distribution and +analysis environment, available for free and under a commercial +license. + +Furthermore, "Google's Colab":"https://colab.research.google.com/notebooks/welcome.ipynb" is a free Jupyter notebook environment that requires +no setup and runs entirely in the cloud. Try it out! + +===== Useful Python libraries ===== +Here we list several useful Python libraries we strongly recommend (if you use anaconda many of these are already there) + +* "NumPy":"https://www.numpy.org/" is a highly popular library for large, multi-dimensional arrays and matrices, along with a large collection of high-level mathematical functions to operate on these arrays +* "The pandas":"https://pandas.pydata.org/" library provides high-performance, easy-to-use data structures and data analysis tools +* "Xarray":"http://xarray.pydata.org/en/stable/" is a Python package that makes working with labelled multi-dimensional arrays simple, efficient, and fun! +* "Scipy":"https://www.scipy.org/" (pronounced “Sigh Pie”) is a Python-based ecosystem of open-source software for mathematics, science, and engineering. +* "Matplotlib":"https://matplotlib.org/" is a Python 2D plotting library which produces publication quality figures in a variety of hardcopy formats and interactive environments across platforms. +* "Autograd":"https://github.com/HIPS/autograd" can automatically differentiate native Python and Numpy code. It can handle a large subset of Python's features, including loops, ifs, recursion and closures, and it can even take derivatives of derivatives of derivatives +* "SymPy":"https://www.sympy.org/en/index.html" is a Python library for symbolic mathematics. +* "scikit-learn":"https://scikit-learn.org/stable/" has simple and efficient tools for machine learning, data mining and data analysis +* "TensorFlow":"https://www.tensorflow.org/" is a Python library for fast numerical computing created and released by Google +* "Keras":"https://keras.io/" is a high-level neural networks API, written in Python and capable of running on top of TensorFlow, CNTK, or Theano +* And many more such as "pytorch":"https://pytorch.org/", "Theano":"https://pypi.org/project/Theano/" etc + +===== Installing R, C++, cython or Julia ===== + +You will also find it convenient to utilize _R_. We will mainly +use Python during our lectures and in various projects and exercises. +Those of you +already familiar with _R_ should feel free to continue using _R_, keeping +however an eye on the parallel Python set ups. Similarly, if you are a +Python afecionado, feel free to explore _R_ as well. Jupyter/Ipython +notebook allows you to run _R_ codes interactively in your +browser. The software library _R_ is really tailored for statistical data analysis +and allows for an easy usage of the tools and algorithms we will discuss in these +lectures. + +To install _R_ with Jupyter notebook +"follow the link here":"https://mpacer.org/maths/r-kernel-for-ipython-notebook" + + + + +===== Installing R, C++, cython, Numba etc ===== + + +For the C++ aficionados, Jupyter/IPython notebook allows you also to +install C++ and run codes written in this language interactively in +the browser. Since we will emphasize writing many of the algorithms +yourself, you can thus opt for either Python or C++ (or Fortran or other compiled languages) as programming +languages. + +To add more entropy, _cython_ can also be used when running your +notebooks. It means that Python with the jupyter notebook +setup allows you to integrate widely popular softwares and tools for +scientific computing. Similarly, the +"Numba Python package":"https://numba.pydata.org/" delivers increased performance +capabilities with minimal rewrites of your codes. With its +versatility, including symbolic operations, Python offers a unique +computational environment. Your jupyter notebook can easily be +converted into a nicely rendered _PDF_ file or a Latex file for +further processing. For example, convert to latex as + +!bc +pycod jupyter nbconvert filename.ipynb --to latex +!ec + +And to add more versatility, the Python package "SymPy":"http://www.sympy.org/en/index.html" is a Python library for symbolic mathematics. It aims to become a full-featured computer algebra system (CAS) and is entirely written in Python. + +Finally, if you wish to use the light mark-up language +"doconce":"https://github.com/hplgit/doconce" you can convert a standard ascii text file into various HTML +formats, ipython notebooks, latex files, pdf files etc with minimal edits. These lectures were generated using _doconce_. + + + +===== Numpy examples and Important Matrix and vector handling packages ===== + +There are several central software libraries for linear algebra and eigenvalue problems. Several of the more +popular ones have been wrapped into ofter software packages like those from the widely used text _Numerical Recipes_. The original source codes in many of the available packages are often taken from the widely used +software package LAPACK, which follows two other popular packages +developed in the 1970s, namely EISPACK and LINPACK. We describe them shortly here. + + * LINPACK: package for linear equations and least square problems. + * LAPACK:package for solving symmetric, unsymmetric and generalized eigenvalue problems. From LAPACK's website URL: "http://www.netlib.org" it is possible to download for free all source codes from this library. Both C/C++ and Fortran versions are available. + * BLAS (I, II and III): (Basic Linear Algebra Subprograms) are routines that provide standard building blocks for performing basic vector and matrix operations. Blas I is vector operations, II vector-matrix operations and III matrix-matrix operations. Highly parallelized and efficient codes, all available for download from URL: "http://www.netlib.org". + + +===== Basic Matrix Features ===== + +!bblock Matrix properties reminder +!bt +\[ + \mathbf{A} = + \begin{bmatrix} a_{11} & a_{12} & a_{13} & a_{14} \\ + a_{21} & a_{22} & a_{23} & a_{24} \\ + a_{31} & a_{32} & a_{33} & a_{34} \\ + a_{41} & a_{42} & a_{43} & a_{44} + \end{bmatrix}\qquad +\mathbf{I} = + \begin{bmatrix} 1 & 0 & 0 & 0 \\ + 0 & 1 & 0 & 0 \\ + 0 & 0 & 1 & 0 \\ + 0 & 0 & 0 & 1 + \end{bmatrix} +\] +!et + + + +The inverse of a matrix is defined by + +!bt +\[ +\mathbf{A}^{-1} \cdot \mathbf{A} = I +\] +!et + + +|----------------------------------------------------------------------| +| Relations | Name | matrix elements | +|----------------------------------------------------------------------| +| $A = A^{T}$ | symmetric | $a_{ij} = a_{ji}$ | +| $A = \left (A^{T} \right )^{-1}$ | real orthogonal | $\sum_k a_{ik} a_{jk} = \sum_k a_{ki} a_{kj} = \delta_{ij}$ | +| $A = A^{ * }$ | real matrix | $a_{ij} = a_{ij}^{ * }$ | +| $A = A^{\dagger}$ | hermitian | $a_{ij} = a_{ji}^{ * }$ | +| $A = \left (A^{\dagger} \right )^{-1}$ | unitary | $\sum_k a_{ik} a_{jk}^{ * } = \sum_k a_{ki}^{ * } a_{kj} = \delta_{ij}$ | +|----------------------------------------------------------------------| + +!eblock + + +=== Some famous Matrices === + + * Diagonal if $a_{ij}=0$ for $i\ne j$ + * Upper triangular if $a_{ij}=0$ for $i > j$ + * Lower triangular if $a_{ij}=0$ for $i < j$ + * Upper Hessenberg if $a_{ij}=0$ for $i > j+1$ + * Lower Hessenberg if $a_{ij}=0$ for $i < j+1$ + * Tridiagonal if $a_{ij}=0$ for $|i -j| > 1$ + * Lower banded with bandwidth $p$: $a_{ij}=0$ for $i > j+p$ + * Upper banded with bandwidth $p$: $a_{ij}=0$ for $i < j+p$ + * Banded, block upper triangular, block lower triangular.... + + +=== More Basic Matrix Features === + +!bblock Some Equivalent Statements +For an $N\times N$ matrix $\mathbf{A}$ the following properties are all equivalent + + * If the inverse of $\mathbf{A}$ exists, $\mathbf{A}$ is nonsingular. + * The equation $\mathbf{Ax}=0$ implies $\mathbf{x}=0$. + * The rows of $\mathbf{A}$ form a basis of $R^N$. + * The columns of $\mathbf{A}$ form a basis of $R^N$. + * $\mathbf{A}$ is a product of elementary matrices. + * $0$ is not eigenvalue of $\mathbf{A}$. +!eblock + + +===== Numpy and arrays ===== +"Numpy":"http://www.numpy.org/" provides an easy way to handle arrays in Python. The standard way to import this library is as + +!bc pycod +import numpy as np +!ec +Here follows a simple example where we set up an array of ten elements, all determined by random numbers drawn according to the normal distribution, +!bc pycod +n = 10 +x = np.random.normal(size=n) +print(x) +!ec +We defined a vector $x$ with $n=10$ elements with its values given by the Normal distribution $N(0,1)$. +Another alternative is to declare a vector as follows +!bc pycod +import numpy as np +x = np.array([1, 2, 3]) +print(x) +!ec +Here we have defined a vector with three elements, with $x_0=1$, $x_1=2$ and $x_2=3$. Note that both Python and C++ +start numbering array elements from $0$ and on. This means that a vector with $n$ elements has a sequence of entities $x_0, x_1, x_2, \dots, x_{n-1}$. We could also let (recommended) Numpy to compute the logarithms of a specific array as +!bc pycod +import numpy as np +x = np.log(np.array([4, 7, 8])) +print(x) +!ec + +In the last example we used Numpy's unary function $np.log$. This function is +highly tuned to compute array elements since the code is vectorized +and does not require looping. We normaly recommend that you use the +Numpy intrinsic functions instead of the corresponding _log_ function +from Python's _math_ module. The looping is done explicitely by the +_np.log_ function. The alternative, and slower way to compute the +logarithms of a vector would be to write + +!bc pycod +import numpy as np +from math import log +x = np.array([4, 7, 8]) +for i in range(0, len(x)): + x[i] = log(x[i]) +print(x) +!ec +We note that our code is much longer already and we need to import the _log_ function from the _math_ module. +The attentive reader will also notice that the output is $[1, 1, 2]$. Python interprets automagically our numbers as integers (like the _automatic_ keyword in C++). To change this we could define our array elements to be double precision numbers as +!bc pycod +import numpy as np +x = np.log(np.array([4, 7, 8], dtype = np.float64)) +print(x) +!ec +or simply write them as double precision numbers (Python uses 64 bits as default for floating point type variables), that is +!bc pycod +import numpy as np +x = np.log(np.array([4.0, 7.0, 8.0]) +print(x) +!ec +To check the number of bytes (remember that one byte contains eight bits for double precision variables), you can use simple use the _itemsize_ functionality (the array $x$ is actually an object which inherits the functionalities defined in Numpy) as +!bc pycod +import numpy as np +x = np.log(np.array([4.0, 7.0, 8.0]) +print(x.itemsize) +!ec + + +===== Matrices in Python ===== + +Having defined vectors, we are now ready to try out matrices. We can +define a $3 \times 3 $ real matrix $\hat{A}$ as (recall that we user +lowercase letters for vectors and uppercase letters for matrices) + +!bc pycod +import numpy as np +A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ])) +print(A) +!ec +If we use the _shape_ function we would get $(3, 3)$ as output, that is verifying that our matrix is a $3\times 3$ matrix. We can slice the matrix and print for example the first column (Python organized matrix elements in a row-major order, see below) as +!bc pycod +import numpy as np +A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ])) +# print the first column, row-major order and elements start with 0 +print(A[:,0]) +!ec +We can continue this was by printing out other columns or rows. The example here prints out the second column +!bc pycod +import numpy as np +A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ])) +# print the first column, row-major order and elements start with 0 +print(A[1,:]) +!ec +Numpy contains many other functionalities that allow us to slice, subdivide etc etc arrays. We strongly recommend that you look up the "Numpy website for more details":"http://www.numpy.org/". Useful functions when defining a matrix are the _np.zeros_ function which declares a matrix of a given dimension and sets all elements to zero +!bc pycod +import numpy as np +n = 10 +# define a matrix of dimension 10 x 10 and set all elements to zero +A = np.zeros( (n, n) ) +print(A) +!ec +or initializing all elements to +!bc pycod +import numpy as np +n = 10 +# define a matrix of dimension 10 x 10 and set all elements to one +A = np.ones( (n, n) ) +print(A) +!ec +or as unitarily distributed random numbers (see the material on random number generators in the statistics part) +!bc pycod +import numpy as np +n = 10 +# define a matrix of dimension 10 x 10 and set all elements to random numbers with x \in [0, 1] +A = np.random.rand(n, n) +print(A) +!ec + +As we will see throughout these lectures, there are several extremely useful functionalities in Numpy. +As an example, consider the discussion of the covariance matrix. Suppose we have defined three vectors +$\hat{x}, \hat{y}, \hat{z}$ with $n$ elements each. The covariance matrix is defined as +!bt +\[ +\hat{\Sigma} = \begin{bmatrix} \sigma_{xx} & \sigma_{xy} & \sigma_{xz} \\ + \sigma_{yx} & \sigma_{yy} & \sigma_{yz} \\ + \sigma_{zx} & \sigma_{zy} & \sigma_{zz} + \end{bmatrix}, +\] +!et +where for example +!bt +\[ +\sigma_{xy} =\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})(y_i- \overline{y}). +\] +!et +The Numpy function _np.cov_ calculates the covariance elements using the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have the exact mean values. +The following simple function uses the _np.vstack_ function which takes each vector of dimension $1\times n$ and produces a $3\times n$ matrix $\hat{W}$ +!bt +\[ +\hat{W} = \begin{bmatrix} x_0 & y_0 & z_0 \\ + x_1 & y_1 & z_1 \\ + x_2 & y_2 & z_2 \\ + \dots & \dots & \dots \\ + x_{n-2} & y_{n-2} & z_{n-2} \\ + x_{n-1} & y_{n-1} & z_{n-1} + \end{bmatrix}, +\] +!et + +which in turn is converted into into the $3\times 3$ covariance matrix +$\hat{\Sigma}$ via the Numpy function _np.cov()_. We note that we can also calculate +the mean value of each set of samples $\hat{x}$ etc using the Numpy +function _np.mean(x)_. We can also extract the eigenvalues of the +covariance matrix through the _np.linalg.eig()_ function. + +!bc pycod +# Importing various packages +import numpy as np + +n = 100 +x = np.random.normal(size=n) +print(np.mean(x)) +y = 4+3*x+np.random.normal(size=n) +print(np.mean(y)) +z = x**3+np.random.normal(size=n) +print(np.mean(z)) +W = np.vstack((x, y, z)) +Sigma = np.cov(W) +print(Sigma) +Eigvals, Eigvecs = np.linalg.eig(Sigma) +print(Eigvals) +!ec + + +!bc pycod +import numpy as np +import matplotlib.pyplot as plt +from scipy import sparse +eye = np.eye(4) +print(eye) +sparse_mtx = sparse.csr_matrix(eye) +print(sparse_mtx) +x = np.linspace(-10,10,100) +y = np.sin(x) +plt.plot(x,y,marker='x') +plt.show() +!ec + + +===== Meet the Pandas ===== + + +FIGURE: [fig/pandas.jpg, width=600 frac=0.8] + +Another useful Python package is +"pandas":"https://pandas.pydata.org/", which is an open source library +providing high-performance, easy-to-use data structures and data +analysis tools for Python. _pandas_ stands for panel data, a term borrowed from econometrics and is an efficient library for data analysis with an emphasis on tabular data. +_pandas_ has two major classes, the _DataFrame_ class with two-dimensional data objects and tabular data organized in columns and the class _Series_ with a focus on one-dimensional data objects. Both classes allow you to index data easily as we will see in the examples below. +_pandas_ allows you also to perform mathematical operations on the data, spanning from simple reshapings of vectors and matrices to statistical operations. + +The following simple example shows how we can, in an easy way make tables of our data. Here we define a data set which includes names, place of birth and date of birth, and displays the data in an easy to read way. We will see repeated use of _pandas_, in particular in connection with classification of data. + +!bc pycod +import pandas as pd +from IPython.display import display +data = {'First Name': ["Frodo", "Bilbo", "Aragorn II", "Samwise"], + 'Last Name': ["Baggins", "Baggins","Elessar","Gamgee"], + 'Place of birth': ["Shire", "Shire", "Eriador", "Shire"], + 'Date of Birth T.A.': [2968, 2890, 2931, 2980] + } +data_pandas = pd.DataFrame(data) +display(data_pandas) +!ec + +In the above we have imported _pandas_ with the shorthand _pd_, the latter has become the standard way we import _pandas_. We make then a list of various variables +and reorganize the aboves lists into a _DataFrame_ and then print out a neat table with specific column labels as *Name*, *place of birth* and *date of birth*. +Displaying these results, we see that the indices are given by the default numbers from zero to three. +_pandas_ is extremely flexible and we can easily change the above indices by defining a new type of indexing as +!bc pycod +data_pandas = pd.DataFrame(data,index=['Frodo','Bilbo','Aragorn','Sam']) +display(data_pandas) +!ec +Thereafter we display the content of the row which begins with the index _Aragorn_ +!bc pycod +display(data_pandas.loc['Aragorn']) +!ec + +We can easily append data to this, for example +!bc pycod +new_hobbit = {'First Name': ["Peregrin"], + 'Last Name': ["Took"], + 'Place of birth': ["Shire"], + 'Date of Birth T.A.': [2990] + } +data_pandas=data_pandas.append(pd.DataFrame(new_hobbit, index=['Pippin'])) +display(data_pandas) +!ec + + +Here are other examples where we use the _DataFrame_ functionality to handle arrays, now with more interesting features for us, namely numbers. We set up a matrix +of dimensionality $10\times 5$ and compute the mean value and standard deviation of each column. Similarly, we can perform mathematial operations like squaring the matrix elements and many other operations. +!bc pycod +import numpy as np +import pandas as pd +from IPython.display import display +np.random.seed(100) +# setting up a 10 x 5 matrix +rows = 10 +cols = 5 +a = np.random.randn(rows,cols) +df = pd.DataFrame(a) +display(df) +print(df.mean()) +print(df.std()) +display(df**2) +!ec + +Thereafter we can select specific columns only and plot final results +!bc pycod +df.columns = ['First', 'Second', 'Third', 'Fourth', 'Fifth'] +df.index = np.arange(10) + +display(df) +print(df['Second'].mean() ) +print(df.info()) +print(df.describe()) + +from pylab import plt, mpl +plt.style.use('seaborn') +mpl.rcParams['font.family'] = 'serif' + +df.cumsum().plot(lw=2.0, figsize=(10,6)) +plt.show() + + +df.plot.bar(figsize=(10,6), rot=15) +plt.show() +!ec +We can produce a $4\times 4$ matrix +!bc pycod +b = np.arange(16).reshape((4,4)) +print(b) +df1 = pd.DataFrame(b) +print(df1) +!ec +and many other operations. + +The _Series_ class is another important class included in +_pandas_. You can view it as a specialization of _DataFrame_ but where +we have just a single column of data. It shares many of the same features as _DataFrame. As with _DataFrame_, +most operations are vectorized, achieving thereby a high performance when dealing with computations of arrays, in particular labeled arrays. +As we will see below it leads also to a very concice code close to the mathematical operations we may be interested in. +For multidimensional arrays, we recommend strongly "xarray":"http://xarray.pydata.org/en/stable/". _xarray_ has much of the same flexibility as _pandas_, but allows for the extension to higher dimensions than two. We will see examples later of the usage of both _pandas_ and _xarray_. + + + +===== Reading Data and fitting ===== + +In order to study various Machine Learning algorithms, we need to +access data. Acccessing data is an essential step in all machine +learning algorithms. In particular, setting up the so-called _design +matrix_ (to be defined below) is often the first element we need in +order to perform our calculations. To set up the design matrix means +reading (and later, when the calculations are done, writing) data +in various formats, The formats span from reading files from disk, +loading data from databases and interacting with online sources +like web application programming interfaces (APIs). + +In handling various input formats, as discussed above, we will mainly stay with _pandas_, +a Python package which allows us, in a seamless and painless way, to +deal with a multitude of formats, from standard _csv_ (comma separated +values) files, via _excel_, _html_ to _hdf5_ formats. With _pandas_ +and the _DataFrame_ and _Series_ functionalities we are able to convert text data +into the calculational formats we need for a specific algorithm. And our code is going to be +pretty close the basic mathematical expressions. + +Our first data set is going to be a classic from nuclear physics, namely all +available data on binding energies. Don't be intimidated if you are not familiar with nuclear physics. It serves simply as an example here of a data set. + +We will show some of the +strengths of packages like _Scikit-Learn_ in fitting nuclear binding energies to +specific functions using linear regression first. Then, as a teaser, we will show you how +you can easily implement other algorithms like decision trees and random forests and neural networks. + +But before we really start with nuclear physics data, let's just look at some simpler polynomial fitting cases, such as, +(don't be offended) fitting straight lines! + + +=== Simple linear regression model using _scikit-learn_ === + +We start with perhaps our simplest possible example, using _Scikit-Learn_ to perform linear regression analysis on a data set produced by us. + +What follows is a simple Python code where we have defined a function +$y$ in terms of the variable $x$. Both are defined as vectors with $100$ entries. +The numbers in the vector $\hat{x}$ are given +by random numbers generated with a uniform distribution with entries +$x_i \in [0,1]$ (more about probability distribution functions +later). These values are then used to define a function $y(x)$ +(tabulated again as a vector) with a linear dependence on $x$ plus a +random noise added via the normal distribution. + + +The Numpy functions are imported used the _import numpy as np_ +statement and the random number generator for the uniform distribution +is called using the function _np.random.rand()_, where we specificy +that we want $100$ random variables. Using Numpy we define +automatically an array with the specified number of elements, $100$ in +our case. With the Numpy function _randn()_ we can compute random +numbers with the normal distribution (mean value $\mu$ equal to zero and +variance $\sigma^2$ set to one) and produce the values of $y$ assuming a linear +dependence as function of $x$ + +!bt +\[ +y = 2x+N(0,1), +\] +!et + +where $N(0,1)$ represents random numbers generated by the normal +distribution. From _Scikit-Learn_ we import then the +_LinearRegression_ functionality and make a prediction $\tilde{y} = +\alpha + \beta x$ using the function _fit(x,y)_. We call the set of +data $(\hat{x},\hat{y})$ for our training data. The Python package +_scikit-learn_ has also a functionality which extracts the above +fitting parameters $\alpha$ and $\beta$ (see below). Later we will +distinguish between training data and test data. + +For plotting we use the Python package +"matplotlib":"https://matplotlib.org/" which produces publication +quality figures. Feel free to explore the extensive +"gallery":"https://matplotlib.org/gallery/index.html" of examples. In +this example we plot our original values of $x$ and $y$ as well as the +prediction _ypredict_ ($\tilde{y}$), which attempts at fitting our +data with a straight line. + +The Python code follows here. +!bc pycod +# Importing various packages +import numpy as np +import matplotlib.pyplot as plt +from sklearn.linear_model import LinearRegression + +x = np.random.rand(100,1) +y = 2*x+np.random.randn(100,1) +linreg = LinearRegression() +linreg.fit(x,y) +xnew = np.array([[0],[1]]) +ypredict = linreg.predict(xnew) + +plt.plot(xnew, ypredict, "r-") +plt.plot(x, y ,'ro') +plt.axis([0,1.0,0, 5.0]) +plt.xlabel(r'$x$') +plt.ylabel(r'$y$') +plt.title(r'Simple Linear Regression') +plt.show() +!ec + +This example serves several aims. It allows us to demonstrate several +aspects of data analysis and later machine learning algorithms. The +immediate visualization shows that our linear fit is not +impressive. It goes through the data points, but there are many +outliers which are not reproduced by our linear regression. We could +now play around with this small program and change for example the +factor in front of $x$ and the normal distribution. Try to change the +function $y$ to + +!bt +\[ +y = 10x+0.01 \times N(0,1), +\] +!et + +where $x$ is defined as before. Does the fit look better? Indeed, by +reducing the role of the noise given by the normal distribution we see immediately that +our linear prediction seemingly reproduces better the training +set. However, this testing 'by the eye' is obviouly not satisfactory in the +long run. Here we have only defined the training data and our model, and +have not discussed a more rigorous approach to the _cost_ function. + +We need more rigorous criteria in defining whether we have succeeded or +not in modeling our training data. You will be surprised to see that +many scientists seldomly venture beyond this 'by the eye' approach. A +standard approach for the *cost* function is the so-called $\chi^2$ +function (a variant of the mean-squared error (MSE)) + +!bt +\[ \chi^2 = \frac{1}{n} +\sum_{i=0}^{n-1}\frac{(y_i-\tilde{y}_i)^2}{\sigma_i^2}, +\] +!et + +where $\sigma_i^2$ is the variance (to be defined later) of the entry +$y_i$. We may not know the explicit value of $\sigma_i^2$, it serves +however the aim of scaling the equations and make the cost function +dimensionless. + +Minimizing the cost function is a central aspect of +our discussions to come. Finding its minima as function of the model +parameters ($\alpha$ and $\beta$ in our case) will be a recurring +theme in these series of lectures. Essentially all machine learning +algorithms we will discuss center around the minimization of the +chosen cost function. This depends in turn on our specific +model for describing the data, a typical situation in supervised +learning. Automatizing the search for the minima of the cost function is a +central ingredient in all algorithms. Typical methods which are +employed are various variants of _gradient_ methods. These will be +discussed in more detail later. Again, you'll be surprised to hear that +many practitioners minimize the above function ''by the eye', popularly dubbed as +'chi by the eye'. That is, change a parameter and see (visually and numerically) that +the $\chi^2$ function becomes smaller. + +There are many ways to define the cost function. A simpler approach is to look at the relative difference between the training data and the predicted data, that is we define +the relative error (why would we prefer the MSE instead of the relative error?) as + +!bt +\[ +\epsilon_{\mathrm{relative}}= \frac{\vert \hat{y} -\hat{\tilde{y}}\vert}{\vert \hat{y}\vert}. +\] +!et + +The squared cost function results in an arithmetic mean-unbiased +estimator, and the absolute-value cost function results in a +median-unbiased estimator (in the one-dimensional case, and a +geometric median-unbiased estimator for the multi-dimensional +case). The squared cost function has the disadvantage that it has the tendency +to be dominated by outliers. + +We can modify easily the above Python code and plot the relative error instead +!bc pycod +import numpy as np +import matplotlib.pyplot as plt +from sklearn.linear_model import LinearRegression + +x = np.random.rand(100,1) +y = 5*x+0.01*np.random.randn(100,1) +linreg = LinearRegression() +linreg.fit(x,y) +ypredict = linreg.predict(x) + +plt.plot(x, np.abs(ypredict-y)/abs(y), "ro") +plt.axis([0,1.0,0.0, 0.5]) +plt.xlabel(r'$x$') +plt.ylabel(r'$\epsilon_{\mathrm{relative}}$') +plt.title(r'Relative error') +plt.show() +!ec + +Depending on the parameter in front of the normal distribution, we may +have a small or larger relative error. Try to play around with +different training data sets and study (graphically) the value of the +relative error. + +As mentioned above, _Scikit-Learn_ has an impressive functionality. +We can for example extract the values of $\alpha$ and $\beta$ and +their error estimates, or the variance and standard deviation and many +other properties from the statistical data analysis. + +Here we show an +example of the functionality of _Scikit-Learn_. +!bc pycod +import numpy as np +import matplotlib.pyplot as plt +from sklearn.linear_model import LinearRegression +from sklearn.metrics import mean_squared_error, r2_score, mean_squared_log_error, mean_absolute_error + +x = np.random.rand(100,1) +y = 2.0+ 5*x+0.5*np.random.randn(100,1) +linreg = LinearRegression() +linreg.fit(x,y) +ypredict = linreg.predict(x) +print('The intercept alpha: \n', linreg.intercept_) +print('Coefficient beta : \n', linreg.coef_) +# The mean squared error +print("Mean squared error: %.2f" % mean_squared_error(y, ypredict)) +# Explained variance score: 1 is perfect prediction +print('Variance score: %.2f' % r2_score(y, ypredict)) +# Mean squared log error +print('Mean squared log error: %.2f' % mean_squared_log_error(y, ypredict) ) +# Mean absolute error +print('Mean absolute error: %.2f' % mean_absolute_error(y, ypredict)) +plt.plot(x, ypredict, "r-") +plt.plot(x, y ,'ro') +plt.axis([0.0,1.0,1.5, 7.0]) +plt.xlabel(r'$x$') +plt.ylabel(r'$y$') +plt.title(r'Linear Regression fit ') +plt.show() + +!ec +The function _coef_ gives us the parameter $\beta$ of our fit while _intercept_ yields +$\alpha$. Depending on the constant in front of the normal distribution, we get values near or far from $alpha =2$ and $\beta =5$. Try to play around with different parameters in front of the normal distribution. The function _meansquarederror_ gives us the mean square error, a risk metric corresponding to the expected value of the squared (quadratic) error or loss defined as +!bt +\[ MSE(\hat{y},\hat{\tilde{y}}) = \frac{1}{n} +\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2, +\] +!et + +The smaller the value, the better the fit. Ideally we would like to +have an MSE equal zero. The attentive reader has probably recognized +this function as being similar to the $\chi^2$ function defined above. + +The _r2score_ function computes $R^2$, the coefficient of +determination. It provides a measure of how well future samples are +likely to be predicted by the model. Best possible score is 1.0 and it +can be negative (because the model can be arbitrarily worse). A +constant model that always predicts the expected value of $\hat{y}$, +disregarding the input features, would get a $R^2$ score of $0.0$. + +If $\tilde{\hat{y}}_i$ is the predicted value of the $i-th$ sample and $y_i$ is the corresponding true value, then the score $R^2$ is defined as +!bt +\[ +R^2(\hat{y}, \tilde{\hat{y}}) = 1 - \frac{\sum_{i=0}^{n - 1} (y_i - \tilde{y}_i)^2}{\sum_{i=0}^{n - 1} (y_i - \bar{y})^2}, +\] +!et +where we have defined the mean value of $\hat{y}$ as +!bt +\[ +\bar{y} = \frac{1}{n} \sum_{i=0}^{n - 1} y_i. +\] +!et +Another quantity taht we will meet again in our discussions of regression analysis is + the mean absolute error (MAE), a risk metric corresponding to the expected value of the absolute error loss or what we call the $l1$-norm loss. In our discussion above we presented the relative error. +The MAE is defined as follows +!bt +\[ +\text{MAE}(\hat{y}, \hat{\tilde{y}}) = \frac{1}{n} \sum_{i=0}^{n-1} \left| y_i - \tilde{y}_i \right|. +\] +!et +We present the +squared logarithmic (quadratic) error +!bt +\[ +\text{MSLE}(\hat{y}, \hat{\tilde{y}}) = \frac{1}{n} \sum_{i=0}^{n - 1} (\log_e (1 + y_i) - \log_e (1 + \tilde{y}_i) )^2, +\] +!et + +where $\log_e (x)$ stands for the natural logarithm of $x$. This error +estimate is best to use when targets having exponential growth, such +as population counts, average sales of a commodity over a span of +years etc. + + +Finally, another cost function is the Huber cost function used in robust regression. + +The rationale behind this possible cost function is its reduced +sensitivity to outliers in the data set. In our discussions on +dimensionality reduction and normalization of data we will meet other +ways of dealing with outliers. + +The Huber cost function is defined as +!bt +\[ +H_{\delta}(a)={\begin{cases}{\frac {1}{2}}{a^{2}}&{\text{for }}|a|\leq \delta ,\\\delta (|a|-{\frac {1}{2}}\delta ),&{\text{otherwise.}}\end{cases}}}. +\] +!et +Here $a=\bm{y} - \bm{\tilde{y}}$. +We will discuss in more +detail these and other functions in the various lectures. We conclude this part with another example. Instead of +a linear $x$-dependence we study now a cubic polynomial and use the polynomial regression analysis tools of scikit-learn. + +!bc pycod +import matplotlib.pyplot as plt +import numpy as np +import random +from sklearn.linear_model import Ridge +from sklearn.preprocessing import PolynomialFeatures +from sklearn.pipeline import make_pipeline +from sklearn.linear_model import LinearRegression + +x=np.linspace(0.02,0.98,200) +noise = np.asarray(random.sample((range(200)),200)) +y=x**3*noise +yn=x**3*100 +poly3 = PolynomialFeatures(degree=3) +X = poly3.fit_transform(x[:,np.newaxis]) +clf3 = LinearRegression() +clf3.fit(X,y) + +Xplot=poly3.fit_transform(x[:,np.newaxis]) +poly3_plot=plt.plot(x, clf3.predict(Xplot), label='Cubic Fit') +plt.plot(x,yn, color='red', label="True Cubic") +plt.scatter(x, y, label='Data', color='orange', s=15) +plt.legend() +plt.show() + +def error(a): + for i in y: + err=(y-yn)/yn + return abs(np.sum(err))/len(err) + +print (error(y)) +!ec + + + + +=== To our real data: nuclear binding energies. Brief reminder on masses and binding energies === + +Let us now dive into nuclear physics and remind ourselves briefly about some basic features about binding +energies. A basic quantity which can be measured for the ground +states of nuclei is the atomic mass $M(N, Z)$ of the neutral atom with +atomic mass number $A$ and charge $Z$. The number of neutrons is $N$. There are indeed several sophisticated experiments worldwide which allow us to measure this quantity to high precision (parts per million even). + +Atomic masses are usually tabulated in terms of the mass excess defined by +!bt +\[ +\Delta M(N, Z) = M(N, Z) - uA, +\] +!et +where $u$ is the Atomic Mass Unit +!bt +\[ +u = M(^{12}\mathrm{C})/12 = 931.4940954(57) \hspace{0.1cm} \mathrm{MeV}/c^2. +\] +!et +The nucleon masses are +!bt +\[ +m_p = 1.00727646693(9)u, +\] +!et +and +!bt +\[ +m_n = 939.56536(8)\hspace{0.1cm} \mathrm{MeV}/c^2 = 1.0086649156(6)u. +\] +!et + +In the "2016 mass evaluation of by W.J.Huang, G.Audi, M.Wang, F.G.Kondev, S.Naimi and X.Xu":"http://nuclearmasses.org/resources_folder/Wang_2017_Chinese_Phys_C_41_030003.pdf" +there are data on masses and decays of 3437 nuclei. + +The nuclear binding energy is defined as the energy required to break +up a given nucleus into its constituent parts of $N$ neutrons and $Z$ +protons. In terms of the atomic masses $M(N, Z)$ the binding energy is +defined by + + +!bt +\[ +BE(N, Z) = ZM_H c^2 + Nm_n c^2 - M(N, Z)c^2 , +\] +!et +where $M_H$ is the mass of the hydrogen atom and $m_n$ is the mass of the neutron. +In terms of the mass excess the binding energy is given by +!bt +\[ +BE(N, Z) = Z\Delta_H c^2 + N\Delta_n c^2 -\Delta(N, Z)c^2 , +\] +!et +where $\Delta_H c^2 = 7.2890$ MeV and $\Delta_n c^2 = 8.0713$ MeV. + + +A popular and physically intuitive model which can be used to parametrize +the experimental binding energies as function of $A$, is the so-called +_liquid drop model_. The ansatz is based on the following expression + +!bt +\[ +BE(N,Z) = a_1A-a_2A^{2/3}-a_3\frac{Z^2}{A^{1/3}}-a_4\frac{(N-Z)^2}{A}, +\] +!et + +where $A$ stands for the number of nucleons and the $a_i$s are parameters which are determined by a fit +to the experimental data. + + + + +To arrive at the above expression we have assumed that we can make the following assumptions: + + * There is a volume term $a_1A$ proportional with the number of nucleons (the energy is also an extensive quantity). When an assembly of nucleons of the same size is packed together into the smallest volume, each interior nucleon has a certain number of other nucleons in contact with it. This contribution is proportional to the volume. + + * There is a surface energy term $a_2A^{2/3}$. The assumption here is that a nucleon at the surface of a nucleus interacts with fewer other nucleons than one in the interior of the nucleus and hence its binding energy is less. This surface energy term takes that into account and is therefore negative and is proportional to the surface area. + + + * There is a Coulomb energy term $a_3\frac{Z^2}{A^{1/3}}$. The electric repulsion between each pair of protons in a nucleus yields less binding. + + * There is an asymmetry term $a_4\frac{(N-Z)^2}{A}$. This term is associated with the Pauli exclusion principle and reflects the fact that the proton-neutron interaction is more attractive on the average than the neutron-neutron and proton-proton interactions. + +We could also add a so-called pairing term, which is a correction term that +arises from the tendency of proton pairs and neutron pairs to +occur. An even number of particles is more stable than an odd number. + + +=== Organizing our data === + +Let us start with reading and organizing our data. +We start with the compilation of masses and binding energies from 2016. +After having downloaded this file to our own computer, we are now ready to read the file and start structuring our data. + + +We start with preparing folders for storing our calculations and the data file over masses and binding energies. We import also various modules that we will find useful in order to present various Machine Learning methods. Here we focus mainly on the functionality of _scikit-learn_. +!bc pycod +# Common imports +import numpy as np +import pandas as pd +import matplotlib.pyplot as plt +import sklearn.linear_model as skl +from sklearn.model_selection import train_test_split +from sklearn.metrics import mean_squared_error, r2_score, mean_absolute_error +import os + +# Where to save the figures and data files +PROJECT_ROOT_DIR = "Results" +FIGURE_ID = "Results/FigureFiles" +DATA_ID = "DataFiles/" + +if not os.path.exists(PROJECT_ROOT_DIR): + os.mkdir(PROJECT_ROOT_DIR) + +if not os.path.exists(FIGURE_ID): + os.makedirs(FIGURE_ID) + +if not os.path.exists(DATA_ID): + os.makedirs(DATA_ID) + +def image_path(fig_id): + return os.path.join(FIGURE_ID, fig_id) + +def data_path(dat_id): + return os.path.join(DATA_ID, dat_id) + +def save_fig(fig_id): + plt.savefig(image_path(fig_id) + ".png", format='png') + +infile = open(data_path("MassEval2016.dat"),'r') +!ec + + +Before we proceed, we define also a function for making our plots. You can obviously avoid this and simply set up various _matplotlib_ commands every time you need them. You may however find it convenient to collect all such commands in one function and simply call this function. +!bc pycod +from pylab import plt, mpl +plt.style.use('seaborn') +mpl.rcParams['font.family'] = 'serif' + +def MakePlot(x,y, styles, labels, axlabels): + plt.figure(figsize=(10,6)) + for i in range(len(x)): + plt.plot(x[i], y[i], styles[i], label = labels[i]) + plt.xlabel(axlabels[0]) + plt.ylabel(axlabels[1]) + plt.legend(loc=0) +!ec + +Our next step is to read the data on experimental binding energies and +reorganize them as functions of the mass number $A$, the number of +protons $Z$ and neutrons $N$ using _pandas_. Before we do this it is +always useful (unless you have a binary file or other types of compressed +data) to actually open the file and simply take a look at it! + + +In particular, the program that outputs the final nuclear masses is written in Fortran with a specific format. It means that we need to figure out the format and which columns contain the data we are interested in. Pandas comes with a function that reads formatted output. After having admired the file, we are now ready to start massaging it with _pandas_. The file begins with some basic format information. +!bc pycod +""" +This is taken from the data file of the mass 2016 evaluation. +All files are 3436 lines long with 124 character per line. + Headers are 39 lines long. + col 1 : Fortran character control: 1 = page feed 0 = line feed + format : a1,i3,i5,i5,i5,1x,a3,a4,1x,f13.5,f11.5,f11.3,f9.3,1x,a2,f11.3,f9.3,1x,i3,1x,f12.5,f11.5 + These formats are reflected in the pandas widths variable below, see the statement + widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1), + Pandas has also a variable header, with length 39 in this case. +""" +!ec + +The data we are interested in are in columns 2, 3, 4 and 11, giving us +the number of neutrons, protons, mass numbers and binding energies, +respectively. We add also for the sake of completeness the element name. The data are in fixed-width formatted lines and we will +covert them into the _pandas_ DataFrame structure. + +!bc pycod +# Read the experimental data with Pandas +Masses = pd.read_fwf(infile, usecols=(2,3,4,6,11), + names=('N', 'Z', 'A', 'Element', 'Ebinding'), + widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1), + header=39, + index_col=False) + +# Extrapolated values are indicated by '#' in place of the decimal place, so +# the Ebinding column won't be numeric. Coerce to float and drop these entries. +Masses['Ebinding'] = pd.to_numeric(Masses['Ebinding'], errors='coerce') +Masses = Masses.dropna() +# Convert from keV to MeV. +Masses['Ebinding'] /= 1000 + +# Group the DataFrame by nucleon number, A. +Masses = Masses.groupby('A') +# Find the rows of the grouped DataFrame with the maximum binding energy. +Masses = Masses.apply(lambda t: t[t.Ebinding==t.Ebinding.max()]) +!ec + +We have now read in the data, grouped them according to the variables we are interested in. +We see how easy it is to reorganize the data using _pandas_. If we +were to do these operations in C/C++ or Fortran, we would have had to +write various functions/subroutines which perform the above +reorganizations for us. Having reorganized the data, we can now start +to make some simple fits using both the functionalities in _numpy_ and +_Scikit-Learn_ afterwards. + +Now we define five variables which contain +the number of nucleons $A$, the number of protons $Z$ and the number of neutrons $N$, the element name and finally the energies themselves. +!bc pycod +A = Masses['A'] +Z = Masses['Z'] +N = Masses['N'] +Element = Masses['Element'] +Energies = Masses['Ebinding'] +print(Masses) +!ec +The next step, and we will define this mathematically later, is to set up the so-called _design matrix_. We will throughout call this matrix $\bm{X}$. +It has dimensionality $p\times n$, where $n$ is the number of data points and $p$ are the so-called predictors. In our case here they are given by the number of polynomials in $A$ we wish to include in the fit. +!bc pycod +# Now we set up the design matrix X +X = np.zeros((len(A),5)) +X[:,0] = 1 +X[:,1] = A +X[:,2] = A**(2.0/3.0) +X[:,3] = A**(-1.0/3.0) +X[:,4] = A**(-1.0) +!ec +With _scikitlearn_ we are now ready to use linear regression and fit our data. +!bc pycod +clf = skl.LinearRegression().fit(X, Energies) +fity = clf.predict(X) +!ec +Pretty simple! +Now we can print measures of how our fit is doing, the coefficients from the fits and plot the final fit together with our data. +!bc pycod +# The mean squared error +print("Mean squared error: %.2f" % mean_squared_error(Energies, fity)) +# Explained variance score: 1 is perfect prediction +print('Variance score: %.2f' % r2_score(Energies, fity)) +# Mean absolute error +print('Mean absolute error: %.2f' % mean_absolute_error(Energies, fity)) +print(clf.coef_, clf.intercept_) + +Masses['Eapprox'] = fity +# Generate a plot comparing the experimental with the fitted values values. +fig, ax = plt.subplots() +ax.set_xlabel(r'$A = N + Z$') +ax.set_ylabel(r'$E_\mathrm{bind}\,/\mathrm{MeV}$') +ax.plot(Masses['A'], Masses['Ebinding'], alpha=0.7, lw=2, + label='Ame2016') +ax.plot(Masses['A'], Masses['Eapprox'], alpha=0.7, lw=2, c='m', + label='Fit') +ax.legend() +save_fig("Masses2016") +plt.show() +!ec + + +=== Seeing the wood for the trees === + +As a teaser, let us now see how we can do this with decision trees using _scikit-learn_. Later we will switch to so-called _random forests_! + + +!bc pycod + +#Decision Tree Regression +from sklearn.tree import DecisionTreeRegressor +regr_1=DecisionTreeRegressor(max_depth=5) +regr_2=DecisionTreeRegressor(max_depth=7) +regr_3=DecisionTreeRegressor(max_depth=9) +regr_1.fit(X, Energies) +regr_2.fit(X, Energies) +regr_3.fit(X, Energies) + + +y_1 = regr_1.predict(X) +y_2 = regr_2.predict(X) +y_3=regr_3.predict(X) +Masses['Eapprox'] = y_3 +# Plot the results +plt.figure() +plt.plot(A, Energies, color="blue", label="Data", linewidth=2) +plt.plot(A, y_1, color="red", label="max_depth=5", linewidth=2) +plt.plot(A, y_2, color="green", label="max_depth=7", linewidth=2) +plt.plot(A, y_3, color="m", label="max_depth=9", linewidth=2) + +plt.xlabel("$A$") +plt.ylabel("$E$[MeV]") +plt.title("Decision Tree Regression") +plt.legend() +save_fig("Masses2016Trees") +plt.show() +print(Masses) +print(np.mean( (Energies-y_1)**2)) +!ec + + +=== And what about using neural networks? === +The _seaborn_ package allows us to visualize data in an efficient way. Note that we use _scikit-learn_'s multi-layer perceptron (or feed forward neural network) +functionality. +!bc pycod +from sklearn.neural_network import MLPRegressor +from sklearn.metrics import accuracy_score +import seaborn as sns + +X_train = X +Y_train = Energies +n_hidden_neurons = 100 +epochs = 100 +# store models for later use +eta_vals = np.logspace(-5, 1, 7) +lmbd_vals = np.logspace(-5, 1, 7) +# store the models for later use +DNN_scikit = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object) +train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) +sns.set() +for i, eta in enumerate(eta_vals): + for j, lmbd in enumerate(lmbd_vals): + dnn = MLPRegressor(hidden_layer_sizes=(n_hidden_neurons), activation='logistic', + alpha=lmbd, learning_rate_init=eta, max_iter=epochs) + dnn.fit(X_train, Y_train) + DNN_scikit[i][j] = dnn + train_accuracy[i][j] = dnn.score(X_train, Y_train) + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Training Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() + + + +!ec + + + + + + +===== A first summary ===== + +The aim behind these introductory words was to present to you various +Python libraries and their functionalities, in particular libraries like +_numpy_, _pandas_, _xarray_ and _matplotlib_ and other that make our life much easier +in handling various data sets and visualizing data. + +Furthermore, +_Scikit-Learn_ allows us with few lines of code to implement popular +Machine Learning algorithms for supervised learning. Later we will meet _Tensorflow_, a powerful library for deep learning. +Now it is time to dive more into the details of various methods. We will start with linear regression and try to take a deeper look at what it entails. + + + + diff --git a/doc/src/How2ReadData/ipynb-chapter3-src.tar.gz b/doc/src/How2ReadData/ipynb-chapter3-src.tar.gz new file mode 100644 index 0000000000000000000000000000000000000000..8c86eb35e4d0b18955381c2484d465c3483bc93f GIT binary patch literal 103631 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 z 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 literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/.doctrees/chapter1.doctree b/doc/src/LectureNotes/_build/.doctrees/chapter1.doctree index 8d4ccb3c74d7c4541a8854d35703e1ef0f3ea839..f4bd7cfe653977fcc6ca4c3d5677be21749b475c 100644 GIT binary patch delta 135 zcmX>#o9)AFwuUK;JdAg?@-p@`OZxS2BxfWRl%y7!PidQi;8{$c*378Sp7mCMfg$Vt z^h3>z6Bxg44{l*R!^~*0U7>?Mhiyv?e#s3-i!c(DJl;D delta 115 zcmew`o9)zWwuUK;JdE46@-p@`Pv6?is5AX_Gh;8~$L*CZjAxh`O}4vrFwSRY;}c|H z$l{*b NU}WCDw1?4~5dh|sBwGLg diff --git a/doc/src/LectureNotes/_build/.doctrees/chapter2.doctree b/doc/src/LectureNotes/_build/.doctrees/chapter2.doctree index 2756e838f6c2df5b5d4eb4204c5c7c868c09e20a..3610d279283d1fa81fb908b9e97e4630c9837902 100644 GIT binary patch delta 20310 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 e7tQ|3OuzrS(xgK&6$BBu{yhEu=Re~HP> delta 20218 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 F{{vhPZWaIl delta 17116 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 OfBF31fBWmdboqaM2j?IF diff --git a/doc/src/LectureNotes/_build/.doctrees/chapter7.doctree b/doc/src/LectureNotes/_build/.doctrees/chapter7.doctree new file mode 100644 index 0000000000000000000000000000000000000000..4ecf61ac36107db2250037600570f14fae62f8ce GIT binary patch literal 384974 zcmeFa*{8`uj-;$oON`yHCCOU2gri-#@w@ z{>krh)7w8SEErbvefZa{ZM}VEHBA-SZ3ELXO~XHl+!}`b_RpNes%v-?uKy&n(&wu` zciZCQ3)^yTmFG`w+P8n!Si$ts_u*f?{o@1%`@Q(@|J~a^eLtleRI9zJM#I?4YA-`o z?=d9-%3sgFJgWkUQy2=Xg4UIT9$?nm%9C>F73zdm(RkJ3O;ik-{eAei;XiF{n6bZr zaaciR72%7SH~u$Ra^~r$r~m2oSr@;2is~op36^1aD)Qc|{5E;AGIx5Xwm?a|SMOHq z>EKyaHZ4@@HDT_4_2gKEWhdTK?mrc9V_v1xr_*4q>Is%P%d_VfuO71(`H=$>^X#jq z$_py5t{>Oa!@SPRp7ORyBCmRKz2;fF-aPG^se5@gJ>yjqdQWLyH_*?bP2dqJXm3(K zMcI3W`q0I%9z(FQVY)TSV7|P%@m#q4@o4HWZxi<^v^r=C&&!_RK~eS84 zOE5*1_X=jXiJa-t$?(*BN%B;;(Iggz{`Bb(r#W%*v`D=B6KK;@omxrq%Q_mNbzZ$n zJvVC8cduQmv1+fW-#nE6b@(@L|IN=_vhP1`g`X`76zom-N8vvS|6U5elt9(~=ItN7 z`uG6Y_CIdG{(P1B_=LBgL)uSt^4EpWeP0$>)*x`;BG&S+>uM z!F(oxzu#zn^&<`Yt+(-uA^aREzhA$1pUsB67{+H5`umOQKm0ZJ?4ud_buE7QJTLqg z;C93R7(l=i{C)wy{|bKpHMrF9b@)~IrTEYPF8q7gqTu!>s|4Hhm(Pd=-2T5)!9zG; zOP~6v37?uie^}{X*52eBCqwEVEtL9@8wuNkHFtyEH6C3znrY*Z(7EWYW`a_ z|6xylv(EpEU#s)RD*$+t_SjY(IZvqt{e^!brv@bhRP9b+WfzV4sRA2SAzDUrvwetSXxDW&IupT1lNlAKwA4 zj~MdR``bS5sKe)+lNZYPdF6s8eE*yF*AE*Izxx8c=>P9?_wUfl7dz*#f2b8Ndhz4W ze)NoAK&;eMc^15gX5Rkkvt~U9iGTCq<;VT^p~2sV|NF~{wf<4J^6$W{JiXsykNJL} zzkl`HXz+_s{dVntG}52I)9=>&#cZxW%SL(8+0P{K_Z!V$eB7`f*Y3reKa~2LE#!yg z`w=QIHeewy6CQZPalQBCMs))ox{c}(jAYY$5PODJ<-WIDQ$Skhe)H}%m>)1EuM%Je zz;=Q&s&cn=Ci4fae(6A52L@?s?>&O!32H!q3{AnX0=$5yIW15J?yHB_fAjQo`LqiU ztMR&(uAk~C12{5; zv-J}|pU|sbwGfQoJit9oXf*(g9{A@yH2PqiJ@6yY#vYz(06(w=ttbeaXXNwIys|%k zLSN|O=a2>}^Z&lw@jn%&{;&b_v)A;+AU=bz-(d_dOvCc`)~gr2{~1Dlzg}~nL#JO1 z;Pc4){l>ET99!$7A^a@jemIifY(oF_dk^^DguZ$oSiPrq|GoEby#0^1KY)Q?1s`_h zy=(sU4L*+Z*S87(HvSL5Y6BtrkNWMu0>AyscfF4P`fE{oq2Mz)X4;81m}DiUOpb*t+bQc>I8@A=m@b+^M4CJtqF>240}!H$X-< zfL6hV0&V!}5t05lY@BfLWYfV+_YutD!x_M2=KXXlc#seN2I$f1l^;Q*`hfG^-J00N zXNT~Jc;RkvH;ok~c?JE3dtv17f%YSYsSD4UNZ4o8J<;!0J^3eq^8?)R%zVC&QKz|> zqKd~9JVdp%6+Fn^Np9ga(?kGu`OzypqRyW^-7hxvXA%hN^aUuxZ*UJk)n+vf^zw>Bb_=@#sQNtG_`b+|U&Y1YmvngH->T^l_Iir%^Ma!RSkA5_}pIh=z zjPf@-8}y~wo;KzuMBe`c5E;^Kkdl0u^bcI?vY>q(0;?MrWybMP!LSNeB>Lj0T7=9B>+)(@S%MJK|HVuXJ826hIifi*!v&9 z^QIW4kxihiNSash`=)Y~iB71$`8(?lRwS_?)|-;ZfA{Uv*H1Y4gEn{IeQ!T(MEs!9 z@Y9W6y^1OTp?0eUghG{)zj?DZ=at2 zC3Z&D5C$HbP|LSS@FdaYf!Sfva_yb_;!B4;b;={E6>L&&TlkjeV-aumy%8-iYyN~ZV zx#xfP<$Fo65I-g3Su99;w`8A4djH-JBz>}6&r|oB-Ri!1 zeEcPde>c*X9ew}aJMpjn<7UHRJLx}qZ<78= z>rbWsRQrDRkp6CRUiSTy$(f!wN&lqv52XK42DFD6Ro`pqV@`iGdGE5dQ&racU^uTL zNK8Q#_t5jn1bEYwz0>+Ao9vPILi4}*=9f5h5B>qm0c(Lg+4#3#J$*C1`N@0Ve)$kK z&CqWtjF^NGp9*{T-aBE_g#4DmW|Oelr^4R72f|>gl!sq=a5NR9p?^46knMYTiRbk6 zYxpxcnXg~tV1Gz3mXj-*T+{2vj7`QLgNJ>1G0n*rw_iD^?r6f!9vgB#7AuR2c-1}r1b}+^&W8k{}*X}pyj3t`uHtyWB*vX^X*^U)8to= zB2zew^B|q84vyyhIaJ~WE#&3k5)OpGxr}T!mCDBd(?sn4ZTvrc;CJ6Mou8&u-@bBy zkNYl~2)XaAAJp5%|8~0jOYsZox#Twf@83yl?PoIYuO>22Zku1n<~_Ii=O0_K5Z5Mf zkmUtG`1a4ggM%L+VLCVS`t9Fj_H&pGjAG;2d48MDD1HC-pG~J2IID`38T3 zQL{NoQ{)p|E|=Jh#>j8Kef5u$4No9shSSSAO%cyRZ~~iw*r!PdF()W|Ih%yM3{YM_ z^9&Q;LtxmKznX;L_+q*rd$U+9a1x&{pWu>M()eOd!2RF1|M30WzxeKvD9*h8`~R`F z@!LB0LsAN2Xvw3H|$tfTDvxBtn1#y{6nPeA=?u_W#UO+VLu<4+6_rvLdT zeK*qo^%uX0bXGp~n6L?Q27aWo7Ou4bu1W{~S)W(T75;L}D!cn|!LVCtb=Hr&6%*`y zCcH({n@rN5`DBEP!y4{g-FGb3;0QW>#D&;N4>65crta1aom6A&3y(RQd*^QM#Wi9H z)7X#JW!Z`YIUM3$z1xJCyJhBwVcA@bQ*UpUn7v7&L%JNy0l93+VGoi6W}U2$`iacs z(RJ~=f%_;!yWVN9iJXRQ`Sn>iUq;?2;&9aWX1;0Xr=m@}+`iV5t=B{sS>kM!QT0%x zo64UF>E2AKdwvM}MZexrsJ{)4bbREHoA5*tED6^^5Qe)T>#f`KwHV-gF3=zEvnwhL&e`)d6X6tmz(9KzK49~6#^jId zh`)0|B0jEHd%mLhurG_#psjOWuyk1{^;ReiM8B1|>M68Doz82mEaq5QT!o8vobThi zc{&f2er^!OTG4}9+}YJ?wOOyFTd~Jn*}n4XkynDX$8hA@OZ1&_+Ye=u1-8fNIl~{B zjufSJG3&P{X4@V)H;59Uv^o-+sJOUl)`Dda47)5V(@7Du-;z7^f>Z>Fo@~Y! z2t33O!p05+U6QPjzPef8I+$Lfw}qtacF%KG7l)=_ly|MpU7Fbv#cV|i9joRYjxt*> z!3Bwt&rGVstmGc1Ux8cMdea6IzPzCx*izDg37 z?zd*zHr!nAqoC;(mq$>^<+V7t_>24Q-1+Crjouc4qE&ihgyeZ`3WpEtB@9ubmNw>H z=N+E70)ITD*VYobTb49@!(f`apmo$&W&VmP8~fsh(nCLj_`a4;xg(UCc4Lla#H)dH zoy&!;E_)GQBQt{)sj52DTz*|Ou$1Sz6$|x9KkE?7Qs?zt$<`#h4LlFmD_`|wTGkk} z(2sgy9&MT<`xVAk{;9dL`CUK9x2iD7wVbk>E2%x?oY?v0HcRB87eVm~CgcyL-i#OZ zoal#kQ8@u?&6fsa(#)LPsE!mDCx;Z-6T+-&hPf7p%jKp&>t)3C?fq`9EeltesFXB( zIA4J zcuWNMLPqpC->Ws42ffQef z;!f>X`;Ed2V<7G4jjiqA07g%CiYTLsW;7dGF_J}(X>Px0Ms87R$6Z0^nzdU`>&7i= z`?S`1$Kx2rEip@zrA@3~8-jEZ)NZbHsR`;h3@d4Uy4ewhxZ8zW;;UmWAdQbF!_qff zLr8qJ!h3|VmR^h5Y??+@r*sHxbKlOQh3d+B@*G zLxBrevY-)L>Y;yeM7eDML(aNxeY#%mAfG@owdj|6iCc*V%R7xH#0lu?HYCkWGQ*tk zB=X06cTj!53kU)YiAvMBrZV@(bDUe-{vNiy9}}3JVk^9+k$|iXXHgxFc|fAw0vY!? zz8Y7Qrp%V;8DnQAws28ywj}&he$yD^utc`T67?w?M zt6nZW&RG@O-0z`vwuC*)A{f|b&iTNJYeIiEG7AK&vChd0(mHEV*g*`Cw{ z46g@AHbt;4RWL`oL$k@$c575gs$HU%XA_&ddNi2p^o)$B zhA7T}oASf-xsY7SlkCgc@g{P@3G9hQwu^3D927;&w$W)trU>i`+`Z@lAkDpi5-u`c zdy`yxNbGmxGGMxSrO(j;k!4s|Z+6Z@XK+L=QL5QKqD8SriL2oRd;C&c(jr2UB`R*@ z4FO9o@@b;AYQXF^tQj{wBbZV!CgWA+SG02BgQFap7@g};pKURD$D|qTm&>I>X7yr! zsO9lS?cD^W_WbtN_QnAx>A{|FL(Ds)_C6T~+gzfDVW>*EnD007sk~GK-q_~^?Ca4u zBt3JT#(zEYp}x7D_v;(J9KaU1)1GG?r6X*B5cC>mT(9^E!$iBeOf~bRhh-LPg|I2- zXa7{&8^V?|F`M+8B1sx04ra5VmM9wEeBVEwHY0o|!=}>9oTVBUp*=&Cw`#er=5*IP zTUHmEOYDQO>*attxtQjxT!lbgYB(%cjk+tXxNcFQafg{$3m!U0B(S>kpEKii`t zZw2<4YkL~)vMgy81nnr&o7L);9mSd5%q}(?1Q#vj_aSej6qMNYw8ycBE?llw?4~<1 zmy9;6Os+&RA z;#q|+HeRW$g?%7U9BZlf%p65#)1oWZ7F!DtrX~5Z3T77F%B0VwI@<~y%zAe93(SF_ zsKO2f)^WpdXU?}sQFd2#x19`_vgt4fe4#y;&pH9qi}!$~vdOmE5;%OoKq3eBQ;hnn zBh~_HF8%HO+GRb}LhEZgVG*^P#kkvhE6j31p*F!0>~BrFU?!2#?108 z90!MLW_~wIhPk`T!k+ZU$&S-V6vxArLc8sDi_5LSWhFjGm2rO?344hun5S%0qn#Zx z67g@R^@$Icws-(sDYK<3lxJQjPpd>1PG>8*S`>yuz=R9U6ii*nRIVsbFtiTyx7@|u zpfK~{a+8r1E2)ZHk&Y2p2VY6iN>Q*XKHeRO(8gxg=cH>kTa6o0W{oYGnO&q#+78L; zzKWE4hRsb07rD)G8)=C`xW_L#4E4K|OozY$iw0iV{|VhT=n(GY6J zx23+yEbwDn*k8us*oNy&8XZCbnKKO9*y@Nbd5%VvdyZST(@|p?-&Yuxa!S2MD-&?# zit^4kx74-Mz+61G=yAT9sjZ9GBzvt4!*7)t-g85<^!>~1u!QB$=leYor|SAnH3kB> zr1xU2zA)^)^a;`tx9gn9Qv5(6ThEq)d7`Svc?E_ffE`3qCwX7p0M7O&Pbn%$lAj?SNv=i^JW3~Sft(aQVe1$G|((2dh-a*f9%&R)fUVSvwCkd z9mQ=y84v3<#60%?a@w6tmcr>9&0sWoSY?vPkSn1V-7H%}yq>`C1%A;cGlOdmfz876 z!R3ZKgT<}7cdWyHL{SVwIaQr;s2}8pKwMUsnvA0~YSBpvhww6%LV;OEymUquh39i}ZRmLo=l^ZK&y6tF zt5IC#3FT9A0&zi+VOsAf>CLtpZacC7jRMP*Mt5KbF%*|L3>tWlU5N^~vjNSrETZaFKt}nniTwPf8U)r_7a2bVpC zF8#JR3G+lwdI|L(_?woqjH*yJuq@=b2W+EnW5P6zcX2MA7eEX2E9JUI8~3UR*|}j% z4JI))5OI6#NjF4hmU_JFqNY?pH(J8nJr@qZXdxi9!zNu}XK6bg*y=W1Q=-JR6`pWi9!Ifi2pC0QF1qMy#qtt|SSk*p-Br2{X_<6R zjI}DTMT%^%x3i)OJe^D&64(}IC=V$r#sxyNF3A#sw;YWHtou+KiLkiPJnst9@kj@b zu_r2qyQkvitYfP%I4IT}^HaIQkj|)tjkdY$Xs}V1rx^8sV&_8O4WW}wzh+jRSC;_U z7PGB>uFPhUhvX%3jP2wz5M;1V^Rm$Q30m$c^Aq&GdpI{KGyN`&Do({!)<; z-xJ(=rNpC3#5NwCZkf6YuWMXfPkg0zMznOrVf0zkvXLagNpIBMI$%Wz?ih_1&kz^Y zOuL08X^pCqtf4THSed~QD78V61GgV=B;}a?O7B)!fm7Z-43-eBLB9^$ZLWablslAP z(rbS~?f`%@cP8Q&4N0E`j_r{Yz?vX)0ZGb>R?X|nL5~)0gn=tM?P`@=_5y;Ud2x;! z?x=}PHbCr`&$5xKAmVKg5D$;|ywObA*xh)5&x4R{VQe%D^6-rCwph}qIrJrK#b_7o z+RScNMTqW&!l>vu;NY4O7s4Z`4FVbwcikPJ1IE z%BpWECe$G`!LO{>&ddf*cz4EPUT;sm<8ImB*&mbxK9IQ#@spwg@|AHsDFCEWE`wHw z!(u5eRWh=T3^y@Yso=W9&e_@;_d^GvBBz3Lra0c?i8caDeZ4{_Yrh2|8!vizQ0o9k6EC z7(BHiu3^L(VvK+{Z=@Vo=Ta9lMz$3|pJP2r5aUo1tpaINE-o%c?sop}xY9_7KjUNW z4CZwx%X_V^#Z9FNVvVF56}?<$x3d%ttX<$D(MEcS4T45j`gOm*-KpNO^^)GBXv!bi zqXxJr5W4PS52bHI@pNGi?p@od2Y!m}FA%be7t~XD0F{^QTCcW`xNG9jl1!N|5l|&q zr5oMD&Lic0%=Bx)BYBnrj$;U~^+iaMB@&)iQ4SbP+Dj19^`zGwa|p(;^%1y`JGuo@ z<*-qu)RdEDvV%DI!g^3m5<+YOn5p%7A zCYgDO?Pvp#Q-7^|Hn{KP4ax)uRZ%ZvHg;z>!AX`mZXCsEFBxpk)HWLeJ!Eiw&ViUw zx&?XdS*zK^?3JXKW_Vl9Y-%Z^pn@0z`4rGWvRDx884gnEWT_zc-f(p{Dh`aNIW za+tmbg1fXdrq~e>f7&6d(w3|?K8jl=L_v)b^mG9xD{)$GHPL(#E`%pk$ujs#M4(sb z`<1>P`O}5h@*M1Q-kUV(T!E@xF}aYZu&`ZBA$rTF$r?OoDkOBWPX zU+%fl-be2i_9@VCGwDt)Y{L-vmN+mg;4|n{;Rc5UlgupGu0B!B08zX}8HSO}GdvOeYrOE-Wc}p2qyem6KJM<;kGop?lb!cG*zq zWyYasHajTN5yn#VXm_XhXz7ij08$a%i1J?CbHH`bqhK18+_<-@3MNjt(q#Pr{8>{j z#JILeoTyI4!#<87Ndr4CSd`aYOFPAZr!&x5l_jb&ONU4`;^sm%r=+zdt=aB?15S@D z{$K?~R^!^(#QO6cw~FMVBm8-tcn1}yCgUwbOr=T);#b*{-l9+9#Z@d$=X-5K7x+}gafo-F z&T?l*%<;~IePYhn(z@~yDOyXL0hKRoQPuhDRSu2WV%$`yNzwRu4s^}vCzWRdTXDMV z`sQ>yq+}}rL^;X`;$7`DHXA@GrEUN@>^nP-x!=Ip@@EIwh6RmIKA^ZL+c?S)r>lyB zLV!5rS3qf7Cs@UW6`qS@!G*yP0tq&7EJ@1(^b+!j+aL!&PV9D(2yx*)Spi3=3p{Y7 zrqj*lQ}8>do%MD*oK0{BCUAeNiqBHrKu>vVjhdy1b9BK57(pWrr^%+%PVtzyA*|MB zuc8;b#JopJy{85=FT>q^9yyS!nr~?pAjBF`c_nhv-Q1&YJDFqVfIZ^!fys8<5li-~ z<9f4?uD}{{z)|(&Rk{n7HFBrrOd5k&bp^C}*Z zP0evR5kej$*3`>Vsvq&97?F!r)uku@5Vkh2l-`yVJSyH15_c}zOj)?@atVY)j(g%U zImq3_Nx-7o(yeQ?!?BC+R7X1XdPNfzO5JAUB5u`kT)GN31~bEz)UxyaSO#2-l1x-w zLc#N;^wQ*|JQhGVPWdo_4Q{eH<6%>{mOH20%LP4y@ohFhl~p?w*nr;eP^do{-F~_7 zxNXrAfr_Gx6yJ*wJUrwG0jDh)afROiGOsavO%9&I03Vu$7sT*uYn21PnDeB!G3TZ8 z$ce6k>t5~TBM@v`kr=NcvjWsR6Y|^TK(LarZ7aZTO-)qCLPI6hS|0o05(Cz3d+{J2 zt@eIh6B02GPJjV6%-J=Qp$G#BXfVAbvB6(#W76MlW4S^TuMrE$o4AwJia*~3g)Jc# zkN6$XP&d6afrfHSsx$So_@JO}1d6HKXh@SJY7-lN)u>FEOpee+x}Wk!d&prn!dahu zJEswrByS*4BDuP}uCIWz>kWjHPTN5u6iP@;R`KWL<=EhJ{A%&b&Pr1bOK?=&N|5Lr zFH~hxOCG?KD#Bc*Ly8O$=;>SiYwck<)Xp zWRBOp(3|lt4q(0`c`$GqYi;n+%j2(@Z%m_qXV&2j?9EnnF;UY*_MK2k(AcDqM(FE`sM*PO*h97 zM_kD{NtA^!y2<+!9(>udbuKckk*LjL86Q487L{AU;S=qK+VY!PS8{>Phv*^y- zj3dHfmLG>9dBpVn+%t3I0(nJhN6P&>{!6n1T$cKS9_)py<_bo@^7lJFFmpPSA@!@B zty>7Z5LOww3tXYQ?s(2W8b`>bEm96JS^#(?AtFdeSyN8naO*6)F@(Kx=`OCQ-MZ?w z9_3~!C7F7)3W;CZGQ>;g0h#h&3}eK&?#G=!=S^{xsioCIJxi${eo6w@4;C^Xet5?9v!D#pf=}M;Yn4dxOor^pp5N#3w0anrgqDP;jPG?mut=K z0!>p5bFZCO4RX8kKyyi)b2;$6FY-GGbT_NH+hRg5L+X^sjybah>^M7UQYViS#}4_< z8OmkZayTdo#+w1a>$X0+7`Le1&cMEQ=t6*yluJ2$(L{P4jgZp|MhM8e?c`gg zT73myyGkb22By}SilkR(-JY1lr z!&)M3w$zuXWn#R4lBqkn=GZ$$@Z;e&hiTt5EGQYo%SKq+0t}$M2vFxWV&nQQ!WYY} zd-NFH9k65$1sb=gD(hamJjAKv=>lO8NYl%cY%}<82Sz5%phts>3OAK(u(I!OtdCLBX4|j4^dv= zZuZNnlnpRVkR%6zRRd*YL`2P0_qy)qWzb#|AK@D5Iygna2f474 zw+mW6SOirAVD`F;E>KQ7*)YN@XD4z=DrU1{$`$Cd1n#`QT9bicS+nMmGJzti?GmlY z%ep_D3aD?>HI~!LqX?|aKFA?EPjN`s^>c`e{2ENS9+U{Gc7Ab)NTBp05~`n)bC}QU z^uDL>X17EZ?!-<6jCSB*P>HvODm5Xxr%*F|>Na}{c(FX!g?oVbTnyj=-4bqUPBB@L zMMyb^|G%I>{WiNCAg5)E*@E_12I4LF6Z zGu;QZ9>m2WePtW;Q-7{gthGazR!gCkl0xXkA({zu*+qmo?5Ot0rV6jUB zVX-9gKj3KbFA2(?rm_?z?`0DDcg>Wy8q*9#i}mSmu4#Odx} zGtdO}&4FLf3STWPbz=#*UZ;eJ$Ay#PLrNOkjGKZ`qHQwUxEM)QX?g_%QyW9#E#`Eis^3Y~_cn|tfMOKRixOD>RTA?<_78LLU^RZ3uE7QC*)iA%CH5JV4`^0+z z!4AF^EZnw+vN|_lS4WIk-5{qZ;BDI);1;7x?i&0Z3ZEdUI=?TRBM3a5&IRN>eV~{6 zHR-g+9S;HNU4+dHrUozX<_&j&t~Y=@?c#+ulZO2|E}@PtPA^cCoQ@`>bK}y4DiBJ8 zsz4xxE+qyzVt+ZtvuraZiqH2Pvo*;3t0yoi+!lDF1e}Wr1ug^Bf;wCHDga{ARZ`xD zFn4_mH95x$*rgs(=sOdN1s^ag)2px!DOr~YtL9BnJ~IwIBs zhu%=4JQWbHtdbj0f$Y@3`@A_8!)%0tE?=n$p_~jL5iBOyDZix?-c6!Jy34_ z#G%1dAl_8_QyWI5C%|vPgMlX4pYF@$3F;Sle~J6W8c6EEm4<^;CB$OSv=LScc#{vq z9DH4C-Q5jdxh!Siwd<)~;+CG# z`NWUVPF__Dh(9jHgS%S|2p#MZ-yrQdQ?Vn3EmnQK%OMF`kc9>|h3Xela32_5fc9L31@^QXnO;V&ZTrw+qmEGg2W6`fNxknx*4OMA9)h zK`j$jYBa}SM4zUXN}pR$WQeZ`SKMutCBy=qCS1i%u`KvP)#SvG5by^*xN-d206h0c za4#qZ4n%=G(B>lTvMsFcu-&&1mhr#|5%;FE34G6x*cz&ys`dR^8?=8In3|hNyhqKN zyjV%nY$P4_3Tp!Kkf&Vh&6;bW9->Gl;>9GOtOjsB#D4&dD}jd*=D>~Xr&8Y~Xr3&@ z<)$-66z1%ZV{=EztxYHa#~g8dd{1IMq)$*w3)RS0eVOE{ASBGeH^?kA%%IA?Ce7{! z|Hnw!31Mnw6JKCCfKc2Vp%e$bk?uZ7q_FX040@4fmzmXw=|E@bI%1#sDPlcpCR<}G zuD}AQeFKJ($+AkIfF_bdy;Y(x1aA|qoNXQkvtv_&E80Mpq{DjTC8;I{ea)v3{AnfB z5};eCu`})zif-2kg7o9Wg^G|gPVgmi268g=fKxw;OmN+>vjeqEF<_TUokXFq3daHN zDM~u}kdrWFI8eZXZbob|ce7i_3!;K_5^w=Gs4_h*fM4h-AsH6Z#0eZkX9;C_z%Mb3 zfd^UCuGq)&Zz%_sTMQWfMiI=_}kyclLR9jdyl-!#Q`g^iUsbVJb=} zLWJ+eaSffoC(ON^%tngP^wk0nkwSRZ1D;*vT?UI(K^-EIgJW#m22Q2S?C^dap-w0| zEf-62Im~Xib2Wnm)hZAm$(SD|eim@o_h;jzm5UAOPjhsY7 z0lv9$oynhEAWuV;;PZF4)z%`GjV+G>IhVl*AoXMqbBxRocF@hVj7lAjZ)rC;ICZ1e zr=1G5L=ZqHnyW)*q@fH5`piUn5EeE@poODzDJEQy8!}L#5oFS}`P1qLh-w$ErdrT6FVF7eBNnyOsG8y zqbE)kob^d^&4U09km%uXfM|?h;VUWUw^E-kfc22GYD3QUaJI)|bjdC}h8YoLCjA_t4N6s}=31VFsuG(r7ID}8m zPb}bqm{+|6i~};apW%*u;Ej#{J9?f=z-; zK6y}+svP#Fvw;6n4zEVVnZqG8qrF)R1A*GDtIY6Mj_>(GT8!AfLN6OQU;{@HFWnNA z707|0$z+Rn!!BYXsMf?F-vD{Oc7y?EW&xfb4$Rb>+u+$NVCM9}q_^R5J)P-^$GJ7$ zz-JNe1(F3Wq=IXrX>ECmkEwFd!(?|m8^IKRWZV*J48exCP-q4xadap}y6#FTh63(X z6(|1ZSOb(fY~Z-cToZ?AR@}f0wC6(xBob`yL%Hf!5#Cj^g&aC+0eN}_Jzhf5+ujxw z-D>P~equl7^EARC@gJYy9D#2@4)`c58&U@9)NZZTN)%=MQbM-4V5(m*CnGt|7I18nr{aS=iqzc8ififW!1MMR35n=*!4D^T1oyTl zH;oJd z*1G^7wb!bKV9)TyKU@1Yh5)_AU|lxtETweAuuI@M7LY)MR1=)j(tvz&R!4GlBWl;W z;7hieNv~|E1vQT=eJG%2g23A|f+JI%@ord$(KX#Ma4^K+S#=$s>X}v%h@BAX1~qo; zQ*dX1g9soXQQb{`sV+6L?!@7k&6i-WSagAGX4On8QDie-G04xDaHar*3{n`b;#`As zBf3^Ls$!njz}!0wyQ51=vQXSyB+0Jq{*py2(AZM_*ALmjyHXumP7vZp6ZK#=q z%)y0EN0L$#Z1F0gkusxDD677qXVmxGwIbw-3vlkhgIy_Yu*Og>i%CJg&6)+`8OYJm z;A|TZNH(aPoNa(Mpbmo=@9&;kT^knCcDrOpCV&Pwo)*bEDDEDlY?s=Y@ z=XrHH&to}BHbg`st*&*Rrd9A&d2zp-Y3!|nb9!yaoYyxv)YEA!A`ej89U4`5hhnq) zet81QaFkqEs)-FpBcv};G&bIa72P3n5X)Pj9!^-U)#?pSmcXo!YNEt}rN;q|*H43$AvGrqbnb!0`%K>_#|BM!~_@hp#540~S!`i#aPefV)`WkZ9Ya8;;F} zegk!K48&oi6~jqF1kNp(z@v~NH&O+wtLJj*iv1R1jwBUzN>=sLNdtL$%r)5nKeh=*BKfFTI%3%UN(VJh(^;P zU(W)Vk~SsOw8S#56P+gVTcACX)XvwCKMha4aGC|Ch~9XCrRf8s;n^i!9&yIMW(YB? zw6;8JX?cKiy=Zd;od}eu2!*wAxRat@F9d(*K^+5ZX*5-!5{B!i^Hj4qJh|R=!i`4` z2w#;JDEtIK>)6JZ`m))SDM>nTApLNJR6SIqIx@4_lMR8%>1s9A&#TsjIV@<%zup&1 zb&u=ICCNbH?@$UE98KBn3;~sPk_zW%T~KAWl`xC;n>%q=7)EBHOxrwyer!vop>JLc zr-jyC&h-7(4^7Bn-V3kA@doPIvJ3p`hh!C*Z&4`XbU|I*LJ3CZ3)dmd&t z&57(e8E19CvWp{21&0Q55fGEEmXQATLFxS|rF+-~=Ty~6db5I%I9q{^K}9~hJ2SyF zEbX9In1T3SyV-g;Q1F?u5@!D&TW7Yds+K0<2jT*e{*q2XdTHfOQ4ndQQBa;f!?mkw zjH*$2#>qTq=WfIk< z(!IE&_Z_%xzVXanT>U#^w9zN2rcnxCPw8dL<09{vJrD0W|AqT;ZI``%m(TnLim_e# zRJldEl-||e3uqG7r_?7}|20QA^u%_XciEOLNP+mx&Dgx|x-GoURU##c63_Bkphg+? zy+)mBNRrd|JZ4Y!I!k4v^bLim8z30g!%RmHxoN%UUY9X>zwl@5iP@iKd{@4_srk%Y zat{sP%!~O5q z5o55+XmTEXN(@9(>)-(bK?(s@F{h0b^j+A?OnyjcZ>@vOHO;Ct)_$u_ZF+}p)giAb zAE3<@NN>7MNU&91uQI2+Rd&U*f-+*ak$p5jBG?5X|ou)B(}>dTe6rH~{# zSW-@rgIy!4Pf-wTO>d?+WYDJ47K%*uT~x~~kmHMe74ZLU^CU{>>$$U_Y2H``7qOdl z$b@%%r`0m-6=)5b3j@(ivnjEB+LytE=iM92>+dXKs-1PgTFhcpazpj=2CRXH_})sU zpr+fb5b-*{nUkyMFoAGb`^@w$c|Hzmxrt38reC(d_~RUgLx=S-kB))SY-mC?E6J&E6t zo0SB2^W)Vde`ghC(s<6qb%*9Lu2O-)Zg ztv%G=N}eVuUG&Q|oN-YdXZ46OUqV-jdDYKzDaEf#vOqgKn0NuTO2Z=2Jj9z#v4!vL z9AlXIu=l2B9@qHIUs*oG);gA46-AxGeJ&Ys@>RL1HjP1{!P#E|j85%WAK(4t#}vuy z4|m)!qf||h&_ha?}cM$-}o`c7_Q_{&q_K_VvHPgo-%uy_>6Na$_ccg@ zz`2SKqOg4;-tC3{ODNHrBrn1u);@*@>X2MLhgYC60k8fyLpV~$Xs3JKT0+m48O`6k z-Z2k(U%u0QnFQk2GAZi#LQ`u(+_?(!u=({N=PuG|X7Q8xwH?k_mr2-@pgF9^I_s^~ zF6O3reH;I=Onbj^7e>KnX}0p1=#IFb=8O64#KwgD@Yo1RdK{@Q>pz=-&FYU)9>YVq zNaqdp_e`TmYJ*pL^0LWBaeQ{Z+J2pQ&cVa$-ssz`uAg#y@`O6uYUjYCVd0znH-h2!Mcmqtk!s72+d{*cFNNTFDEro0etES_G6E(!#OQX z-Q~yjIAQ&LgW2XMmTmPThE)Ybv|c}BNVqW-S&85Uc;eYxPmskDME_U^So{j!A&O5V z^moYA46UELmj}&HM}qNli=!vi?B%#}Rv1NY`p@sc+{QtfV7?|vr-mmj*Zs{a)GA}f zUhKBd*=7oEa0^1?l^<6U=E>sXHBD3(LG`?Dv)3ZV1-_pJPM zvJ$*o9}9N3g$nygMfGwPwG9{zz?U?TRYOSviI~Ph2%#B@SogE=;&Cx1(Z%b`31`V9B?Wu2ld@giP0yI{IXEuL90f?49i=!{5Fn_U_Pt!qlM>cKT{`J~ zksk-+lLx2$Fyp<|J&&F59l`w%?I?j zY6|_sF#z$#P|`-IjUR8u)$#hAu&Zyai_=sbC4CiotW{K*7|)r`e$s({xxnOf+Hc1b zb@uU!Km0I(NVoi4Z>48J%QncEtbXyQ!Ea~P?ybG%#PdK&`$XasX_reeX6R;r^`TAL zX6R3isOoX=CVg`lsZ#ffNb7gdfxb;HfkE8B5RQqX&GQAtB1T#mYk|epBbLH{R&^@7 z;`kA^zzkrEv`W8cFrnTjhZ7!PKsd}>#^w{t{^)AIp%rh9aMWm0^r4-!_a`tz?)UPQ zKriyY89r40+#gf6#cuZ7Drs?1&CL3q`E8l3InJloVa38A@l3VfTj7#h|VDV1HJ1405Oif7gOLgO!8=lR{-;eo*($!_7) z7a-Ijwl%5-ut~ISc5UsK#W znA%98Z|zxL>m-SsF1AN)yH~-@7*k{_UA0=a64GJylTk>aYgJm4pu`4FVc$thXb3n_ zVHg@sJqcgW_F21fR52uWfg2LsoCN*@yY

!vNdhGJ#HW2T10P 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%0Ax{ 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 literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/.doctrees/chapter8.doctree b/doc/src/LectureNotes/_build/.doctrees/chapter8.doctree new file mode 100644 index 0000000000000000000000000000000000000000..3bb9844caf81a493ce6c290e769418e86709fbb8 GIT binary patch literal 479124 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≶SgQ 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 literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/.doctrees/environment.pickle b/doc/src/LectureNotes/_build/.doctrees/environment.pickle index 91ec5636b8336974417b565383b54e3cc9d5bfc4..da58c25c9feb3e0e0cb3a2fad867c8398ed39798 100644 GIT binary patch literal 365288 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 literal 333770 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 delta 154 zcmWlRu?@md3`7O#K1C)#`U}K5``dB;C=@J!Xj39mWQ0g85-C-BmS7j0?(W{*?Nhr? z?KGd}^Vor#+<{cx+0}Dqa&s|QbeN**<$17NDm@P-KKiEE0)*GDW&@NBQ4>|L@1RALDyI z&F6Laq!(Z=RgjelCd^j3s0u*mQc+2xb1sC&(u(d|8+ZUvW@DoU5=BumM}NJx>QUb0k~kMGIERiktw;f axUp3>%IK#`ViX3qaeX}3`}cYoe%l|=86#={ diff --git a/doc/src/LectureNotes/_build/html/_images/chapter2_178_0.png b/doc/src/LectureNotes/_build/html/_images/chapter2_178_0.png index bca7d703a1dbef9c896c4e0c9ed341a6ee7494a1..f26cbb55eb003e16a95b05e3319cb98dce04b0f9 100644 GIT binary patch literal 5169 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 literal 5181 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 diff --git a/doc/src/LectureNotes/_build/html/_images/chapter2_184_1.png b/doc/src/LectureNotes/_build/html/_images/chapter2_184_1.png index 52e1ee090068c51a89d4b3bbd7c26cb72b8ad526..23b842d8464b19e6a04173cb035b85a9ccc0ab06 100644 GIT binary patch literal 9817 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 literal 9823 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 diff --git a/doc/src/LectureNotes/_build/html/_images/chapter4_278_2.png b/doc/src/LectureNotes/_build/html/_images/chapter4_278_2.png index 3fcad478b764ded6415bf07268f0d75a1a664c94..5a4fe5abed9d9b87a4c659bde42999d30e29cdab 100644 GIT binary patch literal 9410 zcmchd30PBiy2cMW#kPpdTw1}Z;1q;fMUX|-5J#()f?$h)2m;C`TLL5yLPEe=ai}ac z$iCI0P(h%85W*G|WrqkcAWH}kA+iPt5JDF2|4>_7r=8k+=U$%2hsVRo$yxs2`@Qe) zJ29uNPs+dh!MhLy$yT*n4=bF-UdI!w>|y|{{K$k zr;Zp1lKU_CpG*&nBnBIeu*c70ZP8v>+=XCIDBuD%&>xNU_qn(y)H4|4gGT8c)IF$s zV9zBiHqb;{`_x!V6}j6IJ4wwh7s%aQ9Y>?iI;2 zeL=BH+lI&v_Hulm-rt>Ek$Lbh1!{NIzj@9Vxu37U^OSr9b#xeSCiOMPyDmzXSj4&V z6oF(Yub`j+f{w^|S*`p9g4}BV=>$Pv{~aX*eH2~w7WA$1*mfxD;;W4(_#QSRRFagR zuV+S_8x9wIcfE^#LoFf^A>Y(eed<(ifNvSfHZde4J&#k}nc96*PTP#-pGpyT3VTC%8J?Pm8A2ga?=Gk5rGTnQlR3zZpoIH6lS=%*Re&=D2z`!34>1~0c zxJCg(=F(LTbv)TAxbHm9Q?xQGTu6w_WYyrjC2Pyn>EfC)zrJF##TK>xIs%UTJTC*) zmUk*+v0<~q?ScaT!OEghO&JJk{b+0@M>?4kJf7s>HC&5NGw`#oM6uGT7_Qgo!>f)z zxcwtNBZDzKoLyX8yvr<1MGB)Rc!?t@zQB6-e_}()7Ho)6>&WG@Y?a%FD~!s-S@6EtFQh_>SMKPttwrTa<`+ zt1AjTo{jsSr!jrlz>$)ebr=;X>5D{ICLd_M?kXNrZ{5jWZNi3xcusVrskw)ThksGh zr-vS{U0Pa--GwBs22L%nrD|ZGf9e{2t?&@S>qDk*(d6W0){KwNiC;Zi{oQ>5O|f}O z#6wH>38<2)v9F1O8g^%Q?nym;{hK@@*VM7};&GLTrS4rufqRY}JJwIdcn=H==tfG# z_wV2L;0@PVkh{9N?pIXAvHKyYLC$D)KPAOE*kV{TEST8M3p;6@X>_BHCSAsh2HDvu zH1W7&O=y6utZW%}vgh8}(hn`bsz~-9syY-A5#f0M(&xSR92xV85EP~EQ&2FKIk4Hy zX;YjV>*c+;+X_}OBZ$=%4lhZo_w!lF&=Kl6?bHlot=!0uU#Kcu@w(mRGym4m|2GQ6 zc$S$wald4G*YfIa+`X=)HM!Gn1*KXtpk~6xw?}<$O1gOIjA86L?NH?*Nb%IrCLP~$ z@6P*iGDi9R$)N0hdx`(%y8n|KFJ;fX1L=@{Jn@6G4NK$izJ2-|W35gf*FNK^1=G2+ ztcHHb%4`q_+sjg~+zVxLW^&(BMmShTy%VZYYBCUUf91(0Mpo5ZscyqdZ#^+u`Gey8 zlPCFl!KZ5yHbFP1S7UC0m71%^K-gfB}`XOH@7|La7IQjC(cmA zVui=f0h00@{;Qu0KYb{Cx=1ZyGZb~gBp}4zE~#0CaDctmOF8jj1&xN>Z-1|ag=1%> z)Gytk&Q(vB5d?Dw&R6Rjvaq(On%T+&F11F}eI@kDfWgIhTy5^CCRlV}$<3GNNDf#m zW(#UH(IkEbe_T7#7-&`d!>e-TZV$fHH#E$zt3v=GF%Fw|TN8=O!xqNWEr8-xS66>P z0PSo(mQf!}SbEWYz_Cm{azQEbhN7mmM`yYLo=0G3{I;|RKt*>S=O*}wJ-%n2(mT{%c30)hCY2qng=niGwd!zKO`3JvsQBy z2)sIuo+$(=Z_YU_`+untuNUBN*2qRx+Mb_&3!|6+c>KK)=Mmqnfk5{3^CQl4zi;MM zxrc1_-mFs>;{@g1<7h^IQCJZlPF!zr3r|q-8;Ol-)j-K)Hy*xn*B#tWcM`J}u3U|r zLc<2kGcQOdg!-ST;f*WF#g}P9Pc9WHb#!KKPce;}Y+$NNn7N@AVc(A+@9ejovkb>SgWZlqKb zw0LdI{K$ijOk<3Pm5q(f)N=SlXGThPcJ>X(B4LmJb9rj==vx7D} zFbj{BxWfeAZd$(#)S$fjmF~ZF=D)D(u|mZ*$j!uvbn&B#bJO293lz5I30{=ScD=1E z4~#V(uESTdHZ0q`1G8#@ybAZI*SP&{^*dF~{l{$~x>K>#gL z-U6(Wm8iPw^8|KK^VHJeKy#h*|8v*0p$$6rFSS7%vL5f3NezBo#TuxODnSnVHwozV zD<4&Ci?R?LRn2z-Yk1xtN^N_jr87y)JP2_f|Nfy46;w%{=9?$&FR9ht?@-*KL|c8V z-kOad^nlC&{Ho`4Z;_h20GN&V`1k{^^=3N{`?rjYxc%(@B@Yxx-|!;WMWAgE>ZQvi z+_@TFmknt#@t!Nq9LEZA2%Q~BI;nzJufg%G$wOGiss8&uwklyGmq9cL7_2l9tAiA} zehN<~R0Y*2u!;I`aQ+W~R~@aN@$qYn?9{b5gMXD5hOHVzIB+f>X_rBW&ESuA?G zyKjJK6P*KYmU`|`vW{Qxy&*g|%aI!FnS8*JeC*n`JNAWfMA}Ax5#8ieoYP{lSRAAu z1cj;OO1~;gAU;>avqi%x8_8#;w7KW$Q~kxdf&%dS=IH1s7h%3#={#1N+GHcEy2Zr6 z(Qw2WQ+z(9t3s$_(mU$``f!ePDc_g`;v^SG(!_API)T&g0V)PUP<$+iBNlZo^jbW> zhr!Sb7SE41-tC)qPk#c^>JF9Srlr)FGldm-`T4lA{0GX86ikMk9)n56o)7+&DrAQ` zJyf(YyAik3aAI|V1Am=#+*P`_&lz*-&&C$Zl!Kk1$p`#JyI{KwFy2KCg}E&1gyp8fBFP3%N# zHgr0>S8l?~`g*$@q)0DU(3$&}I>lbxa1HZqT9B2@%Z9$Z`m&)n?07)60H^n!4xzW> z5Lz%9FhU%0_WY0ej6Y%&uw!a?`Xv0pP=`-YD>O1Rk@l`~(#!BwPzr~yk$$LwU%rtP z-&|FJ2SD=E=pN&3NpPV_*Gkq+EXus;+4m_FZ_udvt3#$+o=HT4e1I9+Q?%*P@;h~n zjGm>YZH5{!nTJsV;5K+9K@D|XD&ohXiE7BT?u0T>I)7F)dVMQ~i2Tkp1R)fr7wokn zcAI+wBKfMElGlST-||7BtO*1HNF%|ZQNwO!VeGL58E6@R3O_23MY@gQ$onN>k6Vz) zm1pk4=16g~xLZ~7xo^cl%R+cvHgFTWOt3F*zmyJ8xyO~Vka-JrC09m+mtE_{ryWxBLN!zyorT1@O|i!uq_zPc(!`%g@&YS>)zR=YhOF z3GVd^KvZ&wi><^L$5h+kt{*(!rrx?Y#hH9kH9~*Owp}exo}3Py8-jg92S_+tT3Y=z zI5he8kKrQ@u^Gr@lMiLDc$O{QfEjrH#0_^?bPl73GePxxfm90X$=C1iC#ySE`nNX4 z?PT=zr5wM$-4n#TxC{gYnYH_HLOD%w{Z&C6J_!v1Wd5$2)v@asUY#IY(gAQ^>u(fckshM05W&p^1rYkYOI!^cO3FaJ#DTYYdyWj)otcIsyUh`3L1 z!i^p9$AI&FGlco(QDGx`9TCRoD1TPeYf?}u*?eUZ5q|H1-gjrfDO{@RFZarWLs-)s z2w~wn%~ad|=;GYZ1Py{^VpnKC9;2E4DS4*9Toa^axEBF{X`+i-mr5pIyl7b*Z!f>l z7`=7dw!>b%Ab*%y@1($)cUZbY;g&Y5SpJy|aw`$e5T+nQ3|4AUhJr1DV<&sC>mwYi z0xxVoaQ2&ti3uQK`Gtl1wNEBUu@=SzCK@ z3m8UUHP^oBWh@St6I^Rwc&Da@uqz*seQo~^RhsFKm42h75JnP=5;JrA4J)Cl*L_0N z|18t#-p+=nqv?on>G>@Gjv&*QWRu8ZFcQP-NNo#^*Ax=`J(aJkom|s3bB+@RDT2Uw z$|k|4HrqF^v6@;Xvv;2)9pRGK$RET2%nj#m6=VrJWI*{fiQ57!EiK=y zra9&pAZXPN#76+YM_Q2D0PPG?&`8gY$4ai5fEnP3UI6{LKL_srC#Ltx%O9Gk*$XM= zE`Lc)V~jbx2Q@v^)6C3$y{|&HR{{W<{uc^AAFZ3ZXO09xaon`+8vm?Og^qB3;l+Od zjm#*27xECuS|Lw4qAjuv!qVBz-jB|Fh?0rIw87;kR=EnI##47UT3abEDM@BiCaR#*fM#p?cBN(^f*Va#d&>C}D)C z>^hcwu@lyh$8u2Wzzp@*vy}^gGc?Er;;!C34g{qZ!a1a#d!%LChC%b*g691{zP!)# z07Ve&rwyf&YHw}bz{|-No*6RGodwzZt#>|7J!5`+YgA9{viv1icI{_d6VyP^(}@|1 zyFdg{3L?iw)QnJ9KQ05(y{9!TK*_An<#;FsPCBDWPA*T*u7_V7Sv`Hui|#)X3j(P@ zkZEUTYZ0Ystxpkt>Q>3ok7na{n=ba#Nr$goxq|Pj8BX#msjK`OGFoq>*9p?8KnTpM z^K0UsVMR{NpoBrtz5Q9$1_Bn&)r+2;_thQL4)4BBRtNS44jty=QH6x51;7X61UH*lXD7m>LQIctQvkHi z4q)$Eenyw}?`* zE||JqA_IN&2phwZW>GU3PV57J(5{&&BLc|UZfk=`a&L|w&tQwaz(k|z z?IR;2`w~pCFHR4yO9kA5!s0fAKIcTu z?68a9<(n5}O;#fo9w|~+2K>sym#1p^S-g%1SGH(|Pcgo5b#=8bI%lv*c->f5{n}V& zShDb?NW(IbH*$$W5JoS&S$Sn z*!WpL*J*0;Ww77c+FBWkRqY(Yw4+WH6fWkfN-jO@a_>2F#?H=eeFeP^&ZMGXYIe2= zfUrU^ohx1&;+i|0Cke;xz$^^x6wS?Ol#imAp7vSVA1%4?e?$)2=V8Iz-V#F!|ydQhcGpms#KokPMTPfOOey8hYWI|4!URaQGzcX-;~&dxwz|4bbh!Mh8ZoihTAB^5&t zGFrn*2G^FS3*jUWpXwZ|rjSxQuBC|6O?acGlKc6Zr>5?}b(i!FF6n9}+- z)muy5n{~arGT+G(VebPnFcjRbrRG=uhJbMTCXzSEmWBd?n5bT8U(`mEPSYkH#V9J` zjxrvBt8oJ35NGhfEXWS^i%IZ|Q*+KE@5X`)MO~Od6J|Jv_Ipz2AIkl-ND2xTJJBRP zm~AAg0}?N6r-|ER5VtJ$pmIttb$_=pK-31PZtK>q&mU}2?HGG}oj>2Gz-`sc=>WDG z4jrrWqlqelRZareki;=81LoN|VwovyIcZJ?)a_J{qZQJ-8f6hIS?=TVq;tGr;dlyH z&UN+Zu%KRW>fsJ6Z3>%20OOs$SYpJBCtw^^aie5UvCkl6zx&m6%_5TGN* z>ta6tsjZE{{MNjDa8)4W05Yj(5zNiPO@NH$zS$cY5htidfT6NbDxl>cr5q$`=21R% z!Fls8v(Lag2k*h}0#MXW#(Mx93>Ge7v651!1&~TBxE_wpMRLrbH$2GMy?ZyFYsyXo zCs_xRM?Ku!&^;&0K~?d{7R+o#-$W8v;rm8SjEquM*H@eItZA2&l1RxkzH#U9HyP-9 zJh|)QnlU59l8h9UBiozJS4zPImJNh{I9(xfwec=7ul1`BR8*{iX=>@Sv%7Qm?xceX zGOM6K*FC!ZTy9)*wVhp(4RK5nzdCxYoFrL`rl*xVQDB+tbwYOrP*@W<|1YyTtL5e8 z#{qHi2?*$fOP&j7vTNo`x8BJRc`UfT(1Q!#zrSqeS*aS19f5;eL`v=Ry?AD!OA?yM z*(scIprylGz$pEJMM5Fd*O*t!4}ScZnLtauV5kk=OwhCd3WA1-abnQBjGnaO z!K+FxsmaO7W=l_wS&-`pf(bB#YljE-twwP^(`3tot+@&2>6^D~^SE^BBU9X*m6Max z1U)AQd}fAKV`$OyBeAwsp@A7WxZ7-y0{~<%!FT%k%cVo!H7IyM(F1aVHgQz$Vdy6C zL}AUv&p+4#({3=3e>%NP1h<(En&)DxQIgNNe{TT1cxTGm7vX$tK~|N{UrRH^p%w^v z8GwgyzrLs$TkIjn%Uj_OtcfYIfGk6p*UWAUA zZprEI?>FAZ)y>MB#AOZ&4GM-nKBT$A&cYIpA;W;`|`g5z34h~ literal 9639 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 KBSqhwx%U569Ckba diff --git a/doc/src/LectureNotes/_build/html/_images/chapter7_109_0.png b/doc/src/LectureNotes/_build/html/_images/chapter7_109_0.png new file mode 100644 index 0000000000000000000000000000000000000000..7188f63c716bd8b792d796a137e0e05c49aa433d GIT binary patch literal 5957 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 literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/html/_images/chapter7_129_0.png b/doc/src/LectureNotes/_build/html/_images/chapter7_129_0.png new file mode 100644 index 0000000000000000000000000000000000000000..659dee5956ab4de9ac41a3608e2b2cf1610b7f79 GIT binary patch literal 8229 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 X4*85Mw`~TtL7}}>Q~{SMn0)$QV{{R? literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/html/_images/chapter7_129_3.png b/doc/src/LectureNotes/_build/html/_images/chapter7_129_3.png new file mode 100644 index 0000000000000000000000000000000000000000..268924deaf59cdaf4c5a2bc13a951bad24625c5e GIT binary patch literal 23008 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 PW(rMpm|Cf-Y2g0=k;S;e literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/html/_images/chapter7_129_4.png b/doc/src/LectureNotes/_build/html/_images/chapter7_129_4.png new file mode 100644 index 0000000000000000000000000000000000000000..88bb051f73e3e42c0819b0ca42fba5c4ed1d8ca1 GIT binary patch literal 28808 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

MJz-5;#A84098bgKWSM(@G5 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 G;C}&&U%;OL literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/html/_images/chapter7_129_6.png b/doc/src/LectureNotes/_build/html/_images/chapter7_129_6.png new file mode 100644 index 0000000000000000000000000000000000000000..34cab365c5e1a292182ec4525688bfe754750901 GIT binary patch literal 53123 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 ?l1VGWSM>svDwr9qa_OGV#|7*Pg>ffe=| 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 dk6&}&gQ5IbX6 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%0AfROa&nRdoajN=@mYfF$juLvwS>EaWzKgY%nv6T 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 literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/html/_images/chapter8_77_1.png b/doc/src/LectureNotes/_build/html/_images/chapter8_77_1.png new file mode 100644 index 0000000000000000000000000000000000000000..6509bb8be4c7e20ee8837ec76a49571109d2ddd2 GIT binary patch literal 26467 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 literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/html/_images/chapter8_7_0.png b/doc/src/LectureNotes/_build/html/_images/chapter8_7_0.png new file mode 100644 index 0000000000000000000000000000000000000000..71f3c58f8e93f7af152173be70fe33096b6781f5 GIT binary patch literal 64956 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 literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/html/_images/chapter8_7_1.png b/doc/src/LectureNotes/_build/html/_images/chapter8_7_1.png new file mode 100644 index 0000000000000000000000000000000000000000..7c2b268201afa2182f6f3e28db0e2af2f8c09d3c GIT binary patch literal 104187 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,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "if our output $y_i=1$.\n", + "In this case we say that $\\boldsymbol{x}_i$ lies on one of the sides of the hyperplane and if" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b+w_1x_{i1}+w_2x_{i2}+\\dots +w_px_{ip} < 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "for the class of observations $y_i=-1$, \n", + "then $\\boldsymbol{x}_i$ lies on the other side. \n", + "\n", + "Equivalently, for the two classes of observations we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i\\left(b+w_1x_{i1}+w_2x_{i2}+\\dots +w_px_{ip}\\right) > 0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "When we try to separate hyperplanes, if it exists, we can use it to construct a natural classifier: a test observation is assigned a given class depending on which side of the hyperplane it is located.\n", + "\n", + "\n", + "## The two-dimensional case\n", + "\n", + "Let us try to develop our intuition about SVMs by limiting ourselves to a two-dimensional\n", + "plane. To separate the two classes of data points, there are many\n", + "possible lines (hyperplanes if you prefer a more strict naming) \n", + "that could be chosen. Our objective is to find a\n", + "plane that has the maximum margin, i.e the maximum distance between\n", + "data points of both classes. Maximizing the margin distance provides\n", + "some reinforcement so that future data points can be classified with\n", + "more confidence.\n", + "\n", + "What a linear classifier attempts to accomplish is to split the\n", + "feature space into two half spaces by placing a hyperplane between the\n", + "data points. This hyperplane will be our decision boundary. All\n", + "points on one side of the plane will belong to class one and all points\n", + "on the other side of the plane will belong to the second class two.\n", + "\n", + "Unfortunately there are many ways in which we can place a hyperplane\n", + "to divide the data. Below is an example of two candidate hyperplanes\n", + "for our data sample.\n", + "\n", + "\n", + "## Getting into the details\n", + "\n", + "Let us define the function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "f(x) = \\boldsymbol{w}^T\\boldsymbol{x}+b = 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "as the function that determines the line $L$ that separates two classes (our two features), see the figure here. \n", + "\n", + "\n", + "Any point defined by $\\boldsymbol{x}_i$ and $\\boldsymbol{x}_2$ on the line $L$ will satisfy $\\boldsymbol{w}^T(\\boldsymbol{x}_1-\\boldsymbol{x}_2)=0$. \n", + "\n", + "The signed distance $\\delta$ from any point defined by a vector $\\boldsymbol{x}$ and a point $\\boldsymbol{x}_0$ on the line $L$ is then" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\delta = \\frac{1}{\\vert\\vert \\boldsymbol{w}\\vert\\vert}(\\boldsymbol{w}^T\\boldsymbol{x}+b).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## First attempt at a minimization approach\n", + "\n", + "How do we find the parameter $b$ and the vector $\\boldsymbol{w}$? What we could\n", + "do is to define a cost function which now contains the set of all\n", + "misclassified points $M$ and attempt to minimize this function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "C(\\boldsymbol{w},b) = -\\sum_{i\\in M} y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We could now for example define all values $y_i =1$ as misclassified in case we have $\\boldsymbol{w}^T\\boldsymbol{x}_i+b < 0$ and the opposite if we have $y_i=-1$. Taking the derivatives gives us" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial C}{\\partial b} = -\\sum_{i\\in M} y_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial C}{\\partial \\boldsymbol{w}} = -\\sum_{i\\in M} y_ix_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Solving the equations\n", + "\n", + "We can now use the Newton-Raphson method or different variants of the gradient descent family (from plain gradient descent to various stochastic gradient descent approaches) to solve the equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b \\leftarrow b +\\eta \\frac{\\partial C}{\\partial b},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{w} \\leftarrow \\boldsymbol{w} +\\eta \\frac{\\partial C}{\\partial \\boldsymbol{w}},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $\\eta$ is our by now well-known learning rate. \n", + "\n", + "\n", + "\n", + "## Code Example\n", + "\n", + "The equations we discussed above can be coded rather easily (the\n", + "framework is similar to what we developed for logistic\n", + "regression). We are going to set up a simple case with two classes only and we want to find a line which separates them the best possible way." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Problems with the Simpler Approach\n", + "\n", + "\n", + "There are however problems with this approach, although it looks\n", + "pretty straightforward to implement. When running the above code, we see that we can easily end up with many diffeent lines which separate the two classes.\n", + "\n", + "\n", + "For small\n", + "gaps between the entries, we may also end up needing many iterations\n", + "before the solutions converge and if the data cannot be separated\n", + "properly into two distinct classes, we may not experience a converge\n", + "at all.\n", + "\n", + "\n", + "## A better approach\n", + "\n", + "A better approach is rather to try to define a large margin between\n", + "the two classes (if they are well separated from the beginning).\n", + "\n", + "Thus, we wish to find a margin $M$ with $\\boldsymbol{w}$ normalized to\n", + "$\\vert\\vert \\boldsymbol{w}\\vert\\vert =1$ subject to the condition" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M \\hspace{0.1cm}\\forall i=1,2,\\dots, p.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "All points are thus at a signed distance from the decision boundary defined by the line $L$. The parameters $b$ and $w_1$ and $w_2$ define this line. \n", + "\n", + "We seek thus the largest value $M$ defined by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{\\vert \\vert \\boldsymbol{w}\\vert\\vert}y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M \\hspace{0.1cm}\\forall i=1,2,\\dots, n,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or just" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M\\vert \\vert \\boldsymbol{w}\\vert\\vert \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If we scale the equation so that $\\vert \\vert \\boldsymbol{w}\\vert\\vert = 1/M$, we have to find the minimum of \n", + "$\\boldsymbol{w}^T\\boldsymbol{w}=\\vert \\vert \\boldsymbol{w}\\vert\\vert$ (the norm) subject to the condition" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq 1 \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We have thus defined our margin as the invers of the norm of\n", + "$\\boldsymbol{w}$. We want to minimize the norm in order to have a as large as\n", + "possible margin $M$. Before we proceed, we need to remind ourselves\n", + "about Lagrangian multipliers.\n", + "\n", + "\n", + "## A quick Reminder on Lagrangian Multipliers\n", + "\n", + "Consider a function of three independent variables $f(x,y,z)$ . For the function $f$ to be an\n", + "extreme we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "df=0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "A necessary and sufficient condition is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial x} =\\frac{\\partial f}{\\partial y}=\\frac{\\partial f}{\\partial z}=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "due to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "df = \\frac{\\partial f}{\\partial x}dx+\\frac{\\partial f}{\\partial y}dy+\\frac{\\partial f}{\\partial z}dz.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In many problems the variables $x,y,z$ are often subject to constraints (such as those above for the margin)\n", + "so that they are no longer all independent. It is possible at least in principle to use each \n", + "constraint to eliminate one variable\n", + "and to proceed with a new and smaller set of independent varables.\n", + "\n", + "The use of so-called Lagrangian multipliers is an alternative technique when the elimination\n", + "of variables is incovenient or undesirable. Assume that we have an equation of constraint on \n", + "the variables $x,y,z$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\phi(x,y,z) = 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "resulting in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "d\\phi = \\frac{\\partial \\phi}{\\partial x}dx+\\frac{\\partial \\phi}{\\partial y}dy+\\frac{\\partial \\phi}{\\partial z}dz =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now we cannot set anymore" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial x} =\\frac{\\partial f}{\\partial y}=\\frac{\\partial f}{\\partial z}=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "if $df=0$ is wanted\n", + "because there are now only two independent variables! Assume $x$ and $y$ are the independent \n", + "variables.\n", + "Then $dz$ is no longer arbitrary.\n", + "\n", + "\n", + "## Adding the Multiplier\n", + "\n", + "However, we can add to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "df = \\frac{\\partial f}{\\partial x}dx+\\frac{\\partial f}{\\partial y}dy+\\frac{\\partial f}{\\partial z}dz,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "a multiplum of $d\\phi$, viz. $\\lambda d\\phi$, resulting in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "df+\\lambda d\\phi = (\\frac{\\partial f}{\\partial z}+\\lambda\n", + "\\frac{\\partial \\phi}{\\partial x})dx+(\\frac{\\partial f}{\\partial y}+\\lambda\\frac{\\partial \\phi}{\\partial y})dy+\n", + "(\\frac{\\partial f}{\\partial z}+\\lambda\\frac{\\partial \\phi}{\\partial z})dz =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Our multiplier is chosen so that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial z}+\\lambda\\frac{\\partial \\phi}{\\partial z} =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We need to remember that we took $dx$ and $dy$ to be arbitrary and thus we must have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial x}+\\lambda\\frac{\\partial \\phi}{\\partial x} =0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial y}+\\lambda\\frac{\\partial \\phi}{\\partial y} =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "When all these equations are satisfied, $df=0$. We have four unknowns, $x,y,z$ and\n", + "$\\lambda$. Actually we want only $x,y,z$, $\\lambda$ needs not to be determined, \n", + "it is therefore often called\n", + "Lagrange's undetermined multiplier.\n", + "If we have a set of constraints $\\phi_k$ we have the equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial x_i}+\\sum_k\\lambda_k\\frac{\\partial \\phi_k}{\\partial x_i} =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Setting up the Problem\n", + "In order to solve the above problem, we define the following Lagrangian function to be minimized" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}(\\lambda,b,\\boldsymbol{w})=\\frac{1}{2}\\boldsymbol{w}^T\\boldsymbol{w}-\\sum_{i=1}^n\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)-1\\right],\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $\\lambda_i$ is a so-called Lagrange multiplier subject to the condition $\\lambda_i \\geq 0$.\n", + "\n", + "Taking the derivatives with respect to $b$ and $\\boldsymbol{w}$ we obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial {\\cal L}}{\\partial b} = -\\sum_{i} \\lambda_iy_i=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial {\\cal L}}{\\partial \\boldsymbol{w}} = 0 = \\boldsymbol{w}-\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Inserting these constraints into the equation for ${\\cal L}$ we obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to the constraints $\\lambda_i\\geq 0$ and $\\sum_i\\lambda_iy_i=0$. \n", + "We must in addition satisfy the [Karush-Kuhn-Tucker](https://en.wikipedia.org/wiki/Karush%E2%80%93Kuhn%E2%80%93Tucker_conditions) (KKT) condition" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) -1\\right] \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "1. If $\\lambda_i > 0$, then $y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1$ and we say that $x_i$ is on the boundary.\n", + "\n", + "2. If $y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)> 1$, we say $x_i$ is not on the boundary and we set $\\lambda_i=0$. \n", + "\n", + "When $\\lambda_i > 0$, the vectors $\\boldsymbol{x}_i$ are called support vectors. They are the vectors closest to the line (or hyperplane) and define the margin $M$. \n", + "\n", + "\n", + "## The problem to solve\n", + "\n", + "We can rewrite" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and its constraints in terms of a matrix-vector problem where we minimize w.r.t. $\\lambda$ the following problem" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1\\boldsymbol{x}_1^T\\boldsymbol{x}_1 & y_1y_2\\boldsymbol{x}_1^T\\boldsymbol{x}_2 & \\dots & \\dots & y_1y_n\\boldsymbol{x}_1^T\\boldsymbol{x}_n \\\\\n", + "y_2y_1\\boldsymbol{x}_2^T\\boldsymbol{x}_1 & y_2y_2\\boldsymbol{x}_2^T\\boldsymbol{x}_2 & \\dots & \\dots & y_1y_n\\boldsymbol{x}_2^T\\boldsymbol{x}_n \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "y_ny_1\\boldsymbol{x}_n^T\\boldsymbol{x}_1 & y_ny_2\\boldsymbol{x}_n^T\\boldsymbol{x}_2 & \\dots & \\dots & y_ny_n\\boldsymbol{x}_n^T\\boldsymbol{x}_n \\\\\n", + "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{1}\\boldsymbol{\\lambda},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", + "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", + "\n", + "\n", + "\n", + "## The last steps\n", + "\n", + "Solving the above problem, yields the values of $\\lambda_i$.\n", + "To find the coefficients of your hyperplane we need simply to compute" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{w}=\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With our vector $\\boldsymbol{w}$ we can in turn find the value of the intercept $b$ (here in two dimensions) via" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "resulting in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b = \\frac{1}{y_i}-\\boldsymbol{w}^T\\boldsymbol{x}_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or if we write it out in terms of the support vectors only, with $N_s$ being their number, we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b = \\frac{1}{N_s}\\sum_{j\\in N_s}\\left(y_j-\\sum_{i=1}^n\\lambda_iy_i\\boldsymbol{x}_i^T\\boldsymbol{x}_j\\right).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With our hyperplane coefficients we can use our classifier to assign any observation by simply using" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i = \\mathrm{sign}(\\boldsymbol{w}^T\\boldsymbol{x}_i+b).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Below we discuss how to find the optimal values of $\\lambda_i$. Before we proceed however, we discuss now the so-called soft classifier. \n", + "\n", + "\n", + "## A soft classifier\n", + "\n", + "Till now, the margin is strictly defined by the support vectors. This defines what is called a hard classifier, that is the margins are well defined.\n", + "\n", + "Suppose now that classes overlap in feature space, as shown in the\n", + "figure here. One way to deal with this problem before we define the\n", + "so-called **kernel approach**, is to allow a kind of slack in the sense\n", + "that we allow some points to be on the wrong side of the margin.\n", + "\n", + "We introduce thus the so-called **slack** variables $\\boldsymbol{\\xi} =[\\xi_1,x_2,\\dots,x_n]$ and \n", + "modify our previous equation" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1-\\xi_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with the requirement $\\xi_i\\geq 0$. The total violation is now $\\sum_i\\xi$. \n", + "The value $\\xi_i$ in the constraint the last constraint corresponds to the amount by which the prediction\n", + "$y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1$ is on the wrong side of its margin. Hence by bounding the sum $\\sum_i \\xi_i$,\n", + "we bound the total amount by which predictions fall on the wrong side of their margins.\n", + "\n", + "Misclassifications occur when $\\xi_i > 1$. Thus bounding the total sum by some value $C$ bounds in turn the total number of\n", + "misclassifications.\n", + "\n", + "\n", + "## Soft optmization problem\n", + "\n", + "\n", + "This has in turn the consequences that we change our optmization problem to finding the minimum of" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\frac{1}{2}\\boldsymbol{w}^T\\boldsymbol{w}-\\sum_{i=1}^n\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)-(1-\\xi_)\\right]+C\\sum_{i=1}^n\\xi_i-\\sum_{i=1}^n\\gamma_i\\xi_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1-\\xi_i \\hspace{0.1cm}\\forall i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with the requirement $\\xi_i\\geq 0$.\n", + "\n", + "Taking the derivatives with respect to $b$ and $\\boldsymbol{w}$ we obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial {\\cal L}}{\\partial b} = -\\sum_{i} \\lambda_iy_i=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial {\\cal L}}{\\partial \\boldsymbol{w}} = 0 = \\boldsymbol{w}-\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\lambda_i = C-\\gamma_i \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Inserting these constraints into the equation for ${\\cal L}$ we obtain the same equation as before" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "but now subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$ and $0\\leq\\lambda_i \\leq C$. \n", + "We must in addition satisfy the Karush-Kuhn-Tucker condition which now reads" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "5\n", + "0\n", + " \n", + "<\n", + "<\n", + "<\n", + "!\n", + "!\n", + "M\n", + "A\n", + "T\n", + "H\n", + "_\n", + "B\n", + "L\n", + "O\n", + "C\n", + "K" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\gamma_i\\xi_i = 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) -(1-\\xi_) \\geq 0 \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Kernels and non-linearity\n", + "\n", + "The cases we have studied till now, were all characterized by two classes\n", + "with a close to linear separability. The classifiers we have described\n", + "so far find linear boundaries in our input feature space. It is\n", + "possible to make our procedure more flexible by exploring the feature\n", + "space using other basis expansions such as higher-order polynomials,\n", + "wavelets, splines etc.\n", + "\n", + "If our feature space is not easy to separate, as shown in the figure\n", + "here, we can achieve a better separation by introducing more complex\n", + "basis functions. The ideal would be, as shown in the next figure, to, via a specific transformation to \n", + "obtain a separation between the classes which is almost linear. \n", + "\n", + "The change of basis, from $x\\rightarrow z=\\phi(x)$ leads to the same type of equations to be solved, except that\n", + "we need to introduce for example a polynomial transformation to a two-dimensional training set." + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import os\n", + "\n", + "np.random.seed(42)\n", + "\n", + "# To plot pretty figures\n", + "import matplotlib\n", + "import matplotlib.pyplot as plt\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", + "\n", + "\n", + "\n", + "X1D = np.linspace(-4, 4, 9).reshape(-1, 1)\n", + "X2D = np.c_[X1D, X1D**2]\n", + "y = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])\n", + "\n", + "plt.figure(figsize=(11, 4))\n", + "\n", + "plt.subplot(121)\n", + "plt.grid(True, which='both')\n", + "plt.axhline(y=0, color='k')\n", + "plt.plot(X1D[:, 0][y==0], np.zeros(4), \"bs\")\n", + "plt.plot(X1D[:, 0][y==1], np.zeros(5), \"g^\")\n", + "plt.gca().get_yaxis().set_ticks([])\n", + "plt.xlabel(r\"$x_1$\", fontsize=20)\n", + "plt.axis([-4.5, 4.5, -0.2, 0.2])\n", + "\n", + "plt.subplot(122)\n", + "plt.grid(True, which='both')\n", + "plt.axhline(y=0, color='k')\n", + "plt.axvline(x=0, color='k')\n", + "plt.plot(X2D[:, 0][y==0], X2D[:, 1][y==0], \"bs\")\n", + "plt.plot(X2D[:, 0][y==1], X2D[:, 1][y==1], \"g^\")\n", + "plt.xlabel(r\"$x_1$\", fontsize=20)\n", + "plt.ylabel(r\"$x_2$\", fontsize=20, rotation=0)\n", + "plt.gca().get_yaxis().set_ticks([0, 4, 8, 12, 16])\n", + "plt.plot([-4.5, 4.5], [6.5, 6.5], \"r--\", linewidth=3)\n", + "plt.axis([-4.5, 4.5, -1, 17])\n", + "plt.subplots_adjust(right=1)\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## The equations\n", + "\n", + "Suppose we define a polynomial transformation of degree two only (we continue to live in a plane with $x_i$ and $y_i$ as variables)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "z = \\phi(x_i) =\\left(x_i^2, y_i^2, \\sqrt{2}x_iy_i\\right).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With our new basis, the equations we solved earlier are basically the same, that is we have now (without the slack option for simplicity)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{z}_i^T\\boldsymbol{z}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$, and for the support vectors" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{z}_i+b)= 1 \\hspace{0.1cm}\\forall i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "from which we also find $b$.\n", + "To compute $\\boldsymbol{z}_i^T\\boldsymbol{z}_j$ we define the kernel $K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=\\boldsymbol{z}_i^T\\boldsymbol{z}_j= \\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "For the above example, the kernel reads" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=[x_i^2, y_i^2, \\sqrt{2}x_iy_i]^T\\begin{bmatrix} x_j^2 \\\\ y_j^2 \\\\ \\sqrt{2}x_jy_j \\end{bmatrix}=x_i^2x_j^2+2x_ix_jy_iy_j+y_i^2y_j^2.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We note that this is nothing but the dot product of the two original\n", + "vectors $(\\boldsymbol{x}_i^T\\boldsymbol{x}_j)^2$. Instead of thus computing the\n", + "product in the Lagrangian of $\\boldsymbol{z}_i^T\\boldsymbol{z}_j$ we simply compute\n", + "the dot product $(\\boldsymbol{x}_i^T\\boldsymbol{x}_j)^2$.\n", + "\n", + "\n", + "This leads to the so-called\n", + "kernel trick and the result leads to the same as if we went through\n", + "the trouble of performing the transformation\n", + "$\\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j)$ during the SVM calculations.\n", + "\n", + "\n", + "\n", + "## The problem to solve\n", + "Using our definition of the kernel We can rewrite again the Lagrangian" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{z}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$ in terms of a convex optimization problem" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1K(\\boldsymbol{x}_1,\\boldsymbol{x}_1) & y_1y_2K(\\boldsymbol{x}_1,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_1,\\boldsymbol{x}_n) \\\\\n", + "y_2y_1K(\\boldsymbol{x}_2,\\boldsymbol{x}_1) & y_2y_2(\\boldsymbol{x}_2,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_2,\\boldsymbol{x}_n) \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "y_ny_1K(\\boldsymbol{x}_n,\\boldsymbol{x}_1) & y_ny_2K(\\boldsymbol{x}_n\\boldsymbol{x}_2) & \\dots & \\dots & y_ny_nK(\\boldsymbol{x}_n,\\boldsymbol{x}_n) \\\\\n", + "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{1}\\boldsymbol{\\lambda},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", + "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", + "If we add the slack constants this leads to the additional constraint $0\\leq \\lambda_i \\leq C$.\n", + "\n", + "We can rewrite this (see the solutions below) in terms of a convex optimization problem of the type" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + " &\\mathrm{min}_{\\lambda}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{\\lambda}^T\\boldsymbol{P}\\boldsymbol{\\lambda}+\\boldsymbol{q}^T\\boldsymbol{\\lambda},\\\\ \\nonumber\n", + " &\\mathrm{subject\\hspace{0.1cm}to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{\\lambda} \\preceq \\boldsymbol{h} \\hspace{0.2cm} \\wedge \\boldsymbol{A}\\boldsymbol{\\lambda}=f.\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Below we discuss how to solve these equations. Here we note that the matrix $\\boldsymbol{P}$ has matrix elements $p_{ij}=y_iy_jK(\\boldsymbol{x}_i,\\boldsymbol{x}_j)$.\n", + "Given a kernel $K$ and the targets $y_i$ this matrix is easy to set up. The constraint $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$ leads to $f=0$ and $\\boldsymbol{A}=\\boldsymbol{y}$. How to set up the matrix $\\boldsymbol{G}$ is discussed later. Here note that the inequalities $0\\leq \\lambda_i \\leq C$ can be split up into\n", + "$0\\leq \\lambda_i$ and $\\lambda_i \\leq C$. These two inequalities define then the matrix $\\boldsymbol{G}$ and the vector $\\boldsymbol{h}$.\n", + "\n", + "\n", + "\n", + "## Different kernels and Mercer's theorem\n", + "\n", + "There are several popular kernels being used. These are\n", + "1. Linear: $K(\\boldsymbol{x},\\boldsymbol{y})=\\boldsymbol{x}^T\\boldsymbol{y}$,\n", + "\n", + "2. Polynomial: $K(\\boldsymbol{x},\\boldsymbol{y})=(\\boldsymbol{x}^T\\boldsymbol{y}+\\gamma)^d$,\n", + "\n", + "3. Gaussian Radial Basis Function: $K(\\boldsymbol{x},\\boldsymbol{y})=\\exp{\\left(-\\gamma\\vert\\vert\\boldsymbol{x}-\\boldsymbol{y}\\vert\\vert^2\\right)}$,\n", + "\n", + "4. Tanh: $K(\\boldsymbol{x},\\boldsymbol{y})=\\tanh{(\\boldsymbol{x}^T\\boldsymbol{y}+\\gamma)}$,\n", + "\n", + "and many other ones.\n", + "\n", + "An important theorem for us is [Mercer's\n", + "theorem](https://en.wikipedia.org/wiki/Mercer%27s_theorem). The\n", + "theorem states that if a kernel function $K$ is symmetric, continuous\n", + "and leads to a positive semi-definite matrix $\\boldsymbol{P}$ then there\n", + "exists a function $\\phi$ that maps $\\boldsymbol{x}_i$ and $\\boldsymbol{x}_j$ into\n", + "another space (possibly with much higher dimensions) such that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=\\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "So you can use $K$ as a kernel since you know $\\phi$ exists, even if\n", + "you don’t know what $\\phi$ is. \n", + "\n", + "Note that some frequently used kernels (such as the Sigmoid kernel)\n", + "don’t respect all of Mercer’s conditions, yet they generally work well\n", + "in practice.\n", + "\n", + "\n", + "\n", + "## The moons example" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "from __future__ import division, print_function, unicode_literals\n", + "\n", + "import numpy as np\n", + "np.random.seed(42)\n", + "\n", + "import matplotlib\n", + "import matplotlib.pyplot as plt\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", + "\n", + "\n", + "\n", + "from sklearn.pipeline import Pipeline\n", + "from sklearn.preprocessing import StandardScaler\n", + "from sklearn.svm import LinearSVC\n", + "\n", + "\n", + "from sklearn.datasets import make_moons\n", + "X, y = make_moons(n_samples=100, noise=0.15, random_state=42)\n", + "\n", + "def plot_dataset(X, y, axes):\n", + " plt.plot(X[:, 0][y==0], X[:, 1][y==0], \"bs\")\n", + " plt.plot(X[:, 0][y==1], X[:, 1][y==1], \"g^\")\n", + " plt.axis(axes)\n", + " plt.grid(True, which='both')\n", + " plt.xlabel(r\"$x_1$\", fontsize=20)\n", + " plt.ylabel(r\"$x_2$\", fontsize=20, rotation=0)\n", + "\n", + "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + "plt.show()\n", + "\n", + "from sklearn.datasets import make_moons\n", + "from sklearn.pipeline import Pipeline\n", + "from sklearn.preprocessing import PolynomialFeatures\n", + "\n", + "polynomial_svm_clf = Pipeline([\n", + " (\"poly_features\", PolynomialFeatures(degree=3)),\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", LinearSVC(C=10, loss=\"hinge\", random_state=42))\n", + " ])\n", + "\n", + "polynomial_svm_clf.fit(X, y)\n", + "\n", + "def plot_predictions(clf, axes):\n", + " x0s = np.linspace(axes[0], axes[1], 100)\n", + " x1s = np.linspace(axes[2], axes[3], 100)\n", + " x0, x1 = np.meshgrid(x0s, x1s)\n", + " X = np.c_[x0.ravel(), x1.ravel()]\n", + " y_pred = clf.predict(X).reshape(x0.shape)\n", + " y_decision = clf.decision_function(X).reshape(x0.shape)\n", + " plt.contourf(x0, x1, y_pred, cmap=plt.cm.brg, alpha=0.2)\n", + " plt.contourf(x0, x1, y_decision, cmap=plt.cm.brg, alpha=0.1)\n", + "\n", + "plot_predictions(polynomial_svm_clf, [-1.5, 2.5, -1, 1.5])\n", + "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + "\n", + "plt.show()\n", + "\n", + "\n", + "from sklearn.svm import SVC\n", + "\n", + "poly_kernel_svm_clf = Pipeline([\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", SVC(kernel=\"poly\", degree=3, coef0=1, C=5))\n", + " ])\n", + "poly_kernel_svm_clf.fit(X, y)\n", + "\n", + "poly100_kernel_svm_clf = Pipeline([\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", SVC(kernel=\"poly\", degree=10, coef0=100, C=5))\n", + " ])\n", + "poly100_kernel_svm_clf.fit(X, y)\n", + "\n", + "plt.figure(figsize=(11, 4))\n", + "\n", + "plt.subplot(121)\n", + "plot_predictions(poly_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])\n", + "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + "plt.title(r\"$d=3, r=1, C=5$\", fontsize=18)\n", + "\n", + "plt.subplot(122)\n", + "plot_predictions(poly100_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])\n", + "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + "plt.title(r\"$d=10, r=100, C=5$\", fontsize=18)\n", + "\n", + "plt.show()\n", + "\n", + "def gaussian_rbf(x, landmark, gamma):\n", + " return np.exp(-gamma * np.linalg.norm(x - landmark, axis=1)**2)\n", + "\n", + "gamma = 0.3\n", + "\n", + "x1s = np.linspace(-4.5, 4.5, 200).reshape(-1, 1)\n", + "x2s = gaussian_rbf(x1s, -2, gamma)\n", + "x3s = gaussian_rbf(x1s, 1, gamma)\n", + "\n", + "XK = np.c_[gaussian_rbf(X1D, -2, gamma), gaussian_rbf(X1D, 1, gamma)]\n", + "yk = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])\n", + "\n", + "plt.figure(figsize=(11, 4))\n", + "\n", + "plt.subplot(121)\n", + "plt.grid(True, which='both')\n", + "plt.axhline(y=0, color='k')\n", + "plt.scatter(x=[-2, 1], y=[0, 0], s=150, alpha=0.5, c=\"red\")\n", + "plt.plot(X1D[:, 0][yk==0], np.zeros(4), \"bs\")\n", + "plt.plot(X1D[:, 0][yk==1], np.zeros(5), \"g^\")\n", + "plt.plot(x1s, x2s, \"g--\")\n", + "plt.plot(x1s, x3s, \"b:\")\n", + "plt.gca().get_yaxis().set_ticks([0, 0.25, 0.5, 0.75, 1])\n", + "plt.xlabel(r\"$x_1$\", fontsize=20)\n", + "plt.ylabel(r\"Similarity\", fontsize=14)\n", + "plt.annotate(r'$\\mathbf{x}$',\n", + " xy=(X1D[3, 0], 0),\n", + " xytext=(-0.5, 0.20),\n", + " ha=\"center\",\n", + " arrowprops=dict(facecolor='black', shrink=0.1),\n", + " fontsize=18,\n", + " )\n", + "plt.text(-2, 0.9, \"$x_2$\", ha=\"center\", fontsize=20)\n", + "plt.text(1, 0.9, \"$x_3$\", ha=\"center\", fontsize=20)\n", + "plt.axis([-4.5, 4.5, -0.1, 1.1])\n", + "\n", + "plt.subplot(122)\n", + "plt.grid(True, which='both')\n", + "plt.axhline(y=0, color='k')\n", + "plt.axvline(x=0, color='k')\n", + "plt.plot(XK[:, 0][yk==0], XK[:, 1][yk==0], \"bs\")\n", + "plt.plot(XK[:, 0][yk==1], XK[:, 1][yk==1], \"g^\")\n", + "plt.xlabel(r\"$x_2$\", fontsize=20)\n", + "plt.ylabel(r\"$x_3$ \", fontsize=20, rotation=0)\n", + "plt.annotate(r'$\\phi\\left(\\mathbf{x}\\right)$',\n", + " xy=(XK[3, 0], XK[3, 1]),\n", + " xytext=(0.65, 0.50),\n", + " ha=\"center\",\n", + " arrowprops=dict(facecolor='black', shrink=0.1),\n", + " fontsize=18,\n", + " )\n", + "plt.plot([-0.1, 1.1], [0.57, -0.1], \"r--\", linewidth=3)\n", + "plt.axis([-0.1, 1.1, -0.1, 1.1])\n", + " \n", + "plt.subplots_adjust(right=1)\n", + "\n", + "plt.show()\n", + "\n", + "\n", + "x1_example = X1D[3, 0]\n", + "for landmark in (-2, 1):\n", + " k = gaussian_rbf(np.array([[x1_example]]), np.array([[landmark]]), gamma)\n", + " print(\"Phi({}, {}) = {}\".format(x1_example, landmark, k))\n", + "\n", + "rbf_kernel_svm_clf = Pipeline([\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", SVC(kernel=\"rbf\", gamma=5, C=0.001))\n", + " ])\n", + "rbf_kernel_svm_clf.fit(X, y)\n", + "\n", + "\n", + "from sklearn.svm import SVC\n", + "\n", + "gamma1, gamma2 = 0.1, 5\n", + "C1, C2 = 0.001, 1000\n", + "hyperparams = (gamma1, C1), (gamma1, C2), (gamma2, C1), (gamma2, C2)\n", + "\n", + "svm_clfs = []\n", + "for gamma, C in hyperparams:\n", + " rbf_kernel_svm_clf = Pipeline([\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", SVC(kernel=\"rbf\", gamma=gamma, C=C))\n", + " ])\n", + " rbf_kernel_svm_clf.fit(X, y)\n", + " svm_clfs.append(rbf_kernel_svm_clf)\n", + "\n", + "plt.figure(figsize=(11, 7))\n", + "\n", + "for i, svm_clf in enumerate(svm_clfs):\n", + " plt.subplot(221 + i)\n", + " plot_predictions(svm_clf, [-1.5, 2.5, -1, 1.5])\n", + " plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + " gamma, C = hyperparams[i]\n", + " plt.title(r\"$\\gamma = {}, C = {}$\".format(gamma, C), fontsize=16)\n", + "\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Mathematical optimization of convex functions\n", + "\n", + "A mathematical (quadratic) optimization problem, or just optimization problem, has the form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + " &\\mathrm{min}_{\\lambda}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{\\lambda}^T\\boldsymbol{P}\\boldsymbol{\\lambda}+\\boldsymbol{q}^T\\boldsymbol{\\lambda},\\\\ \\nonumber\n", + " &\\mathrm{subject\\hspace{0.1cm}to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{\\lambda} \\preceq \\boldsymbol{h} \\wedge \\boldsymbol{A}\\boldsymbol{\\lambda}=f.\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to some constraints for say a selected set $i=1,2,\\dots, n$.\n", + "In our case we are optimizing with respect to the Lagrangian multipliers $\\lambda_i$, and the\n", + "vector $\\boldsymbol{\\lambda}=[\\lambda_1, \\lambda_2,\\dots, \\lambda_n]$ is the optimization variable we are dealing with.\n", + "\n", + "In our case we are particularly interested in a class of optimization problems called convex optmization problems. \n", + "In our discussion on gradient descent methods we discussed at length the definition of a convex function. \n", + "\n", + "Convex optimization problems play a central role in applied mathematics and we recommend strongly [Boyd and Vandenberghe's text on the topics](http://web.stanford.edu/~boyd/cvxbook/).\n", + "\n", + "\n", + "\n", + "\n", + "## How do we solve these problems?\n", + "\n", + "If we use Python as programming language and wish to venture beyond\n", + "**scikit-learn**, **tensorflow** and similar software which makes our\n", + "lives so much easier, we need to dive into the wonderful world of\n", + "quadratic programming. We can, if we wish, solve the minimization\n", + "problem using say standard gradient methods or conjugate gradient\n", + "methods. However, these methods tend to exhibit a rather slow\n", + "converge. So, welcome to the promised land of quadratic programming.\n", + "\n", + "The functions we need are contained in the quadratic programming package **CVXOPT** and we need to import it together with **numpy** as" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy\n", + "import cvxopt" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This will make our life much easier. You don't need t write your own optimizer.\n", + "\n", + "\n", + "\n", + "## A simple example\n", + "\n", + "We remind ourselves about the general problem we want to solve" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + " &\\mathrm{min}_{x}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{P}\\boldsymbol{x}+\\boldsymbol{q}^T\\boldsymbol{x},\\\\ \\nonumber\n", + " &\\mathrm{subject\\hspace{0.1cm} to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{x} \\preceq \\boldsymbol{h} \\wedge \\boldsymbol{A}\\boldsymbol{x}=f.\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Let us show how to perform the optmization using a simple case. Assume we want to optimize the following problem" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + " &\\mathrm{min}_{x}\\hspace{0.2cm} \\frac{1}{2}x^2+5x+3y \\\\ \\nonumber\n", + " &\\mathrm{subject to} \\\\ \\nonumber\n", + " &x, y \\geq 0 \\\\ \\nonumber\n", + " &x+3y \\geq 15 \\\\ \\nonumber\n", + " &2x+5y \\leq 100 \\\\ \\nonumber\n", + " &3x+4y \\leq 80. \\\\ \\nonumber\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The minimization problem can be rewritten in terms of vectors and matrices as (with $x$ and $y$ being the unknowns)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{2}\\begin{bmatrix} x\\\\ y \\end{bmatrix}^T \\begin{bmatrix} 1 & 0\\\\ 0 & 0 \\end{bmatrix} \\begin{bmatrix} x \\\\ y \\end{bmatrix} + \\begin{bmatrix}3\\\\ 4 \\end{bmatrix}^T \\begin{bmatrix}x \\\\ y \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Similarly, we can now set up the inequalities (we need to change $\\geq$ to $\\leq$ by multiplying with $-1$ on bot sides) as the following matrix-vector equation" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{bmatrix} -1 & 0 \\\\ 0 & -1 \\\\ -1 & -3 \\\\ 2 & 5 \\\\ 3 & 4\\end{bmatrix}\\begin{bmatrix} x \\\\ y\\end{bmatrix} \\preceq \\begin{bmatrix}0 \\\\ 0\\\\ -15 \\\\ 100 \\\\ 80\\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We have collapsed all the inequalities into a single matrix $\\boldsymbol{G}$. We see also that our matrix" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{P} =\\begin{bmatrix} 1 & 0\\\\ 0 & 0 \\end{bmatrix}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "is clearly positive semi-definite (all eigenvalues larger or equal zero). \n", + "Finally, the vector $\\boldsymbol{h}$ is defined as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{h} = \\begin{bmatrix}0 \\\\ 0\\\\ -15 \\\\ 100 \\\\ 80\\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Since we don't have any equalities the matrix $\\boldsymbol{A}$ is set to zero\n", + "The following code solves the equations for us" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "# Import the necessary packages\n", + "import numpy\n", + "from cvxopt import matrix\n", + "from cvxopt import solvers\n", + "P = matrix(numpy.diag([1,0]), tc=’d’)\n", + "q = matrix(numpy.array([3,4]), tc=’d’)\n", + "G = matrix(numpy.array([[-1,0],[0,-1],[-1,-3],[2,5],[3,4]]), tc=’d’)\n", + "h = matrix(numpy.array([0,0,-15,100,80]), tc=’d’)\n", + "# Construct the QP, invoke solver\n", + "sol = solvers.qp(P,q,G,h)\n", + "# Extract optimal value and solution\n", + "sol[’x’] \n", + "sol[’primal objective’]" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Back to the more realistic cases\n", + "\n", + "We are now ready to return to our setup of the optmization problem for a more realistic case. Introducing the **slack** parameter $C$ we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1K(\\boldsymbol{x}_1,\\boldsymbol{x}_1) & y_1y_2K(\\boldsymbol{x}_1,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_1,\\boldsymbol{x}_n) \\\\\n", + "y_2y_1K(\\boldsymbol{x}_2,\\boldsymbol{x}_1) & y_2y_2K(\\boldsymbol{x}_2,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_2,\\boldsymbol{x}_n) \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "y_ny_1K(\\boldsymbol{x}_n,\\boldsymbol{x}_1) & y_ny_2K(\\boldsymbol{x}_n\\boldsymbol{x}_2) & \\dots & \\dots & y_ny_nK(\\boldsymbol{x}_n,\\boldsymbol{x}_n) \\\\\n", + "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{I}\\boldsymbol{\\lambda},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", + "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", + "With the slack constants this leads to the additional constraint $0\\leq \\lambda_i \\leq C$.\n", + "\n", + "**code will be added**" + ] + } + ], + "metadata": {}, + "nbformat": 4, + "nbformat_minor": 4 +} diff --git a/doc/src/LectureNotes/_build/html/_sources/chapter8.ipynb b/doc/src/LectureNotes/_build/html/_sources/chapter8.ipynb new file mode 100644 index 000000000..86dc8a18f --- /dev/null +++ b/doc/src/LectureNotes/_build/html/_sources/chapter8.ipynb @@ -0,0 +1,1923 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Dimensionality Reduction\n", + "\n", + "\n", + "## Reducing the number of degrees of freedom, overarching view\n", + "\n", + "Many Machine Learning problems involve thousands or even millions of\n", + "features for each training instance. Not only does this make training\n", + "extremely slow, it can also make it much harder to find a good\n", + "solution, as we will see. This problem is often referred to as the\n", + "curse of dimensionality. Fortunately, in real-world problems, it is\n", + "often possible to reduce the number of features considerably, turning\n", + "an intractable problem into a tractable one.\n", + "\n", + "Here we will discuss some of the most popular dimensionality reduction\n", + "techniques: the principal component analysis (PCA), Kernel PCA, and\n", + "Locally Linear Embedding (LLE). Furthermore, we will start by looking\n", + "at some simple preprocessing of the data which allow us to rescale the\n", + "data.\n", + "\n", + "Principal component analysis and its various variants deal with the\n", + "problem of fitting a low-dimensional [affine\n", + "subspace](https://en.wikipedia.org/wiki/Affine_space) to a set of of\n", + "data points in a high-dimensional space. With its family of methods it\n", + "is one of the most used tools in data modeling, compression and\n", + "visualization.\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Preprocessing our data\n", + "\n", + "Before we proceed however, we will discuss how to preprocess our\n", + "data. Till now and in connection with our previous examples we have\n", + "not met so many cases where we are too sensitive to the scaling of our\n", + "data. Normally the data may need a rescaling and/or may be sensitive\n", + "to extreme values. Scaling the data renders our inputs much more\n", + "suitable for the algorithms we want to employ.\n", + "\n", + "**Scikit-Learn** has several functions which allow us to rescale the\n", + "data, normally resulting in much better results in terms of various\n", + "accuracy scores. The **StandardScaler** function in **Scikit-Learn**\n", + "ensures that for each feature/predictor we study the mean value is\n", + "zero and the variance is one (every column in the design/feature\n", + "matrix). This scaling has the drawback that it does not ensure that\n", + "we have a particular maximum or minimum in our data set. Another\n", + "function included in **Scikit-Learn** is the **MinMaxScaler** which\n", + "ensures that all features are exactly between $0$ and $1$. The\n", + "\n", + "\n", + "## More preprocessing\n", + "\n", + "\n", + "The **Normalizer** scales each data\n", + "point such that the feature vector has a euclidean length of one. In other words, it\n", + "projects a data point on the circle (or sphere in the case of higher dimensions) with a\n", + "radius of 1. This means every data point is scaled by a different number (by the\n", + "inverse of it’s length).\n", + "This normalization is often used when only the direction (or angle) of the data matters,\n", + "not the length of the feature vector.\n", + "\n", + "The **RobustScaler** works similarly to the StandardScaler in that it\n", + "ensures statistical properties for each feature that guarantee that\n", + "they are on the same scale. However, the RobustScaler uses the median\n", + "and quartiles, instead of mean and variance. This makes the\n", + "RobustScaler ignore data points that are very different from the rest\n", + "(like measurement errors). These odd data points are also called\n", + "outliers, and might often lead to trouble for other scaling\n", + "techniques.\n", + "\n", + "\n", + "\n", + "\n", + "## Simple preprocessing examples, Franke function and regression" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "%matplotlib inline\n", + "\n", + "# Common imports\n", + "import os\n", + "import numpy as np\n", + "import pandas as pd\n", + "import matplotlib.pyplot as plt\n", + "import sklearn.linear_model as skl\n", + "from sklearn.metrics import mean_squared_error\n", + "from sklearn.model_selection import train_test_split\n", + "from sklearn.preprocessing import MinMaxScaler, StandardScaler, Normalizer\n", + "from sklearn.svm import SVR\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", + "\n", + "def FrankeFunction(x,y):\n", + "\tterm1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))\n", + "\tterm2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))\n", + "\tterm3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))\n", + "\tterm4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)\n", + "\treturn term1 + term2 + term3 + term4\n", + "\n", + "\n", + "def create_X(x, y, n ):\n", + "\tif len(x.shape) > 1:\n", + "\t\tx = np.ravel(x)\n", + "\t\ty = np.ravel(y)\n", + "\n", + "\tN = len(x)\n", + "\tl = int((n+1)*(n+2)/2)\t\t# Number of elements in beta\n", + "\tX = np.ones((N,l))\n", + "\n", + "\tfor i in range(1,n+1):\n", + "\t\tq = int((i)*(i+1)/2)\n", + "\t\tfor k in range(i+1):\n", + "\t\t\tX[:,q+k] = (x**(i-k))*(y**k)\n", + "\n", + "\treturn X\n", + "\n", + "\n", + "# Making meshgrid of datapoints and compute Franke's function\n", + "n = 5\n", + "N = 1000\n", + "x = np.sort(np.random.uniform(0, 1, N))\n", + "y = np.sort(np.random.uniform(0, 1, N))\n", + "z = FrankeFunction(x, y)\n", + "X = create_X(x, y, n=n) \n", + "# split in training and test data\n", + "X_train, X_test, y_train, y_test = train_test_split(X,z,test_size=0.2)\n", + "\n", + "\n", + "svm = SVR(gamma='auto',C=10.0)\n", + "svm.fit(X_train, y_train)\n", + "\n", + "# The mean squared error and R2 score\n", + "print(\"MSE before scaling: {:.2f}\".format(mean_squared_error(svm.predict(X_test), y_test)))\n", + "print(\"R2 score before scaling {:.2f}\".format(svm.score(X_test,y_test)))\n", + "\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", + "\n", + "print(\"Feature min values before scaling:\\n {}\".format(X_train.min(axis=0)))\n", + "print(\"Feature max values before scaling:\\n {}\".format(X_train.max(axis=0)))\n", + "\n", + "print(\"Feature min values after scaling:\\n {}\".format(X_train_scaled.min(axis=0)))\n", + "print(\"Feature max values after scaling:\\n {}\".format(X_train_scaled.max(axis=0)))\n", + "\n", + "svm = SVR(gamma='auto',C=10.0)\n", + "svm.fit(X_train_scaled, y_train)\n", + "\n", + "print(\"MSE after scaling: {:.2f}\".format(mean_squared_error(svm.predict(X_test_scaled), y_test)))\n", + "print(\"R2 score for scaled data: {:.2f}\".format(svm.score(X_test_scaled,y_test)))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Simple preprocessing examples, breast cancer data and classification, Support Vector Machines\n", + "\n", + "We show here how we can use a simple regression case on the breast\n", + "cancer data using support vector machines (SVM) as algorithm for\n", + "classification." + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "collapsed": false + }, + "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", + "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", + "\n", + "svm = SVC(C=100)\n", + "svm.fit(X_train, y_train)\n", + "print(\"Test set accuracy: {:.2f}\".format(svm.score(X_test,y_test)))\n", + "\n", + "from sklearn.preprocessing import MinMaxScaler, StandardScaler\n", + "scaler = MinMaxScaler()\n", + "scaler.fit(X_train)\n", + "X_train_scaled = scaler.transform(X_train)\n", + "X_test_scaled = scaler.transform(X_test)\n", + "\n", + "print(\"Feature min values before scaling:\\n {}\".format(X_train.min(axis=0)))\n", + "print(\"Feature max values before scaling:\\n {}\".format(X_train.max(axis=0)))\n", + "\n", + "print(\"Feature min values before scaling:\\n {}\".format(X_train_scaled.min(axis=0)))\n", + "print(\"Feature max values before scaling:\\n {}\".format(X_train_scaled.max(axis=0)))\n", + "\n", + "\n", + "svm.fit(X_train_scaled, y_train)\n", + "print(\"Test set accuracy scaled data with Min-Max scaling: {:.2f}\".format(svm.score(X_test_scaled,y_test)))\n", + "\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", + "\n", + "svm.fit(X_train_scaled, y_train)\n", + "print(\"Test set accuracy scaled data with Standar Scaler: {:.2f}\".format(svm.score(X_test_scaled,y_test)))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## More on Cancer Data, now with Logistic Regression" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": { + "collapsed": false + }, + "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.linear_model import LogisticRegression\n", + "cancer = load_breast_cancer()\n", + "\n", + "# Set up training data\n", + "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", + "logreg = LogisticRegression()\n", + "logreg.fit(X_train, y_train)\n", + "print(\"Test set accuracy: {:.2f}\".format(logreg.score(X_test,y_test)))\n", + "\n", + "# Scale 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", + "logreg.fit(X_train_scaled, y_train)\n", + "print(\"Test set accuracy scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Why should we think of reducing the dimensionality\n", + "\n", + "In addition to the plot of the features, we study now also the covariance (and the correlation matrix).\n", + "We use also **Pandas** to compute the correlation matrix." + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": { + "collapsed": false + }, + "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.linear_model import LogisticRegression\n", + "cancer = load_breast_cancer()\n", + "import pandas as pd\n", + "# Making a data frame\n", + "cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)\n", + "\n", + "fig, axes = plt.subplots(15,2,figsize=(10,20))\n", + "malignant = cancer.data[cancer.target == 0]\n", + "benign = cancer.data[cancer.target == 1]\n", + "ax = axes.ravel()\n", + "\n", + "for i in range(30):\n", + " _, bins = np.histogram(cancer.data[:,i], bins =50)\n", + " ax[i].hist(malignant[:,i], bins = bins, alpha = 0.5)\n", + " ax[i].hist(benign[:,i], bins = bins, alpha = 0.5)\n", + " ax[i].set_title(cancer.feature_names[i])\n", + " ax[i].set_yticks(())\n", + "ax[0].set_xlabel(\"Feature magnitude\")\n", + "ax[0].set_ylabel(\"Frequency\")\n", + "ax[0].legend([\"Malignant\", \"Benign\"], loc =\"best\")\n", + "fig.tight_layout()\n", + "plt.show()\n", + "\n", + "import seaborn as sns\n", + "correlation_matrix = cancerpd.corr().round(1)\n", + "# use the heatmap function from seaborn to plot the correlation matrix\n", + "# annot = True to print the values inside the square\n", + "sns.heatmap(data=correlation_matrix, annot=True)\n", + "plt.show()\n", + "\n", + "#print eigvalues of correlation matrix\n", + "EigValues, EigVectors = np.linalg.eig(correlation_matrix)\n", + "print(EigValues)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the above example we note two things. In the first plot we display\n", + "the overlap of benign and malignant tumors as functions of the various\n", + "features in the Wisconsing breast cancer data set. We see that for\n", + "some of the features we can distinguish clearly the benign and\n", + "malignant cases while for other features we cannot. This can point to\n", + "us which features may be of greater interest when we wish to classify\n", + "a benign or not benign tumour.\n", + "\n", + "In the second figure we have computed the so-called correlation\n", + "matrix, which in our case with thirty features becomes a $30\\times 30$\n", + "matrix.\n", + "\n", + "We constructed this matrix using **pandas** via the statements" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and then" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "correlation_matrix = cancerpd.corr().round(1)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Diagonalizing this matrix we can in turn say something about which\n", + "features are of relevance and which are not. But before we proceed we\n", + "need to define covariance and correlation matrices. This leads us to\n", + "the classical Principal Component Analysis (PCA) theorem with\n", + "applications.\n", + "\n", + "\n", + "\n", + "\n", + "## Basic ideas of the Principal Component Analysis (PCA)\n", + "\n", + "The principal component analysis deals with the problem of fitting a\n", + "low-dimensional affine subspace $S$ of dimension $d$ much smaller than\n", + "the totaldimension $D$ of the problem at hand (our data\n", + "set). Mathematically it can be formulated as a statistical problem or\n", + "a geometric problem. In our discussion of the theorem for the\n", + "classical PCA, we will stay with a statistical approach. This is also\n", + "what set the scene historically which for the PCA.\n", + "\n", + "We have a data set defined by a design/feature matrix $\\boldsymbol{X}$ (see below for its definition) \n", + "* Each data point is determined by $p$ extrinsic (measurement) variables\n", + "\n", + "* We may want to ask the following question: Are there fewer intrinsic variables (say $d << p$) that still approximately describe the data?\n", + "\n", + "* If so, these intrinsic variables may tell us something important and finding these intrinsic variables is what dimension reduction methods do. \n", + "\n", + "## Introducing the Covariance and Correlation functions\n", + "\n", + "Before we discuss the PCA theorem, we need to remind ourselves about\n", + "the definition of the covariance and the correlation function. These are quantities \n", + "\n", + "Suppose we have defined two vectors\n", + "$\\hat{x}$ and $\\hat{y}$ with $n$ elements each. The covariance matrix $\\boldsymbol{C}$ is defined as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", + " \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{y}] \\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where for example" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] =\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})(y_i- \\overline{y}).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With this definition and recalling that the variance is defined as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{var}[\\boldsymbol{x}]=\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})^2,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "we can rewrite the covariance matrix as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", + " \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] & \\mathrm{var}[\\boldsymbol{y}] \\\\\n", + " \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The covariance takes values between zero and infinity and may thus\n", + "lead to problems with loss of numerical precision for particularly\n", + "large values. It is common to scale the covariance matrix by\n", + "introducing instead the correlation matrix defined via the so-called\n", + "correlation function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]=\\frac{\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}]}{\\sqrt{\\mathrm{var}[\\boldsymbol{x}] \\mathrm{var}[\\boldsymbol{y}]}}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The correlation function is then given by values $\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]\n", + "\\in [-1,1]$. This avoids eventual problems with too large values. We\n", + "can then define the correlation matrix for the two vectors $\\boldsymbol{x}$\n", + "and $\\boldsymbol{y}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{K}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} 1 & \\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", + " \\mathrm{corr}[\\boldsymbol{y},\\boldsymbol{x}] & 1 \\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the above example this is the function we constructed using **pandas**.\n", + "\n", + "\n", + "## Correlation Function and Design/Feature Matrix\n", + "\n", + "In our derivation of the various regression algorithms like **Ordinary Least Squares** or **Ridge regression**\n", + "we defined the design/feature matrix $\\boldsymbol{X}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{X}=\\begin{bmatrix}\n", + "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", + "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", + "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", + "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", + "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", + "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$, with the predictors/features $p$ refering to the column numbers and the\n", + "entries $n$ being the row elements.\n", + "We can rewrite the design/feature matrix in terms of its column vectors as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{X}=\\begin{bmatrix} \\boldsymbol{x}_0 & \\boldsymbol{x}_1 & \\boldsymbol{x}_2 & \\dots & \\dots & \\boldsymbol{x}_{p-1}\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with a given vector" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{x}_i^T = \\begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \\dots & \\dots x_{n-1,i}\\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With these definitions, we can now rewrite our $2\\times 2$\n", + "correaltion/covariance matrix in terms of a moe general design/feature\n", + "matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$. This leads to a $p\\times p$\n", + "covariance matrix for the vectors $\\boldsymbol{x}_i$ with $i=0,1,\\dots,p-1$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}] = \\begin{bmatrix}\n", + "\\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & \\mathrm{var}[\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & \\mathrm{var}[\\boldsymbol{x}_{p-1}]\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and the correlation matrix" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{K}[\\boldsymbol{x}] = \\begin{bmatrix}\n", + "1 & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & 1 & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & 1 & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & 1\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Covariance Matrix Examples\n", + "\n", + "\n", + "The Numpy function **np.cov** calculates the covariance elements using\n", + "the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have\n", + "the exact mean values. The following simple function uses the\n", + "**np.vstack** function which takes each vector of dimension $1\\times n$\n", + "and produces a $2\\times n$ matrix $\\boldsymbol{W}$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{W} = \\begin{bmatrix} x_0 & y_0 \\\\\n", + " x_1 & y_1 \\\\\n", + " x_2 & y_2\\\\\n", + " \\dots & \\dots \\\\\n", + " x_{n-2} & y_{n-2}\\\\\n", + " x_{n-1} & y_{n-1} & \n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which in turn is converted into into the $2\\times 2$ covariance matrix\n", + "$\\boldsymbol{C}$ via the Numpy function **np.cov()**. We note that we can also calculate\n", + "the mean value of each set of samples $\\boldsymbol{x}$ etc using the Numpy\n", + "function **np.mean(x)**. We can also extract the eigenvalues of the\n", + "covariance matrix through the **np.linalg.eig()** function." + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "# Importing various packages\n", + "import numpy as np\n", + "n = 100\n", + "x = np.random.normal(size=n)\n", + "print(np.mean(x))\n", + "y = 4+3*x+np.random.normal(size=n)\n", + "print(np.mean(y))\n", + "W = np.vstack((x, y))\n", + "C = np.cov(W)\n", + "print(C)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Correlation Matrix\n", + "\n", + "The previous example can be converted into the correlation matrix by\n", + "simply scaling the matrix elements with the variances. We should also\n", + "subtract the mean values for each column. This leads to the following\n", + "code which sets up the correlations matrix for the previous example in\n", + "a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the $2\\times 2$ correlation matrix (since we have only two vectors)." + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "n = 100\n", + "# define two vectors \n", + "x = np.random.random(size=n)\n", + "y = 4+3*x+np.random.normal(size=n)\n", + "#scaling the x and y vectors \n", + "x = x - np.mean(x)\n", + "y = y - np.mean(y)\n", + "variance_x = np.sum(x@x)/n\n", + "variance_y = np.sum(y@y)/n\n", + "print(variance_x)\n", + "print(variance_y)\n", + "cov_xy = np.sum(x@y)/n\n", + "cov_xx = np.sum(x@x)/n\n", + "cov_yy = np.sum(y@y)/n\n", + "C = np.zeros((2,2))\n", + "C[0,0]= cov_xx/variance_x\n", + "C[1,1]= cov_yy/variance_y\n", + "C[0,1]= cov_xy/np.sqrt(variance_y*variance_x)\n", + "C[1,0]= C[0,1]\n", + "print(C)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We see that the matrix elements along the diagonal are one as they\n", + "should be and that the matrix is symmetric. Furthermore, diagonalizing\n", + "this matrix we easily see that it is a positive definite matrix.\n", + "\n", + "The above procedure with **numpy** can be made more compact if we use **pandas**.\n", + "\n", + "\n", + "## Correlation Matrix with Pandas\n", + "\n", + "We whow here how we can set up the correlation matrix using **pandas**, as done in this simple code" + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import pandas as pd\n", + "n = 10\n", + "x = np.random.normal(size=n)\n", + "x = x - np.mean(x)\n", + "y = 4+3*x+np.random.normal(size=n)\n", + "y = y - np.mean(y)\n", + "X = (np.vstack((x, y))).T\n", + "print(X)\n", + "Xpd = pd.DataFrame(X)\n", + "print(Xpd)\n", + "correlation_matrix = Xpd.corr()\n", + "print(correlation_matrix)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We expand this model to the Franke function discussed above.\n", + "\n", + "\n", + "## Correlation Matrix with Pandas and the Franke function" + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "# Common imports\n", + "import numpy as np\n", + "import pandas as pd\n", + "\n", + "\n", + "def FrankeFunction(x,y):\n", + "\tterm1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))\n", + "\tterm2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))\n", + "\tterm3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))\n", + "\tterm4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)\n", + "\treturn term1 + term2 + term3 + term4\n", + "\n", + "\n", + "def create_X(x, y, n ):\n", + "\tif len(x.shape) > 1:\n", + "\t\tx = np.ravel(x)\n", + "\t\ty = np.ravel(y)\n", + "\n", + "\tN = len(x)\n", + "\tl = int((n+1)*(n+2)/2)\t\t# Number of elements in beta\n", + "\tX = np.ones((N,l))\n", + "\n", + "\tfor i in range(1,n+1):\n", + "\t\tq = int((i)*(i+1)/2)\n", + "\t\tfor k in range(i+1):\n", + "\t\t\tX[:,q+k] = (x**(i-k))*(y**k)\n", + "\n", + "\treturn X\n", + "\n", + "\n", + "# Making meshgrid of datapoints and compute Franke's function\n", + "n = 4\n", + "N = 100\n", + "x = np.sort(np.random.uniform(0, 1, N))\n", + "y = np.sort(np.random.uniform(0, 1, N))\n", + "z = FrankeFunction(x, y)\n", + "X = create_X(x, y, n=n) \n", + "\n", + "Xpd = pd.DataFrame(X)\n", + "# subtract the mean values and set up the covariance matrix\n", + "Xpd = Xpd - Xpd.mean()\n", + "covariance_matrix = Xpd.cov()\n", + "print(covariance_matrix)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We note here that the covariance is zero for the first rows and\n", + "columns since all matrix elements in the design matrix were set to one\n", + "(we are fitting the function in terms of a polynomial of degree $n$).\n", + "\n", + "This means that the variance for these elements will be zero and will\n", + "cause problems when we set up the correlation matrix. We can simply\n", + "drop these elements and construct a correlation\n", + "matrix without these elements. \n", + "\n", + "\n", + "\n", + "## Rewriting the Covariance and/or Correlation Matrix\n", + "\n", + "We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix $\\boldsymbol{X}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}\\boldsymbol{X}^T= \\mathbb{E}[\\boldsymbol{X}\\boldsymbol{X}^T].\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "To see this let us simply look at a design matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{2\\times 2}$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{X}=\\begin{bmatrix}\n", + "x_{00} & x_{01}\\\\\n", + "x_{10} & x_{11}\\\\\n", + "\\end{bmatrix}=\\begin{bmatrix}\n", + "\\boldsymbol{x}_{0} & \\boldsymbol{x}_{1}\\\\\n", + "\\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If we then compute the expectation value" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbb{E}[\\boldsymbol{X}\\boldsymbol{X}^T] = \\frac{1}{n}\\boldsymbol{X}\\boldsymbol{X}^T=\\begin{bmatrix}\n", + "x_{00}^2+x_{01}^2 & x_{00}x_{10}+x_{01}x_{11}\\\\\n", + "x_{10}x_{00}+x_{11}x_{01} & x_{10}^2+x_{11}^2\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which is just" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]=\\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] \\\\\n", + " \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] \\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where we wrote $$\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]$$ to indicate that this the covariance of the vectors $\\boldsymbol{x}$ of the design/feature matrix $\\boldsymbol{X}$.\n", + "\n", + "It is easy to generalize this to a matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$.\n", + "\n", + "\n", + "\n", + "## Towards the PCA theorem\n", + "\n", + "We have that the covariance matrix (the correlation matrix involves a simple rescaling) is given as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}\\boldsymbol{X}^T= \\mathbb{E}[\\boldsymbol{X}\\boldsymbol{X}^T].\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Let us now assume that we can perform a series of orthogonal transformations where we employ some orthogonal matrices $\\boldsymbol{S}$.\n", + "These matrices are defined as $\\boldsymbol{S}\\in {\\mathbb{R}}^{p\\times p}$ and obey the orthogonality requirements $\\boldsymbol{S}\\boldsymbol{S}^T=\\boldsymbol{S}^T\\boldsymbol{S}=\\boldsymbol{I}$. The matrix can be written out in terms of the column vectors $\\boldsymbol{s}_i$ as $\\boldsymbol{S}=[\\boldsymbol{s}_0,\\boldsymbol{s}_1,\\dots,\\boldsymbol{s}_{p-1}]$ and $\\boldsymbol{s}_i \\in {\\mathbb{R}}^{p}$.\n", + "\n", + "Assume also that there is a transformation $\\boldsymbol{S}\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}^T=\\boldsymbol{C}[\\boldsymbol{y}]$ such that the new matrix $\\boldsymbol{C}[\\boldsymbol{y}]$ is diagonal with elements $[\\lambda_0,\\lambda_1,\\lambda_2,\\dots,\\lambda_{p-1}]$. \n", + "\n", + "That is we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{y}] = \\mathbb{E}[\\boldsymbol{S}\\boldsymbol{X}\\boldsymbol{X}^T\\boldsymbol{S}^T]=\\boldsymbol{S}\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}^T,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "since the matrix $\\boldsymbol{S}$ is not a data dependent matrix. Multiplying with $\\boldsymbol{S}^T$ from the left we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{S}^T\\boldsymbol{C}[\\boldsymbol{y}] = \\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}^T,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and since $\\boldsymbol{C}[\\boldsymbol{y}]$ is diagonal we have for a given eigenvalue $i$ of the covariance matrix that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{S}^T_i\\lambda_i = \\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}^T_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the derivation of the PCA theorem we will assume that the eigenvalues are ordered in descending order, that is\n", + "$\\lambda_0 > \\lambda_1 > \\dots > \\lambda_{p-1}$. \n", + "\n", + "\n", + "The eigenvalues tell us then how much we need to stretch the\n", + "corresponding eigenvectors. Dimensions with large eigenvalues have\n", + "thus large variations (large variance) and define therefore useful\n", + "dimensions. The data points are more spread out in the direction of\n", + "these eigenvectors. Smaller eigenvalues mean on the other hand that\n", + "the corresponding eigenvectors are shrunk accordingly and the data\n", + "points are tightly bunched together and there is not much variation in\n", + "these specific directions. Hopefully then we could leave it out\n", + "dimensions where the eigenvalues are very small. If $p$ is very large,\n", + "we could then aim at reducing $p$ to $l << p$ and handle only $l$\n", + "features/predictors.\n", + "\n", + "\n", + "## The Algorithm before theorem\n", + "\n", + "Here's how we would proceed in setting up the algorithm for the PCA, see also discussion below here. \n", + "* Set up the datapoints for the design/feature matrix $\\boldsymbol{X}$ with $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$, with the predictors/features $p$ referring to the column numbers and the entries $n$ being the row elements." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{X}=\\begin{bmatrix}\n", + "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", + "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", + "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", + "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", + "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", + "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "* Center the data by subtracting the mean value for each column. This leads to a new matrix $\\boldsymbol{X}\\rightarrow \\overline{\\boldsymbol{X}}$.\n", + "\n", + "* Compute then the covariance/correlation matrix $\\mathbb{E}[\\overline{\\boldsymbol{X}}\\overline{\\boldsymbol{X}}^T]$.\n", + "\n", + "* Find the eigenpairs of $\\boldsymbol{C}$ with eigenvalues $[\\lambda_0,\\lambda_1,\\dots,\\lambda_{p-1}]$ and eigenvectors $[\\boldsymbol{s}_0,\\boldsymbol{s}_1,\\dots,\\boldsymbol{s}_{p-1}]$.\n", + "\n", + "* Order the eigenvalue (and the eigenvectors accordingly) in order of decreasing eigenvalues.\n", + "\n", + "* Keep only those $l$ eigenvalues larger than a selected threshold value, discarding thus $p-l$ features since we expect small variations in the data here.\n", + "\n", + "## Writing our own PCA code\n", + "\n", + "We will use a simple example first with two-dimensional data\n", + "drawn from a multivariate normal distribution with the following mean and covariance matrix:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mu = (-1,2) \\qquad \\Sigma = \\begin{bmatrix} 4 & 2 \\\\\n", + "2 & 2\n", + "\\end{bmatrix}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that the mean refers to each column of data. \n", + "We will generate $n = 1000$ points $X = \\{ x_1, \\ldots, x_N \\}$ from\n", + "this distribution, and store them in the $1000 \\times 2$ matrix $\\boldsymbol{X}$.\n", + "\n", + "The following Python code aids in setting up the data and writing out the design matrix.\n", + "Note that the function **multivariate** returns also the covariance discussed above and that it is defined by dividing by $n-1$ instead of $n$." + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import pandas as pd\n", + "import matplotlib.pyplot as plt\n", + "from IPython.display import display\n", + "n = 10000\n", + "mean = (-1, 2)\n", + "cov = [[4, 2], [2, 2]]\n", + "X = np.random.multivariate_normal(mean, cov, n)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now we are going to implement the PCA algorithm. We will break it down into various substeps.\n", + "\n", + "### Compute the sample mean and center the data\n", + "\n", + "The first step of PCA is to compute the sample mean of the data and use it to center the data. Recall that the sample mean is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mu_n = \\frac{1}{n} \\sum_{i=1}^n x_i\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and the mean-centered data $\\bar{X} = \\{ \\bar{x}_1, \\ldots, \\bar{x}_n \\}$ takes the form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\bar{x}_i = x_i - \\mu_n.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "When you are done with these steps, print out $\\mu_n$ to verify it is\n", + "close to $\\mu$ and plot your mean centered data to verify it is\n", + "centered at the origin! Compare your code with the functionality from **Scikit-Learn** discussed above.\n", + "The following code elements perform these operations using **pandas** or using our own functionality for doing so. The latter, using **numpy** is rather simple through the **mean()** function." + ] + }, + { + "cell_type": "code", + "execution_count": 12, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "df = pd.DataFrame(X)\n", + "# Pandas does the centering for us\n", + "df = df -df.mean()\n", + "# we center it ourselves\n", + "X_centered = X - X.mean(axis=0)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Alternatively, we could use the functions we discussed\n", + "earlier for scaling the data set. That is, we could have used the\n", + "**StandardScaler** function in **Scikit-Learn**, a function which ensures\n", + "that for each feature/predictor we study the mean value is zero and\n", + "the variance is one (every column in the design/feature matrix). You\n", + "would then not get the same results, since we divide by the\n", + "variance. The diagonal covariance matrix elements will then be one,\n", + "while the non-diagonal ones need to be divided by $2\\sqrt{2}$ for our\n", + "specific case.\n", + "\n", + "### Compute the sample covariance\n", + "\n", + "Now we are going to use the mean centered data to compute the sample covariance of the data by using the following equation" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\Sigma_n = \\frac{1}{n-1} \\sum_{i=1}^n \\bar{x}_i^T \\bar{x}_i = \\frac{1}{n-1} \\sum_{i=1}^n (x_i - \\mu_n)^T (x_i - \\mu_n)\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where the data points $x_i \\in \\mathbb{R}^p$ (here in this example $p = 2$) are column vectors and $x^T$ is the transpose of $x$.\n", + "We can write our own code or simply use either the functionaly of **numpy** or that of **pandas**, as follows" + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "print(df.cov())\n", + "print(np.cov(X_centered.T))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that the way we define the covariance matrix here has a factor $n-1$ instead of $n$. This is included in the **cov()** function by **numpy** and **pandas**. \n", + "Our own code here is not very elegant and asks for obvious improvements. It is tailored to this specific $2\\times 2$ covariance matrix." + ] + }, + { + "cell_type": "code", + "execution_count": 14, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "# extract the relevant columns from the centered design matrix of dim n x 2\n", + "x = X_centered[:,0]\n", + "y = X_centered[:,1]\n", + "Cov = np.zeros((2,2))\n", + "Cov[0,1] = np.sum(x.T@y)/(n-1.0)\n", + "Cov[0,0] = np.sum(x.T@x)/(n-1.0)\n", + "Cov[1,1] = np.sum(y.T@y)/(n-1.0)\n", + "Cov[1,0]= Cov[0,1]\n", + "print(\"Centered covariance using own code\")\n", + "print(Cov)\n", + "plt.plot(x, y, 'x')\n", + "plt.axis('equal')\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Depending on the number of points $n$, we will get results that are close to the covariance values defined above.\n", + "The plot shows how the data are clustered around a line with slope close to one. Is this expected?\n", + "\n", + "### Diagonalize the sample covariance matrix to obtain the principal components\n", + "\n", + "Now we are ready to solve for the principal components! To do so we\n", + "diagonalize the sample covariance matrix $\\Sigma$. We can use the\n", + "function **np.linalg.eig** to do so. It will return the eigenvalues and\n", + "eigenvectors of $\\Sigma$. Once we have these we can perform the \n", + "following tasks:\n", + "\n", + "* We compute the percentage of the total variance captured by the first principal component\n", + "\n", + "* We plot the mean centered data and lines along the first and second principal components\n", + "\n", + "* Then we project the mean centered data onto the first and second principal components, and plot the projected data. \n", + "\n", + "* Finally, we approximate the data as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_i \\approx \\tilde{x}_i = \\mu_n + \\langle x_i, v_0 \\rangle v_0\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $v_0$ is the first principal component. \n", + "\n", + "Collecting all these steps we can write our own PCA function and\n", + "compare this with the functionality included in **Scikit-Learn**. \n", + "\n", + "The code here outlines some of the elements we could include in the\n", + "analysis. Feel free to extend upon this in order to address the above\n", + "questions." + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "# diagonalize and obtain eigenvalues, not necessarily sorted\n", + "EigValues, EigVectors = np.linalg.eig(Cov)\n", + "# sort eigenvectors and eigenvalues\n", + "#permute = EigValues.argsort()\n", + "#EigValues = EigValues[permute]\n", + "#EigVectors = EigVectors[:,permute]\n", + "print(\"Eigenvalues of Covariance matrix\")\n", + "for i in range(2):\n", + " print(EigValues[i])\n", + "FirstEigvector = EigVectors[:,0]\n", + "SecondEigvector = EigVectors[:,1]\n", + "print(\"First eigenvector\")\n", + "print(FirstEigvector)\n", + "print(\"Second eigenvector\")\n", + "print(SecondEigvector)\n", + "#thereafter we do a PCA with Scikit-learn\n", + "from sklearn.decomposition import PCA\n", + "pca = PCA(n_components = 2)\n", + "X2Dsl = pca.fit_transform(X)\n", + "print(\"Eigenvector of largest eigenvalue\")\n", + "print(pca.components_.T[:, 0])" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This code does not contain all the above elements, but it shows how we can use **Scikit-Learn** to extract the eigenvector which corresponds to the largest eigenvalue. Try to address the questions we pose before the above code. Try also to change the values of the covariance matrix by making one of the diagonal elements much larger than the other. What do you observe then? \n", + "\n", + "\n", + "## Classical PCA Theorem\n", + "\n", + "We assume now that we have a design matrix $\\boldsymbol{X}$ which has been\n", + "centered as discussed above. For the sake of simplicity we skip the\n", + "overline symbol. The matrix is defined in terms of the various column\n", + "vectors $[\\boldsymbol{x}_0,\\boldsymbol{x}_1,\\dots, \\boldsymbol{x}_{p-1}]$ each with dimension\n", + "$\\boldsymbol{x}\\in {\\mathbb{R}}^{n}$.\n", + "\n", + "We assume also that we have an orthogonal transformation $\\boldsymbol{W}\\in {\\mathbb{R}}^{p\\times p}$. We define the reconstruction error (which is similar to the mean squared error we have seen before) as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{W},\\boldsymbol{Z}) = \\frac{1}{n}\\sum_i (\\boldsymbol{x}_i - \\overline{\\boldsymbol{x}}_i)^2,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $\\overline{\\boldsymbol{x}}_i = \\boldsymbol{W}\\boldsymbol{z}_i$, where $\\boldsymbol{z}_i$ is a row vector with dimension ${\\mathbb{R}}^{n}$ of the matrix\n", + "$\\boldsymbol{Z}\\in{\\mathbb{R}}^{p\\times n}$. When doing PCA we want to reduce this dimensionality. \n", + "\n", + "The PCA theorem states that minimizing the above reconstruction error\n", + "corresponds to setting $\\boldsymbol{W}=\\boldsymbol{S}$, the orthogonal matrix which\n", + "diagonalizes the empirical covariance(correlation) matrix. The optimal\n", + "low-dimensional encoding of the data is then given by a set of vectors\n", + "$\\boldsymbol{z}_i$ with at most $l$ vectors, with $l << p$, defined by the\n", + "orthogonal projection of the data onto the columns spanned by the\n", + "eigenvectors of the covariance(correlations matrix).\n", + "\n", + "The proof which follows will be updated by mid January 2020.\n", + "\n", + "\n", + "## Proof of the PCA Theorem\n", + "\n", + "To show the PCA theorem let us start with the assumption that there is one vector $\\boldsymbol{w}_0$ which corresponds to a solution which minimized the reconstruction error $J$. This is an orthogonal vector. It means that we now approximate the reconstruction error in terms of $\\boldsymbol{w}_0$ and $\\boldsymbol{z}_0$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{w}_0,\\boldsymbol{z}_0)= \\frac{1}{n}\\sum_i (\\boldsymbol{x}_i - z_{i0}\\boldsymbol{w}_0)^2=\\frac{1}{n}\\sum_i (\\boldsymbol{x}_i^T\\boldsymbol{x}_i - 2z_{i0}\\boldsymbol{w}_0^T\\boldsymbol{x}_i+z_{i0}^2\\boldsymbol{w}_0^T\\boldsymbol{w}_0),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which we can rewrite due to the orthogonality of $\\boldsymbol{w}_i$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{w}_0,\\boldsymbol{z}_0)=\\frac{1}{n}\\sum_i (\\boldsymbol{x}_i^T\\boldsymbol{x}_i - 2z_{i0}\\boldsymbol{w}_0^T\\boldsymbol{x}_i+z_{i0}^2).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Minimizing $J$ with respect to the unknown parameters $z_{0i}$ we obtain that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "z_{i0}=\\boldsymbol{w}_0^T\\boldsymbol{x}_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where the vectors on the rhs are known. \n", + "\n", + "\n", + "\n", + "## PCA Proof continued\n", + "\n", + "We have now found the unknown parameters $z_{i0}$. These correspond to the projected coordinates and we can write" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{w}_0)= \\frac{1}{p}\\sum_i (\\boldsymbol{x}_i^T\\boldsymbol{x}_i - z_{i0}^2)=\\mathrm{const}-\\frac{1}{n}\\sum_i z_{i0}^2.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We can show that the variance of the projected coordinates defined by $\\boldsymbol{w}_0^T\\boldsymbol{x}_i$ are given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{var}[\\boldsymbol{w}_0^T\\boldsymbol{x}_i] = \\frac{1}{n}\\sum_i z_{i0}^2,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "since the expectation value of" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbb{E}[\\boldsymbol{w}_0^T\\boldsymbol{x}_i] = \\mathbb{E}[z_{i0}]= \\boldsymbol{w}_0^T\\mathbb{E}[\\boldsymbol{x}_i]=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where we have used the fact that our data are centered.\n", + "\n", + "Recalling our definition of the covariance as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}\\boldsymbol{X}^T=\\mathbb{E}[\\boldsymbol{X}\\boldsymbol{X}^T],\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "we have thus that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{var}[\\boldsymbol{w}_0^T\\boldsymbol{x}_i] = \\frac{1}{n}\\sum_i z_{i0}^2=\\boldsymbol{w}_0^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We are almost there, we have obtained a relation between minimizing\n", + "the reconstruction error and the variance and the covariance\n", + "matrix. Minimizing the error is equivalent to maximizing the variance\n", + "of the projected data.\n", + "\n", + "\n", + "## The final step\n", + "\n", + "We could trivially maximize the variance of the projection (and\n", + "thereby minimize the error in the reconstruction function) by letting\n", + "the norm-2 of $\\boldsymbol{w}_0$ go to infinity. However, this norm since we\n", + "want the matrix $\\boldsymbol{W}$ to be an orthogonal matrix, is constrained by\n", + "$\\vert\\vert \\boldsymbol{w}_0 \\vert\\vert_2^2=1$. Imposing this condition via a\n", + "Lagrange multiplier we can then in turn maximize" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{w}_0)= \\boldsymbol{w}_0^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0+\\lambda_0(1-\\boldsymbol{w}_0^T\\boldsymbol{w}_0).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Taking the derivative with respect to $\\boldsymbol{w}_0$ we obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial J(\\boldsymbol{w}_0)}{\\partial \\boldsymbol{w}_0}= 2\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0-2\\lambda_0\\boldsymbol{w}_0=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "meaning that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0=\\lambda_0\\boldsymbol{w}_0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "**The direction that maximizes the variance (or minimizes the construction error) is an eigenvector of the covariance matrix**! If we left multiply with $\\boldsymbol{w}_0^T$ we have the variance of the projected data is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{w}_0^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0=\\lambda_0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If we want to maximize the variance (minimize the construction error)\n", + "we simply pick the eigenvector of the covariance matrix with the\n", + "largest eigenvalue. This establishes the link between the minimization\n", + "of the reconstruction function $J$ in terms of an orthogonal matrix\n", + "and the maximization of the variance and thereby the covariance of our\n", + "observations encoded in the design/feature matrix $\\boldsymbol{X}$.\n", + "\n", + "The proof\n", + "for the other eigenvectors $\\boldsymbol{w}_1,\\boldsymbol{w}_2,\\dots$ can be\n", + "established by applying the above arguments and using the fact that\n", + "our basis of eigenvectors is orthogonal, see [Murphy chapter\n", + "12.2](https://mitpress.mit.edu/books/machine-learning-1). The\n", + "discussion in chapter 12.2 of Murphy's text has also a nice link with\n", + "the Singular Value Decomposition theorem. For categorical data, see\n", + "chapter 12.4 and discussion therein.\n", + "\n", + "Additional part of the proof for the other eigenvectors will be added by mid January 2020.\n", + "\n", + "\n", + "## Geometric Interpretation and link with Singular Value Decomposition\n", + "\n", + "This material will be added by mid January 2020.\n", + "\n", + "\n", + "\n", + "## Principal Component Analysis\n", + "\n", + "Principal Component Analysis (PCA) is by far the most popular dimensionality reduction algorithm.\n", + "First it identifies the hyperplane that lies closest to the data, and then it projects the data onto it.\n", + "\n", + "The following Python code uses NumPy’s **svd()** function to obtain all the principal components of the\n", + "training set, then extracts the first two principal components. First we center the data using either **pandas** or our own code" + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import pandas as pd\n", + "from IPython.display import display\n", + "np.random.seed(100)\n", + "# setting up a 10 x 5 vanilla matrix \n", + "rows = 10\n", + "cols = 5\n", + "X = np.random.randn(rows,cols)\n", + "df = pd.DataFrame(X)\n", + "# Pandas does the centering for us\n", + "df = df -df.mean()\n", + "display(df)\n", + "\n", + "# we center it ourselves\n", + "X_centered = X - X.mean(axis=0)\n", + "# Then check the difference between pandas and our own set up\n", + "print(X_centered-df)\n", + "#Now we do an SVD\n", + "U, s, V = np.linalg.svd(X_centered)\n", + "c1 = V.T[:, 0]\n", + "c2 = V.T[:, 1]\n", + "W2 = V.T[:, :2]\n", + "X2D = X_centered.dot(W2)\n", + "print(X2D)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "PCA assumes that the dataset is centered around the origin. Scikit-Learn’s PCA classes take care of centering\n", + "the data for you. However, if you implement PCA yourself (as in the preceding example), or if you use other libraries, don’t\n", + "forget to center the data first.\n", + "\n", + "Once you have identified all the principal components, you can reduce the dimensionality of the dataset\n", + "down to $d$ dimensions by projecting it onto the hyperplane defined by the first $d$ principal components.\n", + "Selecting this hyperplane ensures that the projection will preserve as much variance as possible." + ] + }, + { + "cell_type": "code", + "execution_count": 17, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "W2 = V.T[:, :2]\n", + "X2D = X_centered.dot(W2)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## PCA and scikit-learn\n", + "\n", + "Scikit-Learn’s PCA class implements PCA using SVD decomposition just like we did before. The\n", + "following code applies PCA to reduce the dimensionality of the dataset down to two dimensions (note\n", + "that it automatically takes care of centering the data):" + ] + }, + { + "cell_type": "code", + "execution_count": 18, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "#thereafter we do a PCA with Scikit-learn\n", + "from sklearn.decomposition import PCA\n", + "pca = PCA(n_components = 2)\n", + "X2D = pca.fit_transform(X)\n", + "print(X2D)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "After fitting the PCA transformer to the dataset, you can access the principal components using the\n", + "components variable (note that it contains the PCs as horizontal vectors, so, for example, the first\n", + "principal component is equal to" + ] + }, + { + "cell_type": "code", + "execution_count": 19, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "pca.components_.T[:, 0]." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Another very useful piece of information is the explained variance ratio of each principal component,\n", + "available via the $explained\\_variance\\_ratio$ variable. It indicates the proportion of the dataset’s\n", + "variance that lies along the axis of each principal component. \n", + "\n", + "\n", + "## Back to the Cancer Data\n", + "We can now repeat the above but applied to real data, in this case our breast cancer data.\n", + "Here we compute performance scores on the training data using logistic regression." + ] + }, + { + "cell_type": "code", + "execution_count": 20, + "metadata": { + "collapsed": false + }, + "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.linear_model import LogisticRegression\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", + "\n", + "logreg = LogisticRegression()\n", + "logreg.fit(X_train, y_train)\n", + "print(\"Train set accuracy from Logistic Regression: {:.2f}\".format(logreg.score(X_train,y_train)))\n", + "# We 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", + "# Then perform again a log reg fit\n", + "logreg.fit(X_train_scaled, y_train)\n", + "print(\"Train set accuracy scaled data: {:.2f}\".format(logreg.score(X_train_scaled,y_train)))\n", + "#thereafter we do a PCA with Scikit-learn\n", + "from sklearn.decomposition import PCA\n", + "pca = PCA(n_components = 2)\n", + "X2D_train = pca.fit_transform(X_train_scaled)\n", + "# and finally compute the log reg fit and the score on the training data\t\n", + "logreg.fit(X2D_train,y_train)\n", + "print(\"Train set accuracy scaled and PCA data: {:.2f}\".format(logreg.score(X2D_train,y_train)))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We see that our training data after the PCA decomposition has a performance similar to the non-scaled data. \n", + "\n", + "\n", + "## More on the PCA\n", + "\n", + "Instead of arbitrarily choosing the number of dimensions to reduce down to, it is generally preferable to\n", + "choose the number of dimensions that add up to a sufficiently large portion of the variance (e.g., 95%).\n", + "Unless, of course, you are reducing dimensionality for data visualization — in that case you will\n", + "generally want to reduce the dimensionality down to 2 or 3.\n", + "The following code computes PCA without reducing dimensionality, then computes the minimum number\n", + "of dimensions required to preserve 95% of the training set’s variance:" + ] + }, + { + "cell_type": "code", + "execution_count": 21, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "pca = PCA()\n", + "pca.fit(X)\n", + "cumsum = np.cumsum(pca.explained_variance_ratio_)\n", + "d = np.argmax(cumsum >= 0.95) + 1" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "You could then set $n\\_components=d$ and run PCA again. However, there is a much better option: instead\n", + "of specifying the number of principal components you want to preserve, you can set $n\\_components$ to be\n", + "a float between 0.0 and 1.0, indicating the ratio of variance you wish to preserve:" + ] + }, + { + "cell_type": "code", + "execution_count": 22, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "pca = PCA(n_components=0.95)\n", + "X_reduced = pca.fit_transform(X)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Incremental PCA\n", + "\n", + "One problem with the preceding implementation of PCA is that it requires the whole training set to fit in\n", + "memory in order for the SVD algorithm to run. Fortunately, Incremental PCA (IPCA) algorithms have\n", + "been developed: you can split the training set into mini-batches and feed an IPCA algorithm one minibatch\n", + "at a time. This is useful for large training sets, and also to apply PCA online (i.e., on the fly, as new\n", + "instances arrive).\n", + "\n", + "\n", + "## Randomized PCA\n", + "\n", + "Scikit-Learn offers yet another option to perform PCA, called Randomized PCA. This is a stochastic\n", + "algorithm that quickly finds an approximation of the first d principal components. Its computational\n", + "complexity is $O(m \\times d^2)+O(d^3)$, instead of $O(m \\times n^2) + O(n^3)$, so it is dramatically faster than the\n", + "previous algorithms when $d$ is much smaller than $n$.\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Kernel PCA\n", + "\n", + "The kernel trick is a mathematical technique that implicitly maps instances into a\n", + "very high-dimensional space (called the feature space), enabling nonlinear classification and regression\n", + "with Support Vector Machines. Recall that a linear decision boundary in the high-dimensional feature\n", + "space corresponds to a complex nonlinear decision boundary in the original space.\n", + "It turns out that the same trick can be applied to PCA, making it possible to perform complex nonlinear\n", + "projections for dimensionality reduction. This is called Kernel PCA (kPCA). It is often good at\n", + "preserving clusters of instances after projection, or sometimes even unrolling datasets that lie close to a\n", + "twisted manifold.\n", + "For example, the following code uses Scikit-Learn’s KernelPCA class to perform kPCA with an" + ] + }, + { + "cell_type": "code", + "execution_count": 23, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "from sklearn.decomposition import KernelPCA\n", + "rbf_pca = KernelPCA(n_components = 2, kernel=\"rbf\", gamma=0.04)\n", + "X_reduced = rbf_pca.fit_transform(X)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## LLE\n", + "\n", + "Locally Linear Embedding (LLE) is another very powerful nonlinear dimensionality reduction\n", + "(NLDR) technique. It is a Manifold Learning technique that does not rely on projections like the previous\n", + "algorithms. In a nutshell, LLE works by first measuring how each training instance linearly relates to its\n", + "closest neighbors (c.n.), and then looking for a low-dimensional representation of the training set where\n", + "these local relationships are best preserved (more details shortly). \n", + "\n", + "\n", + "\n", + "\n", + "## Other techniques\n", + "\n", + "\n", + "There are many other dimensionality reduction techniques, several of which are available in Scikit-Learn.\n", + "\n", + "Here are some of the most popular:\n", + "* **Multidimensional Scaling (MDS)** reduces dimensionality while trying to preserve the distances between the instances.\n", + "\n", + "* **Isomap** creates a graph by connecting each instance to its nearest neighbors, then reduces dimensionality while trying to preserve the geodesic distances between the instances.\n", + "\n", + "* **t-Distributed Stochastic Neighbor Embedding** (t-SNE) reduces dimensionality while trying to keep similar instances close and dissimilar instances apart. It is mostly used for visualization, in particular to visualize clusters of instances in high-dimensional space (e.g., to visualize the MNIST images in 2D).\n", + "\n", + "* Linear Discriminant Analysis (LDA) is actually a classification algorithm, but during training it learns the most discriminative axes between the classes, and these axes can then be used to define a hyperplane onto which to project the data. The benefit is that the projection will keep classes as far apart as possible, so LDA is a good technique to reduce dimensionality before running another classification algorithm such as a Support Vector Machine (SVM) classifier discussed in the SVM lectures." + ] + } + ], + "metadata": {}, + "nbformat": 4, + "nbformat_minor": 4 +} diff --git a/doc/src/LectureNotes/_build/html/chapter1.html b/doc/src/LectureNotes/_build/html/chapter1.html index 20fe64aea..de400ade1 100644 --- a/doc/src/LectureNotes/_build/html/chapter1.html +++ b/doc/src/LectureNotes/_build/html/chapter1.html @@ -174,6 +174,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/chapter2.html b/doc/src/LectureNotes/_build/html/chapter2.html index 914dd94ed..c699338e4 100644 --- a/doc/src/LectureNotes/_build/html/chapter2.html +++ b/doc/src/LectureNotes/_build/html/chapter2.html @@ -175,6 +175,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • @@ -1001,27 +1011,27 @@ uncorrelated.

    -
    1.5027679581515354
    -[[ 4.01839868  4.38511101  9.23577076  8.53622276  4.78693205  9.01249172
    -   5.62006613  2.52380443  6.68351121  4.12787844]
    - [ 4.38511101  4.78528891 10.07861174  9.31522416  5.22377946  9.83495664
    -   6.13294396  2.7541226   7.29343725  4.50458172]
    - [ 9.23577076 10.07861174 21.22722716 19.61940636 11.00214554 20.71404911
    -  12.9169967   5.80063878 15.36118796  9.48739587]
    - [ 8.53622276  9.31522416 19.61940636 18.13336726 10.16880644 19.14509813
    -  11.9386204   5.3612791  14.19768049  8.76878895]
    - [ 4.78693205  5.22377946 11.00214554 10.16880644  5.70245024 10.73616358
    -   6.69492424  3.00649122  7.96175706  4.91735022]
    - [ 9.01249172  9.83495664 20.71404911 19.14509813 10.73616358 20.21327739
    -  12.60472232  5.66040565 14.98982413  9.25803368]
    - [ 5.62006613  6.13294396 12.9169967  11.9386204   6.69492424 12.60472232
    -   7.86013182  3.52975127  9.34744857  5.77318272]
    - [ 2.52380443  2.7541226   5.80063878  5.3612791   3.00649122  5.66040565
    -   3.52975127  1.58510624  4.19766095  2.59256454]
    - [ 6.68351121  7.29343725 15.36118796 14.19768049  7.96175706 14.98982413
    -   9.34744857  4.19766095 11.11619967  6.86560096]
    - [ 4.12787844  4.50458172  9.48739587  8.76878895  4.91735022  9.25803368
    -   5.77318272  2.59256454  6.86560096  4.24034094]]
    +
    9.106279149747735
    +[[  1.87336856   1.77787047   1.44771535   6.44982327  11.43684153
    +    5.83694909   1.84228806   7.37557482  -2.58314202   6.48643762]
    + [  1.77787047   1.68724056   1.37391564   6.12103277  10.85382947
    +    5.53940088   1.74837435   6.9995926   -2.45146205   6.15578065]
    + [  1.44771535   1.37391564   1.11877597   4.98434123   8.83824539
    +    4.51071987   1.42369673   5.69975023  -1.99621924   5.01263633]
    + [  6.44982327   6.12103277   4.98434123  22.2061057   39.37591798
    +   20.09604032   6.34281617  25.39337703  -8.89350334  22.33216531]
    + [ 11.43684153  10.85382947   8.83824539  39.37591798  69.82146882
    +   35.63434516  11.2470963   45.02759486 -15.76998069  39.59944717]
    + [  5.83694909   5.53940088   4.51071987  20.09604032  35.63434516
    +   18.18647726   5.74011     22.9804512   -8.04842615  20.21012151]
    + [  1.84228806   1.74837435   1.42369673   6.34281617  11.2470963
    +    5.74011      1.8117232    7.25320885  -2.54028588   6.37882306]
    + [  7.37557482   6.9995926    5.69975023  25.39337703  45.02759486
    +   22.9804512    7.25320885  29.03812156 -10.16999948  25.53753014]
    + [ -2.58314202  -2.45146205  -1.99621924  -8.89350334 -15.76998069
    +   -8.04842615  -2.54028588 -10.16999948   3.56183127  -8.94398998]
    + [  6.48643762   6.15578065   5.01263633  22.33216531  39.59944717
    +   20.21012151   6.37882306  25.53753014  -8.94398998  22.45894054]]
     
    @@ -1329,15 +1339,15 @@ more practically oriented methods like the blocking technique.

    -
    -0.02709116808235872
    -4.0262891855828515
    --0.05083752107727271
    -1.1034925742304618 9.662232920789233 19.396576628082066
    -3.1026745228913506 3.57651731449913 9.947888130154134
    -[[ 1.10349257  3.10267452  3.57651731]
    - [ 3.10267452  9.66223292  9.94788813]
    - [ 3.57651731  9.94788813 19.39657663]]
    -[26.46728898  0.08444587  3.61056727]
    +
    0.06894012083823547
    +4.139781119573823
    +0.04321525078901231
    +1.0006918520539008 10.50426403458282 18.88724031810869
    +3.0717579594084814 3.4645963550106305 10.40024628605229
    +[[ 1.00069185  3.07175796  3.46459636]
    + [ 3.07175796 10.50426403 10.40024629]
    + [ 3.46459636 10.40024629 18.88724032]]
    +[26.72833966  0.07676079  3.58709575]
     
    @@ -1744,7 +1754,7 @@ assumption for approximating \(\sigma
    -
    0.02793163482104733 1.025167138849349
    +
    -0.027481252820017347 1.0170183171235068
     
    _images/chapter2_184_1.png diff --git a/doc/src/LectureNotes/_build/html/chapter3.html b/doc/src/LectureNotes/_build/html/chapter3.html index 1c4d89f6a..489503811 100644 --- a/doc/src/LectureNotes/_build/html/chapter3.html +++ b/doc/src/LectureNotes/_build/html/chapter3.html @@ -175,6 +175,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • @@ -700,8 +710,8 @@ developed in the 1970s, namely EISPACK and LINPACK. We describe them shortly he
    -
    [-0.80600218 -0.30092    -0.79536928  0.14039618  0.5768749   0.74732035
    - -2.28459617 -0.84483144 -1.24760167  1.04875861]
    +
    [ 0.99499832 -0.89728339 -1.69744895 -1.03875025 -0.07638981  0.18716123
    + -0.27804028  0.72149922  1.25862131 -0.7970463 ]
     
    diff --git a/doc/src/LectureNotes/_build/html/chapter4.html b/doc/src/LectureNotes/_build/html/chapter4.html index c15fee6d0..02dbedac4 100644 --- a/doc/src/LectureNotes/_build/html/chapter4.html +++ b/doc/src/LectureNotes/_build/html/chapter4.html @@ -175,6 +175,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • @@ -1806,13 +1816,13 @@ but now splitting the data into a training set and a test set.

    Training R2
    -0.9999853406074647
    +0.9999886705644145
     Training MSE
    -6.359080163429899
    +3.90943518299982
     Test R2
    -0.9999859407754539
    +0.9999697792755088
     Test MSE
    -6.980914000813206
    +25.32441051671905
     
    @@ -1943,7 +1953,7 @@ dtype: int64
    -
    <matplotlib.axes._subplots.AxesSubplot at 0x7fddb4c436d0>
    +
    <matplotlib.axes._subplots.AxesSubplot at 0x7fb5be1db040>
     
    _images/chapter4_131_1.png @@ -2229,27 +2239,27 @@ techniques.

    MSE before scaling: 0.00
     R2 score before scaling 0.99
     Feature min values before scaling:
    - [1.00000000e+00 4.28119384e-04 8.30273573e-04 1.83286207e-07
    - 3.55456211e-07 6.89354206e-07 7.84683780e-11 1.52177694e-10
    - 2.95125898e-10 5.72352580e-10 3.35938336e-14 6.51502206e-14
    - 1.26349118e-13 2.45035234e-13 4.75209222e-13 1.43821714e-17
    - 2.78920723e-17 5.40925064e-17 1.04904333e-16 2.03446279e-16
    - 3.94553659e-16]
    + [1.00000000e+00 1.97624658e-03 6.76071445e-04 3.90555053e-06
    + 1.33608388e-06 4.57072598e-07 7.71833086e-09 2.64043119e-09
    + 9.03288157e-10 3.09013732e-10 1.52533249e-11 5.21814310e-12
    + 1.78512013e-12 6.10687329e-13 2.08915360e-13 3.01443312e-14
    + 1.03123374e-14 3.52783754e-15 1.20686874e-15 4.12868265e-16
    + 1.41241709e-16]
     Feature max values before scaling:
    - [1.         0.99959919 0.99554286 0.99919855 0.99514384 0.99110558
    - 0.99879806 0.99474497 0.99070834 0.98668808 0.99839773 0.99434627
    - 0.99031125 0.98629261 0.98229027 0.99799757 0.99394773 0.98991433
    - 0.98589729 0.98189656 0.97791206]
    + [1.         0.99729116 0.99990303 0.99458965 0.99719445 0.99980607
    + 0.99189546 0.9944932  0.99709775 0.99970911 0.98920857 0.99179928
    + 0.99439677 0.99700106 0.99961217 0.98652896 0.98911265 0.9917031
    + 0.99430034 0.99690438 0.99951524]
     Feature min values after scaling:
    - [ 0.         -1.69931545 -1.67469653 -1.11879252 -1.10594061 -1.09316288
    - -0.88278129 -0.87818569 -0.8737743  -0.8695324  -0.74532693 -0.74499485
    - -0.74480651 -0.74474355 -0.7447873  -0.65291273 -0.65458157 -0.65636186
    - -0.6582414  -0.6602078  -0.66224856]
    + [ 0.         -1.72006556 -1.76752166 -1.10773734 -1.11611153 -1.12503152
    + -0.87804483 -0.88146268 -0.88496565 -0.8885653  -0.75100539 -0.75305518
    + -0.75511928 -0.75719979 -0.75929911 -0.66720819 -0.66863343 -0.67005915
    + -0.67148589 -0.67291428 -0.67434497]
     Feature max values after scaling:
    - [0.         1.73355301 1.72505955 2.27111673 2.24946337 2.22510326
    - 2.69980853 2.67945831 2.65749797 2.63400218 3.05843173 3.04339787
    - 3.02720478 3.00984683 2.99131512 3.36770789 3.3585133  3.3484316
    - 3.33743441 3.32549161 3.31257165]
    + [0.         1.74774217 1.73485006 2.2506647  2.23491553 2.21893993
    + 2.6752011  2.65930564 2.64314172 2.62671501 3.05237641 3.03669249
    + 3.02075875 3.00457804 2.98815333 3.39653406 3.38082542 3.36489022
    + 3.34873108 3.33235061 3.31575145]
     MSE after  scaling: 0.00
     R2 score for  scaled data: 0.99
     
    @@ -2839,10 +2849,10 @@ covariance matrix through the np.linalg.eig() function.

    -
    0.10594950732957698
    -4.624126522020202
    -[[ 0.994928    3.03386068]
    - [ 3.03386068 10.13854864]]
    +
    0.12208685625303164
    +4.452659449239899
    +[[ 1.00910422  3.12769989]
    + [ 3.12769989 10.63920917]]
     
    @@ -2882,10 +2892,10 @@ a more brute force way. Here we scale the mean values for each column of the des
    -
    0.07844342450165018
    -1.1438626259785865
    -[[1.         0.60716876]
    - [0.60716876 1.        ]]
    +
    0.08487462066865184
    +1.7716882265595972
    +[[1.         0.74332853]
    + [0.74332853 1.        ]]
     
    @@ -2917,30 +2927,30 @@ this matrix we easily see that it is a positive definite matrix.

    -
    [[-0.1066151   0.79747251]
    - [ 0.75209514  1.96762409]
    - [-0.41638994 -2.34035396]
    - [-0.2780316  -1.49418072]
    - [ 0.86865915  2.72245363]
    - [ 0.20418073  0.86260647]
    - [-0.79048758 -0.42464144]
    - [-0.01768994 -0.1467412 ]
    - [-0.26355349 -1.81771904]
    - [ 0.04783264 -0.12652035]]
    +
    [[-0.63821798 -2.03548189]
    + [ 0.98355854  2.40965456]
    + [ 0.48870683  2.68995497]
    + [ 0.44655566  1.28908336]
    + [ 0.3871261  -0.67155367]
    + [-0.32256574 -0.55849157]
    + [ 1.3507663   2.75066843]
    + [-1.44489727 -5.37462032]
    + [-0.42087991  1.26840089]
    + [-0.83015254 -1.76761477]]
               0         1
    -0 -0.106615  0.797473
    -1  0.752095  1.967624
    -2 -0.416390 -2.340354
    -3 -0.278032 -1.494181
    -4  0.868659  2.722454
    -5  0.204181  0.862606
    -6 -0.790488 -0.424641
    -7 -0.017690 -0.146741
    -8 -0.263553 -1.817719
    -9  0.047833 -0.126520
    +0 -0.638218 -2.035482
    +1  0.983559  2.409655
    +2  0.488707  2.689955
    +3  0.446556  1.289083
    +4  0.387126 -0.671554
    +5 -0.322566 -0.558492
    +6  1.350766  2.750668
    +7 -1.444897 -5.374620
    +8 -0.420880  1.268401
    +9 -0.830153 -1.767615
               0         1
    -0  1.000000  0.824095
    -1  0.824095  1.000000
    +0  1.000000  0.877156
    +1  0.877156  1.000000
     
    @@ -3000,37 +3010,37 @@ this matrix we easily see that it is a positive definite matrix.

         0         1         2         3         4         5         6         7   \
     0   0.0  0.000000  0.000000  0.000000  0.000000  0.000000  0.000000  0.000000   
    -1   0.0  0.090154  0.084830  0.094410  0.086610  0.079643  0.088034  0.080631   
    -2   0.0  0.084830  0.081616  0.091708  0.085377  0.079558  0.087469  0.081068   
    -3   0.0  0.094410  0.091708  0.104704  0.097816  0.091403  0.101195  0.093913   
    -4   0.0  0.086610  0.085377  0.097816  0.092341  0.087099  0.095895  0.089763   
    -5   0.0  0.079643  0.079558  0.091403  0.087099  0.082837  0.090734  0.085584   
    -6   0.0  0.088034  0.087469  0.101195  0.095895  0.090734  0.100269  0.094057   
    -7   0.0  0.080631  0.081068  0.093913  0.089763  0.085584  0.094057  0.088862   
    -8   0.0  0.074145  0.075363  0.087388  0.084186  0.080823  0.088367  0.084031   
    -9   0.0  0.068449  0.070272  0.081540  0.079119  0.076438  0.083169  0.079557   
    -10  0.0  0.080692  0.081580  0.095076  0.091141  0.087107  0.095945  0.090806   
    -11  0.0  0.074184  0.075759  0.088306  0.085279  0.082038  0.089878  0.085590   
    -12  0.0  0.068486  0.070593  0.082283  0.080006  0.077425  0.084399  0.080829   
    -13  0.0  0.063479  0.065996  0.076913  0.075254  0.073225  0.079446  0.076483   
    -14  0.0  0.059064  0.061893  0.072112  0.070966  0.069398  0.074962  0.072512   
    +1   0.0  0.085618  0.079643  0.085857  0.084047  0.081888  0.076531  0.075718   
    +2   0.0  0.079643  0.075359  0.078265  0.077130  0.075774  0.069143  0.068658   
    +3   0.0  0.085857  0.078265  0.090778  0.088194  0.085138  0.083648  0.082461   
    +4   0.0  0.084047  0.077130  0.088194  0.085938  0.083258  0.080985  0.079981   
    +5   0.0  0.081888  0.075774  0.085138  0.083258  0.081011  0.077856  0.077054   
    +6   0.0  0.076531  0.069143  0.083648  0.080985  0.077856  0.078889  0.077645   
    +7   0.0  0.075718  0.068658  0.082461  0.079981  0.077054  0.077645  0.076512   
    +8   0.0  0.074845  0.068154  0.081161  0.078881  0.076175  0.076275  0.075261   
    +9   0.0  0.073877  0.067608  0.079704  0.077645  0.075189  0.074736  0.073852   
    +10  0.0  0.067084  0.060409  0.075015  0.072536  0.069633  0.071991  0.070821   
    +11  0.0  0.066572  0.060088  0.074312  0.071948  0.069168  0.071268  0.070173   
    +12  0.0  0.066065  0.059784  0.073591  0.071348  0.068699  0.070516  0.069500   
    +13  0.0  0.065552  0.059492  0.072838  0.070724  0.068215  0.069723  0.068789   
    +14  0.0  0.065022  0.059205  0.072037  0.070061  0.067706  0.068871  0.068023   
     
               8         9         10        11        12        13        14  
     0   0.000000  0.000000  0.000000  0.000000  0.000000  0.000000  0.000000  
    -1   0.074145  0.068449  0.080692  0.074184  0.068486  0.063479  0.059064  
    -2   0.075363  0.070272  0.081580  0.075759  0.070593  0.065996  0.061893  
    -3   0.087388  0.081540  0.095076  0.088306  0.082283  0.076913  0.072112  
    -4   0.084186  0.079119  0.091141  0.085279  0.080006  0.075254  0.070966  
    -5   0.080823  0.076438  0.087107  0.082038  0.077425  0.073225  0.069398  
    -6   0.088367  0.083169  0.095945  0.089878  0.084399  0.079446  0.074962  
    -7   0.084031  0.079557  0.090806  0.085590  0.080829  0.076483  0.072512  
    -8   0.079929  0.076076  0.085994  0.081509  0.077368  0.073550  0.070030  
    -9   0.076076  0.072757  0.081515  0.077656  0.074052  0.070694  0.067570  
    -10  0.085994  0.081515  0.093107  0.087851  0.083035  0.078625  0.074586  
    -11  0.081509  0.077656  0.087851  0.083337  0.079156  0.075290  0.071718  
    -12  0.077368  0.074052  0.083035  0.079156  0.075521  0.072127  0.068962  
    -13  0.073550  0.070694  0.078625  0.075290  0.072127  0.069142  0.066334  
    -14  0.070030  0.067570  0.074586  0.071718  0.068962  0.066334  0.063837  
    +1   0.074845  0.073877  0.067084  0.066572  0.066065  0.065552  0.065022  
    +2   0.068154  0.067608  0.060409  0.060088  0.059784  0.059492  0.059205  
    +3   0.081161  0.079704  0.075015  0.074312  0.073591  0.072838  0.072037  
    +4   0.078881  0.077645  0.072536  0.071948  0.071348  0.070724  0.070061  
    +5   0.076175  0.075189  0.069633  0.069168  0.068699  0.068215  0.067706  
    +6   0.076275  0.074736  0.071991  0.071268  0.070516  0.069723  0.068871  
    +7   0.075261  0.073852  0.070821  0.070173  0.069500  0.068789  0.068023  
    +8   0.074139  0.072869  0.069531  0.068962  0.068371  0.067746  0.067072  
    +9   0.072869  0.071752  0.068081  0.067595  0.067092  0.066559  0.065985  
    +10  0.069531  0.068081  0.066617  0.065944  0.065240  0.064493  0.063686  
    +11  0.068962  0.067595  0.065944  0.065324  0.064676  0.063985  0.063237  
    +12  0.068371  0.067092  0.065240  0.064676  0.064083  0.063452  0.062765  
    +13  0.067746  0.066559  0.064493  0.063985  0.063452  0.062881  0.062258  
    +14  0.067072  0.065985  0.063686  0.063237  0.062765  0.062258  0.061702  
     
    @@ -3380,10 +3390,10 @@ number \(i\) is left out. Usin
    -
    Runtime: 0.425629 sec
    +
    Runtime: 0.430516 sec
     Jackknife Statistics :
     original           bias      std. error
    -   99.99          99.98        0.151321
    + 100.186        100.176        0.153008
     
    @@ -3525,10 +3535,10 @@ theorem.

    -
    Runtime: 2.1542 sec
    +
    Runtime: 2.20285 sec
     Bootstrap Statistics :
     original           bias      std. error
    - 99.8081  15.0184        99.8106        0.150604
    + 100.167   14.919        100.169        0.150847
     
    ---------------------------------------------------------------------------
    diff --git a/doc/src/LectureNotes/_build/html/chapter5.html b/doc/src/LectureNotes/_build/html/chapter5.html
    index f56f8239f..b0717bca3 100644
    --- a/doc/src/LectureNotes/_build/html/chapter5.html
    +++ b/doc/src/LectureNotes/_build/html/chapter5.html
    @@ -175,6 +175,16 @@
        18. Neural networks, from the simple perceptron to deep learning
       
      
    + 
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/chapter6.html b/doc/src/LectureNotes/_build/html/chapter6.html index db3babcba..bb606dccb 100644 --- a/doc/src/LectureNotes/_build/html/chapter6.html +++ b/doc/src/LectureNotes/_build/html/chapter6.html @@ -38,6 +38,7 @@ + @@ -174,6 +175,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • @@ -3223,6 +3234,7 @@ features).

    diff --git a/doc/src/LectureNotes/_build/html/chapter7.html b/doc/src/LectureNotes/_build/html/chapter7.html new file mode 100644 index 000000000..8b28d428f --- /dev/null +++ b/doc/src/LectureNotes/_build/html/chapter7.html @@ -0,0 +1,1503 @@ + + + + + + + + + 19. Support Vector Machines, overarching aims — Applied Machine Learning and Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    + + + + + + + + +
    + + +
    +
    + +
    + +
    +

    19. Support Vector Machines, overarching aims

    +

    A Support Vector Machine (SVM) is a very powerful and versatile +Machine Learning method, capable of performing linear or nonlinear +classification, regression, and even outlier detection. It is one of +the most popular models in Machine Learning, and anyone interested in +Machine Learning should have it in their toolbox. SVMs are +particularly well suited for classification of complex but small-sized or +medium-sized datasets.

    +

    The case with two well-separated classes only can be understood in an +intuitive way in terms of lines in a two-dimensional space separating +the two classes (see figure below).

    +

    The basic mathematics behind the SVM is however less familiar to most of us. +It relies on the definition of hyperplanes and the +definition of a margin which separates classes (in case of +classification problems) of variables. It is also used for regression +problems.

    +

    With SVMs we distinguish between hard margin and soft margins. The +latter introduces a so-called softening parameter to be discussed +below. We distinguish also between linear and non-linear +approaches. The latter are the most frequent ones since it is rather +unlikely that we can separate classes easily by say straight lines.

    +
    +

    19.1. Hyperplanes and all that

    +

    The theory behind support vector machines (SVM hereafter) is based on +the mathematical description of so-called hyperplanes. Let us start +with a two-dimensional case. This will also allow us to introduce our +first SVM examples. These will be tailored to the case of two specific +classes, as displayed in the figure here based on the usage of the petal data.

    +

    We assume here that our data set can be well separated into two +domains, where a straight line does the job in the separating the two +classes. Here the two classes are represented by either squares or +circles.

    +
    +
    +
    %matplotlib inline
    +
    +from sklearn import datasets
    +from sklearn.svm import SVC, LinearSVC
    +from sklearn.linear_model import SGDClassifier
    +from sklearn.preprocessing import StandardScaler
    +import matplotlib
    +import matplotlib.pyplot as plt
    +plt.rcParams['axes.labelsize'] = 14
    +plt.rcParams['xtick.labelsize'] = 12
    +plt.rcParams['ytick.labelsize'] = 12
    +
    +
    +iris = datasets.load_iris()
    +X = iris["data"][:, (2, 3)]  # petal length, petal width
    +y = iris["target"]
    +
    +setosa_or_versicolor = (y == 0) | (y == 1)
    +X = X[setosa_or_versicolor]
    +y = y[setosa_or_versicolor]
    +
    +
    +
    +C = 5
    +alpha = 1 / (C * len(X))
    +
    +lin_clf = LinearSVC(loss="hinge", C=C, random_state=42)
    +svm_clf = SVC(kernel="linear", C=C)
    +sgd_clf = SGDClassifier(loss="hinge", learning_rate="constant", eta0=0.001, alpha=alpha,
    +                        max_iter=100000, random_state=42)
    +
    +scaler = StandardScaler()
    +X_scaled = scaler.fit_transform(X)
    +
    +lin_clf.fit(X_scaled, y)
    +svm_clf.fit(X_scaled, y)
    +sgd_clf.fit(X_scaled, y)
    +
    +print("LinearSVC:                   ", lin_clf.intercept_, lin_clf.coef_)
    +print("SVC:                         ", svm_clf.intercept_, svm_clf.coef_)
    +print("SGDClassifier(alpha={:.5f}):".format(sgd_clf.alpha), sgd_clf.intercept_, sgd_clf.coef_)
    +
    +# Compute the slope and bias of each decision boundary
    +w1 = -lin_clf.coef_[0, 0]/lin_clf.coef_[0, 1]
    +b1 = -lin_clf.intercept_[0]/lin_clf.coef_[0, 1]
    +w2 = -svm_clf.coef_[0, 0]/svm_clf.coef_[0, 1]
    +b2 = -svm_clf.intercept_[0]/svm_clf.coef_[0, 1]
    +w3 = -sgd_clf.coef_[0, 0]/sgd_clf.coef_[0, 1]
    +b3 = -sgd_clf.intercept_[0]/sgd_clf.coef_[0, 1]
    +
    +# Transform the decision boundary lines back to the original scale
    +line1 = scaler.inverse_transform([[-10, -10 * w1 + b1], [10, 10 * w1 + b1]])
    +line2 = scaler.inverse_transform([[-10, -10 * w2 + b2], [10, 10 * w2 + b2]])
    +line3 = scaler.inverse_transform([[-10, -10 * w3 + b3], [10, 10 * w3 + b3]])
    +
    +# Plot all three decision boundaries
    +plt.figure(figsize=(11, 4))
    +plt.plot(line1[:, 0], line1[:, 1], "k:", label="LinearSVC")
    +plt.plot(line2[:, 0], line2[:, 1], "b--", linewidth=2, label="SVC")
    +plt.plot(line3[:, 0], line3[:, 1], "r-", label="SGDClassifier")
    +plt.plot(X[:, 0][y==1], X[:, 1][y==1], "bs") # label="Iris-Versicolor"
    +plt.plot(X[:, 0][y==0], X[:, 1][y==0], "yo") # label="Iris-Setosa"
    +plt.xlabel("Petal length", fontsize=14)
    +plt.ylabel("Petal width", fontsize=14)
    +plt.legend(loc="upper center", fontsize=14)
    +plt.axis([0, 5.5, 0, 2])
    +
    +plt.show()
    +
    +
    +
    +
    +
    LinearSVC:                    [0.28475098] [[1.05364854 1.09903804]]
    +SVC:                          [0.31896852] [[1.1203284  1.02625193]]
    +SGDClassifier(alpha=0.00200): [0.117] [[0.77714169 0.72981762]]
    +
    +
    +_images/chapter7_1_1.png +
    +
    +
    +
    +

    19.2. What is a hyperplane?

    +

    The aim of the SVM algorithm is to find a hyperplane in a +\(p\)-dimensional space, where \(p\) is the number of features that +distinctly classifies the data points.

    +

    In a \(p\)-dimensional space, a hyperplane is what we call an affine subspace of dimension of \(p-1\). +As an example, in two dimension, a hyperplane is simply as straight line while in three dimensions it is +a two-dimensional subspace, or stated simply, a plane.

    +

    In two dimensions, with the variables \(x_1\) and \(x_2\), the hyperplane is defined as

    +
    +\[ +b+w_1x_1+w_2x_2=0, +\]
    +

    where \(b\) is the intercept and \(w_1\) and \(w_2\) define the elements of a vector orthogonal to the line +\(b+w_1x_1+w_2x_2=0\). +In two dimensions we define the vectors \(\boldsymbol{x} =[x1,x2]\) and \(\boldsymbol{w}=[w1,w2]\). +We can then rewrite the above equation as

    +
    +\[ +\boldsymbol{x}^T\boldsymbol{w}+b=0. +\]
    +
    +
    +

    19.3. A \(p\)-dimensional space of features

    +

    We limit ourselves to two classes of outputs \(y_i\) and assign these classes the values \(y_i = \pm 1\). +In a \(p\)-dimensional space of say \(p\) features we have a hyperplane defines as

    +
    +\[ +b+wx_1+w_2x_2+\dots +w_px_p=0. +\]
    +

    If we define a +matrix \(\boldsymbol{X}=\left[\boldsymbol{x}_1,\boldsymbol{x}_2,\dots, \boldsymbol{x}_p\right]\) +of dimension \(n\times p\), where \(n\) represents the observations for each feature and each vector \(x_i\) is a column vector of the matrix \(\boldsymbol{X}\),

    +
    +\[\begin{split} +\boldsymbol{x}_i = \begin{bmatrix} x_{i1} \\ x_{i2} \\ \dots \\ \dots \\ x_{ip} \end{bmatrix}. +\end{split}\]
    +

    If the above condition is not met for a given vector \(\boldsymbol{x}_i\) we have

    +
    +\[ +b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip} >0, +\]
    +

    if our output \(y_i=1\). +In this case we say that \(\boldsymbol{x}_i\) lies on one of the sides of the hyperplane and if

    +
    +\[ +b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip} < 0, +\]
    +

    for the class of observations \(y_i=-1\), +then \(\boldsymbol{x}_i\) lies on the other side.

    +

    Equivalently, for the two classes of observations we have

    +
    +\[ +y_i\left(b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip}\right) > 0. +\]
    +

    When we try to separate hyperplanes, if it exists, we can use it to construct a natural classifier: a test observation is assigned a given class depending on which side of the hyperplane it is located.

    +
    +
    +

    19.4. The two-dimensional case

    +

    Let us try to develop our intuition about SVMs by limiting ourselves to a two-dimensional +plane. To separate the two classes of data points, there are many +possible lines (hyperplanes if you prefer a more strict naming)
    +that could be chosen. Our objective is to find a +plane that has the maximum margin, i.e the maximum distance between +data points of both classes. Maximizing the margin distance provides +some reinforcement so that future data points can be classified with +more confidence.

    +

    What a linear classifier attempts to accomplish is to split the +feature space into two half spaces by placing a hyperplane between the +data points. This hyperplane will be our decision boundary. All +points on one side of the plane will belong to class one and all points +on the other side of the plane will belong to the second class two.

    +

    Unfortunately there are many ways in which we can place a hyperplane +to divide the data. Below is an example of two candidate hyperplanes +for our data sample.

    +
    +
    +

    19.5. Getting into the details

    +

    Let us define the function

    +
    +\[ +f(x) = \boldsymbol{w}^T\boldsymbol{x}+b = 0, +\]
    +

    as the function that determines the line \(L\) that separates two classes (our two features), see the figure here.

    +

    Any point defined by \(\boldsymbol{x}_i\) and \(\boldsymbol{x}_2\) on the line \(L\) will satisfy \(\boldsymbol{w}^T(\boldsymbol{x}_1-\boldsymbol{x}_2)=0\).

    +

    The signed distance \(\delta\) from any point defined by a vector \(\boldsymbol{x}\) and a point \(\boldsymbol{x}_0\) on the line \(L\) is then

    +
    +\[ +\delta = \frac{1}{\vert\vert \boldsymbol{w}\vert\vert}(\boldsymbol{w}^T\boldsymbol{x}+b). +\]
    +
    +
    +

    19.6. First attempt at a minimization approach

    +

    How do we find the parameter \(b\) and the vector \(\boldsymbol{w}\)? What we could +do is to define a cost function which now contains the set of all +misclassified points \(M\) and attempt to minimize this function

    +
    +\[ +C(\boldsymbol{w},b) = -\sum_{i\in M} y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b). +\]
    +

    We could now for example define all values \(y_i =1\) as misclassified in case we have \(\boldsymbol{w}^T\boldsymbol{x}_i+b < 0\) and the opposite if we have \(y_i=-1\). Taking the derivatives gives us

    +
    +\[ +\frac{\partial C}{\partial b} = -\sum_{i\in M} y_i, +\]
    +

    and

    +
    +\[ +\frac{\partial C}{\partial \boldsymbol{w}} = -\sum_{i\in M} y_ix_i. +\]
    +
    +
    +

    19.7. Solving the equations

    +

    We can now use the Newton-Raphson method or different variants of the gradient descent family (from plain gradient descent to various stochastic gradient descent approaches) to solve the equations

    +
    +\[ +b \leftarrow b +\eta \frac{\partial C}{\partial b}, +\]
    +

    and

    +
    +\[ +\boldsymbol{w} \leftarrow \boldsymbol{w} +\eta \frac{\partial C}{\partial \boldsymbol{w}}, +\]
    +

    where \(\eta\) is our by now well-known learning rate.

    +
    +
    +

    19.8. Code Example

    +

    The equations we discussed above can be coded rather easily (the +framework is similar to what we developed for logistic +regression). We are going to set up a simple case with two classes only and we want to find a line which separates them the best possible way.

    +
    +
    +

    19.9. Problems with the Simpler Approach

    +

    There are however problems with this approach, although it looks +pretty straightforward to implement. When running the above code, we see that we can easily end up with many diffeent lines which separate the two classes.

    +

    For small +gaps between the entries, we may also end up needing many iterations +before the solutions converge and if the data cannot be separated +properly into two distinct classes, we may not experience a converge +at all.

    +
    +
    +

    19.10. A better approach

    +

    A better approach is rather to try to define a large margin between +the two classes (if they are well separated from the beginning).

    +

    Thus, we wish to find a margin \(M\) with \(\boldsymbol{w}\) normalized to +\(\vert\vert \boldsymbol{w}\vert\vert =1\) subject to the condition

    +
    +\[ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq M \hspace{0.1cm}\forall i=1,2,\dots, p. +\]
    +

    All points are thus at a signed distance from the decision boundary defined by the line \(L\). The parameters \(b\) and \(w_1\) and \(w_2\) define this line.

    +

    We seek thus the largest value \(M\) defined by

    +
    +\[ +\frac{1}{\vert \vert \boldsymbol{w}\vert\vert}y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq M \hspace{0.1cm}\forall i=1,2,\dots, n, +\]
    +

    or just

    +
    +\[ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq M\vert \vert \boldsymbol{w}\vert\vert \hspace{0.1cm}\forall i. +\]
    +

    If we scale the equation so that \(\vert \vert \boldsymbol{w}\vert\vert = 1/M\), we have to find the minimum of +\(\boldsymbol{w}^T\boldsymbol{w}=\vert \vert \boldsymbol{w}\vert\vert\) (the norm) subject to the condition

    +
    +\[ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq 1 \hspace{0.1cm}\forall i. +\]
    +

    We have thus defined our margin as the invers of the norm of +\(\boldsymbol{w}\). We want to minimize the norm in order to have a as large as +possible margin \(M\). Before we proceed, we need to remind ourselves +about Lagrangian multipliers.

    +
    +
    +

    19.11. A quick Reminder on Lagrangian Multipliers

    +

    Consider a function of three independent variables \(f(x,y,z)\) . For the function \(f\) to be an +extreme we have

    +
    +\[ +df=0. +\]
    +

    A necessary and sufficient condition is

    +
    +\[ +\frac{\partial f}{\partial x} =\frac{\partial f}{\partial y}=\frac{\partial f}{\partial z}=0, +\]
    +

    due to

    +
    +\[ +df = \frac{\partial f}{\partial x}dx+\frac{\partial f}{\partial y}dy+\frac{\partial f}{\partial z}dz. +\]
    +

    In many problems the variables \(x,y,z\) are often subject to constraints (such as those above for the margin) +so that they are no longer all independent. It is possible at least in principle to use each +constraint to eliminate one variable +and to proceed with a new and smaller set of independent varables.

    +

    The use of so-called Lagrangian multipliers is an alternative technique when the elimination +of variables is incovenient or undesirable. Assume that we have an equation of constraint on +the variables \(x,y,z\)

    +
    +\[ +\phi(x,y,z) = 0, +\]
    +

    resulting in

    +
    +\[ +d\phi = \frac{\partial \phi}{\partial x}dx+\frac{\partial \phi}{\partial y}dy+\frac{\partial \phi}{\partial z}dz =0. +\]
    +

    Now we cannot set anymore

    +
    +\[ +\frac{\partial f}{\partial x} =\frac{\partial f}{\partial y}=\frac{\partial f}{\partial z}=0, +\]
    +

    if \(df=0\) is wanted +because there are now only two independent variables! Assume \(x\) and \(y\) are the independent +variables. +Then \(dz\) is no longer arbitrary.

    +
    +
    +

    19.12. Adding the Multiplier

    +

    However, we can add to

    +
    +\[ +df = \frac{\partial f}{\partial x}dx+\frac{\partial f}{\partial y}dy+\frac{\partial f}{\partial z}dz, +\]
    +

    a multiplum of \(d\phi\), viz. \(\lambda d\phi\), resulting in

    +
    +\[ +df+\lambda d\phi = (\frac{\partial f}{\partial z}+\lambda +\frac{\partial \phi}{\partial x})dx+(\frac{\partial f}{\partial y}+\lambda\frac{\partial \phi}{\partial y})dy+ +(\frac{\partial f}{\partial z}+\lambda\frac{\partial \phi}{\partial z})dz =0. +\]
    +

    Our multiplier is chosen so that

    +
    +\[ +\frac{\partial f}{\partial z}+\lambda\frac{\partial \phi}{\partial z} =0. +\]
    +

    We need to remember that we took \(dx\) and \(dy\) to be arbitrary and thus we must have

    +
    +\[ +\frac{\partial f}{\partial x}+\lambda\frac{\partial \phi}{\partial x} =0, +\]
    +

    and

    +
    +\[ +\frac{\partial f}{\partial y}+\lambda\frac{\partial \phi}{\partial y} =0. +\]
    +

    When all these equations are satisfied, \(df=0\). We have four unknowns, \(x,y,z\) and +\(\lambda\). Actually we want only \(x,y,z\), \(\lambda\) needs not to be determined, +it is therefore often called +Lagrange’s undetermined multiplier. +If we have a set of constraints \(\phi_k\) we have the equations

    +
    +\[ +\frac{\partial f}{\partial x_i}+\sum_k\lambda_k\frac{\partial \phi_k}{\partial x_i} =0. +\]
    +
    +
    +

    19.13. Setting up the Problem

    +

    In order to solve the above problem, we define the following Lagrangian function to be minimized

    +
    +\[ +{\cal L}(\lambda,b,\boldsymbol{w})=\frac{1}{2}\boldsymbol{w}^T\boldsymbol{w}-\sum_{i=1}^n\lambda_i\left[y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)-1\right], +\]
    +

    where \(\lambda_i\) is a so-called Lagrange multiplier subject to the condition \(\lambda_i \geq 0\).

    +

    Taking the derivatives with respect to \(b\) and \(\boldsymbol{w}\) we obtain

    +
    +\[ +\frac{\partial {\cal L}}{\partial b} = -\sum_{i} \lambda_iy_i=0, +\]
    +

    and

    +
    +\[ +\frac{\partial {\cal L}}{\partial \boldsymbol{w}} = 0 = \boldsymbol{w}-\sum_{i} \lambda_iy_i\boldsymbol{x}_i. +\]
    +

    Inserting these constraints into the equation for \({\cal L}\) we obtain

    +
    +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{x}_j, +\]
    +

    subject to the constraints \(\lambda_i\geq 0\) and \(\sum_i\lambda_iy_i=0\). +We must in addition satisfy the Karush-Kuhn-Tucker (KKT) condition

    +
    +\[ +\lambda_i\left[y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) -1\right] \hspace{0.1cm}\forall i. +\]
    +
      +
    1. If \(\lambda_i > 0\), then \(y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1\) and we say that \(x_i\) is on the boundary.

    2. +
    3. If \(y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)> 1\), we say \(x_i\) is not on the boundary and we set \(\lambda_i=0\).

    4. +
    +

    When \(\lambda_i > 0\), the vectors \(\boldsymbol{x}_i\) are called support vectors. They are the vectors closest to the line (or hyperplane) and define the margin \(M\).

    +
    +
    +

    19.14. The problem to solve

    +

    We can rewrite

    +
    +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{x}_j, +\]
    +

    and its constraints in terms of a matrix-vector problem where we minimize w.r.t. \(\lambda\) the following problem

    +
    +\[\begin{split} +\frac{1}{2} \boldsymbol{\lambda}^T\begin{bmatrix} y_1y_1\boldsymbol{x}_1^T\boldsymbol{x}_1 & y_1y_2\boldsymbol{x}_1^T\boldsymbol{x}_2 & \dots & \dots & y_1y_n\boldsymbol{x}_1^T\boldsymbol{x}_n \\ +y_2y_1\boldsymbol{x}_2^T\boldsymbol{x}_1 & y_2y_2\boldsymbol{x}_2^T\boldsymbol{x}_2 & \dots & \dots & y_1y_n\boldsymbol{x}_2^T\boldsymbol{x}_n \\ +\dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots \\ +y_ny_1\boldsymbol{x}_n^T\boldsymbol{x}_1 & y_ny_2\boldsymbol{x}_n^T\boldsymbol{x}_2 & \dots & \dots & y_ny_n\boldsymbol{x}_n^T\boldsymbol{x}_n \\ +\end{bmatrix}\boldsymbol{\lambda}-\mathbb{1}\boldsymbol{\lambda}, +\end{split}\]
    +

    subject to \(\boldsymbol{y}^T\boldsymbol{\lambda}=0\). Here we defined the vectors \(\boldsymbol{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]\) and +\(\boldsymbol{y}=[y_1,y_2,\dots,y_n]\).

    +
    +
    +

    19.15. The last steps

    +

    Solving the above problem, yields the values of \(\lambda_i\). +To find the coefficients of your hyperplane we need simply to compute

    +
    +\[ +\boldsymbol{w}=\sum_{i} \lambda_iy_i\boldsymbol{x}_i. +\]
    +

    With our vector \(\boldsymbol{w}\) we can in turn find the value of the intercept \(b\) (here in two dimensions) via

    +
    +\[ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1, +\]
    +

    resulting in

    +
    +\[ +b = \frac{1}{y_i}-\boldsymbol{w}^T\boldsymbol{x}_i, +\]
    +

    or if we write it out in terms of the support vectors only, with \(N_s\) being their number, we have

    +
    +\[ +b = \frac{1}{N_s}\sum_{j\in N_s}\left(y_j-\sum_{i=1}^n\lambda_iy_i\boldsymbol{x}_i^T\boldsymbol{x}_j\right). +\]
    +

    With our hyperplane coefficients we can use our classifier to assign any observation by simply using

    +
    +\[ +y_i = \mathrm{sign}(\boldsymbol{w}^T\boldsymbol{x}_i+b). +\]
    +

    Below we discuss how to find the optimal values of \(\lambda_i\). Before we proceed however, we discuss now the so-called soft classifier.

    +
    +
    +

    19.16. A soft classifier

    +

    Till now, the margin is strictly defined by the support vectors. This defines what is called a hard classifier, that is the margins are well defined.

    +

    Suppose now that classes overlap in feature space, as shown in the +figure here. One way to deal with this problem before we define the +so-called kernel approach, is to allow a kind of slack in the sense +that we allow some points to be on the wrong side of the margin.

    +

    We introduce thus the so-called slack variables \(\boldsymbol{\xi} =[\xi_1,x_2,\dots,x_n]\) and +modify our previous equation

    +
    +\[ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1, +\]
    +

    to

    +
    +\[ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1-\xi_i, +\]
    +

    with the requirement \(\xi_i\geq 0\). The total violation is now \(\sum_i\xi\). +The value \(\xi_i\) in the constraint the last constraint corresponds to the amount by which the prediction +\(y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1\) is on the wrong side of its margin. Hence by bounding the sum \(\sum_i \xi_i\), +we bound the total amount by which predictions fall on the wrong side of their margins.

    +

    Misclassifications occur when \(\xi_i > 1\). Thus bounding the total sum by some value \(C\) bounds in turn the total number of +misclassifications.

    +
    +
    +

    19.17. Soft optmization problem

    +

    This has in turn the consequences that we change our optmization problem to finding the minimum of

    +
    +\[ +{\cal L}=\frac{1}{2}\boldsymbol{w}^T\boldsymbol{w}-\sum_{i=1}^n\lambda_i\left[y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)-(1-\xi_)\right]+C\sum_{i=1}^n\xi_i-\sum_{i=1}^n\gamma_i\xi_i, +\]
    +

    subject to

    +
    +\[ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1-\xi_i \hspace{0.1cm}\forall i, +\]
    +

    with the requirement \(\xi_i\geq 0\).

    +

    Taking the derivatives with respect to \(b\) and \(\boldsymbol{w}\) we obtain

    +
    +\[ +\frac{\partial {\cal L}}{\partial b} = -\sum_{i} \lambda_iy_i=0, +\]
    +

    and

    +
    +\[ +\frac{\partial {\cal L}}{\partial \boldsymbol{w}} = 0 = \boldsymbol{w}-\sum_{i} \lambda_iy_i\boldsymbol{x}_i, +\]
    +

    and

    +
    +\[ +\lambda_i = C-\gamma_i \hspace{0.1cm}\forall i. +\]
    +

    Inserting these constraints into the equation for \({\cal L}\) we obtain the same equation as before

    +
    +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{x}_j, +\]
    +

    but now subject to the constraints \(\lambda_i\geq 0\), \(\sum_i\lambda_iy_i=0\) and \(0\leq\lambda_i \leq C\). +We must in addition satisfy the Karush-Kuhn-Tucker condition which now reads

    +

    5 +0

    +

    < +< +< +! +! +M +A +T +H +_ +B +L +O +C +K

    +
    +\[ +\gamma_i\xi_i = 0, +\]
    +

    and

    +
    +\[ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) -(1-\xi_) \geq 0 \hspace{0.1cm}\forall i. +\]
    +
    +
    +

    19.18. Kernels and non-linearity

    +

    The cases we have studied till now, were all characterized by two classes +with a close to linear separability. The classifiers we have described +so far find linear boundaries in our input feature space. It is +possible to make our procedure more flexible by exploring the feature +space using other basis expansions such as higher-order polynomials, +wavelets, splines etc.

    +

    If our feature space is not easy to separate, as shown in the figure +here, we can achieve a better separation by introducing more complex +basis functions. The ideal would be, as shown in the next figure, to, via a specific transformation to +obtain a separation between the classes which is almost linear.

    +

    The change of basis, from \(x\rightarrow z=\phi(x)\) leads to the same type of equations to be solved, except that +we need to introduce for example a polynomial transformation to a two-dimensional training set.

    +
    +
    +
    import numpy as np
    +import os
    +
    +np.random.seed(42)
    +
    +# To plot pretty figures
    +import matplotlib
    +import matplotlib.pyplot as plt
    +plt.rcParams['axes.labelsize'] = 14
    +plt.rcParams['xtick.labelsize'] = 12
    +plt.rcParams['ytick.labelsize'] = 12
    +
    +
    +from sklearn.svm import SVC
    +from sklearn import datasets
    +
    +
    +
    +X1D = np.linspace(-4, 4, 9).reshape(-1, 1)
    +X2D = np.c_[X1D, X1D**2]
    +y = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])
    +
    +plt.figure(figsize=(11, 4))
    +
    +plt.subplot(121)
    +plt.grid(True, which='both')
    +plt.axhline(y=0, color='k')
    +plt.plot(X1D[:, 0][y==0], np.zeros(4), "bs")
    +plt.plot(X1D[:, 0][y==1], np.zeros(5), "g^")
    +plt.gca().get_yaxis().set_ticks([])
    +plt.xlabel(r"$x_1$", fontsize=20)
    +plt.axis([-4.5, 4.5, -0.2, 0.2])
    +
    +plt.subplot(122)
    +plt.grid(True, which='both')
    +plt.axhline(y=0, color='k')
    +plt.axvline(x=0, color='k')
    +plt.plot(X2D[:, 0][y==0], X2D[:, 1][y==0], "bs")
    +plt.plot(X2D[:, 0][y==1], X2D[:, 1][y==1], "g^")
    +plt.xlabel(r"$x_1$", fontsize=20)
    +plt.ylabel(r"$x_2$", fontsize=20, rotation=0)
    +plt.gca().get_yaxis().set_ticks([0, 4, 8, 12, 16])
    +plt.plot([-4.5, 4.5], [6.5, 6.5], "r--", linewidth=3)
    +plt.axis([-4.5, 4.5, -1, 17])
    +plt.subplots_adjust(right=1)
    +plt.show()
    +
    +
    +
    +
    +_images/chapter7_109_0.png +
    +
    +
    +
    +

    19.19. The equations

    +

    Suppose we define a polynomial transformation of degree two only (we continue to live in a plane with \(x_i\) and \(y_i\) as variables)

    +
    +\[ +z = \phi(x_i) =\left(x_i^2, y_i^2, \sqrt{2}x_iy_i\right). +\]
    +

    With our new basis, the equations we solved earlier are basically the same, that is we have now (without the slack option for simplicity)

    +
    +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{z}_i^T\boldsymbol{z}_j, +\]
    +

    subject to the constraints \(\lambda_i\geq 0\), \(\sum_i\lambda_iy_i=0\), and for the support vectors

    +
    +\[ +y_i(\boldsymbol{w}^T\boldsymbol{z}_i+b)= 1 \hspace{0.1cm}\forall i, +\]
    +

    from which we also find \(b\). +To compute \(\boldsymbol{z}_i^T\boldsymbol{z}_j\) we define the kernel \(K(\boldsymbol{x}_i,\boldsymbol{x}_j)\) as

    +
    +\[ +K(\boldsymbol{x}_i,\boldsymbol{x}_j)=\boldsymbol{z}_i^T\boldsymbol{z}_j= \phi(\boldsymbol{x}_i)^T\phi(\boldsymbol{x}_j). +\]
    +

    For the above example, the kernel reads

    +
    +\[\begin{split} +K(\boldsymbol{x}_i,\boldsymbol{x}_j)=[x_i^2, y_i^2, \sqrt{2}x_iy_i]^T\begin{bmatrix} x_j^2 \\ y_j^2 \\ \sqrt{2}x_jy_j \end{bmatrix}=x_i^2x_j^2+2x_ix_jy_iy_j+y_i^2y_j^2. +\end{split}\]
    +

    We note that this is nothing but the dot product of the two original +vectors \((\boldsymbol{x}_i^T\boldsymbol{x}_j)^2\). Instead of thus computing the +product in the Lagrangian of \(\boldsymbol{z}_i^T\boldsymbol{z}_j\) we simply compute +the dot product \((\boldsymbol{x}_i^T\boldsymbol{x}_j)^2\).

    +

    This leads to the so-called +kernel trick and the result leads to the same as if we went through +the trouble of performing the transformation +\(\phi(\boldsymbol{x}_i)^T\phi(\boldsymbol{x}_j)\) during the SVM calculations.

    +
    +
    +

    19.20. The problem to solve

    +

    Using our definition of the kernel We can rewrite again the Lagrangian

    +
    +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{z}_j, +\]
    +

    subject to the constraints \(\lambda_i\geq 0\), \(\sum_i\lambda_iy_i=0\) in terms of a convex optimization problem

    +
    +\[\begin{split} +\frac{1}{2} \boldsymbol{\lambda}^T\begin{bmatrix} y_1y_1K(\boldsymbol{x}_1,\boldsymbol{x}_1) & y_1y_2K(\boldsymbol{x}_1,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_1,\boldsymbol{x}_n) \\ +y_2y_1K(\boldsymbol{x}_2,\boldsymbol{x}_1) & y_2y_2(\boldsymbol{x}_2,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_2,\boldsymbol{x}_n) \\ +\dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots \\ +y_ny_1K(\boldsymbol{x}_n,\boldsymbol{x}_1) & y_ny_2K(\boldsymbol{x}_n\boldsymbol{x}_2) & \dots & \dots & y_ny_nK(\boldsymbol{x}_n,\boldsymbol{x}_n) \\ +\end{bmatrix}\boldsymbol{\lambda}-\mathbb{1}\boldsymbol{\lambda}, +\end{split}\]
    +

    subject to \(\boldsymbol{y}^T\boldsymbol{\lambda}=0\). Here we defined the vectors \(\boldsymbol{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]\) and +\(\boldsymbol{y}=[y_1,y_2,\dots,y_n]\). +If we add the slack constants this leads to the additional constraint \(0\leq \lambda_i \leq C\).

    +

    We can rewrite this (see the solutions below) in terms of a convex optimization problem of the type

    +
    +\[\begin{split} +\begin{align*} + &\mathrm{min}_{\lambda}\hspace{0.2cm} \frac{1}{2}\boldsymbol{\lambda}^T\boldsymbol{P}\boldsymbol{\lambda}+\boldsymbol{q}^T\boldsymbol{\lambda},\\ \nonumber + &\mathrm{subject\hspace{0.1cm}to} \hspace{0.2cm} \boldsymbol{G}\boldsymbol{\lambda} \preceq \boldsymbol{h} \hspace{0.2cm} \wedge \boldsymbol{A}\boldsymbol{\lambda}=f. +\end{align*} +\end{split}\]
    +

    Below we discuss how to solve these equations. Here we note that the matrix \(\boldsymbol{P}\) has matrix elements \(p_{ij}=y_iy_jK(\boldsymbol{x}_i,\boldsymbol{x}_j)\). +Given a kernel \(K\) and the targets \(y_i\) this matrix is easy to set up. The constraint \(\boldsymbol{y}^T\boldsymbol{\lambda}=0\) leads to \(f=0\) and \(\boldsymbol{A}=\boldsymbol{y}\). How to set up the matrix \(\boldsymbol{G}\) is discussed later. Here note that the inequalities \(0\leq \lambda_i \leq C\) can be split up into +\(0\leq \lambda_i\) and \(\lambda_i \leq C\). These two inequalities define then the matrix \(\boldsymbol{G}\) and the vector \(\boldsymbol{h}\).

    +
    +
    +

    19.21. Different kernels and Mercer’s theorem

    +

    There are several popular kernels being used. These are

    +
      +
    1. Linear: \(K(\boldsymbol{x},\boldsymbol{y})=\boldsymbol{x}^T\boldsymbol{y}\),

    2. +
    3. Polynomial: \(K(\boldsymbol{x},\boldsymbol{y})=(\boldsymbol{x}^T\boldsymbol{y}+\gamma)^d\),

    4. +
    5. Gaussian Radial Basis Function: \(K(\boldsymbol{x},\boldsymbol{y})=\exp{\left(-\gamma\vert\vert\boldsymbol{x}-\boldsymbol{y}\vert\vert^2\right)}\),

    6. +
    7. Tanh: \(K(\boldsymbol{x},\boldsymbol{y})=\tanh{(\boldsymbol{x}^T\boldsymbol{y}+\gamma)}\),

    8. +
    +

    and many other ones.

    +

    An important theorem for us is Mercer’s +theorem. The +theorem states that if a kernel function \(K\) is symmetric, continuous +and leads to a positive semi-definite matrix \(\boldsymbol{P}\) then there +exists a function \(\phi\) that maps \(\boldsymbol{x}_i\) and \(\boldsymbol{x}_j\) into +another space (possibly with much higher dimensions) such that

    +
    +\[ +K(\boldsymbol{x}_i,\boldsymbol{x}_j)=\phi(\boldsymbol{x}_i)^T\phi(\boldsymbol{x}_j). +\]
    +

    So you can use \(K\) as a kernel since you know \(\phi\) exists, even if +you don’t know what \(\phi\) is.

    +

    Note that some frequently used kernels (such as the Sigmoid kernel) +don’t respect all of Mercer’s conditions, yet they generally work well +in practice.

    +
    +
    +

    19.22. The moons example

    +
    +
    +
    from __future__ import division, print_function, unicode_literals
    +
    +import numpy as np
    +np.random.seed(42)
    +
    +import matplotlib
    +import matplotlib.pyplot as plt
    +plt.rcParams['axes.labelsize'] = 14
    +plt.rcParams['xtick.labelsize'] = 12
    +plt.rcParams['ytick.labelsize'] = 12
    +
    +
    +from sklearn.svm import SVC
    +from sklearn import datasets
    +
    +
    +
    +from sklearn.pipeline import Pipeline
    +from sklearn.preprocessing import StandardScaler
    +from sklearn.svm import LinearSVC
    +
    +
    +from sklearn.datasets import make_moons
    +X, y = make_moons(n_samples=100, noise=0.15, random_state=42)
    +
    +def plot_dataset(X, y, axes):
    +    plt.plot(X[:, 0][y==0], X[:, 1][y==0], "bs")
    +    plt.plot(X[:, 0][y==1], X[:, 1][y==1], "g^")
    +    plt.axis(axes)
    +    plt.grid(True, which='both')
    +    plt.xlabel(r"$x_1$", fontsize=20)
    +    plt.ylabel(r"$x_2$", fontsize=20, rotation=0)
    +
    +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])
    +plt.show()
    +
    +from sklearn.datasets import make_moons
    +from sklearn.pipeline import Pipeline
    +from sklearn.preprocessing import PolynomialFeatures
    +
    +polynomial_svm_clf = Pipeline([
    +        ("poly_features", PolynomialFeatures(degree=3)),
    +        ("scaler", StandardScaler()),
    +        ("svm_clf", LinearSVC(C=10, loss="hinge", random_state=42))
    +    ])
    +
    +polynomial_svm_clf.fit(X, y)
    +
    +def plot_predictions(clf, axes):
    +    x0s = np.linspace(axes[0], axes[1], 100)
    +    x1s = np.linspace(axes[2], axes[3], 100)
    +    x0, x1 = np.meshgrid(x0s, x1s)
    +    X = np.c_[x0.ravel(), x1.ravel()]
    +    y_pred = clf.predict(X).reshape(x0.shape)
    +    y_decision = clf.decision_function(X).reshape(x0.shape)
    +    plt.contourf(x0, x1, y_pred, cmap=plt.cm.brg, alpha=0.2)
    +    plt.contourf(x0, x1, y_decision, cmap=plt.cm.brg, alpha=0.1)
    +
    +plot_predictions(polynomial_svm_clf, [-1.5, 2.5, -1, 1.5])
    +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])
    +
    +plt.show()
    +
    +
    +from sklearn.svm import SVC
    +
    +poly_kernel_svm_clf = Pipeline([
    +        ("scaler", StandardScaler()),
    +        ("svm_clf", SVC(kernel="poly", degree=3, coef0=1, C=5))
    +    ])
    +poly_kernel_svm_clf.fit(X, y)
    +
    +poly100_kernel_svm_clf = Pipeline([
    +        ("scaler", StandardScaler()),
    +        ("svm_clf", SVC(kernel="poly", degree=10, coef0=100, C=5))
    +    ])
    +poly100_kernel_svm_clf.fit(X, y)
    +
    +plt.figure(figsize=(11, 4))
    +
    +plt.subplot(121)
    +plot_predictions(poly_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])
    +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])
    +plt.title(r"$d=3, r=1, C=5$", fontsize=18)
    +
    +plt.subplot(122)
    +plot_predictions(poly100_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])
    +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])
    +plt.title(r"$d=10, r=100, C=5$", fontsize=18)
    +
    +plt.show()
    +
    +def gaussian_rbf(x, landmark, gamma):
    +    return np.exp(-gamma * np.linalg.norm(x - landmark, axis=1)**2)
    +
    +gamma = 0.3
    +
    +x1s = np.linspace(-4.5, 4.5, 200).reshape(-1, 1)
    +x2s = gaussian_rbf(x1s, -2, gamma)
    +x3s = gaussian_rbf(x1s, 1, gamma)
    +
    +XK = np.c_[gaussian_rbf(X1D, -2, gamma), gaussian_rbf(X1D, 1, gamma)]
    +yk = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])
    +
    +plt.figure(figsize=(11, 4))
    +
    +plt.subplot(121)
    +plt.grid(True, which='both')
    +plt.axhline(y=0, color='k')
    +plt.scatter(x=[-2, 1], y=[0, 0], s=150, alpha=0.5, c="red")
    +plt.plot(X1D[:, 0][yk==0], np.zeros(4), "bs")
    +plt.plot(X1D[:, 0][yk==1], np.zeros(5), "g^")
    +plt.plot(x1s, x2s, "g--")
    +plt.plot(x1s, x3s, "b:")
    +plt.gca().get_yaxis().set_ticks([0, 0.25, 0.5, 0.75, 1])
    +plt.xlabel(r"$x_1$", fontsize=20)
    +plt.ylabel(r"Similarity", fontsize=14)
    +plt.annotate(r'$\mathbf{x}$',
    +             xy=(X1D[3, 0], 0),
    +             xytext=(-0.5, 0.20),
    +             ha="center",
    +             arrowprops=dict(facecolor='black', shrink=0.1),
    +             fontsize=18,
    +            )
    +plt.text(-2, 0.9, "$x_2$", ha="center", fontsize=20)
    +plt.text(1, 0.9, "$x_3$", ha="center", fontsize=20)
    +plt.axis([-4.5, 4.5, -0.1, 1.1])
    +
    +plt.subplot(122)
    +plt.grid(True, which='both')
    +plt.axhline(y=0, color='k')
    +plt.axvline(x=0, color='k')
    +plt.plot(XK[:, 0][yk==0], XK[:, 1][yk==0], "bs")
    +plt.plot(XK[:, 0][yk==1], XK[:, 1][yk==1], "g^")
    +plt.xlabel(r"$x_2$", fontsize=20)
    +plt.ylabel(r"$x_3$  ", fontsize=20, rotation=0)
    +plt.annotate(r'$\phi\left(\mathbf{x}\right)$',
    +             xy=(XK[3, 0], XK[3, 1]),
    +             xytext=(0.65, 0.50),
    +             ha="center",
    +             arrowprops=dict(facecolor='black', shrink=0.1),
    +             fontsize=18,
    +            )
    +plt.plot([-0.1, 1.1], [0.57, -0.1], "r--", linewidth=3)
    +plt.axis([-0.1, 1.1, -0.1, 1.1])
    +    
    +plt.subplots_adjust(right=1)
    +
    +plt.show()
    +
    +
    +x1_example = X1D[3, 0]
    +for landmark in (-2, 1):
    +    k = gaussian_rbf(np.array([[x1_example]]), np.array([[landmark]]), gamma)
    +    print("Phi({}, {}) = {}".format(x1_example, landmark, k))
    +
    +rbf_kernel_svm_clf = Pipeline([
    +        ("scaler", StandardScaler()),
    +        ("svm_clf", SVC(kernel="rbf", gamma=5, C=0.001))
    +    ])
    +rbf_kernel_svm_clf.fit(X, y)
    +
    +
    +from sklearn.svm import SVC
    +
    +gamma1, gamma2 = 0.1, 5
    +C1, C2 = 0.001, 1000
    +hyperparams = (gamma1, C1), (gamma1, C2), (gamma2, C1), (gamma2, C2)
    +
    +svm_clfs = []
    +for gamma, C in hyperparams:
    +    rbf_kernel_svm_clf = Pipeline([
    +            ("scaler", StandardScaler()),
    +            ("svm_clf", SVC(kernel="rbf", gamma=gamma, C=C))
    +        ])
    +    rbf_kernel_svm_clf.fit(X, y)
    +    svm_clfs.append(rbf_kernel_svm_clf)
    +
    +plt.figure(figsize=(11, 7))
    +
    +for i, svm_clf in enumerate(svm_clfs):
    +    plt.subplot(221 + i)
    +    plot_predictions(svm_clf, [-1.5, 2.5, -1, 1.5])
    +    plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])
    +    gamma, C = hyperparams[i]
    +    plt.title(r"$\gamma = {}, C = {}$".format(gamma, C), fontsize=16)
    +
    +plt.show()
    +
    +
    +
    +
    +_images/chapter7_129_0.png +
    /Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/svm/_base.py:976: ConvergenceWarning: Liblinear failed to converge, increase the number of iterations.
    +  warnings.warn("Liblinear failed to converge, increase "
    +
    +
    +_images/chapter7_129_2.png +_images/chapter7_129_3.png +_images/chapter7_129_4.png +
    Phi(-1.0, -2) = [0.74081822]
    +Phi(-1.0, 1) = [0.30119421]
    +
    +
    +_images/chapter7_129_6.png +
    +
    +
    +
    +

    19.23. Mathematical optimization of convex functions

    +

    A mathematical (quadratic) optimization problem, or just optimization problem, has the form

    +
    +\[\begin{split} +\begin{align*} + &\mathrm{min}_{\lambda}\hspace{0.2cm} \frac{1}{2}\boldsymbol{\lambda}^T\boldsymbol{P}\boldsymbol{\lambda}+\boldsymbol{q}^T\boldsymbol{\lambda},\\ \nonumber + &\mathrm{subject\hspace{0.1cm}to} \hspace{0.2cm} \boldsymbol{G}\boldsymbol{\lambda} \preceq \boldsymbol{h} \wedge \boldsymbol{A}\boldsymbol{\lambda}=f. +\end{align*} +\end{split}\]
    +

    subject to some constraints for say a selected set \(i=1,2,\dots, n\). +In our case we are optimizing with respect to the Lagrangian multipliers \(\lambda_i\), and the +vector \(\boldsymbol{\lambda}=[\lambda_1, \lambda_2,\dots, \lambda_n]\) is the optimization variable we are dealing with.

    +

    In our case we are particularly interested in a class of optimization problems called convex optmization problems. +In our discussion on gradient descent methods we discussed at length the definition of a convex function.

    +

    Convex optimization problems play a central role in applied mathematics and we recommend strongly Boyd and Vandenberghe’s text on the topics.

    +
    +
    +

    19.24. How do we solve these problems?

    +

    If we use Python as programming language and wish to venture beyond +scikit-learn, tensorflow and similar software which makes our +lives so much easier, we need to dive into the wonderful world of +quadratic programming. We can, if we wish, solve the minimization +problem using say standard gradient methods or conjugate gradient +methods. However, these methods tend to exhibit a rather slow +converge. So, welcome to the promised land of quadratic programming.

    +

    The functions we need are contained in the quadratic programming package CVXOPT and we need to import it together with numpy as

    +
    +
    +
    import numpy
    +import cvxopt
    +
    +
    +
    +
    +

    This will make our life much easier. You don’t need t write your own optimizer.

    +
    +
    +

    19.25. A simple example

    +

    We remind ourselves about the general problem we want to solve

    +
    +\[\begin{split} +\begin{align*} + &\mathrm{min}_{x}\hspace{0.2cm} \frac{1}{2}\boldsymbol{x}^T\boldsymbol{P}\boldsymbol{x}+\boldsymbol{q}^T\boldsymbol{x},\\ \nonumber + &\mathrm{subject\hspace{0.1cm} to} \hspace{0.2cm} \boldsymbol{G}\boldsymbol{x} \preceq \boldsymbol{h} \wedge \boldsymbol{A}\boldsymbol{x}=f. +\end{align*} +\end{split}\]
    +

    Let us show how to perform the optmization using a simple case. Assume we want to optimize the following problem

    +
    +\[\begin{split} +\begin{align*} + &\mathrm{min}_{x}\hspace{0.2cm} \frac{1}{2}x^2+5x+3y \\ \nonumber + &\mathrm{subject to} \\ \nonumber + &x, y \geq 0 \\ \nonumber + &x+3y \geq 15 \\ \nonumber + &2x+5y \leq 100 \\ \nonumber + &3x+4y \leq 80. \\ \nonumber +\end{align*} +\end{split}\]
    +

    The minimization problem can be rewritten in terms of vectors and matrices as (with \(x\) and \(y\) being the unknowns)

    +
    +\[\begin{split} +\frac{1}{2}\begin{bmatrix} x\\ y \end{bmatrix}^T \begin{bmatrix} 1 & 0\\ 0 & 0 \end{bmatrix} \begin{bmatrix} x \\ y \end{bmatrix} + \begin{bmatrix}3\\ 4 \end{bmatrix}^T \begin{bmatrix}x \\ y \end{bmatrix}. +\end{split}\]
    +

    Similarly, we can now set up the inequalities (we need to change \(\geq\) to \(\leq\) by multiplying with \(-1\) on bot sides) as the following matrix-vector equation

    +
    +\[\begin{split} +\begin{bmatrix} -1 & 0 \\ 0 & -1 \\ -1 & -3 \\ 2 & 5 \\ 3 & 4\end{bmatrix}\begin{bmatrix} x \\ y\end{bmatrix} \preceq \begin{bmatrix}0 \\ 0\\ -15 \\ 100 \\ 80\end{bmatrix}. +\end{split}\]
    +

    We have collapsed all the inequalities into a single matrix \(\boldsymbol{G}\). We see also that our matrix

    +
    +\[\begin{split} +\boldsymbol{P} =\begin{bmatrix} 1 & 0\\ 0 & 0 \end{bmatrix} +\end{split}\]
    +

    is clearly positive semi-definite (all eigenvalues larger or equal zero). +Finally, the vector \(\boldsymbol{h}\) is defined as

    +
    +\[\begin{split} +\boldsymbol{h} = \begin{bmatrix}0 \\ 0\\ -15 \\ 100 \\ 80\end{bmatrix}. +\end{split}\]
    +

    Since we don’t have any equalities the matrix \(\boldsymbol{A}\) is set to zero +The following code solves the equations for us

    +
    +
    +
    # Import the necessary packages
    +import numpy
    +from cvxopt import matrix
    +from cvxopt import solvers
    +P = matrix(numpy.diag([1,0]), tc=’d’)
    +q = matrix(numpy.array([3,4]), tc=’d’)
    +G = matrix(numpy.array([[-1,0],[0,-1],[-1,-3],[2,5],[3,4]]), tc=’d’)
    +h = matrix(numpy.array([0,0,-15,100,80]), tc=’d’)
    +# Construct the QP, invoke solver
    +sol = solvers.qp(P,q,G,h)
    +# Extract optimal value and solution
    +sol[’x’] 
    +sol[’primal objective’]
    +
    +
    +
    +
    +
      File "<ipython-input-5-c46dd114b2af>", line 5
    +    P = matrix(numpy.diag([1,0]), tc=’d’)
    +                                       ^
    +SyntaxError: invalid character in identifier
    +
    +
    +
    +
    +
    +
    +

    19.26. Back to the more realistic cases

    +

    We are now ready to return to our setup of the optmization problem for a more realistic case. Introducing the slack parameter \(C\) we have

    +
    +\[\begin{split} +\frac{1}{2} \boldsymbol{\lambda}^T\begin{bmatrix} y_1y_1K(\boldsymbol{x}_1,\boldsymbol{x}_1) & y_1y_2K(\boldsymbol{x}_1,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_1,\boldsymbol{x}_n) \\ +y_2y_1K(\boldsymbol{x}_2,\boldsymbol{x}_1) & y_2y_2K(\boldsymbol{x}_2,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_2,\boldsymbol{x}_n) \\ +\dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots \\ +y_ny_1K(\boldsymbol{x}_n,\boldsymbol{x}_1) & y_ny_2K(\boldsymbol{x}_n\boldsymbol{x}_2) & \dots & \dots & y_ny_nK(\boldsymbol{x}_n,\boldsymbol{x}_n) \\ +\end{bmatrix}\boldsymbol{\lambda}-\mathbb{I}\boldsymbol{\lambda}, +\end{split}\]
    +

    subject to \(\boldsymbol{y}^T\boldsymbol{\lambda}=0\). Here we defined the vectors \(\boldsymbol{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]\) and +\(\boldsymbol{y}=[y_1,y_2,\dots,y_n]\). +With the slack constants this leads to the additional constraint \(0\leq \lambda_i \leq C\).

    +

    code will be added

    +
    +
    + + + + +
    + +
    +
    + + + +
    +
    +

    + + By Morten Hjorth-Jensen
    + + © Copyright 2020.
    +

    +
    +
    +
    + + +
    +
    + + + + + \ No newline at end of file diff --git a/doc/src/LectureNotes/_build/html/chapter8.html b/doc/src/LectureNotes/_build/html/chapter8.html new file mode 100644 index 000000000..72c3ffa09 --- /dev/null +++ b/doc/src/LectureNotes/_build/html/chapter8.html @@ -0,0 +1,2044 @@ + + + + + + + + + 20. Dimensionality Reduction — Applied Machine Learning and Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    + + + + + + + + +
    + +
    + +
    + + + + + + + + + + + + +
    + + +
    +
    + Contents +
    + +
    +
    +
    +
    + +
    + +
    +

    20. Dimensionality Reduction

    +
    +

    20.1. Reducing the number of degrees of freedom, overarching view

    +

    Many Machine Learning problems involve thousands or even millions of +features for each training instance. Not only does this make training +extremely slow, it can also make it much harder to find a good +solution, as we will see. This problem is often referred to as the +curse of dimensionality. Fortunately, in real-world problems, it is +often possible to reduce the number of features considerably, turning +an intractable problem into a tractable one.

    +

    Here we will discuss some of the most popular dimensionality reduction +techniques: the principal component analysis (PCA), Kernel PCA, and +Locally Linear Embedding (LLE). Furthermore, we will start by looking +at some simple preprocessing of the data which allow us to rescale the +data.

    +

    Principal component analysis and its various variants deal with the +problem of fitting a low-dimensional affine +subspace to a set of of +data points in a high-dimensional space. With its family of methods it +is one of the most used tools in data modeling, compression and +visualization.

    +
    +
    +

    20.2. Preprocessing our data

    +

    Before we proceed however, we will discuss how to preprocess our +data. Till now and in connection with our previous examples we have +not met so many cases where we are too sensitive to the scaling of our +data. Normally the data may need a rescaling and/or may be sensitive +to extreme values. Scaling the data renders our inputs much more +suitable for the algorithms we want to employ.

    +

    Scikit-Learn has several functions which allow us to rescale the +data, normally resulting in much better results in terms of various +accuracy scores. The StandardScaler function in Scikit-Learn +ensures that for each feature/predictor we study the mean value is +zero and the variance is one (every column in the design/feature +matrix). This scaling has the drawback that it does not ensure that +we have a particular maximum or minimum in our data set. Another +function included in Scikit-Learn is the MinMaxScaler which +ensures that all features are exactly between \(0\) and \(1\). The

    +
    +
    +

    20.3. More preprocessing

    +

    The Normalizer scales each data +point such that the feature vector has a euclidean length of one. In other words, it +projects a data point on the circle (or sphere in the case of higher dimensions) with a +radius of 1. This means every data point is scaled by a different number (by the +inverse of it’s length). +This normalization is often used when only the direction (or angle) of the data matters, +not the length of the feature vector.

    +

    The RobustScaler works similarly to the StandardScaler in that it +ensures statistical properties for each feature that guarantee that +they are on the same scale. However, the RobustScaler uses the median +and quartiles, instead of mean and variance. This makes the +RobustScaler ignore data points that are very different from the rest +(like measurement errors). These odd data points are also called +outliers, and might often lead to trouble for other scaling +techniques.

    +
    +
    +

    20.4. Simple preprocessing examples, Franke function and regression

    +
    +
    +
    %matplotlib inline
    +
    +# Common imports
    +import os
    +import numpy as np
    +import pandas as pd
    +import matplotlib.pyplot as plt
    +import sklearn.linear_model as skl
    +from sklearn.metrics import mean_squared_error
    +from sklearn.model_selection import  train_test_split
    +from sklearn.preprocessing import MinMaxScaler, StandardScaler, Normalizer
    +from sklearn.svm import SVR
    +
    +# Where to save the figures and data files
    +PROJECT_ROOT_DIR = "Results"
    +FIGURE_ID = "Results/FigureFiles"
    +DATA_ID = "DataFiles/"
    +
    +if not os.path.exists(PROJECT_ROOT_DIR):
    +    os.mkdir(PROJECT_ROOT_DIR)
    +
    +if not os.path.exists(FIGURE_ID):
    +    os.makedirs(FIGURE_ID)
    +
    +if not os.path.exists(DATA_ID):
    +    os.makedirs(DATA_ID)
    +
    +def image_path(fig_id):
    +    return os.path.join(FIGURE_ID, fig_id)
    +
    +def data_path(dat_id):
    +    return os.path.join(DATA_ID, dat_id)
    +
    +def save_fig(fig_id):
    +    plt.savefig(image_path(fig_id) + ".png", format='png')
    +
    +
    +def FrankeFunction(x,y):
    +	term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))
    +	term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))
    +	term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))
    +	term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)
    +	return term1 + term2 + term3 + term4
    +
    +
    +def create_X(x, y, n ):
    +	if len(x.shape) > 1:
    +		x = np.ravel(x)
    +		y = np.ravel(y)
    +
    +	N = len(x)
    +	l = int((n+1)*(n+2)/2)		# Number of elements in beta
    +	X = np.ones((N,l))
    +
    +	for i in range(1,n+1):
    +		q = int((i)*(i+1)/2)
    +		for k in range(i+1):
    +			X[:,q+k] = (x**(i-k))*(y**k)
    +
    +	return X
    +
    +
    +# Making meshgrid of datapoints and compute Franke's function
    +n = 5
    +N = 1000
    +x = np.sort(np.random.uniform(0, 1, N))
    +y = np.sort(np.random.uniform(0, 1, N))
    +z = FrankeFunction(x, y)
    +X = create_X(x, y, n=n)    
    +# split in training and test data
    +X_train, X_test, y_train, y_test = train_test_split(X,z,test_size=0.2)
    +
    +
    +svm = SVR(gamma='auto',C=10.0)
    +svm.fit(X_train, y_train)
    +
    +# The mean squared error and R2 score
    +print("MSE before scaling: {:.2f}".format(mean_squared_error(svm.predict(X_test), y_test)))
    +print("R2 score before scaling {:.2f}".format(svm.score(X_test,y_test)))
    +
    +scaler = StandardScaler()
    +scaler.fit(X_train)
    +X_train_scaled = scaler.transform(X_train)
    +X_test_scaled = scaler.transform(X_test)
    +
    +print("Feature min values before scaling:\n {}".format(X_train.min(axis=0)))
    +print("Feature max values before scaling:\n {}".format(X_train.max(axis=0)))
    +
    +print("Feature min values after scaling:\n {}".format(X_train_scaled.min(axis=0)))
    +print("Feature max values after scaling:\n {}".format(X_train_scaled.max(axis=0)))
    +
    +svm = SVR(gamma='auto',C=10.0)
    +svm.fit(X_train_scaled, y_train)
    +
    +print("MSE after  scaling: {:.2f}".format(mean_squared_error(svm.predict(X_test_scaled), y_test)))
    +print("R2 score for  scaled data: {:.2f}".format(svm.score(X_test_scaled,y_test)))
    +
    +
    +
    +
    +
    MSE before scaling: 0.01
    +R2 score before scaling 0.93
    +Feature min values before scaling:
    + [1.00000000e+00 7.43297505e-04 1.67887686e-04 5.52491181e-07
    + 1.24790498e-07 2.81862750e-08 4.10665316e-10 9.27564656e-11
    + 2.09507879e-11 4.73212847e-12 3.05246505e-13 6.89456494e-14
    + 1.55726683e-14 3.51737928e-15 7.94466097e-16 2.26888965e-16
    + 5.12471292e-17 1.15751255e-17 2.61445925e-18 5.90524667e-19
    + 1.33381074e-19]
    +Feature max values before scaling:
    + [1.         0.99422559 0.99481826 0.98848453 0.98907377 0.98966337
    + 0.98277662 0.98336246 0.98394865 0.98453519 0.97710167 0.97768412
    + 0.97826693 0.97885008 0.97943358 0.97145948 0.97203858 0.97261802
    + 0.9731978  0.97377793 0.97435841]
    +Feature min values after scaling:
    + [ 0.         -1.7697784  -1.72415276 -1.14649434 -1.12953807 -1.11320874
    + -0.90535485 -0.8968819  -0.88864254 -0.88062733 -0.77069333 -0.76574003
    + -0.76089806 -0.7561637  -0.75153337 -0.68210821 -0.6789547  -0.67586334
    + -0.67283231 -0.66985986 -0.66694428]
    +Feature max values after scaling:
    + [0.         1.68453745 1.71039356 2.1618639  2.17707405 2.19168422
    + 2.54536814 2.55730765 2.56887875 2.58009023 2.87398064 2.88442648
    + 2.89461285 2.90454384 2.91422324 3.16472629 3.17449812 3.18407693
    + 3.19346461 3.20266288 3.21167335]
    +MSE after  scaling: 0.00
    +R2 score for  scaled data: 0.97
    +
    +
    +
    +
    +
    +
    +

    20.5. Simple preprocessing examples, breast cancer data and classification, Support Vector Machines

    +

    We show here how we can use a simple regression case on the breast +cancer data using support vector machines (SVM) as algorithm for +classification.

    +
    +
    +
    import matplotlib.pyplot as plt
    +import numpy as np
    +from sklearn.model_selection import  train_test_split 
    +from sklearn.datasets import load_breast_cancer
    +from sklearn.svm import SVC
    +cancer = load_breast_cancer()
    +
    +X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)
    +print(X_train.shape)
    +print(X_test.shape)
    +
    +svm = SVC(C=100)
    +svm.fit(X_train, y_train)
    +print("Test set accuracy: {:.2f}".format(svm.score(X_test,y_test)))
    +
    +from sklearn.preprocessing import MinMaxScaler, StandardScaler
    +scaler = MinMaxScaler()
    +scaler.fit(X_train)
    +X_train_scaled = scaler.transform(X_train)
    +X_test_scaled = scaler.transform(X_test)
    +
    +print("Feature min values before scaling:\n {}".format(X_train.min(axis=0)))
    +print("Feature max values before scaling:\n {}".format(X_train.max(axis=0)))
    +
    +print("Feature min values before scaling:\n {}".format(X_train_scaled.min(axis=0)))
    +print("Feature max values before scaling:\n {}".format(X_train_scaled.max(axis=0)))
    +
    +
    +svm.fit(X_train_scaled, y_train)
    +print("Test set accuracy scaled data with Min-Max scaling: {:.2f}".format(svm.score(X_test_scaled,y_test)))
    +
    +scaler = StandardScaler()
    +scaler.fit(X_train)
    +X_train_scaled = scaler.transform(X_train)
    +X_test_scaled = scaler.transform(X_test)
    +
    +svm.fit(X_train_scaled, y_train)
    +print("Test set accuracy scaled data with Standar Scaler: {:.2f}".format(svm.score(X_test_scaled,y_test)))
    +
    +
    +
    +
    +
    (426, 30)
    +(143, 30)
    +Test set accuracy: 0.94
    +Feature min values before scaling:
    + [6.981e+00 9.710e+00 4.379e+01 1.435e+02 5.263e-02 1.938e-02 0.000e+00
    + 0.000e+00 1.060e-01 4.996e-02 1.115e-01 3.628e-01 7.570e-01 7.228e+00
    + 1.713e-03 2.252e-03 0.000e+00 0.000e+00 7.882e-03 8.948e-04 7.930e+00
    + 1.202e+01 5.041e+01 1.852e+02 7.117e-02 2.729e-02 0.000e+00 0.000e+00
    + 1.565e-01 5.504e-02]
    +Feature max values before scaling:
    + [2.811e+01 3.381e+01 1.885e+02 2.501e+03 1.447e-01 3.114e-01 4.268e-01
    + 2.012e-01 3.040e-01 9.744e-02 2.873e+00 4.885e+00 2.198e+01 5.422e+02
    + 2.333e-02 1.064e-01 3.960e-01 5.279e-02 6.146e-02 2.984e-02 3.604e+01
    + 4.954e+01 2.512e+02 4.254e+03 2.226e-01 1.058e+00 1.252e+00 2.903e-01
    + 6.638e-01 2.075e-01]
    +Feature min values before scaling:
    + [0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0.
    + 0. 0. 0. 0. 0. 0.]
    +
    +
    +
    Feature max values before scaling:
    + [1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1.
    + 1. 1. 1. 1. 1. 1.]
    +Test set accuracy scaled data with Min-Max scaling: 0.97
    +Test set accuracy scaled data with Standar Scaler: 0.96
    +
    +
    +
    +
    +
    +
    +

    20.6. More on Cancer Data, now with Logistic Regression

    +
    +
    +
    import matplotlib.pyplot as plt
    +import numpy as np
    +from sklearn.model_selection import  train_test_split 
    +from sklearn.datasets import load_breast_cancer
    +from sklearn.linear_model import LogisticRegression
    +cancer = load_breast_cancer()
    +
    +# Set up training data
    +X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)
    +logreg = LogisticRegression()
    +logreg.fit(X_train, y_train)
    +print("Test set accuracy: {:.2f}".format(logreg.score(X_test,y_test)))
    +
    +# Scale data
    +from sklearn.preprocessing import StandardScaler
    +scaler = StandardScaler()
    +scaler.fit(X_train)
    +X_train_scaled = scaler.transform(X_train)
    +X_test_scaled = scaler.transform(X_test)
    +logreg.fit(X_train_scaled, y_train)
    +print("Test set accuracy scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test)))
    +
    +
    +
    +
    +
    Test set accuracy: 0.95
    +Test set accuracy scaled data: 0.96
    +
    +
    +
    /Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/linear_model/_logistic.py:762: ConvergenceWarning: lbfgs failed to converge (status=1):
    +STOP: TOTAL NO. of ITERATIONS REACHED LIMIT.
    +
    +Increase the number of iterations (max_iter) or scale the data as shown in:
    +    https://scikit-learn.org/stable/modules/preprocessing.html
    +Please also refer to the documentation for alternative solver options:
    +    https://scikit-learn.org/stable/modules/linear_model.html#logistic-regression
    +  n_iter_i = _check_optimize_result(
    +
    +
    +
    +
    +
    +
    +

    20.7. Why should we think of reducing the dimensionality

    +

    In addition to the plot of the features, we study now also the covariance (and the correlation matrix). +We use also Pandas to compute the correlation matrix.

    +
    +
    +
    import matplotlib.pyplot as plt
    +import numpy as np
    +from sklearn.model_selection import  train_test_split 
    +from sklearn.datasets import load_breast_cancer
    +from sklearn.linear_model import LogisticRegression
    +cancer = load_breast_cancer()
    +import pandas as pd
    +# Making a data frame
    +cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)
    +
    +fig, axes = plt.subplots(15,2,figsize=(10,20))
    +malignant = cancer.data[cancer.target == 0]
    +benign = cancer.data[cancer.target == 1]
    +ax = axes.ravel()
    +
    +for i in range(30):
    +    _, bins = np.histogram(cancer.data[:,i], bins =50)
    +    ax[i].hist(malignant[:,i], bins = bins, alpha = 0.5)
    +    ax[i].hist(benign[:,i], bins = bins, alpha = 0.5)
    +    ax[i].set_title(cancer.feature_names[i])
    +    ax[i].set_yticks(())
    +ax[0].set_xlabel("Feature magnitude")
    +ax[0].set_ylabel("Frequency")
    +ax[0].legend(["Malignant", "Benign"], loc ="best")
    +fig.tight_layout()
    +plt.show()
    +
    +import seaborn as sns
    +correlation_matrix = cancerpd.corr().round(1)
    +# use the heatmap function from seaborn to plot the correlation matrix
    +# annot = True to print the values inside the square
    +sns.heatmap(data=correlation_matrix, annot=True)
    +plt.show()
    +
    +#print eigvalues of correlation matrix
    +EigValues, EigVectors = np.linalg.eig(correlation_matrix)
    +print(EigValues)
    +
    +
    +
    +
    +_images/chapter8_7_0.png +_images/chapter8_7_1.png +
    [ 1.33026664e+01  5.69238112e+00  2.83259341e+00  1.99126621e+00
    +  1.69095941e+00  1.19614372e+00  7.13037918e-01  5.77804918e-01
    +  5.14549644e-01  4.30579019e-01  3.58977964e-01 -1.91269450e-01
    +  2.86195387e-01 -1.59310961e-01 -1.38483045e-01  2.44786221e-01
    + -8.79318674e-02  1.91811329e-01  1.70896266e-01 -7.17683028e-02
    +  1.39860289e-01  1.18721828e-01 -4.83194721e-02  8.92983892e-02
    +  6.81402316e-02  6.01968016e-02  3.31819744e-02  1.56432255e-02
    + -1.61028757e-02 -6.50565973e-03]
    +
    +
    +
    +
    +

    In the above example we note two things. In the first plot we display +the overlap of benign and malignant tumors as functions of the various +features in the Wisconsing breast cancer data set. We see that for +some of the features we can distinguish clearly the benign and +malignant cases while for other features we cannot. This can point to +us which features may be of greater interest when we wish to classify +a benign or not benign tumour.

    +

    In the second figure we have computed the so-called correlation +matrix, which in our case with thirty features becomes a \(30\times 30\) +matrix.

    +

    We constructed this matrix using pandas via the statements

    +
    +
    +
    cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)
    +
    +
    +
    +
    +

    and then

    +
    +
    +
    correlation_matrix = cancerpd.corr().round(1)
    +
    +
    +
    +
    +

    Diagonalizing this matrix we can in turn say something about which +features are of relevance and which are not. But before we proceed we +need to define covariance and correlation matrices. This leads us to +the classical Principal Component Analysis (PCA) theorem with +applications.

    +
    +
    +

    20.8. Basic ideas of the Principal Component Analysis (PCA)

    +

    The principal component analysis deals with the problem of fitting a +low-dimensional affine subspace \(S\) of dimension \(d\) much smaller than +the totaldimension \(D\) of the problem at hand (our data +set). Mathematically it can be formulated as a statistical problem or +a geometric problem. In our discussion of the theorem for the +classical PCA, we will stay with a statistical approach. This is also +what set the scene historically which for the PCA.

    +

    We have a data set defined by a design/feature matrix \(\boldsymbol{X}\) (see below for its definition)

    +
      +
    • Each data point is determined by \(p\) extrinsic (measurement) variables

    • +
    • We may want to ask the following question: Are there fewer intrinsic variables (say \(d << p\)) that still approximately describe the data?

    • +
    • If so, these intrinsic variables may tell us something important and finding these intrinsic variables is what dimension reduction methods do.

    • +
    +
    +
    +

    20.9. Introducing the Covariance and Correlation functions

    +

    Before we discuss the PCA theorem, we need to remind ourselves about +the definition of the covariance and the correlation function. These are quantities

    +

    Suppose we have defined two vectors +\(\hat{x}\) and \(\hat{y}\) with \(n\) elements each. The covariance matrix \(\boldsymbol{C}\) is defined as

    +
    +\[\begin{split} +\boldsymbol{C}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} \mathrm{cov}[\boldsymbol{x},\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] \\ + \mathrm{cov}[\boldsymbol{y},\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{y},\boldsymbol{y}] \\ + \end{bmatrix}, +\end{split}\]
    +

    where for example

    +
    +\[ +\mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] =\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})(y_i- \overline{y}). +\]
    +

    With this definition and recalling that the variance is defined as

    +
    +\[ +\mathrm{var}[\boldsymbol{x}]=\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})^2, +\]
    +

    we can rewrite the covariance matrix as

    +
    +\[\begin{split} +\boldsymbol{C}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} \mathrm{var}[\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] \\ + \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] & \mathrm{var}[\boldsymbol{y}] \\ + \end{bmatrix}. +\end{split}\]
    +

    The covariance takes values between zero and infinity and may thus +lead to problems with loss of numerical precision for particularly +large values. It is common to scale the covariance matrix by +introducing instead the correlation matrix defined via the so-called +correlation function

    +
    +\[ +\mathrm{corr}[\boldsymbol{x},\boldsymbol{y}]=\frac{\mathrm{cov}[\boldsymbol{x},\boldsymbol{y}]}{\sqrt{\mathrm{var}[\boldsymbol{x}] \mathrm{var}[\boldsymbol{y}]}}. +\]
    +

    The correlation function is then given by values \(\mathrm{corr}[\boldsymbol{x},\boldsymbol{y}] +\in [-1,1]\). This avoids eventual problems with too large values. We +can then define the correlation matrix for the two vectors \(\boldsymbol{x}\) +and \(\boldsymbol{y}\) as

    +
    +\[\begin{split} +\boldsymbol{K}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} 1 & \mathrm{corr}[\boldsymbol{x},\boldsymbol{y}] \\ + \mathrm{corr}[\boldsymbol{y},\boldsymbol{x}] & 1 \\ + \end{bmatrix}, +\end{split}\]
    +

    In the above example this is the function we constructed using pandas.

    +
    +
    +

    20.10. Correlation Function and Design/Feature Matrix

    +

    In our derivation of the various regression algorithms like Ordinary Least Squares or Ridge regression +we defined the design/feature matrix \(\boldsymbol{X}\) as

    +
    +\[\begin{split} +\boldsymbol{X}=\begin{bmatrix} +x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ +x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ +x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ +\dots & \dots & \dots & \dots \dots & \dots \\ +x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ +x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ +\end{bmatrix}, +\end{split}\]
    +

    with \(\boldsymbol{X}\in {\mathbb{R}}^{n\times p}\), with the predictors/features \(p\) refering to the column numbers and the +entries \(n\) being the row elements. +We can rewrite the design/feature matrix in terms of its column vectors as

    +
    +\[ +\boldsymbol{X}=\begin{bmatrix} \boldsymbol{x}_0 & \boldsymbol{x}_1 & \boldsymbol{x}_2 & \dots & \dots & \boldsymbol{x}_{p-1}\end{bmatrix}, +\]
    +

    with a given vector

    +
    +\[ +\boldsymbol{x}_i^T = \begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \dots & \dots x_{n-1,i}\end{bmatrix}. +\]
    +

    With these definitions, we can now rewrite our \(2\times 2\) +correaltion/covariance matrix in terms of a moe general design/feature +matrix \(\boldsymbol{X}\in {\mathbb{R}}^{n\times p}\). This leads to a \(p\times p\) +covariance matrix for the vectors \(\boldsymbol{x}_i\) with \(i=0,1,\dots,p-1\)

    +
    +\[\begin{split} +\boldsymbol{C}[\boldsymbol{x}] = \begin{bmatrix} +\mathrm{var}[\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_{p-1}]\\ +\mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_0] & \mathrm{var}[\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_{p-1}]\\ +\mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_1] & \mathrm{var}[\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_{p-1}]\\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_{2}] & \dots & \dots & \mathrm{var}[\boldsymbol{x}_{p-1}]\\ +\end{bmatrix}, +\end{split}\]
    +

    and the correlation matrix

    +
    +\[\begin{split} +\boldsymbol{K}[\boldsymbol{x}] = \begin{bmatrix} +1 & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_1] & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_2] & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_{p-1}]\\ +\mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_0] & 1 & \mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_2] & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_{p-1}]\\ +\mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_0] & \mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_1] & 1 & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_{p-1}]\\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_0] & \mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_1] & \mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_{2}] & \dots & \dots & 1\\ +\end{bmatrix}, +\end{split}\]
    +
    +
    +

    20.11. Covariance Matrix Examples

    +

    The Numpy function np.cov calculates the covariance elements using +the factor \(1/(n-1)\) instead of \(1/n\) since it assumes we do not have +the exact mean values. The following simple function uses the +np.vstack function which takes each vector of dimension \(1\times n\) +and produces a \(2\times n\) matrix \(\boldsymbol{W}\)

    +
    +\[\begin{split} +\boldsymbol{W} = \begin{bmatrix} x_0 & y_0 \\ + x_1 & y_1 \\ + x_2 & y_2\\ + \dots & \dots \\ + x_{n-2} & y_{n-2}\\ + x_{n-1} & y_{n-1} & + \end{bmatrix}, +\end{split}\]
    +

    which in turn is converted into into the \(2\times 2\) covariance matrix +\(\boldsymbol{C}\) via the Numpy function np.cov(). We note that we can also calculate +the mean value of each set of samples \(\boldsymbol{x}\) etc using the Numpy +function np.mean(x). We can also extract the eigenvalues of the +covariance matrix through the np.linalg.eig() function.

    +
    +
    +
    # Importing various packages
    +import numpy as np
    +n = 100
    +x = np.random.normal(size=n)
    +print(np.mean(x))
    +y = 4+3*x+np.random.normal(size=n)
    +print(np.mean(y))
    +W = np.vstack((x, y))
    +C = np.cov(W)
    +print(C)
    +
    +
    +
    +
    +
    0.039184456674535545
    +4.128680426693387
    +[[ 1.12297057  3.2186233 ]
    + [ 3.2186233  10.11517976]]
    +
    +
    +
    +
    +
    +
    +

    20.12. Correlation Matrix

    +

    The previous example can be converted into the correlation matrix by +simply scaling the matrix elements with the variances. We should also +subtract the mean values for each column. This leads to the following +code which sets up the correlations matrix for the previous example in +a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the \(2\times 2\) correlation matrix (since we have only two vectors).

    +
    +
    +
    import numpy as np
    +n = 100
    +# define two vectors                                                                                           
    +x = np.random.random(size=n)
    +y = 4+3*x+np.random.normal(size=n)
    +#scaling the x and y vectors                                                                                   
    +x = x - np.mean(x)
    +y = y - np.mean(y)
    +variance_x = np.sum(x@x)/n
    +variance_y = np.sum(y@y)/n
    +print(variance_x)
    +print(variance_y)
    +cov_xy = np.sum(x@y)/n
    +cov_xx = np.sum(x@x)/n
    +cov_yy = np.sum(y@y)/n
    +C = np.zeros((2,2))
    +C[0,0]= cov_xx/variance_x
    +C[1,1]= cov_yy/variance_y
    +C[0,1]= cov_xy/np.sqrt(variance_y*variance_x)
    +C[1,0]= C[0,1]
    +print(C)
    +
    +
    +
    +
    +
    0.08474873038505544
    +1.7239002399681738
    +[[1.         0.62968416]
    + [0.62968416 1.        ]]
    +
    +
    +
    +
    +

    We see that the matrix elements along the diagonal are one as they +should be and that the matrix is symmetric. Furthermore, diagonalizing +this matrix we easily see that it is a positive definite matrix.

    +

    The above procedure with numpy can be made more compact if we use pandas.

    +
    +
    +

    20.13. Correlation Matrix with Pandas

    +

    We whow here how we can set up the correlation matrix using pandas, as done in this simple code

    +
    +
    +
    import numpy as np
    +import pandas as pd
    +n = 10
    +x = np.random.normal(size=n)
    +x = x - np.mean(x)
    +y = 4+3*x+np.random.normal(size=n)
    +y = y - np.mean(y)
    +X = (np.vstack((x, y))).T
    +print(X)
    +Xpd = pd.DataFrame(X)
    +print(Xpd)
    +correlation_matrix = Xpd.corr()
    +print(correlation_matrix)
    +
    +
    +
    +
    +
    [[ 0.29439863  1.90169666]
    + [ 1.67736015  3.10465335]
    + [-0.55604865 -0.71001501]
    + [-0.86385893 -3.79843757]
    + [-0.32231733  0.0602184 ]
    + [-1.30134141 -3.01442901]
    + [-0.46095356  0.49571687]
    + [ 0.83524925  1.94721304]
    + [-0.41069583 -1.37424606]
    + [ 1.10820768  1.38762934]]
    +          0         1
    +0  0.294399  1.901697
    +1  1.677360  3.104653
    +2 -0.556049 -0.710015
    +3 -0.863859 -3.798438
    +4 -0.322317  0.060218
    +5 -1.301341 -3.014429
    +6 -0.460954  0.495717
    +7  0.835249  1.947213
    +8 -0.410696 -1.374246
    +9  1.108208  1.387629
    +          0         1
    +0  1.000000  0.883341
    +1  0.883341  1.000000
    +
    +
    +
    +
    +

    We expand this model to the Franke function discussed above.

    +
    +
    +

    20.14. Correlation Matrix with Pandas and the Franke function

    +
    +
    +
    # Common imports
    +import numpy as np
    +import pandas as pd
    +
    +
    +def FrankeFunction(x,y):
    +	term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))
    +	term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))
    +	term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))
    +	term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)
    +	return term1 + term2 + term3 + term4
    +
    +
    +def create_X(x, y, n ):
    +	if len(x.shape) > 1:
    +		x = np.ravel(x)
    +		y = np.ravel(y)
    +
    +	N = len(x)
    +	l = int((n+1)*(n+2)/2)		# Number of elements in beta
    +	X = np.ones((N,l))
    +
    +	for i in range(1,n+1):
    +		q = int((i)*(i+1)/2)
    +		for k in range(i+1):
    +			X[:,q+k] = (x**(i-k))*(y**k)
    +
    +	return X
    +
    +
    +# Making meshgrid of datapoints and compute Franke's function
    +n = 4
    +N = 100
    +x = np.sort(np.random.uniform(0, 1, N))
    +y = np.sort(np.random.uniform(0, 1, N))
    +z = FrankeFunction(x, y)
    +X = create_X(x, y, n=n)    
    +
    +Xpd = pd.DataFrame(X)
    +# subtract the mean values and set up the covariance matrix
    +Xpd = Xpd - Xpd.mean()
    +covariance_matrix = Xpd.cov()
    +print(covariance_matrix)
    +
    +
    +
    +
    +
         0         1         2         3         4         5         6         7   \
    +0   0.0  0.000000  0.000000  0.000000  0.000000  0.000000  0.000000  0.000000   
    +1   0.0  0.088096  0.086427  0.083845  0.082640  0.081425  0.073689  0.072606   
    +2   0.0  0.086427  0.085149  0.082400  0.081356  0.080291  0.072444  0.071452   
    +3   0.0  0.083845  0.082400  0.085937  0.084688  0.083422  0.079032  0.077855   
    +4   0.0  0.082640  0.081356  0.084688  0.083531  0.082352  0.077865  0.076753   
    +5   0.0  0.081425  0.080291  0.083422  0.082352  0.081256  0.076682  0.075632   
    +6   0.0  0.073689  0.072444  0.079032  0.077865  0.076682  0.074903  0.073780   
    +7   0.0  0.072606  0.071452  0.077855  0.076753  0.075632  0.073780  0.072708   
    +8   0.0  0.071547  0.070480  0.076701  0.075660  0.074600  0.072677  0.071655   
    +9   0.0  0.070513  0.069529  0.075570  0.074589  0.073587  0.071595  0.070622   
    +10  0.0  0.064543  0.063450  0.071358  0.070294  0.069218  0.069100  0.068064   
    +11  0.0  0.063581  0.062551  0.070288  0.069275  0.068248  0.068065  0.067072   
    +12  0.0  0.062646  0.061677  0.069247  0.068283  0.067304  0.067057  0.066105   
    +13  0.0  0.061738  0.060828  0.068235  0.067318  0.066385  0.066075  0.065164   
    +14  0.0  0.060857  0.060003  0.067250  0.066378  0.065490  0.065119  0.064247   
    +
    +          8         9         10        11        12        13        14  
    +0   0.000000  0.000000  0.000000  0.000000  0.000000  0.000000  0.000000  
    +1   0.071547  0.070513  0.064543  0.063581  0.062646  0.061738  0.060857  
    +2   0.070480  0.069529  0.063450  0.062551  0.061677  0.060828  0.060003  
    +3   0.076701  0.075570  0.071358  0.070288  0.069247  0.068235  0.067250  
    +4   0.075660  0.074589  0.070294  0.069275  0.068283  0.067318  0.066378  
    +5   0.074600  0.073587  0.069218  0.068248  0.067304  0.066385  0.065490  
    +6   0.072677  0.071595  0.069100  0.068065  0.067057  0.066075  0.065119  
    +7   0.071655  0.070622  0.068064  0.067072  0.066105  0.065164  0.064247  
    +8   0.070650  0.069664  0.067046  0.066096  0.065170  0.064268  0.063389  
    +9   0.069664  0.068722  0.066047  0.065138  0.064251  0.063387  0.062545  
    +10  0.067046  0.066047  0.064786  0.063821  0.062880  0.061964  0.061071  
    +11  0.066096  0.065138  0.063821  0.062893  0.061989  0.061108  0.060249  
    +12  0.065170  0.064251  0.062880  0.061989  0.061120  0.060273  0.059447  
    +13  0.064268  0.063387  0.061964  0.061108  0.060273  0.059458  0.058665  
    +14  0.063389  0.062545  0.061071  0.060249  0.059447  0.058665  0.057901  
    +
    +
    +
    +
    +

    We note here that the covariance is zero for the first rows and +columns since all matrix elements in the design matrix were set to one +(we are fitting the function in terms of a polynomial of degree \(n\)).

    +

    This means that the variance for these elements will be zero and will +cause problems when we set up the correlation matrix. We can simply +drop these elements and construct a correlation +matrix without these elements.

    +
    +
    +

    20.15. Rewriting the Covariance and/or Correlation Matrix

    +

    We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix \(\boldsymbol{X}\) as

    +
    +\[ +\boldsymbol{C}[\boldsymbol{x}] = \frac{1}{n}\boldsymbol{X}\boldsymbol{X}^T= \mathbb{E}[\boldsymbol{X}\boldsymbol{X}^T]. +\]
    +

    To see this let us simply look at a design matrix \(\boldsymbol{X}\in {\mathbb{R}}^{2\times 2}\)

    +
    +\[\begin{split} +\boldsymbol{X}=\begin{bmatrix} +x_{00} & x_{01}\\ +x_{10} & x_{11}\\ +\end{bmatrix}=\begin{bmatrix} +\boldsymbol{x}_{0} & \boldsymbol{x}_{1}\\ +\end{bmatrix}. +\end{split}\]
    +

    If we then compute the expectation value

    +
    +\[\begin{split} +\mathbb{E}[\boldsymbol{X}\boldsymbol{X}^T] = \frac{1}{n}\boldsymbol{X}\boldsymbol{X}^T=\begin{bmatrix} +x_{00}^2+x_{01}^2 & x_{00}x_{10}+x_{01}x_{11}\\ +x_{10}x_{00}+x_{11}x_{01} & x_{10}^2+x_{11}^2\\ +\end{bmatrix}, +\end{split}\]
    +

    which is just

    +
    +\[\begin{split} +\boldsymbol{C}[\boldsymbol{x}_0,\boldsymbol{x}_1] = \boldsymbol{C}[\boldsymbol{x}]=\begin{bmatrix} \mathrm{var}[\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_1] \\ + \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_0] & \mathrm{var}[\boldsymbol{x}_1] \\ + \end{bmatrix}, +\end{split}\]
    +

    where we wrote $\(\boldsymbol{C}[\boldsymbol{x}_0,\boldsymbol{x}_1] = \boldsymbol{C}[\boldsymbol{x}]\)\( to indicate that this the covariance of the vectors \)\boldsymbol{x}\( of the design/feature matrix \)\boldsymbol{X}$.

    +

    It is easy to generalize this to a matrix \(\boldsymbol{X}\in {\mathbb{R}}^{n\times p}\).

    +
    +
    +

    20.16. Towards the PCA theorem

    +

    We have that the covariance matrix (the correlation matrix involves a simple rescaling) is given as

    +
    +\[ +\boldsymbol{C}[\boldsymbol{x}] = \frac{1}{n}\boldsymbol{X}\boldsymbol{X}^T= \mathbb{E}[\boldsymbol{X}\boldsymbol{X}^T]. +\]
    +

    Let us now assume that we can perform a series of orthogonal transformations where we employ some orthogonal matrices \(\boldsymbol{S}\). +These matrices are defined as \(\boldsymbol{S}\in {\mathbb{R}}^{p\times p}\) and obey the orthogonality requirements \(\boldsymbol{S}\boldsymbol{S}^T=\boldsymbol{S}^T\boldsymbol{S}=\boldsymbol{I}\). The matrix can be written out in terms of the column vectors \(\boldsymbol{s}_i\) as \(\boldsymbol{S}=[\boldsymbol{s}_0,\boldsymbol{s}_1,\dots,\boldsymbol{s}_{p-1}]\) and \(\boldsymbol{s}_i \in {\mathbb{R}}^{p}\).

    +

    Assume also that there is a transformation \(\boldsymbol{S}\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}^T=\boldsymbol{C}[\boldsymbol{y}]\) such that the new matrix \(\boldsymbol{C}[\boldsymbol{y}]\) is diagonal with elements \([\lambda_0,\lambda_1,\lambda_2,\dots,\lambda_{p-1}]\).

    +

    That is we have

    +
    +\[ +\boldsymbol{C}[\boldsymbol{y}] = \mathbb{E}[\boldsymbol{S}\boldsymbol{X}\boldsymbol{X}^T\boldsymbol{S}^T]=\boldsymbol{S}\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}^T, +\]
    +

    since the matrix \(\boldsymbol{S}\) is not a data dependent matrix. Multiplying with \(\boldsymbol{S}^T\) from the left we have

    +
    +\[ +\boldsymbol{S}^T\boldsymbol{C}[\boldsymbol{y}] = \boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}^T, +\]
    +

    and since \(\boldsymbol{C}[\boldsymbol{y}]\) is diagonal we have for a given eigenvalue \(i\) of the covariance matrix that

    +
    +\[ +\boldsymbol{S}^T_i\lambda_i = \boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}^T_i. +\]
    +

    In the derivation of the PCA theorem we will assume that the eigenvalues are ordered in descending order, that is +\(\lambda_0 > \lambda_1 > \dots > \lambda_{p-1}\).

    +

    The eigenvalues tell us then how much we need to stretch the +corresponding eigenvectors. Dimensions with large eigenvalues have +thus large variations (large variance) and define therefore useful +dimensions. The data points are more spread out in the direction of +these eigenvectors. Smaller eigenvalues mean on the other hand that +the corresponding eigenvectors are shrunk accordingly and the data +points are tightly bunched together and there is not much variation in +these specific directions. Hopefully then we could leave it out +dimensions where the eigenvalues are very small. If \(p\) is very large, +we could then aim at reducing \(p\) to \(l << p\) and handle only \(l\) +features/predictors.

    +
    +
    +

    20.17. The Algorithm before theorem

    +

    Here’s how we would proceed in setting up the algorithm for the PCA, see also discussion below here.

    +
      +
    • Set up the datapoints for the design/feature matrix \(\boldsymbol{X}\) with \(\boldsymbol{X}\in {\mathbb{R}}^{n\times p}\), with the predictors/features \(p\) referring to the column numbers and the entries \(n\) being the row elements.

    • +
    +
    +\[\begin{split} +\boldsymbol{X}=\begin{bmatrix} +x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ +x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ +x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ +\dots & \dots & \dots & \dots \dots & \dots \\ +x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ +x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ +\end{bmatrix}, +\end{split}\]
    +
      +
    • Center the data by subtracting the mean value for each column. This leads to a new matrix \(\boldsymbol{X}\rightarrow \overline{\boldsymbol{X}}\).

    • +
    • Compute then the covariance/correlation matrix \(\mathbb{E}[\overline{\boldsymbol{X}}\overline{\boldsymbol{X}}^T]\).

    • +
    • Find the eigenpairs of \(\boldsymbol{C}\) with eigenvalues \([\lambda_0,\lambda_1,\dots,\lambda_{p-1}]\) and eigenvectors \([\boldsymbol{s}_0,\boldsymbol{s}_1,\dots,\boldsymbol{s}_{p-1}]\).

    • +
    • Order the eigenvalue (and the eigenvectors accordingly) in order of decreasing eigenvalues.

    • +
    • Keep only those \(l\) eigenvalues larger than a selected threshold value, discarding thus \(p-l\) features since we expect small variations in the data here.

    • +
    +
    +
    +

    20.18. Writing our own PCA code

    +

    We will use a simple example first with two-dimensional data +drawn from a multivariate normal distribution with the following mean and covariance matrix:

    +
    +\[\begin{split} +\mu = (-1,2) \qquad \Sigma = \begin{bmatrix} 4 & 2 \\ +2 & 2 +\end{bmatrix} +\end{split}\]
    +

    Note that the mean refers to each column of data. +We will generate \(n = 1000\) points \(X = \{ x_1, \ldots, x_N \}\) from +this distribution, and store them in the \(1000 \times 2\) matrix \(\boldsymbol{X}\).

    +

    The following Python code aids in setting up the data and writing out the design matrix. +Note that the function multivariate returns also the covariance discussed above and that it is defined by dividing by \(n-1\) instead of \(n\).

    +
    +
    +
    import numpy as np
    +import pandas as pd
    +import matplotlib.pyplot as plt
    +from IPython.display import display
    +n = 10000
    +mean = (-1, 2)
    +cov = [[4, 2], [2, 2]]
    +X = np.random.multivariate_normal(mean, cov, n)
    +
    +
    +
    +
    +

    Now we are going to implement the PCA algorithm. We will break it down into various substeps.

    +
    +

    20.18.1. Compute the sample mean and center the data

    +

    The first step of PCA is to compute the sample mean of the data and use it to center the data. Recall that the sample mean is

    +
    +\[ +\mu_n = \frac{1}{n} \sum_{i=1}^n x_i +\]
    +

    and the mean-centered data \(\bar{X} = \{ \bar{x}_1, \ldots, \bar{x}_n \}\) takes the form

    +
    +\[ +\bar{x}_i = x_i - \mu_n. +\]
    +

    When you are done with these steps, print out \(\mu_n\) to verify it is +close to \(\mu\) and plot your mean centered data to verify it is +centered at the origin! Compare your code with the functionality from Scikit-Learn discussed above. +The following code elements perform these operations using pandas or using our own functionality for doing so. The latter, using numpy is rather simple through the mean() function.

    +
    +
    +
    df = pd.DataFrame(X)
    +# Pandas does the centering for us
    +df = df -df.mean()
    +# we center it ourselves
    +X_centered = X - X.mean(axis=0)
    +
    +
    +
    +
    +

    Alternatively, we could use the functions we discussed +earlier for scaling the data set. That is, we could have used the +StandardScaler function in Scikit-Learn, a function which ensures +that for each feature/predictor we study the mean value is zero and +the variance is one (every column in the design/feature matrix). You +would then not get the same results, since we divide by the +variance. The diagonal covariance matrix elements will then be one, +while the non-diagonal ones need to be divided by \(2\sqrt{2}\) for our +specific case.

    +
    +
    +

    20.18.2. Compute the sample covariance

    +

    Now we are going to use the mean centered data to compute the sample covariance of the data by using the following equation

    +
    +\[ +\Sigma_n = \frac{1}{n-1} \sum_{i=1}^n \bar{x}_i^T \bar{x}_i = \frac{1}{n-1} \sum_{i=1}^n (x_i - \mu_n)^T (x_i - \mu_n) +\]
    +

    where the data points \(x_i \in \mathbb{R}^p\) (here in this example \(p = 2\)) are column vectors and \(x^T\) is the transpose of \(x\). +We can write our own code or simply use either the functionaly of numpy or that of pandas, as follows

    +
    +
    +
    print(df.cov())
    +print(np.cov(X_centered.T))
    +
    +
    +
    +
    +
              0         1
    +0  4.050693  2.010827
    +1  2.010827  1.974163
    +[[4.050693   2.01082738]
    + [2.01082738 1.97416255]]
    +
    +
    +
    +
    +

    Note that the way we define the covariance matrix here has a factor \(n-1\) instead of \(n\). This is included in the cov() function by numpy and pandas. +Our own code here is not very elegant and asks for obvious improvements. It is tailored to this specific \(2\times 2\) covariance matrix.

    +
    +
    +
    # extract the relevant columns from the centered design matrix of dim n x 2
    +x = X_centered[:,0]
    +y = X_centered[:,1]
    +Cov = np.zeros((2,2))
    +Cov[0,1] = np.sum(x.T@y)/(n-1.0)
    +Cov[0,0] = np.sum(x.T@x)/(n-1.0)
    +Cov[1,1] = np.sum(y.T@y)/(n-1.0)
    +Cov[1,0]= Cov[0,1]
    +print("Centered covariance using own code")
    +print(Cov)
    +plt.plot(x, y, 'x')
    +plt.axis('equal')
    +plt.show()
    +
    +
    +
    +
    +
    Centered covariance using own code
    +[[4.050693   2.01082738]
    + [2.01082738 1.97416255]]
    +
    +
    +_images/chapter8_77_1.png +
    +
    +

    Depending on the number of points \(n\), we will get results that are close to the covariance values defined above. +The plot shows how the data are clustered around a line with slope close to one. Is this expected?

    +
    +
    +

    20.18.3. Diagonalize the sample covariance matrix to obtain the principal components

    +

    Now we are ready to solve for the principal components! To do so we +diagonalize the sample covariance matrix \(\Sigma\). We can use the +function np.linalg.eig to do so. It will return the eigenvalues and +eigenvectors of \(\Sigma\). Once we have these we can perform the +following tasks:

    +
      +
    • We compute the percentage of the total variance captured by the first principal component

    • +
    • We plot the mean centered data and lines along the first and second principal components

    • +
    • Then we project the mean centered data onto the first and second principal components, and plot the projected data.

    • +
    • Finally, we approximate the data as

    • +
    +
    +\[ +x_i \approx \tilde{x}_i = \mu_n + \langle x_i, v_0 \rangle v_0 +\]
    +

    where \(v_0\) is the first principal component.

    +

    Collecting all these steps we can write our own PCA function and +compare this with the functionality included in Scikit-Learn.

    +

    The code here outlines some of the elements we could include in the +analysis. Feel free to extend upon this in order to address the above +questions.

    +
    +
    +
    # diagonalize and obtain eigenvalues, not necessarily sorted
    +EigValues, EigVectors = np.linalg.eig(Cov)
    +# sort eigenvectors and eigenvalues
    +#permute = EigValues.argsort()
    +#EigValues = EigValues[permute]
    +#EigVectors = EigVectors[:,permute]
    +print("Eigenvalues of Covariance matrix")
    +for i in range(2):
    +    print(EigValues[i])
    +FirstEigvector = EigVectors[:,0]
    +SecondEigvector = EigVectors[:,1]
    +print("First eigenvector")
    +print(FirstEigvector)
    +print("Second eigenvector")
    +print(SecondEigvector)
    +#thereafter we do a PCA with Scikit-learn
    +from sklearn.decomposition import PCA
    +pca = PCA(n_components = 2)
    +X2Dsl = pca.fit_transform(X)
    +print("Eigenvector of largest eigenvalue")
    +print(pca.components_.T[:, 0])
    +
    +
    +
    +
    +
    Eigenvalues of Covariance matrix
    +5.275483542917728
    +0.7493720026008108
    +First eigenvector
    +[0.85404598 0.52019753]
    +Second eigenvector
    +[-0.52019753  0.85404598]
    +Eigenvector of largest eigenvalue
    +[0.85404598 0.52019753]
    +
    +
    +
    +
    +

    This code does not contain all the above elements, but it shows how we can use Scikit-Learn to extract the eigenvector which corresponds to the largest eigenvalue. Try to address the questions we pose before the above code. Try also to change the values of the covariance matrix by making one of the diagonal elements much larger than the other. What do you observe then?

    +
    +
    +
    +

    20.19. Classical PCA Theorem

    +

    We assume now that we have a design matrix \(\boldsymbol{X}\) which has been +centered as discussed above. For the sake of simplicity we skip the +overline symbol. The matrix is defined in terms of the various column +vectors \([\boldsymbol{x}_0,\boldsymbol{x}_1,\dots, \boldsymbol{x}_{p-1}]\) each with dimension +\(\boldsymbol{x}\in {\mathbb{R}}^{n}\).

    +

    We assume also that we have an orthogonal transformation \(\boldsymbol{W}\in {\mathbb{R}}^{p\times p}\). We define the reconstruction error (which is similar to the mean squared error we have seen before) as

    +
    +\[ +J(\boldsymbol{W},\boldsymbol{Z}) = \frac{1}{n}\sum_i (\boldsymbol{x}_i - \overline{\boldsymbol{x}}_i)^2, +\]
    +

    with \(\overline{\boldsymbol{x}}_i = \boldsymbol{W}\boldsymbol{z}_i\), where \(\boldsymbol{z}_i\) is a row vector with dimension \({\mathbb{R}}^{n}\) of the matrix +\(\boldsymbol{Z}\in{\mathbb{R}}^{p\times n}\). When doing PCA we want to reduce this dimensionality.

    +

    The PCA theorem states that minimizing the above reconstruction error +corresponds to setting \(\boldsymbol{W}=\boldsymbol{S}\), the orthogonal matrix which +diagonalizes the empirical covariance(correlation) matrix. The optimal +low-dimensional encoding of the data is then given by a set of vectors +\(\boldsymbol{z}_i\) with at most \(l\) vectors, with \(l << p\), defined by the +orthogonal projection of the data onto the columns spanned by the +eigenvectors of the covariance(correlations matrix).

    +

    The proof which follows will be updated by mid January 2020.

    +
    +
    +

    20.20. Proof of the PCA Theorem

    +

    To show the PCA theorem let us start with the assumption that there is one vector \(\boldsymbol{w}_0\) which corresponds to a solution which minimized the reconstruction error \(J\). This is an orthogonal vector. It means that we now approximate the reconstruction error in terms of \(\boldsymbol{w}_0\) and \(\boldsymbol{z}_0\) as

    +
    +\[ +J(\boldsymbol{w}_0,\boldsymbol{z}_0)= \frac{1}{n}\sum_i (\boldsymbol{x}_i - z_{i0}\boldsymbol{w}_0)^2=\frac{1}{n}\sum_i (\boldsymbol{x}_i^T\boldsymbol{x}_i - 2z_{i0}\boldsymbol{w}_0^T\boldsymbol{x}_i+z_{i0}^2\boldsymbol{w}_0^T\boldsymbol{w}_0), +\]
    +

    which we can rewrite due to the orthogonality of \(\boldsymbol{w}_i\) as

    +
    +\[ +J(\boldsymbol{w}_0,\boldsymbol{z}_0)=\frac{1}{n}\sum_i (\boldsymbol{x}_i^T\boldsymbol{x}_i - 2z_{i0}\boldsymbol{w}_0^T\boldsymbol{x}_i+z_{i0}^2). +\]
    +

    Minimizing \(J\) with respect to the unknown parameters \(z_{0i}\) we obtain that

    +
    +\[ +z_{i0}=\boldsymbol{w}_0^T\boldsymbol{x}_i, +\]
    +

    where the vectors on the rhs are known.

    +
    +
    +

    20.21. PCA Proof continued

    +

    We have now found the unknown parameters \(z_{i0}\). These correspond to the projected coordinates and we can write

    +
    +\[ +J(\boldsymbol{w}_0)= \frac{1}{p}\sum_i (\boldsymbol{x}_i^T\boldsymbol{x}_i - z_{i0}^2)=\mathrm{const}-\frac{1}{n}\sum_i z_{i0}^2. +\]
    +

    We can show that the variance of the projected coordinates defined by \(\boldsymbol{w}_0^T\boldsymbol{x}_i\) are given by

    +
    +\[ +\mathrm{var}[\boldsymbol{w}_0^T\boldsymbol{x}_i] = \frac{1}{n}\sum_i z_{i0}^2, +\]
    +

    since the expectation value of

    +
    +\[ +\mathbb{E}[\boldsymbol{w}_0^T\boldsymbol{x}_i] = \mathbb{E}[z_{i0}]= \boldsymbol{w}_0^T\mathbb{E}[\boldsymbol{x}_i]=0, +\]
    +

    where we have used the fact that our data are centered.

    +

    Recalling our definition of the covariance as

    +
    +\[ +\boldsymbol{C}[\boldsymbol{x}] = \frac{1}{n}\boldsymbol{X}\boldsymbol{X}^T=\mathbb{E}[\boldsymbol{X}\boldsymbol{X}^T], +\]
    +

    we have thus that

    +
    +\[ +\mathrm{var}[\boldsymbol{w}_0^T\boldsymbol{x}_i] = \frac{1}{n}\sum_i z_{i0}^2=\boldsymbol{w}_0^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0. +\]
    +

    We are almost there, we have obtained a relation between minimizing +the reconstruction error and the variance and the covariance +matrix. Minimizing the error is equivalent to maximizing the variance +of the projected data.

    +
    +
    +

    20.22. The final step

    +

    We could trivially maximize the variance of the projection (and +thereby minimize the error in the reconstruction function) by letting +the norm-2 of \(\boldsymbol{w}_0\) go to infinity. However, this norm since we +want the matrix \(\boldsymbol{W}\) to be an orthogonal matrix, is constrained by +\(\vert\vert \boldsymbol{w}_0 \vert\vert_2^2=1\). Imposing this condition via a +Lagrange multiplier we can then in turn maximize

    +
    +\[ +J(\boldsymbol{w}_0)= \boldsymbol{w}_0^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0+\lambda_0(1-\boldsymbol{w}_0^T\boldsymbol{w}_0). +\]
    +

    Taking the derivative with respect to \(\boldsymbol{w}_0\) we obtain

    +
    +\[ +\frac{\partial J(\boldsymbol{w}_0)}{\partial \boldsymbol{w}_0}= 2\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0-2\lambda_0\boldsymbol{w}_0=0, +\]
    +

    meaning that

    +
    +\[ +\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0=\lambda_0\boldsymbol{w}_0. +\]
    +

    The direction that maximizes the variance (or minimizes the construction error) is an eigenvector of the covariance matrix! If we left multiply with \(\boldsymbol{w}_0^T\) we have the variance of the projected data is

    +
    +\[ +\boldsymbol{w}_0^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0=\lambda_0. +\]
    +

    If we want to maximize the variance (minimize the construction error) +we simply pick the eigenvector of the covariance matrix with the +largest eigenvalue. This establishes the link between the minimization +of the reconstruction function \(J\) in terms of an orthogonal matrix +and the maximization of the variance and thereby the covariance of our +observations encoded in the design/feature matrix \(\boldsymbol{X}\).

    +

    The proof +for the other eigenvectors \(\boldsymbol{w}_1,\boldsymbol{w}_2,\dots\) can be +established by applying the above arguments and using the fact that +our basis of eigenvectors is orthogonal, see Murphy chapter +12.2. The +discussion in chapter 12.2 of Murphy’s text has also a nice link with +the Singular Value Decomposition theorem. For categorical data, see +chapter 12.4 and discussion therein.

    +

    Additional part of the proof for the other eigenvectors will be added by mid January 2020.

    +
    + +
    +

    20.24. Principal Component Analysis

    +

    Principal Component Analysis (PCA) is by far the most popular dimensionality reduction algorithm. +First it identifies the hyperplane that lies closest to the data, and then it projects the data onto it.

    +

    The following Python code uses NumPy’s svd() function to obtain all the principal components of the +training set, then extracts the first two principal components. First we center the data using either pandas or our own code

    +
    +
    +
    import numpy as np
    +import pandas as pd
    +from IPython.display import display
    +np.random.seed(100)
    +# setting up a 10 x 5 vanilla matrix 
    +rows = 10
    +cols = 5
    +X = np.random.randn(rows,cols)
    +df = pd.DataFrame(X)
    +# Pandas does the centering for us
    +df = df -df.mean()
    +display(df)
    +
    +# we center it ourselves
    +X_centered = X - X.mean(axis=0)
    +# Then check the difference between pandas and our own set up
    +print(X_centered-df)
    +#Now we do an SVD
    +U, s, V = np.linalg.svd(X_centered)
    +c1 = V.T[:, 0]
    +c2 = V.T[:, 1]
    +W2 = V.T[:, :2]
    +X2D = X_centered.dot(W2)
    +print(X2D)
    +
    +
    +
    +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    01234
    0-1.5744650.2591531.1973700.1474000.649382
    10.6895190.137652-1.0257090.210340-0.076938
    2-0.2827270.351636-0.5392611.2166830.340782
    30.070889-0.6148081.074067-0.038300-1.450257
    41.7942821.458078-0.207545-0.442600-0.147420
    51.1123830.6474731.4058900.073598-0.276263
    60.397700-1.526744-0.7120181.2162900.418506
    7-0.2806471.106095-1.646283-0.956563-1.564374
    8-0.369139-0.7516990.051649-0.2131030.967809
    9-1.557795-1.0668370.401842-1.2137431.138775
    +
         0    1    2    3    4
    +0  0.0  0.0  0.0  0.0  0.0
    +1  0.0  0.0  0.0  0.0  0.0
    +2  0.0  0.0  0.0  0.0  0.0
    +3  0.0  0.0  0.0  0.0  0.0
    +4  0.0  0.0  0.0  0.0  0.0
    +5  0.0  0.0  0.0  0.0  0.0
    +6  0.0  0.0  0.0  0.0  0.0
    +7  0.0  0.0  0.0  0.0  0.0
    +8  0.0  0.0  0.0  0.0  0.0
    +9  0.0  0.0  0.0  0.0  0.0
    +[[-1.5378811  -0.94639099]
    + [ 0.86145244  0.89288636]
    + [-0.00445655  0.81633628]
    + [ 0.07145103 -1.00433417]
    + [ 2.03707133 -0.48476997]
    + [ 0.72174172 -1.4557763 ]
    + [-0.55854694  1.60673226]
    + [ 1.6999536   0.43766686]
    + [-1.10405456  0.31718909]
    + [-2.18673098 -0.17953942]]
    +
    +
    +
    +
    +

    PCA assumes that the dataset is centered around the origin. Scikit-Learn’s PCA classes take care of centering +the data for you. However, if you implement PCA yourself (as in the preceding example), or if you use other libraries, don’t +forget to center the data first.

    +

    Once you have identified all the principal components, you can reduce the dimensionality of the dataset +down to \(d\) dimensions by projecting it onto the hyperplane defined by the first \(d\) principal components. +Selecting this hyperplane ensures that the projection will preserve as much variance as possible.

    +
    +
    +
    W2 = V.T[:, :2]
    +X2D = X_centered.dot(W2)
    +
    +
    +
    +
    +
    +
    +

    20.25. PCA and scikit-learn

    +

    Scikit-Learn’s PCA class implements PCA using SVD decomposition just like we did before. The +following code applies PCA to reduce the dimensionality of the dataset down to two dimensions (note +that it automatically takes care of centering the data):

    +
    +
    +
    #thereafter we do a PCA with Scikit-learn
    +from sklearn.decomposition import PCA
    +pca = PCA(n_components = 2)
    +X2D = pca.fit_transform(X)
    +print(X2D)
    +
    +
    +
    +
    +
    [[ 1.5378811  -0.94639099]
    + [-0.86145244  0.89288636]
    + [ 0.00445655  0.81633628]
    + [-0.07145103 -1.00433417]
    + [-2.03707133 -0.48476997]
    + [-0.72174172 -1.4557763 ]
    + [ 0.55854694  1.60673226]
    + [-1.6999536   0.43766686]
    + [ 1.10405456  0.31718909]
    + [ 2.18673098 -0.17953942]]
    +
    +
    +
    +
    +

    After fitting the PCA transformer to the dataset, you can access the principal components using the +components variable (note that it contains the PCs as horizontal vectors, so, for example, the first +principal component is equal to

    +
    +
    +
    pca.components_.T[:, 0].
    +
    +
    +
    +
    +
      File "<ipython-input-19-17314f270d45>", line 1
    +    pca.components_.T[:, 0].
    +                            ^
    +SyntaxError: invalid syntax
    +
    +
    +
    +
    +

    Another very useful piece of information is the explained variance ratio of each principal component, +available via the \(explained\_variance\_ratio\) variable. It indicates the proportion of the dataset’s +variance that lies along the axis of each principal component.

    +
    +
    +

    20.26. Back to the Cancer Data

    +

    We can now repeat the above but applied to real data, in this case our breast cancer data. +Here we compute performance scores on the training data using logistic regression.

    +
    +
    +
    import matplotlib.pyplot as plt
    +import numpy as np
    +from sklearn.model_selection import  train_test_split 
    +from sklearn.datasets import load_breast_cancer
    +from sklearn.linear_model import LogisticRegression
    +cancer = load_breast_cancer()
    +
    +X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)
    +
    +logreg = LogisticRegression()
    +logreg.fit(X_train, y_train)
    +print("Train set accuracy from Logistic Regression: {:.2f}".format(logreg.score(X_train,y_train)))
    +# We scale the data
    +from sklearn.preprocessing import StandardScaler
    +scaler = StandardScaler()
    +scaler.fit(X_train)
    +X_train_scaled = scaler.transform(X_train)
    +X_test_scaled = scaler.transform(X_test)
    +# Then perform again a log reg fit
    +logreg.fit(X_train_scaled, y_train)
    +print("Train set accuracy scaled data: {:.2f}".format(logreg.score(X_train_scaled,y_train)))
    +#thereafter we do a PCA with Scikit-learn
    +from sklearn.decomposition import PCA
    +pca = PCA(n_components = 2)
    +X2D_train = pca.fit_transform(X_train_scaled)
    +# and finally compute the log reg fit and the score on the training data	
    +logreg.fit(X2D_train,y_train)
    +print("Train set accuracy scaled and PCA data: {:.2f}".format(logreg.score(X2D_train,y_train)))
    +
    +
    +
    +
    +

    We see that our training data after the PCA decomposition has a performance similar to the non-scaled data.

    +
    +
    +

    20.27. More on the PCA

    +

    Instead of arbitrarily choosing the number of dimensions to reduce down to, it is generally preferable to +choose the number of dimensions that add up to a sufficiently large portion of the variance (e.g., 95%). +Unless, of course, you are reducing dimensionality for data visualization — in that case you will +generally want to reduce the dimensionality down to 2 or 3. +The following code computes PCA without reducing dimensionality, then computes the minimum number +of dimensions required to preserve 95% of the training set’s variance:

    +
    +
    +
    pca = PCA()
    +pca.fit(X)
    +cumsum = np.cumsum(pca.explained_variance_ratio_)
    +d = np.argmax(cumsum >= 0.95) + 1
    +
    +
    +
    +
    +

    You could then set \(n\_components=d\) and run PCA again. However, there is a much better option: instead +of specifying the number of principal components you want to preserve, you can set \(n\_components\) to be +a float between 0.0 and 1.0, indicating the ratio of variance you wish to preserve:

    +
    +
    +
    pca = PCA(n_components=0.95)
    +X_reduced = pca.fit_transform(X)
    +
    +
    +
    +
    +
    +
    +

    20.28. Incremental PCA

    +

    One problem with the preceding implementation of PCA is that it requires the whole training set to fit in +memory in order for the SVD algorithm to run. Fortunately, Incremental PCA (IPCA) algorithms have +been developed: you can split the training set into mini-batches and feed an IPCA algorithm one minibatch +at a time. This is useful for large training sets, and also to apply PCA online (i.e., on the fly, as new +instances arrive).

    +
    +
    +

    20.29. Randomized PCA

    +

    Scikit-Learn offers yet another option to perform PCA, called Randomized PCA. This is a stochastic +algorithm that quickly finds an approximation of the first d principal components. Its computational +complexity is \(O(m \times d^2)+O(d^3)\), instead of \(O(m \times n^2) + O(n^3)\), so it is dramatically faster than the +previous algorithms when \(d\) is much smaller than \(n\).

    +
    +
    +

    20.30. Kernel PCA

    +

    The kernel trick is a mathematical technique that implicitly maps instances into a +very high-dimensional space (called the feature space), enabling nonlinear classification and regression +with Support Vector Machines. Recall that a linear decision boundary in the high-dimensional feature +space corresponds to a complex nonlinear decision boundary in the original space. +It turns out that the same trick can be applied to PCA, making it possible to perform complex nonlinear +projections for dimensionality reduction. This is called Kernel PCA (kPCA). It is often good at +preserving clusters of instances after projection, or sometimes even unrolling datasets that lie close to a +twisted manifold. +For example, the following code uses Scikit-Learn’s KernelPCA class to perform kPCA with an

    +
    +
    +
    from sklearn.decomposition import KernelPCA
    +rbf_pca = KernelPCA(n_components = 2, kernel="rbf", gamma=0.04)
    +X_reduced = rbf_pca.fit_transform(X)
    +
    +
    +
    +
    +
    +
    +

    20.31. LLE

    +

    Locally Linear Embedding (LLE) is another very powerful nonlinear dimensionality reduction +(NLDR) technique. It is a Manifold Learning technique that does not rely on projections like the previous +algorithms. In a nutshell, LLE works by first measuring how each training instance linearly relates to its +closest neighbors (c.n.), and then looking for a low-dimensional representation of the training set where +these local relationships are best preserved (more details shortly).

    +
    +
    +

    20.32. Other techniques

    +

    There are many other dimensionality reduction techniques, several of which are available in Scikit-Learn.

    +

    Here are some of the most popular:

    +
      +
    • Multidimensional Scaling (MDS) reduces dimensionality while trying to preserve the distances between the instances.

    • +
    • Isomap creates a graph by connecting each instance to its nearest neighbors, then reduces dimensionality while trying to preserve the geodesic distances between the instances.

    • +
    • t-Distributed Stochastic Neighbor Embedding (t-SNE) reduces dimensionality while trying to keep similar instances close and dissimilar instances apart. It is mostly used for visualization, in particular to visualize clusters of instances in high-dimensional space (e.g., to visualize the MNIST images in 2D).

    • +
    • Linear Discriminant Analysis (LDA) is actually a classification algorithm, but during training it learns the most discriminative axes between the classes, and these axes can then be used to define a hyperplane onto which to project the data. The benefit is that the projection will keep classes as far apart as possible, so LDA is a good technique to reduce dimensionality before running another classification algorithm such as a Support Vector Machine (SVM) classifier discussed in the SVM lectures.

    • +
    +
    +
    + + + + +
    + +
    +
    + + + +
    +
    +

    + + By Morten Hjorth-Jensen
    + + © Copyright 2020.
    +

    +
    +
    +
    + + +
    +
    + + + + + \ No newline at end of file diff --git a/doc/src/LectureNotes/_build/html/genindex.html b/doc/src/LectureNotes/_build/html/genindex.html index 77b8a713d..88edf20ac 100644 --- a/doc/src/LectureNotes/_build/html/genindex.html +++ b/doc/src/LectureNotes/_build/html/genindex.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/objects.inv b/doc/src/LectureNotes/_build/html/objects.inv index a1178aa97f0fecb987c3d19705fca62a6bffa9a0..d70ab953e518b24576bb675e07e656887b66a353 100644 GIT binary patch delta 970 zcmV;*12z1E2(t)~cYkx+HW0n*SL{r$QXR=(nci&KNz{oIk0iH~lLrD<6lxG)0Zh42}fQ9{MN5@^%_J__LX5`Pm^&VpXSqtQ#Y6jHbx z7HiZdFHq->IbogPOxAr?@aGNi=K=mBI!A%f24);aebAYKl`z&pTA zE*d;s1P`Cdlo^;|Y|vU?B9ED9gK!gVnBr8aH;doLe%XM0St9GWNc)X>Wp&kHbrr0p zm>DXRLbuiC#eeo;Wpn~=jbKHRN`w>*$CO%HG&4d>L4Mb->jwDi06)*tR2v6>Aa~kS zwIerrgN7OZ6ay2CnvS8pp;(!ag6 zmQifj>KQj8qQ2qt=-u$5Zs*XtrPeQJ2{SK|-l_uNmw(E1P?-)2(?KuMQG@q1A5;q= zfCrihDrbn}&FTTO$K0){^fhaXzH)WL@UAR+SbtOC9CKi9!cV=S;6p@PAnf<5a5wDWP$K*cV7kq&7@h87f{7 zSo^b#6mqP!Ayr@wVV+ypB}7St&uAtzZLB}|UvFuTiM|6|NQ`LXh(xdzZVkJ&gW;YO z)RC@RwXTb(wW`^lycyRbhUHl(cHb5#rFQ0-eXbb*}%b0p=xb8-0egI=_X2 z-+#j-z%6ZhMG~I1jX1?hd87FB^?Wq!!&ox9BzjgoAf-lywJ@Q^3A&WUOcnQNgeN8F zre^8F)hA9HpUddoX!z>0rUm0K)4QkfqA`S~ja6O|dOlKqe&qIJFJ_b5r^RIYv6F+{ z?$_!WvCMow_PChc-`qXi9|jNm%4>I6m_z!7J+QThwr(G^>d1rrIQtoLz^0sWl$-|J se+lIN)96_D)s_0l2x>QR`iLk&J_y;Z=Iw{ePdnOLvun-a9}}CaBq;gbn*aa+ delta 922 zcmV;L17-ZP2!jZacYkl&I1s((R}9dr-PF!UfxRV8(z>YAAa+pn6wuUI;)WtslCrCR zze7<70|c^d>p{9C4Z)C}`&kR}S%s|QGVNF9wbglx)p@YG z#oSP#6uONzPk(j*E2C3z34#@ACJ{0;95Xu7@-QRB3}k&?G15JajVb}&)uzMRbXb}Wk5V1Ac+ZMq zy$}MJ5g93u5XY<49cFihODN}twWY*)(liXug3Uav-+!?fkDjx6T;@VX$A9NpL1ll$ zU&wQZ$GoMH`r7>2Xnoy{4{%qt-aKO*2e1$+U1!>R9T3-6X#AnTjbSNTDCvBUsjs8~ zD&QKq(h22c%H7_a(E`A9IIUDIjw$NK3?uo=w%7 zkVMRUT7SJmIXxhhN(a7Ew+-N0p@|D$POoZtT2^U75ujO@p@3wY-r<}b5Kbi?pP5Ou zqC$MLTu902$ohIcKfr4xK8uYWE_GCtQclX=JJXK``21K2o>oKBVB-X_FOZfr}7*OQt&Y=-&!Yr^392lyqvw9^%lc0=?V4v#9qZgkIEtq_}y?U4|T0>~tSmza?=Og9kTW&k{;(mJhu$bO{ z>gC{h_e=GRSmypbwz#;zzPOrQ?*zru#KCp)81*-lLy;zwlidhP1WNl wIW@K)!3+OQvakDkq~0@v#w1Q(J{8D~kQ4oC-u-fUvsYVZcAYu=16DhFf`EUz9RL6T diff --git a/doc/src/LectureNotes/_build/html/reports/chapter7.log b/doc/src/LectureNotes/_build/html/reports/chapter7.log new file mode 100644 index 000000000..8fdae3155 --- /dev/null +++ b/doc/src/LectureNotes/_build/html/reports/chapter7.log @@ -0,0 +1,41 @@ +Traceback (most recent call last): + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/jupyter_cache/executors/utils.py", line 51, in single_nb_execution + executenb( + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 1082, in execute + return NotebookClient(nb=nb, resources=resources, km=km, **kwargs).execute() + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 74, in wrapped + return just_run(coro(*args, **kwargs)) + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 53, in just_run + return loop.run_until_complete(coro) + File "/Users/hjensen/opt/anaconda3/lib/python3.8/asyncio/base_events.py", line 616, in run_until_complete + return future.result() + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 535, in async_execute + await self.async_execute_cell( + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 827, in async_execute_cell + self._check_raise_for_error(cell, exec_reply) + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 735, in _check_raise_for_error + raise CellExecutionError.from_cell_and_msg(cell, exec_reply['content']) +nbclient.exceptions.CellExecutionError: An error occurred while executing the following cell: +------------------ +# Import the necessary packages +import numpy +from cvxopt import matrix +from cvxopt import solvers +P = matrix(numpy.diag([1,0]), tc=’d’) +q = matrix(numpy.array([3,4]), tc=’d’) +G = matrix(numpy.array([[-1,0],[0,-1],[-1,-3],[2,5],[3,4]]), tc=’d’) +h = matrix(numpy.array([0,0,-15,100,80]), tc=’d’) +# Construct the QP, invoke solver +sol = solvers.qp(P,q,G,h) +# Extract optimal value and solution +sol[’x’] +sol[’primal objective’] +------------------ + + File "", line 5 + P = matrix(numpy.diag([1,0]), tc=’d’) + ^ +SyntaxError: invalid character in identifier + +SyntaxError: invalid character in identifier (, line 5) + diff --git a/doc/src/LectureNotes/_build/html/reports/chapter8.log b/doc/src/LectureNotes/_build/html/reports/chapter8.log new file mode 100644 index 000000000..21e824860 --- /dev/null +++ b/doc/src/LectureNotes/_build/html/reports/chapter8.log @@ -0,0 +1,29 @@ +Traceback (most recent call last): + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/jupyter_cache/executors/utils.py", line 51, in single_nb_execution + executenb( + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 1082, in execute + return NotebookClient(nb=nb, resources=resources, km=km, **kwargs).execute() + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 74, in wrapped + return just_run(coro(*args, **kwargs)) + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 53, in just_run + return loop.run_until_complete(coro) + File "/Users/hjensen/opt/anaconda3/lib/python3.8/asyncio/base_events.py", line 616, in run_until_complete + return future.result() + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 535, in async_execute + await self.async_execute_cell( + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 827, in async_execute_cell + self._check_raise_for_error(cell, exec_reply) + File "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 735, in _check_raise_for_error + raise CellExecutionError.from_cell_and_msg(cell, exec_reply['content']) +nbclient.exceptions.CellExecutionError: An error occurred while executing the following cell: +------------------ +pca.components_.T[:, 0]. +------------------ + + File "", line 1 + pca.components_.T[:, 0]. + ^ +SyntaxError: invalid syntax + +SyntaxError: invalid syntax (, line 1) + diff --git a/doc/src/LectureNotes/_build/html/search.html b/doc/src/LectureNotes/_build/html/search.html index 066128e44..b520a5e83 100644 --- a/doc/src/LectureNotes/_build/html/search.html +++ b/doc/src/LectureNotes/_build/html/search.html @@ -178,6 +178,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/searchindex.js b/doc/src/LectureNotes/_build/html/searchindex.js index c0bcab061..f34bff254 100644 --- a/doc/src/LectureNotes/_build/html/searchindex.js +++ b/doc/src/LectureNotes/_build/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["chapter1","chapter2","chapter3","chapter4","chapter5","chapter6","testbook/_build/jupyter_execute/chapter1","testbook/_build/jupyter_execute/chapter2","testbook/_build/jupyter_execute/chapter3","testbook/_build/jupyter_execute/chapter4","testbook/_build/jupyter_execute/chapter5","testbook/_build/jupyter_execute/chapter6","testbook/_build/jupyter_execute/chapter7","testbook/_build/jupyter_execute/lecturenotes/lecturenotes/notebooks","testbook/_build/jupyter_execute/notebooks","testbook/chapter1","testbook/chapter2","testbook/chapter3","testbook/chapter4","testbook/chapter5","testbook/chapter6","testbook/chapter7","testbook/content","testbook/intro","testbook/lecturenotes/CONDUCT","testbook/lecturenotes/CONTRIBUTING","testbook/lecturenotes/README","testbook/lecturenotes/lecturenotes/content","testbook/lecturenotes/lecturenotes/intro","testbook/lecturenotes/lecturenotes/markdown","testbook/lecturenotes/lecturenotes/notebooks","testbook/markdown"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,"sphinx.ext.intersphinx":1,sphinx:56},filenames:["chapter1.ipynb","chapter2.ipynb","chapter3.ipynb","chapter4.ipynb","chapter5.ipynb","chapter6.ipynb","testbook/_build/jupyter_execute/chapter1.ipynb","testbook/_build/jupyter_execute/chapter2.ipynb","testbook/_build/jupyter_execute/chapter3.ipynb","testbook/_build/jupyter_execute/chapter4.ipynb","testbook/_build/jupyter_execute/chapter5.ipynb","testbook/_build/jupyter_execute/chapter6.ipynb","testbook/_build/jupyter_execute/chapter7.ipynb","testbook/_build/jupyter_execute/lecturenotes/lecturenotes/notebooks.ipynb","testbook/_build/jupyter_execute/notebooks.ipynb","testbook/chapter1.ipynb","testbook/chapter2.ipynb","testbook/chapter3.ipynb","testbook/chapter4.ipynb","testbook/chapter5.ipynb","testbook/chapter6.ipynb","testbook/chapter7.ipynb","testbook/content.md","testbook/intro.md","testbook/lecturenotes/CONDUCT.md","testbook/lecturenotes/CONTRIBUTING.md","testbook/lecturenotes/README.md","testbook/lecturenotes/lecturenotes/content.md","testbook/lecturenotes/lecturenotes/intro.md","testbook/lecturenotes/lecturenotes/markdown.md","testbook/lecturenotes/lecturenotes/notebooks.ipynb","testbook/markdown.md"],objects:{},objnames:{},objtypes:{},terms:{"00000000e":3,"00694659e":[],"00pm":23,"01347297e":[],"02004166e":[],"02176297e":[],"02599545e":[],"03256632e":5,"03446279e":3,"04029857e":[],"04722875e":[],"04904333e":3,"06648521e":[],"07106781e":3,"07557895e":[],"08248290e":3,"08318298e":5,"09284157e":[],"0_tlsccwai":23,"0_utc9il9i":23,"0x7fad47b08730":[],"0x7fddb4c436d0":3,"0x7ff4f8410b20":[],"0x7ff6a7303b50":[],"1000s":3,"100m":[8,17],"10368860e":[],"10378326e":5,"10898112e":3,"10th":23,"10x":2,"112453549290521e":[9,18],"11487443e":[],"11507992e":5,"12cm":[7,16],"14g":3,"15657183e":[],"15g":3,"16496581e":3,"16b8e3cda33a":5,"17174962e":5,"18442813e":[],"19218307e":[],"1970s":[2,7,16],"1_1":5,"1_2":5,"1_2v2se359":23,"1_2v439nza":23,"1_3":5,"1_azwo1s2r":23,"1_b81t0tta":23,"1_d70czgce":23,"1_e1cs5784":23,"1_ftgzt035":23,"1_hxxec3uc":23,"1_i9hczn21":23,"1_j5ugthfg":23,"1_rz8vr2ht":23,"1_sp7p28vk":23,"1_t1pocrww":23,"1_t2l86862":23,"1_utivxb87":23,"1_w9xc8az7":23,"1_wk9trq9k":23,"1cm":[1,2,8,17],"1e4":3,"1kg":[7,16],"1kgm":[7,16],"20745612e":[],"21351358e":[],"21635571e":[],"21869563e":[],"21st":23,"22164060e":[],"22421033e":[],"224805627923717e":[9,18],"23h":[12,21],"24629399e":[],"24h":[12,21],"2572e3a4b38d":5,"26349118e":3,"27n_":1,"28119384e":3,"28444646e":[],"28590170e":[],"28kg":[12,21],"2_1":5,"2_2":5,"2_3":5,"2_i":5,"2_m":1,"2_x":1,"2cm":[7,16],"2dimgrav":[11,20],"2dimhovv":[11,20],"2ff97f4bf03b":1,"2k_2":[10,19],"2k_3":[10,19],"2me":[11,20],"2meb":[11,20],"2mr":[11,20],"2mr_":[11,20],"2nd":[10,19,23],"2v_":[8,17],"2v_x":[8,17],"2v_y":[8,17],"2y_0":[7,16],"30273573e":3,"30pm":23,"32218090e":[],"32849325e":[],"33066907e":3,"33291949e":[],"33583503e":[],"35938336e":3,"36816390e":[],"37689988e":[],"3rd":23,"40925064e":3,"41088348e":[],"412252157986472e":[9,18],"41511965e":5,"43821714e":3,"44970586e":5,"45035234e":3,"45426079e":[],"47269386e":[],"49887171e":[],"4ar":[11,20],"4dr":[11,20],"4f_0":[9,18],"4pm":23,"4th":23,"50446329e":[],"50470354e":[],"50pm":23,"50x10":5,"51502206e":3,"52131750e":[],"52177694e":3,"52583599e":[],"53990135e988":3,"54220685e":[],"54686289e":[],"55456211e":3,"55868382e":[],"56min":[12,21],"57425734e":3,"58928789e":[],"58934440e":[],"59958864e":[],"5cm":[1,10,19],"5th":23,"60505104e":[],"60996409e":[],"62113986e":[],"62496853e":[],"63164705e":[],"63177381e":[],"64x50":5,"65939208e":3,"66371431e":[],"67m":[12,21],"69069n_":1,"6n_":1,"6pm":23,"6th":23,"72347840e":[],"72352580e":3,"73374509e":[],"74784357e":[],"75209222e":3,"77350269e":3,"77667437e":[],"78920723e":3,"7th":23,"80872400e":[],"83131741e":[],"83286207e":3,"84355903e":5,"84443254e":5,"84683780e":3,"89045976e":[],"89354206e":3,"8th":23,"8x8":5,"92507116e":5,"94553659e":3,"95125898e":3,"96064784e":[],"98658737e":[],"9th":23,"abstract":[5,6,15],"break":[2,3,7,8,11,16,17,20],"byte":[2,7,16],"case":[0,2,3,4,5,6,8,9,10,11,12,15,17,18,19,20,21],"catch":2,"char":1,"class":[0,1,2,3,5,6,7,10,15,16,19,23],"const":1,"default":[2,3,4,5,7,16,29,31],"final":[1,2,3,4,6,10,11,12,15,19,20,21],"float":[1,2,3,6,7,9,15,16,18],"function":[0,2,6,7,8,9,10,11,12,15,16,17,18,19,20,21,29,31],"import":[0,3,4,5,6,8,9,10,11,13,14,15,17,18,19,20,23,26,30],"int":[1,3,5,8,10,11,17,19,20],"long":[1,2,5,8,10,11,12,17,19,20,21],"new":[0,1,2,3,4,5,6,7,8,9,10,15,16,17,18,19],"null":1,"public":[0,2,7,16,24],"return":[1,2,3,5,6,7,8,9,10,11,15,16,17,18,19,20],"s\u00f8renssen":23,"short":[22,27],"super":3,"switch":[2,11,12,20,21],"throw":[1,8,10,12,17,19,21],"true":[1,2,3,4,5,9,10,11,12,18,19,20,21],"try":[0,1,2,4,5,6,7,8,10,11,15,16,17,19,20],"var":[1,3],"while":[0,1,2,3,5,8,9,10,12,17,18,19,21,23],AGE:3,AMS:23,Added:[8,17],Adding:[0,5],And:[0,1,3,6,7,15,16],Are:[8,17],BPS:23,Being:24,But:[1,2,3,5,8,9,12,13,14,17,18,21,30],CAS:[2,7,16],DIS:3,Doing:3,EoS:3,For:[0,1,2,3,4,5,7,8,9,10,11,12,13,14,16,17,18,19,20,21,23,29,30,31],GPS:0,Going:[3,5],I_s:[10,19],Ising:5,Its:5,NNs:5,Not:[0,2,3],ODE:[8,17],One:[0,1,3,4,5,9,10,11,12,18,19,20,21],RMS:1,Such:[1,3,5,6,8,15,17],That:[1,2,4,5,8,12,17,21],The:[0,2,6,7,11,15,16,20,23,24,25,26,29,31],Then:[1,2,3,5,7,11,12,16,20,21],There:[0,1,2,3,5,6,7,9,10,12,13,14,15,16,18,19,21,22,27,29,30,31],These:[0,1,2,3,5,6,7,8,10,11,12,15,16,17,19,20,21,23],Use:[0,11,20],Useful:3,Using:[2,3,7,8,9,10,11,12,16,17,18,19,20,21,24],With:[1,2,3,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21],Yes:[0,8,17],__doc__:3,__init__:[3,5],__name__:3,_auto10:[3,5,8,9,10,11,17,18,19,20],_auto11:[3,8,9,10,11,17,18,19,20],_auto12:[8,9,10,11,17,18,19,20],_auto13:[3,8,9,10,11,17,18,19,20],_auto14:[8,9,10,11,17,18,19,20],_auto15:[8,9,10,11,17,18,19,20],_auto16:[8,10,11,17,19,20],_auto17:[8,10,11,17,19,20],_auto18:[8,10,11,17,19,20],_auto19:[8,10,17,19],_auto1:[1,3,4,5,8,9,10,11,12,17,18,19,20,21],_auto20:[8,10,17,19],_auto21:[8,10,17,19],_auto23:[10,19],_auto24:[10,19],_auto25:[10,19],_auto26:[10,19],_auto27:[10,19],_auto28:[10,19],_auto29:[10,19],_auto2:[1,3,5,8,9,10,11,12,17,18,19,20,21],_auto30:[10,19],_auto31:[10,19],_auto32:[10,19],_auto33:[10,19],_auto34:[10,19],_auto3:[3,5,8,9,10,11,12,17,18,19,20,21],_auto4:[3,5,8,9,10,11,12,17,18,19,20,21],_auto5:[3,5,8,9,10,11,17,18,19,20],_auto6:[3,5,8,9,10,11,17,18,19,20],_auto7:[3,5,8,9,10,11,17,18,19,20],_auto8:[3,5,8,9,10,11,17,18,19,20],_auto9:[3,5,8,9,10,11,17,18,19,20],_ax:3,_build:26,_datafram:[2,7,16],_lambda:3,_setattr_cm:3,_subplot:3,_update_properti:3,a_0:[3,9,18],a_1:[10,12,19,21],a_1a:[2,3],a_1x:[9,18],a_2:[10,12,19,21],a_2a:[2,3],a_2a_3:[9,18],a_2x:[9,18],a_3:[2,12,21],a_3a:3,a_3a_2:[9,18],a_4:2,a_4a:3,a_fc1:5,a_fc2:5,a_h:5,a_i:[2,5,7,9,12,16,18,21],a_j:5,a_ja_k:[9,18],a_k:5,a_n:[9,18],a_p:[10,19],a_x:[7,16],a_z:[7,16],aaverag:[7,16],abandon:5,abid:[1,25],abil:[0,2],abl:[1,2,3,4,5,8,10,11,17,19,20,23],abort:1,abotu:[12,21],about:[0,1,3,5,6,8,9,10,11,12,13,14,15,17,18,19,20,21,23,25,29,30,31],abov:[1,2,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21],abovement:[3,6,12,15,21],abs:[2,3,6,9,15,18],absolut:[2,3,6,7,15,16],absorb:[10,11,12,19,20,21],abus:24,acccess:2,accelearatio:[7,16],acceler:[9,10,11,18,19,20,23],acceleromet:[12,21],accept:[0,3,8,17,24,29,31],access:[0,1,2,3],accid:3,accommod:[10,19],accompani:[0,3],accomplish:[11,20],accord:[1,2,3,5,7,10,11,12,16,19,20,21],account:[0,1,2,7,12,16,21,24],accumul:[1,5,6,15],accur:[1,3,9,18],accuraci:[0,2,3,5,9,18],accuracy_scor:[2,5],accuracy_score_numpi:5,achiev:[0,2,3,5,7,16],aco:[1,8,17],acquaint:0,acquir:[0,5,23],acr:3,across:[2,3,5,7,16],act:[5,7,9,10,11,12,16,18,19,20,21,23,24],action:[1,8,9,17,18,24,26],activ:[2,23],actual:[2,3,5,7,8,11,12,16,17,20,21],adapt:[3,24],add:[0,1,2,3,5,7,8,9,10,12,16,17,18,19,21,29,31],add_:[13,14,30],add_graph:5,add_subplot:[4,5],added:[2,3,5,6,8,9,12,15,17,18,21],adding:[3,5,9,10,18,19],addit:[0,1,2,3,4,5,6,7,8,10,11,12,15,16,17,19,20,21,23],addition:5,address:[6,9,15,18,24],adjac:5,adjust:[8,10,11,17,19,20],admir:2,adopt:[7,16],advanc:[5,6,15,24],advantag:[3,5,8,17],afecionado:2,affect:[3,9,11,18,20],affin:3,aficionado:2,african:3,after:[0,1,2,3,5,7,9,10,11,16,18,19,20,23],afterward:[2,7,16],again:[0,1,2,3,4,5,9,10,12,18,19,21,29,31],against:[5,8,10,17,19],age:[0,2,3,24],agre:[1,10,19,25],aim:[0,2,4,6,7,8,9,11,15,16,17,18,20],air:[9,10,12,18,19,21,23],aircraft:[12,21],akin:[10,19],algebra:[0,2,11,20],algo:[0,1],algorithm:[0,1,2,4,6,7,8,10,15,16,17,19,23],align:[1,3,4,13,14,24,30],all:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,24,26,29,31],allevi:5,allow:[0,2,3,5,6,7,8,9,10,11,15,16,17,18,19,20,23,29,31],almost:[0,1,2,3,5],alon:[10,19],along:[2,3,7,9,11,12,16,18,20,21],alpha:[1,2,3,5,8,9,11,12,17,18,20,21],alpha_n:[10,19],alreadi:[1,2,5,7,8,10,16,17,19,29,31],also:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,23,29,30,31],alter:[1,5],altern:[2,3,5,7,8,9,16,17,18],although:[3,5,8,9,10,17,18,19],alwai:[0,1,2,3,5,7,8,9,11,16,17,18,20,23,25],amaz:0,ame2016:[2,3],american:3,among:[0,3,5],amongst:[11,20],amount:[3,9,10,12,18,19,21],amplitud:[8,10,12,17,19,21],an_:1,anaconda3:3,anaconda:[2,5,7,16,23],analog:[11,20],analogu:[11,20],analys:[1,3],analysi:[2,4,5,6,7,8,11,15,16,17,20],analyt:[2,3,4,5,6,8,9,10,12,15,17,18,19,21,23],analyz:[0,1,2,3,5,8,17,23],ander:23,andrew:5,anew:[9,10,11,18,19,20],angl:[1,3,7,9,10,11,12,16,18,19,20,21],angmom:[11,20],angular:[8,10,11,12,17,19,20,21,23],anharmon:[10,19],ani:[0,1,2,3,4,5,8,9,10,11,12,17,18,19,20,21,24,25,29,31],anim:5,ann:5,annot:[2,3,5],anoth:[0,1,2,5,7,8,10,11,12,16,17,19,20,21,29,31],ans:1,ansatz:2,answer:[0,2,3,5,7,8,10,16,17,19],anticip:[7,16],antiparallel:[11,20],antisymmetri:[9,18],anyth:[1,5,25],apach:5,api:[2,5,7,16],appar:[12,21],appear:[0,1,2,5,8,9,10,11,12,17,18,19,20,21,24],append:[1,2,7,16],appendix:[10,19],appl:0,appli:[1,2,3,4,5,6,7,8,9,10,11,15,16,17,18,19,20,23,24],applic:[0,1,2,3,5,6,8,12,15,17,21,23],appoint:24,appreci:25,approach:[1,2,5,6,7,9,10,11,15,16,18,19,20],appropri:[1,3,5,8,17,24],approx:[1,3,8,9,10,11,12,17,18,19,20,21],approxim:[1,3,4,6,8,9,10,12,15,17,18,19,21],apt:[2,7,16],aragorn:[2,7,16],arang:[2,3,4,5,7,16],arbitrari:[1,5,8,10,11,12,17,19,20,21],arbitrarili:[2,5,11,20],arctan:[11,20],arctanh:[7,16],area:[0,2,8,9,11,17,18,20],areal:[11,20],arg:3,argc:1,argmax:5,argu:5,argument:[1,3,5],argv:1,aris:[0,1,2,3,5,12,21],arithmet:2,arma:1,armadillo:1,around:[1,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21],arrai:[1,3,5,6,9,10,11,13,14,15,18,19,20,30],arrang:23,arriv:[1,2,6,15],arrow:[5,8,17],art:0,articl:[1,3,5,25],artifici:[0,2,4],artificialneuron:5,artist:3,asarrai:2,ascii:[1,2],asid:[9,10,18,19],asin:[8,10,17,19],ask:[3,5,8,12,17,21],aspect:[2,6,8,15,17],assembl:2,assess:[0,3],assign:[0,2,3,4,5,11,20,23],assist:23,associ:[1,2,3,5,12,21,29,31],assum:[1,2,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21],assumpt:[0,1,2,12,21],ast:3,asteroid:[11,20],astronom:[9,18],asymmetr:[9,18],asymmetri:2,asymptot:[3,11,20],atoi:1,atom:[2,8,9,10,11,17,18,19,20],attack:24,attempt:[2,9,18],attent:[2,7,12,16,21,24],attitud:[0,6,15],attract:[2,11,20],attribut:3,attributeerror:3,audi:2,auditori:[29,31],australia:[29,31],author:[0,1,2,5],authour:[0,2],auto:1,autocor:1,autocorrelation_tim:1,autocorrelform:1,autocovari:1,autograd:[2,7,16],autom:[0,6,15,26],automag:[0,2,7,16],automat:[2,7,16,26],automobil:[8,17],avail:[0,2,3,5,6,7,15,16,23],avdt:[8,17],avenu:0,averag:[1,2,3,5,9,11,18,20],avg:1,avoid:[0,2,3,7,9,16,18],awai:[1,3,10,11,12,19,20,21],aws:23,axel:[8,17],axes:[3,7,8,13,14,16,17,30],axes_grid1:3,axessubplot:3,axi:[1,2,3,4,5,8,9,11,12,17,18,20,21],axlabel:[2,7,16],axs:[7,16],azimuth:[9,11,18,20],b_1:5,b_1e:[10,19],b_2e:[10,19],b_fc1:5,b_fc2:5,b_i:[3,5],b_ia_:3,b_j:5,b_k:5,b_m:5,b_out:5,b_p:[10,19],b_x:[7,16],b_y:[7,16],b_z:[7,16],back:[0,1,3,7,8,9,11,12,16,17,18,20,21],background:[7,16],backpropag:5,backward:[5,11,20],bad:[1,3],badli:1,baggin:[2,7,16],bake:[6,15],balanc:3,ball:[7,8,12,16,17,21],ban:24,band:[2,7,16],bandwidth:[2,7,16],bar:[2,7,9,16,18],barrier:23,base:[0,1,2,3,4,5,6,7,10,15,16,19],basi:[2,3,4,5,7,11,16,20,23],basic:[0,1,5,6,10,12,15,19,21],batch:5,batch_i:5,batch_siz:5,batch_x:5,bay:4,bayesian:0,bdb:[11,20],becaus:[0,2,3,5,6,8,9,10,11,12,15,17,18,19,20,21],becom:[0,1,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21],been:[0,2,3,5,6,7,8,10,15,16,17,19,23,26],befor:[0,1,2,3,4,5,6,8,9,10,11,12,15,17,18,19,20,21],beforehand:[0,1,2],began:[11,20],begin:[1,2,3,4,5,7,8,9,10,11,12,13,14,16,17,18,19,20,21,23,30],behav:[3,5,11,20],behavior:[0,2,5,6,10,15,19,24],behaviour:5,behind:[0,2,3,5,10,19],being:[0,1,2,3,4,5,6,10,11,12,15,19,20,21,29,31],believ:[8,17],belong:[4,12,21],below:[1,2,3,4,5,6,7,8,9,10,12,15,16,17,18,19,21,25],benchmark:[6,15],benefici:5,benefit:[2,5,6,15],bengio:5,best:[0,1,2,3,5,8,10,11,17,19,20,24,25],beta:[2,4,5,11,20],beta_0:[3,4,5,10,19],beta_0x_:3,beta_1:[3,4,5],beta_1x_0:3,beta_1x_1:[3,4],beta_1x_2:3,beta_1x_:3,beta_1x_i:4,beta_2:3,beta_2x_0:3,beta_2x_1:3,beta_2x_2:[3,4],beta_2x_:3,beta_:[3,4],beta_i:3,beta_j:3,beta_n:[10,19],beta_p:4,beta_px_p:4,better:[0,2,5,6,8,9,10,15,17,18,19],between:[0,1,2,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21],beyond:[0,2,3,5,6,10,15,19],bia:[0,1,5],bias:3,bias_vari:5,bib:[29,31],bibliographi:[29,31],bibtex:[29,31],bicycl:[7,16],big:[0,2,3,5,8,17],bigger:5,bigr:5,bilbo:[2,7,16],billion:5,bin:[1,3],binari:[1,2,4],binomi:0,binsboot:3,bioinformat:[0,2],biolog:5,bird:2,birth:[2,7,16],bit:[1,2,5,7,8,10,12,16,17,19,21,25],bitwis:1,bla:[2,7,16],blob:23,block:[0,2,3,7,16,23,29,31],blockeulercrom:[10,19],blockingavg:1,blockingstd:1,blockingvar:1,blocksiz:1,blocksizemax:1,blocksizemin:1,blog:25,blue:2,blue_patch:[7,16],bmatrix:[2,3,4,5,7,16],bmi:5,bodi:[0,3,5,8,9,12,17,18,21,23,24],boldfac:[3,7,16],boldsymbol:[0,2,5,7,8,9,11,12,16,17,18,20,21],bolt:[8,17],boltzmann:[0,5],bonu:[6,15],book:[13,14,23,29,30,31],boost:5,bootavg:1,bootstd:1,bootstrap:[0,5],bootvar:1,bootvec:1,bore:0,borrow:[2,7,16],boston_dataset:3,both:[0,1,2,3,5,6,7,8,10,11,12,15,16,17,19,20,21,24,29,31],bottl:4,bottom:[3,10,19],bounc:[8,17],bound:[3,5,11,20],boundari:[5,8,17],box:[9,18,29,31],bracket:1,brain:[4,5],brake:[12,21],branch:[25,26],brand:0,breast:5,brew:[2,7,16],brian:[29,31],brief:[9,18],briefli:[2,6,10,15,19],bring:[2,3,10,12,19,21],brisban:[29,31],broad:[0,2],broken:[8,17],browser:2,brute:3,bte:[10,19],bthe:[11,20],buck:0,build:[0,1,2,3,7,16,29,31],built:[3,5,10,19,26,29,31],bundl:28,buoyanc:[7,16],bus:[12,21],busi:3,butler:23,c_0:1,c_1:[5,12,21],c_1e:[12,21],c_2:[5,12,21],c_2e:[12,21],c_3:5,c_4:5,c_i:5,c_k:1,c_w:[8,17],cal:5,calcul:[0,2,3,5,6,7,8,9,10,11,15,16,17,18,19,20],calculu:23,call:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,29,31],callabl:3,came:[8,12,17,21],camera:0,can:[0,1,2,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,23,25,26,29,30,31],cancel:[3,9,18],cancer:5,cannot:[0,1,2,3,5,8,9,17,18],canopi:[2,7,16],capabl:[0,2,7,16],capita:3,captur:5,car:[0,8,12,17,21],card:[0,3,4],cardin:5,care:[10,19],carlo:[0,1,2,3],carmak:0,carri:[3,4],cartesian:[7,11,16,20],cast:5,categor:[0,2,5],categori:[0,2,4,5],categorical_crossentropi:5,caus:[0,1,3,8,12,17,21],causal:3,causat:0,caveat:[9,18],cbook:3,ccc:5,cdf:1,cdot:[1,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21],ceil:[7,9,10,11,16,18,19,20],cell:[29,31],cellphon:23,center:[1,2,3,4,8,9,10,12,17,18,19,21,23],central:[0,2,3,6,7,12,15,16,21,23],centrifug:23,centroid:1,centuri:[6,15],certain:[0,1,2,3,4,11,20],cha:3,chain:[0,1,9,11,12,18,20,21,23],challeng:[9,18],chanc:[1,5,11,20],chang:[1,2,3,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,25],chapter:[3,10,19,23],charact:[1,2,3],character:[1,5],characterist:[3,10,19],charg:[2,8,11,17,20],charl:3,cheap:3,cheaper:5,check:[2,3,5,7,8,10,13,14,16,17,19,28,30],checkmark:[10,19],chemic:1,chi:2,chimborazo:[12,21],choic:[1,3,7,8,10,11,16,17,19,20],choleski:3,choos:[1,3,7,8,9,10,11,16,17,18,19,20],chosen:[1,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21],chosen_datapoint:5,chpater:[10,19],christoph:[29,31],cin:1,circ:[5,12,21],circl:[3,5,8,11,17,20],circuit:[10,19],circul:[11,12,20,21],circular:[8,9,11,17,18,20],circumst:24,circumv:[3,5],cite:[29,31],citizen:0,civita:[9,18],claim:0,clarifi:24,clariti:1,classic:[2,6,9,11,12,15,18,20,21,31],classif:[0,2,3,4,7,16],classifi:[0,4,5],classificaton:5,clean:5,clear:[5,11,20],clearli:[1,3,8,9,17,18],clever:5,clf3:2,clf:[2,3],clf_lasso:3,clf_ridg:3,clip:1,clockwis:[8,12,17,21],clone:[25,26],close:[0,1,2,3,5,7,8,10,11,12,16,17,19,20,21],closer:[8,17],closest:[7,11,16,20],closur:[2,7,16],cloud:[2,7,16],cluster:[0,2,3,5],cmap:[2,3,5,13,14,30],cmap_arg:3,cmath:1,cmse201:[6,15],cn_:1,cna:[8,17],cnn:5,cntk:[2,7,16],code:[0,2,4,6,8,15,17],coef:2,coef_:[2,3],coeffici:[2,3,4,8,10,12,17,19,21],coerc:[2,3],cognit:[29,31],coin:1,col:[2,3,7,16],colab:[2,7,16],cold:[13,14,30],colinear:3,collect:[1,2,3,7,8,16,17],collid:[0,11,20],collinear:3,collis:[0,11,20],color:[1,2,3,7,11,13,14,16,20,30],color_cod:3,colorbar:3,column:[2,3,5,7,16],com:23,combin:[1,3,4,6,9,11,12,15,18,20,21],come:[0,2,3,5,7,8,10,11,12,16,17,19,20,21],comma:2,command:[0,1,2,5,6,7,15,16,29,31],comment:24,commerci:[2,7,16],commit:[24,25],commod:2,common:[0,1,2,3,4,5,7,8,9,10,11,16,17,18,19,20],commonli:[3,4,5],commonmark:[29,31],commun:[0,2,5,24],commut:[9,18],compact:[3,4,5,9,11,18,20],compactli:[9,18],compani:0,compar:[2,3,6,7,8,10,11,12,15,16,17,19,20,21],compat:4,compdriv:[10,19],compet:[0,2,6,15,23],compil:[0,1,2,5],complaint:24,complement:[9,18],complementari:[10,19],complet:[2,5,8,10,17,19],completenn:5,complex:[0,3,5,10,11,12,19,20,21,29,31],complic:[0,2,3,5,6,8,11,12,15,17,20,21],compon:[3,5,8,9,10,11,12,17,18,19,20,21],compos:5,compress:[2,3,8,17],compris:3,compromis:3,comput:[0,2,3,5,6,8,9,10,12,15,17,18,19,21,23,29,31],computation:[0,1],con:23,concaten:3,concentr:3,concept:[0,2,3,9,18],conceptu:[5,11,12,20,21],concern:[0,4,5,9,18],concic:[2,7,16],conclud:2,conclus:[0,5],conda:[2,5,7,16,25],condit:[1,3,7,8,9,10,11,12,16,17,18,19,20,21],conduct:[0,6,15],confer:[29,31],confid:[3,4],confidenti:24,confirm:5,confus:3,congruenti:1,connect:[2,3,5,7,16,23],consequ:[3,5,6,11,15,20],conserv:[3,8,10,11,17,19,20,23],consid:[0,1,2,3,4,5,8,9,10,11,12,17,18,19,20,21,24],consider:[0,3,5,8,17],consist:[1,3,5,8,10,17,19],constant:[1,2,3,5,8,9,10,11,12,17,18,19,20,21],constitu:2,constitut:3,constrain:[5,11,20],constraint:[3,23],construct:[0,1,2,3,5,6,15,24],consumpt:[8,17],contact:[2,8,11,17,20,24],contain:[0,1,2,3,4,5,6,7,15,16,23],content:[2,7,16,28,29,31],context:3,continu:[0,2,3,4,5,6,7,8,12,15,16,17,21],continuosli:0,contrast:[5,8,12,17,21],contribut:[0,1,2,3,9,10,11,12,18,19,20,21,24,26],contributor:[0,2,24,25],control:[0,2,5],conveni:[2,3,5,6,7,8,9,11,15,16,17,18,20],convent:[5,6,7,15,16],converg:[3,5],convert:[2,3,7,11,12,16,20,21],convex:4,convolut:[10,19],cookiecutt:26,coolwarm:[13,14,30],coordin:[3,5,8,9,10,11,17,18,19,20,23],coorel:3,copi:[5,25],corel:0,corioli:23,corner:[12,21],corona:23,corr:3,correalt:3,correct:[0,1,2,3,5,8,9,10,12,17,18,19,21,24],correct_predict:5,correctli:[3,5],correl:[0,2,5],correlation_matrix:3,correspod:[12,21],correspond:[1,2,3,5,7,9,10,11,12,16,18,19,20,21],cortex:[5,29,31],cos:[3,7,8,9,10,11,12,16,17,18,19,20,21],cosh:[7,16],cosin:[3,10,19],cost:[0,1,2,3,4],could:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,24,25],coulomb:[2,11,20],count:[1,2],counter:[7,10,12,16,19,21],coupl:[3,7,8,10,16,17,19],cours:[0,1,3,6,7,8,9,15,16,17,18,23],cout:1,cov:[1,2,3],cov_xi:3,cov_xx:3,cov_yi:3,covari:[0,2],covariance_matrix:3,coven:24,cover:[0,2,10,11,19,20,22,23,27],covert:2,covxi:1,covxx:1,covxz:1,covyi:1,covyz:1,covzz:1,creat:[2,5,6,7,11,13,14,15,16,20,24,25,26,30],create_accuraci:5,create_biases_and_weight:5,create_dnn:5,create_loss:5,create_neural_network_kera:5,create_optimis:5,create_placehold:5,create_x:3,creation:5,credit:[0,3,4,23,25],crim:3,crime:3,criteria:[1,2],critic:[0,9,18,23,24],criticallydamp:[10,19],cromer:[10,19,23],cross:[0,1,4,5,7,8,9,10,12,16,17,18,19,21,23],cross_val_scor:3,crossvalid:3,crucial:[1,5],csc:[10,19],csr_matrix:2,cstdlib:1,csv:[2,3],ctnk:5,ctrajectori:[11,20],cubic:2,cumsum:[2,7,16],cumul:3,current:[12,21,26],curs:3,curv:[4,5,8,9,17,18],curvatur:[11,12,20,21],custom_lin:[13,14,30],cycl:[1,5,11,20],cycler:[13,14,30],cyclon:[12,21],cyclotron:[8,17],d2l:23,da_d:[11,20],da_i:[12,21],dagger:[2,3,7,16],dai:[5,6,8,12,15,17,21,23],damp:23,dampeddiffyq:[10,19],darkr:1,dat:[2,3,7,16],dat_id:[2,3,7,9,10,11,16,18,19,20],data:[4,6,7,8,9,10,11,13,14,15,16,17,18,19,20,30],data_id:[2,3,7,9,10,11,16,18,19,20],data_indic:5,data_panda:[2,7,16],data_path:[2,3,7,9,10,11,16,18,19,20],databas:[2,5],datafil:[2,3,7,9,10,11,16,18,19,20],datafram:[2,3,7,16],datapoint:[3,4,5],dataset:[3,4],date:[0,2,7,16],dbh:5,dbo:5,ddot:[8,10,11,12,17,19,20,21],ddrive:[10,19],dead:5,deadlin:23,deal:[0,1,2,3,5,7,12,16,21],dearli:0,debt:4,debug:3,decad:[0,2],decai:[1,2,8,10,17,19],decid:[0,3],decim:[2,3],decis:[0,2,5],decisiontreeregressor:2,declar:[2,3,7,16],decomposit:[0,5],decompost:3,decreas:[3,5,9,18],deduc:[0,2,8,17],deem:[8,17,24],deep:[2,4,8,17],deepen:[6,15],deeper:[0,2,6,8,9,15,17,18,23],def:[1,2,3,5,6,7,9,10,11,15,16,18,19,20],def_covari:1,defect:3,defici:3,defin:[1,2,3,4,6,7,9,10,11,12,15,16,18,19,20,21,23,24,29,31],definit:[3,6,7,8,10,11,12,15,16,17,19,20,21],defint:[1,7,16],deflect:[12,21],degre:[0,1,2,6,8,9,10,11,12,15,17,18,19,20,21],delet:[1,3],deliv:2,delta:[1,2,5,7,8,9,10,11,12,16,17,18,19,20,21],delta_:[2,5,7,16],delta_h:[2,5],delta_j:5,delta_k:5,delta_l:5,delta_n:[2,10,19],deltat:[7,9,10,11,16,18,19,20],deltax:[11,20],delv:2,demonstr:[2,3,4,5,10,12,19,21],demostr:[12,21],denomin:[5,10,11,19,20],denot:[1,3,4,5,9,12,18,21],dens:5,densiti:[1,3,8,11,17,20],depart:[12,21],departur:[11,20],depend:[1,2,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21,23,29,31],depict:1,deploy:[2,7,16],deposit:[11,20],deriv:[2,3,4,6,7,8,12,15,16,17,21,23],derogatori:24,descend:3,descent:[0,3,4],descr:3,describ:[0,2,3,5,7,8,10,11,12,16,17,19,20,21],descript:[3,12,21],deserv:0,design:[2,4,5,8,10,17,19],designmatrix:3,desir:[0,2,3],despit:[5,8,17],det:3,detail:[2,7,9,11,16,18,20,23,24,25],detect:[5,12,21],detector:[11,20],determin:[0,1,2,3,5,7,8,9,10,12,16,17,18,19,21,23,24],determinist:[1,4],detial:23,detriment:0,dev:[1,5],develop:[0,2,6,7,8,9,10,11,15,16,17,18,19,20,23,25,26],deviat:[2,3,5,7,16],devic:[6,15],devis:5,df1:[2,7,16],diag:3,diagnost:5,diagon:[1,2,3,4,7,16],diagonaliz:3,diagram:23,diagsvd:3,dial:[10,19],dialect:0,diamet:[12,21],dict:3,dict_kei:3,dictionari:3,did:[3,4,5,8,10,12,17,19,21],die:5,died:[10,19],diff:[8,17],differ:[0,1,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21,23,24,29,31],differenti:[0,2,9,11,12,18,20,21,23],difficult:[0,1,3,5,8,9,12,17,18,21],difficulti:[0,5],digit:[0,2,5],dilut:5,dim:[10,19],dimens:[2,3,5,9,10,12,18,19,21],dimension:[0,2,7,9,10,11,16,18,19,20],dimensionless:[2,8,9,10,17,18,19],diment:[7,16],dimless:[8,17],diod:[10,19],direct:[0,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21],directli:[1,3,5,7,11,16,20,29,31],directori:26,disabl:[24,26],disadvantag:2,disappear:[10,11,19,20],discard:3,disciplin:[0,2,5],disclaim:[0,1],discours:[0,6,15],discov:0,discrep:[12,21],discret:[4,5,6,10,15,19],discrimin:4,discuss:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,23],discussiom:23,diseas:4,disk:2,disord:4,displac:[9,10,12,18,19,21],displai:[1,2,3,5,7,11,16,20,29,31],displaystyl:3,disregard:2,disrupt:0,dissip:[8,17],dissipitav:[10,19],distanc:[1,3,8,9,11,12,17,18,20,21],distant:[11,20],distinct:4,distinguish:[1,2,8,17],distort:[11,12,20,21],distplot:3,distribuit:[7,16],distribut:[0,2,3,5,7,11,12,16,20,21],distrubut:[2,7,16],dive:[2,3,10,19],diverg:[5,11,20],divid:[0,1,2,3,5,7,8,10,11,16,17,19,20],divis:[1,3],dna:4,dnn:[2,5],dnn_kera:5,dnn_numpi:5,dnn_scikit:[2,5],dnn_tf:5,doc:[23,25,29,31],doconc:2,docstr:25,doctest:[6,15],document:[13,14,29,30,31],doe:[0,1,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21],doesn:[5,8,9,17,18,29,31],dog:5,doing:[2,3,8,17],dollar:[13,14,30],domin:[2,8,11,17,20],don:[1,2,3,5,7,8,11,12,16,17,20,21],done:[1,2,3,7,8,9,10,11,12,16,17,18,19,20,21],door:[10,19],dot:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21],doubl:[1,2,7,8,11,12,16,17,20,21,23],doubli:[5,9,12,18,21],down:[2,3,8,10,11,12,17,19,20,21],download:[2,5,7,16],drag:[7,8,10,16,17,19],draw:[3,8,17],drawback:3,drawn:[1,2,3,4,5,7,16],dream:0,drive:[0,8,10,17,19],driven:[23,25],drivenosc:[10,19],driver:0,drop:[1,2,3,12,21],dropna:[2,3],dry:0,dtype:[2,3,5,7,16],dub:2,due:[3,5,7,8,9,10,11,12,16,17,18,19,20,21,23],dummi:3,dure:[0,2,5,10,12,19,21],dv_:[8,17],dv_x:[8,9,12,17,18,21],dv_y:[8,9,12,17,18,21],dv_z:[9,12,18,21],dwell:3,dwh:5,dwo:5,dx_1:1,dx_n:1,dxdy:[10,19],dying:5,e_0:[8,17],each:[0,1,2,3,4,5,7,9,10,11,12,16,18,19,20,21],eager:3,eapprox:[2,3],ear:0,earli:5,earlier:[3,4,5,9,10,18,19],earth:[8,11,12,17,20,21,23],earthsuneul:[9,18],earthsunvv:[9,18],easi:[0,2,3,4,5,7,8,9,10,11,16,17,18,19,20],easier:[0,1,2,3,11,20,23,25],easili:[0,2,3,4,5,6,7,8,9,10,15,16,17,18,19],east:[12,21],ebind:[2,3],eccentr:[11,20],econom:0,econometr:[2,7,16],ecosystem:[2,7,16,29,31],edgecolor:3,edit:[2,24],edu:23,educ:[0,2,3,6,10,15,19,23],eff:[1,11,12,20,21],effect:[1,5,7,8,10,16,17,19,23],effic:5,effici:[1,2,7,8,16,17],efron:[1,3],eig:[1,2,3],eigen:1,eigenpair:3,eigenvalu:[2,3,7,16],eigenvector:3,eight:[2,7,16],eigval:[1,2],eigvec:[1,2],eispack:[2,7,16],either:[0,1,2,3,4,5,8,9,10,11,12,17,18,19,20,21],elabor:1,elast:[11,20],electr:[2,5,8,10,11,17,19,20],electrodynam:[11,20],electromagnet:[8,11,17,20],electron:[6,9,11,15,18,20,24],elel:[7,16],element:[0,2,3,4,5,6,8,9,15,17,18],elementari:[2,7,16,23],elessar:[2,7,16],elimin:[10,11,19,20],ellips:[11,12,20,21],ellipt:[12,21,23],els:[1,4,5,8,17],elu:5,elus:0,email:23,emb:[13,14,30],embed:3,embodi:3,emit:[1,9,18],empathi:24,emphas:[0,2,10,19,23],emphasi:[2,7,16],empir:[1,5],emploi:[1,2,3,5,8,10,17,19],employ:[0,2,3],employe:0,empti:3,emul:5,enabl:[6,15],enbodi:[10,19],encapsul:[10,11,19,20],encod:0,encompass:[0,1,2,8,17],encount:[0,1,3,4,5,11,20],end:[0,1,2,3,4,5,7,8,9,10,11,12,13,14,16,17,18,19,20,21,23,30],endl:1,endpoint:[1,3,10,19],energi:[7,8,10,11,12,16,17,19,20,21,23],enforc:5,engag:[6,15],engin:[0,1,2,5,7,8,16,17,23],enhanc:[6,15,23,25],enough:[0,3,8,11,12,17,20,21],enquiri:[8,17],enscrib:[9,18],ensembl:[1,5],ensur:[1,3,5,10,11,19,20],entail:2,enter:[0,1,3,10,12,19,21],enthought:[2,7,16],entir:[1,2,4,5,7,10,11,16,19,20,29,31],entiti:[2,5,7,16],entitl:0,entri:[2,3,5],entropi:[2,4,5],enumer:[2,3,5],env:1,environ:[2,6,7,8,15,16,17,24,26],eol:3,eosfit:3,epoch:[2,5],epsilon:[3,4,9,18],epsilon_0:[3,11,20],epsilon_1:3,epsilon_2:3,epsilon_:[2,3,8,9,17,18],epsilon_i:3,eqnarrai:[3,8,9,10,11,12,17,18,19,20,21],equador:[12,21],equal:[0,1,2,3,5,7,8,10,11,12,16,17,19,20,21],equat:[0,1,2,4,6,11,12,15,20,21,23],equatori:[12,21],equilibrium:[5,8,17],equiv:[1,9,10,11,12,18,19,20,21],equival:[2,3,5,7,9,10,11,16,18,19,20],erf:1,eriador:[2,7,16],eridg:3,err:2,err_:3,error:[0,1,2,4,5,6,10,15,19],error_estimate_corr_tim:1,error_hidden:5,error_output:5,escap:[13,14,30],especi:[5,9,10,11,18,19,20],essenti:[0,1,2,3,5,6,8,12,15,17,21],estim:[0,1,2,3,4,5,9,18],estimated_mse_fold:3,estimated_mse_kfold:3,estimated_mse_sklearn:3,eta:[2,5,10,12,19,21],eta_v:[2,5],etc:[0,1,3,4,5,7,8,13,14,16,17,23,30],ethic:[6,15],ethnic:24,etsim:3,euclidean:3,euler:[8,10,17,19,23],eulerintegr:[7,16],eurler:[7,16],european:0,evalu:[0,1,2,3,6,8,9,10,15,17,18,19,23],even:[0,1,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21,25],event:[0,4,24],eventson:3,eventu:[3,5,8,12,17,21],everest:[12,21],everi:[1,2,3,5,7,8,9,12,16,17,18,21,25],everybodi:[0,23],everyon:24,everyth:[5,8,11,17,20],evid:[8,17,29,31],evolut:[10,11,19,20],evolv:[0,2],exact:[1,2,3,5,6,7,8,9,10,15,16,17,18,19],exactli:[3,5,11,12,20,21],exam:23,examin:3,exampl:[0,4,8,10,12,13,14,17,19,21,23,24,29,30,31],exce:5,excel:[0,2,3,5,26],except:[1,3,8,12,17,21],excess:2,excit:[0,2,10,11,19,20],exclud:[3,5],exclus:[1,2,3],execut:3,executablebook:26,exercis:[0,2,3,6,8,9,15,17,18,23],exert:[9,18],exhaust:3,exhibit:3,exist:[0,2,3,5,7,9,10,11,16,18,19,20,26,29,31],exit:[1,3],exp:[1,3,4,5,10,19],exp_term:5,expand:[3,4,7,10,16,19],expans:[3,5,9,10,11,18,19,20],expect:[0,2,5,8,10,11,12,17,19,20,21,24],expectation_value_of_h_wrt_p:1,expens:1,experi:[0,2,3,5,6,8,11,12,15,17,20,21,24],experiment:[1,2,3,8,11,17,20],experimentalist:[11,20],expert:5,explain:[1,2,3,12,21,25],explanatori:3,explicit:[2,3,7,9,10,12,16,18,19,21,24],explicitli:[0,2,9,18],explod:5,exploit:[3,5],explor:[2,3,6,7,15,16],expon:5,exponenti:[2,5,8,10,17,19],expos:0,express:[1,2,4,5,7,8,10,11,12,16,17,19,20,21,24],exptmean:1,exptvari:1,ext:[10,19],extend:[0,4,6,7,15,16],extens:[0,2,3,5,9,11,18,20,29,31],extent:[0,2,3,23],extern:[3,8,9,10,11,12,17,18,19,20,21],extra:[3,5,10,19,23],extract:[0,2,3,4,8,10,11,17,19,20],extrapol:[2,3],extrem:[0,2,3,4,5,6,7,15,16],eye:[0,2],f11:2,f12:2,f13:2,f6d7a289d493:[2,7,16],f_0:[9,10,18,19],f_0b:[9,18],f_0e:[10,19],f_2:5,f_3:5,f_d:1,f_g:[9,18],f_h:[9,18],f_i:[3,5,8,10,17,19],f_m:[10,19],f_n:[10,19],f_r:[11,20],f_x:[8,9,11,17,18,20],f_xv_x:[9,18],f_y:[8,11,17,20],f_yv_i:[9,18],f_zv_z:[9,18],face:24,facecolor:[1,3],facil:0,facilit:5,fact:[0,2,3,5,7,9,10,11,12,16,18,19,20,21],factor:[1,2,3,5,8,9,11,17,18,20],fade:3,fail:[3,11,20],failur:4,fair:24,fairli:1,faith:24,fall:[11,20,23],fallingbasebal:[7,16],fals:[2,3,4,5,10,19],famili:[0,1,2,4,7,10,16,19,23],familiar:[0,1,2,7,9,11,16,18,20],famou:[0,3,5],fanci:0,far:[0,1,2,3,5,8,11,17,20],fashion:[0,6,15],fast:[1,2,3,5,7,12,16,21],fastdriven1:[10,19],fastdriven2:[10,19],favor:4,favorit:1,fc1:5,fc2:5,featur:[1,4,5,10,19],feature_nam:3,feb:23,februari:[10,19],fed:[0,5],feed:[0,2,8,17],feed_dict:5,feed_forward:5,feed_forward_out:5,feed_forward_train:5,feedforward:5,feel:[2,7,9,10,12,16,18,19,21,28],feet:[3,12,21],fellow:0,felt:[8,17],few:[1,2,5,22,27],fewer:2,ffedbda27704:[10,19],ffnn:5,fictiti:[12,21],field:[0,2,3,5,9,10,11,12,18,19,20,21,23],fifth:[2,7,16],fig:[2,3,4,5,7,9,10,11,13,14,16,18,19,20,30],fig_id:[2,3,7,9,10,11,16,18,19,20],figaxi:1,figsiz:[2,3,5,7,13,14,16,30],figur:[2,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21],figure_id:[2,3,7,9,10,11,16,18,19,20],figurefil:[2,3,7,9,10,11,16,18,19,20],file:[1,2,3,5,7,9,10,11,16,18,19,20,23,25],filenam:[1,2,3,7,16],fileout:1,filewrit:5,fill:3,financ:[0,2],find:[0,1,2,4,5,6,8,9,10,11,12,15,17,18,19,20,21,23],fine:5,finish:[8,17],finit:[1,3,5,11,20],first:[0,1,3,4,6,9,10,11,12,15,18,19,20,21,23,29,31],fit:[0,1,4,5,8,17],fit_intercept:3,fit_transform:[2,3],fiti:2,five:[2,3],fix:[2,5,8,9,10,11,12,13,14,17,18,19,20,21,30],flat:5,flatten:5,flavor:[29,31],flexibl:[2,3,5,6,7,10,15,16,19],flip:[11,20],float32:5,float64:[2,3,7,16],floor:[7,16],flop:3,flow:[5,8,12,17,21],fly:[11,20],flyvbjerg:1,fmax:[10,19],focault:[12,21],foci:[11,20],focoault:[12,21],focu:[0,2,3,7,8,11,12,16,17,20,21],focus:[4,5,10,19,24],folder:[2,7,16,23],folk:0,follow:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,24,29,31],font:[1,2,7,10,16,19],fontdict:1,fontsiz:[1,3],footbal:[11,20],forc:[3,6,7,9,15,16,18,23],forcedblockeulercrom:[10,19],forcedblockrk4:[10,19],forecast:5,forest:[0,2,5],fork:25,form:[0,1,2,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21],formal:[1,7,9,12,16,18,21,23],formalim:23,format:[1,2,3,6,7,9,10,11,15,16,18,19,20],formul:[3,8,17],formula:[1,7,9,10,11,16,18,19,20],forth:[5,11,12,20,21],fortran90:1,fortran:[0,2,7,16],fortun:3,forum:23,forward:[2,3,7,8,9,10,12,16,17,18,19,21],forwardeul:[10,19],forwardeulercrom:[10,19],foster:24,foucalt:23,foucault:23,found:[3,5,8,10,11,17,19,20,26],foundat:[6,15],four:[5,9,12,18,21],fourier:[3,23],fourierdef1:[10,19],fourierdef2:[10,19],fourierseriessign:[10,19],fouriersolut:[10,19],fourpi2:[9,18],fourth:[2,5,7,10,16,19],frac:[1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21],frame:[8,11,17,20,23],framework:[0,1,5],frankefunct:3,free:[1,2,7,16,24],freedom:[6,8,10,11,15,17,19,20],freeli:[0,2],freewai:[8,17],frequenc:[1,3,7,8,10,11,12,16,17,19,20,21],frequent:[0,2],frib:23,friction:[8,10,17,19,23],frictionless:[8,17],fridai:23,friendli:[10,19],frodo:[2,7,16],from:[0,1,2,4,6,7,8,9,10,11,13,14,15,16,17,18,19,20,23,24,30],front:[0,2],frontier:[29,31],frydai:23,fstream:1,ftild:[10,19],fuel:[8,17],fulfil:[3,5,8,17],full:[0,1,2,3,4,7,16],fulli:[1,3,5,26],fun:[2,7,16],func:3,fundament:[0,3,8,10,17,19],further:[2,6,7,8,9,11,12,15,16,17,18,20,21,23,24],furthermor:[2,3,4,5,6,7,8,15,16,17],furthest:[12,21],futur:[0,2,8,10,17,19],futurist:0,fwhm:[10,19],g_m:[10,19],g_n:[10,19],gain:[0,3,5,6,8,9,10,15,17,18,19,23],galaxi:[8,17],galleri:[0,2],gallon:[11,20],gamge:[2,7,16],gamma:[3,8,10,11,12,17,19,20,21],gamma_:3,gamma_i:[1,3],gamma_x:3,gate:5,gather:5,gaug:5,gauss:[11,20],gaussian:[3,10,19],gca:3,gen:1,gender:[3,24],gener:[0,2,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,23],generallay:5,genet:[0,5],geodes:[12,21],geometr:[2,8,9,17,18],geq:3,get:[0,1,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,23,28],get_default_graph:5,get_yticklabel:3,getattr:3,ggplot:[7,16],ghp:26,gibb:0,git:[0,23],github:[0,2,23,25,26],gitlab:0,give:[0,1,2,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21,23,28],given:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,25],global:[1,4,9,10,18,19],global_step:5,global_variables_initi:5,glorot:5,gm_1m_2:[11,20],gm_:[9,11,18,20],gm_am_b:[11,20],gmm:[11,12,20,21],goal:[0,2,3,4,8,17],goe:[2,3,5,9,10,11,18,19,20,23],going:[2,5,8,12,17,21],gold:[11,20],gone:3,gong:5,good:[1,2,3,5,6,8,10,15,17,19,23,24],googl:[2,5,7,16],got:5,govern:[6,8,15,17],gracefulli:24,grader:23,gradient:[0,2,3,4,12,21],gradientdescentoptim:5,gradual:[8,10,17,19],graph:[0,5],graphic:[2,5,6,8,15,17],grasp:[0,2],gravgauss:[11,20],gravit:[5,7,8,9,10,12,16,17,18,19,21,23],graviti:[7,11,12,16,20,21,23],gray_r:5,graze:[11,20],great:[8,17],greater:[1,5],greatli:25,green:[1,2,10,19],greeni:[10,19],greeny2:[10,19],grid:[1,3,4,5,8,11,17,20],ground:[2,7,12,16,21],group:[0,2,3],groupbi:[2,3],grow:5,growth:2,guarante:[0,1,3],guess:[5,8,10,12,17,19,21],guid:[0,5,13,14,30],habit:[6,15],had:[0,2,3,5,8,9,11,17,18,20],hadamard:5,half:[5,11,20],hamiltonian:[9,18],hand:[0,1,2,3,5,6,7,8,11,12,15,16,17,20,21,23],handi:[9,12,18,21],handl:5,handsid:5,handwrit:5,handwritten:5,handwrittennot:23,happen:[1,5,8,11,17,20],harass:24,hard:[4,5],hardcopi:[2,7,16],harder:[3,5],harm:24,harmon:[8,9,17,18,23],has:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,23,26,29,31],hassl:[2,7,16],hast:0,hat:[1,2,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21],have:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,23,24],haven:5,hbar:[9,18],hdf5:2,hdhpk14:[29,31],head:[1,3],header:[2,3],hear:[0,2],heart:[0,2],heatmap:[2,3,5],heavi:[6,11,15,20],heavili:[0,2],heavisid:5,heer:[29,31],height:[5,8,9,11,12,17,18,20,21],helic:[8,17],help:[0,5,6,11,15,20,25],hemispher:[12,21],henc:[2,3,5,8,17],her:4,here:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,23,25,26,29,30,31],hereaft:[3,5,9,12,18,21],hermitian:[2,7,16],hessenberg:[2,7,16],hhint:[9,18],hidden:5,hidden_bia:5,hidden_bias_gradi:5,hidden_layer_s:[2,5],hidden_weight:5,hidden_weights_gradi:5,high:[0,2,3,5,7,10,12,16,19,21],higher:[0,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21],highest:5,highli:[1,2,3,7,16],highwai:3,hinder:0,hire:[0,2],his:4,hist:[1,3],histogram:[1,3],histor:4,histori:5,histtyp:3,hit:[0,7,8,11,16,17,20],hjensen:23,hjorth:23,hobbi:1,hoc:3,hold:[1,3,5,8,10,12,17,19,21],holder:3,holdgraf:[29,31],holdgraf_evidence_2014:[29,31],home:[3,23],homework:[9,11,18,20,23],homogen:[5,8,10,12,17,19,21],homogn:[8,17],homogsolut:[10,19],hope:[0,6,15],hopefulli:[1,3,8,17],horizont:[8,12,17,21],hors:4,hot:[5,13,14,30],hour:[1,5,12,21,23],how:[0,2,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,22,23,25,27,28],howev:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21],hspace:[1,2,7,8,10,16,17,19],htm:23,html:[2,6,13,14,15,23,26,30],http:[2,5,7,16,23],huang:2,huber:2,huge:5,human:[0,2,5,29,31],hundr:5,hungri:5,hurrican:[12,21],hv_:[9,18],hw10:23,hydrogen:2,hyperbola:[11,20],hyperparamet:3,i_1:3,i_2:3,i_c:[10,19],i_i:[10,19],idea:[0,1,2,3,5],ideal:[0,1,2,3,6,8,10,15,17,19],idem:3,ident:[3,5,10,19,24],identifi:[0,2,4,5,6,11,15,20],idum:1,ieor:1,iet:[10,19],ifs:[2,7,16],ignor:[3,7,9,11,12,16,18,20,21],iii:[2,7,16],ijk:[8,9,17,18],illustr:[0,5,8,11,12,17,20,21],imag:[3,5,13,14,30],image_path:[2,3,7,9,10,11,16,18,19,20],imageri:24,imagin:[8,9,17,18],imaginari:[10,12,19,21],immedi:[0,2,3,10,19,23],impact:[0,6,11,15,20],impart:[8,17],implement:[2,3,6,8,9,10,15,17,18,19,23],impli:[2,3,6,7,10,15,16,19],implic:[8,17],implicitli:1,impos:[0,3,5],imposs:[0,3],impress:[0,2,5],improv:[0,3,8,9,10,17,18,19],impuls:[10,19],imshow:[3,5],inact:5,inadequ:0,inappropri:24,incid:[11,20,24],includ:[1,2,3,5,6,8,10,11,12,13,14,15,17,19,20,21,24,25,29,30,31],include_bia:3,inclus:[6,15,24],incom:[5,11,20],inconsist:[10,19],incorpor:[10,12,19,21],incorrect:5,increas:[0,1,2,3,5,6,9,10,11,15,18,19,20],increasingli:1,incred:0,increment:[6,15],ind:3,inde:[0,2,3,8,9,10,11,17,18,19,20],indent:[1,10,19],indentationerror:1,independ:[1,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21,23],index:[1,2,3,5,7,16],index_col:[2,3],indic:[2,3,5,7,8,16,17],indispens:3,individu:[1,4,5,10,11,19,20,24],indu:3,industri:[6,15],inelast:[11,20],inequ:0,inerti:[8,17,23],inertia:[8,17],inf:3,infam:0,infer:[0,3,5,11,20],infil:[2,3,7,16],infin:[3,10,19],infinit:[0,8,10,11,17,19,20],infinitesim:[1,10,19],influenc:[3,7,8,11,16,17,20],influenti:5,info:[2,5,7,16],inform:[0,2,3,5,9,11,13,14,18,20,24,26,29,30,31],infti:[1,8,10,17,19],ingredi:[0,2],inher:3,inherit:[2,7,16],init:[29,31],initi:[1,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21],initialis:1,inlin:[1,2,3,4,5,6,7,9,10,11,15,16,18,19,20],inner:3,inoccu:0,input:[0,1,2,3,4,5,6,7,9,10,15,16,18,19,29,31],inputs_shuffl:5,insert:[1,5,7,9,10,11,12,16,18,19,20,21,29,31],insid:[3,11,20,29,31],insight:[0,2,3,5,6,8,15,17,23],inspect:[8,10,11,17,19,20],inspir:[0,2,5],instal:[5,23,25,26],instanc:[0,3,5,8,17,24],instant:[9,18],instantan:[7,16],instead:[0,1,2,3,5,6,7,8,9,11,15,16,17,18,20],institut:[0,5],instruct:[0,5],instructor:23,insult:24,int32:5,int64:3,int_0:[1,6,7,8,9,10,12,15,16,17,18,19,21],int_:[1,7,8,9,10,16,17,18,19],int_a:[1,6,9,15,18],integ:[1,2,5,7,11,16,20],integer_vector:5,integr:[0,1,2,6,8,10,11,15,17,19,20,23],integraldef:[9,18],integrand:[10,19],intellig:[0,2],intens:[5,6,15],interact:[2,3,5,7,8,10,11,13,14,16,17,19,20,30],intercept:[2,3],intercept_:[2,3],interchang:5,interest:[0,1,2,3,4,5,7,9,10,12,16,18,19,21,24],interfac:[2,5,6,15],interior:2,intermedi:[10,19],intern:[5,8,9,11,17,18,20,29,31],internet:[12,21],interpol:[5,9,18],interpr:3,interpret:[0,1,2,5,7,8,9,16,17,18],interv:[1,3,4,6,8,9,10,15,17,18,19],intimid:2,intract:3,intrins:[1,2,7,16],intro:[29,31],introduc:[0,1,2,5,6,7,8,9,10,12,15,16,17,18,19,21,23],introduct:[3,5,23],introductori:[2,3],intuit:[2,3,5],inv:3,invalid:[2,5,7,16],invalu:[2,6,7,15,16],invari:[5,9,18],invd:3,invers:[2,3,7,8,10,11,16,17,19,20],invers_period:1,invert:[3,4,8,9,17,18],investig:[6,15,24],invis:[11,20],invok:[3,8,17],involv:[0,3,4,5,7,8,10,11,16,17,19,20],inward:[12,21],iomanip:1,ion:[13,14,30],ios:1,iostream:1,ipynb:[2,7,16,29,31],ipython:[1,2,3,5,7,10,16,19],irreduc:3,irrelev:[3,10,19],irrespect:[0,2],ising:5,ismov:[8,17],isnul:3,isol:[7,9,16,18],isotrop:[12,21],issu:[0,5,24,25],item:[0,2,3],items:[2,7,16],iter:[1,3,5,8,17],its:[0,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,24,25,29,31],itself:[1,3,5,8,9,10,11,17,18,19,20],j_lasso_sk:3,j_ridge_sk:3,j_sk:3,jackknavg:1,jackknif:0,jackknstd:1,jackknvar:1,jackknvec:1,jargon:1,jensen:23,jeremi:23,job:[8,17],john:23,join:[2,3,7,9,10,11,16,18,19,20],joul:[7,16],journal:1,jrt:23,juli:23,jump:1,jupyt:[0,2,6,7,13,14,15,16,26,29,30,31],jupytext:[29,31],just:[0,1,2,3,4,5,7,8,9,10,11,16,17,18,19,20,23],justif:[0,2],k1v:[10,19],k1x:[10,19],k2v:[10,19],k2x:[10,19],k3v:[10,19],k3x:[10,19],k4v:[10,19],k4x:[10,19],k_1:[10,19],k_2:[10,19],k_3:[10,19],k_4:[10,19],kappa_d:1,keep:[0,2,3,5,6,7,8,9,10,13,14,15,16,17,18,19,25,30],keepdim:[3,5],kei:[3,5,10,19],kepler:[11,20,23],kept:[10,19],kera:[0,2,7,16],kernel:[3,5,29,31],kernel_regular:5,kev:[2,3],keyword:[2,7,16],kfold:3,kick:5,kilogram:[7,16],kind:[0,3,5,8,11,17,20,29,31],kindergarten:0,kinet:[7,8,9,10,11,16,17,18,19,20],knight:[29,31],know:[0,1,2,3,7,8,10,11,12,16,17,19,20,21,23],knowledg:[0,2,3,6,15,23],known:[0,1,3,4,5,7,8,9,10,12,16,17,18,19,21,23],kondev:2,kr_:[11,20],krh:[11,20],kutta2:[10,19],kutta4:[10,19],kutta:23,kwarg:3,kwown:3,l2_loss:5,l_1:4,l_2:4,l_j:5,l_z:[9,18],la_:[13,14,30],la_i:5,la_k:5,lab:[0,11,20],label:[1,2,3,4,5,8,9,10,11,12,17,18,19,20,21],labels:3,labels_shuffl:5,laboratori:[8,11,12,17,20,21],lack:[0,2],lad:0,lagrang:[9,18,23],lagrangian:[9,18,23],lai:[6,15],lambda:[1,2,4,5],lambda_1:3,lambda_n:3,land:3,langl:[1,3],langrangian:23,languag:[2,5,7,16,24,29,31],lapack:[2,7,16],larg:[0,1,2,3,5,6,7,8,10,11,15,16,17,19,20,23],larger:[1,2,3,6,10,15,19],lass:0,lasso:4,lasso_sk:3,last:[0,1,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21],later:[0,1,2,3,4,5,7,8,9,10,11,16,17,18,19,20],latest:23,latex:[2,6,7,15,16],latitud:[12,21],latter:[0,1,2,3,4,7,8,9,10,11,12,16,17,18,19,20,21],lattic:5,launch:0,law:[0,2,5,6,7,10,11,12,15,16,19,20,21,23],layer:2,lbl:3,lcc:3,ldot:[1,3],lead:[0,1,2,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21],leader:0,leadership:24,leaki:5,learn:[4,7,16],learning_r:5,learning_rate_init:[2,5],least:[0,1,2,4,7,8,16,17],leav:[3,5,9,11,18,20],lectur:[0,2,3,5,7,10,12,16,19,21],lecturenot:25,left:[1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21],leftarrow:5,legend:[2,3,7,13,14,16,30],len:[1,2,3,5,7,16],length:[1,2,3,5,7,8,9,10,16,17,18,19],lengthi:[12,21],leq:[1,2,3,4],less:[0,1,2,3,5,6,7,10,11,12,15,16,19,20,21,29,31],let:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21],letter:[1,2,3,7,16],level:[2,3,5,6,7,12,15,16,21,24],levi:[9,18],lhs:[7,16],lib:3,librari:[0,1,3,5,6,15],licens:[2,5,7,16],lie:[1,3],lies:[6,15],life:[0,2,5,6,12,15,21],light:[2,8,17],lightgrai:[11,20],like:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,23,26,29,31],likelihood:[0,3,5],lim_:[1,7,16],limit:[3,6,7,8,9,10,12,15,16,17,18,19,21,23],lin_model:3,linalg:[1,2,3],line2d:[13,14,30],line:[0,1,2,3,6,7,10,12,13,14,15,16,19,21,29,30,31],linear:[0,1,4,5,7,8,10,16,17,19,23],linear_model:[2,3],linear_regress:3,linearli:[3,8,10,17,19],linearregress:[2,3],liner:5,linestyl:[11,20],linewidth:[2,3],link:[2,5,12,21],linpack:[2,7,16],linreg:2,linspac:[1,2,3,10,11,13,14,19,20,30],linux:[2,5,7,16],liquid:[2,3],list:[2,3,7,10,16,19,25,26],listcomp:3,literatur:[4,5,11,20,23],littl:[5,7,11,16,20,25],lle:3,lmb:3,lmbd:[2,5],lmbd_val:[2,5],load:[2,3],load_boston:3,load_digit:5,loc:[2,3,7,16],local:[3,4,5,9,10,11,12,18,19,20,21,25,26],locat:[11,20,23],log10:[3,6,15],log:[2,3,4,5,7,16],log_:2,logarithm:[2,4,7,16],logic:[0,2],logist:[2,3],logit:[4,5],logspac:[2,3,5,13,14,30],longer:[1,2,7,8,9,10,11,16,17,18,19,20],loocv:3,look:[0,1,2,3,5,7,8,9,11,12,16,17,18,20,21,25,29,31],loop:[1,2,3,5,7,8,9,16,17,18],loos:[12,21],lorentz:[12,21],lose:5,loss:[0,2,3,4,5,7,8,9,16,17,18],lost:[10,19],lot:[3,6,13,14,15,30],love:[8,10,17,19],low:[1,3,11,12,20,21],lower:[2,3,5,7,9,10,11,12,16,18,19,20,21],lowercas:[2,7,16],lowest:1,lstat:3,lstsq:3,lvert:5,m_0:[9,18],m_1:[11,20],m_1m_2:[11,20],m_2:[11,20],m_e:[9,18],m_h:2,m_i:[9,18],m_iv_i:[9,18],m_l:5,m_n:2,m_p:2,machin:[3,4,5,7,16],made:[0,2,4,5,6,9,10,15,18,19],mae:2,magnitud:[5,7,8,9,10,11,12,16,17,18,19,20,21],mai:[0,1,2,3,4,5,6,7,8,9,10,12,15,16,17,18,19,21,24,26],mail:[23,24],main:[0,2,3,4,10,19,26],mainli:[2,3,4,8,10,17,19],maintain:[3,8,10,17,19,24],major:[2,3,5,6,7,15,16],make:[0,1,2,3,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,23,24,25,30],make_axes_locat:3,make_pipelin:[2,3],makedir:[2,3,7,9,10,11,16,18,19,20],makeplot:[2,7,16],malth:23,manag:[2,5,7,16],mani:[0,1,2,3,4,7,8,10,11,12,16,17,19,20,21,22,23,27,29,31],manifestli:[9,18],manner:[12,21],manual:[6,15,26],map:[0,1,2,3,4,5],margin:[0,2,9,18],marit:3,mark:[2,7,16],markedli:[29,31],marker:[2,3],market:0,markov:0,markup:[29,31],marsaglia:1,mask:1,mass:[3,5,7,8,9,10,12,16,17,18,19,21,23],massag:2,masses2016:2,masses2016ol:3,masses2016tre:2,masseval2016:[2,3,7,16],massiv:[12,21],master:23,match:[5,11,20],materi:[0,2,3,4,5,6,7,8,9,10,12,15,16,17,18,19,21],math:[1,2,4,5,6,7,9,10,11,13,14,15,16,18,19,20,30],mathbb:[1,3,4,5],mathbf:[1,2,3,4,7,16],mathcal:[3,4,5],mathemat:[0,1,2,6,8,10,15,17,19,23],mathemati:[2,7,16],mathemt:3,mathrm:[1,2,3,4,5,7,8,9,10,12,16,17,18,19,21],matmul:[3,5],matplotlib:[1,2,3,4,5,6,7,9,10,11,13,14,15,16,18,19,20,30],matric:[3,4],matrix:4,matur:[6,15],max:[2,3,5,9,10,11,18,19,20],max_depth:2,max_it:[2,5],maxdegre:3,maxim:[4,5],maxima:[11,20],maximum:[2,3,8,9,10,11,17,18,19,20],maxpolydegre:3,mbox:[3,13,14,30],mcculloch:5,mcint:1,mcintsqr2:1,mean:[0,2,3,4,5,6,7,8,9,10,12,13,14,15,16,17,18,19,21,23,30],mean_absolute_error:[2,3],mean_i:1,mean_squared_error:[2,3],mean_squared_log_error:2,mean_x:1,meaning:0,meansquarederror:2,meant:[0,4,6,11,15,20,23],meantempvec:1,meanvec:1,measur:[1,2,3,5,7,8,10,11,12,16,17,19,20,21],mechan:[0,1,6,8,9,10,12,15,17,18,19,21,31],mechanist:0,media:[23,24],median:[2,3],mediaspac:23,medicin:[0,5],medium:[8,10,13,14,17,19,30],medv:3,meet:[6,15],mehta:3,member:24,memori:[5,10,19],mention:[1,2,5,8,10,11,17,19,20],mere:[11,20],mersienn:1,mesh:[7,8,9,16,17,18],meshgrid:3,messi:[10,11,19,20],met:[0,2,3,9,18],metadata:[29,31],meter:[7,11,16,20],method:[0,2,4,5,6,8,11,15,17,20,23],methodolog:[6,15],metric:[2,3,5],metropoli:0,mev:[1,2,3],mgh:[11,12,20,21],mgl:[10,19],mglearn:[2,7,16],mgsin:[8,10,17,19],mgx:[12,21],mgy:[12,21],mhjensen:23,michigan:31,mid:[5,9,18],midpoint:[9,10,18,19,23],midterm:23,might:[3,5,8,9,11,17,18,20,25],mileag:[8,17],miller:1,million:[2,3],mimic:5,min:[3,11,20],min_:3,mind:[0,2,3],mine:[2,7,16],mini:5,minibatch:5,minim:[0,1,2,3,4,5,10,11,19,20],minima:[2,4,5,11,20],minimum:[3,5,10,11,19,20],minmaxscal:3,minneapoli:[12,21],minor:1,minut:[11,20],mismatch:5,miss:3,mix:[5,7,8,10,16,17,19],mkdir:[2,3,7,9,10,11,16,18,19,20],mlab:[1,3],mle:[1,4],mlk:23,mlpclassifi:5,mlpregressor:2,mnist:5,mod:1,mode:[1,10,19],model:[1,4,6,11,15,20],model_select:[2,3,5],modern:[0,2,3,4,6,15],modif:[5,11,20],modifi:[2,3,4,5,7,12,16,21],modul:[2,3,5,6,7,15,16],modular:[1,6,15],modulo:1,moe:3,molecul:[8,17],molten:[12,21],moment:3,momenta:[7,11,16,20],momentum:[7,8,10,11,16,17,19,20,23],mondai:23,monoton:[1,5],monstertruck:0,mont:[0,1,2,3],montecarlocycl:1,moon:[11,20],moor:3,more:[0,1,5,6,9,11,12,13,14,15,18,20,21,23,25,26,29,30,31],moreoev:31,moreov:[2,29],morten:23,most:[0,1,2,3,4,5,6,7,8,9,11,12,15,16,17,18,20,21,29,31],mostli:5,motion:[0,2,6,9,10,12,15,18,19,21,23],motiv:[5,8,10,17,19],mount:[12,21],move:[1,2,3,4,5,8,9,11,12,17,18,20,21,23],mpatch:[7,16],mph:[8,17],mpl:[2,7,10,16,19],mpl_toolkit:3,mplregressor:5,mr_:[11,20],mrv_:[11,20],mse:[2,3],msle:2,msu:23,mt19937_64:1,mu0:1,mu1:1,mu2:1,mu_:1,mu_k:[8,17],mu_x:1,much:[0,1,2,3,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21],multi:[2,3,4,7,16],multiclass:[4,5],multidimension:[2,5,7,16],multinomi:4,multipl:[1,3,4,7,8,16,17],multipli:[1,3,7,8,9,12,16,17,18,21,23],multitud:2,multivari:[0,1,2],must:[1,3,5,8,10,11,12,17,19,20,21,29,31],mutat:4,mutual:3,mv_0:[9,18],mv_:[11,20],mv_e:[9,18],mvn:1,mx_:1,mydirectivenam:[29,31],myriad:[2,7,16],mz1:1,mz2:1,n_0:[1,5],n_b:1,n_boostrap:3,n_bootstrap:3,n_categori:5,n_featur:5,n_hidden_neuron:[2,5],n_i:1,n_input:5,n_l:[1,5],n_neurons_layer1:5,n_neurons_layer2:5,n_sampl:3,n_split:3,nabla:[5,9,11,18,20],nabla_i:[9,18],nabla_jv:[9,18],naimi:2,naiv:4,name:[0,2,3,4,5,7,8,9,10,12,16,17,18,19,21,25,29,31],name_scop:5,namespac:1,narrow:25,nation:[5,24],nativ:[2,7,16],natur:[0,1,2,5,6,8,10,15,17,19],navier:5,navig:26,nbconvert:[2,7,16],nboot:1,ndarrai:3,nearest:[3,5],nearli:[12,21],neat:[2,7,16],neccesari:3,necessari:[0,5,8,10,17,19],necessarili:[0,1,11,20],neck:4,need:[0,1,3,5,8,9,10,11,12,17,18,19,20,21],neg:[1,2,3,4,5,8,10,11,12,17,19,20,21],neg_mean_squared_error:3,neglect:[1,10,11,19,20],neglig:[1,12,21],neighbor:3,neq:1,nervou:5,nest:5,net:[5,8,9,11,12,17,18,20,21],netlib:[2,7,16],network:[0,3,4,7,16],neural:[0,3,4,7,16],neural_network:[2,5],neuralnetwork:5,neuralnetworktensorflow:5,neurosci:[29,31],neutral:2,neutron:2,never:[1,3,5,10,11,19,20],new_hobbit:[2,7,16],new_sig:3,newaxi:[2,3],newdata:[7,16],newli:[0,7,16],newton1:[8,17],newton:[1,4,5,7,10,12,16,19,21,23],newtonian:[12,21],next:[1,2,5,7,9,10,11,12,16,18,19,20,21],nice:[2,3,5,7,16,23],nitric:3,nlambda:3,nm_n:2,nmse:3,node:5,nois:[2,3],noisi:[3,5],non:[1,3,4,5,9,10,18,19,23],none:[1,3,5],nonlinear:[3,5],nonneg:3,nonparametr:3,nonsens:1,nonsingular:[2,7,16],nonumb:[4,8,9,10,11,12,17,18,19,20,21],nor:[0,5],norm:[2,3,5,8,9,10,17,18,19],normal:[0,2,3,4,5,6,7,8,9,10,12,15,16,17,18,19,21],normali:[2,7,16],normpdf:3,north:[12,21],northern:[12,21],notat:[1,3,7,9,16,18],note:[1,2,3,4,5,7,8,9,10,11,16,17,18,19,20,25,29,31],notebook:[0,2,5,6,7,15,16,29,31],notesapril10:23,notesapril13:23,notesapril15:23,notesapril17:23,notesapril1:23,notesapril20:23,notesapril22:23,notesapril24:23,notesapril3:23,notesapril6:23,notesapril8:23,notesmarch13:23,notesmarch16:23,notesmarch18:23,notesmarch20:23,notesmarch23:23,notesmarch25:23,notesmarch27:23,notesmarch30:23,notesmarch9:23,noth:[1,3,5,7,16],notic:[1,2,5,7,9,12,16,18,21],novel:3,novemb:5,now:[1,2,4,5,7,8,9,10,11,12,16,17,18,19,20,21],nowadai:[0,2,5,6,15],nox:3,nozzl:[11,20],npt:[6,15],nsampl:3,nscl:23,nspin:1,nuclear:[10,11,19,20],nuclei:[1,2,11,20],nucleon:[2,3],nucleu:[2,11,20],number:[0,2,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21],numer:[0,2,3,5,6,7,8,11,15,16,17,20,23],numpi:[1,3,4,5,6,9,10,11,13,14,15,18,19,20,30],obei:[8,11,12,17,20,21],object:[2,3,7,11,16,20,23],oblig:24,observ:[3,4,5,8,11,12,17,20,21],obstacl:0,obtain:[1,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21],obviou:[0,1,3,9,18],obviouli:2,obvious:[0,2,3,7,8,9,16,17,18],occupi:3,occur:[1,2,8,10,11,12,17,19,20,21],ocean:[12,21],odd:[2,3,4,9,10,18,19],odot:[9,18],off:[1,3,5,10,11,19,20],offend:2,offens:24,offer:[2,3,6,15],offic:23,offici:[24,25],offlin:24,ofil:1,ofstream:1,often:[0,1,2,3,4,5,6,7,8,10,11,12,15,16,17,19,20,21],ofter:[2,7,16],oint:[11,20],old:[5,9,18],ols_inv:3,ols_sk:3,ols_svd:3,omega02:[11,20],omega:[3,7,8,9,10,11,12,16,17,18,19,20,21],omega_0:[8,11,12,17,20,21],omega_0a:[10,19],omega_0t:[8,10,11,12,17,19,20,21],omega_c:[8,17],omega_ct:[8,17],omega_cv_i:[8,17],omega_i:[12,21],omega_t:[10,19],omega_x:[12,21],omega_xv_i:[12,21],omega_xv_z:[12,21],omega_yv_x:[12,21],omega_yv_z:[12,21],omega_z:[12,21],omega_zt:[12,21],omega_zv_i:[12,21],omega_zv_x:[12,21],omegatild:[10,19],omit:3,omnipres:[10,19],onc:[1,3,5,8,10,11,17,19,20,29,31],one:[0,1,2,4,6,9,10,11,12,15,18,19,20,21,29,31],onehot:5,onehot_vector:5,ones:[0,2,3,7,9,16,18],onli:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,29,31],onlin:[0,2,24],onto:[8,17],open:[0,1,2,3,5,6,7,15,16,24,25,26],oper:[0,1,2,3,5,7,9,10,16,18,19,25],operation:1,oplu:1,opportun:[0,2],oppos:[3,8,17],opposit:[5,8,9,11,12,17,18,20,21],oppotun:[6,15],opt:[0,2,3,5],optim:[0,4],option:[0,5],optmiz:5,orang:2,orbit:[9,18,23],order:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21],ordinari:[4,8,10,17,19],org:[2,5,7,16],organ:[3,7,16],orient:[1,3,7,16,24],origin:[1,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21],orthogn:3,orthogon:[2,3,7,12,16,21],orthonorm:3,oscil:[8,9,12,17,18,21,23],oscillatori:[10,19],osx:[2,7,16],other:[0,2,3,4,6,8,9,10,11,12,15,17,18,19,20,21,24],otherwis:[2,3,4,5,9,11,18,20,24],ouput:5,our:[0,4,6,9,11,12,15,18,20,21],ourselv:[0,2,3,7,8,10,11,12,16,17,19,20,21],out:[1,2,3,4,5,7,9,10,11,12,13,14,16,18,19,20,21,28,30],outcom:[1,3,4,5,6,12,15,21],outer:[3,5],outfilenam:1,outgo:[11,20],outlier:[2,3],outlin:[3,6,15],output:[0,2,3,4,5,7,8,16,17,29,31],output_bia:5,output_bias_gradi:5,output_weight:5,output_weights_gradi:5,outputlayer1:5,outputlayer2:5,outward:[9,11,12,18,20,21],over:[0,1,2,3,5,6,7,8,9,10,11,15,16,17,18,19,20],overal:[5,11,20],overarch:[0,8,17],overcom:[5,8,17],overdetermin:3,overfit:[3,5],overflow:5,overhead:5,overlin:[2,3,7,16],overst:[0,2],overview:[0,23],owe:0,own:[0,2,5,6,9,10,12,15,18,19,21,23],owner:3,oxid:3,p_0:[11,20],p_0b:[11,20],p_0b_:[11,20],p_2:[9,18],p_f:[11,20],p_fr:[11,20],p_i:1,p_j:1,p_n:1,p_x:[1,9,18],pack:2,packag:[0,1,3,5,10,19],page:[2,26,28,29,31],pai:5,painless:2,paint:[11,20],pair:[1,2,3,8,17],panda:[9,10,11,18,19,20],panel:[2,7,16],paper:[5,6,15,23],paradigm:[0,2],parallel:[2,7,8,9,11,16,17,18,20],paramet:[0,1,2,5,7,11,16,20],parameter:[0,3,8,10,17,19],parametr:[2,3],pari:[12,21],park:1,part:[0,1,2,3,5,6,7,10,11,12,15,16,19,20,21,23,25],partform:[10,19],partial:[1,3,4,5,8,9,17,18],partial_:[9,18],partial_i:[9,18],partial_r:[11,20],partial_ru:[11,20],partial_ru_:[11,20],partial_tv:[9,18],partial_x:[9,10,18,19],partial_xv:[9,10,18,19],partial_yv:[9,18],partial_z:[9,18],partial_zv:[9,18],particip:[11,20,24],particl:[1,2,3,8,9,10,11,12,17,18,19,20,21,23],particular:[0,1,2,3,5,6,7,8,10,11,15,16,17,19,20,23],particularli:[1,3,6,10,15,19],partit:5,partli:3,paslei:[29,31],pass:[1,10,11,19,20],passeng:0,past:1,patch:[1,3,7,16],path:[2,3,7,8,9,10,11,12,16,17,18,19,20,21,29,31],patient:4,pattern:[0,2,5,12,21,29,31],pauli:2,pavement:[8,17],pca:3,pdf:[0,2,3,7,16,23],pedagog:[3,6,15],pen:[6,15],penal:3,penalti:3,pencil:[6,15,23],pend1:[8,10,17,19],pend2:[8,10,17,19],pendulum:23,penros:3,peopl:[0,3,5],per:[2,3,6,7,11,12,15,16,20,21],perceiv:0,percentag:[3,23],perceptron:[2,4],peregrin:[2,7,16],perfect:[2,3,5,11,20],perfectli:[3,8,17],perform:[1,2,7,8,9,10,11,12,16,17,18,19,20,21],perhap:[0,2,3,8,9,17,18],period:[5,8,11,12,17,20,21],perman:24,permiss:24,permut:[9,18],perp:[11,20],perpendicular:[8,11,12,17,20,21],person:[4,24],perspect:[9,18],pertain:[7,16],pertin:[5,6,15],perturb:[11,20],petersen:1,phantom:1,phase:[3,5,8,10,12,17,19,21],phasespac:[11,20],phenomena:[1,10,19],phi:[7,8,9,10,11,16,17,18,19,20],phi_a:[12,21],phi_b:[12,21],philosophi:[10,19],phone:23,phonon:[10,19],phrase:0,phy321:31,physic:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,24],physics321:23,piazza:23,pick:[1,5,10,19],pictur:[0,2,10,19],pie:[2,7,16],piec:[5,9,11,18,20],pillow:[2,7,16],pinv:3,pip3:[2,5,7,16],pip:[2,5,7,16,26],pipelin:[2,3],pippin:[2,7,16],pitfal:[9,18],pitt:5,pixel:5,pixel_height:5,pixel_width:5,place:[2,3,7,11,12,16,20,21],placehold:5,plai:[0,2,3,8,9,10,17,18,19],plain:5,plan:[3,23],plane:[7,11,12,16,20,21],planet:[11,20],planetari:[11,20],plateau:1,platform:[2,7,16],plausibl:5,pleas:[23,25],plenti:5,plethora:5,plot:[1,2,3,4,5,6,7,8,9,10,11,13,14,15,16,17,18,19,20,30],plot_count:3,plt:[1,2,3,4,5,6,7,9,10,11,13,14,15,16,18,19,20,30],plu:[2,10,12,19,21],plug:[8,10,11,17,19,20],png:[2,3,7,9,10,11,16,18,19,20],point:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21],poisson:0,polar:[9,10,11,12,18,19,20,21],pole:[12,21],poli:3,polici:24,polit:[0,24],poly3:2,poly3_plot:2,polydegre:3,polym:5,polynomi:[0,2,3,4,9,18],polynomial_featur:3,polynomialfeatur:[2,3],polytrop:3,poor:5,popul:[2,3],popular:[0,1,2,3,5,7,10,16,19],popularli:2,pose:[0,1],posit:[1,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21,24],possess:[12,21],possibl:[0,1,2,3,4,5,6,7,8,9,10,15,16,17,18,19,25],post:[13,14,23,24,25,30],postpon:[3,7,16],potenti:[0,2,3,5,6,7,8,9,10,15,16,17,18,19,23],pott:5,power:[2,3,5,6,8,10,15,17,19,29,31],practic:[1,3,4,11,20],practition:[2,5],pre:[29,31],preced:[1,5],precess:[12,21],precis:[0,1,2,3,7,9,11,16,18,20],precmess:[12,21],pred:3,predict:[0,2,3,4,5,7,12,16,21,29,31],predict_prob:5,predictor:[2,3,4],prefer:[2,5,10,19],prepar:[2,7,16],preprocess:2,prerequisit:[0,2],presenc:[8,10,17,19],present:[0,1,2,3,5,6,9,15,18],pressur:[12,21],pretti:[2,7,16],prevent:1,previou:[1,3,5,7,8,10,11,16,17,19,20],previous:1,price:3,primari:[0,4],prime:[1,9,10,18,19],princip:[3,10,19],principl:[2,3,4,8,12,17,21],print:[1,2,3,5,7,9,11,16,18,20,29,31],printout:[3,7,16],prior:[0,2,3],prioriti:0,privaci:0,privat:[0,2,24],privileg:[7,16],pro:23,prob:1,probabilist:3,probabl:[2,3,4,5,11,20],problem:[0,1,2,4,6,7,8,10,12,15,16,17,19,21,23],proce:[0,2,3,10,11,19,20],procedur:[12,21],proceed:[8,17],process:[0,1,2,3,6,7,8,15,16,17,23,26],prod_:[4,5],produc:[0,1,2,3,5,6,7,12,15,16,21],product:[2,3,4,5,7,9,11,16,18,20],profess:3,profession:24,profound:[9,18],program:[1,2,3,5,6,7,8,10,15,16,17,19],progress:5,prohibit:3,project:[0,1,2,3,5,6,12,15,21,23,24,25,26],project_root_dir:[2,3,7,9,10,11,16,18,19,20],promin:5,pronounc:[2,7,16],proof:[3,5,9,18],prop:3,prop_cycl:[13,14,30],proper:[0,2,3],properli:[5,6,15,29,31],properti:[2,5,7,8,12,16,17,21],proport:[1,2,3,5,8,10,17,19],propos:[5,25],propto:[11,20],protect:0,proton:[2,11,20],prove:[12,21],provid:[1,2,3,5,6,7,8,10,11,12,15,16,17,19,20,21],proxi:5,pseudoinvers:3,pseudorandom:1,psycholog:[0,2],ptratio:3,pub:23,publish:24,pull:[11,20,23,25,26],pulsar:5,punish:[0,2,5],pure:[1,10,11,19,20],purpos:[0,2,5,6,8,10,15,17,19,29,31],push:[12,21,25,26],put:[10,11,19,20],puzzl:[8,17],pycod:[2,7,16],pyhton2:[2,7,16],pylab:[2,7,10,16,19],pyplot:[1,2,3,4,5,6,7,9,10,11,13,14,15,16,18,19,20,30],python3:[2,3,7,16],python:[0,3,5,6,8,10,15,17,19,23],pytorch:[0,2,5,7,16],qbv_x:[8,17],qbv_y:[8,17],qquad:[2,7,16],quad:5,quadrat:[2,8,10,11,17,19,20],qualit:1,qualiti:[0,2,6,7,8,10,15,16,17,19],quantifi:[5,11,20],quantit:[0,3],quantiti:[1,2,3,4,5,8,9,10,12,17,18,19,21],quantum:[0,5,9,10,18,19],quartil:3,question:[0,3,5,7,8,10,16,17,19,23],quick:[1,6,15],quickli:[9,10,11,12,18,19,20,21],quit:[3,5],quitecompl:[11,20],quot:1,r2_score:[2,3],r2score:2,r_1:[10,19],r_1t:[10,19],r_2:[10,11,19,20],r_2t:[10,19],r_h:[9,18],r_i:[9,18],rab:[9,11,18,20],race:24,rad:3,radial:[3,5,9,11,12,18,20,21],radialeqofmot:[11,20],radialeqofmotion2:[11,20],radialgvv:[11,20],radialhovv:[11,20],radii:[11,20],radio:[10,19],radioact:1,radiu:[3,8,11,12,17,20,21],rais:3,ramsai:[29,31],ran1:1,ran2:1,ran3:1,rand:[1,2,3,7,16],rand_max:1,randint:3,randn:[2,3,5,7,13,14,16,30],random:[0,2,3,5,7,11,13,14,16,20,30],random_devic:1,random_indic:5,random_st:3,randomli:[1,3,5],randomnumbergener:1,rang:[1,2,3,4,5,6,7,8,9,10,11,13,14,15,16,17,18,19,20,30],rangl:[1,3],rangle_x:1,rank:3,raphson:5,rapidli:[0,2,12,21],rare:[8,17],rate:[3,5,9,11,12,18,20,21],rather:[0,1,2,3,4,5,8,9,10,11,12,17,18,19,20,21],ratio:[4,10,11,19,20],rational:2,ravel:3,raw:1,rawdata:[7,16],rbf:5,rcond:3,rcparam:[1,2,5,7,10,13,14,16,19,30],rdotdot:[11,20],rdr:[10,19],reach:[1,3,5,8,9,11,17,18,20],reaction:[8,9,17,18],read:[0,1,3,5,6,7,8,9,10,15,16,17,18,19,23],read_csv:3,read_fwf:[2,3],reader:[0,1,2,7,16],readi:[2,5,6,7,15,16,25],readili:5,real:[3,4,5,6,7,10,11,12,15,16,19,20,21],realist:[6,15],realiti:[1,12,21],realiz:[5,10,11,19,20],realli:[2,5,8,17],reason:[0,3,5,6,12,15,21,24],rebenstock:23,recal:[1,2,3,5,7,12,16,21],recalcul:1,recast:[8,10,17,19],receiv:[1,5,10,19],recent:[0,2,3],recept:5,recip:[2,3,4,7,16],recogn:[2,11,20,26],recognit:[0,2,5],recommend:[1,2,3,7,9,16,18,23,26],record:[8,17],recov:[7,16],recreat:1,rectangl:3,rectifi:5,rectilinear:[12,21],recur:[0,2],recurs:[2,7,16],recycl:1,red:[2,3],redefin:3,reduc:[2,5,8,10,11,17,19,20],reduce_mean:5,reduct:[1,2,3],refactor:[6,15],refer:[0,2,3,5,6,8,10,11,12,15,17,19,20,21,23,29,31],refin:5,refit:3,reflect:[0,1,2,5,6,15],reformul:[8,17],regard:[5,24],regardless:[5,11,20,24],region:[5,6,12,15,21],regist:1,regr_1:2,regr_2:2,regr_3:2,regress:[0,5],regressor:[3,4],regular:[4,12,21,29,31],regularizer_loss:5,regularizer_loss_fc1:5,regularizer_loss_fc2:5,regularizer_loss_out:5,reinforc:[0,2],reject:24,rel:[0,1,2,3,4,5,6,8,9,10,12,15,17,18,19,21,23,29,31],relat:[0,1,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21,23],relationship:[0,2,3,12,21],relatist:[12,21],relativeerror:[3,6,15],relativist:[8,10,17,19],releas:[2,5,7,16,25],relev:[1,2,3,6,7,15,16],reli:[0,2,3,8,17],reliabl:[1,4,9,18],religion:24,remain:[1,3,5,8,10,17,19],remaind:1,remark:[5,12,21],rememb:[2,7,10,16,19,25],remind:[0,1,3,6,8,10,11,12,15,17,19,20,21],remov:[3,24,26],render:[2,3,7,16,26,29,31],reorder:4,reorgan:[2,7,16],repeat:[1,2,3,5,7,8,9,10,11,12,16,17,18,19,20,21],repeated:0,repeatedli:[1,3,10,19],repel:[11,20],repercuss:24,repetit:3,rephras:[8,17],replac:[2,3,5,6,7,9,10,11,15,16,18,19,20,23],replica:3,repo:[25,26],report:[6,15,24],repositori:[0,26],repres:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,24],represent:[0,1,3,5,10,19,24],reproduc:[0,1,2,5,6,11,13,14,15,20,23,25,30],repuls:[2,11,20],request:[0,2,25,26],requir:[2,3,5,6,7,8,10,11,15,16,17,19,20,26],resampl:[0,1],rescal:[3,5],research:[0,2],resembl:[1,3,12,21],reserv:[1,3,5],reset:1,reshap:[2,3,5,7,16],residenti:3,residu:3,resist:[9,10,18,19,23],reson:23,respect:[0,1,2,3,4,5,6,7,8,10,12,15,16,17,19,21,24],respond:[5,24],respons:[3,4,5,8,12,17,21],rest:[3,7,8,10,11,12,16,17,19,20,21,29,31],restat:[3,5],restor:[8,17],restrict:[0,5,12,21],result:[0,1,2,4,5,6,7,9,10,11,12,15,16,18,19,20,21,23,29,31],ret:3,retail:3,retain:[3,9,18],rethink:3,reus:[9,10,18,19],reveal:[0,5],revers:[5,11,20],revert:[7,16],review:24,revis:[5,7,16],revisit:[10,19],reward:[0,2],rework:5,rewrit:[1,2,4,5,7,8,9,10,11,12,16,17,18,19,20,21],rewritten:[1,3,11,20],rho:[3,11,12,20,21],rho_m:[8,17],rho_ma:[8,17],rhs:[7,16],rich:[0,2],ridg:[2,4],ridge_sk:3,right:[1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,24],rightarrow:[1,3,5,7,8,9,10,11,12,16,17,18,19,20,21],rigid:[12,21],rigor:[0,2,12,21],ring:[3,11,20],rise:[3,12,21],risk:2,river:3,rk2:[10,19],rk4:[10,19],rmin:[11,20],rminofa:[11,20],rmse:3,rnn:5,rntrick1:1,rntrick2:1,rntrick3:1,rntrick4:1,road:0,robert:[29,31],robust:2,robustscal:3,rocket:[9,18],role:[0,2,3,9,18],rolenam:[29,31],roll:[3,10,19],room:[0,2,3,23],root:[0,1,2,3,10,19],rot:[2,7,16],rotat:[7,8,9,11,16,17,18,20,23],roughli:[5,11,20],round:[3,12,21],routin:[2,7,16],row:[2,3,5,7,16],rp_f:[11,20],rrr:3,rtotheta:[11,20],rule:[3,6,7,11,12,15,16,20,21,23],run:[0,2,3,5,6,7,8,11,15,16,17,20,26,29,31],rung:23,runner:[7,16],runtim:[3,5],runtimewarn:5,rust:2,ruthtraj:[11,20],rvert:5,rvert_2:5,rwidth:3,s_0:[12,21],s_1:3,s_h:[9,18],s_i:[3,4],s_j:3,s_k:3,safe:1,sai:[0,1,2,3,4,5,7,8,11,12,16,17,20,21],said:3,sake:[2,3,4],sale:2,sam:[2,7,16],same:[1,2,5,7,8,9,10,11,12,16,17,18,19,20,21,29,31],sampl:[0,2,3,4,5,11,12,13,14,20,21,28,30],sampleexptvari:1,sampler:0,samwis:[2,7,16],sanitize_sequ:3,satisfactori:2,satisfi:[1,3,5,8,10,11,17,19,20],satur:[3,5],save:[2,3,6,7,9,10,11,15,16,18,19,20],save_fig:[2,3,7,9,10,11,16,18,19,20],savefig:[1,2,3,7,9,10,11,16,18,19,20],saw:[9,10,18,19],scalar:3,scale:[2,3,4,5,6,7,11,15,16,20,23],scaler:3,scan:4,scatt:[11,20],scattangl:[11,20],scatter:[2,3,7,16,23],scenario:3,scheme:[5,7,16],schrage:1,sci:23,scienc:[0,1,2,5,6,7,15,16,23],scientif:[0,2,6,7,15,16,23],scientist:[0,2],scikit:[0,7,16],scikitlearn:2,scipi:[2,3,7,10,16,19],scl:3,scope:[5,25],score:[2,3,5,23],scores_kfold:3,sea:[12,21],seaborn:[2,3,5,7,10,16,19],seamless:[2,7,16],search:[2,5,8,11,17,20],seat:[12,21],sec:3,second:[0,1,2,3,4,5,7,9,10,11,12,16,18,19,20,21,23],secondli:[5,10,19],section:[1,7,8,10,12,16,17,19,21,22,23,27],sector:[0,2],secur:0,see:[0,1,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,23,26,29,30,31],seed:[1,2,3,5,7,13,14,16,30],seek:5,seem:[5,10,11,19,20],seemingli:2,seen:[0,1,2,3,5,6,8,11,12,15,17,20,21],seismic:3,seldomli:[2,6,15],select:[2,3,5,7,16],self:[0,1,3,5,6,15],semilogx:3,send:[5,23,25],sens:[0,3,8,17],sensit:[2,3],sensor:0,sent:23,sentenc:5,separ:[1,2,3,5,7,8,10,11,16,17,19,20,24],septemb:3,sequenc:[1,2,4,5,7,16],sequenti:[1,5],seri:[0,2,3,5,7,16,23],serif:[1,2,7,10,16,19],seriou:0,serv:[0,2,4,5,29,31],sess:5,session:[5,23],set:[0,1,2,4,6,7,9,10,11,12,15,16,18,19,20,21,24,25],set_:3,set_label:3,set_titl:[2,4,5],set_xlabel:[2,3,4,5,7,9,10,11,16,18,19,20],set_xlim:[4,5,7,9,10,16,18,19],set_ylabel:[2,3,5,7,9,10,11,16,18,19,20],set_ylim:[4,5],set_yticklabel:3,setiosflag:1,setminu:3,setp:3,setprecis:1,setup:[2,3,5,7,12,16,21,25],setw:1,sever:[0,1,2,3,4,5,6,7,9,10,15,16,18,19,23],sexist:0,sexual:24,sgd:5,shape:[2,3,5,6,7,11,12,15,16,20,21],share:[0,2,5,7,16],she:4,shift:[1,5],shire:[2,7,16],shock:[10,19],shorter:1,shorthand:[2,7,9,16,18],shortli:[2,7,8,16,17],should:[0,2,3,7,8,9,10,11,12,16,17,18,19,20,21,23,26],show:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,24],shown:[1,5,8,9,17,18],showpoint:1,shrink:3,shrinkag:3,shuffl:[3,5],side:[3,5,7,8,11,12,16,17,20,21],sigh:[2,7,16],sigma0:1,sigma1:1,sigma2:1,sigma:[1,2,3,4,5,11,20],sigma_1:3,sigma_2:3,sigma_:[1,2,3,11,20],sigma_fn:[4,5],sigma_i:[2,3],sigma_j:3,sigma_m:1,sigma_n:1,sigma_x:1,sigmoid:4,sign:[1,4,5,8,11,12,13,14,17,20,21,23,30],signal:[5,10,19],signific:[5,12,21],significantli:[1,5,8,10,17,19],sim:[1,3,11,20],similar:[0,2,3,4,6,10,11,15,19,20,23,29,31],similarli:[1,2,3,5,7,10,11,12,16,19,20,21],simpl:[0,4,6,8,10,11,12,15,17,19,20,21],simpler:[0,2,5,6,8,9,15,17,18],simplest:[0,2,3,5,7,9,10,12,16,18,19,21,29,31],simpli:[1,2,3,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21],simplic:[3,4,5,7,8,11,16,17,20],simplicti:[10,19],simplifi:[0,2,3,7,11,16,20],simplist:1,simpson:23,simul:[0,1,3,8,17],simultan:3,sin:[2,3,5,7,8,9,10,11,12,16,17,18,19,20,21],sinc:[0,1,2,3,4,5,6,7,8,9,12,15,16,17,18,21],sine:[5,10,19],singl:[1,2,4,5,7,9,10,11,12,16,18,19,20,21,23],singular:0,sit:[10,12,19,21],site:[0,2,3],situat:[0,2,3,4,6,10,11,12,15,19,20,21],six:1,size:[1,2,5,7,8,9,10,11,16,17,18,19,20,24],sketch:[8,11,17,20],skill:[0,2,6,15,23],skl:[2,3],sklearn:[2,3,5],slice:[2,7,16],slide:[1,3,23],slight:[3,29,31],slightli:[1,3,4,5,8,9,12,17,18,21],slope:[5,7,16],sloppi:[8,17],slow:[3,8,17],slower:[2,3,7,12,16,21],slowli:5,slp:5,small:[1,2,3,5,8,9,10,11,12,17,18,19,20,21,23,28,29,31],smaller:[1,2,3,5,9,11,18,20],smallest:[2,7,16],smart:3,smooth:3,sneak:3,sns:[2,3,5],soar:3,social:[0,2,24],societ:0,societi:[0,6,15],sofist:0,soft:[4,5],softmax:4,softmax_cross_entropy_with_logits_v2:5,softmax_loss:5,softwar:[0,6,15,23],sole:[0,2,3],solid:[0,2,4,10,11,19,20],solut:[1,3,5,6,8,9,10,12,15,17,18,19,21,23],solv:[0,2,3,5,6,9,11,12,15,18,20,21,23],solver:[8,17],some:[0,1,4,5,6,8,9,10,11,12,13,14,15,17,18,19,20,21,23,29,30,31],someth:[0,1,5,8,17],sometim:[3,5,11,20],somewher:[11,20],soon:[3,7,10,12,16,19,21],sophist:[0,2],sort:[1,3],sound:[0,6,10,15,19],sourc:[0,1,2,3,5,6,7,8,10,11,15,16,17,19,20,26],south:[12,21],southern:[12,21],sovl:[9,18],space:[1,3,5,8,10,12,17,19,21,23,24],spacetim:[12,21],span:[0,2,3,7,16,29,31],spare:5,spars:[2,3],sparse_mtx:2,spartan:[11,20],spatial:[5,7,10,16,19],speak:1,speci:[11,20],special:[1,2,3,4,5,6,7,8,12,15,16,17,21],specif:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,24,29,31],specifi:[0,1,2,3,4,7,8,12,16,17,21],specifici:2,speech:[0,2,5],speed:[5,8,9,17,18],spell:[9,18],spend:1,sphere:[3,11,20],spheric:[11,20],sphinx:[29,31],spin:[3,9,18],spite:[0,2],split:[0,1,2,5,9,18],spontan:[1,9,18],sprai:[11,20],spread:[1,3,11,20],spring2020:23,spring:[8,10,11,17,19,20,31],springer:23,springforc:[10,19],spuriou:[12,21],sqrsignal:[10,19],sqrt:[1,3,7,8,9,10,11,12,16,17,18,19,20,21],squar:[0,1,2,4,5,7,8,10,11,16,17,19,20],squash:5,srand:1,stabil:[8,10,17,19],stabl:[2,3,9,11,18,20],stack:3,stadium:[11,20],stage:[0,8,10,17,19],stai:[2,3,8,9,10,11,12,17,18,19,20,21],stand:[0,2,3,5,7,12,16,21,29,31],standard:[0,2,3,4,5,7,8,11,12,16,17,20,21],standardscal:3,standpoint:[6,15],start:[0,1,3,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,23,28],startpoint:1,stat:3,state:[0,1,2,4,5,7,8,9,10,11,12,13,14,16,17,18,19,20,21,30,31],statement:[0,2,7,16],station:[10,19],statis:3,statist:[0,2,4,5,7,8,16,17],statu:[3,4],std:[1,2,3,7,16],stddev:5,stdev:1,steadi:[10,19],step:[1,2,4,5,7,10,11,12,16,19,20,21,25],step_fn:[4,5],stepsiz:[6,15],sthetover2:[11,20],still:[1,3,8,11,17,20],stimuli:5,stochast:[0,3,5],stock:0,stoke:5,stone:[2,4],stop:[1,5,7,8,16,17],storag:3,store:[1,2,5,7,16,29,31],str:5,straight:[0,2,3,8,12,17,21],straightforward:3,strategi:[0,5,8,9,11,17,18,20],stratifi:3,stream:5,strength:[2,3,10,19],stretch:[8,11,17,20],strictli:[8,17],strike:[3,11,20],string:[1,5],stroke:4,strong:[1,5,10,11,19,20],strongli:[0,2,3,7,11,16,20],stronli:3,structur:[0,2,3,5,6,7,15,16,23,28,29,31],stuck:5,student:[0,2,6,15],studi:[0,2,3,5,6,7,8,11,12,15,16,17,20,21,23],style:[2,7,10,16,19],sub:5,subdivid:[0,2,7,8,9,16,17,18],subfield:[0,2],subinterv:[9,18],subject:[1,3],subplot:[2,3,5,7,9,10,11,13,14,16,18,19,20,30],subplots_adjust:1,subprogram:[2,7,16],subroutin:2,subscript:[5,7,9,12,16,18,21],subsect:[10,19],subsequ:[1,3,5],subset:[2,3,5,7,16],subspac:3,substitut:[3,5,8,9,10,11,12,17,18,19,20,21],subtend:[11,20],subtl:5,subtract:[1,3],succeed:2,success:[1,4],sucess:1,sudden:[10,19],suddenli:[12,21],sudo:[2,7,16],suffer:[3,5],suffic:[7,16],suffici:[3,5,10,11,12,19,20,21],suggest:5,suit:[5,10,19],suitabl:[1,3],sum:[1,2,4,5,8,9,10,11,17,18,19,20],sum_:[1,2,3,4,5,8,9,10,11,17,18,19,20],sum_i:[3,9,10,12,18,19,21],sum_ia_i:[12,21],sum_im_i:[9,18],sum_im_ix_i:[9,18],sum_j:3,sum_k:[2,3,5,7,16],sum_n:[10,19],sum_nx_:[10,19],summar:3,summari:[5,23],summat:3,sun:[8,11,17,20,23],superscript:5,supervis:[0,2,3,4],supplement:[4,12,21],support:[0,3,5],suppos:[0,2,3,4,5,7,8,12,16,17,21],supposedli:0,sure:[3,5,13,14,30],surfac:[2,8,9,11,12,17,18,20,21],surpass:3,surpris:2,surprisingli:[11,20],surround:[11,20],surv:0,survei:[0,2],svdinv:3,sweep:[8,17],swift:0,swing:[10,19],symbol:[1,2,5,6,7,8,9,15,16,17,18,23],symmetr:[0,2,3,5,7,11,12,16,20,21],symmetri:[3,10,19],sympi:[2,6,7,9,15,16,18],symplect:[9,18],synonim:1,syntax:[2,7,16,29,31],syntaxerror:[2,7,16],system:[0,2,3,4,5,6,7,10,11,15,16,19,20,23,25],systemat:[1,3],t_0:[7,16],t_f:[7,8,16,17],t_h:[9,18],t_i:[5,7,8,9,10,16,17,18,19],t_j:5,t_n:[9,18],t_x:[12,21],t_y:[12,21],tab:[10,19,26],taberror:[10,19],tabl:[1,2,7,16],tabul:2,tabular:[2,7,16],tag:[1,3,4,5,8,9,10,11,12,17,18,19,20,21,25],taht:2,tail:1,tailor:2,taiwan:3,take:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,24],taken:[2,3,5,7,16],takeoff:[12,21],tan:[10,19],tangent:[5,12,21],tanh:[4,5,7,16],target:[2,3,5,11,20],task:[0,2,3,5],tau:[1,9,10,18,19],tau_z:[9,18],taught:[0,6,15],tax:3,taxpay:0,taylor2:23,taylor:[7,8,9,10,11,16,17,18,19,20,23],tba:23,tdt:[7,16],teach:[6,15],team:[5,24],teaser:2,techniqu:[0,1,2,3,5,6,7,8,9,15,16,17,18],technolog:[0,2,5],tediou:[6,11,15,20],tell:[1,3,8,9,10,17,18,19],temperatur:3,templat:26,tempor:[10,19],temporari:24,temporarili:24,ten:[2,7,16],tend:[3,5,8,11,12,17,20,21],tendenc:2,tension:[3,12,21],tensorboard:5,tensorflow:[0,2,7,16],term1:3,term2:3,term3:3,term4:3,term:[1,2,3,4,6,7,8,9,10,11,12,15,16,17,18,19,20,21,25],termin:[3,8,17],test:[0,1,2,6,8,11,15,17,20,26],test_accuraci:5,test_error:3,test_ind:3,test_loss:5,test_pr:5,test_predict:5,test_siz:[3,5],testerror:3,tex:[13,14,30],text:[1,2,3,5,7,10,16,19,23,29,31],textbook:[8,17],tfinal:[7,9,10,11,16,18,19,20],than:[1,2,3,4,5,7,8,10,11,12,16,17,19,20,21],theano:[2,5,7,16],thei:[0,1,2,3,4,5,6,7,8,10,11,12,15,16,17,19,20,21,23,24,25,29,31],them:[0,2,5,6,7,10,12,15,16,19,21],theme:2,themselv:[1,2],thenc:3,theorem:[3,9,18,23],theoret:[3,8,17],theori:[0,2,5,8,10,17,19],thereaft:[2,3,5,7,10,12,16,19,21],therebi:[0,1,2,4,7,10,12,16,19,21],therefor:[1,2,3,4,5,10,11,19,20],thereof:[0,2,3],theta:[1,3,5,8,9,10,11,12,17,18,19,20,21],theta_0:[8,11,17,20],theta_:[5,11,20],theta_i:5,theta_k:1,thi:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,24,25,26,27,28,29,30,31],thick:[11,20],thin:[11,20],thing:[1,3,5],think:[0,1,3,5,6,8,10,11,12,15,17,19,20,21,23],third:[0,2,3,7,9,10,11,12,16,18,19,20,21],those:[2,3,7,8,9,10,11,12,16,17,18,19,20,21,29,31],though:[0,1,5,8,10,11,17,19,20],thought:[1,3,11,12,20,21],thousand:[0,2,3,5],threaten:24,three:[0,2,3,5,7,9,10,12,16,18,19,21],threshold:5,through:[0,1,2,3,5,6,7,8,9,11,12,15,16,17,18,20,21,23,25],throughout:[0,1,2,3,7,16],thrown:[8,17],thu:[0,1,2,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21,23],thumb:3,thursdai:23,tick_param:3,ticker:1,tidal:[12,21],tide:[11,20],tight_layout:[7,9,10,11,16,18,19,20],tild:[1,2,3,10,19],till:[3,4,5,7,8,12,16,17,21],time:[1,2,3,4,5,6,8,9,10,11,12,15,17,18,19,20,21,23,29,31],timefunct:1,tiniti:[7,16],tip:[22,27],tire:[8,17],titl:[1,2,3,5],to_categor:5,to_categorical_numpi:5,to_numer:[2,3],to_str:1,todai:0,togeth:[2,3,11,12,20,21],toler:[8,17],tomographi:5,too:[1,3,8,17],took:[2,7,16],tool:[0,1,2,3,5,6,7,15,16,29,31],top:[2,3,6,7,12,15,16,21],topic:[0,2,3,4,6,15,23],topolog:5,torqu:[8,9,10,17,18,19],tot:[11,20],total:[1,3,4,5,8,9,10,11,17,18,19,20,23],totalvari:1,tout:0,toward:[4,5,10,11,12,19,20,21,24],town:3,tqdm:3,traceback:3,track:[5,7,11,16,20],tract:3,tractabl:[0,3],traction:0,trade:3,tradeoff:0,tradit:[0,2,3,5],tradition:[6,15],train:[0,2,6,8,12,15,17,21],train_accuraci:[2,5],train_end:5,train_error:3,train_ind:3,train_loss:5,train_pr:5,train_siz:5,train_test_split:[2,3,5],train_test_split_numpi:5,trainabl:5,trainingerror:3,trait:[0,2],trajectori:[8,9,10,11,17,18,19,20],transcendent:[8,17],transform:[3,4,5,11,20,23],transit:[3,5],translat:[5,9,10,18,19],translation:[9,18],transpos:[3,5],transvers:[11,20],trapez1:[9,18],trapez:[6,9,15,18],trapezoid:[6,15,23],trapoezoid:[9,18],travel:[8,11,17,20],treat:[1,3,5,10,11,12,19,20,21],tree:[0,5,23],trend:1,tri:[8,17],trial:[0,1,2,3],triangular:[2,7,16],trick:[1,11,12,20,21],trickier:[1,7,16],tridiagon:[2,7,16],trivial:[1,3,5,11,20],troll:24,troubl:[3,5],troubleshoot:25,true_divid:5,true_fun:3,truncat:[7,10,16,19],truncated_norm:5,trust:[8,9,17,18],truth:0,tumor:4,tune:[2,7,10,16,19],turn:[0,1,2,3,5,6,8,9,10,12,15,17,18,19,21],tutori:5,tweak:[1,5],twice:[7,11,16,20],twister:1,two:[0,1,2,3,5,7,9,10,12,16,18,19,21,23,29,31],twoard:[12,21],txt:26,type:[0,1,3,7,8,9,10,16,17,18,19,23],typeset:[6,15],typic:[0,1,2,3,4,5,8,9,10,11,17,18,19,20],u_i:5,ubuntu:[2,7,16],uci:3,ugli:[10,19],unaccept:24,unari:[2,7,16],unbalanc:3,unbias:[1,2,3],unbound:[11,20],uncertainti:[3,8,17],uncertitud:1,unchang:[5,9,18],uncov:5,undamp:[10,19],undefin:3,under:[2,3,5,7,8,9,11,16,17,18,20],underdetermin:3,underfit:[3,5],undergo:[6,8,11,15,17,20],undergradu:0,underli:[0,1,2,5,6,15],understand:[0,2,5,6,8,15,17,23],understood:[8,11,17,20],undriven:[8,10,17,19],unexpect:[1,3],unexpected:1,unfortun:[5,8,17],uniform:[0,2,3,5,8,17],uniform_real_distribut:1,uniformli:[1,11,12,20,21],unifrompdf:1,union:3,uniqu:[0,2,3,6,15],unit:[1,2,3,5,6,8,9,10,12,15,17,18,19,21],unitari:[2,3,7,16],unitarili:[2,7,16],uniti:[1,10,19],univ:23,univari:1,univers:[0,31],unix:5,unknow:3,unknown:[3,5,10,19],unknowwn:5,unlabel:5,unless:[2,3,8,9,10,12,17,18,19,21],unlik:[1,5],unlimit:[9,18],unravel:5,unscatt:[11,20],unseen:4,unstabl:[5,11,20],unsupervis:[0,2,5],unsymmetr:[2,7,16],until:[1,5,10,19],unusu:5,unwelcom:24,updat:[3,5,7,9,10,11,16,18,19,20],upgrad:[8,17],upon:[0,5,8,12,17,21],upper:[2,3,7,9,16,18],uppercas:[1,2,7,16],ups:2,upward:[8,12,17,21],usag:[0,1,2,3,7,16],usain:[8,17],uscibook:23,usd10000:3,usd:3,use:[0,2,3,4,6,7,8,9,10,11,12,15,16,17,18,19,20,21,23,24,25,29,31],usecol:[2,3],used:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,23,29,31],useful:[0,1,2,4,5,7,8,9,10,11,12,16,17,18,19,20,21,23],useless:5,user:[2,4,5,6,7,8,15,16,17],uses:[1,2,3,5,7,9,10,11,16,18,19,20,29,31],usetex:1,using:[0,3,6,7,8,9,10,11,12,15,16,17,18,19,20,21,23,24,25,26],usr:1,usual:[2,4,5,8,11,12,17,20,21],util:[2,3,5],utliz:[9,18],utmost:0,v_0:[7,8,9,10,16,17,18,19],v_1:[9,18],v_e:[9,18],v_i:[7,8,9,16,17,18],v_jb_k:[8,17],v_n:[9,18],v_t:[7,8,16,17],v_x:[8,9,12,17,18,21],v_xf_x:[9,18],v_y:[8,9,17,18],v_yf_i:[9,18],v_z:[8,9,12,17,18,21],v_zf_z:[9,18],v_zt:[8,17],valid:[0,1,5,6,8,15,17,29,31],valu:[0,2,4,5,6,7,8,9,10,11,15,16,17,18,19,20],van:3,vandermond:3,vanish:[1,5],var_x:1,varepsilon:3,varepsilon_:3,varepsilon_i:3,vari:[3,5,7,12,16,21],variabl:[2,3,4,5,7,9,11,12,16,18,20,21,23],varianc:[0,2,4,5],variance_i:3,variance_x:3,variant:[2,3,5,6,7,15,16],variat:[9,18,23,29,31],varieti:[0,2,5,7,16],variou:[0,1,2,4,5,6,7,9,10,12,15,16,18,19,21,23],vartempvec:1,varvec:1,vaverag:[7,16],vdt:[8,17],vec:[1,3],vecto:[9,18],vector:[4,8,9,11,12,17,18,20,21,23],vehicl:[12,21],veloc:[8,10,11,12,17,19,20,21,23],velocityverlet:[10,19],ventur:[0,2,6,7,9,15,16,18],verbos:5,veri:[0,1,2,3,5,7,8,9,10,12,16,17,18,19,21,23,29,31],verif:[6,15,23],verifi:[2,6,7,8,10,15,16,17,19],verlet:[10,11,19,20,23],versa:[9,18],versatil:[2,6,7,15,16],version:[0,1,2,7,10,11,16,19,20,24,25,26],versu:[5,11,20],vert:[2,3,4,5,7,16],vert_1:3,vert_2:3,vert_:[9,18],vertic:3,via:[0,1,2,3,5,6,7,8,9,10,15,16,17,18,19,24],vibrat:[11,20],vice:[9,18],video:[5,23],view:[0,1,2,5,6,7,9,12,15,16,18,21,23],viewpoint:24,viridi:[2,5],virtual:[5,26],virtualenv:25,viru:23,viscos:[8,10,17,19],viscou:[8,10,17,19],vision:[0,2],visual:[0,2,3,10,19],viz:[1,3],vmax:3,vmc:1,vmin:3,volcano:[12,21],voltag:[11,20],volum:[2,8,11,17,20],volunt:25,vstack:[1,2,3],w_fc1:5,w_fc2:5,w_i:5,w_ix_i:5,w_out:5,wai:[0,1,2,3,4,5,6,7,9,15,16,18,22,24,25,27],walker:1,wang:2,want:[0,1,2,3,5,7,8,10,12,13,14,16,17,19,21,25,30],warrant:3,water:[11,12,20,21],wave:[10,19],wealth:[0,6,15],weather:[5,12,21],web:[2,6,15,23,25],websit:[2,7,16,25],wedg:1,wednesdai:23,weekli:23,weight:[0,1,3,4,9,18],weight_vari:5,welcom:[24,25,26,29],well:[0,1,2,3,4,5,7,8,9,10,11,12,13,14,16,17,18,19,20,21,23,30],wendi:[29,31],were:[0,1,2,3,4,5,8,9,10,11,12,17,18,19,20,21],wessel:3,what:[4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,23,24],whatev:0,when:[0,1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21,23,24,29,31],whenev:1,where:[0,1,2,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21],wherea:[1,3,8,9,11,17,18,20,29,31],wherein:5,whether:[0,1,2,4,8,9,10,11,17,18,19,20,25,29,31],which:[0,2,3,4,6,7,8,9,10,11,12,15,16,17,18,19,20,21,24,29,31],who:[0,2,24],whoever:25,whole:5,whose:[1,3,9,10,18,19],whow:3,why:[0,2,8,12,17,21],wide:[2,3,5,7,8,10,16,17,19],widehat:3,wider:[0,12,21],width:[2,3],wieringen:3,wiki:24,willing:0,win:[11,20],wind:[8,10,17,19],wise:[3,5],wish:[0,2,4,7,8,10,11,12,16,17,19,20,21,26],wither:3,within:[0,1,2,4,5,8,17,24,26],without:[0,2,3,5,7,8,10,16,17,19,23,24],witth:[10,19],won:[2,3],word:[1,2,3,12,21],work:[0,1,2,3,4,5,6,7,8,10,11,13,14,15,16,17,19,20,23,25,29,30,31],workflow:26,world:[3,8,17],worldwid:[2,12,21],wors:[2,3,5],would:[0,1,2,3,4,5,7,8,9,10,11,12,16,17,18,19,20,21,23,25],wrap:[2,3,7,16,23],write:[0,1,2,3,5,6,7,9,10,11,12,15,16,18,19,20,21,22,27,29,31],writer:5,written:[0,1,2,3,5,6,7,8,9,10,11,15,16,17,18,19,20,29,31],wrong:[5,6,15,23],wrongli:1,wrote:[0,3],www:[2,5,7,16,23],x_0:[2,3,7,8,9,10,16,17,18,19],x_1:[0,1,2,3,4,7,9,16,18],x_2:[0,1,2,3,4,7,9,16,18],x_3:1,x_data:5,x_data_ful:5,x_f:[9,18],x_i:[1,2,3,4,5,8,9,17,18],x_ix_:3,x_j:[1,5],x_k:[1,5],x_l:1,x_m:[1,5],x_n:[0,1,3,5,10,19],x_p:[4,10,19],x_test:[3,5],x_test_own:3,x_test_scal:3,x_train:[2,3,5],x_train_own:3,x_train_scal:3,xarrai:[2,7,16],xavier:5,xcode:[2,7,16],xf_y:[9,18],xfinal:[11,20],xiniti:[11,20],xlabel:[1,2,3,6,7,15,16],xlim:3,xnew:2,xpd:3,xplot:2,xtest:3,xtick:3,xtrain:3,y_0:[2,3,7,8,9,16,17,18],y_1:[2,3,9,10,18,19],y_2:[2,3,9,18],y_3:2,y_data:[3,5],y_data_ful:5,y_i:[2,3,4,5,7,9,10,16,18,19],y_ix_:3,y_ix_i:4,y_j:[3,5],y_k:5,y_model:3,y_n:[9,18],y_p:[8,17],y_pred:[3,5],y_test:[3,5],y_test_onehot:5,y_test_predict:3,y_train:[2,3,5],y_train_onehot:5,y_train_predict:3,yanalyt:[7,16],year:[0,2,9,10,18,19],yes:[0,3,4],yet:[0,3,5,7,8,11,16,17,20],yf_x:[9,18],yield:[1,2,3,5,7,9,10,11,16,18,19,20],ylabel:[1,2,3,6,7,15,16],ylim:[3,10,19],yoshua:5,you:[0,1,2,3,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,23,25,26,28,29,30,31],young:[0,2],your:[0,1,2,3,5,6,7,8,9,10,12,13,14,15,16,17,18,19,21,23,25,26,30],yourself:[2,11,12,20,21],ypred:3,ypredict:[2,3],yridg:3,ytest:3,ytick:3,ytild:3,ytildenp:3,ytrain:3,z_0:[2,8,17],z_1:2,z_2:2,z_c:5,z_h:5,z_i:5,z_k:5,z_m:5,z_o:5,z_out:5,zaman:1,zero:[1,2,3,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21],zillion:0,zip:3,zm_h:2,zone:3,zze:[11,20]},titles:["Introduction to Applied Data Analysis and Machine Learning","1. Elements of Probability Theory and Statistical Data Analysis","15. Getting started, our first data and Machine Learning encounters","16. Linear Regression and more Advanced Regression Analysis","17. Logistic Regression","18. Neural networks, from the simple perceptron to deep learning","Introduction","Space, Time, Motion, Reference Frames and Reminder on vectors and other mathematical quantities","Basic Steps of Scientific Investigations","Work, Energy, Momentum and Conservation laws","Harmonic Oscillator","Two-body Problems","Non-inertial Frames, Translation and Rotating Coordinate Systems","Content with notebooks","Content with notebooks","Introduction","Space, Time, Motion, Reference Frames and Reminder on vectors and other mathematical quantities","Basic Steps of Scientific Investigations","Work, Energy, Momentum and Conservation laws","Harmonic Oscillator","Two-body Problems","Non-inertial Frames, Translation and Rotating Coordinate Systems","Content in Jupyter Book","PHY321, Classical Mechanics I, Michigan State University, Spring 2021","Code of Conduct","Contributing","LectureNotes","Content in Jupyter Book","Welcome to your Jupyter Book","Markdown Files","Content with notebooks","Markdown Files"],titleterms:{"break":23,"case":[1,7,16],"class":4,"final":[5,7,8,9,16,17,18,23],"function":[1,3,4,5],"import":[1,2,7,16],"transient":[10,19],Adding:[3,9,18,29,31],And:[2,8,17],Going:[8,17],Ising:3,OLS:3,One:[8,17],The:[1,3,4,5,8,9,10,12,17,18,19,21],Then:[8,17],Useful:[2,7,16],Using:[5,29,31],about:2,abov:[6,15],acceler:[7,8,12,16,17,21],act:[8,17],activ:5,actual:1,adjust:5,advanc:3,aim:3,air:[7,8,16,17],aka:3,algebra:[3,7,12,16,21],algorithm:[3,5,9,18],altern:[10,19],analysi:[0,1,3],analyt:[7,16],angular:[9,18],anoth:3,appli:0,approach:[0,3,8,17],approxim:5,april:23,architectur:5,arrai:[2,7,16],artifici:5,asap:23,aspect:0,assumpt:3,attempt:[7,16],attribut:24,autocorrel:1,averag:[7,16],back:5,backend:5,background:3,ballist:[8,17],basebal:[7,16],basic:[2,3,4,7,8,9,16,17,18],beta:[3,10,19],better:[1,3],bia:3,bias:[0,5],binari:5,bind:[2,3],binomi:1,block:[1,8,10,13,14,17,19,30],bodi:[11,20],boldsymbol:3,book:[22,26,27,28],bootstrap:[1,3],boston:3,brief:[2,3],bring:5,bug:25,build:[5,9,18,26],buld:[9,18],calcul:1,can:3,center:[11,20],central:1,centrifug:[11,12,20,21],chain:5,chi:3,choic:[0,5],choos:5,citat:[29,31],classic:[8,10,17,19,23],classif:5,code:[1,3,5,7,9,10,11,13,14,16,18,19,20,24,25,29,30,31],collect:5,compact:[7,16],comput:[1,7,16],computation:3,concept:[1,6,15],conduct:[24,25],conserv:[9,18],constant:[7,16],content:[13,14,22,27,30],continu:1,contn:[8,17],contribut:25,contributor:26,convolut:5,coordin:[12,21],corioli:[12,21],correl:[1,3],cost:5,cote:[9,18],coupl:[9,18],covari:[1,3],credit:26,critic:[10,19],cromer:[7,9,16,18],cross:[3,11,20],cumul:1,cython:2,damp:[10,19],dampl:[10,19],data:[0,1,2,3,5],dataset:5,date:23,decompos:3,decomposit:3,deep:5,defin:[5,8,17],definit:[1,5],degre:3,demonstr:1,dens:3,deriv:[5,9,10,11,18,19,20],descent:5,design:3,detail:[3,8,17],develop:5,deviat:1,dice:1,differenti:[7,8,10,16,17,19],dimens:[7,8,11,16,17,20],dimension:3,direct:[29,31],discret:[1,7,9,16,18],disguis:1,distribut:1,document:25,doing:5,domain:1,down:5,driven:[10,19],earth:[9,18],economi:3,effect:[11,12,20,21],element:[1,7,16],ellipt:[11,20],encount:[2,7,16],energi:[2,3,9,18],enforc:24,equal:[9,18],equat:[3,5,7,8,9,10,16,17,18,19],error:[3,9,18],essenti:[],etc:2,ethic:0,euler:[7,9,12,16,18,21],evalu:5,event:1,exampl:[1,2,3,5,6,7,9,11,15,16,18,20],execut:[29,31],expect:[1,3],expens:3,experi:1,exponenti:1,express:[3,9,18],extens:[7,16],extrem:[],factor:[10,19],fall:[7,8,12,16,17,21],famili:[3,5],famou:[1,2,7,16],fantast:3,featur:[2,3,7,16,25],februari:23,feed:5,feedback:25,field:[8,17],file:[29,31],find:[3,7,16],first:[2,5,7,8,16,17],fit:[2,3],fix:[3,25],fold:3,forc:[8,10,11,12,17,19,20,21],forward:5,foucault:[12,21],fouri:[10,19],fourier:[10,19],frame:[7,12,16,21],frank:3,freedom:3,frequentist:0,from:[3,5,12,21],full:5,funtion:5,galilean:[12,21],gaussian:1,gener:[1,3],get:[2,25],going:3,good:0,grade:23,gradient:5,gravit:[11,20],handl:[0,2,7,16],happen:3,harmon:[10,11,19,20],height:[7,16],host:26,hous:3,how:[1,3],hyperbol:5,hyperparamet:5,identifi:[8,17],illustr:[6,15],implement:[1,5,7,16,25],improv:5,includ:[4,7,16],inerti:[12,21],instal:[2,7,16],integr:[7,9,16,18],interpret:3,introduc:3,introduct:[0,2,4,6,15],investig:[8,17],its:1,jackknif:[1,3],januari:23,julia:2,jupyt:[22,27,28],kera:5,known:[6,15],kutta:[10,19],label:[7,16],lambda:3,languag:0,lasso:3,law:[8,9,17,18],layer:5,learn:[0,2,3,5,23],least:3,lectur:23,lecturenot:26,librari:[2,7,16],likelihood:4,limit:[1,5],linear:[2,3,12,21],link:[3,23],list:5,logist:[4,5],machin:[0,2],made:3,magnet:[8,17],mai:23,main:1,mani:[5,6,15],march:23,markdown:[13,14,29,30,31],mass:[2,11,20],materi:23,math:3,mathemat:[3,5,7,9,16,18],matric:[2,7,16],matrix:[1,2,3,5,7,16],matter:3,maximum:4,mean:1,mechan:23,meet:[1,2,7,16],mersenn:1,method:[1,3,7,9,10,16,18,19],michigan:23,minim:[],mlp:5,model:[0,2,3,5,7,8,16,17],moment:1,momentum:[9,18],more:[2,3,4,7,8,10,16,17,19],motion:[7,8,11,16,17,20],multi:5,multidisciplinari:[],multilay:5,multipl:5,myst:[13,14,29,30,31],name:1,need:[2,7,16],network:[2,5],neural:[2,5],neuron:5,newton:[8,9,17,18],non:[12,21],normal:1,notat:5,note:23,notebook:[13,14,30],now:3,nuclear:[2,3],numba:2,number:[1,3],numer:[1,9,10,18,19],numpi:[2,7,16],object:[5,8,12,17,21],observ:1,omega_0:[10,19],one:[3,5,7,8,16,17],ones:5,optim:[3,5],orbit:[11,20],ordinari:3,organ:2,orient:5,oscil:[10,11,19,20],other:[1,5,7,16,23],our:[1,2,3,5,7,8,10,16,17,19,24],outcom:[0,23],output:[1,13,14,30],overarch:3,overdamp:[10,19],own:3,packag:[2,7,16],panda:[2,3,7,16],paramet:[3,4],part:[8,17],pass:5,pdf:1,pendulum:[8,10,12,17,19,21],perceptron:5,perform:[3,5],period:[1,10,19],perspect:[5,12,21],philosophi:[9,18],phy321:23,pledg:24,poisson:1,possibl:23,potenti:[11,12,20,21],practic:[7,16,23],pre:5,preprocess:3,principl:[10,19],probabl:[0,1],problem:[3,5,9,11,18,20],procedur:3,process:5,program:0,projectil:[8,17],propag:5,properti:[1,3],pseudo:1,python:[1,2,7,16],quadratur:[9,18],quantiti:[7,16],raindrop:[8,17],ran0:1,random:1,read:2,real:2,recip:1,rectangl:[9,18],rectangular:[9,18],recurr:5,reduc:3,refer:[7,16],reformul:3,regress:[2,3,4],regular:[3,5],rel:[11,20],relev:5,relu:5,remind:[2,7,16],report:25,repositori:3,resampl:3,resist:[7,8,16,17],reson:[10,19],respons:[10,19,24],result:[3,8,17],rewrit:3,rich:[],ridg:3,rng:1,role:[29,31],rotat:[12,21],rule:[5,9,18],rung:[10,19],rutherford:[11,20],same:3,sampl:1,scale:[8,10,17,19],scatter:[11,20],schedul:23,scientif:[8,17],scikit:[2,3,5],scope:24,second:[8,17],section:[11,20],see:2,select:1,seri:[10,19],set:[3,5,8,17],should:[1,5],sigmoid:5,simpl:[1,2,3,5,7,9,16,18],simpson:[9,18],singl:[8,17],singular:3,sinusoid:[10,19],situat:1,size:3,slide:[8,10,17,19],small:0,softer:[8,17],softmax:5,softwar:[2,7,16],solar:[9,18],solut:[7,11,16,20],solv:[7,8,10,16,17,19],some:[2,3,7,16],space:[7,16],split:[3,8,17],spring:23,squar:3,stabil:[11,20],standard:[1,24],start:[2,25],state:[3,23],statist:[1,3],step:[3,8,9,17,18],stochast:1,studi:[9,10,18,19],submit:25,suit:3,sum:3,summari:2,sun:[9,18],superposit:[10,19],supervis:5,svd:3,symmetri:[9,18],system:[8,9,12,17,18,21],teach:23,team:23,tensorflow:5,term:5,test:[3,5],textbook:23,theorem:[1,5,12,21],theori:1,thi:23,third:[8,17],three:1,tidal:[11,20],tied:[8,17],time:[7,16],togeth:5,top:5,toss:1,tradeoff:3,train:[3,5],transform:[10,12,19,21],translat:[12,21],trapezoid:[9,18],tree:2,truncat:[9,18],two:[4,8,11,17,20],type:[2,5],uncorrel:1,underdamp:[10,19],understand:3,uniform:1,unit:[7,16],univers:[5,23],updat:23,usag:26,use:[1,5],useful:3,using:[1,2,5],valid:3,valu:[1,3],variabl:1,varianc:[1,3],variou:3,vector:[2,3,5,7,16],veloc:[7,9,16,18],verlet:[9,18],view:3,visual:5,wai:[8,17],wall:[8,17],week:23,weight:5,welcom:28,well:[6,15],what:[0,1,2,3,29,31],where:3,which:[1,5],why:[1,3,5],width:[10,19],wood:2,work:[9,18],write:25,your:[28,29,31],z_j:5}}) \ No newline at end of file +Search.setIndex({docnames:["chapter1","chapter2","chapter3","chapter4","chapter5","chapter6","chapter7","chapter8","testbook/_build/jupyter_execute/chapter1","testbook/_build/jupyter_execute/chapter2","testbook/_build/jupyter_execute/chapter3","testbook/_build/jupyter_execute/chapter4","testbook/_build/jupyter_execute/chapter5","testbook/_build/jupyter_execute/chapter6","testbook/_build/jupyter_execute/chapter7","testbook/_build/jupyter_execute/lecturenotes/lecturenotes/notebooks","testbook/_build/jupyter_execute/notebooks","testbook/chapter1","testbook/chapter2","testbook/chapter3","testbook/chapter4","testbook/chapter5","testbook/chapter6","testbook/chapter7","testbook/content","testbook/intro","testbook/lecturenotes/CONDUCT","testbook/lecturenotes/CONTRIBUTING","testbook/lecturenotes/README","testbook/lecturenotes/lecturenotes/content","testbook/lecturenotes/lecturenotes/intro","testbook/lecturenotes/lecturenotes/markdown","testbook/lecturenotes/lecturenotes/notebooks","testbook/markdown"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,"sphinx.ext.intersphinx":1,sphinx:56},filenames:["chapter1.ipynb","chapter2.ipynb","chapter3.ipynb","chapter4.ipynb","chapter5.ipynb","chapter6.ipynb","chapter7.ipynb","chapter8.ipynb","testbook/_build/jupyter_execute/chapter1.ipynb","testbook/_build/jupyter_execute/chapter2.ipynb","testbook/_build/jupyter_execute/chapter3.ipynb","testbook/_build/jupyter_execute/chapter4.ipynb","testbook/_build/jupyter_execute/chapter5.ipynb","testbook/_build/jupyter_execute/chapter6.ipynb","testbook/_build/jupyter_execute/chapter7.ipynb","testbook/_build/jupyter_execute/lecturenotes/lecturenotes/notebooks.ipynb","testbook/_build/jupyter_execute/notebooks.ipynb","testbook/chapter1.ipynb","testbook/chapter2.ipynb","testbook/chapter3.ipynb","testbook/chapter4.ipynb","testbook/chapter5.ipynb","testbook/chapter6.ipynb","testbook/chapter7.ipynb","testbook/content.md","testbook/intro.md","testbook/lecturenotes/CONDUCT.md","testbook/lecturenotes/CONTRIBUTING.md","testbook/lecturenotes/README.md","testbook/lecturenotes/lecturenotes/content.md","testbook/lecturenotes/lecturenotes/intro.md","testbook/lecturenotes/lecturenotes/markdown.md","testbook/lecturenotes/lecturenotes/notebooks.ipynb","testbook/markdown.md"],objects:{},objnames:{},objtypes:{},terms:{"00000000e":[3,7],"000e":7,"00694659e":[],"00pm":25,"012e":7,"01347297e":[],"01443312e":3,"01968016e":7,"02004166e":[],"02176297e":[],"02599545e":[],"03123374e":3,"03256632e":5,"03288157e":3,"03446279e":[],"04029857e":[],"040e":7,"041e":7,"04722875e":[],"04904333e":[],"05246505e":7,"058e":7,"060e":7,"064e":7,"06648521e":[],"07106781e":3,"07557895e":[],"075e":7,"08248290e":3,"08318298e":5,"08915360e":3,"09013732e":3,"09284157e":[],"09507879e":7,"0_tlsccwai":25,"0_utc9il9i":25,"0x7fad47b08730":[],"0x7fb5be1db040":3,"0x7fddb4c436d0":[],"0x7ff4f8410b20":[],"0x7ff6a7303b50":[],"1000s":3,"100m":[10,19],"10368860e":[],"10378326e":5,"10665316e":7,"10687329e":3,"10898112e":3,"10th":25,"10x":2,"112453549290521e":[11,20],"11487443e":[],"114e":7,"11507992e":5,"115e":7,"117e":7,"12471292e":7,"12868265e":3,"12cm":[9,18],"13037918e":7,"14549644e":7,"146e":7,"14g":3,"15657183e":[],"15751255e":7,"15g":3,"16496581e":3,"16b8e3cda33a":5,"17174962e":5,"17314f270d45":7,"17683028e":7,"18442813e":[],"18721828e":7,"19218307e":[],"19614372e":7,"1970s":[2,9,18],"198e":7,"1_1":5,"1_2":5,"1_2v2se359":25,"1_2v439nza":25,"1_3":5,"1_azwo1s2r":25,"1_b81t0tta":25,"1_d70czgce":25,"1_e1cs5784":25,"1_ftgzt035":25,"1_hxxec3uc":25,"1_i9hczn21":25,"1_j5ugthfg":25,"1_rz8vr2ht":25,"1_sp7p28vk":25,"1_t1pocrww":25,"1_t2l86862":25,"1_utivxb87":25,"1_w9xc8az7":25,"1_wk9trq9k":25,"1cm":[1,2,6,10,19],"1e4":3,"1kg":[9,18],"1kgm":[9,18],"202e":7,"20686874e":3,"20745612e":[],"21351358e":[],"21635571e":[],"21814310e":3,"21869563e":[],"21st":25,"22164060e":[],"22421033e":[],"224805627923717e":[11,20],"226e":7,"228e":7,"23h":[14,23],"24629399e":[],"24790498e":7,"24h":[14,23],"252e":7,"254e":7,"2572e3a4b38d":5,"26349118e":[],"263e":7,"26888965e":7,"268e":7,"27564656e":7,"279e":7,"27n_":1,"28119384e":[],"28444646e":[],"28590170e":[],"28kg":[14,23],"2_1":5,"2_2":5,"2_3":5,"2_i":5,"2_m":1,"2_x":1,"2cm":[6,9,18],"2dimgrav":[13,22],"2dimhovv":[13,22],"2ff97f4bf03b":1,"2k_2":[12,21],"2k_3":[12,21],"2me":[13,22],"2meb":[13,22],"2mr":[13,22],"2mr_":[13,22],"2nd":[12,21,25],"2v_":[10,19],"2v_x":[10,19],"2v_y":[10,19],"2x_ix_jy_iy_j":6,"2x_j":6,"2y_0":[9,18],"2y_j":6,"2z_":7,"30273573e":[],"30579019e":7,"30pm":25,"31819744e":7,"32218090e":[],"32849325e":[],"33026664e":7,"33066907e":3,"33291949e":[],"33381074e":7,"333e":7,"33583503e":[],"33608388e":3,"35938336e":[],"36816390e":[],"37689988e":[],"379e":7,"381e":7,"38483045e":7,"39860289e":7,"3rd":25,"40925064e":[],"41088348e":[],"412252157986472e":[11,20],"41241709e":3,"41511965e":5,"422e":7,"43297505e":7,"435e":7,"43821714e":[],"44786221e":7,"447e":7,"44970586e":5,"45035234e":[],"45426079e":[],"47269386e":[],"49887171e":[],"4ar":[13,22],"4dr":[13,22],"4f_0":[11,20],"4pm":25,"4th":25,"501e":7,"50446329e":[],"50470354e":[],"504e":7,"50565973e":7,"50pm":25,"50x10":5,"512e":7,"51502206e":[],"51737928e":7,"52131750e":[],"52177694e":[],"52491181e":7,"52533249e":3,"52583599e":[],"52783754e":3,"53990135e988":3,"54220685e":[],"54686289e":[],"55456211e":[],"55726683e":7,"55868382e":[],"56432255e":7,"565e":7,"56min":[14,23],"57072598e":3,"570e":7,"57425734e":3,"58928789e":[],"58934440e":[],"58977964e":7,"59310961e":7,"59958864e":[],"5cm":[1,12,21],"5th":25,"604e":7,"60505104e":[],"60996409e":[],"61028757e":7,"61445925e":7,"62113986e":[],"62496853e":[],"628e":7,"63164705e":[],"63177381e":[],"638e":7,"64043119e":3,"64x50":5,"65939208e":3,"66371431e":[],"67887686e":7,"67m":[14,23],"69069n_":1,"69095941e":7,"69238112e":7,"6n_":1,"6pm":25,"6th":25,"70896266e":7,"710e":7,"713e":7,"71833086e":3,"72347840e":[],"72352580e":[],"729e":7,"73212847e":7,"73374509e":[],"744e":7,"74784357e":[],"75209222e":[],"76071445e":3,"77350269e":3,"77667437e":[],"77804918e":7,"78512013e":3,"78920723e":[],"79318674e":7,"7th":25,"80872400e":[],"811e":7,"81402316e":7,"81862750e":7,"83131741e":[],"83194721e":7,"83259341e":7,"83286207e":[],"84355903e":5,"84443254e":5,"84683780e":[],"852e":7,"86195387e":7,"873e":7,"882e":7,"885e":7,"89045976e":[],"89354206e":[],"89456494e":7,"8th":25,"8x8":5,"903e":7,"90524667e":7,"90555053e":3,"91269450e":7,"91811329e":7,"92507116e":5,"92983892e":7,"930e":7,"938e":7,"94466097e":7,"94553659e":[],"948e":7,"95125898e":[],"954e":7,"96064784e":[],"960e":7,"97624658e":3,"981e":7,"984e":7,"98658737e":[],"99126621e":7,"996e":7,"9th":25,"abstract":[5,8,17],"break":[2,3,7,9,10,13,18,19,22],"byte":[2,9,18],"case":[0,2,3,4,5,7,8,10,11,12,13,14,17,19,20,21,22,23],"catch":2,"char":1,"class":[0,1,2,3,5,6,7,8,9,12,17,18,21,25],"const":[1,7],"default":[2,3,4,5,9,18,31,33],"final":[1,2,3,4,6,8,12,13,14,17,21,22,23],"float":[1,2,3,7,8,9,11,17,18,20],"function":[0,2,8,9,10,11,12,13,14,17,18,19,20,21,22,23,31,33],"import":[0,3,4,5,6,7,8,10,11,12,13,15,16,17,19,20,21,22,25,28,32],"int":[1,3,5,7,10,12,13,19,21,22],"long":[1,2,5,10,12,13,14,19,21,22,23],"new":[0,1,2,3,4,5,6,7,8,9,10,11,12,17,18,19,20,21],"null":1,"public":[0,2,9,18,26],"return":[1,2,3,5,6,7,8,9,10,11,12,13,17,18,19,20,21,22],"s\u00f8renssen":25,"short":[24,29],"super":3,"switch":[2,13,14,22,23],"throw":[1,10,12,14,19,21,23],"true":[1,2,3,4,5,6,7,11,12,13,14,20,21,22,23],"try":[0,1,2,4,5,6,7,8,9,10,12,13,17,18,19,21,22],"var":[1,3,7],"while":[0,1,2,3,5,6,7,10,11,12,14,19,20,21,23,25],AGE:3,AMS:25,Added:[10,19],Adding:[0,5],And:[0,1,3,8,9,17,18],Are:[7,10,19],BPS:25,Being:26,But:[1,2,3,5,7,10,11,14,15,16,19,20,23,32],CAS:[2,9,18],DIS:3,Doing:3,EoS:3,For:[0,1,2,3,4,5,6,7,9,10,11,12,13,14,15,16,18,19,20,21,22,23,25,31,32,33],GPS:0,Going:[3,5],I_s:[12,21],Ising:5,Its:[5,7],MDS:7,NNs:5,N_s:6,Not:[0,2,3,7],ODE:[10,19],One:[0,1,3,4,5,6,7,11,12,13,14,20,21,22,23],PCs:7,RMS:1,Such:[1,3,5,8,10,17,19],That:[1,2,4,5,7,10,14,19,23],The:[0,2,8,9,13,17,18,22,25,26,27,28,31,33],Then:[1,2,3,5,6,7,9,13,14,18,22,23],There:[0,1,2,3,5,6,7,8,9,11,12,14,15,16,17,18,20,21,23,24,29,31,32,33],These:[0,1,2,3,5,6,7,8,9,10,12,13,14,17,18,19,21,22,23,25],Use:[0,13,22],Useful:3,Using:[2,3,6,9,10,11,12,13,14,18,19,20,21,22,23,26],With:[1,2,3,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23],Yes:[0,10,19],__doc__:3,__future__:6,__init__:[3,5],__name__:3,_auto10:[3,5,10,11,12,13,19,20,21,22],_auto11:[3,10,11,12,13,19,20,21,22],_auto12:[10,11,12,13,19,20,21,22],_auto13:[3,10,11,12,13,19,20,21,22],_auto14:[10,11,12,13,19,20,21,22],_auto15:[10,11,12,13,19,20,21,22],_auto16:[10,12,13,19,21,22],_auto17:[10,12,13,19,21,22],_auto18:[10,12,13,19,21,22],_auto19:[10,12,19,21],_auto1:[1,3,4,5,10,11,12,13,14,19,20,21,22,23],_auto20:[10,12,19,21],_auto21:[10,12,19,21],_auto23:[12,21],_auto24:[12,21],_auto25:[12,21],_auto26:[12,21],_auto27:[12,21],_auto28:[12,21],_auto29:[12,21],_auto2:[1,3,5,10,11,12,13,14,19,20,21,22,23],_auto30:[12,21],_auto31:[12,21],_auto32:[12,21],_auto33:[12,21],_auto34:[12,21],_auto3:[3,5,10,11,12,13,14,19,20,21,22,23],_auto4:[3,5,10,11,12,13,14,19,20,21,22,23],_auto5:[3,5,10,11,12,13,19,20,21,22],_auto6:[3,5,10,11,12,13,19,20,21,22],_auto7:[3,5,10,11,12,13,19,20,21,22],_auto8:[3,5,10,11,12,13,19,20,21,22],_auto9:[3,5,10,11,12,13,19,20,21,22],_ax:3,_base:6,_build:28,_check_optimize_result:7,_compon:7,_datafram:[2,9,18],_lambda:3,_logist:7,_ratio:7,_setattr_cm:3,_subplot:3,_update_properti:3,_varianc:7,a_0:[3,11,20],a_1:[12,14,21,23],a_1a:[2,3],a_1x:[11,20],a_2:[12,14,21,23],a_2a:[2,3],a_2a_3:[11,20],a_2x:[11,20],a_3:[2,14,23],a_3a:3,a_3a_2:[11,20],a_4:2,a_4a:3,a_fc1:5,a_fc2:5,a_h:5,a_i:[2,5,9,11,14,18,20,23],a_j:5,a_ja_k:[11,20],a_k:5,a_n:[11,20],a_p:[12,21],a_x:[9,18],a_z:[9,18],aaverag:[9,18],abandon:5,abid:[1,27],abil:[0,2],abl:[1,2,3,4,5,10,12,13,19,21,22,25],abort:1,abotu:[14,23],about:[0,1,3,5,6,7,8,10,11,12,13,14,15,16,17,19,20,21,22,23,25,27,31,32,33],abov:[1,2,3,4,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23],abovement:[3,8,14,17,23],abs:[2,3,8,11,17,20],absolut:[2,3,8,9,17,18],absorb:[12,13,14,21,22,23],abus:26,acccess:2,accelearatio:[9,18],acceler:[11,12,13,20,21,22,25],acceleromet:[14,23],accept:[0,3,10,19,26,31,33],access:[0,1,2,3,7],accid:3,accommod:[12,21],accompani:[0,3],accomplish:[6,13,22],accord:[1,2,3,5,9,12,13,14,18,21,22,23],accordingli:7,account:[0,1,2,9,14,18,23,26],accumul:[1,5,8,17],accur:[1,3,11,20],accuraci:[0,2,3,5,7,11,20],accuracy_scor:[2,5],accuracy_score_numpi:5,achiev:[0,2,3,5,6,9,18],aco:[1,10,19],acquaint:0,acquir:[0,5,25],acr:3,across:[2,3,5,9,18],act:[5,9,11,12,13,14,18,20,21,22,23,25,26],action:[1,10,11,19,20,26,28],activ:[2,25],actual:[2,3,5,6,7,9,10,13,14,18,19,22,23],adapt:[3,26],add:[0,1,2,3,5,6,7,9,10,11,12,14,18,19,20,21,23,31,33],add_:[15,16,32],add_graph:5,add_subplot:[4,5],added:[2,3,5,6,7,8,10,11,14,17,19,20,23],adding:[3,5,11,12,20,21],addit:[0,1,2,3,4,5,6,7,8,9,10,12,13,14,17,18,19,21,22,23,25],addition:5,address:[7,8,11,17,20,26],adjac:5,adjust:[10,12,13,19,21,22],admir:2,adopt:[9,18],advanc:[5,8,17,26],advantag:[3,5,10,19],afecionado:2,affect:[3,11,13,20,22],affin:[3,6,7],aficionado:2,african:3,after:[0,1,2,3,5,7,9,11,12,13,18,20,21,22,25],afterward:[2,9,18],again:[0,1,2,3,4,5,6,7,11,12,14,20,21,23,31,33],against:[5,10,12,19,21],age:[0,2,3,26],agre:[1,12,21,27],aid:7,aim:[0,2,4,7,8,9,10,11,13,17,18,19,20,22],air:[11,12,14,20,21,23,25],aircraft:[14,23],akin:[12,21],algebra:[0,2,13,22],algo:[0,1],algorithm:[0,1,2,4,6,8,9,10,12,17,18,19,21,25],align:[1,3,4,6,15,16,26,32],all:[0,1,2,3,4,5,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,26,28,31,33],allevi:5,allow:[0,2,3,5,6,7,8,9,10,11,12,13,17,18,19,20,21,22,25,31,33],almost:[0,1,2,3,5,6,7],alon:[12,21],along:[2,3,7,9,11,13,14,18,20,22,23],alpha:[1,2,3,5,6,7,10,11,13,14,19,20,22,23],alpha_n:[12,21],alreadi:[1,2,5,9,10,12,18,19,21,31,33],also:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,25,31,32,33],alter:[1,5],altern:[2,3,5,6,7,9,10,11,18,19,20],although:[3,5,6,10,11,12,19,20,21],alwai:[0,1,2,3,5,9,10,11,13,18,19,20,22,25,27],amaz:0,ame2016:[2,3],american:3,among:[0,3,5],amongst:[13,22],amount:[3,6,11,12,14,20,21,23],amplitud:[10,12,14,19,21,23],an_:1,anaconda3:[3,6,7],anaconda:[2,5,9,18,25],analog:[13,22],analogu:[13,22],analys:[1,3],analysi:[2,4,5,8,9,10,13,17,18,19,22],analyt:[2,3,4,5,8,10,11,12,14,17,19,20,21,23,25],analyz:[0,1,2,3,5,10,19,25],ander:25,andrew:5,anew:[11,12,13,20,21,22],angl:[1,3,7,9,11,12,13,14,18,20,21,22,23],angmom:[13,22],angular:[10,12,13,14,19,21,22,23,25],anharmon:[12,21],ani:[0,1,2,3,4,5,6,10,11,12,13,14,19,20,21,22,23,26,27,31,33],anim:5,ann:5,annot:[2,3,5,6,7],anoth:[0,1,2,5,6,7,9,10,12,13,14,18,19,21,22,23,31,33],ans:1,ansatz:2,answer:[0,2,3,5,9,10,12,18,19,21],anticip:[9,18],antiparallel:[13,22],antisymmetri:[11,20],anymor:6,anyon:6,anyth:[1,5,27],apach:5,apart:7,api:[2,5,9,18],appar:[14,23],appear:[0,1,2,5,10,11,12,13,14,19,20,21,22,23,26],append:[1,2,6,9,18],appendix:[12,21],appl:0,appli:[1,2,3,4,5,6,7,8,9,10,11,12,13,17,18,19,20,21,22,25,26],applic:[0,1,2,3,5,7,8,10,14,17,19,23,25],appoint:26,appreci:27,approach:[1,2,5,7,8,9,11,12,13,17,18,20,21,22],appropri:[1,3,5,10,19,26],approx:[1,3,7,10,11,12,13,14,19,20,21,22,23],approxim:[1,3,4,7,8,10,11,12,14,17,19,20,21,23],apt:[2,9,18],aragorn:[2,9,18],arang:[2,3,4,5,9,18],arbitrari:[1,5,6,10,12,13,14,19,21,22,23],arbitrarili:[2,5,7,13,22],arctan:[13,22],arctanh:[9,18],area:[0,2,10,11,13,19,20,22],areal:[13,22],arg:3,argc:1,argmax:[5,7],argsort:7,argu:5,argument:[1,3,5,7],argv:1,aris:[0,1,2,3,5,14,23],arithmet:2,arma:1,armadillo:1,around:[1,2,3,5,7,9,10,11,12,13,14,18,19,20,21,22,23],arrai:[1,3,5,6,8,11,12,13,15,16,17,20,21,22,32],arrang:25,arriv:[1,2,7,8,17],arrow:[5,10,19],arrowprop:6,art:0,articl:[1,3,5,27],artifici:[0,2,4],artificialneuron:5,artist:3,asarrai:2,ascii:[1,2],asid:[11,12,20,21],asin:[10,12,19,21],ask:[3,5,7,10,14,19,23],aspect:[2,8,10,17,19],assembl:2,assess:[0,3],assign:[0,2,3,4,5,6,13,22,25],assist:25,associ:[1,2,3,5,14,23,31,33],assum:[1,2,3,4,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23],assumpt:[0,1,2,7,14,23],ast:3,asteroid:[13,22],astronom:[11,20],asymmetr:[11,20],asymmetri:2,asymptot:[3,13,22],atoi:1,atom:[2,10,11,12,13,19,20,21,22],attack:26,attempt:[2,11,20],attent:[2,9,14,18,23,26],attitud:[0,8,17],attract:[2,13,22],attribut:3,attributeerror:3,audi:2,auditori:[31,33],australia:[31,33],author:[0,1,2,5],authour:[0,2],auto:[1,7],autocor:1,autocorrelation_tim:1,autocorrelform:1,autocovari:1,autograd:[2,9,18],autom:[0,8,17,28],automag:[0,2,9,18],automat:[2,7,9,18,28],automobil:[10,19],avail:[0,2,3,5,7,8,9,17,18,25],avdt:[10,19],avenu:0,averag:[1,2,3,5,11,13,20,22],avg:1,avoid:[0,2,3,7,9,11,18,20],awai:[1,3,12,13,14,21,22,23],aws:25,axel:[10,19],axes:[3,6,7,9,10,15,16,18,19,32],axes_grid1:3,axessubplot:3,axhlin:6,axi:[1,2,3,4,5,6,7,10,11,13,14,19,20,22,23],axlabel:[2,9,18],axs:[9,18],axvlin:6,azimuth:[11,13,20,22],b_1:5,b_1e:[12,21],b_2e:[12,21],b_fc1:5,b_fc2:5,b_i:[3,5],b_ia_:3,b_j:5,b_k:5,b_m:5,b_out:5,b_p:[12,21],b_x:[9,18],b_y:[9,18],b_z:[9,18],back:[0,1,3,9,10,11,13,14,18,19,20,22,23],background:[9,18],backpropag:5,backward:[5,13,22],bad:[1,3],badli:1,baggin:[2,9,18],bake:[8,17],balanc:3,ball:[9,10,14,18,19,23],ban:26,band:[2,9,18],bandwidth:[2,9,18],bar:[2,7,9,11,18,20],barrier:25,base:[0,1,2,3,4,5,6,8,9,12,17,18,21],basi:[2,3,4,5,6,7,9,13,18,22,25],basic:[0,1,5,6,8,12,14,17,21,23],batch:[5,7],batch_i:5,batch_siz:5,batch_x:5,bay:4,bayesian:0,bdb:[13,22],becaus:[0,2,3,5,6,8,10,11,12,13,14,17,19,20,21,22,23],becom:[0,1,2,3,5,7,9,10,11,12,13,14,18,19,20,21,22,23],been:[0,2,3,5,7,8,9,10,12,17,18,19,21,25,28],befor:[0,1,2,3,4,5,6,8,10,11,12,13,14,17,19,20,21,22,23],beforehand:[0,1,2],began:[13,22],begin:[1,2,3,4,5,6,7,9,10,11,12,13,14,15,16,18,19,20,21,22,23,25,32],behav:[3,5,13,22],behavior:[0,2,5,8,12,17,21,26],behaviour:5,behind:[0,2,3,5,6,12,21],being:[0,1,2,3,4,5,6,7,8,12,13,14,17,21,22,23,31,33],believ:[10,19],belong:[4,6,14,23],below:[1,2,3,4,5,6,7,8,9,10,11,12,14,17,18,19,20,21,23,27],benchmark:[8,17],benefici:5,benefit:[2,5,7,8,17],bengio:5,benign:7,best:[0,1,2,3,5,6,7,10,12,13,19,21,22,26,27],beta:[2,4,5,7,13,22],beta_0:[3,4,5,12,21],beta_0x_:3,beta_1:[3,4,5],beta_1x_0:3,beta_1x_1:[3,4],beta_1x_2:3,beta_1x_:3,beta_1x_i:4,beta_2:3,beta_2x_0:3,beta_2x_1:3,beta_2x_2:[3,4],beta_2x_:3,beta_:[3,4],beta_i:3,beta_j:3,beta_n:[12,21],beta_p:4,beta_px_p:4,better:[0,2,5,7,8,10,11,12,17,19,20,21],between:[0,1,2,3,4,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23],beyond:[0,2,3,5,6,8,12,17,21],bia:[0,1,5,6],bias:3,bias_vari:5,bib:[31,33],bibliographi:[31,33],bibtex:[31,33],bicycl:[9,18],big:[0,2,3,5,10,19],bigger:5,bigr:5,bilbo:[2,9,18],billion:5,bin:[1,3,7],binari:[1,2,4],binomi:0,binsboot:3,bioinformat:[0,2],biolog:5,bird:2,birth:[2,9,18],bit:[1,2,5,9,10,12,14,18,19,21,23,27],bitwis:1,bla:[2,9,18],black:6,blob:25,block:[0,2,3,9,18,25,31,33],blockeulercrom:[12,21],blockingavg:1,blockingstd:1,blockingvar:1,blocksiz:1,blocksizemax:1,blocksizemin:1,blog:27,blue:2,blue_patch:[9,18],bmatrix:[2,3,4,5,6,7,9,18],bmi:5,bodi:[0,3,5,10,11,14,19,20,23,25,26],boldfac:[3,9,18],boldsymbol:[0,2,5,6,7,9,10,11,13,14,18,19,20,22,23],bolt:[10,19],boltzmann:[0,5],bonu:[8,17],book:[15,16,25,31,32,33],boost:5,bootavg:1,bootstd:1,bootstrap:[0,5],bootvar:1,bootvec:1,bore:0,borrow:[2,9,18],boston_dataset:3,bot:6,both:[0,1,2,3,5,6,8,9,10,12,13,14,17,18,19,21,22,23,26,31,33],bottl:4,bottom:[3,12,21],bounc:[10,19],bound:[3,5,6,13,22],boundari:[5,6,7,10,19],box:[11,20,31,33],boyd:6,bracket:1,brain:[4,5],brake:[14,23],branch:[27,28],brand:0,breast:5,brew:[2,9,18],brg:6,brian:[31,33],brief:[11,20],briefli:[2,8,12,17,21],bring:[2,3,12,14,21,23],brisban:[31,33],broad:[0,2],broken:[10,19],browser:2,brute:[3,7],bte:[12,21],bthe:[13,22],buck:0,build:[0,1,2,3,9,18,31,33],built:[3,5,12,21,28,31,33],bunch:7,bundl:30,buoyanc:[9,18],bus:[14,23],busi:3,butler:25,c46dd114b2af:6,c_0:1,c_1:[5,14,23],c_1e:[14,23],c_2:[5,14,23],c_2e:[14,23],c_3:5,c_4:5,c_i:5,c_k:1,c_w:[10,19],cal:[5,6],calcul:[0,2,3,5,6,7,8,9,10,11,12,13,17,18,19,20,21,22],calculu:25,call:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,31,33],callabl:3,came:[10,14,19,23],camera:0,can:[0,1,2,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,25,27,28,31,32,33],cancel:[3,11,20],cancer:5,cancerpd:7,candid:6,cannot:[0,1,2,3,5,6,7,10,11,19,20],canopi:[2,9,18],capabl:[0,2,6,9,18],capita:3,captur:[5,7],car:[0,10,14,19,23],card:[0,3,4],cardin:5,care:[7,12,21],carlo:[0,1,2,3],carmak:0,carri:[3,4],cartesian:[9,13,18,22],cast:5,categor:[0,2,5,7],categori:[0,2,4,5],categorical_crossentropi:5,caus:[0,1,3,7,10,14,19,23],causal:3,causat:0,caveat:[11,20],cbook:3,ccc:5,cdf:1,cdot:[1,2,3,5,9,10,11,12,13,14,18,19,20,21,22,23],ceil:[9,11,12,13,18,20,21,22],cell:[31,33],cellphon:25,center:[1,2,3,4,6,10,11,12,14,19,20,21,23,25],central:[0,2,3,6,8,9,14,17,18,23,25],centrifug:25,centroid:1,centuri:[8,17],certain:[0,1,2,3,4,13,22],cha:3,chain:[0,1,11,13,14,20,22,23,25],challeng:[11,20],chanc:[1,5,13,22],chang:[1,2,3,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,27],chapter:[3,7,12,21,25],charact:[1,2,3,6],character:[1,5,6],characterist:[3,12,21],charg:[2,10,13,19,22],charl:3,cheap:3,cheaper:5,check:[2,3,5,7,9,10,12,15,16,18,19,21,30,32],checkmark:[12,21],chemic:1,chi:2,chimborazo:[14,23],choic:[1,3,9,10,12,13,18,19,21,22],choleski:3,choos:[1,3,7,9,10,11,12,13,18,19,20,21,22],chosen:[1,2,3,5,6,9,10,11,12,13,14,18,19,20,21,22,23],chosen_datapoint:5,chpater:[12,21],christoph:[31,33],cin:1,circ:[5,14,23],circl:[3,5,6,7,10,13,19,22],circuit:[12,21],circul:[13,14,22,23],circular:[10,11,13,19,20,22],circumst:26,circumv:[3,5],cite:[31,33],citizen:0,civita:[11,20],claim:0,clarifi:26,clariti:1,classic:[2,8,11,13,14,17,20,22,23,33],classif:[0,2,3,4,6,9,18],classifi:[0,4,5,7],classificaton:5,clean:5,clear:[5,13,22],clearli:[1,3,6,7,10,11,19,20],clever:5,clf3:2,clf:[2,3,6],clf_lasso:3,clf_ridg:3,clip:1,clockwis:[10,14,19,23],clone:[27,28],close:[0,1,2,3,5,6,7,9,10,12,13,14,18,19,21,22,23],closer:[10,19],closest:[6,7,9,13,18,22],closur:[2,9,18],cloud:[2,9,18],cluster:[0,2,3,5,7],cmap:[2,3,5,6,15,16,32],cmap_arg:3,cmath:1,cmse201:[8,17],cn_:1,cna:[10,19],cnn:5,cntk:[2,9,18],code:[0,2,4,8,10,17,19],coef0:6,coef:2,coef_:[2,3,6],coeffici:[2,3,4,6,10,12,14,19,21,23],coerc:[2,3],cognit:[31,33],coin:1,col:[2,3,7,9,18],colab:[2,9,18],cold:[15,16,32],colinear:3,collaps:6,collect:[1,2,3,7,9,10,18,19],collid:[0,13,22],collinear:3,collis:[0,13,22],color:[1,2,3,6,9,13,15,16,18,22,32],color_cod:3,colorbar:3,column:[2,3,5,6,7,9,18],com:25,combin:[1,3,4,8,11,13,14,17,20,22,23],come:[0,2,3,5,9,10,12,13,14,18,19,21,22,23],comma:2,command:[0,1,2,5,8,9,17,18,31,33],comment:26,commerci:[2,9,18],commit:[26,27],commod:2,common:[0,1,2,3,4,5,7,9,10,11,12,13,18,19,20,21,22],commonli:[3,4,5],commonmark:[31,33],commun:[0,2,5,26],commut:[11,20],compact:[3,4,5,7,11,13,20,22],compactli:[11,20],compani:0,compar:[2,3,7,8,9,10,12,13,14,17,18,19,21,22,23],compat:4,compdriv:[12,21],compet:[0,2,8,17,25],compil:[0,1,2,5],complaint:26,complement:[11,20],complementari:[12,21],complet:[2,5,10,12,19,21],completenn:5,complex:[0,3,5,6,7,12,13,14,21,22,23,31,33],complic:[0,2,3,5,8,10,13,14,17,19,22,23],compon:[3,5,10,11,12,13,14,19,20,21,22,23],components_:7,compos:5,compress:[2,3,7,10,19],compris:3,compromis:3,comput:[0,2,3,5,6,8,10,11,12,14,17,19,20,21,23,25,31,33],computation:[0,1],con:25,concaten:3,concentr:3,concept:[0,2,3,11,20],conceptu:[5,13,14,22,23],concern:[0,4,5,11,20],concic:[2,9,18],conclud:2,conclus:[0,5],conda:[2,5,9,18,27],condit:[1,3,6,7,9,10,11,12,13,14,18,19,20,21,22,23],conduct:[0,8,17],confer:[31,33],confid:[3,4,6],confidenti:26,confirm:5,confus:3,congruenti:1,conjug:6,connect:[2,3,5,7,9,18,25],consequ:[3,5,6,8,13,17,22],conserv:[3,10,12,13,19,21,22,25],consid:[0,1,2,3,4,5,6,10,11,12,13,14,19,20,21,22,23,26],consider:[0,3,5,7,10,19],consist:[1,3,5,10,12,19,21],constant:[1,2,3,5,6,10,11,12,13,14,19,20,21,22,23],constitu:2,constitut:3,constrain:[5,7,13,22],constraint:[3,6,25],construct:[0,1,2,3,5,6,7,8,17,26],consumpt:[10,19],contact:[2,10,13,19,22,26],contain:[0,1,2,3,4,5,6,7,8,9,17,18,25],content:[2,9,18,30,31,33],context:3,continu:[0,2,3,4,5,6,8,9,10,14,17,18,19,23],continuosli:0,contourf:6,contrast:[5,10,14,19,23],contribut:[0,1,2,3,11,12,13,14,20,21,22,23,26,28],contributor:[0,2,26,27],control:[0,2,5],conveni:[2,3,5,8,9,10,11,13,17,18,19,20,22],convent:[5,8,9,17,18],converg:[3,5,6,7],convergencewarn:[6,7],convert:[2,3,7,9,13,14,18,22,23],convex:4,convolut:[12,21],cookiecutt:28,coolwarm:[15,16,32],coordin:[3,5,7,10,11,12,13,19,20,21,22,25],coorel:3,copi:[5,27],corel:0,corioli:25,corner:[14,23],corona:25,corr:[3,7],correalt:[3,7],correct:[0,1,2,3,5,10,11,12,14,19,20,21,23,26],correct_predict:5,correctli:[3,5],correl:[0,2,5],correlation_matrix:[3,7],correspod:[14,23],correspond:[1,2,3,5,6,7,9,11,12,13,14,18,20,21,22,23],cortex:[5,31,33],cos:[3,9,10,11,12,13,14,18,19,20,21,22,23],cosh:[9,18],cosin:[3,12,21],cost:[0,1,2,3,4,6],could:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,26,27],coulomb:[2,13,22],count:[1,2],counter:[9,12,14,18,21,23],coupl:[3,9,10,12,18,19,21],cours:[0,1,3,7,8,9,10,11,17,18,19,20,25],cout:1,cov:[1,2,3,7],cov_xi:[3,7],cov_xx:[3,7],cov_yi:[3,7],covari:[0,2],covariance_matrix:[3,7],coven:26,cover:[0,2,12,13,21,22,24,25,29],covert:2,covxi:1,covxx:1,covxz:1,covyi:1,covyz:1,covzz:1,creat:[2,5,7,8,9,13,15,16,17,18,22,26,27,28,32],create_accuraci:5,create_biases_and_weight:5,create_dnn:5,create_loss:5,create_neural_network_kera:5,create_optimis:5,create_placehold:5,create_x:[3,7],creation:5,credit:[0,3,4,25,27],crim:3,crime:3,criteria:[1,2],critic:[0,11,20,25,26],criticallydamp:[12,21],cromer:[12,21,25],cross:[0,1,4,5,9,10,11,12,14,18,19,20,21,23,25],cross_val_scor:3,crossvalid:3,crucial:[1,5],csc:[12,21],csr_matrix:2,cstdlib:1,csv:[2,3],ctnk:5,ctrajectori:[13,22],cubic:2,cumsum:[2,7,9,18],cumul:3,current:[14,23,28],curs:[3,7],curv:[4,5,10,11,19,20],curvatur:[13,14,22,23],custom_lin:[15,16,32],cvxopt:6,cycl:[1,5,13,22],cycler:[15,16,32],cyclon:[14,23],cyclotron:[10,19],d2l:25,da_d:[13,22],da_i:[14,23],dagger:[2,3,9,18],dai:[5,8,10,14,17,19,23,25],damp:25,dampeddiffyq:[12,21],darkr:1,dat:[2,3,9,18],dat_id:[2,3,7,9,11,12,13,18,20,21,22],data:[4,6,8,9,10,11,12,13,15,16,17,18,19,20,21,22,32],data_id:[2,3,7,9,11,12,13,18,20,21,22],data_indic:5,data_panda:[2,9,18],data_path:[2,3,7,9,11,12,13,18,20,21,22],databas:[2,5],datafil:[2,3,7,9,11,12,13,18,20,21,22],datafram:[2,3,7,9,18],datapoint:[3,4,5,7],dataset:[3,4,6,7],date:[0,2,9,18],dbh:5,dbo:5,ddot:[10,12,13,14,19,21,22,23],ddrive:[12,21],dead:5,deadlin:25,deal:[0,1,2,3,5,6,7,9,14,18,23],dearli:0,debt:4,debug:3,decad:[0,2],decai:[1,2,10,12,19,21],decid:[0,3],decim:[2,3],decis:[0,2,5,6,7],decision_funct:6,decisiontreeregressor:2,declar:[2,3,9,18],decomposit:[0,5],decompost:3,decreas:[3,5,7,11,20],deduc:[0,2,10,19],deem:[10,19,26],deep:[2,4,10,19],deepen:[8,17],deeper:[0,2,8,10,11,17,19,20,25],def:[1,2,3,5,6,7,8,9,11,12,13,17,18,20,21,22],def_covari:1,defect:3,defici:3,defin:[1,2,3,4,6,7,8,9,11,12,13,14,17,18,20,21,22,23,25,26,31,33],definit:[3,6,7,8,9,10,12,13,14,17,18,19,21,22,23],defint:[1,9,18],deflect:[14,23],degre:[0,1,2,6,8,10,11,12,13,14,17,19,20,21,22,23],delet:[1,3],deliv:2,delta:[1,2,5,6,9,10,11,12,13,14,18,19,20,21,22,23],delta_:[2,5,9,18],delta_h:[2,5],delta_j:5,delta_k:5,delta_l:5,delta_n:[2,12,21],deltat:[9,11,12,13,18,20,21,22],deltax:[13,22],delv:2,demonstr:[2,3,4,5,12,14,21,23],demostr:[14,23],denomin:[5,12,13,21,22],denot:[1,3,4,5,11,14,20,23],dens:5,densiti:[1,3,10,13,19,22],depart:[14,23],departur:[13,22],depend:[1,2,3,4,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23,25,31,33],depict:1,deploy:[2,9,18],deposit:[13,22],deriv:[2,3,4,6,7,8,9,10,14,17,18,19,23,25],derogatori:26,descend:[3,7],descent:[0,3,4,6],descr:3,describ:[0,2,3,5,6,7,9,10,12,13,14,18,19,21,22,23],descript:[3,6,14,23],deserv:0,design:[2,4,5,10,12,19,21],designmatrix:3,desir:[0,2,3],despit:[5,10,19],det:3,detail:[2,7,9,11,13,18,20,22,25,26,27],detect:[5,6,14,23],detector:[13,22],determin:[0,1,2,3,5,6,7,9,10,11,12,14,18,19,20,21,23,25,26],determinist:[1,4],detial:25,detriment:0,dev:[1,5],develop:[0,2,6,7,8,9,10,11,12,13,17,18,19,20,21,22,25,27,28],deviat:[2,3,5,9,18],devic:[8,17],devis:5,df1:[2,9,18],diag:[3,6],diagnost:5,diagon:[1,2,3,4,9,18],diagonaliz:3,diagram:25,diagsvd:3,dial:[12,21],dialect:0,diamet:[14,23],dict:[3,6],dict_kei:3,dictionari:3,did:[3,4,5,7,10,12,14,19,21,23],die:5,died:[12,21],diff:[10,19],diffeent:6,differ:[0,1,2,3,5,7,9,10,11,12,13,14,18,19,20,21,22,23,25,26,31,33],differenti:[0,2,11,13,14,20,22,23,25],difficult:[0,1,3,5,10,11,14,19,20,23],difficulti:[0,5],digit:[0,2,5],dilut:5,dim:[7,12,21],dimens:[2,3,5,6,7,11,12,14,20,21,23],dimension:[0,2,9,11,12,13,18,20,21,22],dimensionless:[2,10,11,12,19,20,21],diment:[9,18],dimless:[10,19],diod:[12,21],direct:[0,2,3,5,7,9,10,11,12,13,14,18,19,20,21,22,23],directli:[1,3,5,9,13,18,22,31,33],directori:28,disabl:[26,28],disadvantag:2,disappear:[12,13,21,22],discard:[3,7],disciplin:[0,2,5],disclaim:[0,1],discours:[0,8,17],discov:0,discrep:[14,23],discret:[4,5,8,12,17,21],discrimin:[4,7],discuss:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,25],discussiom:25,diseas:4,disk:2,disord:4,displac:[11,12,14,20,21,23],displai:[1,2,3,5,6,7,9,13,18,22,31,33],displaystyl:3,disregard:2,disrupt:0,dissimilar:7,dissip:[10,19],dissipitav:[12,21],distanc:[1,3,6,7,10,11,13,14,19,20,22,23],distant:[13,22],distinct:[4,6],distinctli:6,distinguish:[1,2,6,7,10,19],distort:[13,14,22,23],distplot:3,distribuit:[9,18],distribut:[0,2,3,5,7,9,13,14,18,22,23],distrubut:[2,9,18],dive:[2,3,6,12,21],diverg:[5,13,22],divid:[0,1,2,3,5,6,7,9,10,12,13,18,19,21,22],divis:[1,3,6],dna:4,dnn:[2,5],dnn_kera:5,dnn_numpi:5,dnn_scikit:[2,5],dnn_tf:5,doc:[25,27,31,33],doconc:2,docstr:27,doctest:[8,17],document:[7,15,16,31,32,33],doe:[0,1,2,3,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23],doesn:[5,10,11,19,20,31,33],dog:5,doing:[2,3,7,10,19],dollar:[15,16,32],domain:6,domin:[2,10,13,19,22],don:[1,2,3,5,6,7,9,10,13,14,18,19,22,23],done:[1,2,3,7,9,10,11,12,13,14,18,19,20,21,22,23],door:[12,21],dot:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23],doubl:[1,2,9,10,13,14,18,19,22,23,25],doubli:[5,11,14,20,23],down:[2,3,7,10,12,13,14,19,21,22,23],download:[2,5,9,18],drag:[9,10,12,18,19,21],dramat:7,draw:[3,10,19],drawback:[3,7],drawn:[1,2,3,4,5,7,9,18],dream:0,drive:[0,10,12,19,21],driven:[25,27],drivenosc:[12,21],driver:0,drop:[1,2,3,7,14,23],dropna:[2,3],dry:0,dtype:[2,3,5,9,18],dub:2,due:[3,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23,25],dummi:3,dure:[0,2,5,6,7,12,14,21,23],dv_:[10,19],dv_x:[10,11,14,19,20,23],dv_y:[10,11,14,19,20,23],dv_z:[11,14,20,23],dwell:3,dwh:5,dwo:5,dx_1:1,dx_n:1,dxdy:[12,21],dying:5,e_0:[10,19],each:[0,1,2,3,4,5,6,7,9,11,12,13,14,18,20,21,22,23],eager:3,eapprox:[2,3],ear:0,earli:5,earlier:[3,4,5,6,7,11,12,20,21],earth:[10,13,14,19,22,23,25],earthsuneul:[11,20],earthsunvv:[11,20],easi:[0,2,3,4,5,6,7,9,10,11,12,13,18,19,20,21,22],easier:[0,1,2,3,6,13,22,25,27],easili:[0,2,3,4,5,6,7,8,9,10,11,12,17,18,19,20,21],east:[14,23],ebind:[2,3],eccentr:[13,22],econom:0,econometr:[2,9,18],ecosystem:[2,9,18,31,33],edgecolor:3,edit:[2,26],edu:25,educ:[0,2,3,8,12,17,21,25],eff:[1,13,14,22,23],effect:[1,5,9,10,12,18,19,21,25],effic:5,effici:[1,2,9,10,18,19],efron:[1,3],eig:[1,2,3,7],eigen:1,eigenpair:[3,7],eigenvalu:[2,3,6,7,9,18],eigenvector:[3,7],eight:[2,9,18],eigval:[1,2],eigvalu:7,eigvec:[1,2],eigvector:7,eispack:[2,9,18],either:[0,1,2,3,4,5,6,7,10,11,12,13,14,19,20,21,22,23],elabor:1,elast:[13,22],electr:[2,5,10,12,13,19,21,22],electrodynam:[13,22],electromagnet:[10,13,19,22],electron:[8,11,13,17,20,22,26],eleg:7,elel:[9,18],element:[0,2,3,4,5,6,7,8,10,11,17,19,20],elementari:[2,9,18,25],elessar:[2,9,18],elimin:[6,12,13,21,22],ellips:[13,14,22,23],ellipt:[14,23,25],els:[1,4,5,10,19],elu:5,elus:0,email:25,emb:[15,16,32],embed:[3,7],embodi:3,emit:[1,11,20],empathi:26,emphas:[0,2,12,21,25],emphasi:[2,9,18],empir:[1,5,7],emploi:[1,2,3,5,7,10,12,19,21],employ:[0,2,3],employe:0,empti:3,emul:5,enabl:[7,8,17],enbodi:[12,21],encapsul:[12,13,21,22],encod:[0,7],encompass:[0,1,2,10,19],encount:[0,1,3,4,5,13,22],end:[0,1,2,3,4,5,6,7,9,10,11,12,13,14,15,16,18,19,20,21,22,23,25,32],endl:1,endpoint:[1,3,12,21],energi:[9,10,12,13,14,18,19,21,22,23,25],enforc:5,engag:[8,17],engin:[0,1,2,5,9,10,18,19,25],enhanc:[8,17,25,27],enough:[0,3,10,13,14,19,22,23],enquiri:[10,19],enscrib:[11,20],ensembl:[1,5],ensur:[1,3,5,7,12,13,21,22],entail:2,enter:[0,1,3,12,14,21,23],enthought:[2,9,18],entir:[1,2,4,5,9,12,13,18,21,22,31,33],entiti:[2,5,9,18],entitl:0,entri:[2,3,5,6,7],entropi:[2,4,5],enumer:[2,3,5,6],env:1,environ:[2,8,9,10,17,18,19,26,28],eol:3,eosfit:3,epoch:[2,5],epsilon:[3,4,11,20],epsilon_0:[3,13,22],epsilon_1:3,epsilon_2:3,epsilon_:[2,3,10,11,19,20],epsilon_i:3,eqnarrai:[3,10,11,12,13,14,19,20,21,22,23],equador:[14,23],equal:[0,1,2,3,5,6,7,9,10,12,13,14,18,19,21,22,23],equat:[0,1,2,4,7,8,13,14,17,22,23,25],equatori:[14,23],equilibrium:[5,10,19],equiv:[1,11,12,13,14,20,21,22,23],equival:[2,3,5,6,7,9,11,12,13,18,20,21,22],erf:1,eriador:[2,9,18],eridg:3,err:2,err_:3,error:[0,1,2,4,5,7,8,12,17,21],error_estimate_corr_tim:1,error_hidden:5,error_output:5,escap:[15,16,32],especi:[5,11,12,13,20,21,22],essenti:[0,1,2,3,5,8,10,14,17,19,23],establish:7,estim:[0,1,2,3,4,5,11,20],estimated_mse_fold:3,estimated_mse_kfold:3,estimated_mse_sklearn:3,eta0:6,eta:[2,5,6,12,14,21,23],eta_v:[2,5],etc:[0,1,3,4,5,6,7,9,10,15,16,18,19,25,32],ethic:[8,17],ethnic:26,etsim:3,euclidean:[3,7],euler:[10,12,19,21,25],eulerintegr:[9,18],eurler:[9,18],european:0,evalu:[0,1,2,3,8,10,11,12,17,19,20,21,25],even:[0,1,2,3,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23,27],event:[0,4,26],eventson:3,eventu:[3,5,7,10,14,19,23],everest:[14,23],everi:[1,2,3,5,7,9,10,11,14,18,19,20,23,27],everybodi:[0,25],everyon:26,everyth:[5,10,13,19,22],evid:[10,19,31,33],evolut:[12,13,21,22],evolv:[0,2],exact:[1,2,3,5,7,8,9,10,11,12,17,18,19,20,21],exactli:[3,5,7,13,14,22,23],exam:25,examin:3,exampl:[0,4,10,12,14,15,16,19,21,23,25,26,31,32,33],exce:5,excel:[0,2,3,5,28],except:[1,3,6,10,14,19,23],excess:2,excit:[0,2,12,13,21,22],exclud:[3,5],exclus:[1,2,3],execut:3,executablebook:28,exercis:[0,2,3,8,10,11,17,19,20,25],exert:[11,20],exhaust:3,exhibit:[3,6],exist:[0,2,3,5,6,7,9,11,12,13,18,20,21,22,28,31,33],exit:[1,3],exp:[1,3,4,5,6,7,12,21],exp_term:5,expand:[3,4,7,9,12,18,21],expans:[3,5,6,11,12,13,20,21,22],expect:[0,2,5,7,10,12,13,14,19,21,22,23,26],expectation_value_of_h_wrt_p:1,expens:1,experi:[0,2,3,5,6,8,10,13,14,17,19,22,23,26],experiment:[1,2,3,10,13,19,22],experimentalist:[13,22],expert:5,explain:[1,2,3,7,14,23,27],explained_variance_ratio_:7,explanatori:3,explicit:[2,3,9,11,12,14,18,20,21,23,26],explicitli:[0,2,11,20],explod:5,exploit:[3,5],explor:[2,3,6,8,9,17,18],expon:5,exponenti:[2,5,10,12,19,21],expos:0,express:[1,2,4,5,9,10,12,13,14,18,19,21,22,23,26],exptmean:1,exptvari:1,ext:[12,21],extend:[0,4,7,8,9,17,18],extens:[0,2,3,5,11,13,20,22,31,33],extent:[0,2,3,25],extern:[3,10,11,12,13,14,19,20,21,22,23],extra:[3,5,12,21,25],extract:[0,2,3,4,6,7,10,12,13,19,21,22],extrapol:[2,3],extrem:[0,2,3,4,5,6,7,8,9,17,18],extrins:7,eye:[0,2],f11:2,f12:2,f13:2,f6d7a289d493:[2,9,18],f_0:[11,12,20,21],f_0b:[11,20],f_0e:[12,21],f_2:5,f_3:5,f_d:1,f_g:[11,20],f_h:[11,20],f_i:[3,5,10,12,19,21],f_m:[12,21],f_n:[12,21],f_r:[13,22],f_x:[10,11,13,19,20,22],f_xv_x:[11,20],f_y:[10,13,19,22],f_yv_i:[11,20],f_zv_z:[11,20],face:26,facecolor:[1,3,6],facil:0,facilit:5,fact:[0,2,3,5,7,9,11,12,13,14,18,20,21,22,23],factor:[1,2,3,5,7,10,11,13,19,20,22],fade:3,fail:[3,6,7,13,22],failur:4,fair:26,fairli:1,faith:26,fall:[6,13,22,25],fallingbasebal:[9,18],fals:[2,3,4,5,12,21],famili:[0,1,2,4,6,7,9,12,18,21,25],familiar:[0,1,2,6,9,11,13,18,20,22],famou:[0,3,5],fanci:0,far:[0,1,2,3,5,6,7,10,13,19,22],fashion:[0,8,17],fast:[1,2,3,5,9,14,18,23],fastdriven1:[12,21],fastdriven2:[12,21],faster:7,favor:4,favorit:1,fc1:5,fc2:5,featur:[1,4,5,12,21],feature_nam:[3,7],feb:25,februari:[12,21],fed:[0,5],feed:[0,2,7,10,19],feed_dict:5,feed_forward:5,feed_forward_out:5,feed_forward_train:5,feedforward:5,feel:[2,7,9,11,12,14,18,20,21,23,30],feet:[3,14,23],fellow:0,felt:[10,19],few:[1,2,5,24,29],fewer:[2,7],ffedbda27704:[12,21],ffnn:5,fictiti:[14,23],field:[0,2,3,5,11,12,13,14,20,21,22,23,25],fifth:[2,9,18],fig:[2,3,4,5,7,9,11,12,13,15,16,18,20,21,22,32],fig_id:[2,3,7,9,11,12,13,18,20,21,22],figaxi:1,figsiz:[2,3,5,6,7,9,15,16,18,32],figur:[2,3,4,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23],figure_id:[2,3,7,9,11,12,13,18,20,21,22],figurefil:[2,3,7,9,11,12,13,18,20,21,22],file:[1,2,3,5,6,7,9,11,12,13,18,20,21,22,25,27],filenam:[1,2,3,9,18],fileout:1,filewrit:5,fill:3,financ:[0,2],find:[0,1,2,4,5,6,7,8,10,11,12,13,14,17,19,20,21,22,23,25],fine:5,finish:[10,19],finit:[1,3,5,13,22],first:[0,1,3,4,7,8,11,12,13,14,17,20,21,22,23,25,31,33],firsteigvector:7,fit:[0,1,4,5,6,7,10,19],fit_intercept:3,fit_transform:[2,3,6,7],fiti:2,five:[2,3],fix:[2,5,10,11,12,13,14,15,16,19,20,21,22,23,32],flat:5,flatten:5,flavor:[31,33],flexibl:[2,3,5,6,8,9,12,17,18,21],flip:[13,22],float32:5,float64:[2,3,9,18],floor:[9,18],flop:3,flow:[5,10,14,19,23],fly:[7,13,22],flyvbjerg:1,fmax:[12,21],focault:[14,23],foci:[13,22],focoault:[14,23],focu:[0,2,3,9,10,13,14,18,19,22,23],focus:[4,5,12,21,26],folder:[2,9,18,25],folk:0,follow:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,26,31,33],font:[1,2,9,12,18,21],fontdict:1,fontsiz:[1,3,6],footbal:[13,22],foral:6,forc:[3,7,8,9,11,17,18,20,25],forcedblockeulercrom:[12,21],forcedblockrk4:[12,21],forecast:5,forest:[0,2,5],forget:7,fork:27,form:[0,1,2,3,4,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23],formal:[1,9,11,14,18,20,23,25],formalim:25,format:[1,2,3,6,7,8,9,11,12,13,17,18,20,21,22],formul:[3,7,10,19],formula:[1,9,11,12,13,18,20,21,22],forth:[5,13,14,22,23],fortran90:1,fortran:[0,2,9,18],fortun:[3,7],forum:25,forward:[2,3,9,10,11,12,14,18,19,20,21,23],forwardeul:[12,21],forwardeulercrom:[12,21],foster:26,foucalt:25,foucault:25,found:[3,5,7,10,12,13,19,21,22,28],foundat:[8,17],four:[5,6,11,14,20,23],fourier:[3,25],fourierdef1:[12,21],fourierdef2:[12,21],fourierseriessign:[12,21],fouriersolut:[12,21],fourpi2:[11,20],fourth:[2,5,9,12,18,21],frac:[1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23],frame:[7,10,13,19,22,25],framework:[0,1,5,6],frankefunct:[3,7],free:[1,2,7,9,18,26],freedom:[8,10,12,13,17,19,21,22],freeli:[0,2],freewai:[10,19],frequenc:[1,3,7,9,10,12,13,14,18,19,21,22,23],frequent:[0,2,6],frib:25,friction:[10,12,19,21,25],frictionless:[10,19],fridai:25,friendli:[12,21],frodo:[2,9,18],from:[0,1,2,4,6,7,8,9,10,11,12,13,15,16,17,18,19,20,21,22,25,26,32],front:[0,2],frontier:[31,33],frydai:25,fstream:1,ftild:[12,21],fuel:[10,19],fulfil:[3,5,10,19],full:[0,1,2,3,4,9,18],fulli:[1,3,5,28],fun:[2,9,18],func:3,functionali:7,fundament:[0,3,10,12,19,21],further:[2,8,9,10,11,13,14,17,18,19,20,22,23,25,26],furthermor:[2,3,4,5,7,8,9,10,17,18,19],furthest:[14,23],futur:[0,2,6,10,12,19,21],futurist:0,fwhm:[12,21],g_m:[12,21],g_n:[12,21],gain:[0,3,5,8,10,11,12,17,19,20,21,25],galaxi:[10,19],galleri:[0,2],gallon:[13,22],gamge:[2,9,18],gamma1:6,gamma2:6,gamma:[3,6,7,10,12,13,14,19,21,22,23],gamma_:3,gamma_i:[1,3,6],gamma_x:3,gap:6,gate:5,gather:5,gaug:5,gauss:[13,22],gaussian:[3,6,12,21],gaussian_rbf:6,gca:[3,6],gen:1,gender:[3,26],gener:[0,2,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,25],generallay:5,genet:[0,5],geodes:[7,14,23],geometr:[2,10,11,19,20],geq:[3,6],get:[0,1,3,4,5,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,25,30],get_default_graph:5,get_yaxi:6,get_yticklabel:3,getattr:3,ggplot:[9,18],ghp:28,gibb:0,git:[0,25],github:[0,2,25,27,28],gitlab:0,give:[0,1,2,3,4,5,6,9,10,11,12,13,14,18,19,20,21,22,23,25,30],given:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,27],global:[1,4,11,12,20,21],global_step:5,global_variables_initi:5,glorot:5,gm_1m_2:[13,22],gm_:[11,13,20,22],gm_am_b:[13,22],gmm:[13,14,22,23],goal:[0,2,3,4,10,19],goe:[2,3,5,11,12,13,20,21,22,25],going:[2,5,6,7,10,14,19,23],gold:[13,22],gone:3,gong:5,good:[1,2,3,5,7,8,10,12,17,19,21,25,26],googl:[2,5,9,18],got:5,govern:[8,10,17,19],gracefulli:26,grader:25,gradient:[0,2,3,4,6,14,23],gradientdescentoptim:5,gradual:[10,12,19,21],graph:[0,5,7],graphic:[2,5,8,10,17,19],grasp:[0,2],gravgauss:[13,22],gravit:[5,9,10,11,12,14,18,19,20,21,23,25],graviti:[9,13,14,18,22,23,25],gray_r:5,graze:[13,22],great:[10,19],greater:[1,5,7],greatli:27,green:[1,2,12,21],greeni:[12,21],greeny2:[12,21],grid:[1,3,4,5,6,10,13,19,22],ground:[2,9,14,18,23],group:[0,2,3],groupbi:[2,3],grow:5,growth:2,guarante:[0,1,3,7],guess:[5,10,12,14,19,21,23],guid:[0,5,15,16,32],habit:[8,17],had:[0,2,3,5,10,11,13,19,20,22],hadamard:5,half:[5,6,13,22],hamiltonian:[11,20],hand:[0,1,2,3,5,7,8,9,10,13,14,17,18,19,22,23,25],handi:[11,14,20,23],handl:[5,7],handsid:5,handwrit:5,handwritten:5,handwrittennot:25,happen:[1,5,10,13,19,22],harass:26,hard:[4,5,6],hardcopi:[2,9,18],harder:[3,5,7],harm:26,harmon:[10,11,19,20,25],has:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,25,28,31,33],hassl:[2,9,18],hast:0,hat:[1,2,3,4,5,7,9,10,11,12,13,14,18,19,20,21,22,23],have:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,25,26],haven:5,hbar:[11,20],hdf5:2,hdhpk14:[31,33],head:[1,3],header:[2,3],hear:[0,2],heart:[0,2],heatmap:[2,3,5,7],heavi:[8,13,17,22],heavili:[0,2],heavisid:5,heer:[31,33],height:[5,10,11,13,14,19,20,22,23],helic:[10,19],help:[0,5,8,13,17,22,27],hemispher:[14,23],henc:[2,3,5,6,10,19],her:4,here:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,25,27,28,31,32,33],hereaft:[3,5,6,11,14,20,23],hermitian:[2,9,18],hessenberg:[2,9,18],hhint:[11,20],hidden:5,hidden_bia:5,hidden_bias_gradi:5,hidden_layer_s:[2,5],hidden_weight:5,hidden_weights_gradi:5,high:[0,2,3,5,7,9,12,14,18,21,23],higher:[0,2,3,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23],highest:5,highli:[1,2,3,9,18],highwai:3,hinder:0,hing:6,hire:[0,2],his:4,hist:[1,3,7],histogram:[1,3,7],histor:[4,7],histori:5,histtyp:3,hit:[0,9,10,13,18,19,22],hjensen:[6,7,25],hjorth:25,hobbi:1,hoc:3,hold:[1,3,5,10,12,14,19,21,23],holder:3,holdgraf:[31,33],holdgraf_evidence_2014:[31,33],home:[3,25],homework:[11,13,20,22,25],homogen:[5,10,12,14,19,21,23],homogn:[10,19],homogsolut:[12,21],hope:[0,8,17],hopefulli:[1,3,7,10,19],horizont:[7,10,14,19,23],hors:4,hot:[5,15,16,32],hour:[1,5,14,23,25],how:[0,2,4,5,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,24,25,27,29,30],howev:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23],hspace:[1,2,6,9,10,12,18,19,21],htm:25,html:[2,7,8,15,16,17,25,28,32],http:[2,5,7,9,18,25],huang:2,huber:2,huge:5,human:[0,2,5,31,33],hundr:5,hungri:5,hurrican:[14,23],hv_:[11,20],hw10:25,hydrogen:2,hyperbola:[13,22],hyperparam:6,hyperparamet:3,hyperplan:7,i_1:3,i_2:3,i_c:[12,21],i_i:[12,21],idea:[0,1,2,3,5],ideal:[0,1,2,3,6,8,10,12,17,19,21],idem:3,ident:[3,5,12,21,26],identifi:[0,2,4,5,6,7,8,13,17,22],idum:1,ieor:1,iet:[12,21],ifs:[2,9,18],ignor:[3,7,9,11,13,14,18,20,22,23],iii:[2,9,18],ijk:[10,11,19,20],illustr:[0,5,10,13,14,19,22,23],imag:[3,5,7,15,16,32],image_path:[2,3,7,9,11,12,13,18,20,21,22],imageri:26,imagin:[10,11,19,20],imaginari:[12,14,21,23],immedi:[0,2,3,12,21,25],impact:[0,8,13,17,22],impart:[10,19],implement:[2,3,6,7,8,10,11,12,17,19,20,21,25],impli:[2,3,8,9,12,17,18,21],implic:[10,19],implicitli:[1,7],impos:[0,3,5,7],imposs:[0,3],impress:[0,2,5],improv:[0,3,7,10,11,12,19,20,21],impuls:[12,21],imshow:[3,5],inact:5,inadequ:0,inappropri:26,incid:[13,22,26],includ:[1,2,3,5,7,8,10,12,13,14,15,16,17,19,21,22,23,26,27,31,32,33],include_bia:3,inclus:[8,17,26],incom:[5,13,22],inconsist:[12,21],incorpor:[12,14,21,23],incorrect:5,incoveni:6,increas:[0,1,2,3,5,6,7,8,11,12,13,17,20,21,22],increasingli:1,incred:0,increment:[8,17],ind:3,inde:[0,2,3,10,11,12,13,19,20,21,22],indent:[1,12,21],indentationerror:1,independ:[1,3,4,5,6,9,10,11,12,13,14,18,19,20,21,22,23,25],index:[1,2,3,5,9,18],index_col:[2,3],indic:[2,3,5,7,9,10,18,19],indispens:3,individu:[1,4,5,12,13,21,22,26],indu:3,industri:[8,17],inelast:[13,22],inequ:[0,6],inerti:[10,19,25],inertia:[10,19],inf:3,infam:0,infer:[0,3,5,13,22],infil:[2,3,9,18],infin:[3,7,12,21],infinit:[0,10,12,13,19,21,22],infinitesim:[1,12,21],influenc:[3,9,10,13,18,19,22],influenti:5,info:[2,5,9,18],inform:[0,2,3,5,7,11,13,15,16,20,22,26,28,31,32,33],infti:[1,10,12,19,21],ingredi:[0,2],inher:3,inherit:[2,9,18],init:[31,33],initi:[1,2,3,5,9,10,11,12,13,14,18,19,20,21,22,23],initialis:1,inlin:[1,2,3,4,5,6,7,8,9,11,12,13,17,18,20,21,22],inner:3,inoccu:0,input:[0,1,2,3,4,5,6,7,8,9,11,12,17,18,20,21,31,33],inputs_shuffl:5,insert:[1,5,6,9,11,12,13,14,18,20,21,22,23,31,33],insid:[3,7,13,22,31,33],insight:[0,2,3,5,8,10,17,19,25],inspect:[10,12,13,19,21,22],inspir:[0,2,5],instal:[5,25,27,28],instanc:[0,3,5,7,10,19,26],instant:[11,20],instantan:[9,18],instead:[0,1,2,3,5,6,7,8,9,10,11,13,17,18,19,20,22],institut:[0,5],instruct:[0,5],instructor:25,insult:26,int32:5,int64:3,int_0:[1,8,9,10,11,12,14,17,18,19,20,21,23],int_:[1,9,10,11,12,18,19,20,21],int_a:[1,8,11,17,20],integ:[1,2,5,9,13,18,22],integer_vector:5,integr:[0,1,2,8,10,12,13,17,19,21,22,25],integraldef:[11,20],integrand:[12,21],intellig:[0,2],intens:[5,8,17],interact:[2,3,5,9,10,12,13,15,16,18,19,21,22,32],intercept:[2,3,6],intercept_:[2,3,6],interchang:5,interest:[0,1,2,3,4,5,6,7,9,11,12,14,18,20,21,23,26],interfac:[2,5,8,17],interior:2,intermedi:[12,21],intern:[5,10,11,13,19,20,22,31,33],internet:[14,23],interpol:[5,11,20],interpr:3,interpret:[0,1,2,5,9,10,11,18,19,20],interv:[1,3,4,8,10,11,12,17,19,20,21],intimid:2,intract:[3,7],intrins:[1,2,7,9,18],intro:[31,33],introduc:[0,1,2,5,6,8,9,10,11,12,14,17,18,19,20,21,23,25],introduct:[3,5,25],introductori:[2,3],intuit:[2,3,5,6],inv:3,invalid:[2,5,6,7,9,18],invalu:[2,8,9,17,18],invari:[5,11,20],invd:3,inver:6,invers:[2,3,7,9,10,12,13,18,19,21,22],invers_period:1,inverse_transform:6,invert:[3,4,10,11,19,20],investig:[8,17,26],invis:[13,22],invok:[3,6,10,19],involv:[0,3,4,5,7,9,10,12,13,18,19,21,22],inward:[14,23],iomanip:1,ion:[15,16,32],ios:1,iostream:1,ipca:7,ipynb:[2,9,18,31,33],ipython:[1,2,3,5,6,7,9,12,18,21],iri:6,irreduc:3,irrelev:[3,12,21],irrespect:[0,2],ising:5,ismov:[10,19],isnul:3,isol:[9,11,18,20],isomap:7,isotrop:[14,23],issu:[0,5,26,27],item:[0,2,3],items:[2,9,18],iter:[1,3,5,6,7,10,19],its:[0,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,26,27,31,33],itself:[1,3,5,10,11,12,13,19,20,21,22],j_lasso_sk:3,j_ridge_sk:3,j_sk:3,jackknavg:1,jackknif:0,jackknstd:1,jackknvar:1,jackknvec:1,januari:7,jargon:1,jensen:25,jeremi:25,job:[6,10,19],john:25,join:[2,3,7,9,11,12,13,18,20,21,22],joul:[9,18],journal:1,jrt:25,juli:25,jump:1,jupyt:[0,2,8,9,15,16,17,18,28,31,32,33],jupytext:[31,33],just:[0,1,2,3,4,5,6,7,9,10,11,12,13,18,19,20,21,22,25],justif:[0,2],k1v:[12,21],k1x:[12,21],k2v:[12,21],k2x:[12,21],k3v:[12,21],k3x:[12,21],k4v:[12,21],k4x:[12,21],k_1:[12,21],k_2:[12,21],k_3:[12,21],k_4:[12,21],kappa_d:1,karush:6,keep:[0,2,3,5,7,8,9,10,11,12,15,16,17,18,19,20,21,27,32],keepdim:[3,5],kei:[3,5,12,21],kepler:[13,22,25],kept:[12,21],kera:[0,2,9,18],kernel:[3,5,31,33],kernel_regular:5,kernelpca:7,kev:[2,3],keyword:[2,9,18],kfold:3,kick:5,kilogram:[9,18],kind:[0,3,5,6,10,13,19,22,31,33],kindergarten:0,kinet:[9,10,11,12,13,18,19,20,21,22],kkt:6,knight:[31,33],know:[0,1,2,3,6,9,10,12,13,14,18,19,21,22,23,25],knowledg:[0,2,3,8,17,25],known:[0,1,3,4,5,6,7,9,10,11,12,14,18,19,20,21,23,25],kondev:2,kpca:7,kr_:[13,22],krh:[13,22],kuhn:6,kutta2:[12,21],kutta4:[12,21],kutta:25,kwarg:3,kwown:3,l2_loss:5,l_1:4,l_2:4,l_j:5,l_z:[11,20],la_:[15,16,32],la_i:5,la_k:5,lab:[0,13,22],label:[1,2,3,4,5,6,10,11,12,13,14,19,20,21,22,23],labels:[3,6],labels_shuffl:5,laboratori:[10,13,14,19,22,23],lack:[0,2],lad:0,lagrang:[6,7,11,20,25],lagrangian:[11,20,25],lai:[8,17],lambda:[1,2,4,5,6],lambda_0:7,lambda_1:[3,6,7],lambda_2:[6,7],lambda_:7,lambda_i:[6,7],lambda_iy_i:6,lambda_jy_iy_j:6,lambda_k:6,lambda_n:[3,6],land:[3,6],landmark:6,langl:[1,3,7],langrangian:25,languag:[2,5,6,9,18,26,31,33],lapack:[2,9,18],larg:[0,1,2,3,5,6,7,8,9,10,12,13,17,18,19,21,22,25],larger:[1,2,3,6,7,8,12,17,21],largest:[6,7],lass:0,lasso:4,lasso_sk:3,last:[0,1,2,3,5,9,10,11,12,13,14,18,19,20,21,22,23],later:[0,1,2,3,4,5,6,9,10,11,12,13,18,19,20,21,22],latest:25,latex:[2,8,9,17,18],latitud:[14,23],latter:[0,1,2,3,4,6,7,9,10,11,12,13,14,18,19,20,21,22,23],lattic:5,launch:0,law:[0,2,5,8,9,12,13,14,17,18,21,22,23,25],layer:2,lbfg:7,lbl:3,lcc:3,lda:7,ldot:[1,3,7],lead:[0,1,2,3,4,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23],leader:0,leadership:26,leaki:5,learn:[4,6,9,18],learning_r:[5,6],learning_rate_init:[2,5],least:[0,1,2,4,6,7,9,10,18,19],leav:[3,5,7,11,13,20,22],lectur:[0,2,3,5,7,9,12,14,18,21,23],lecturenot:27,left:[1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23],leftarrow:[5,6],legend:[2,3,6,7,9,15,16,18,32],len:[1,2,3,5,6,7,9,18],length:[1,2,3,5,6,7,9,10,11,12,18,19,20,21],lengthi:[14,23],leq:[1,2,3,4,6],less:[0,1,2,3,5,6,8,9,12,13,14,17,18,21,22,23,31,33],let:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23],letter:[1,2,3,9,18],level:[2,3,5,8,9,14,17,18,23,26],levi:[11,20],lhs:[9,18],lib:[3,6,7],liblinear:6,librari:[0,1,3,5,7,8,17],licens:[2,5,9,18],lie:[1,3,7],lies:[6,7,8,17],life:[0,2,5,6,8,14,17,23],light:[2,10,19],lightgrai:[13,22],like:[0,1,2,3,4,5,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,25,28,31,33],likelihood:[0,3,5],lim_:[1,9,18],limit:[3,6,7,8,9,10,11,12,14,17,18,19,20,21,23,25],lin_clf:6,lin_model:3,linalg:[1,2,3,6,7],line1:6,line2:6,line2d:[15,16,32],line3:6,line:[0,1,2,3,6,7,8,9,12,14,15,16,17,18,21,23,31,32,33],linear:[0,1,4,5,7,9,10,12,18,19,21,25],linear_model:[2,3,6,7],linear_regress:3,linearli:[3,7,10,12,19,21],linearregress:[2,3],linearsvc:6,liner:5,linestyl:[13,22],linewidth:[2,3,6],link:[2,5,14,23],linpack:[2,9,18],linreg:2,linspac:[1,2,3,6,12,13,15,16,21,22,32],linux:[2,5,9,18],liquid:[2,3],list:[2,3,9,12,18,21,27,28],listcomp:3,literatur:[4,5,13,22,25],littl:[5,9,13,18,22,27],live:6,lle:3,lmb:3,lmbd:[2,5],lmbd_val:[2,5],load:[2,3],load_boston:3,load_breast_canc:7,load_digit:5,load_iri:6,loc:[2,3,6,7,9,18],local:[3,4,5,7,11,12,13,14,20,21,22,23,27,28],locat:[6,13,22,25],log10:[3,8,17],log:[2,3,4,5,7,9,18],log_:2,logarithm:[2,4,9,18],logic:[0,2],logist:[2,3,6],logisticregress:7,logit:[4,5],logreg:7,logspac:[2,3,5,15,16,32],longer:[1,2,6,9,10,11,12,13,18,19,20,21,22],loocv:3,look:[0,1,2,3,5,6,7,9,10,11,13,14,18,19,20,22,23,27,31,33],loop:[1,2,3,5,9,10,11,18,19,20],loos:[14,23],lorentz:[14,23],lose:5,loss:[0,2,3,4,5,6,7,9,10,11,18,19,20],lost:[12,21],lot:[3,8,15,16,17,32],love:[10,12,19,21],low:[1,3,7,13,14,22,23],lower:[2,3,5,9,11,12,13,14,18,20,21,22,23],lowercas:[2,9,18],lowest:1,lstat:3,lstsq:3,lvert:5,m_0:[11,20],m_1:[13,22],m_1m_2:[13,22],m_2:[13,22],m_e:[11,20],m_h:2,m_i:[11,20],m_iv_i:[11,20],m_l:5,m_n:2,m_p:2,machin:[3,4,5,9,18],made:[0,2,4,5,7,8,11,12,17,20,21],mae:2,magnitud:[5,7,9,10,11,12,13,14,18,19,20,21,22,23],mai:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,17,18,19,20,21,23,26,28],mail:[25,26],main:[0,2,3,4,12,21,28],mainli:[2,3,4,10,12,19,21],maintain:[3,10,12,19,21,26],major:[2,3,5,8,9,17,18],make:[0,1,2,3,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,25,26,27,32],make_axes_locat:3,make_moon:6,make_pipelin:[2,3],makedir:[2,3,7,9,11,12,13,18,20,21,22],makeplot:[2,9,18],malign:7,malth:25,manag:[2,5,9,18],mani:[0,1,2,3,4,6,7,9,10,12,13,14,18,19,21,22,23,24,25,29,31,33],manifestli:[11,20],manifold:7,manner:[14,23],manual:[8,17,28],map:[0,1,2,3,4,5,6,7],margin:[0,2,6,11,20],marit:3,mark:[2,9,18],markedli:[31,33],marker:[2,3],market:0,markov:0,markup:[31,33],marsaglia:1,mask:1,mass:[3,5,9,10,11,12,14,18,19,20,21,23,25],massag:2,masses2016:2,masses2016ol:3,masses2016tre:2,masseval2016:[2,3,9,18],massiv:[14,23],master:25,match:[5,13,22],materi:[0,2,3,4,5,7,8,9,10,11,12,14,17,18,19,20,21,23],math:[1,2,4,5,8,9,11,12,13,15,16,17,18,20,21,22,32],mathbb:[1,3,4,5,6,7],mathbf:[1,2,3,4,6,9,18],mathcal:[3,4,5],mathemat:[0,1,2,7,8,10,12,17,19,21,25],mathemati:[2,9,18],mathemt:3,mathrm:[1,2,3,4,5,6,7,9,10,11,12,14,18,19,20,21,23],matmul:[3,5],matplotlib:[1,2,3,4,5,6,7,8,9,11,12,13,15,16,17,18,20,21,22,32],matric:[3,4,6,7],matrix:[4,6],matter:7,matur:[8,17],max:[2,3,5,7,11,12,13,20,21,22],max_depth:2,max_it:[2,5,6,7],maxdegre:3,maxim:[4,5,6,7],maxima:[13,22],maximum:[2,3,6,7,10,11,12,13,19,20,21,22],maxpolydegre:3,mbox:[3,15,16,32],mcculloch:5,mcint:1,mcintsqr2:1,mean:[0,2,3,4,5,8,9,10,11,12,14,15,16,17,18,19,20,21,23,25,32],mean_absolute_error:[2,3],mean_i:1,mean_squared_error:[2,3,7],mean_squared_log_error:2,mean_x:1,meaning:0,meansquarederror:2,meant:[0,4,8,13,17,22,25],meantempvec:1,meanvec:1,measur:[1,2,3,5,7,9,10,12,13,14,18,19,21,22,23],mechan:[0,1,8,10,11,12,14,17,19,20,21,23,33],mechanist:0,media:[25,26],median:[2,3,7],mediaspac:25,medicin:[0,5],medium:[6,10,12,15,16,19,21,32],medv:3,meet:[8,17],mehta:3,member:26,memori:[5,7,12,21],mention:[1,2,5,10,12,13,19,21,22],mere:[13,22],mersienn:1,mesh:[9,10,11,18,19,20],meshgrid:[3,6,7],messi:[12,13,21,22],met:[0,2,3,6,7,11,20],metadata:[31,33],meter:[9,13,18,22],method:[0,2,4,5,6,7,8,10,13,17,19,22,25],methodolog:[8,17],metric:[2,3,5,7],metropoli:0,mev:[1,2,3],mgh:[13,14,22,23],mgl:[12,21],mglearn:[2,9,18],mgsin:[10,12,19,21],mgx:[14,23],mgy:[14,23],mhjensen:25,michigan:33,mid:[5,7,11,20],midpoint:[11,12,20,21,25],midterm:25,might:[3,5,7,10,11,13,19,20,22,27],mileag:[10,19],miller:1,million:[2,3,7],mimic:5,min:[3,6,7,13,22],min_:3,mind:[0,2,3],mine:[2,9,18],mini:[5,7],minibatch:[5,7],minim:[0,1,2,3,4,5,7,12,13,21,22],minima:[2,4,5,13,22],minimum:[3,5,6,7,12,13,21,22],minmaxscal:[3,7],minneapoli:[14,23],minor:1,minut:[13,22],misclassif:6,misclassifi:6,mismatch:5,miss:3,mix:[5,9,10,12,18,19,21],mkdir:[2,3,7,9,11,12,13,18,20,21,22],mlab:[1,3],mle:[1,4],mlk:25,mlpclassifi:5,mlpregressor:2,mnist:[5,7],mod:1,mode:[1,12,21],model:[1,4,6,7,8,13,17,22],model_select:[2,3,5,7],modern:[0,2,3,4,8,17],modif:[5,13,22],modifi:[2,3,4,5,6,9,14,18,23],modul:[2,3,5,7,8,9,17,18],modular:[1,8,17],modulo:1,moe:[3,7],molecul:[10,19],molten:[14,23],moment:3,momenta:[9,13,18,22],momentum:[9,10,12,13,18,19,21,22,25],mondai:25,monoton:[1,5],monstertruck:0,mont:[0,1,2,3],montecarlocycl:1,moon:[13,22],moor:3,more:[0,1,5,8,11,13,14,15,16,17,20,22,23,25,27,28,31,32,33],moreoev:33,moreov:[2,31],morten:25,most:[0,1,2,3,4,5,6,7,8,9,10,11,13,14,17,18,19,20,22,23,31,33],mostli:[5,7],motion:[0,2,8,11,12,14,17,20,21,23,25],motiv:[5,10,12,19,21],mount:[14,23],move:[1,2,3,4,5,10,11,13,14,19,20,22,23,25],mpatch:[9,18],mph:[10,19],mpl:[2,9,12,18,21],mpl_toolkit:3,mplregressor:5,mr_:[13,22],mrv_:[13,22],mse:[2,3,7],msle:2,msu:25,mt19937_64:1,mu0:1,mu1:1,mu2:1,mu_:1,mu_k:[10,19],mu_n:7,mu_x:1,much:[0,1,2,3,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23],multi:[2,3,4,9,18],multiclass:[4,5],multidimension:[2,5,7,9,18],multinomi:4,multipl:[1,3,4,9,10,18,19],multipli:[1,3,7,9,10,11,14,18,19,20,23,25],multiplum:6,multitud:2,multivari:[0,1,2,7],multivariate_norm:7,murphi:7,must:[1,3,5,6,10,12,13,14,19,21,22,23,31,33],mutat:4,mutual:3,mv_0:[11,20],mv_:[13,22],mv_e:[11,20],mvn:1,mx_:1,mydirectivenam:[31,33],myriad:[2,9,18],mz1:1,mz2:1,n_0:[1,5],n_b:1,n_boostrap:3,n_bootstrap:3,n_categori:5,n_compon:7,n_featur:5,n_hidden_neuron:[2,5],n_i:1,n_input:5,n_iter_i:7,n_l:[1,5],n_neurons_layer1:5,n_neurons_layer2:5,n_sampl:[3,6],n_split:3,nabla:[5,11,13,20,22],nabla_i:[11,20],nabla_jv:[11,20],naimi:2,naiv:4,name:[0,2,3,4,5,6,9,10,11,12,14,18,19,20,21,23,27,31,33],name_scop:5,namespac:1,narrow:27,nation:[5,26],nativ:[2,9,18],natur:[0,1,2,5,6,8,10,12,17,19,21],navier:5,navig:28,nbconvert:[2,9,18],nboot:1,ndarrai:3,nearest:[3,5,7],nearli:[14,23],neat:[2,9,18],neccesari:3,necessari:[0,5,6,10,12,19,21],necessarili:[0,1,7,13,22],neck:4,need:[0,1,3,5,6,7,10,11,12,13,14,19,20,21,22,23],neg:[1,2,3,4,5,10,12,13,14,19,21,22,23],neg_mean_squared_error:3,neglect:[1,12,13,21,22],neglig:[1,14,23],neighbor:[3,7],neq:1,nervou:5,nest:5,net:[5,10,11,13,14,19,20,22,23],netlib:[2,9,18],network:[0,3,4,9,18],neural:[0,3,4,9,18],neural_network:[2,5],neuralnetwork:5,neuralnetworktensorflow:5,neurosci:[31,33],neutral:2,neutron:2,never:[1,3,5,12,13,21,22],new_hobbit:[2,9,18],new_sig:3,newaxi:[2,3],newdata:[9,18],newli:[0,9,18],newton1:[10,19],newton:[1,4,5,6,9,12,14,18,21,23,25],newtonian:[14,23],next:[1,2,5,6,9,11,12,13,14,18,20,21,22,23],nice:[2,3,5,7,9,18,25],nitric:3,nlambda:3,nldr:7,nm_n:2,nmse:3,node:5,nois:[2,3,6],noisi:[3,5],non:[1,3,4,5,7,11,12,20,21,25],none:[1,3,5],nonlinear:[3,5,6,7],nonneg:3,nonparametr:3,nonsens:1,nonsingular:[2,9,18],nonumb:[4,6,10,11,12,13,14,19,20,21,22,23],nor:[0,5],norm:[2,3,5,6,7,10,11,12,19,20,21],normal:[0,2,3,4,5,6,7,8,9,10,11,12,14,17,18,19,20,21,23],normali:[2,9,18],normpdf:3,north:[14,23],northern:[14,23],notat:[1,3,9,11,18,20],note:[1,2,3,4,5,6,7,9,10,11,12,13,18,19,20,21,22,27,31,33],notebook:[0,2,5,8,9,17,18,31,33],notesapril10:25,notesapril13:25,notesapril15:25,notesapril17:25,notesapril1:25,notesapril20:25,notesapril22:25,notesapril24:25,notesapril3:25,notesapril6:25,notesapril8:25,notesmarch13:25,notesmarch16:25,notesmarch18:25,notesmarch20:25,notesmarch23:25,notesmarch25:25,notesmarch27:25,notesmarch30:25,notesmarch9:25,noth:[1,3,5,6,9,18],notic:[1,2,5,9,11,14,18,20,23],novel:3,novemb:5,now:[1,2,4,5,6,9,10,11,12,13,14,18,19,20,21,22,23],nowadai:[0,2,5,8,17],nox:3,nozzl:[13,22],npt:[8,17],nsampl:3,nscl:25,nspin:1,nuclear:[12,13,21,22],nuclei:[1,2,13,22],nucleon:[2,3],nucleu:[2,13,22],number:[0,2,4,5,6,8,9,10,11,12,13,14,17,18,19,20,21,22,23],numer:[0,2,3,5,7,8,9,10,13,17,18,19,22,25],numpi:[1,3,4,5,6,7,8,11,12,13,15,16,17,20,21,22,32],nutshel:7,obei:[7,10,13,14,19,22,23],object:[2,3,6,9,13,18,22,25],oblig:26,observ:[3,4,5,6,7,10,13,14,19,22,23],obstacl:0,obtain:[1,3,4,5,6,9,10,11,12,13,14,18,19,20,21,22,23],obviou:[0,1,3,7,11,20],obviouli:2,obvious:[0,2,3,9,10,11,18,19,20],occupi:3,occur:[1,2,6,10,12,13,14,19,21,22,23],ocean:[14,23],odd:[2,3,4,7,11,12,20,21],odot:[11,20],off:[1,3,5,12,13,21,22],offend:2,offens:26,offer:[2,3,7,8,17],offic:25,offici:[26,27],offlin:26,ofil:1,ofstream:1,often:[0,1,2,3,4,5,6,7,8,9,10,12,13,14,17,18,19,21,22,23],ofter:[2,9,18],oint:[13,22],old:[5,11,20],ols_inv:3,ols_sk:3,ols_svd:3,omega02:[13,22],omega:[3,9,10,11,12,13,14,18,19,20,21,22,23],omega_0:[10,13,14,19,22,23],omega_0a:[12,21],omega_0t:[10,12,13,14,19,21,22,23],omega_c:[10,19],omega_ct:[10,19],omega_cv_i:[10,19],omega_i:[14,23],omega_t:[12,21],omega_x:[14,23],omega_xv_i:[14,23],omega_xv_z:[14,23],omega_yv_x:[14,23],omega_yv_z:[14,23],omega_z:[14,23],omega_zt:[14,23],omega_zv_i:[14,23],omega_zv_x:[14,23],omegatild:[12,21],omit:3,omnipres:[12,21],onc:[1,3,5,7,10,12,13,19,21,22,31,33],one:[0,1,2,4,6,7,8,11,12,13,14,17,20,21,22,23,31,33],onehot:5,onehot_vector:5,ones:[0,2,3,6,7,9,11,18,20],onli:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,31,33],onlin:[0,2,7,26],onto:[7,10,19],open:[0,1,2,3,5,8,9,17,18,26,27,28],oper:[0,1,2,3,5,7,9,11,12,18,20,21,27],operation:1,oplu:1,opportun:[0,2],oppos:[3,10,19],opposit:[5,6,10,11,13,14,19,20,22,23],oppotun:[8,17],opt:[0,2,3,5,6,7],optim:[0,4,7],option:[0,5,6,7],optmiz:5,orang:2,orbit:[11,20,25],order:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23],ordinari:[4,7,10,12,19,21],org:[2,5,7,9,18],organ:[3,9,18],orient:[1,3,9,18,26],origin:[1,2,3,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23],orthogn:3,orthogon:[2,3,6,7,9,14,18,23],orthonorm:3,oscil:[10,11,14,19,20,23,25],oscillatori:[12,21],osx:[2,9,18],other:[0,2,3,4,6,8,10,11,12,13,14,17,19,20,21,22,23,26],otherwis:[2,3,4,5,11,13,20,22,26],ouput:5,our:[0,4,6,8,11,13,14,17,20,22,23],ourselv:[0,2,3,6,7,9,10,12,13,14,18,19,21,22,23],out:[1,2,3,4,5,6,7,9,11,12,13,14,15,16,18,20,21,22,23,30,32],outcom:[1,3,4,5,8,14,17,23],outer:[3,5],outfilenam:1,outgo:[13,22],outlier:[2,3,6,7],outlin:[3,7,8,17],output:[0,2,3,4,5,6,9,10,18,19,31,33],output_bia:5,output_bias_gradi:5,output_weight:5,output_weights_gradi:5,outputlayer1:5,outputlayer2:5,outward:[11,13,14,20,22,23],over:[0,1,2,3,5,8,9,10,11,12,13,17,18,19,20,21,22],overal:[5,13,22],overarch:[0,10,19],overcom:[5,10,19],overdetermin:3,overfit:[3,5],overflow:5,overhead:5,overlap:[6,7],overlin:[2,3,7,9,18],overst:[0,2],overview:[0,25],owe:0,own:[0,2,5,6,8,11,12,14,17,20,21,23,25],owner:3,oxid:3,p_0:[13,22],p_0b:[13,22],p_0b_:[13,22],p_2:[11,20],p_f:[13,22],p_fr:[13,22],p_i:1,p_j:1,p_n:1,p_x:[1,11,20],pack:2,packag:[0,1,3,5,6,7,12,21],page:[2,28,30,31,33],pai:5,painless:2,paint:[13,22],pair:[1,2,3,10,19],panda:[11,12,13,20,21,22],panel:[2,9,18],paper:[5,8,17,25],paradigm:[0,2],parallel:[2,9,10,11,13,18,19,20,22],paramet:[0,1,2,5,6,7,9,13,18,22],parameter:[0,3,10,12,19,21],parametr:[2,3],pari:[14,23],park:1,part:[0,1,2,3,5,7,8,9,12,13,14,17,18,21,22,23,25,27],partform:[12,21],partial:[1,3,4,5,6,7,10,11,19,20],partial_:[11,20],partial_i:[11,20],partial_r:[13,22],partial_ru:[13,22],partial_ru_:[13,22],partial_tv:[11,20],partial_x:[11,12,20,21],partial_xv:[11,12,20,21],partial_yv:[11,20],partial_z:[11,20],partial_zv:[11,20],particip:[13,22,26],particl:[1,2,3,10,11,12,13,14,19,20,21,22,23,25],particular:[0,1,2,3,5,7,8,9,10,12,13,17,18,19,21,22,25],particularli:[1,3,6,7,8,12,17,21],partit:5,partli:3,paslei:[31,33],pass:[1,12,13,21,22],passeng:0,past:1,patch:[1,3,9,18],path:[2,3,7,9,10,11,12,13,14,18,19,20,21,22,23,31,33],patient:4,pattern:[0,2,5,14,23,31,33],pauli:2,pavement:[10,19],pca:3,pdf:[0,2,3,9,18,25],pedagog:[3,8,17],pen:[8,17],penal:3,penalti:3,pencil:[8,17,25],pend1:[10,12,19,21],pend2:[10,12,19,21],pendulum:25,penros:3,peopl:[0,3,5],per:[2,3,8,9,13,14,17,18,22,23],perceiv:0,percentag:[3,7,25],perceptron:[2,4],peregrin:[2,9,18],perfect:[2,3,5,13,22],perfectli:[3,10,19],perform:[1,2,6,7,9,10,11,12,13,14,18,19,20,21,22,23],perhap:[0,2,3,10,11,19,20],period:[5,10,13,14,19,22,23],perman:26,permiss:26,permut:[7,11,20],perp:[13,22],perpendicular:[10,13,14,19,22,23],person:[4,26],perspect:[11,20],pertain:[9,18],pertin:[5,8,17],perturb:[13,22],petal:6,petersen:1,phantom:1,phase:[3,5,10,12,14,19,21,23],phasespac:[13,22],phenomena:[1,12,21],phi:[6,9,10,11,12,13,18,19,20,21,22],phi_a:[14,23],phi_b:[14,23],phi_k:6,philosophi:[12,21],phone:25,phonon:[12,21],phrase:0,phy321:33,physic:[0,1,2,3,4,5,8,9,10,11,12,13,14,17,18,19,20,21,22,23,26],physics321:25,piazza:25,pick:[1,5,7,12,21],pictur:[0,2,12,21],pie:[2,9,18],piec:[5,7,11,13,20,22],pillow:[2,9,18],pinv:3,pip3:[2,5,9,18],pip:[2,5,9,18,28],pipelin:[2,3,6],pippin:[2,9,18],pitfal:[11,20],pitt:5,pixel:5,pixel_height:5,pixel_width:5,place:[2,3,6,9,13,14,18,22,23],placehold:5,plai:[0,2,3,6,10,11,12,19,20,21],plain:[5,6],plan:[3,25],plane:[6,9,13,14,18,22,23],planet:[13,22],planetari:[13,22],plateau:1,platform:[2,9,18],plausibl:5,pleas:[7,25,27],plenti:5,plethora:5,plot:[1,2,3,4,5,6,7,8,9,10,11,12,13,15,16,17,18,19,20,21,22,32],plot_count:3,plot_dataset:6,plot_predict:6,plt:[1,2,3,4,5,6,7,8,9,11,12,13,15,16,17,18,20,21,22,32],plu:[2,12,14,21,23],plug:[10,12,13,19,21,22],png:[2,3,7,9,11,12,13,18,20,21,22],point:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23],poisson:0,polar:[11,12,13,14,20,21,22,23],pole:[14,23],poli:[3,6],polici:26,polit:[0,26],poly100_kernel_svm_clf:6,poly3:2,poly3_plot:2,poly_featur:6,poly_kernel_svm_clf:6,polydegre:3,polym:5,polynomi:[0,2,3,4,6,7,11,20],polynomial_featur:3,polynomial_svm_clf:6,polynomialfeatur:[2,3,6],polytrop:3,poor:5,popul:[2,3],popular:[0,1,2,3,5,6,7,9,12,18,21],popularli:2,portion:7,pose:[0,1,7],posit:[1,3,4,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23,26],possess:[14,23],possibl:[0,1,2,3,4,5,6,7,8,9,10,11,12,17,18,19,20,21,27],post:[15,16,25,26,27,32],postpon:[3,9,18],potenti:[0,2,3,5,8,9,10,11,12,17,18,19,20,21,25],pott:5,power:[2,3,5,6,7,8,10,12,17,19,21,31,33],practic:[1,3,4,6,13,22],practition:[2,5],pre:[31,33],preced:[1,5,7],preceq:6,precess:[14,23],precis:[0,1,2,3,7,9,11,13,18,20,22],precmess:[14,23],pred:3,predict:[0,2,3,4,5,6,7,9,14,18,23,31,33],predict_prob:5,predictor:[2,3,4,7],prefer:[2,5,6,7,12,21],prepar:[2,9,18],preprocess:[2,6],prerequisit:[0,2],presenc:[10,12,19,21],present:[0,1,2,3,5,8,11,17,20],preserv:7,pressur:[14,23],pretti:[2,6,9,18],prevent:1,previou:[1,3,5,6,7,9,10,12,13,18,19,21,22],previous:1,price:3,primal:6,primari:[0,4],prime:[1,11,12,20,21],princip:[3,12,21],principl:[2,3,4,6,10,14,19,23],print:[1,2,3,5,6,7,9,11,13,18,20,22,31,33],print_funct:6,printout:[3,9,18],prior:[0,2,3],prioriti:0,privaci:0,privat:[0,2,26],privileg:[9,18],pro:25,prob:1,probabilist:3,probabl:[2,3,4,5,13,22],problem:[0,1,2,4,7,8,9,10,12,14,17,18,19,21,23,25],proce:[0,2,3,6,7,12,13,21,22],procedur:[6,7,14,23],proceed:[10,19],process:[0,1,2,3,8,9,10,17,18,19,25,28],prod_:[4,5],produc:[0,1,2,3,5,7,8,9,14,17,18,23],product:[2,3,4,5,6,9,11,13,18,20,22],profess:3,profession:26,profound:[11,20],program:[1,2,3,5,6,8,9,10,12,17,18,19,21],progress:5,prohibit:3,project:[0,1,2,3,5,7,8,14,17,23,25,26,27,28],project_root_dir:[2,3,7,9,11,12,13,18,20,21,22],promin:5,promis:6,pronounc:[2,9,18],proof:[3,5,11,20],prop:3,prop_cycl:[15,16,32],proper:[0,2,3],properli:[5,6,8,17,31,33],properti:[2,5,7,9,10,14,18,19,23],proport:[1,2,3,5,7,10,12,19,21],propos:[5,27],propto:[13,22],protect:0,proton:[2,13,22],prove:[14,23],provid:[1,2,3,5,6,8,9,10,12,13,14,17,18,19,21,22,23],proxi:5,pseudoinvers:3,pseudorandom:1,psycholog:[0,2],ptratio:3,pub:25,publish:26,pull:[13,22,25,27,28],pulsar:5,punish:[0,2,5],pure:[1,12,13,21,22],purpos:[0,2,5,8,10,12,17,19,21,31,33],push:[14,23,27,28],put:[12,13,21,22],puzzl:[10,19],pycod:[2,9,18],pyhton2:[2,9,18],pylab:[2,9,12,18,21],pyplot:[1,2,3,4,5,6,7,8,9,11,12,13,15,16,17,18,20,21,22,32],python3:[2,3,6,7,9,18],python:[0,3,5,6,7,8,10,12,17,19,21,25],pytorch:[0,2,5,9,18],qbv_x:[10,19],qbv_y:[10,19],qquad:[2,7,9,18],quad:5,quadrat:[2,6,10,12,13,19,21,22],qualit:1,qualiti:[0,2,8,9,10,12,17,18,19,21],quantifi:[5,13,22],quantit:[0,3],quantiti:[1,2,3,4,5,7,10,11,12,14,19,20,21,23],quantum:[0,5,11,12,20,21],quartil:[3,7],question:[0,3,5,7,9,10,12,18,19,21,25],quick:[1,8,17],quickli:[7,11,12,13,14,20,21,22,23],quit:[3,5],quitecompl:[13,22],quot:1,r2_score:[2,3],r2score:2,r_1:[12,21],r_1t:[12,21],r_2:[12,13,21,22],r_2t:[12,21],r_h:[11,20],r_i:[11,20],rab:[11,13,20,22],race:26,rad:3,radial:[3,5,6,11,13,14,20,22,23],radialeqofmot:[13,22],radialeqofmotion2:[13,22],radialgvv:[13,22],radialhovv:[13,22],radii:[13,22],radio:[12,21],radioact:1,radiu:[3,7,10,13,14,19,22,23],rais:3,ramsai:[31,33],ran1:1,ran2:1,ran3:1,rand:[1,2,3,9,18],rand_max:1,randint:3,randn:[2,3,5,7,9,15,16,18,32],random:[0,2,3,5,6,9,13,15,16,18,22,32],random_devic:1,random_indic:5,random_st:[3,6,7],randomli:[1,3,5],randomnumbergener:1,rang:[1,2,3,4,5,7,8,9,10,11,12,13,15,16,17,18,19,20,21,22,32],rangl:[1,3,7],rangle_x:1,rank:3,raphson:[5,6],rapidli:[0,2,14,23],rare:[10,19],rate:[3,5,6,11,13,14,20,22,23],rather:[0,1,2,3,4,5,6,7,10,11,12,13,14,19,20,21,22,23],ratio:[4,7,12,13,21,22],rational:2,ravel:[3,6,7],raw:1,rawdata:[9,18],rbf:[5,6,7],rbf_kernel_svm_clf:6,rbf_pca:7,rcond:3,rcparam:[1,2,5,6,9,12,15,16,18,21,32],rdotdot:[13,22],rdr:[12,21],reach:[1,3,5,7,10,11,13,19,20,22],reaction:[10,11,19,20],read:[0,1,3,5,6,8,9,10,11,12,17,18,19,20,21,25],read_csv:3,read_fwf:[2,3],reader:[0,1,2,9,18],readi:[2,5,6,7,8,9,17,18,27],readili:5,real:[3,4,5,7,8,9,12,13,14,17,18,21,22,23],realist:[8,17],realiti:[1,14,23],realiz:[5,12,13,21,22],realli:[2,5,10,19],reason:[0,3,5,8,14,17,23,26],rebenstock:25,recal:[1,2,3,5,7,9,14,18,23],recalcul:1,recast:[10,12,19,21],receiv:[1,5,12,21],recent:[0,2,3],recept:5,recip:[2,3,4,9,18],recogn:[2,13,22,28],recognit:[0,2,5],recommend:[1,2,3,6,9,11,18,20,25,28],reconstruct:7,record:[10,19],recov:[9,18],recreat:1,rectangl:3,rectifi:5,rectilinear:[14,23],recur:[0,2],recurs:[2,9,18],recycl:1,red:[2,3,6],redefin:3,reduc:[2,5,10,12,13,19,21,22],reduce_mean:5,reduct:[1,2,3],refactor:[8,17],refer:[0,2,3,5,7,8,10,12,13,14,17,19,21,22,23,25,31,33],refin:5,refit:3,reflect:[0,1,2,5,8,17],reformul:[10,19],reg:7,regard:[5,26],regardless:[5,13,22,26],region:[5,8,14,17,23],regist:1,regr_1:2,regr_2:2,regr_3:2,regress:[0,5,6],regressor:[3,4],regular:[4,14,23,31,33],regularizer_loss:5,regularizer_loss_fc1:5,regularizer_loss_fc2:5,regularizer_loss_out:5,reinforc:[0,2,6],reject:26,rel:[0,1,2,3,4,5,8,10,11,12,14,17,19,20,21,23,25,31,33],relat:[0,1,2,3,5,7,9,10,11,12,13,14,18,19,20,21,22,23,25],relationship:[0,2,3,7,14,23],relatist:[14,23],relativeerror:[3,8,17],relativist:[10,12,19,21],releas:[2,5,9,18,27],relev:[1,2,3,7,8,9,17,18],reli:[0,2,3,6,7,10,19],reliabl:[1,4,11,20],religion:26,remain:[1,3,5,10,12,19,21],remaind:1,remark:[5,14,23],rememb:[2,6,9,12,18,21,27],remind:[0,1,3,7,8,10,12,13,14,17,19,21,22,23],remov:[3,26,28],render:[2,3,7,9,18,28,31,33],reorder:4,reorgan:[2,9,18],repeat:[1,2,3,5,7,9,10,11,12,13,14,18,19,20,21,22,23],repeated:0,repeatedli:[1,3,12,21],repel:[13,22],repercuss:26,repetit:3,rephras:[10,19],replac:[2,3,5,8,9,11,12,13,17,18,20,21,22,25],replica:3,repo:[27,28],report:[8,17,26],repositori:[0,28],repres:[0,1,2,3,4,5,6,8,9,10,11,12,13,14,17,18,19,20,21,22,23,26],represent:[0,1,3,5,7,12,21,26],reproduc:[0,1,2,5,8,13,15,16,17,22,25,27,32],repuls:[2,13,22],request:[0,2,27,28],requir:[2,3,5,6,7,8,9,10,12,13,17,18,19,21,22,28],resampl:[0,1],rescal:[3,5,7],research:[0,2],resembl:[1,3,14,23],reserv:[1,3,5],reset:1,reshap:[2,3,5,6,9,18],residenti:3,residu:3,resist:[11,12,20,21,25],reson:25,respect:[0,1,2,3,4,5,6,7,8,9,10,12,14,17,18,19,21,23,26],respond:[5,26],respons:[3,4,5,10,14,19,23],rest:[3,7,9,10,12,13,14,18,19,21,22,23,31,33],restat:[3,5],restor:[10,19],restrict:[0,5,14,23],result:[0,1,2,4,5,6,7,8,9,11,12,13,14,17,18,20,21,22,23,25,31,33],ret:3,retail:3,retain:[3,11,20],rethink:3,reus:[11,12,20,21],reveal:[0,5],revers:[5,13,22],revert:[9,18],review:26,revis:[5,9,18],revisit:[12,21],reward:[0,2],rework:5,rewrit:[1,2,4,5,6,9,10,11,12,13,14,18,19,20,21,22,23],rewritten:[1,3,6,13,22],rho:[3,13,14,22,23],rho_m:[10,19],rho_ma:[10,19],rhs:[7,9,18],rich:[0,2],ridg:[2,4,7],ridge_sk:3,right:[1,2,3,4,5,6,8,9,10,11,12,13,14,17,18,19,20,21,22,23,26],rightarrow:[1,3,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23],rigid:[14,23],rigor:[0,2,14,23],ring:[3,13,22],rise:[3,14,23],risk:2,river:3,rk2:[12,21],rk4:[12,21],rmin:[13,22],rminofa:[13,22],rmse:3,rnn:5,rntrick1:1,rntrick2:1,rntrick3:1,rntrick4:1,road:0,robert:[31,33],robust:2,robustscal:[3,7],rocket:[11,20],role:[0,2,3,6,11,20],rolenam:[31,33],roll:[3,12,21],room:[0,2,3,25],root:[0,1,2,3,12,21],rot:[2,9,18],rotat:[6,9,10,11,13,18,19,20,22,25],roughli:[5,13,22],round:[3,7,14,23],routin:[2,9,18],row:[2,3,5,7,9,18],rp_f:[13,22],rrr:3,rtotheta:[13,22],rule:[3,8,9,13,14,17,18,22,23,25],run:[0,2,3,5,6,7,8,9,10,13,17,18,19,22,28,31,33],rung:25,runner:[9,18],runtim:[3,5],runtimewarn:5,rust:2,ruthtraj:[13,22],rvert:5,rvert_2:5,rwidth:3,s_0:[14,23],s_1:3,s_h:[11,20],s_i:[3,4],s_j:3,s_k:3,safe:1,sai:[0,1,2,3,4,5,6,7,9,10,13,14,18,19,22,23],said:3,sake:[2,3,4,7],sale:2,sam:[2,9,18],same:[1,2,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23,31,33],sampl:[0,2,3,4,5,6,13,14,15,16,22,23,30,32],sampleexptvari:1,sampler:0,samwis:[2,9,18],sanitize_sequ:3,satisfactori:2,satisfi:[1,3,5,6,10,12,13,19,21,22],satur:[3,5],save:[2,3,7,8,9,11,12,13,17,18,20,21,22],save_fig:[2,3,7,9,11,12,13,18,20,21,22],savefig:[1,2,3,7,9,11,12,13,18,20,21,22],saw:[11,12,20,21],scalar:3,scale:[2,3,4,5,6,7,8,9,13,17,18,22,25],scaler:[3,6,7],scan:4,scatt:[13,22],scattangl:[13,22],scatter:[2,3,6,9,18,25],scenario:3,scene:7,scheme:[5,9,18],schrage:1,sci:25,scienc:[0,1,2,5,8,9,17,18,25],scientif:[0,2,8,9,17,18,25],scientist:[0,2],scikit:[0,6,9,18],scikitlearn:2,scipi:[2,3,9,12,18,21],scl:3,scope:[5,27],score:[2,3,5,7,25],scores_kfold:3,sea:[14,23],seaborn:[2,3,5,7,9,12,18,21],seamless:[2,9,18],search:[2,5,10,13,19,22],seat:[14,23],sec:3,second:[0,1,2,3,4,5,6,7,9,11,12,13,14,18,20,21,22,23,25],secondeigvector:7,secondli:[5,12,21],section:[1,9,10,12,14,18,19,21,23,24,25,29],sector:[0,2],secur:0,see:[0,1,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,25,28,31,32,33],seed:[1,2,3,5,6,7,9,15,16,18,32],seek:[5,6],seem:[5,12,13,21,22],seemingli:2,seen:[0,1,2,3,5,7,8,10,13,14,17,19,22,23],seismic:3,seldomli:[2,8,17],select:[2,3,5,6,7,9,18],self:[0,1,3,5,8,17],semi:6,semilogx:3,send:[5,25,27],sens:[0,3,6,10,19],sensit:[2,3,7],sensor:0,sent:25,sentenc:5,separ:[1,2,3,5,6,9,10,12,13,18,19,21,22,26],septemb:3,sequenc:[1,2,4,5,9,18],sequenti:[1,5],seri:[0,2,3,5,7,9,18,25],serif:[1,2,9,12,18,21],seriou:0,serv:[0,2,4,5,31,33],sess:5,session:[5,25],set:[0,1,2,4,7,8,9,11,12,13,14,17,18,20,21,22,23,26,27],set_:3,set_label:3,set_tick:6,set_titl:[2,4,5,7],set_xlabel:[2,3,4,5,7,9,11,12,13,18,20,21,22],set_xlim:[4,5,9,11,12,18,20,21],set_ylabel:[2,3,5,7,9,11,12,13,18,20,21,22],set_ylim:[4,5],set_ytick:7,set_yticklabel:3,setiosflag:1,setminu:3,setosa:6,setosa_or_versicolor:6,setp:3,setprecis:1,setup:[2,3,5,6,9,14,18,23,27],setw:1,sever:[0,1,2,3,4,5,6,7,8,9,11,12,17,18,20,21,25],sexist:0,sexual:26,sgd:5,sgd_clf:6,sgdclassifi:6,shape:[2,3,5,6,7,8,9,13,14,17,18,22,23],share:[0,2,5,9,18],she:4,shift:[1,5],shire:[2,9,18],shock:[12,21],shorter:1,shorthand:[2,9,11,18,20],shortli:[2,7,9,10,18,19],should:[0,2,3,6,9,10,11,12,13,14,18,19,20,21,22,23,25,28],show:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,26],shown:[1,5,6,7,10,11,19,20],showpoint:1,shrink:[3,6],shrinkag:3,shrunk:7,shuffl:[3,5],side:[3,5,6,9,10,13,14,18,19,22,23],sigh:[2,9,18],sigma0:1,sigma1:1,sigma2:1,sigma:[1,2,3,4,5,7,13,22],sigma_1:3,sigma_2:3,sigma_:[1,2,3,13,22],sigma_fn:[4,5],sigma_i:[2,3],sigma_j:3,sigma_m:1,sigma_n:[1,7],sigma_x:1,sigmoid:[4,6],sign:[1,4,5,6,10,13,14,15,16,19,22,23,25,32],signal:[5,12,21],signific:[5,14,23],significantli:[1,5,10,12,19,21],sim:[1,3,13,22],similar:[0,2,3,4,6,7,8,12,13,17,21,22,25,31,33],similarli:[1,2,3,5,6,7,9,12,13,14,18,21,22,23],simpl:[0,4,8,10,12,13,14,17,19,21,22,23],simpler:[0,2,5,8,10,11,17,19,20],simplest:[0,2,3,5,9,11,12,14,18,20,21,23,31,33],simpli:[1,2,3,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23],simplic:[3,4,5,6,7,9,10,13,18,19,22],simplicti:[12,21],simplifi:[0,2,3,9,13,18,22],simplist:1,simpson:25,simul:[0,1,3,10,19],simultan:3,sin:[2,3,5,9,10,11,12,13,14,18,19,20,21,22,23],sinc:[0,1,2,3,4,5,6,7,8,9,10,11,14,17,18,19,20,23],sine:[5,12,21],singl:[1,2,4,5,6,9,11,12,13,14,18,20,21,22,23,25],singular:0,sit:[12,14,21,23],site:[0,2,3,6,7],situat:[0,2,3,4,8,12,13,14,17,21,22,23],six:1,size:[1,2,5,6,7,9,10,11,12,13,18,19,20,21,22,26],sketch:[10,13,19,22],skill:[0,2,8,17,25],skip:7,skl:[2,3,7],sklearn:[2,3,5,6,7],slack:6,slice:[2,9,18],slide:[1,3,25],slight:[3,31,33],slightli:[1,3,4,5,10,11,14,19,20,23],slope:[5,6,7,9,18],sloppi:[10,19],slow:[3,6,7,10,19],slower:[2,3,9,14,18,23],slowli:5,slp:5,small:[1,2,3,5,6,7,10,11,12,13,14,19,20,21,22,23,25,30,31,33],smaller:[1,2,3,5,6,7,11,13,20,22],smallest:[2,9,18],smart:3,smooth:3,sne:7,sneak:3,sns:[2,3,5,7],soar:3,social:[0,2,26],societ:0,societi:[0,8,17],sofist:0,soft:[4,5],soften:6,softmax:4,softmax_cross_entropy_with_logits_v2:5,softmax_loss:5,softwar:[0,6,8,17,25],sol:6,sole:[0,2,3],solid:[0,2,4,12,13,21,22],solut:[1,3,5,6,7,8,10,11,12,14,17,19,20,21,23,25],solv:[0,2,3,5,7,8,11,13,14,17,20,22,23,25],solver:[6,7,10,19],some:[0,1,4,5,6,7,8,10,11,12,13,14,15,16,17,19,20,21,22,23,25,31,32,33],someth:[0,1,5,7,10,19],sometim:[3,5,7,13,22],somewher:[13,22],soon:[3,9,12,14,18,21,23],sophist:[0,2],sort:[1,3,7],sound:[0,8,12,17,21],sourc:[0,1,2,3,5,8,9,10,12,13,17,18,19,21,22,28],south:[14,23],southern:[14,23],sovl:[11,20],space:[1,3,5,7,10,12,14,19,21,23,25,26],spacetim:[14,23],span:[0,2,3,7,9,18,31,33],spare:5,spars:[2,3],sparse_mtx:2,spartan:[13,22],spatial:[5,9,12,18,21],speak:1,speci:[13,22],special:[1,2,3,4,5,8,9,10,14,17,18,19,23],specif:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,26,31,33],specifi:[0,1,2,3,4,7,9,10,14,18,19,23],specifici:2,speech:[0,2,5],speed:[5,10,11,19,20],spell:[11,20],spend:1,sphere:[3,7,13,22],spheric:[13,22],sphinx:[31,33],spin:[3,11,20],spite:[0,2],spline:6,split:[0,1,2,5,6,7,11,20],spontan:[1,11,20],sprai:[13,22],spread:[1,3,7,13,22],spring2020:25,spring:[10,12,13,19,21,22,33],springer:25,springforc:[12,21],spuriou:[14,23],sqrsignal:[12,21],sqrt:[1,3,6,7,9,10,11,12,13,14,18,19,20,21,22,23],squar:[0,1,2,4,5,6,7,9,10,12,13,18,19,21,22],squash:5,srand:1,stabil:[10,12,19,21],stabl:[2,3,7,11,13,20,22],stack:3,stadium:[13,22],stage:[0,10,12,19,21],stai:[2,3,7,10,11,12,13,14,19,20,21,22,23],stand:[0,2,3,5,9,14,18,23,31,33],standar:7,standard:[0,2,3,4,5,6,9,10,13,14,18,19,22,23],standardscal:[3,6,7],standpoint:[8,17],start:[0,1,3,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,25,30],startpoint:1,stat:3,state:[0,1,2,4,5,6,7,9,10,11,12,13,14,15,16,18,19,20,21,22,23,32,33],statement:[0,2,7,9,18],station:[12,21],statis:3,statist:[0,2,4,5,7,9,10,18,19],statu:[3,4,7],std:[1,2,3,9,18],stddev:5,stdev:1,steadi:[12,21],step:[1,2,4,5,9,12,13,14,18,21,22,23,27],step_fn:[4,5],stepsiz:[8,17],sthetover2:[13,22],still:[1,3,7,10,13,19,22],stimuli:5,stochast:[0,3,5,6,7],stock:0,stoke:5,stone:[2,4],stop:[1,5,7,9,10,18,19],storag:3,store:[1,2,5,7,9,18,31,33],str:5,straight:[0,2,3,6,10,14,19,23],straightforward:[3,6],strategi:[0,5,10,11,13,19,20,22],stratifi:3,stream:5,strength:[2,3,12,21],stretch:[7,10,13,19,22],strict:6,strictli:[6,10,19],strike:[3,13,22],string:[1,5],stroke:4,strong:[1,5,12,13,21,22],strongli:[0,2,3,6,9,13,18,22],stronli:3,structur:[0,2,3,5,8,9,17,18,25,30,31,33],stuck:5,student:[0,2,8,17],studi:[0,2,3,5,6,7,8,9,10,13,14,17,18,19,22,23,25],style:[2,9,12,18,21],sub:5,subdivid:[0,2,9,10,11,18,19,20],subfield:[0,2],subinterv:[11,20],subject:[1,3,6],subplot:[2,3,5,6,7,9,11,12,13,15,16,18,20,21,22,32],subplots_adjust:[1,6],subprogram:[2,9,18],subroutin:2,subscript:[5,9,11,14,18,20,23],subsect:[12,21],subsequ:[1,3,5],subset:[2,3,5,9,18],subspac:[3,6,7],substep:7,substitut:[3,5,10,11,12,13,14,19,20,21,22,23],subtend:[13,22],subtl:5,subtract:[1,3,7],succeed:2,success:[1,4],sucess:1,sudden:[12,21],suddenli:[14,23],sudo:[2,9,18],suffer:[3,5],suffic:[9,18],suffici:[3,5,6,7,12,13,14,21,22,23],suggest:5,suit:[5,6,12,21],suitabl:[1,3,7],sum:[1,2,4,5,6,7,10,11,12,13,19,20,21,22],sum_:[1,2,3,4,5,6,7,10,11,12,13,19,20,21,22],sum_i:[3,6,7,11,12,14,20,21,23],sum_ia_i:[14,23],sum_im_i:[11,20],sum_im_ix_i:[11,20],sum_j:3,sum_k:[2,3,5,6,9,18],sum_n:[12,21],sum_nx_:[12,21],summar:3,summari:[5,25],summat:3,sun:[10,13,19,22,25],superscript:5,supervis:[0,2,3,4],supplement:[4,14,23],support:[0,3,5],suppos:[0,2,3,4,5,6,7,9,10,14,18,19,23],supposedli:0,sure:[3,5,15,16,32],surfac:[2,10,11,13,14,19,20,22,23],surpass:3,surpris:2,surprisingli:[13,22],surround:[13,22],surv:0,survei:[0,2],svc:[6,7],svd:7,svdinv:3,svm:[6,7],svm_clf:6,svr:7,sweep:[10,19],swift:0,swing:[12,21],symbol:[1,2,5,7,8,9,10,11,17,18,19,20,25],symmetr:[0,2,3,5,6,7,9,13,14,18,22,23],symmetri:[3,12,21],sympi:[2,8,9,11,17,18,20],symplect:[11,20],synonim:1,syntax:[2,7,9,18,31,33],syntaxerror:[2,6,7,9,18],system:[0,2,3,4,5,8,9,12,13,17,18,21,22,25,27],systemat:[1,3],t_0:[9,18],t_f:[9,10,18,19],t_h:[11,20],t_i:[5,7,9,10,11,12,18,19,20,21],t_j:5,t_n:[11,20],t_x:[14,23],t_y:[14,23],tab:[12,21,28],taberror:[12,21],tabl:[1,2,9,18],tabul:2,tabular:[2,9,18],tag:[1,3,4,5,10,11,12,13,14,19,20,21,22,23,27],taht:2,tail:1,tailor:[2,6,7],taiwan:3,take:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,26],taken:[2,3,5,9,18],takeoff:[14,23],tan:[12,21],tangent:[5,14,23],tanh:[4,5,6,9,18],target:[2,3,5,6,7,13,22],task:[0,2,3,5,7],tau:[1,11,12,20,21],tau_z:[11,20],taught:[0,8,17],tax:3,taxpay:0,taylor2:25,taylor:[9,10,11,12,13,18,19,20,21,22,25],tba:25,tdt:[9,18],teach:[8,17],team:[5,26],teaser:2,techniqu:[0,1,2,3,5,6,8,9,10,11,17,18,19,20],technolog:[0,2,5],tediou:[8,13,17,22],tell:[1,3,7,10,11,12,19,20,21],temperatur:3,templat:28,tempor:[12,21],temporari:26,temporarili:26,ten:[2,9,18],tend:[3,5,6,10,13,14,19,22,23],tendenc:2,tension:[3,14,23],tensorboard:5,tensorflow:[0,2,6,9,18],term1:[3,7],term2:[3,7],term3:[3,7],term4:[3,7],term:[1,2,3,4,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,27],termin:[3,10,19],test:[0,1,2,6,7,8,10,13,17,19,22,28],test_accuraci:5,test_error:3,test_ind:3,test_loss:5,test_pr:5,test_predict:5,test_siz:[3,5,7],testerror:3,tex:[15,16,32],text:[1,2,3,5,6,7,9,12,18,21,25,31,33],textbook:[10,19],tfinal:[9,11,12,13,18,20,21,22],than:[1,2,3,4,5,7,9,10,12,13,14,18,19,21,22,23],theano:[2,5,9,18],thei:[0,1,2,3,4,5,6,7,8,9,10,12,13,14,17,18,19,21,22,23,25,26,27,31,33],them:[0,2,5,6,7,8,9,12,14,17,18,21,23],theme:2,themselv:[1,2],thenc:3,theorem:[3,11,20,25],theoret:[3,10,19],theori:[0,2,5,6,10,12,19,21],thereaft:[2,3,5,7,9,12,14,18,21,23],therebi:[0,1,2,4,7,9,12,14,18,21,23],therefor:[1,2,3,4,5,6,7,12,13,21,22],therein:7,thereof:[0,2,3],theta:[1,3,5,10,11,12,13,14,19,20,21,22,23],theta_0:[10,13,19,22],theta_:[5,13,22],theta_i:5,theta_k:1,thi:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,26,27,28,29,30,31,32,33],thick:[13,22],thin:[13,22],thing:[1,3,5,7],think:[0,1,3,5,8,10,12,13,14,17,19,21,22,23,25],third:[0,2,3,9,11,12,13,14,18,20,21,22,23],thirti:7,those:[2,3,6,7,9,10,11,12,13,14,18,19,20,21,22,23,31,33],though:[0,1,5,10,12,13,19,21,22],thought:[1,3,13,14,22,23],thousand:[0,2,3,5,7],threaten:26,three:[0,2,3,5,6,9,11,12,14,18,20,21,23],threshold:[5,7],through:[0,1,2,3,5,6,7,8,9,10,11,13,14,17,18,19,20,22,23,25,27],throughout:[0,1,2,3,9,18],thrown:[10,19],thu:[0,1,2,3,4,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23,25],thumb:3,thursdai:25,tick_param:3,ticker:1,tidal:[14,23],tide:[13,22],tight_layout:[7,9,11,12,13,18,20,21,22],tightli:7,tild:[1,2,3,7,12,21],till:[3,4,5,6,7,9,10,14,18,19,23],time:[1,2,3,4,5,6,7,8,10,11,12,13,14,17,19,20,21,22,23,25,31,33],timefunct:1,tiniti:[9,18],tip:[24,29],tire:[10,19],titl:[1,2,3,5,6],to_categor:5,to_categorical_numpi:5,to_numer:[2,3],to_str:1,todai:0,togeth:[2,3,6,7,13,14,22,23],toler:[10,19],tomographi:5,too:[1,3,7,10,19],took:[2,6,9,18],tool:[0,1,2,3,5,7,8,9,17,18,31,33],toolbox:6,top:[2,3,8,9,14,17,18,23],topic:[0,2,3,4,6,8,17,25],topolog:5,torqu:[10,11,12,19,20,21],tot:[13,22],total:[1,3,4,5,6,7,10,11,12,13,19,20,21,22,25],totaldimens:7,totalvari:1,tout:0,toward:[4,5,12,13,14,21,22,23,26],town:3,tqdm:3,traceback:3,track:[5,9,13,18,22],tract:3,tractabl:[0,3,7],traction:0,trade:3,tradeoff:0,tradit:[0,2,3,5],tradition:[8,17],train:[0,2,6,7,8,10,14,17,19,23],train_accuraci:[2,5],train_end:5,train_error:3,train_ind:3,train_loss:5,train_pr:5,train_siz:5,train_test_split:[2,3,5,7],train_test_split_numpi:5,trainabl:5,trainingerror:3,trait:[0,2],trajectori:[10,11,12,13,19,20,21,22],transcendent:[10,19],transform:[3,4,5,6,7,13,22,25],transit:[3,5],translat:[5,11,12,20,21],translation:[11,20],transpos:[3,5,7],transvers:[13,22],trapez1:[11,20],trapez:[8,11,17,20],trapezoid:[8,17,25],trapoezoid:[11,20],travel:[10,13,19,22],treat:[1,3,5,12,13,14,21,22,23],tree:[0,5,25],trend:1,tri:[10,19],trial:[0,1,2,3],triangular:[2,9,18],trick:[1,6,7,13,14,22,23],trickier:[1,9,18],tridiagon:[2,9,18],trivial:[1,3,5,7,13,22],troll:26,troubl:[3,5,6,7],troubleshoot:27,true_divid:5,true_fun:3,truncat:[9,12,18,21],truncated_norm:5,trust:[10,11,19,20],truth:0,tucker:6,tumor:[4,7],tumour:7,tune:[2,9,12,18,21],turn:[0,1,2,3,5,6,7,8,10,11,12,14,17,19,20,21,23],tutori:5,tweak:[1,5],twice:[9,13,18,22],twist:7,twister:1,two:[0,1,2,3,5,7,9,11,12,14,18,20,21,23,25,31,33],twoard:[14,23],txt:28,type:[0,1,3,6,9,10,11,12,18,19,20,21,25],typeset:[8,17],typic:[0,1,2,3,4,5,10,11,12,13,19,20,21,22],u_i:5,ubuntu:[2,9,18],uci:3,ugli:[12,21],unaccept:26,unari:[2,9,18],unbalanc:3,unbias:[1,2,3],unbound:[13,22],uncertainti:[3,10,19],uncertitud:1,unchang:[5,11,20],uncov:5,undamp:[12,21],undefin:3,under:[2,3,5,9,10,11,13,18,19,20,22],underdetermin:3,underfit:[3,5],undergo:[8,10,13,17,19,22],undergradu:0,underli:[0,1,2,5,8,17],understand:[0,2,5,8,10,17,19,25],understood:[6,10,13,19,22],undesir:6,undetermin:6,undriven:[10,12,19,21],unexpect:[1,3],unexpected:1,unfortun:[5,6,10,19],unicode_liter:6,uniform:[0,2,3,5,7,10,19],uniform_real_distribut:1,uniformli:[1,13,14,22,23],unifrompdf:1,union:3,uniqu:[0,2,3,8,17],unit:[1,2,3,5,8,10,11,12,14,17,19,20,21,23],unitari:[2,3,9,18],unitarili:[2,9,18],uniti:[1,12,21],univ:25,univari:1,univers:[0,33],unix:5,unknow:3,unknown:[3,5,6,7,12,21],unknowwn:5,unlabel:5,unless:[2,3,7,10,11,12,14,19,20,21,23],unlik:[1,5,6],unlimit:[11,20],unravel:5,unrol:7,unscatt:[13,22],unseen:4,unstabl:[5,13,22],unsupervis:[0,2,5],unsymmetr:[2,9,18],until:[1,5,12,21],unusu:5,unwelcom:26,updat:[3,5,7,9,11,12,13,18,20,21,22],upgrad:[10,19],upon:[0,5,7,10,14,19,23],upper:[2,3,6,9,11,18,20],uppercas:[1,2,9,18],ups:2,upward:[10,14,19,23],usag:[0,1,2,3,6,9,18],usain:[10,19],uscibook:25,usd10000:3,usd:3,use:[0,2,3,4,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,25,26,27,31,33],usecol:[2,3],used:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,25,31,33],useful:[0,1,2,4,5,7,9,10,11,12,13,14,18,19,20,21,22,23,25],useless:5,user:[2,4,5,6,7,8,9,10,17,18,19],uses:[1,2,3,5,7,9,11,12,13,18,20,21,22,31,33],usetex:1,using:[0,3,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,25,26,27,28],usr:1,usual:[2,4,5,10,13,14,19,22,23],util:[2,3,5],utliz:[11,20],utmost:0,v_0:[7,9,10,11,12,18,19,20,21],v_1:[11,20],v_e:[11,20],v_i:[9,10,11,18,19,20],v_jb_k:[10,19],v_n:[11,20],v_t:[9,10,18,19],v_x:[10,11,14,19,20,23],v_xf_x:[11,20],v_y:[10,11,19,20],v_yf_i:[11,20],v_z:[10,11,14,19,20,23],v_zf_z:[11,20],v_zt:[10,19],valid:[0,1,5,8,10,17,19,31,33],valu:[0,2,4,5,6,8,9,10,11,12,13,17,18,19,20,21,22],van:3,vandenbergh:6,vandermond:3,vanilla:7,vanish:[1,5],var_x:1,varabl:6,varepsilon:3,varepsilon_:3,varepsilon_i:3,vari:[3,5,9,14,18,23],variabl:[2,3,4,5,6,7,9,11,13,14,18,20,22,23,25],varianc:[0,2,4,5,7],variance_i:[3,7],variance_x:[3,7],variant:[2,3,5,6,7,8,9,17,18],variat:[7,11,20,25,31,33],varieti:[0,2,5,9,18],variou:[0,1,2,4,5,6,7,8,9,11,12,14,17,18,20,21,23,25],vartempvec:1,varvec:1,vaverag:[9,18],vdt:[10,19],vec:[1,3],vecto:[11,20],vector:[4,10,11,13,14,19,20,22,23,25],vehicl:[14,23],veloc:[10,12,13,14,19,21,22,23,25],velocityverlet:[12,21],ventur:[0,2,6,8,9,11,17,18,20],verbos:5,veri:[0,1,2,3,5,6,7,9,10,11,12,14,18,19,20,21,23,25,31,33],verif:[8,17,25],verifi:[2,7,8,9,10,12,17,18,19,21],verlet:[12,13,21,22,25],versa:[11,20],versatil:[2,6,8,9,17,18],versicolor:6,version:[0,1,2,9,12,13,18,21,22,26,27,28],versu:[5,13,22],vert:[2,3,4,5,6,7,9,18],vert_1:3,vert_2:[3,7],vert_:[11,20],vertic:3,via:[0,1,2,3,5,6,7,8,9,10,11,12,17,18,19,20,21,26],vibrat:[13,22],vice:[11,20],video:[5,25],view:[0,1,2,5,8,9,11,14,17,18,20,23,25],viewpoint:26,violat:6,viridi:[2,5],virtual:[5,28],virtualenv:27,viru:25,viscos:[10,12,19,21],viscou:[10,12,19,21],vision:[0,2],visual:[0,2,3,7,12,21],viz:[1,3,6],vmax:3,vmc:1,vmin:3,volcano:[14,23],voltag:[13,22],volum:[2,10,13,19,22],volunt:27,vstack:[1,2,3,7],w_1:6,w_1x_1:6,w_1x_:6,w_2:6,w_2x_2:6,w_2x_:6,w_fc1:5,w_fc2:5,w_i:5,w_ix_i:5,w_out:5,w_px_:6,w_px_p:6,wai:[0,1,2,3,4,5,6,7,8,9,11,17,18,20,24,26,27,29],walker:1,wang:2,want:[0,1,2,3,5,6,7,9,10,12,14,15,16,18,19,21,23,27,32],warn:6,warrant:3,water:[13,14,22,23],wave:[12,21],wavelet:6,wealth:[0,8,17],weather:[5,14,23],web:[2,8,17,25,27],websit:[2,9,18,27],wedg:[1,6],wednesdai:25,weekli:25,weight:[0,1,3,4,11,20],weight_vari:5,welcom:[6,26,27,28,31],well:[0,1,2,3,4,5,6,9,10,11,12,13,14,15,16,18,19,20,21,22,23,25,32],wendi:[31,33],went:6,were:[0,1,2,3,4,5,6,7,10,11,12,13,14,19,20,21,22,23],wessel:3,what:[4,5,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,25,26],whatev:0,when:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,25,26,31,33],whenev:1,where:[0,1,2,4,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23],wherea:[1,3,10,11,13,19,20,22,31,33],wherein:5,whether:[0,1,2,4,10,11,12,13,19,20,21,22,27,31,33],which:[0,2,3,4,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23,26,31,33],who:[0,2,26],whoever:27,whole:[5,7],whose:[1,3,11,12,20,21],whow:[3,7],why:[0,2,10,14,19,23],wide:[2,3,5,9,10,12,18,19,21],widehat:3,wider:[0,14,23],width:[2,3,6],wieringen:3,wiki:26,willing:0,win:[13,22],wind:[10,12,19,21],wiscons:7,wise:[3,5],wish:[0,2,4,6,7,9,10,12,13,14,18,19,21,22,23,28],wither:3,within:[0,1,2,4,5,10,19,26,28],without:[0,2,3,5,6,7,9,10,12,18,19,21,25,26],witth:[12,21],won:[2,3],wonder:6,word:[1,2,3,7,14,23],work:[0,1,2,3,4,5,6,7,8,9,10,12,13,15,16,17,18,19,21,22,25,27,31,32,33],workflow:28,world:[3,6,7,10,19],worldwid:[2,14,23],wors:[2,3,5],would:[0,1,2,3,4,5,6,7,9,10,11,12,13,14,18,19,20,21,22,23,25,27],wrap:[2,3,9,18,25],write:[0,1,2,3,5,6,8,9,11,12,13,14,17,18,20,21,22,23,24,29,31,33],writer:5,written:[0,1,2,3,5,7,8,9,10,11,12,13,17,18,19,20,21,22,31,33],wrong:[5,6,8,17,25],wrongli:1,wrote:[0,3,7],www:[2,5,9,18,25],wx_1:6,x0s:6,x1_exampl:6,x1d:6,x1s:6,x2d:[6,7],x2d_train:7,x2dsl:7,x2s:6,x3s:6,x_0:[2,3,7,9,10,11,12,18,19,20,21],x_1:[0,1,2,3,4,6,7,9,11,18,20],x_2:[0,1,2,3,4,6,7,9,11,18,20],x_3:[1,6],x_center:7,x_data:5,x_data_ful:5,x_f:[11,20],x_i:[1,2,3,4,5,6,7,10,11,19,20],x_ix_:3,x_iy_i:6,x_j:[1,5,6],x_jy_j:6,x_k:[1,5],x_l:1,x_m:[1,5],x_n:[0,1,3,5,6,7,12,21],x_p:[4,12,21],x_reduc:7,x_scale:6,x_test:[3,5,7],x_test_own:3,x_test_scal:[3,7],x_train:[2,3,5,7],x_train_own:3,x_train_scal:[3,7],xarrai:[2,9,18],xavier:5,xcode:[2,9,18],xf_y:[11,20],xfinal:[13,22],xi_1:6,xi_:6,xi_i:6,xiniti:[13,22],xlabel:[1,2,3,6,8,9,17,18],xlim:3,xnew:2,xpd:[3,7],xplot:2,xtest:3,xtick:[3,6],xtrain:3,xytext:6,y_0:[2,3,7,9,10,11,18,19,20],y_1:[2,3,6,7,11,12,20,21],y_1y_1:6,y_1y_1k:6,y_1y_2:6,y_1y_2k:6,y_1y_n:6,y_1y_nk:6,y_2:[2,3,6,7,11,20],y_2y_1:6,y_2y_1k:6,y_2y_2:6,y_2y_2k:6,y_3:2,y_data:[3,5],y_data_ful:5,y_decis:6,y_i:[2,3,4,5,6,7,9,11,12,18,20,21],y_ix_:3,y_ix_i:[4,6],y_iy_jk:6,y_j:[3,5,6],y_k:5,y_model:3,y_n:[6,11,20],y_ny_1:6,y_ny_1k:6,y_ny_2:6,y_ny_2k:6,y_ny_n:6,y_ny_nk:6,y_p:[10,19],y_pred:[3,5,6],y_test:[3,5,7],y_test_onehot:5,y_test_predict:3,y_train:[2,3,5,7],y_train_onehot:5,y_train_predict:3,yanalyt:[9,18],year:[0,2,11,12,20,21],yes:[0,3,4],yet:[0,3,5,6,7,9,10,13,18,19,22],yf_x:[11,20],yield:[1,2,3,5,6,9,11,12,13,18,20,21,22],ylabel:[1,2,3,6,8,9,17,18],ylim:[3,12,21],yoshua:5,you:[0,1,2,3,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,25,27,28,30,31,32,33],young:[0,2],your:[0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,25,27,28,32],yourself:[2,7,13,14,22,23],ypred:3,ypredict:[2,3],yridg:3,ytest:3,ytick:[3,6],ytild:3,ytildenp:3,ytrain:3,z_0:[2,10,19],z_1:2,z_2:2,z_c:5,z_h:5,z_i:5,z_k:5,z_m:5,z_o:5,z_out:5,zaman:1,zero:[1,2,3,5,6,7,8,9,10,11,12,13,14,17,18,19,20,21,22,23],zillion:0,zip:3,zm_h:2,zone:3,zze:[13,22]},titles:["Introduction to Applied Data Analysis and Machine Learning","1. Elements of Probability Theory and Statistical Data Analysis","15. Getting started, our first data and Machine Learning encounters","16. Linear Regression and more Advanced Regression Analysis","17. Logistic Regression","18. Neural networks, from the simple perceptron to deep learning","19. Support Vector Machines, overarching aims","20. Dimensionality Reduction","Introduction","Space, Time, Motion, Reference Frames and Reminder on vectors and other mathematical quantities","Basic Steps of Scientific Investigations","Work, Energy, Momentum and Conservation laws","Harmonic Oscillator","Two-body Problems","Non-inertial Frames, Translation and Rotating Coordinate Systems","Content with notebooks","Content with notebooks","Introduction","Space, Time, Motion, Reference Frames and Reminder on vectors and other mathematical quantities","Basic Steps of Scientific Investigations","Work, Energy, Momentum and Conservation laws","Harmonic Oscillator","Two-body Problems","Non-inertial Frames, Translation and Rotating Coordinate Systems","Content in Jupyter Book","PHY321, Classical Mechanics I, Michigan State University, Spring 2021","Code of Conduct","Contributing","LectureNotes","Content in Jupyter Book","Welcome to your Jupyter Book","Markdown Files","Content with notebooks","Markdown Files"],titleterms:{"break":25,"case":[1,6,9,18],"class":4,"final":[5,7,9,10,11,18,19,20,25],"function":[1,3,4,5,6,7],"import":[1,2,9,18],"transient":[12,21],Adding:[3,6,11,20,31,33],And:[2,10,19],Going:[10,19],Ising:3,OLS:3,One:[10,19],The:[1,3,4,5,6,7,10,11,12,14,19,20,21,23],Then:[10,19],Useful:[2,9,18],Using:[5,31,33],about:2,abov:[8,17],acceler:[9,10,14,18,19,23],act:[10,19],activ:5,actual:1,adjust:5,advanc:3,aim:[3,6],air:[9,10,18,19],aka:3,algebra:[3,9,14,18,23],algorithm:[3,5,7,11,20],all:6,altern:[12,21],analysi:[0,1,3,7],analyt:[9,18],angular:[11,20],anoth:3,appli:0,approach:[0,3,6,10,19],approxim:5,april:25,architectur:5,arrai:[2,9,18],artifici:5,asap:25,aspect:0,assumpt:3,attempt:[6,9,18],attribut:26,autocorrel:1,averag:[9,18],back:[5,6,7],backend:5,background:3,ballist:[10,19],basebal:[9,18],basic:[2,3,4,7,9,10,11,18,19,20],befor:7,beta:[3,12,21],better:[1,3,6],bia:3,bias:[0,5],binari:5,bind:[2,3],binomi:1,block:[1,10,12,15,16,19,21,32],bodi:[13,22],boldsymbol:3,book:[24,28,29,30],bootstrap:[1,3],boston:3,breast:7,brief:[2,3],bring:5,bug:27,build:[5,11,20,28],buld:[11,20],calcul:1,can:3,cancer:7,center:[7,13,22],central:1,centrifug:[13,14,22,23],chain:5,chi:3,choic:[0,5],choos:5,citat:[31,33],classic:[7,10,12,19,21,25],classif:[5,7],classifi:6,code:[1,3,5,6,7,9,11,12,13,15,16,18,20,21,22,26,27,31,32,33],collect:5,compact:[9,18],compon:7,comput:[1,7,9,18],computation:3,concept:[1,8,17],conduct:[26,27],conserv:[11,20],constant:[9,18],content:[15,16,24,29,32],continu:[1,7],contn:[10,19],contribut:27,contributor:28,convex:6,convolut:5,coordin:[14,23],corioli:[14,23],correl:[1,3,7],cost:5,cote:[11,20],coupl:[11,20],covari:[1,3,7],credit:28,critic:[12,21],cromer:[9,11,18,20],cross:[3,13,22],cumul:1,cython:2,damp:[12,21],dampl:[12,21],data:[0,1,2,3,5,7],dataset:5,date:25,decompos:3,decomposit:[3,7],deep:5,defin:[5,10,19],definit:[1,5],degre:[3,7],demonstr:1,dens:3,deriv:[5,11,12,13,20,21,22],descent:5,design:[3,7],detail:[3,6,10,19],develop:5,deviat:1,diagon:7,dice:1,differ:6,differenti:[9,10,12,18,19,21],dimens:[9,10,13,18,19,22],dimension:[3,6,7],direct:[31,33],discret:[1,9,11,18,20],disguis:1,distribut:1,document:27,doing:5,domain:1,down:5,driven:[12,21],earth:[11,20],economi:3,effect:[13,14,22,23],element:[1,9,18],ellipt:[13,22],encount:[2,9,18],energi:[2,3,11,20],enforc:26,equal:[11,20],equat:[3,5,6,9,10,11,12,18,19,20,21],error:[3,11,20],essenti:[],etc:2,ethic:0,euler:[9,11,14,18,20,23],evalu:5,event:1,exampl:[1,2,3,5,6,7,8,9,11,13,17,18,20,22],execut:[31,33],expect:[1,3],expens:3,experi:1,exponenti:1,express:[3,11,20],extens:[9,18],extrem:[],factor:[12,21],fall:[9,10,14,18,19,23],famili:[3,5],famou:[1,2,9,18],fantast:3,featur:[2,3,6,7,9,18,27],februari:25,feed:5,feedback:27,field:[10,19],file:[31,33],find:[3,9,18],first:[2,5,6,9,10,18,19],fit:[2,3],fix:[3,27],fold:3,forc:[10,12,13,14,19,21,22,23],forward:5,foucault:[14,23],fouri:[12,21],fourier:[12,21],frame:[9,14,18,23],frank:[3,7],freedom:[3,7],frequentist:0,from:[3,5,14,23],full:5,funtion:5,galilean:[14,23],gaussian:1,gener:[1,3],geometr:7,get:[2,6,27],going:3,good:0,grade:25,gradient:5,gravit:[13,22],handl:[0,2,9,18],happen:3,harmon:[12,13,21,22],height:[9,18],host:28,hous:3,how:[1,3,6],hyperbol:5,hyperparamet:5,hyperplan:6,idea:7,identifi:[10,19],illustr:[8,17],implement:[1,5,9,18,27],improv:5,includ:[4,9,18],increment:7,inerti:[14,23],instal:[2,9,18],integr:[9,11,18,20],interpret:[3,7],introduc:[3,7],introduct:[0,2,4,8,17],investig:[10,19],its:1,jackknif:[1,3],januari:25,julia:2,jupyt:[24,29,30],kera:5,kernel:[6,7],known:[8,17],kutta:[12,21],label:[9,18],lagrangian:6,lambda:3,languag:0,lasso:3,last:6,law:[10,11,19,20],layer:5,learn:[0,2,3,5,7,25],least:3,lectur:25,lecturenot:28,librari:[2,9,18],likelihood:4,limit:[1,5],linear:[2,3,6,14,23],link:[3,7,25],list:5,lle:7,logist:[4,5,7],machin:[0,2,6,7],made:3,magnet:[10,19],mai:25,main:1,mani:[5,8,17],march:25,markdown:[15,16,31,32,33],mass:[2,13,22],materi:25,math:3,mathemat:[3,5,6,9,11,18,20],matric:[2,9,18],matrix:[1,2,3,5,7,9,18],matter:3,maximum:4,mean:[1,7],mechan:25,meet:[1,2,9,18],mercer:6,mersenn:1,method:[1,3,9,11,12,18,20,21],michigan:25,minim:6,mlp:5,model:[0,2,3,5,9,10,18,19],moment:1,momentum:[11,20],moon:6,more:[2,3,4,6,7,9,10,12,18,19,21],motion:[9,10,13,18,19,22],multi:5,multidisciplinari:[],multilay:5,multipl:5,multipli:6,myst:[15,16,31,32,33],name:1,need:[2,9,18],network:[2,5],neural:[2,5],neuron:5,newton:[10,11,19,20],non:[6,14,23],normal:1,notat:5,note:25,notebook:[15,16,32],now:[3,7],nuclear:[2,3],numba:2,number:[1,3,7],numer:[1,11,12,20,21],numpi:[2,9,18],object:[5,10,14,19,23],observ:1,obtain:7,omega_0:[12,21],one:[3,5,9,10,18,19],ones:5,optim:[3,5,6],optmiz:6,orbit:[13,22],ordinari:3,organ:2,orient:5,oscil:[12,13,21,22],other:[1,5,7,9,18,25],our:[1,2,3,5,7,9,10,12,18,19,21,26],outcom:[0,25],output:[1,15,16,32],overarch:[3,6,7],overdamp:[12,21],own:[3,7],packag:[2,9,18],panda:[2,3,7,9,18],paramet:[3,4],part:[10,19],pass:5,pca:7,pdf:1,pendulum:[10,12,14,19,21,23],perceptron:5,perform:[3,5],period:[1,12,21],perspect:[5,14,23],philosophi:[11,20],phy321:25,pledg:26,poisson:1,possibl:25,potenti:[13,14,22,23],practic:[9,18,25],pre:5,preprocess:[3,7],princip:7,principl:[12,21],probabl:[0,1],problem:[3,5,6,11,13,20,22],procedur:3,process:5,program:0,projectil:[10,19],proof:7,propag:5,properti:[1,3],pseudo:1,python:[1,2,9,18],quadratur:[11,20],quantiti:[9,18],quick:6,raindrop:[10,19],ran0:1,random:[1,7],read:2,real:2,realist:6,recip:1,rectangl:[11,20],rectangular:[11,20],recurr:5,reduc:[3,7],reduct:7,refer:[9,18],reformul:3,regress:[2,3,4,7],regular:[3,5],rel:[13,22],relev:5,relu:5,remind:[2,6,9,18],report:27,repositori:3,resampl:3,resist:[9,10,18,19],reson:[12,21],respons:[12,21,26],result:[3,10,19],rewrit:[3,7],rich:[],ridg:3,rng:1,role:[31,33],rotat:[14,23],rule:[5,11,20],rung:[12,21],rutherford:[13,22],same:3,sampl:[1,7],scale:[10,12,19,21],scatter:[13,22],schedul:25,scientif:[10,19],scikit:[2,3,5,7],scope:26,second:[10,19],section:[13,22],see:2,select:1,seri:[12,21],set:[3,5,6,10,19],should:[1,5,7],sigmoid:5,simpl:[1,2,3,5,6,7,9,11,18,20],simpler:6,simpson:[11,20],singl:[10,19],singular:[3,7],sinusoid:[12,21],situat:1,size:3,slide:[10,12,19,21],small:0,soft:6,softer:[10,19],softmax:5,softwar:[2,9,18],solar:[11,20],solut:[9,13,18,22],solv:[6,9,10,12,18,19,21],some:[2,3,9,18],space:[6,9,18],split:[3,10,19],spring:25,squar:3,stabil:[13,22],standard:[1,26],start:[2,27],state:[3,25],statist:[1,3],step:[3,6,7,10,11,19,20],stochast:1,studi:[11,12,20,21],submit:27,suit:3,sum:3,summari:2,sun:[11,20],superposit:[12,21],supervis:5,support:[6,7],svd:3,symmetri:[11,20],system:[10,11,14,19,20,23],teach:25,team:25,techniqu:7,tensorflow:5,term:5,test:[3,5],textbook:25,theorem:[1,5,6,7,14,23],theori:1,thi:25,think:7,third:[10,19],three:1,tidal:[13,22],tied:[10,19],time:[9,18],togeth:5,top:5,toss:1,toward:7,tradeoff:3,train:[3,5],transform:[12,14,21,23],translat:[14,23],trapezoid:[11,20],tree:2,truncat:[11,20],two:[4,6,10,13,19,22],type:[2,5],uncorrel:1,underdamp:[12,21],understand:3,uniform:1,unit:[9,18],univers:[5,25],updat:25,usag:28,use:[1,5],useful:3,using:[1,2,5],valid:3,valu:[1,3,7],variabl:1,varianc:[1,3],variou:3,vector:[2,3,5,6,7,9,18],veloc:[9,11,18,20],verlet:[11,20],view:[3,7],visual:5,wai:[10,19],wall:[10,19],week:25,weight:5,welcom:30,well:[8,17],what:[0,1,2,3,6,31,33],where:3,which:[1,5],why:[1,3,5,7],width:[12,21],wood:2,work:[11,20],write:[7,27],your:[30,31,33],z_j:5}}) \ No newline at end of file diff --git a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter1.html b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter1.html index e373356cc..e66c8b392 100644 --- a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter1.html +++ b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter1.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter2.html b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter2.html index 493002026..3bbe9cae9 100644 --- a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter2.html +++ b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter2.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • @@ -1603,8 +1613,8 @@ developed in the 1970s, namely EISPACK and LINPACK. We describe them shortly he
    -
    [ 0.90559229 -2.01023012 -0.44771747  1.75725059 -1.23503845  0.00290572
    - -1.00282695  1.34507057  1.8031745  -0.99146414]
    +
    [ 1.54613374 -0.53808134 -0.25599148 -2.19980623 -1.26614367  2.09110254
    +  0.54374681  0.6362131   1.04152939 -1.69246995]
     
    diff --git a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter3.html b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter3.html index f837b00ec..45cae9446 100644 --- a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter3.html +++ b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter3.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter4.html b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter4.html index bef2df4a1..e15eb5827 100644 --- a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter4.html +++ b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter4.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter5.html b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter5.html index 446e476f4..d66630259 100644 --- a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter5.html +++ b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter5.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter6.html b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter6.html index 33374daf5..7c190a792 100644 --- a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter6.html +++ b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter6.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter7.html b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter7.html index 97b70508a..409ae0789 100644 --- a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter7.html +++ b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/chapter7.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/lecturenotes/lecturenotes/notebooks.html b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/lecturenotes/lecturenotes/notebooks.html index b0c0618e7..3253a021c 100644 --- a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/lecturenotes/lecturenotes/notebooks.html +++ b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/lecturenotes/lecturenotes/notebooks.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/notebooks.html b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/notebooks.html index 0a47f2306..f388fed80 100644 --- a/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/notebooks.html +++ b/doc/src/LectureNotes/_build/html/testbook/_build/jupyter_execute/notebooks.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/chapter1.html b/doc/src/LectureNotes/_build/html/testbook/chapter1.html index 6b6d8620f..193a8de3c 100644 --- a/doc/src/LectureNotes/_build/html/testbook/chapter1.html +++ b/doc/src/LectureNotes/_build/html/testbook/chapter1.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/chapter2.html b/doc/src/LectureNotes/_build/html/testbook/chapter2.html index 64d91e9cd..1f78bb349 100644 --- a/doc/src/LectureNotes/_build/html/testbook/chapter2.html +++ b/doc/src/LectureNotes/_build/html/testbook/chapter2.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • @@ -1603,8 +1613,8 @@ developed in the 1970s, namely EISPACK and LINPACK. We describe them shortly he
    -
    [-1.36647401  0.48392582  1.3866607  -1.32437748 -1.27886869 -0.45735097
    -  2.09942022  0.4864173  -0.46526198  1.4136186 ]
    +
    [ 0.37402521 -0.6723554   0.34705159 -0.23106244  0.37640289  1.26261376
    + -1.28899002  0.59279401 -1.28878405 -0.82161508]
     
    diff --git a/doc/src/LectureNotes/_build/html/testbook/chapter3.html b/doc/src/LectureNotes/_build/html/testbook/chapter3.html index 8b7a86aa0..ca795115c 100644 --- a/doc/src/LectureNotes/_build/html/testbook/chapter3.html +++ b/doc/src/LectureNotes/_build/html/testbook/chapter3.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/chapter4.html b/doc/src/LectureNotes/_build/html/testbook/chapter4.html index a9d97f924..cbc1e8217 100644 --- a/doc/src/LectureNotes/_build/html/testbook/chapter4.html +++ b/doc/src/LectureNotes/_build/html/testbook/chapter4.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/chapter5.html b/doc/src/LectureNotes/_build/html/testbook/chapter5.html index 3b009f97a..74c05c336 100644 --- a/doc/src/LectureNotes/_build/html/testbook/chapter5.html +++ b/doc/src/LectureNotes/_build/html/testbook/chapter5.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/chapter6.html b/doc/src/LectureNotes/_build/html/testbook/chapter6.html index 24f0c32b5..e48c39d7d 100644 --- a/doc/src/LectureNotes/_build/html/testbook/chapter6.html +++ b/doc/src/LectureNotes/_build/html/testbook/chapter6.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/chapter7.html b/doc/src/LectureNotes/_build/html/testbook/chapter7.html index 18f43b015..2aac939e8 100644 --- a/doc/src/LectureNotes/_build/html/testbook/chapter7.html +++ b/doc/src/LectureNotes/_build/html/testbook/chapter7.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/content.html b/doc/src/LectureNotes/_build/html/testbook/content.html index c5fc77275..d3596a040 100644 --- a/doc/src/LectureNotes/_build/html/testbook/content.html +++ b/doc/src/LectureNotes/_build/html/testbook/content.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/intro.html b/doc/src/LectureNotes/_build/html/testbook/intro.html index 2c9d21112..679fa8fb5 100644 --- a/doc/src/LectureNotes/_build/html/testbook/intro.html +++ b/doc/src/LectureNotes/_build/html/testbook/intro.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/CONDUCT.html b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/CONDUCT.html index d50f6a554..e82b3c2b7 100644 --- a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/CONDUCT.html +++ b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/CONDUCT.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/CONTRIBUTING.html b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/CONTRIBUTING.html index 8f8e1c046..a25bcd8f1 100644 --- a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/CONTRIBUTING.html +++ b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/CONTRIBUTING.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/README.html b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/README.html index e911298e2..c302f7bde 100644 --- a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/README.html +++ b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/README.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/content.html b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/content.html index 72bdce70d..0c90c302f 100644 --- a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/content.html +++ b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/content.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/intro.html b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/intro.html index be84cf3b1..7dab19a74 100644 --- a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/intro.html +++ b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/intro.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/markdown.html b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/markdown.html index f6028a82e..a6b7b46e2 100644 --- a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/markdown.html +++ b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/markdown.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/notebooks.html b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/notebooks.html index 8cc58ffb7..79ecee8f8 100644 --- a/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/notebooks.html +++ b/doc/src/LectureNotes/_build/html/testbook/lecturenotes/lecturenotes/notebooks.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/html/testbook/markdown.html b/doc/src/LectureNotes/_build/html/testbook/markdown.html index c2476bf7a..41e66e4e6 100644 --- a/doc/src/LectureNotes/_build/html/testbook/markdown.html +++ b/doc/src/LectureNotes/_build/html/testbook/markdown.html @@ -173,6 +173,16 @@ 18. Neural networks, from the simple perceptron to deep learning +
  • + + 19. Support Vector Machines, overarching aims + +
  • +
  • + + 20. Dimensionality Reduction + +
  • diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter1.ipynb b/doc/src/LectureNotes/_build/jupyter_execute/chapter1.ipynb index 54b83d865..1e244ebde 100644 --- a/doc/src/LectureNotes/_build/jupyter_execute/chapter1.ipynb +++ b/doc/src/LectureNotes/_build/jupyter_execute/chapter1.ipynb @@ -413,6 +413,8 @@ "chapter4.ipynb\n", "chapter5.ipynb\n", "chapter6.ipynb\n", + "chapter7.ipynb\n", + "chapter8.ipynb\n", "```\n" ] } diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter1.txt b/doc/src/LectureNotes/_build/jupyter_execute/chapter1.txt index 503b79146..ea7542ffd 100644 --- a/doc/src/LectureNotes/_build/jupyter_execute/chapter1.txt +++ b/doc/src/LectureNotes/_build/jupyter_execute/chapter1.txt @@ -402,4 +402,6 @@ chapter3.ipynb chapter4.ipynb chapter5.ipynb chapter6.ipynb +chapter7.ipynb +chapter8.ipynb ``` diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter2.ipynb b/doc/src/LectureNotes/_build/jupyter_execute/chapter2.ipynb index 4b0fa0e97..ee510de2f 100644 --- a/doc/src/LectureNotes/_build/jupyter_execute/chapter2.ipynb +++ b/doc/src/LectureNotes/_build/jupyter_execute/chapter2.ipynb @@ -1094,27 +1094,27 @@ "name": "stdout", "output_type": "stream", "text": [ - "1.5027679581515354\n", - "[[ 4.01839868 4.38511101 9.23577076 8.53622276 4.78693205 9.01249172\n", - " 5.62006613 2.52380443 6.68351121 4.12787844]\n", - " [ 4.38511101 4.78528891 10.07861174 9.31522416 5.22377946 9.83495664\n", - " 6.13294396 2.7541226 7.29343725 4.50458172]\n", - " [ 9.23577076 10.07861174 21.22722716 19.61940636 11.00214554 20.71404911\n", - " 12.9169967 5.80063878 15.36118796 9.48739587]\n", - " [ 8.53622276 9.31522416 19.61940636 18.13336726 10.16880644 19.14509813\n", - " 11.9386204 5.3612791 14.19768049 8.76878895]\n", - " [ 4.78693205 5.22377946 11.00214554 10.16880644 5.70245024 10.73616358\n", - " 6.69492424 3.00649122 7.96175706 4.91735022]\n", - " [ 9.01249172 9.83495664 20.71404911 19.14509813 10.73616358 20.21327739\n", - " 12.60472232 5.66040565 14.98982413 9.25803368]\n", - " [ 5.62006613 6.13294396 12.9169967 11.9386204 6.69492424 12.60472232\n", - " 7.86013182 3.52975127 9.34744857 5.77318272]\n", - " [ 2.52380443 2.7541226 5.80063878 5.3612791 3.00649122 5.66040565\n", - " 3.52975127 1.58510624 4.19766095 2.59256454]\n", - " [ 6.68351121 7.29343725 15.36118796 14.19768049 7.96175706 14.98982413\n", - " 9.34744857 4.19766095 11.11619967 6.86560096]\n", - " [ 4.12787844 4.50458172 9.48739587 8.76878895 4.91735022 9.25803368\n", - " 5.77318272 2.59256454 6.86560096 4.24034094]]\n" + "9.106279149747735\n", + "[[ 1.87336856 1.77787047 1.44771535 6.44982327 11.43684153\n", + " 5.83694909 1.84228806 7.37557482 -2.58314202 6.48643762]\n", + " [ 1.77787047 1.68724056 1.37391564 6.12103277 10.85382947\n", + " 5.53940088 1.74837435 6.9995926 -2.45146205 6.15578065]\n", + " [ 1.44771535 1.37391564 1.11877597 4.98434123 8.83824539\n", + " 4.51071987 1.42369673 5.69975023 -1.99621924 5.01263633]\n", + " [ 6.44982327 6.12103277 4.98434123 22.2061057 39.37591798\n", + " 20.09604032 6.34281617 25.39337703 -8.89350334 22.33216531]\n", + " [ 11.43684153 10.85382947 8.83824539 39.37591798 69.82146882\n", + " 35.63434516 11.2470963 45.02759486 -15.76998069 39.59944717]\n", + " [ 5.83694909 5.53940088 4.51071987 20.09604032 35.63434516\n", + " 18.18647726 5.74011 22.9804512 -8.04842615 20.21012151]\n", + " [ 1.84228806 1.74837435 1.42369673 6.34281617 11.2470963\n", + " 5.74011 1.8117232 7.25320885 -2.54028588 6.37882306]\n", + " [ 7.37557482 6.9995926 5.69975023 25.39337703 45.02759486\n", + " 22.9804512 7.25320885 29.03812156 -10.16999948 25.53753014]\n", + " [ -2.58314202 -2.45146205 -1.99621924 -8.89350334 -15.76998069\n", + " -8.04842615 -2.54028588 -10.16999948 3.56183127 -8.94398998]\n", + " [ 6.48643762 6.15578065 5.01263633 22.33216531 39.59944717\n", + " 20.21012151 6.37882306 25.53753014 -8.94398998 22.45894054]]\n" ] } ], @@ -1673,15 +1673,15 @@ "name": "stdout", "output_type": "stream", "text": [ - "-0.02709116808235872\n", - "4.0262891855828515\n", - "-0.05083752107727271\n", - "1.1034925742304618 9.662232920789233 19.396576628082066\n", - "3.1026745228913506 3.57651731449913 9.947888130154134\n", - "[[ 1.10349257 3.10267452 3.57651731]\n", - " [ 3.10267452 9.66223292 9.94788813]\n", - " [ 3.57651731 9.94788813 19.39657663]]\n", - "[26.46728898 0.08444587 3.61056727]\n" + "0.06894012083823547\n", + "4.139781119573823\n", + "0.04321525078901231\n", + "1.0006918520539008 10.50426403458282 18.88724031810869\n", + "3.0717579594084814 3.4645963550106305 10.40024628605229\n", + "[[ 1.00069185 3.07175796 3.46459636]\n", + " [ 3.07175796 10.50426403 10.40024629]\n", + " [ 3.46459636 10.40024629 18.88724032]]\n", + "[26.72833966 0.07676079 3.58709575]\n" ] } ], @@ -2296,7 +2296,7 @@ "outputs": [ { "data": { - "image/png": "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\n", + "image/png": "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\n", "text/plain": [ "
    " ] @@ -2402,12 +2402,12 @@ "name": "stdout", "output_type": "stream", "text": [ - "0.02793163482104733 1.025167138849349\n" + "-0.027481252820017347 1.0170183171235068\n" ] }, { "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAYcAAAESCAYAAAAWtRmOAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4yLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy+WH4yJAAAgAElEQVR4nO3de5xf450H8M9DRNoGYyKK0pXJFlXETiat25ZlgiWuO6SslmiNrbSktIm4lV1dlZZqKE3Q1GJfIuPWVt0mFtGiJuOakJAfQYjITH6SlGSSyXf/+J7HuTznd5v5nd/vzMzn/Xqd1++c59yec+ac8z2X53nGiAiIiIiCNqt2BoiIKH0YHIiIyMHgQEREDgYHIiJyMDgQEZGDwYGIiBwMDlRWxpg51c5Dbxhj6o0xS3o4b4/my5GH5krty3Llm/oXBgcqG2NME4AmY0xNifM1J5SlkolIO4BMoW2Iy7OIjCxTNqYCuBvAWWVa3mcSzjf1IwwOVE61AFoAFH2x9y7CZyeWowTE5dkYU+cFx3KoEZGsiGTLtDwAFck39SMMDlQW3oWnE8AMuBegRmPMEmNMjXcxeswY0+iNrgNQY4xpMsbUB+Zp9uZrtBevQFq9nTbHdHZ9jcaYOd56nTRv2sleWrMxpi5mu+z6rg6Mj8tzJ4CrA8stlK9GY8yM6BOKt7xab9l1+fZdoeXF7K/E8k39z6BqZ4D6jZNFZCYAGGNqjTH13isaiEirMSbj9WeMMY8BqPGG240xWRFpsQuyFyURafWG7YV5mIjM9PqneMuJTpcJrK9TRE7yFuuk2VcsgfnnALDTW2eLyEnGGACY4g07eRaRrN3GHPkP5ivj7Yd6AA0AWgPLaTfGdAJo9Z4cMnn2Xc7leXkYGdxfInJ2Uvmm/odPDlQuI7070iboRaM3r4rGAsgEhjsAHAbgeUAvkiJydo7pGrz+WhucAqJpowFkA3fWz8fkZYq3TQ0x40rJf3D+zkB/Oe7A45Y3Bu7+KqTS+aYUY3CgXvMurLNFpMW7Kz0LwMl5Zol+AO30lmNfNc2HvgIJTj8XesGz66zJMV1bCVm3Tx7tXtCYGRzp5WeKt032btquL5rnoN7mK59iPx4/D3d/AdXLN/UxDA7UK15guBnhi0qdN25G4GI6A0Bz4F332YEL1hwTKEXjvZ6y3wmaAMwXkWkAOrynk0YAdTmma7fv14PLjEuzr1eCywy8mz8Z/oW0HnqnXBvYzjlxy4f/ei1nvgCc7G37WABjI98J7DTBj/qx+y7f8rxtC+2vJPNN/Y9hk91ERBSV2JND4C4nblyTd3cyOan1ExFRzyUSHLzH2NjanTZoeCUisvmCCBERVUciwcG78GdyjB4PwFbuyQCI+zBGRERVVI0P0raylDWsCnkgIqI8WFqJiIgc1aghnYUWCQT0KaIjOoFX1K4ZAGq22GL0yH32qVzuiIj6gfnz568UkeE9nb9iwcEre50FMBt+rcs6xFTB98pbzwSAhh12kLY21sMhIiqFMWZpb+ZPqrRSE4AGE27tcS7wWZPItkRTNqaJAyIiqrLUV4Jr2GEHaVu+vNrZICLqU4wx80WklDbBQvhBmoiIHAwORETkYHAgIiIHgwMRETkYHIiIyMHgQEREDgYHIiJypD84pLweBhFRf5T+4EBERBXH4EBERA4GByIicjA4EBGRg8GBiIgcDA5ERORgcCAiIgeDAxERORgciIjIweBARESO9AcHNp9BRFRx6Q8ORERUcQwORETkYHAgIiIHgwMRETkYHIiIyMHgQEREDgYHIiJyMDgQEZGDwYGIiBwMDkRE5Eh/cGDzGUREFZf+4EBERBU3KImFGmOaAGQB1IvItDzj60RkZhJ5ICKiniv7k4Mxph4ARKQVQNYOR8ZnvPGZ6HgiIqq+JF4rjYc+FQBABkBjzDRXe791ItKeQB6IiKgXkggONQA6A8PDgiO9YJAxxqyKTEdERClR8Q/Sxpga6JPFVQBuNsbUxUzTbIxpM8a0rVu3rtJZJCIa8JIIDlkAtV5/DYCOyPhmAFd5H6rPAtAUXYCIzBSRBhFpGDJkSAJZJCKifJIIDrMB2KeBOgCtwGdPDCEi0gL/+wQREaVE2Yuyiki7MabBGNMIIBv44DwXwGgRmWaMmWyMyQCoZVFWIqL0SaSeQ9wFX0RGB/qdug9ERJQe6a8hzeYziIgqLv3BgYiIKo7BgYiIHAwORETkYHAgIiIHgwMRETkYHIiIyMHgQEREDgYHIiJyMDgQEZGDwYGIiBzpDw5sPoOIqOLSHxyIiKjiGByIiMjB4EBERA4GByIicjA4EBGRg8GBiIgcDA5ERORgcCAiIgeDAxERORgciIjIweBARESO9AcHtq1ERFRx6Q8ORERUcQwORETkYHAgIiIHgwMRETkYHIiIyMHgQEREDgYHIiJyDEpiocaYJgBZAPUiMi1mfD2AOgAQkZYk8kBERD1X9icH78IPEWkFkLXDEVO9oFCXYzwREVVREq+VxkOfGgAgA6AxONJ7qngeAERkmoi0J5AHIiLqhSSCQw2AzsDwsMj4MQCGGWPqjTGTCy6NzWcQEVVctT5Id9gnBu9JIsQY02yMaTPGtK3v6qp87oiIBrgkgkMWQK3XXwOgIzK+A/q6yU47JroAEZkpIg0i0rDl4MEJZJGIiPJJIjjMhlcSyfttBQBjTI2X1hIYXwPv+wMREaVH2YND4HVRI4Bs4IPzXG98BlqKqQnAMBZlJSJKHyMp/+DbsO220rZqVbWzQUTUpxhj5otIQ0/nZw1pIiJyMDgQEZGDwYGIiBzpDw4p/yZCRNQfpT84EBFRxTE4EBGRg8GBiIgcDA5ERORgcCAiIgeDAxERORgciIjIweBAREQOBgciInIwOBARkSP9wYHNZxARVVz6gwMREVUcgwMRETkYHIiIyMHgQEREDgYHIiJyMDgQEZGj6OBgjNk6MrxruTNDRETpMKiEaWsBrDbG/ByAAOgA8MtEckVERFVVVHAwxowQkbe8wdki8oIxZkSC+SIioioqKjiIyFvGmH2hTw9tNi3JjBERUfUU++SwNYCRALIAxhtjlgDYFsAqEXk8wfyx+Qwioioo9pvDXBEZY/uTygwREaVDsaWVViWaCyIiSpVig8NJxpgTE80JERGlRrEfpD8GcG/CeSEiopRIpIa0MabJGNNojJlcYLq844mIqDrKHhyMMfUAICKtALJ2OGa6RgBjy71+IiLqvSSeHMZDi7wCQAZAYwLrICKiBCURHGoAdAaGh0UnMMbUe08WRESUQtVqlbU230hjTLMxps0Y07ahq6tSeSIiIk8SwSEL/+JfA22g7zPFPDWIyEwRaRCRhi0GD04gi0RElE8prbIWazaABq+/DkArABhjakQkC6DOGFMHDSC1XrBoz7k0Np9BRFRxZX9ysBd6rzRSNnDhn+uNbxGRFi+tptzrJyKi3jOS8jvzhq22krY1a6qdDSKiPsUYM19EGgpPGY//JpSIiBwMDkRE5GBwICIiB4MDERE5GByIiMjB4EBERA4GByIicjA4EBGRg8GBiIgc6Q8OKa/BTUTUH6U/OBARUcUxOBARkYPBgYiIHAwORETkYHAgIiIHgwMRETkYHIiIyMHgQEREDgYHIiJyMDgQEZEj/cGBzWcQEVVc+oMDERFVHIMDERE5GByIiMjB4EBERA4GByIicjA4EBGRg8GBiIgcDA5ERORgcCAiIgeDAxEROQYlsVBjTBOALIB6EZkWM77Z6x0pIlPyLozNZxARVVzZnxyMMfUAICKtALJ2ODC+EUCriMwEUOcNExFRiiTxWmk89KkBADIAohf/ukBaxhsmIqIUSeK1Ug2AzsDwsOBI74nBqgcwO4E8EBFRL1Ttg7T3uqldRNpjxjUbY9qMMW0bN26sQu6IiAa2JIJDFkCt118DoCPHdI25PkaLyEwRaRCRhkGDEvlmTkREeSQRHGbD/45QB6AVAIwxNXYCY0yzLcXED9JEROlT9uBgXxN5F/1s4LXR3ED61caYJcaYVeVePxER9V4i72wiH51t2mjvtxXAtkmsl4iIyoM1pImIyMHgQEREjvQHBzafQURUcekPDkREVHEMDkRE5GBwICIiB4MDERE5GByIiMjB4EBERA4GByIicjA4EBGRg8GBiIgcDA5ERORIf3Bg8xlERBWX/uBAREQVx+BAREQOBgciInIwOBARkYPBoRLWrwd23x149NFq54SIqCgMDpXwne8AixcD555b7ZwQERWl7weHjRuBTz6pdi7yu/tu/d2s7+/uslq7FvjiF/lERZRCfeNqJQK88EL8uOOPB77whcrmp6c237zaOaisDz8E7rsv9/jXXwdWrACmTKlcnoioKH0jONxyC1BfDzz0kDvuwQf1ty9UlvvoI2DatL6R13I45hjgxBOB1avjxxujvxs2AKtWVS5fxXjqKWDZsmrngqhq+kZweOUV/T3rLOCII+KnyXUBilq7FshktD+T0QvUE0/0Oos5BQPBhx/qXfKrr/ppH30ELF+ee/5XXwX+8pfy56mtLXeQevvt8lys33lHf//+9/jx9nXgggVAbS3Q0QHMnp1soOjoAJYuLTzdwQcDo0Yllw+ilOsbwcFatkzfT9uL2i23+ONeeQV47jl/eOVK4LDD3AvvEUcAI0dq/5NP6u/vf59YlrFunZu2YIEfILbfHthxx9zz7703cNBBwBlnxC+rJ+6+GxgzBrjrrvjxI0YA++5b3LJefhm4+mo3ff58DYaABmRA9/Nmm/nbsWZNeJ5584BvfQv49reLW3dP/MM/ALvumn8ae3x1dCSXj2I88ADQ2ho/bsUKvbGI09mpx3+5tbfrsmlgEJFUd6P1VA13H38sIuKmA/KZ//5vHZ46VULsdJs2icyapf2nny5F+d3vRO6/v7hpRUQWLxY57bT4fNq8RvMdFZz+nnuKX3c+V16py7voovzrFNHtfeGFwvnr7s6d7/nzRS64wB9evFinueuu8HS//rX+jhwp8pe/+Mt64w2R5maRDRt6vs1x2xZ0000iTU3a/8knhf8ulZAvDz0d11ObNuky6+vLu1xKDIA26cW1t289OVgffJD7lcjjj+vv+vX629YGLFqkryuCNm70+4v9BnDmmfoBvJBZs/QO64QTgDvuKG7ZcR55JDzc028VDz7ov0oDgC220N+uLk0fMgR47TVN6+4Oz3v88cA//ZO7zEmTgF//2h/esCH3+tesAa65xh+2d7z2icL64AP9XbIEOPBA//XPqacCM2cCM2bot6ckSqd9//tAS4v253oNlkb/93/6ZNnVlex67Ku+9vb807W2Aldc0bN1dHcD116b/tKHA0TfDQ65LkaHHaa/9tXFY48Be+yhryuC1q/3P4hu2hQet2yZjstVxHL9en3Ns2SJDnd3A+edp+/qFyzQIDJsmPaXwgasJ58Esln9mBskooHO+uEP9fVQIePGAXvu6Q/b4LBhA3DPPbo9t96qaYW+3XR0ANdfr4Fh0iQ//brr3Iu9FV2mDQLR6bPZ+Pns3/qCC7TU2osv5s9jb6xZEw4OS5dqBcb33ss9j4geZ6tW6etNY/Qi2tWV+9VP1PLl+Ut25dLUpN+k7D6Nuv9+4M478y/D3kjlY18RbrllOP3II4EbbvCHTz0VuPxy4I03/LRrrtEgVkhLi/6NL7mk8LRB77/f8xunVauA//mfns3bz/Xd4FDo7iLuTuqkk/z+YHCIzvf889r/m9/EL/vRR4HbbgN+/GMd/tvfgOnTgQkTSrvrDL5zv/12vWi/8QZwyCF6xz50aHj6a6/VQHf66Tp8ww36ZDRjhn7DePrp3Otav14vWCtWAIMH+9s6ZIj2f/qp/n78sT/P3Ll+vz1ht9suvjLfhRcC55+vF/T99w+Pi15Y7Xej998Pp//hD+Hhn/xEKw/aoGkvAPnqi9x0E3DxxXpzMHYs8Oc/5542zj33hJ+Idt1V8zBlil9fBdB9Z/Pz4ovA4YcDp52mQdJu45Zb6jelYi5chx+uNwOffuq/aCuG/QYQfeKzTjhB8zV9urvMRx/Vc2DIkPCTZZwVK/TXHpNdXXqMPvKI3qRYW22lv5mMBsqVK/U8OfTQwttij8F833pWrAhvx5tvAl/6EvCrXxVefpwf/EDPp/nz3XFXXw386Ec9W25/0Jt3UpXoYr85GCOy99653+XPnKnvRnONB0QWLhS58ELt//d/15d0N92kwzNm6K9dx0MP6Tt1O++tt0roW8WTT+rwgQeK/PWv+dcb7A47zO8/+GD9/f3v9fdznxPZbbfc8+pLRbd7+GEd19Ehsn69vqcPjv/Sl/ztO+sskZtv1v4JE3S+F1/Mvc4PPsi/PfvvL9La6qaPHOmm5du2YDd6tMhXvxpOe+qpfC9a3e7oo0W22y48ftMmf56NG0U237y4/Ij479+HDBFpb/e3eaedRI46ys+3neeTT+Lz+txzum4RkS220Gk7OkT+67/cdRbazoULRR5/PLxfo9Pdf3/429Dhh/vj7r1X01auFLn4Ys3Hr36l+bv0Un+6rbcW6epy/ybLl+v8u++uw3Pm6O/gwe52dHTofrv1VpF58zTt6af99Zx2mj/tq6+KXHON9r/wgn+OWI89pmmHHBK/n4Keespfn3XkkTr/Aw/k3seFdHaKLFtWeLoKQy+/OfR4xkp1scGhHN222/r9NjgceqgOf+974WmPPVZk9Wp/+Oc/198LLtD5Hn5Yhw86SGTuXH+64MlXqLPB7LLL9HfLLUV22UXk85+Pnz4YrILdzTf7F6+mJpG1a91pbrlFf884ww+Qp5yiwSSY/2hnP2RXsvv6191AMmuWXqTuu0/3/6uv6g3B176Wf1kifv+6dTr85pul5Wfnnf0Liu3++Z/1d+hQP80Yv3/ZMr14fvyxXgQ3bhRpa9NxP/2p5sNOby+AwW7jRpGJE0X+9rfgmR/uXnhBZI89cm+v7b77XU3v7vZvSACR8eP1d8IE/d1mG/394Q/dZZx4Yvy+sccu4N9ABbvrrtN119Tkz+cpp2jawoUiW22laZdfLvKFL2j/Oef4+2HSJE375jf9tDFj9NyzQXnlyvB2dHfruX7AASI77KBphxyiBSKspUv96c8+W//mb72lf7/OTgnZZRd/O1IklcEBQBOARgCTezI+2CUWHILdcceJnHCCyJ576vDpp4fHH3OMyHvv+cPf/77+XnqpyM9+JnLmmf4B+sAD/nTf+lbpeTnhBL9/661FRo2Kn+6jj+LTzzxTL5Z2eOVKdxr7hHTqqX7ajjtK6OKQlu7QQ0Xq6uLHffGL9iworrNBE/BLvH3zm8lvgz2ugt1DD+nvYYf5/YBIbW3+Za1dG7/Nzz4r8uUvh9P+/Of4ZYjoBTRuXKEn7t5sM6BPDdG0jRvdtMcfz73sCy4QWbNGS8HZtN12E7n99vj9dcwx4bSpU3Mv+8YbwzeC+brly0Vmz/aH16wReeklkREjNGgtXepesTdu1Juazk4NcqtX++NWrhT5t3/T+a68UuTvfw/Pu3ChyG235YsHIakLDgDqATR5/c0A6ksZH+2c4GDvHpLsondG48bpHyY63bHHhodHjvTvygE/aJTS/eM/hofHjo2f7v77i1veu++6abbI6Mknu+M226w8+zB40vSmO+4496JnuyFD9AQtdlkjRvj9ixaV/tRQzu7uu3s+7/vvu2lPPCEyfHhx84tUb7vjunHj3LTJk/PPs88+In/4Q+Fln3Za7husXF0mU9x0//u/4eFf/ELk2mvDaW+9pU913d0izzwj8i//Eh4/bZreZO65p8j224fH/eY3GjzOPz+c3tqqQeLdd/UY7u52i5KXITgMSuAzxngAj3n9Ge8Job2E8flttVXyRQ2DH2UBLc0UV4pn8eLw8JIlwPe+17t1v/lmeHiXXeKnK6ZILRD+qGzZioFxH/WjJbd6YqedtEG9cthyy3Cx46B164Addih+WW+95ffvvnvv8tVb777b83l32slNW7So+JJRr7/u90+YoAUDosWmK+lPf3LTpk3LP8/LLwPHHlt42Q88AHz5y6XlZ86c4qY7++zw8E9+4k4zYkT+ZUyenHvcxInaRTU2xk9fWwv87nf699166/zrLUISpZVqAASrUQ4rcTyMMc3GmDZjTJuzdFvSJknRQCASHxyCJxngXhCjRTN7otDBVcgZZ7hpV12lv9EgaPX2wDr6aL8UVDGidVCCjMldTLMvCxb/LIfrr49PnzXLTfvqV/3+bbYBhg8vb17SZM2a0ouUF9sQZLSGf7V1dupN44UXatH6XkplUVYRmSkiDSLS4Iy0ZfSTZIuyWg89VPhk3n574Be/CKcF73iPPlq7Ynzta35/b4NDPvPmxadH13nZZaUtd/hwtzz85z+fe/qTT849bv16Dc6VtM025V3e3nu7acGnGCD/HWQxbFHTqLibg6BLLnFvuCpxA5Ymp5yiv+PGFTd9sG20Yl16aenzAPq/YKKmT9fi0+++q7/77adF62fPBv74Rz0WevNk6kkiOGQB1Hr9NQCihZYLjc+vEsEhTrQMflRNjdt0eLCuxZVXxj8+xznuOL9/jz2KmyfqK1/p2XyAGxz23x/42c90mcUcdMOHu08OPX0auf/+ns1XjLg2oYDiXleUYvTo0qaZOhU46ii3nks+K1bk3sczZ+rriei+HDFCK2tGK5TutVfx6wUKt1XVW9Onh4dLzV8htoHFQpUB58/XG5W413pxgvViLr9ca49v2gTce6/e3Xd3AwsX6t+lpUVvEFat0noel12mN5yzZmn9jzvu0LbkPvlE65WMGgXsvLP+PvOMBpGTT9YAN3x4eV7rJvRButnrnwzvgzOAmnzji/4gvddeyXwU6233jW/4RVptF/z49Oqr8R8Cbbl4wC+K+MgjftqKFT3LT7S4ZSnds8+Gh//61+iXrvzdXXeFS3cBfrHJYGks24mES05FO1uSqtzdbbfFp3/3u36/LdkV7KKlX5qb868nWm/Bdm+/7fe//HJ4f4iI/PKXpW1P3LkRtGlTuK2v4cM1PVqqbuedS1uvrduQryv22Al2zz3nz3fDDZp27rn6MRrQ0nyAfvQttKx58/S43Gknd5w9b0eN0joVcaWZMhk/L8HSVf/6r35/MB/Tp/vTHXywVAPSVlpJ84Rm6Ifm5kDa/Hzjc3VOcNh33/g/vj1QkuyC5dht+WrbHXOMVrIJph14oN+/aJH9i4W7I44IL0NE5LXX/LSPP+5ZXqdPL266Z55x06L5XLAgetS53Y47aqmM++7TOgTBxusAPeFWrtQT5oAD3PU991zuPMaVZrFdS4uWM7/gAr+8ebCLlv4Kdhs26Pho/YjTT9dSII8/Ht5eeyEIBgxbme7tt3MXHX3lFb/flrYbNy687OXLtW7Lfvv5+9lWUCy2O/VUkauuCpeYi1qxQusMAFrZTUSLTwaXY4PFgw+G0+MCOyDyla/o71FHaTHv/fbzx02cKPL88/mPnf/4DzfNNoIY58c/1mk6O7VId3C5n34arqw5YkR8kVI7fvVqkWxW+21lu7h85po/WI9IRAPQf/6nP92bb2oR1ypIZXAoZ+cEh1zls6+4orQTqSfdj37k90fvBp95JlzuOprXt97Sv9jixSJ33umnNzb6/Q0NOk3wjnLduuLy9vrr4eHoU0yuLlhEd599tHy1SHia996LHnVud9BBcUendkceqXfGVrSOhkh85S/bffvbWmM8blywtvSUKX76pEkacF56KTz99deH1yuire0GpwlWsgpuh61Idd11fvHIXNsc3T7bAvB22+nvxInh6Vev1gtbV5e/rGhRSUAra+XaT+eeq/PNm6fDm2/u5s9av94PbLZ1XBs0Fi70y9/bio/33afzPP20Xsw//FArqwFa696eHyKaD5unyy8Pr/emm9w787Vrw3VQAC0GnsuGDX5QiO536+GH9UYyuD+DJkzQ48qyNdWjy4su1/rTn/S4sZVRx47Nnd8qGXjBIdjkRLCzweHii8Pl2eO6c84R+e1v809ju2DZ8T/+0e+/8Ub9/frX/Ytn9AJ9553+xeCdd/y/mr2TNMavlb3XXtp0hUi47P6mTXog22YCamvj6ziIhIfz3YkHu0zGbzoiWFY6OE30zsemT5zon+h33hl3dMafWCL6JAXoY76IPp3kyuN557llwG1n95mI7iv7Kua11/z0YL0AWzM5mK9gsLbHUNDFF+tTgb1j/fnP9YnuzTfd7XrlFfc1k4hfQeuUU/SJwFZwsrXtoxcnEb8c/3bbaZ2U114LN28Srb18xRU6n93GIUPi932c9ev1N/q37u7W5mHi2GZDjj9ef20T8MFy+dde6863aVO4How97lau1HVNmqT9pTjwQH2yKRebtyOO0KZC8lm0yK+cmCL9PzgMH66vDK65Ru8COzvdC8S0afq/DoDiKhf94Ad27xXuLrrIf0/5xBN+un1fHbxjtt8Hxozx02zzFMGD3V4YBw/238XbVxgi/qukzTYL/7V/+1v/fyF85zvuBShYq3Tx4uK27/33db8G26uJ7ptgO0Qius3nnecP2wtLFJD77rWrS18d2Iv7G2/kzuPll4vsumv8uCVLwsvdtMlt3mDVKn/64Cseq6UlvMxHHonP8yWX+PkpRlxwOPXU4uYV8V9Tnniin2aDw157+ce87W6+WaexgXbrrYtfV2/YGwT71GkrsG2/fe47dxH375AmI0fmf/LqA/p/cBg92t3q6COoZT/6nnFG/guifaQv9F7+oYf0js7etQZfG9k7n2CbLiLa/k2wobXubg0a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\n", + "image/png": "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\n", "text/plain": [ "
    " ] diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter2_178_0.png b/doc/src/LectureNotes/_build/jupyter_execute/chapter2_178_0.png index bca7d703a1dbef9c896c4e0c9ed341a6ee7494a1..f26cbb55eb003e16a95b05e3319cb98dce04b0f9 100644 GIT binary patch literal 5169 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 literal 5181 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 diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter2_184_1.png b/doc/src/LectureNotes/_build/jupyter_execute/chapter2_184_1.png index 52e1ee090068c51a89d4b3bbd7c26cb72b8ad526..23b842d8464b19e6a04173cb035b85a9ccc0ab06 100644 GIT binary patch literal 9817 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 literal 9823 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 diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter3.ipynb b/doc/src/LectureNotes/_build/jupyter_execute/chapter3.ipynb index 724425d7f..7690e5625 100644 --- a/doc/src/LectureNotes/_build/jupyter_execute/chapter3.ipynb +++ b/doc/src/LectureNotes/_build/jupyter_execute/chapter3.ipynb @@ -440,8 +440,8 @@ "name": "stdout", "output_type": "stream", "text": [ - "[-0.80600218 -0.30092 -0.79536928 0.14039618 0.5768749 0.74732035\n", - " -2.28459617 -0.84483144 -1.24760167 1.04875861]\n" + "[ 0.99499832 -0.89728339 -1.69744895 -1.03875025 -0.07638981 0.18716123\n", + " -0.27804028 0.72149922 1.25862131 -0.7970463 ]\n" ] } ], diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter4.ipynb b/doc/src/LectureNotes/_build/jupyter_execute/chapter4.ipynb index 18ba69f3f..fe58f3b8e 100644 --- a/doc/src/LectureNotes/_build/jupyter_execute/chapter4.ipynb +++ b/doc/src/LectureNotes/_build/jupyter_execute/chapter4.ipynb @@ -1750,13 +1750,13 @@ "output_type": "stream", "text": [ "Training R2\n", - "0.9999853406074647\n", + "0.9999886705644145\n", "Training MSE\n", - "6.359080163429899\n", + "3.90943518299982\n", "Test R2\n", - "0.9999859407754539\n", + "0.9999697792755088\n", "Test MSE\n", - "6.980914000813206\n" + "25.32441051671905\n" ] } ], @@ -2041,7 +2041,7 @@ { "data": { "text/plain": [ - "" + "" ] }, "execution_count": 16, @@ -2353,27 +2353,27 @@ "MSE before scaling: 0.00\n", "R2 score before scaling 0.99\n", "Feature min values before scaling:\n", - " [1.00000000e+00 4.28119384e-04 8.30273573e-04 1.83286207e-07\n", - " 3.55456211e-07 6.89354206e-07 7.84683780e-11 1.52177694e-10\n", - " 2.95125898e-10 5.72352580e-10 3.35938336e-14 6.51502206e-14\n", - " 1.26349118e-13 2.45035234e-13 4.75209222e-13 1.43821714e-17\n", - " 2.78920723e-17 5.40925064e-17 1.04904333e-16 2.03446279e-16\n", - " 3.94553659e-16]\n", + " [1.00000000e+00 1.97624658e-03 6.76071445e-04 3.90555053e-06\n", + " 1.33608388e-06 4.57072598e-07 7.71833086e-09 2.64043119e-09\n", + " 9.03288157e-10 3.09013732e-10 1.52533249e-11 5.21814310e-12\n", + " 1.78512013e-12 6.10687329e-13 2.08915360e-13 3.01443312e-14\n", + " 1.03123374e-14 3.52783754e-15 1.20686874e-15 4.12868265e-16\n", + " 1.41241709e-16]\n", "Feature max values before scaling:\n", - " [1. 0.99959919 0.99554286 0.99919855 0.99514384 0.99110558\n", - " 0.99879806 0.99474497 0.99070834 0.98668808 0.99839773 0.99434627\n", - " 0.99031125 0.98629261 0.98229027 0.99799757 0.99394773 0.98991433\n", - " 0.98589729 0.98189656 0.97791206]\n", + " [1. 0.99729116 0.99990303 0.99458965 0.99719445 0.99980607\n", + " 0.99189546 0.9944932 0.99709775 0.99970911 0.98920857 0.99179928\n", + " 0.99439677 0.99700106 0.99961217 0.98652896 0.98911265 0.9917031\n", + " 0.99430034 0.99690438 0.99951524]\n", "Feature min values after scaling:\n", - " [ 0. -1.69931545 -1.67469653 -1.11879252 -1.10594061 -1.09316288\n", - " -0.88278129 -0.87818569 -0.8737743 -0.8695324 -0.74532693 -0.74499485\n", - " -0.74480651 -0.74474355 -0.7447873 -0.65291273 -0.65458157 -0.65636186\n", - " -0.6582414 -0.6602078 -0.66224856]\n", + " [ 0. -1.72006556 -1.76752166 -1.10773734 -1.11611153 -1.12503152\n", + " -0.87804483 -0.88146268 -0.88496565 -0.8885653 -0.75100539 -0.75305518\n", + " -0.75511928 -0.75719979 -0.75929911 -0.66720819 -0.66863343 -0.67005915\n", + " -0.67148589 -0.67291428 -0.67434497]\n", "Feature max values after scaling:\n", - " [0. 1.73355301 1.72505955 2.27111673 2.24946337 2.22510326\n", - " 2.69980853 2.67945831 2.65749797 2.63400218 3.05843173 3.04339787\n", - " 3.02720478 3.00984683 2.99131512 3.36770789 3.3585133 3.3484316\n", - " 3.33743441 3.32549161 3.31257165]\n", + " [0. 1.74774217 1.73485006 2.2506647 2.23491553 2.21893993\n", + " 2.6752011 2.65930564 2.64314172 2.62671501 3.05237641 3.03669249\n", + " 3.02075875 3.00457804 2.98815333 3.39653406 3.38082542 3.36489022\n", + " 3.34873108 3.33235061 3.31575145]\n", "MSE after scaling: 0.00\n", "R2 score for scaled data: 0.99\n" ] @@ -3623,10 +3623,10 @@ "name": "stdout", "output_type": "stream", "text": [ - "0.10594950732957698\n", - "4.624126522020202\n", - "[[ 0.994928 3.03386068]\n", - " [ 3.03386068 10.13854864]]\n" + "0.12208685625303164\n", + "4.452659449239899\n", + "[[ 1.00910422 3.12769989]\n", + " [ 3.12769989 10.63920917]]\n" ] } ], @@ -3667,10 +3667,10 @@ "name": "stdout", "output_type": "stream", "text": [ - "0.07844342450165018\n", - "1.1438626259785865\n", - "[[1. 0.60716876]\n", - " [0.60716876 1. ]]\n" + "0.08487462066865184\n", + "1.7716882265595972\n", + "[[1. 0.74332853]\n", + " [0.74332853 1. ]]\n" ] } ], @@ -3724,30 +3724,30 @@ "name": "stdout", "output_type": "stream", "text": [ - "[[-0.1066151 0.79747251]\n", - " [ 0.75209514 1.96762409]\n", - " [-0.41638994 -2.34035396]\n", - " [-0.2780316 -1.49418072]\n", - " [ 0.86865915 2.72245363]\n", - " [ 0.20418073 0.86260647]\n", - " [-0.79048758 -0.42464144]\n", - " [-0.01768994 -0.1467412 ]\n", - " [-0.26355349 -1.81771904]\n", - " [ 0.04783264 -0.12652035]]\n", + "[[-0.63821798 -2.03548189]\n", + " [ 0.98355854 2.40965456]\n", + " [ 0.48870683 2.68995497]\n", + " [ 0.44655566 1.28908336]\n", + " [ 0.3871261 -0.67155367]\n", + " [-0.32256574 -0.55849157]\n", + " [ 1.3507663 2.75066843]\n", + " [-1.44489727 -5.37462032]\n", + " [-0.42087991 1.26840089]\n", + " [-0.83015254 -1.76761477]]\n", " 0 1\n", - "0 -0.106615 0.797473\n", - "1 0.752095 1.967624\n", - "2 -0.416390 -2.340354\n", - "3 -0.278032 -1.494181\n", - "4 0.868659 2.722454\n", - "5 0.204181 0.862606\n", - "6 -0.790488 -0.424641\n", - "7 -0.017690 -0.146741\n", - "8 -0.263553 -1.817719\n", - "9 0.047833 -0.126520\n", + "0 -0.638218 -2.035482\n", + "1 0.983559 2.409655\n", + "2 0.488707 2.689955\n", + "3 0.446556 1.289083\n", + "4 0.387126 -0.671554\n", + "5 -0.322566 -0.558492\n", + "6 1.350766 2.750668\n", + "7 -1.444897 -5.374620\n", + "8 -0.420880 1.268401\n", + "9 -0.830153 -1.767615\n", " 0 1\n", - "0 1.000000 0.824095\n", - "1 0.824095 1.000000\n" + "0 1.000000 0.877156\n", + "1 0.877156 1.000000\n" ] } ], @@ -3789,37 +3789,37 @@ "text": [ " 0 1 2 3 4 5 6 7 \\\n", "0 0.0 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 \n", - "1 0.0 0.090154 0.084830 0.094410 0.086610 0.079643 0.088034 0.080631 \n", - "2 0.0 0.084830 0.081616 0.091708 0.085377 0.079558 0.087469 0.081068 \n", - "3 0.0 0.094410 0.091708 0.104704 0.097816 0.091403 0.101195 0.093913 \n", - "4 0.0 0.086610 0.085377 0.097816 0.092341 0.087099 0.095895 0.089763 \n", - "5 0.0 0.079643 0.079558 0.091403 0.087099 0.082837 0.090734 0.085584 \n", - "6 0.0 0.088034 0.087469 0.101195 0.095895 0.090734 0.100269 0.094057 \n", - "7 0.0 0.080631 0.081068 0.093913 0.089763 0.085584 0.094057 0.088862 \n", - "8 0.0 0.074145 0.075363 0.087388 0.084186 0.080823 0.088367 0.084031 \n", - "9 0.0 0.068449 0.070272 0.081540 0.079119 0.076438 0.083169 0.079557 \n", - "10 0.0 0.080692 0.081580 0.095076 0.091141 0.087107 0.095945 0.090806 \n", - "11 0.0 0.074184 0.075759 0.088306 0.085279 0.082038 0.089878 0.085590 \n", - "12 0.0 0.068486 0.070593 0.082283 0.080006 0.077425 0.084399 0.080829 \n", - "13 0.0 0.063479 0.065996 0.076913 0.075254 0.073225 0.079446 0.076483 \n", - "14 0.0 0.059064 0.061893 0.072112 0.070966 0.069398 0.074962 0.072512 \n", + "1 0.0 0.085618 0.079643 0.085857 0.084047 0.081888 0.076531 0.075718 \n", + "2 0.0 0.079643 0.075359 0.078265 0.077130 0.075774 0.069143 0.068658 \n", + "3 0.0 0.085857 0.078265 0.090778 0.088194 0.085138 0.083648 0.082461 \n", + "4 0.0 0.084047 0.077130 0.088194 0.085938 0.083258 0.080985 0.079981 \n", + "5 0.0 0.081888 0.075774 0.085138 0.083258 0.081011 0.077856 0.077054 \n", + "6 0.0 0.076531 0.069143 0.083648 0.080985 0.077856 0.078889 0.077645 \n", + "7 0.0 0.075718 0.068658 0.082461 0.079981 0.077054 0.077645 0.076512 \n", + "8 0.0 0.074845 0.068154 0.081161 0.078881 0.076175 0.076275 0.075261 \n", + "9 0.0 0.073877 0.067608 0.079704 0.077645 0.075189 0.074736 0.073852 \n", + "10 0.0 0.067084 0.060409 0.075015 0.072536 0.069633 0.071991 0.070821 \n", + "11 0.0 0.066572 0.060088 0.074312 0.071948 0.069168 0.071268 0.070173 \n", + "12 0.0 0.066065 0.059784 0.073591 0.071348 0.068699 0.070516 0.069500 \n", + "13 0.0 0.065552 0.059492 0.072838 0.070724 0.068215 0.069723 0.068789 \n", + "14 0.0 0.065022 0.059205 0.072037 0.070061 0.067706 0.068871 0.068023 \n", "\n", " 8 9 10 11 12 13 14 \n", "0 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 \n", - "1 0.074145 0.068449 0.080692 0.074184 0.068486 0.063479 0.059064 \n", - "2 0.075363 0.070272 0.081580 0.075759 0.070593 0.065996 0.061893 \n", - "3 0.087388 0.081540 0.095076 0.088306 0.082283 0.076913 0.072112 \n", - "4 0.084186 0.079119 0.091141 0.085279 0.080006 0.075254 0.070966 \n", - "5 0.080823 0.076438 0.087107 0.082038 0.077425 0.073225 0.069398 \n", - "6 0.088367 0.083169 0.095945 0.089878 0.084399 0.079446 0.074962 \n", - "7 0.084031 0.079557 0.090806 0.085590 0.080829 0.076483 0.072512 \n", - "8 0.079929 0.076076 0.085994 0.081509 0.077368 0.073550 0.070030 \n", - "9 0.076076 0.072757 0.081515 0.077656 0.074052 0.070694 0.067570 \n", - "10 0.085994 0.081515 0.093107 0.087851 0.083035 0.078625 0.074586 \n", - "11 0.081509 0.077656 0.087851 0.083337 0.079156 0.075290 0.071718 \n", - "12 0.077368 0.074052 0.083035 0.079156 0.075521 0.072127 0.068962 \n", - "13 0.073550 0.070694 0.078625 0.075290 0.072127 0.069142 0.066334 \n", - "14 0.070030 0.067570 0.074586 0.071718 0.068962 0.066334 0.063837 \n" + "1 0.074845 0.073877 0.067084 0.066572 0.066065 0.065552 0.065022 \n", + "2 0.068154 0.067608 0.060409 0.060088 0.059784 0.059492 0.059205 \n", + "3 0.081161 0.079704 0.075015 0.074312 0.073591 0.072838 0.072037 \n", + "4 0.078881 0.077645 0.072536 0.071948 0.071348 0.070724 0.070061 \n", + "5 0.076175 0.075189 0.069633 0.069168 0.068699 0.068215 0.067706 \n", + "6 0.076275 0.074736 0.071991 0.071268 0.070516 0.069723 0.068871 \n", + "7 0.075261 0.073852 0.070821 0.070173 0.069500 0.068789 0.068023 \n", + "8 0.074139 0.072869 0.069531 0.068962 0.068371 0.067746 0.067072 \n", + "9 0.072869 0.071752 0.068081 0.067595 0.067092 0.066559 0.065985 \n", + "10 0.069531 0.068081 0.066617 0.065944 0.065240 0.064493 0.063686 \n", + "11 0.068962 0.067595 0.065944 0.065324 0.064676 0.063985 0.063237 \n", + "12 0.068371 0.067092 0.065240 0.064676 0.064083 0.063452 0.062765 \n", + "13 0.067746 0.066559 0.064493 0.063985 0.063452 0.062881 0.062258 \n", + "14 0.067072 0.065985 0.063686 0.063237 0.062765 0.062258 0.061702 \n" ] } ], @@ -4405,10 +4405,10 @@ "name": "stdout", "output_type": "stream", "text": [ - "Runtime: 0.425629 sec\n", + "Runtime: 0.430516 sec\n", "Jackknife Statistics :\n", "original bias std. error\n", - " 99.99 99.98 0.151321\n" + " 100.186 100.176 0.153008\n" ] } ], @@ -4559,10 +4559,10 @@ "name": "stdout", "output_type": "stream", "text": [ - "Runtime: 2.1542 sec\n", + "Runtime: 2.20285 sec\n", "Bootstrap Statistics :\n", "original bias std. error\n", - " 99.8081 15.0184 99.8106 0.150604\n" + " 100.167 14.919 100.169 0.150847\n" ] }, { @@ -4584,7 +4584,7 @@ }, { "data": { - "image/png": "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BgeH0t8/UO+xxuXnZx+P1hfMH/faeXPn5P/c/A/jXv+Zbasm9PtPdJ6Jrp9Js5S2fibNUtr6mTTL+b5+Js1S2vqZNMv5vn4iz+Wf2bZqws/7z5zjdqt1KzZUq9VqLX/DT33qU/nxj3+c6667Lklyzz335NChQ/nIRz5Sy28DAABTVvNLq42MjKSh4f8Xe7VafdbXAAAwU9Q8hhcuXJje3t7Rr3t7e9Pa2lrrbwMAAFNW8xh+zWtek29961t5+umnc+rUqfzDP/xD2traav1tAABgymr+BroXvehFue6667Jhw4acOXMmV1xxRV7+8pfX+tsAAMCU1fwNdAAAcL6o+WkSAABwvhDDAAAUSwwDAFAsMQwAQLGKieFPf/rTWb16ddrb23PHHXckSe69995cfvnlaW9vz80335yhoaGz7nfw4MFcccUV6ejoyFVXXZWjR4+e69GLMNn9+alHH300v/3bv32uxi3KZPfm2LFjefe73503vOENWb9+fZ588slzPfqsN9m9efLJJ/PWt741HR0dedvb3uZxrUb6+/uzbt260b/rBw4cSHt7e1atWpWdO3eOrjt8+HA6OzuzevXqbN269Rfu0cmTJ/Pud787r3vd6/LWt771WdfvZ3JquT/f//73R3+G3vzmN+fw4cPn7Dhmo1ruzU/9z//8T1796leP77mnWoB/+Zd/qa5bt67a19dXHRoaql599dXVT33qU9VLL7202tPTU61Wq9Ubb7yxeuedd55138suu6x6+PDharVard5zzz3Va6655pzOXoKp7E+1Wq3++Mc/rq5fv776m7/5m+dy7CJMZW+uuuqq6he/+MVqtVqtfvGLX6xee+2153T22W4qe/PBD36w+oUvfKFarVard911V3XTpk3ndPbZ6N///d+r69atqy5btqz6xBNPVE+dOlVduXJl9b/+67+qZ86cqb7jHe+ofuMb36hWq9Xq2rVrq//2b/9WrVar1Q996EOje/GzbrrppuqnPvWparVard53331+fqao1vuzfv366te//vVqtVqtHjhwoNre3n7OjmW2qfXeVKvV6vDwcPUd73hHdfny5dUnnnhizBmKeGX40Ucfze///u9nwYIFmTNnTi699NLcdtttWb58+ein41122WX56le/+qz7nT59Otdee22WLl2aJPmt3/qtPPXUU+d8/tlusvvzU9u3b89VV111LkcuxmT35umnn873vve9rF+/Pknyxje+MR/4wAfO+fyz2VR+bkZGRtLf358kOXXqVJqbm8/p7LPRrl27cuONN47+2R86dChLlizJ4sWL09jYmPb29nR3d+fo0aMZGBjI8uXLkySdnZ3p7u4+6/f7xje+kfb29iTJunXr8k//9E85c+bMuTugWabW+/OmN70pl156aRJtMFW13psk+bu/+7u85jWvyQte8IJxzVBEDC9btizf/OY386Mf/SiDg4N58MEHs3z58jz88MN56qmnMjw8nO7u7hw/fvxZ95s3b146OjqS/OTJ45gXHmEAAAT5SURBVLbbbstrX/va6TiEWW2y+5MkX/va1zIwMJA1a9ZMw+Sz32T35oknnsiv/dqvZfv27XnjG9+Y97///Zk7d+40HcXsNJWfm2uvvTaf+9zncumll+bOO+/Mu971rmk4gtnlox/9aF71qleNfn3s2LFUKpXRr1tbW9PT03PW7ZVKJT09PWf9fj+7rrGxMQsWLMjTTz9dxyOY3Wq9P52dnZkzZ06S5NZbb9UGU1DrvXnkkUfy7W9/O3/yJ38y7hlq/gl0M9GKFSvS2dmZt73tbXn+85+fFStW5OGHH86mTZvynve8J83NzVmzZk2++93v/sL7nz59Otdff32GhoZy9dVXn+PpZ7/J7k9vb2/uuOOOfO5zn5uewQsw2b0ZGhrKo48+mo0bN+ZDH/pQ7rnnnlx//fW5++67p+lIZp+pPK79xV/8RT784Q/nta99bR544IG8733vy549e9LQ0DANRzI7jYyMPOvPs1qtpqGh4TlvH0u1Ws3znlfE61fnRC32p1qt5uMf/3gefvjh3HXXXXWfuRRT2ZtTp07lpptuyic+8YkJ/bwU8ZPV39+fVatWZe/evbn77rszb968vOhFL8rLX/7yfOUrX8mXvvSlvOhFL8rixYvPuu8zzzyTd77znRkaGsodd9zh1a06mOz+fOMb38iPfvSj0TcxJElHR8fo//5l6ia7N5VKJRdccEEuu+yyJD/537yHDh2ajkOYtSa7N08//XR+8IMfjL6StXr16vT29uaHP/zhdBzGrLVw4cJnvemtt7c3ra2tZ91+/Pjx0f89/LNaW1tHX9UfGhrKM888k+c///n1H7wQU92foaGhfPCDH8x3v/vd3HXXXWlpaTknc5dgKnvz0EMP5cSJE3nPe96Tjo6O0Tdy/+AHP/il37OIGH7yySfzp3/6pxkaGkpfX192796djo6OvP3tb09/f39Onz6dz3/+87n88svPuu/mzZuzZMmS/PVf/3XmzZs3DdPPfpPdnze96U356le/mq6urnR1dSVJurq6smDBguk4jFlpsnvz67/+61m4cGH279+fJPn617+eZcuWTcchzFqT3ZsXvOAFaWpqykMPPZTkJ1fMueCCC/LCF75wOg5j1rrkkkvy2GOP5ciRIxkeHs6+ffvS1taWRYsWpampKQcPHkzyk8estra2s+6/cuXKfOUrX0mS3H///XnVq17lxZgamur+fOxjH0t/f3/uvPNOIVxjU9mbSy+9NA8++OBoF7S2tubTn/50XvKSl/zS71nEaRJLly7NqlWr8vrXvz7Dw8N5+9vfnle+8pV573vfmze/+c0ZGhrKunXrRt+ssHXr1vzhH/5hLr744nzta1/LS1/60vzxH/9xkp/81/rf/u3fTufhzDqT3Z8/+qM/mubJZ7+p7M0nP/nJ3Hjjjfmrv/qrLFiwINu3b5/mo5ldprI3t912Wz7ykY9kYGAgF1xwQT75yU9O89HMPk1NTdm+fXs2btyYwcHBrFy5cvS9DTt27Mi2bdvS39+fZcuWZcOGDUmST3ziE2ltbc1b3vKWXHvttbn++uuzdu3atLS0ZMeOHdN5OLPOVPZn9erV+cIXvpAXv/jFedOb3jT6e/70RRmmZqo/O5PRUK1WqzU7AgAAOI8UcZoEAAD8ImIYAIBiiWEAAIolhgEAKJYYBgCgWGIYAIBiiWEAAIolhgEAKNb/BWogoLx3OxXgAAAAAElFTkSuQmCC\n", + "image/png": "iVBORw0KGgoAAAANSUhEUgAAArcAAAHjCAYAAAA5ajcLAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4yLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy+WH4yJAAAgAElEQVR4nO3dcXTVd2H//1cgEFibHmt3rzhknOPmsTucY/HU46SuYZ0ewEKkS/VY7UTnT61Ose3Bbh0weqrthpMejtVTj55Nd6z2OKytAcZSt1WZDj2ecmZZFc/Z0Za1nC4EqiOpJJDk8/tjXb6l1JJAbkLeeTz+aj55X/L+9N187rOX9/3cpqqqqgAAQAFmTPYEAABgvIhbAACKIW4BACiGuAUAoBjiFgCAYohbAACKIW4BAChG82RP4Ll+/vOnMzx87t5696KLzs+RI32TPQ3GyLpNTdZtarJuU5N1m5qm47rNmNGUCy8871d+/5yL2+Hh6pyO2yTn/Px4ftZtarJuU5N1m5qs29Rk3U5mWwIAAMUQtwAAFEPcAgBQDHELAEAxxC0AAMUQtwAAFEPcAgBQDHELAEAxRhW3Dz74YDo6OvKmN70pt912W5Jkz549aW9vz7Jly7J169aRsfv3709HR0eWL1+eDRs2ZHBwsDEzBwCA5zht3D7++OO55ZZbctddd2X79u358Y9/nN27d2f9+vW56667smvXrjzyyCPZvXt3kuSmm27Kpk2b8sADD6Sqqmzbtq3hJwEAAMko4vaf/umfcuWVV2bevHmZNWtWtm7dmrlz52bhwoVZsGBBmpub097enq6urhw8eDD9/f1ZvHhxkqSjoyNdXV0NPwkAAEiS5tMNOHDgQGbNmpUPfOADefLJJ/P7v//7ecUrXpFarTYypl6vp7u7O4cOHTrpeK1WS3d3d2NmDgAAz3HauB0aGspDDz2Uu+++O7/2a7+WD37wg5kzZ06amppGxlRVlaampgwPDz/v8bG46KLzxzR+MtRqrZM9Bc6AdZuarNvUZN2mJus2NVm3k502bn/91389S5YsyYtf/OIkyRvf+MZ0dXVl5syZI2N6enpSr9czb9689PT0jBw/fPhw6vX6mCZ05EhfhoerMT1mItVqrenp6Z3saTBG1m1qsm5Tk3Wbmqzb1DQd123GjKYXfDH0tHtur7jiinz3u9/N0aNHMzQ0lO985ztZsWJFHn300Rw4cCBDQ0PZuXNn2traMn/+/LS0tGTv3r1Jks7OzrS1tY3f2QAAwAs47Su3l1xySd773vfmHe94R06cOJHXv/71efvb356Xv/zlWbt2bQYGBrJ06dKsWLEiSbJly5Zs3LgxfX19WbRoUdasWdPwkwAAgCRpqqrqnNoDYFsCjWDdpibrNjVZt6nJuk1N03HdznpbAgAATBWn3ZYAQLlaL5ibOS2jfyroHxhM79FjDZwRwNkRtwDT2JyW5rSv6xz1+B13rM70+gtQYKqxLQEAgGJ45RaAUTt+YmhUN4z/vzG2MQATTdwCMGqzZ820jQE4p9mWAABAMcQtAADFELcAABRD3AIAUAxxCwBAMcQtAADFELcAABRD3AIAUAxxCwBAMcQtAADFELcAABRD3AIAUAxxCwBAMcQtAADFELcAABRD3AIAUAxxCwBAMcQtAADFaJ7sCQAwflovmJs5LS7twPTlCghQkDktzWlf1znq8TvuWN3A2QBMPNsSAAAohrgFAKAYtiUAnOPsowUYPVdLgAl2JrE62n209tAC0524BZhg3vQF0Dj23AIAUAxxCwBAMcQtAADFELcAABRD3AIAUAxxCwBAMcQtAADFELcAABRD3AIAUAxxCwBAMcQtAADFELcAABRD3AIAUAxxCwBAMcQtAADFELcAABRD3AIAUAxxCwBAMZonewIAlOv4iaHUaq2jHt8/MJjeo8caOCOgdOIWgIaZPWtm2td1jnr8jjtWp7eB8wHKZ1sCAADFELcAABRD3AIAUAxxCwBAMcQtAADFELcAABRD3AIAUAxxCwBAMcQtAADFELcAABRD3AIAUAxxCwBAMcQtAADFaB7NoHe+85156qmn0tz8v8M/9rGP5emnn85f/dVfZWBgIG9605ty4403Jkn279+fDRs25Omnn85rXvOa3HrrrSOPAwCARjptdVZVlcceeyzf+ta3RiK1v78/K1asyN13352XvvSlue6667J79+4sXbo0N910U2677bYsXrw469evz7Zt2/KOd7yj4ScCAACn3Zbws5/9LEnynve8J29+85vz5S9/Ofv27cvChQuzYMGCNDc3p729PV1dXTl48GD6+/uzePHiJElHR0e6uroaewYAAPCM075ye/To0SxZsiR/8Rd/kRMnTmTNmjV573vf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5Gtf+1r27duXj3/84+P5YwAA4BTjfiuw4eHhNDX9v6KuquqkrwEAoFHGPW7nzZuXnp6eka97enpSr9fH+8cAAMApxj1uL7vssnzve9/LU089lWPHjuWb3/xm2traxvvHAADAKcb9DWUveclLcuONN2bNmjU5ceJE3vKWt+RVr3rVeP8YAAA4xbi/oQwAACbLuG9LAACAySJuAQAohrgFAKAY4hYAgGKI22f5/Oc/n+XLl6e9vT2f/exnkyT33XdfrrzyyrS3t+e2227L4ODgKY87dOhQ3v/+9+eqq67KNddckyeeeGKipz6tnem6PfHEE7n22muzevXqvPOd78zBgwcneurTUl9fX1atWjXye7Jnz560t7dn2bJl2bp168i4/fv3p6OjI8uXL8+GDRuedw2PHj2a97///XnTm96Ua6+99qR7bDO+xnPdfvrTn4787r3tbW/L/v37J+w8ppvxXLf/89///d957Wtf67mugcZz3fr6+rJu3bpcddVVueqqq/KjH/1ows5j0lRUVVVV//Zv/1atWrWq6u3trQYHB6vrrruu+tznPlddfvnlVXd3d1VVVXXLLbdUX/jCF0557Lve9a7qnnvuqaqqqu65557q+uuvn9C5T2dns24f/ehHq6985StVVVXVl770pWrdunUTOvfp6Ic//GG1atWqatGiRdXjjz9eHTt2rFq6dGn1X//1X9WJEyeq97znPdW3v/3tqqqqauXKldW///u/V1VVVX/+538+slbPduutt1af+9znqqqqqvvvv9/vXoOM97pdc8011be+9a2qqqpqz549VXt7+4Sdy3Qy3utWVVU1NDRUvec976kWL15cPf744xN2LtPJeK/b+vXrq09+8pNVVVXV7t27q7e85S0TdzKTxCu3z/jxj3+c3/u938v555+fmTNn5vLLL89nPvOZLF68eOQT1q644or88z//80mPe+qpp/KTn/wk11xzTZLk6quvzg033DDh85+uznTdkv/9qOi+vr4kybFjxzJnzpwJnft0tG3bttxyyy0ja7Nv374sXLgwCxYsSHNzc9rb29PV1ZWDBw+mv78/ixcvTpJ0dHSkq6vrlD/v29/+dtrb25Mkq1atyr/+67/mxIkTE3dC08R4r9tb3/rWXH755UmSV77ylXnyyScn7mSmkfFetyT5m7/5m1x22WW58MILJ+w8ppvxXLeqqvLNb34z73//+5MkbW1t+cu//MuJPaFJIG6fsWjRonz3u9/NL37xiwwMDOTBBx/M4sWL8/DDD+fJJ5/M0NBQurq6cvjw4ZMe9/jjj+c3fuM3snnz5lx99dX5yEc+klmzZk3SWUw/Z7puSXL99dfn7/7u73L55ZfnC1/4Qt73vvdNwhlML7fffnte85rXjHx96NCh1Gq1ka/r9Xq6u7tPOV6r1dLd3X3Kn/fscc3NzTn//PPz1FNPNfAMpqfxXreOjo7MnDkzSXLnnXfmjW98YwNnP32N97o98sgj+f73v58//uM/buzEp7nxXAMcPEoAAAQUSURBVLcjR45k9uzZueeee/K2t70ta9asydDQUONPYpKJ22csWbIkHR0deec735n3vve9ufTSSzN37tysW7cuH/zgB3Pttdfmla985SnhOjg4mB//+Md53etel69//et5wxvekJtvvnmSzmL6OdN1S5I/+7M/y8c+9rF85zvfya233poPf/jDqXymyYQaHh5OU1PTyNdVVaWpqelXHj+dqqoyY4bLWqONx7pVVZVPfOITefjhh7N+/fqGz5mzW7djx47l1ltvzW233eZ3bIKdzboNDQ3l8OHDaW1tzd///d/nuuuuy4c+9KEJm/tk8V/oM/r6+rJs2bLs2LEjd999d2bPnp2XvOQledWrXpVvfOMb+epXv5qXvOQlWbBgwUmPq9VqOe+883LFFVck+d+/Gt23b99knMK0dKbr9tRTT+VnP/vZyCtGy5cvT09PT37+859PxmlMW/PmzTvpTWA9PT2p1+unHD98+PDIX9E9W71eH3lVfnBwME8//XRe9KIXNX7i09zZrtvg4GA++tGP5j/+4z/ypS99Ka2trRMy7+nubNbtoYceypEjR/LBD34wq1evHnkj9c9+9rMJm/90dTbrduGFF6a5uTmrVq1Kkrz+9a/PL3/5yxw5cmRiJj9JxO0znnjiifzJn/xJBgcH09vbm3vvvTerV6/Ou9/97vT19eX48eP58pe/nCuvvPKkx/3mb/5m5s2bl927dydJvvWtb2XRokWTcQrT0pmu24UXXpiWlpY89NBDSZK9e/fmvPPOy4tf/OLJOI1p65JLLsmjjz6aAwcOZGhoKDt37kxbW1vmz5+flpaW7N27N0nS2dmZtra2Ux6/dOnSfOMb30iS7Nq1K695zWtsC5oAZ7tun/jEJ9LX15cvfOELwnYCnc26XX755XnwwQfT2dmZzs7O1Ov1fP7zn8/LX/7yyTiVaeVs1m327Nm57LLL8g//8A9Jkh/+8IeZO3du8Xummyd7AueKiy++OMuWLcub3/zmDA0N5d3vfncuvfTSfOhDH8rb3va2DA4OZtWqVSNvXtmwYUP+4A/+IG94wxvy6U9/Orfccks++clP5vzzz8/mzZsn+Wymj7NZt8985jP5+Mc/nv7+/px33nn59Kc/PclnM/20tLRk8+bNWbt2bQYGBrJ06dKsWLEiSbJly5Zs3LgxfX19WbRoUdasWZMk+dSnPpV6vZ63v/3tuf7663PzzTdn5cqVaW1tzZYtWybzdKaNs1m35cuX5ytf+Upe9rKX5a1vfevIn9nZ2Tkp5zKdnO3vG5PjbNft9ttvz6ZNm3LPPfekubk5W7duLX5rSVNlkyEAAIUoO90BAJhWxC0AAMUQtwAAFEPcAgBQDHELAEAxxC0AAMUQtwAAFEPcAgBQjP8fZtvHcPNWAbIAAAAASUVORK5CYII=\n", "text/plain": [ "
    " ] diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter4_278_2.png b/doc/src/LectureNotes/_build/jupyter_execute/chapter4_278_2.png index 3fcad478b764ded6415bf07268f0d75a1a664c94..5a4fe5abed9d9b87a4c659bde42999d30e29cdab 100644 GIT binary patch literal 9410 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 literal 9639 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 KBSqhwx%U569Ckba diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter7.ipynb b/doc/src/LectureNotes/_build/jupyter_execute/chapter7.ipynb new file mode 100644 index 000000000..b84053770 --- /dev/null +++ b/doc/src/LectureNotes/_build/jupyter_execute/chapter7.ipynb @@ -0,0 +1,2052 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Support Vector Machines, overarching aims\n", + "\n", + "A Support Vector Machine (SVM) is a very powerful and versatile\n", + "Machine Learning method, capable of performing linear or nonlinear\n", + "classification, regression, and even outlier detection. It is one of\n", + "the most popular models in Machine Learning, and anyone interested in\n", + "Machine Learning should have it in their toolbox. SVMs are\n", + "particularly well suited for classification of complex but small-sized or\n", + "medium-sized datasets. \n", + "\n", + "The case with two well-separated classes only can be understood in an\n", + "intuitive way in terms of lines in a two-dimensional space separating\n", + "the two classes (see figure below).\n", + "\n", + "The basic mathematics behind the SVM is however less familiar to most of us. \n", + "It relies on the definition of hyperplanes and the\n", + "definition of a **margin** which separates classes (in case of\n", + "classification problems) of variables. It is also used for regression\n", + "problems.\n", + "\n", + "With SVMs we distinguish between hard margin and soft margins. The\n", + "latter introduces a so-called softening parameter to be discussed\n", + "below. We distinguish also between linear and non-linear\n", + "approaches. The latter are the most frequent ones since it is rather\n", + "unlikely that we can separate classes easily by say straight lines.\n", + "\n", + "\n", + "## Hyperplanes and all that\n", + "\n", + "The theory behind support vector machines (SVM hereafter) is based on\n", + "the mathematical description of so-called hyperplanes. Let us start\n", + "with a two-dimensional case. This will also allow us to introduce our\n", + "first SVM examples. These will be tailored to the case of two specific\n", + "classes, as displayed in the figure here based on the usage of the petal data.\n", + "\n", + "We assume here that our data set can be well separated into two\n", + "domains, where a straight line does the job in the separating the two\n", + "classes. Here the two classes are represented by either squares or\n", + "circles." + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "LinearSVC: [0.28475098] [[1.05364854 1.09903804]]\n", + "SVC: [0.31896852] [[1.1203284 1.02625193]]\n", + "SGDClassifier(alpha=0.00200): [0.117] [[0.77714169 0.72981762]]\n" + ] + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
    " + ] + }, + "metadata": { + "filenames": { + "image/png": "/Users/hjensen/Teaching/FYS-STK4150/doc/src/LectureNotes/_build/jupyter_execute/chapter7_1_1.png" + }, + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "%matplotlib inline\n", + "\n", + "from sklearn import datasets\n", + "from sklearn.svm import SVC, LinearSVC\n", + "from sklearn.linear_model import SGDClassifier\n", + "from sklearn.preprocessing import StandardScaler\n", + "import matplotlib\n", + "import matplotlib.pyplot as plt\n", + "plt.rcParams['axes.labelsize'] = 14\n", + "plt.rcParams['xtick.labelsize'] = 12\n", + "plt.rcParams['ytick.labelsize'] = 12\n", + "\n", + "\n", + "iris = datasets.load_iris()\n", + "X = iris[\"data\"][:, (2, 3)] # petal length, petal width\n", + "y = iris[\"target\"]\n", + "\n", + "setosa_or_versicolor = (y == 0) | (y == 1)\n", + "X = X[setosa_or_versicolor]\n", + "y = y[setosa_or_versicolor]\n", + "\n", + "\n", + "\n", + "C = 5\n", + "alpha = 1 / (C * len(X))\n", + "\n", + "lin_clf = LinearSVC(loss=\"hinge\", C=C, random_state=42)\n", + "svm_clf = SVC(kernel=\"linear\", C=C)\n", + "sgd_clf = SGDClassifier(loss=\"hinge\", learning_rate=\"constant\", eta0=0.001, alpha=alpha,\n", + " max_iter=100000, random_state=42)\n", + "\n", + "scaler = StandardScaler()\n", + "X_scaled = scaler.fit_transform(X)\n", + "\n", + "lin_clf.fit(X_scaled, y)\n", + "svm_clf.fit(X_scaled, y)\n", + "sgd_clf.fit(X_scaled, y)\n", + "\n", + "print(\"LinearSVC: \", lin_clf.intercept_, lin_clf.coef_)\n", + "print(\"SVC: \", svm_clf.intercept_, svm_clf.coef_)\n", + "print(\"SGDClassifier(alpha={:.5f}):\".format(sgd_clf.alpha), sgd_clf.intercept_, sgd_clf.coef_)\n", + "\n", + "# Compute the slope and bias of each decision boundary\n", + "w1 = -lin_clf.coef_[0, 0]/lin_clf.coef_[0, 1]\n", + "b1 = -lin_clf.intercept_[0]/lin_clf.coef_[0, 1]\n", + "w2 = -svm_clf.coef_[0, 0]/svm_clf.coef_[0, 1]\n", + "b2 = -svm_clf.intercept_[0]/svm_clf.coef_[0, 1]\n", + "w3 = -sgd_clf.coef_[0, 0]/sgd_clf.coef_[0, 1]\n", + "b3 = -sgd_clf.intercept_[0]/sgd_clf.coef_[0, 1]\n", + "\n", + "# Transform the decision boundary lines back to the original scale\n", + "line1 = scaler.inverse_transform([[-10, -10 * w1 + b1], [10, 10 * w1 + b1]])\n", + "line2 = scaler.inverse_transform([[-10, -10 * w2 + b2], [10, 10 * w2 + b2]])\n", + "line3 = scaler.inverse_transform([[-10, -10 * w3 + b3], [10, 10 * w3 + b3]])\n", + "\n", + "# Plot all three decision boundaries\n", + "plt.figure(figsize=(11, 4))\n", + "plt.plot(line1[:, 0], line1[:, 1], \"k:\", label=\"LinearSVC\")\n", + "plt.plot(line2[:, 0], line2[:, 1], \"b--\", linewidth=2, label=\"SVC\")\n", + "plt.plot(line3[:, 0], line3[:, 1], \"r-\", label=\"SGDClassifier\")\n", + "plt.plot(X[:, 0][y==1], X[:, 1][y==1], \"bs\") # label=\"Iris-Versicolor\"\n", + "plt.plot(X[:, 0][y==0], X[:, 1][y==0], \"yo\") # label=\"Iris-Setosa\"\n", + "plt.xlabel(\"Petal length\", fontsize=14)\n", + "plt.ylabel(\"Petal width\", fontsize=14)\n", + "plt.legend(loc=\"upper center\", fontsize=14)\n", + "plt.axis([0, 5.5, 0, 2])\n", + "\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## What is a hyperplane?\n", + "\n", + "The aim of the SVM algorithm is to find a hyperplane in a\n", + "$p$-dimensional space, where $p$ is the number of features that\n", + "distinctly classifies the data points.\n", + "\n", + "In a $p$-dimensional space, a hyperplane is what we call an affine subspace of dimension of $p-1$.\n", + "As an example, in two dimension, a hyperplane is simply as straight line while in three dimensions it is \n", + "a two-dimensional subspace, or stated simply, a plane. \n", + "\n", + "In two dimensions, with the variables $x_1$ and $x_2$, the hyperplane is defined as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b+w_1x_1+w_2x_2=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $b$ is the intercept and $w_1$ and $w_2$ define the elements of a vector orthogonal to the line \n", + "$b+w_1x_1+w_2x_2=0$. \n", + "In two dimensions we define the vectors $\\boldsymbol{x} =[x1,x2]$ and $\\boldsymbol{w}=[w1,w2]$. \n", + "We can then rewrite the above equation as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{x}^T\\boldsymbol{w}+b=0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## A $p$-dimensional space of features\n", + "\n", + "We limit ourselves to two classes of outputs $y_i$ and assign these classes the values $y_i = \\pm 1$. \n", + "In a $p$-dimensional space of say $p$ features we have a hyperplane defines as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b+wx_1+w_2x_2+\\dots +w_px_p=0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If we define a \n", + "matrix $\\boldsymbol{X}=\\left[\\boldsymbol{x}_1,\\boldsymbol{x}_2,\\dots, \\boldsymbol{x}_p\\right]$\n", + "of dimension $n\\times p$, where $n$ represents the observations for each feature and each vector $x_i$ is a column vector of the matrix $\\boldsymbol{X}$," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{x}_i = \\begin{bmatrix} x_{i1} \\\\ x_{i2} \\\\ \\dots \\\\ \\dots \\\\ x_{ip} \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If the above condition is not met for a given vector $\\boldsymbol{x}_i$ we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b+w_1x_{i1}+w_2x_{i2}+\\dots +w_px_{ip} >0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "if our output $y_i=1$.\n", + "In this case we say that $\\boldsymbol{x}_i$ lies on one of the sides of the hyperplane and if" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b+w_1x_{i1}+w_2x_{i2}+\\dots +w_px_{ip} < 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "for the class of observations $y_i=-1$, \n", + "then $\\boldsymbol{x}_i$ lies on the other side. \n", + "\n", + "Equivalently, for the two classes of observations we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i\\left(b+w_1x_{i1}+w_2x_{i2}+\\dots +w_px_{ip}\\right) > 0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "When we try to separate hyperplanes, if it exists, we can use it to construct a natural classifier: a test observation is assigned a given class depending on which side of the hyperplane it is located.\n", + "\n", + "\n", + "## The two-dimensional case\n", + "\n", + "Let us try to develop our intuition about SVMs by limiting ourselves to a two-dimensional\n", + "plane. To separate the two classes of data points, there are many\n", + "possible lines (hyperplanes if you prefer a more strict naming) \n", + "that could be chosen. Our objective is to find a\n", + "plane that has the maximum margin, i.e the maximum distance between\n", + "data points of both classes. Maximizing the margin distance provides\n", + "some reinforcement so that future data points can be classified with\n", + "more confidence.\n", + "\n", + "What a linear classifier attempts to accomplish is to split the\n", + "feature space into two half spaces by placing a hyperplane between the\n", + "data points. This hyperplane will be our decision boundary. All\n", + "points on one side of the plane will belong to class one and all points\n", + "on the other side of the plane will belong to the second class two.\n", + "\n", + "Unfortunately there are many ways in which we can place a hyperplane\n", + "to divide the data. Below is an example of two candidate hyperplanes\n", + "for our data sample.\n", + "\n", + "\n", + "## Getting into the details\n", + "\n", + "Let us define the function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "f(x) = \\boldsymbol{w}^T\\boldsymbol{x}+b = 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "as the function that determines the line $L$ that separates two classes (our two features), see the figure here. \n", + "\n", + "\n", + "Any point defined by $\\boldsymbol{x}_i$ and $\\boldsymbol{x}_2$ on the line $L$ will satisfy $\\boldsymbol{w}^T(\\boldsymbol{x}_1-\\boldsymbol{x}_2)=0$. \n", + "\n", + "The signed distance $\\delta$ from any point defined by a vector $\\boldsymbol{x}$ and a point $\\boldsymbol{x}_0$ on the line $L$ is then" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\delta = \\frac{1}{\\vert\\vert \\boldsymbol{w}\\vert\\vert}(\\boldsymbol{w}^T\\boldsymbol{x}+b).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## First attempt at a minimization approach\n", + "\n", + "How do we find the parameter $b$ and the vector $\\boldsymbol{w}$? What we could\n", + "do is to define a cost function which now contains the set of all\n", + "misclassified points $M$ and attempt to minimize this function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "C(\\boldsymbol{w},b) = -\\sum_{i\\in M} y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We could now for example define all values $y_i =1$ as misclassified in case we have $\\boldsymbol{w}^T\\boldsymbol{x}_i+b < 0$ and the opposite if we have $y_i=-1$. Taking the derivatives gives us" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial C}{\\partial b} = -\\sum_{i\\in M} y_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial C}{\\partial \\boldsymbol{w}} = -\\sum_{i\\in M} y_ix_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Solving the equations\n", + "\n", + "We can now use the Newton-Raphson method or different variants of the gradient descent family (from plain gradient descent to various stochastic gradient descent approaches) to solve the equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b \\leftarrow b +\\eta \\frac{\\partial C}{\\partial b},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{w} \\leftarrow \\boldsymbol{w} +\\eta \\frac{\\partial C}{\\partial \\boldsymbol{w}},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $\\eta$ is our by now well-known learning rate. \n", + "\n", + "\n", + "\n", + "## Code Example\n", + "\n", + "The equations we discussed above can be coded rather easily (the\n", + "framework is similar to what we developed for logistic\n", + "regression). We are going to set up a simple case with two classes only and we want to find a line which separates them the best possible way." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Problems with the Simpler Approach\n", + "\n", + "\n", + "There are however problems with this approach, although it looks\n", + "pretty straightforward to implement. When running the above code, we see that we can easily end up with many diffeent lines which separate the two classes.\n", + "\n", + "\n", + "For small\n", + "gaps between the entries, we may also end up needing many iterations\n", + "before the solutions converge and if the data cannot be separated\n", + "properly into two distinct classes, we may not experience a converge\n", + "at all.\n", + "\n", + "\n", + "## A better approach\n", + "\n", + "A better approach is rather to try to define a large margin between\n", + "the two classes (if they are well separated from the beginning).\n", + "\n", + "Thus, we wish to find a margin $M$ with $\\boldsymbol{w}$ normalized to\n", + "$\\vert\\vert \\boldsymbol{w}\\vert\\vert =1$ subject to the condition" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M \\hspace{0.1cm}\\forall i=1,2,\\dots, p.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "All points are thus at a signed distance from the decision boundary defined by the line $L$. The parameters $b$ and $w_1$ and $w_2$ define this line. \n", + "\n", + "We seek thus the largest value $M$ defined by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{\\vert \\vert \\boldsymbol{w}\\vert\\vert}y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M \\hspace{0.1cm}\\forall i=1,2,\\dots, n,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or just" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M\\vert \\vert \\boldsymbol{w}\\vert\\vert \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If we scale the equation so that $\\vert \\vert \\boldsymbol{w}\\vert\\vert = 1/M$, we have to find the minimum of \n", + "$\\boldsymbol{w}^T\\boldsymbol{w}=\\vert \\vert \\boldsymbol{w}\\vert\\vert$ (the norm) subject to the condition" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq 1 \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We have thus defined our margin as the invers of the norm of\n", + "$\\boldsymbol{w}$. We want to minimize the norm in order to have a as large as\n", + "possible margin $M$. Before we proceed, we need to remind ourselves\n", + "about Lagrangian multipliers.\n", + "\n", + "\n", + "## A quick Reminder on Lagrangian Multipliers\n", + "\n", + "Consider a function of three independent variables $f(x,y,z)$ . For the function $f$ to be an\n", + "extreme we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "df=0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "A necessary and sufficient condition is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial x} =\\frac{\\partial f}{\\partial y}=\\frac{\\partial f}{\\partial z}=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "due to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "df = \\frac{\\partial f}{\\partial x}dx+\\frac{\\partial f}{\\partial y}dy+\\frac{\\partial f}{\\partial z}dz.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In many problems the variables $x,y,z$ are often subject to constraints (such as those above for the margin)\n", + "so that they are no longer all independent. It is possible at least in principle to use each \n", + "constraint to eliminate one variable\n", + "and to proceed with a new and smaller set of independent varables.\n", + "\n", + "The use of so-called Lagrangian multipliers is an alternative technique when the elimination\n", + "of variables is incovenient or undesirable. Assume that we have an equation of constraint on \n", + "the variables $x,y,z$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\phi(x,y,z) = 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "resulting in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "d\\phi = \\frac{\\partial \\phi}{\\partial x}dx+\\frac{\\partial \\phi}{\\partial y}dy+\\frac{\\partial \\phi}{\\partial z}dz =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now we cannot set anymore" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial x} =\\frac{\\partial f}{\\partial y}=\\frac{\\partial f}{\\partial z}=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "if $df=0$ is wanted\n", + "because there are now only two independent variables! Assume $x$ and $y$ are the independent \n", + "variables.\n", + "Then $dz$ is no longer arbitrary.\n", + "\n", + "\n", + "## Adding the Multiplier\n", + "\n", + "However, we can add to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "df = \\frac{\\partial f}{\\partial x}dx+\\frac{\\partial f}{\\partial y}dy+\\frac{\\partial f}{\\partial z}dz,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "a multiplum of $d\\phi$, viz. $\\lambda d\\phi$, resulting in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "df+\\lambda d\\phi = (\\frac{\\partial f}{\\partial z}+\\lambda\n", + "\\frac{\\partial \\phi}{\\partial x})dx+(\\frac{\\partial f}{\\partial y}+\\lambda\\frac{\\partial \\phi}{\\partial y})dy+\n", + "(\\frac{\\partial f}{\\partial z}+\\lambda\\frac{\\partial \\phi}{\\partial z})dz =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Our multiplier is chosen so that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial z}+\\lambda\\frac{\\partial \\phi}{\\partial z} =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We need to remember that we took $dx$ and $dy$ to be arbitrary and thus we must have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial x}+\\lambda\\frac{\\partial \\phi}{\\partial x} =0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial y}+\\lambda\\frac{\\partial \\phi}{\\partial y} =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "When all these equations are satisfied, $df=0$. We have four unknowns, $x,y,z$ and\n", + "$\\lambda$. Actually we want only $x,y,z$, $\\lambda$ needs not to be determined, \n", + "it is therefore often called\n", + "Lagrange's undetermined multiplier.\n", + "If we have a set of constraints $\\phi_k$ we have the equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial x_i}+\\sum_k\\lambda_k\\frac{\\partial \\phi_k}{\\partial x_i} =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Setting up the Problem\n", + "In order to solve the above problem, we define the following Lagrangian function to be minimized" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}(\\lambda,b,\\boldsymbol{w})=\\frac{1}{2}\\boldsymbol{w}^T\\boldsymbol{w}-\\sum_{i=1}^n\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)-1\\right],\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $\\lambda_i$ is a so-called Lagrange multiplier subject to the condition $\\lambda_i \\geq 0$.\n", + "\n", + "Taking the derivatives with respect to $b$ and $\\boldsymbol{w}$ we obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial {\\cal L}}{\\partial b} = -\\sum_{i} \\lambda_iy_i=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial {\\cal L}}{\\partial \\boldsymbol{w}} = 0 = \\boldsymbol{w}-\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Inserting these constraints into the equation for ${\\cal L}$ we obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to the constraints $\\lambda_i\\geq 0$ and $\\sum_i\\lambda_iy_i=0$. \n", + "We must in addition satisfy the [Karush-Kuhn-Tucker](https://en.wikipedia.org/wiki/Karush%E2%80%93Kuhn%E2%80%93Tucker_conditions) (KKT) condition" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) -1\\right] \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "1. If $\\lambda_i > 0$, then $y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1$ and we say that $x_i$ is on the boundary.\n", + "\n", + "2. If $y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)> 1$, we say $x_i$ is not on the boundary and we set $\\lambda_i=0$. \n", + "\n", + "When $\\lambda_i > 0$, the vectors $\\boldsymbol{x}_i$ are called support vectors. They are the vectors closest to the line (or hyperplane) and define the margin $M$. \n", + "\n", + "\n", + "## The problem to solve\n", + "\n", + "We can rewrite" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and its constraints in terms of a matrix-vector problem where we minimize w.r.t. $\\lambda$ the following problem" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1\\boldsymbol{x}_1^T\\boldsymbol{x}_1 & y_1y_2\\boldsymbol{x}_1^T\\boldsymbol{x}_2 & \\dots & \\dots & y_1y_n\\boldsymbol{x}_1^T\\boldsymbol{x}_n \\\\\n", + "y_2y_1\\boldsymbol{x}_2^T\\boldsymbol{x}_1 & y_2y_2\\boldsymbol{x}_2^T\\boldsymbol{x}_2 & \\dots & \\dots & y_1y_n\\boldsymbol{x}_2^T\\boldsymbol{x}_n \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "y_ny_1\\boldsymbol{x}_n^T\\boldsymbol{x}_1 & y_ny_2\\boldsymbol{x}_n^T\\boldsymbol{x}_2 & \\dots & \\dots & y_ny_n\\boldsymbol{x}_n^T\\boldsymbol{x}_n \\\\\n", + "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{1}\\boldsymbol{\\lambda},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", + "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", + "\n", + "\n", + "\n", + "## The last steps\n", + "\n", + "Solving the above problem, yields the values of $\\lambda_i$.\n", + "To find the coefficients of your hyperplane we need simply to compute" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{w}=\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With our vector $\\boldsymbol{w}$ we can in turn find the value of the intercept $b$ (here in two dimensions) via" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "resulting in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b = \\frac{1}{y_i}-\\boldsymbol{w}^T\\boldsymbol{x}_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or if we write it out in terms of the support vectors only, with $N_s$ being their number, we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b = \\frac{1}{N_s}\\sum_{j\\in N_s}\\left(y_j-\\sum_{i=1}^n\\lambda_iy_i\\boldsymbol{x}_i^T\\boldsymbol{x}_j\\right).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With our hyperplane coefficients we can use our classifier to assign any observation by simply using" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i = \\mathrm{sign}(\\boldsymbol{w}^T\\boldsymbol{x}_i+b).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Below we discuss how to find the optimal values of $\\lambda_i$. Before we proceed however, we discuss now the so-called soft classifier. \n", + "\n", + "\n", + "## A soft classifier\n", + "\n", + "Till now, the margin is strictly defined by the support vectors. This defines what is called a hard classifier, that is the margins are well defined.\n", + "\n", + "Suppose now that classes overlap in feature space, as shown in the\n", + "figure here. One way to deal with this problem before we define the\n", + "so-called **kernel approach**, is to allow a kind of slack in the sense\n", + "that we allow some points to be on the wrong side of the margin.\n", + "\n", + "We introduce thus the so-called **slack** variables $\\boldsymbol{\\xi} =[\\xi_1,x_2,\\dots,x_n]$ and \n", + "modify our previous equation" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1-\\xi_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with the requirement $\\xi_i\\geq 0$. The total violation is now $\\sum_i\\xi$. \n", + "The value $\\xi_i$ in the constraint the last constraint corresponds to the amount by which the prediction\n", + "$y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1$ is on the wrong side of its margin. Hence by bounding the sum $\\sum_i \\xi_i$,\n", + "we bound the total amount by which predictions fall on the wrong side of their margins.\n", + "\n", + "Misclassifications occur when $\\xi_i > 1$. Thus bounding the total sum by some value $C$ bounds in turn the total number of\n", + "misclassifications.\n", + "\n", + "\n", + "## Soft optmization problem\n", + "\n", + "\n", + "This has in turn the consequences that we change our optmization problem to finding the minimum of" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\frac{1}{2}\\boldsymbol{w}^T\\boldsymbol{w}-\\sum_{i=1}^n\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)-(1-\\xi_)\\right]+C\\sum_{i=1}^n\\xi_i-\\sum_{i=1}^n\\gamma_i\\xi_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1-\\xi_i \\hspace{0.1cm}\\forall i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with the requirement $\\xi_i\\geq 0$.\n", + "\n", + "Taking the derivatives with respect to $b$ and $\\boldsymbol{w}$ we obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial {\\cal L}}{\\partial b} = -\\sum_{i} \\lambda_iy_i=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial {\\cal L}}{\\partial \\boldsymbol{w}} = 0 = \\boldsymbol{w}-\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\lambda_i = C-\\gamma_i \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Inserting these constraints into the equation for ${\\cal L}$ we obtain the same equation as before" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "but now subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$ and $0\\leq\\lambda_i \\leq C$. \n", + "We must in addition satisfy the Karush-Kuhn-Tucker condition which now reads" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "5\n", + "0\n", + " \n", + "<\n", + "<\n", + "<\n", + "!\n", + "!\n", + "M\n", + "A\n", + "T\n", + "H\n", + "_\n", + "B\n", + "L\n", + "O\n", + "C\n", + "K" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\gamma_i\\xi_i = 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) -(1-\\xi_) \\geq 0 \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Kernels and non-linearity\n", + "\n", + "The cases we have studied till now, were all characterized by two classes\n", + "with a close to linear separability. The classifiers we have described\n", + "so far find linear boundaries in our input feature space. It is\n", + "possible to make our procedure more flexible by exploring the feature\n", + "space using other basis expansions such as higher-order polynomials,\n", + "wavelets, splines etc.\n", + "\n", + "If our feature space is not easy to separate, as shown in the figure\n", + "here, we can achieve a better separation by introducing more complex\n", + "basis functions. The ideal would be, as shown in the next figure, to, via a specific transformation to \n", + "obtain a separation between the classes which is almost linear. \n", + "\n", + "The change of basis, from $x\\rightarrow z=\\phi(x)$ leads to the same type of equations to be solved, except that\n", + "we need to introduce for example a polynomial transformation to a two-dimensional training set." + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
    " + ] + }, + "metadata": { + "filenames": { + "image/png": "/Users/hjensen/Teaching/FYS-STK4150/doc/src/LectureNotes/_build/jupyter_execute/chapter7_109_0.png" + }, + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "import numpy as np\n", + "import os\n", + "\n", + "np.random.seed(42)\n", + "\n", + "# To plot pretty figures\n", + "import matplotlib\n", + "import matplotlib.pyplot as plt\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", + "\n", + "\n", + "\n", + "X1D = np.linspace(-4, 4, 9).reshape(-1, 1)\n", + "X2D = np.c_[X1D, X1D**2]\n", + "y = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])\n", + "\n", + "plt.figure(figsize=(11, 4))\n", + "\n", + "plt.subplot(121)\n", + "plt.grid(True, which='both')\n", + "plt.axhline(y=0, color='k')\n", + "plt.plot(X1D[:, 0][y==0], np.zeros(4), \"bs\")\n", + "plt.plot(X1D[:, 0][y==1], np.zeros(5), \"g^\")\n", + "plt.gca().get_yaxis().set_ticks([])\n", + "plt.xlabel(r\"$x_1$\", fontsize=20)\n", + "plt.axis([-4.5, 4.5, -0.2, 0.2])\n", + "\n", + "plt.subplot(122)\n", + "plt.grid(True, which='both')\n", + "plt.axhline(y=0, color='k')\n", + "plt.axvline(x=0, color='k')\n", + "plt.plot(X2D[:, 0][y==0], X2D[:, 1][y==0], \"bs\")\n", + "plt.plot(X2D[:, 0][y==1], X2D[:, 1][y==1], \"g^\")\n", + "plt.xlabel(r\"$x_1$\", fontsize=20)\n", + "plt.ylabel(r\"$x_2$\", fontsize=20, rotation=0)\n", + "plt.gca().get_yaxis().set_ticks([0, 4, 8, 12, 16])\n", + "plt.plot([-4.5, 4.5], [6.5, 6.5], \"r--\", linewidth=3)\n", + "plt.axis([-4.5, 4.5, -1, 17])\n", + "plt.subplots_adjust(right=1)\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## The equations\n", + "\n", + "Suppose we define a polynomial transformation of degree two only (we continue to live in a plane with $x_i$ and $y_i$ as variables)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "z = \\phi(x_i) =\\left(x_i^2, y_i^2, \\sqrt{2}x_iy_i\\right).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With our new basis, the equations we solved earlier are basically the same, that is we have now (without the slack option for simplicity)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{z}_i^T\\boldsymbol{z}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$, and for the support vectors" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{z}_i+b)= 1 \\hspace{0.1cm}\\forall i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "from which we also find $b$.\n", + "To compute $\\boldsymbol{z}_i^T\\boldsymbol{z}_j$ we define the kernel $K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=\\boldsymbol{z}_i^T\\boldsymbol{z}_j= \\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "For the above example, the kernel reads" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=[x_i^2, y_i^2, \\sqrt{2}x_iy_i]^T\\begin{bmatrix} x_j^2 \\\\ y_j^2 \\\\ \\sqrt{2}x_jy_j \\end{bmatrix}=x_i^2x_j^2+2x_ix_jy_iy_j+y_i^2y_j^2.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We note that this is nothing but the dot product of the two original\n", + "vectors $(\\boldsymbol{x}_i^T\\boldsymbol{x}_j)^2$. Instead of thus computing the\n", + "product in the Lagrangian of $\\boldsymbol{z}_i^T\\boldsymbol{z}_j$ we simply compute\n", + "the dot product $(\\boldsymbol{x}_i^T\\boldsymbol{x}_j)^2$.\n", + "\n", + "\n", + "This leads to the so-called\n", + "kernel trick and the result leads to the same as if we went through\n", + "the trouble of performing the transformation\n", + "$\\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j)$ during the SVM calculations.\n", + "\n", + "\n", + "\n", + "## The problem to solve\n", + "Using our definition of the kernel We can rewrite again the Lagrangian" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{z}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$ in terms of a convex optimization problem" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1K(\\boldsymbol{x}_1,\\boldsymbol{x}_1) & y_1y_2K(\\boldsymbol{x}_1,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_1,\\boldsymbol{x}_n) \\\\\n", + "y_2y_1K(\\boldsymbol{x}_2,\\boldsymbol{x}_1) & y_2y_2(\\boldsymbol{x}_2,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_2,\\boldsymbol{x}_n) \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "y_ny_1K(\\boldsymbol{x}_n,\\boldsymbol{x}_1) & y_ny_2K(\\boldsymbol{x}_n\\boldsymbol{x}_2) & \\dots & \\dots & y_ny_nK(\\boldsymbol{x}_n,\\boldsymbol{x}_n) \\\\\n", + "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{1}\\boldsymbol{\\lambda},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", + "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", + "If we add the slack constants this leads to the additional constraint $0\\leq \\lambda_i \\leq C$.\n", + "\n", + "We can rewrite this (see the solutions below) in terms of a convex optimization problem of the type" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + " &\\mathrm{min}_{\\lambda}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{\\lambda}^T\\boldsymbol{P}\\boldsymbol{\\lambda}+\\boldsymbol{q}^T\\boldsymbol{\\lambda},\\\\ \\nonumber\n", + " &\\mathrm{subject\\hspace{0.1cm}to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{\\lambda} \\preceq \\boldsymbol{h} \\hspace{0.2cm} \\wedge \\boldsymbol{A}\\boldsymbol{\\lambda}=f.\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Below we discuss how to solve these equations. Here we note that the matrix $\\boldsymbol{P}$ has matrix elements $p_{ij}=y_iy_jK(\\boldsymbol{x}_i,\\boldsymbol{x}_j)$.\n", + "Given a kernel $K$ and the targets $y_i$ this matrix is easy to set up. The constraint $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$ leads to $f=0$ and $\\boldsymbol{A}=\\boldsymbol{y}$. How to set up the matrix $\\boldsymbol{G}$ is discussed later. Here note that the inequalities $0\\leq \\lambda_i \\leq C$ can be split up into\n", + "$0\\leq \\lambda_i$ and $\\lambda_i \\leq C$. These two inequalities define then the matrix $\\boldsymbol{G}$ and the vector $\\boldsymbol{h}$.\n", + "\n", + "\n", + "\n", + "## Different kernels and Mercer's theorem\n", + "\n", + "There are several popular kernels being used. These are\n", + "1. Linear: $K(\\boldsymbol{x},\\boldsymbol{y})=\\boldsymbol{x}^T\\boldsymbol{y}$,\n", + "\n", + "2. Polynomial: $K(\\boldsymbol{x},\\boldsymbol{y})=(\\boldsymbol{x}^T\\boldsymbol{y}+\\gamma)^d$,\n", + "\n", + "3. Gaussian Radial Basis Function: $K(\\boldsymbol{x},\\boldsymbol{y})=\\exp{\\left(-\\gamma\\vert\\vert\\boldsymbol{x}-\\boldsymbol{y}\\vert\\vert^2\\right)}$,\n", + "\n", + "4. Tanh: $K(\\boldsymbol{x},\\boldsymbol{y})=\\tanh{(\\boldsymbol{x}^T\\boldsymbol{y}+\\gamma)}$,\n", + "\n", + "and many other ones.\n", + "\n", + "An important theorem for us is [Mercer's\n", + "theorem](https://en.wikipedia.org/wiki/Mercer%27s_theorem). The\n", + "theorem states that if a kernel function $K$ is symmetric, continuous\n", + "and leads to a positive semi-definite matrix $\\boldsymbol{P}$ then there\n", + "exists a function $\\phi$ that maps $\\boldsymbol{x}_i$ and $\\boldsymbol{x}_j$ into\n", + "another space (possibly with much higher dimensions) such that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=\\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "So you can use $K$ as a kernel since you know $\\phi$ exists, even if\n", + "you don’t know what $\\phi$ is. \n", + "\n", + "Note that some frequently used kernels (such as the Sigmoid kernel)\n", + "don’t respect all of Mercer’s conditions, yet they generally work well\n", + "in practice.\n", + "\n", + "\n", + "\n", + "## The moons example" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
    " + ] + }, + "metadata": { + "filenames": { + "image/png": "/Users/hjensen/Teaching/FYS-STK4150/doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_0.png" + }, + "needs_background": "light" + }, + "output_type": "display_data" + }, + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/svm/_base.py:976: ConvergenceWarning: Liblinear failed to converge, increase the number of iterations.\n", + " warnings.warn(\"Liblinear failed to converge, increase \"\n" + ] + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
    " + ] + }, + "metadata": { + "filenames": { + "image/png": "/Users/hjensen/Teaching/FYS-STK4150/doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_2.png" + }, + "needs_background": "light" + }, + "output_type": "display_data" + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
    " + ] + }, + "metadata": { + "filenames": { + "image/png": "/Users/hjensen/Teaching/FYS-STK4150/doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_3.png" + }, + "needs_background": "light" + }, + "output_type": "display_data" + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
    " + ] + }, + "metadata": { + "filenames": { + "image/png": "/Users/hjensen/Teaching/FYS-STK4150/doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_4.png" + }, + "needs_background": "light" + }, + "output_type": "display_data" + }, + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Phi(-1.0, -2) = [0.74081822]\n", + "Phi(-1.0, 1) = [0.30119421]\n" + ] + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
    " + ] + }, + "metadata": { + "filenames": { + "image/png": "/Users/hjensen/Teaching/FYS-STK4150/doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_6.png" + }, + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "from __future__ import division, print_function, unicode_literals\n", + "\n", + "import numpy as np\n", + "np.random.seed(42)\n", + "\n", + "import matplotlib\n", + "import matplotlib.pyplot as plt\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", + "\n", + "\n", + "\n", + "from sklearn.pipeline import Pipeline\n", + "from sklearn.preprocessing import StandardScaler\n", + "from sklearn.svm import LinearSVC\n", + "\n", + "\n", + "from sklearn.datasets import make_moons\n", + "X, y = make_moons(n_samples=100, noise=0.15, random_state=42)\n", + "\n", + "def plot_dataset(X, y, axes):\n", + " plt.plot(X[:, 0][y==0], X[:, 1][y==0], \"bs\")\n", + " plt.plot(X[:, 0][y==1], X[:, 1][y==1], \"g^\")\n", + " plt.axis(axes)\n", + " plt.grid(True, which='both')\n", + " plt.xlabel(r\"$x_1$\", fontsize=20)\n", + " plt.ylabel(r\"$x_2$\", fontsize=20, rotation=0)\n", + "\n", + "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + "plt.show()\n", + "\n", + "from sklearn.datasets import make_moons\n", + "from sklearn.pipeline import Pipeline\n", + "from sklearn.preprocessing import PolynomialFeatures\n", + "\n", + "polynomial_svm_clf = Pipeline([\n", + " (\"poly_features\", PolynomialFeatures(degree=3)),\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", LinearSVC(C=10, loss=\"hinge\", random_state=42))\n", + " ])\n", + "\n", + "polynomial_svm_clf.fit(X, y)\n", + "\n", + "def plot_predictions(clf, axes):\n", + " x0s = np.linspace(axes[0], axes[1], 100)\n", + " x1s = np.linspace(axes[2], axes[3], 100)\n", + " x0, x1 = np.meshgrid(x0s, x1s)\n", + " X = np.c_[x0.ravel(), x1.ravel()]\n", + " y_pred = clf.predict(X).reshape(x0.shape)\n", + " y_decision = clf.decision_function(X).reshape(x0.shape)\n", + " plt.contourf(x0, x1, y_pred, cmap=plt.cm.brg, alpha=0.2)\n", + " plt.contourf(x0, x1, y_decision, cmap=plt.cm.brg, alpha=0.1)\n", + "\n", + "plot_predictions(polynomial_svm_clf, [-1.5, 2.5, -1, 1.5])\n", + "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + "\n", + "plt.show()\n", + "\n", + "\n", + "from sklearn.svm import SVC\n", + "\n", + "poly_kernel_svm_clf = Pipeline([\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", SVC(kernel=\"poly\", degree=3, coef0=1, C=5))\n", + " ])\n", + "poly_kernel_svm_clf.fit(X, y)\n", + "\n", + "poly100_kernel_svm_clf = Pipeline([\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", SVC(kernel=\"poly\", degree=10, coef0=100, C=5))\n", + " ])\n", + "poly100_kernel_svm_clf.fit(X, y)\n", + "\n", + "plt.figure(figsize=(11, 4))\n", + "\n", + "plt.subplot(121)\n", + "plot_predictions(poly_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])\n", + "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + "plt.title(r\"$d=3, r=1, C=5$\", fontsize=18)\n", + "\n", + "plt.subplot(122)\n", + "plot_predictions(poly100_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])\n", + "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + "plt.title(r\"$d=10, r=100, C=5$\", fontsize=18)\n", + "\n", + "plt.show()\n", + "\n", + "def gaussian_rbf(x, landmark, gamma):\n", + " return np.exp(-gamma * np.linalg.norm(x - landmark, axis=1)**2)\n", + "\n", + "gamma = 0.3\n", + "\n", + "x1s = np.linspace(-4.5, 4.5, 200).reshape(-1, 1)\n", + "x2s = gaussian_rbf(x1s, -2, gamma)\n", + "x3s = gaussian_rbf(x1s, 1, gamma)\n", + "\n", + "XK = np.c_[gaussian_rbf(X1D, -2, gamma), gaussian_rbf(X1D, 1, gamma)]\n", + "yk = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])\n", + "\n", + "plt.figure(figsize=(11, 4))\n", + "\n", + "plt.subplot(121)\n", + "plt.grid(True, which='both')\n", + "plt.axhline(y=0, color='k')\n", + "plt.scatter(x=[-2, 1], y=[0, 0], s=150, alpha=0.5, c=\"red\")\n", + "plt.plot(X1D[:, 0][yk==0], np.zeros(4), \"bs\")\n", + "plt.plot(X1D[:, 0][yk==1], np.zeros(5), \"g^\")\n", + "plt.plot(x1s, x2s, \"g--\")\n", + "plt.plot(x1s, x3s, \"b:\")\n", + "plt.gca().get_yaxis().set_ticks([0, 0.25, 0.5, 0.75, 1])\n", + "plt.xlabel(r\"$x_1$\", fontsize=20)\n", + "plt.ylabel(r\"Similarity\", fontsize=14)\n", + "plt.annotate(r'$\\mathbf{x}$',\n", + " xy=(X1D[3, 0], 0),\n", + " xytext=(-0.5, 0.20),\n", + " ha=\"center\",\n", + " arrowprops=dict(facecolor='black', shrink=0.1),\n", + " fontsize=18,\n", + " )\n", + "plt.text(-2, 0.9, \"$x_2$\", ha=\"center\", fontsize=20)\n", + "plt.text(1, 0.9, \"$x_3$\", ha=\"center\", fontsize=20)\n", + "plt.axis([-4.5, 4.5, -0.1, 1.1])\n", + "\n", + "plt.subplot(122)\n", + "plt.grid(True, which='both')\n", + "plt.axhline(y=0, color='k')\n", + "plt.axvline(x=0, color='k')\n", + "plt.plot(XK[:, 0][yk==0], XK[:, 1][yk==0], \"bs\")\n", + "plt.plot(XK[:, 0][yk==1], XK[:, 1][yk==1], \"g^\")\n", + "plt.xlabel(r\"$x_2$\", fontsize=20)\n", + "plt.ylabel(r\"$x_3$ \", fontsize=20, rotation=0)\n", + "plt.annotate(r'$\\phi\\left(\\mathbf{x}\\right)$',\n", + " xy=(XK[3, 0], XK[3, 1]),\n", + " xytext=(0.65, 0.50),\n", + " ha=\"center\",\n", + " arrowprops=dict(facecolor='black', shrink=0.1),\n", + " fontsize=18,\n", + " )\n", + "plt.plot([-0.1, 1.1], [0.57, -0.1], \"r--\", linewidth=3)\n", + "plt.axis([-0.1, 1.1, -0.1, 1.1])\n", + " \n", + "plt.subplots_adjust(right=1)\n", + "\n", + "plt.show()\n", + "\n", + "\n", + "x1_example = X1D[3, 0]\n", + "for landmark in (-2, 1):\n", + " k = gaussian_rbf(np.array([[x1_example]]), np.array([[landmark]]), gamma)\n", + " print(\"Phi({}, {}) = {}\".format(x1_example, landmark, k))\n", + "\n", + "rbf_kernel_svm_clf = Pipeline([\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", SVC(kernel=\"rbf\", gamma=5, C=0.001))\n", + " ])\n", + "rbf_kernel_svm_clf.fit(X, y)\n", + "\n", + "\n", + "from sklearn.svm import SVC\n", + "\n", + "gamma1, gamma2 = 0.1, 5\n", + "C1, C2 = 0.001, 1000\n", + "hyperparams = (gamma1, C1), (gamma1, C2), (gamma2, C1), (gamma2, C2)\n", + "\n", + "svm_clfs = []\n", + "for gamma, C in hyperparams:\n", + " rbf_kernel_svm_clf = Pipeline([\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", SVC(kernel=\"rbf\", gamma=gamma, C=C))\n", + " ])\n", + " rbf_kernel_svm_clf.fit(X, y)\n", + " svm_clfs.append(rbf_kernel_svm_clf)\n", + "\n", + "plt.figure(figsize=(11, 7))\n", + "\n", + "for i, svm_clf in enumerate(svm_clfs):\n", + " plt.subplot(221 + i)\n", + " plot_predictions(svm_clf, [-1.5, 2.5, -1, 1.5])\n", + " plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + " gamma, C = hyperparams[i]\n", + " plt.title(r\"$\\gamma = {}, C = {}$\".format(gamma, C), fontsize=16)\n", + "\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Mathematical optimization of convex functions\n", + "\n", + "A mathematical (quadratic) optimization problem, or just optimization problem, has the form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + " &\\mathrm{min}_{\\lambda}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{\\lambda}^T\\boldsymbol{P}\\boldsymbol{\\lambda}+\\boldsymbol{q}^T\\boldsymbol{\\lambda},\\\\ \\nonumber\n", + " &\\mathrm{subject\\hspace{0.1cm}to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{\\lambda} \\preceq \\boldsymbol{h} \\wedge \\boldsymbol{A}\\boldsymbol{\\lambda}=f.\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to some constraints for say a selected set $i=1,2,\\dots, n$.\n", + "In our case we are optimizing with respect to the Lagrangian multipliers $\\lambda_i$, and the\n", + "vector $\\boldsymbol{\\lambda}=[\\lambda_1, \\lambda_2,\\dots, \\lambda_n]$ is the optimization variable we are dealing with.\n", + "\n", + "In our case we are particularly interested in a class of optimization problems called convex optmization problems. \n", + "In our discussion on gradient descent methods we discussed at length the definition of a convex function. \n", + "\n", + "Convex optimization problems play a central role in applied mathematics and we recommend strongly [Boyd and Vandenberghe's text on the topics](http://web.stanford.edu/~boyd/cvxbook/).\n", + "\n", + "\n", + "\n", + "\n", + "## How do we solve these problems?\n", + "\n", + "If we use Python as programming language and wish to venture beyond\n", + "**scikit-learn**, **tensorflow** and similar software which makes our\n", + "lives so much easier, we need to dive into the wonderful world of\n", + "quadratic programming. We can, if we wish, solve the minimization\n", + "problem using say standard gradient methods or conjugate gradient\n", + "methods. However, these methods tend to exhibit a rather slow\n", + "converge. So, welcome to the promised land of quadratic programming.\n", + "\n", + "The functions we need are contained in the quadratic programming package **CVXOPT** and we need to import it together with **numpy** as" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy\n", + "import cvxopt" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This will make our life much easier. You don't need t write your own optimizer.\n", + "\n", + "\n", + "\n", + "## A simple example\n", + "\n", + "We remind ourselves about the general problem we want to solve" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + " &\\mathrm{min}_{x}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{P}\\boldsymbol{x}+\\boldsymbol{q}^T\\boldsymbol{x},\\\\ \\nonumber\n", + " &\\mathrm{subject\\hspace{0.1cm} to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{x} \\preceq \\boldsymbol{h} \\wedge \\boldsymbol{A}\\boldsymbol{x}=f.\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Let us show how to perform the optmization using a simple case. Assume we want to optimize the following problem" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + " &\\mathrm{min}_{x}\\hspace{0.2cm} \\frac{1}{2}x^2+5x+3y \\\\ \\nonumber\n", + " &\\mathrm{subject to} \\\\ \\nonumber\n", + " &x, y \\geq 0 \\\\ \\nonumber\n", + " &x+3y \\geq 15 \\\\ \\nonumber\n", + " &2x+5y \\leq 100 \\\\ \\nonumber\n", + " &3x+4y \\leq 80. \\\\ \\nonumber\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The minimization problem can be rewritten in terms of vectors and matrices as (with $x$ and $y$ being the unknowns)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{2}\\begin{bmatrix} x\\\\ y \\end{bmatrix}^T \\begin{bmatrix} 1 & 0\\\\ 0 & 0 \\end{bmatrix} \\begin{bmatrix} x \\\\ y \\end{bmatrix} + \\begin{bmatrix}3\\\\ 4 \\end{bmatrix}^T \\begin{bmatrix}x \\\\ y \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Similarly, we can now set up the inequalities (we need to change $\\geq$ to $\\leq$ by multiplying with $-1$ on bot sides) as the following matrix-vector equation" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{bmatrix} -1 & 0 \\\\ 0 & -1 \\\\ -1 & -3 \\\\ 2 & 5 \\\\ 3 & 4\\end{bmatrix}\\begin{bmatrix} x \\\\ y\\end{bmatrix} \\preceq \\begin{bmatrix}0 \\\\ 0\\\\ -15 \\\\ 100 \\\\ 80\\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We have collapsed all the inequalities into a single matrix $\\boldsymbol{G}$. We see also that our matrix" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{P} =\\begin{bmatrix} 1 & 0\\\\ 0 & 0 \\end{bmatrix}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "is clearly positive semi-definite (all eigenvalues larger or equal zero). \n", + "Finally, the vector $\\boldsymbol{h}$ is defined as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{h} = \\begin{bmatrix}0 \\\\ 0\\\\ -15 \\\\ 100 \\\\ 80\\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Since we don't have any equalities the matrix $\\boldsymbol{A}$ is set to zero\n", + "The following code solves the equations for us" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "ename": "SyntaxError", + "evalue": "invalid character in identifier (, line 5)", + "output_type": "error", + "traceback": [ + "\u001b[0;36m File \u001b[0;32m\"\"\u001b[0;36m, line \u001b[0;32m5\u001b[0m\n\u001b[0;31m P = matrix(numpy.diag([1,0]), tc=’d’)\u001b[0m\n\u001b[0m ^\u001b[0m\n\u001b[0;31mSyntaxError\u001b[0m\u001b[0;31m:\u001b[0m invalid character in identifier\n" + ] + } + ], + "source": [ + "# Import the necessary packages\n", + "import numpy\n", + "from cvxopt import matrix\n", + "from cvxopt import solvers\n", + "P = matrix(numpy.diag([1,0]), tc=’d’)\n", + "q = matrix(numpy.array([3,4]), tc=’d’)\n", + "G = matrix(numpy.array([[-1,0],[0,-1],[-1,-3],[2,5],[3,4]]), tc=’d’)\n", + "h = matrix(numpy.array([0,0,-15,100,80]), tc=’d’)\n", + "# Construct the QP, invoke solver\n", + "sol = solvers.qp(P,q,G,h)\n", + "# Extract optimal value and solution\n", + "sol[’x’] \n", + "sol[’primal objective’]" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Back to the more realistic cases\n", + "\n", + "We are now ready to return to our setup of the optmization problem for a more realistic case. Introducing the **slack** parameter $C$ we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1K(\\boldsymbol{x}_1,\\boldsymbol{x}_1) & y_1y_2K(\\boldsymbol{x}_1,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_1,\\boldsymbol{x}_n) \\\\\n", + "y_2y_1K(\\boldsymbol{x}_2,\\boldsymbol{x}_1) & y_2y_2K(\\boldsymbol{x}_2,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_2,\\boldsymbol{x}_n) \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "y_ny_1K(\\boldsymbol{x}_n,\\boldsymbol{x}_1) & y_ny_2K(\\boldsymbol{x}_n\\boldsymbol{x}_2) & \\dots & \\dots & y_ny_nK(\\boldsymbol{x}_n,\\boldsymbol{x}_n) \\\\\n", + "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{I}\\boldsymbol{\\lambda},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", + "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", + "With the slack constants this leads to the additional constraint $0\\leq \\lambda_i \\leq C$.\n", + "\n", + "**code will be added**" + ] + } + ], + "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.3" + } + }, + "nbformat": 4, + "nbformat_minor": 4 +} \ No newline at end of file diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter7.py b/doc/src/LectureNotes/_build/jupyter_execute/chapter7.py new file mode 100644 index 000000000..ecf74ee9d --- /dev/null +++ b/doc/src/LectureNotes/_build/jupyter_execute/chapter7.py @@ -0,0 +1,1114 @@ +# Support Vector Machines, overarching aims + +A Support Vector Machine (SVM) is a very powerful and versatile +Machine Learning method, capable of performing linear or nonlinear +classification, regression, and even outlier detection. It is one of +the most popular models in Machine Learning, and anyone interested in +Machine Learning should have it in their toolbox. SVMs are +particularly well suited for classification of complex but small-sized or +medium-sized datasets. + +The case with two well-separated classes only can be understood in an +intuitive way in terms of lines in a two-dimensional space separating +the two classes (see figure below). + +The basic mathematics behind the SVM is however less familiar to most of us. +It relies on the definition of hyperplanes and the +definition of a **margin** which separates classes (in case of +classification problems) of variables. It is also used for regression +problems. + +With SVMs we distinguish between hard margin and soft margins. The +latter introduces a so-called softening parameter to be discussed +below. We distinguish also between linear and non-linear +approaches. The latter are the most frequent ones since it is rather +unlikely that we can separate classes easily by say straight lines. + + +## Hyperplanes and all that + +The theory behind support vector machines (SVM hereafter) is based on +the mathematical description of so-called hyperplanes. Let us start +with a two-dimensional case. This will also allow us to introduce our +first SVM examples. These will be tailored to the case of two specific +classes, as displayed in the figure here based on the usage of the petal data. + +We assume here that our data set can be well separated into two +domains, where a straight line does the job in the separating the two +classes. Here the two classes are represented by either squares or +circles. + +%matplotlib inline + +from sklearn import datasets +from sklearn.svm import SVC, LinearSVC +from sklearn.linear_model import SGDClassifier +from sklearn.preprocessing import StandardScaler +import matplotlib +import matplotlib.pyplot as plt +plt.rcParams['axes.labelsize'] = 14 +plt.rcParams['xtick.labelsize'] = 12 +plt.rcParams['ytick.labelsize'] = 12 + + +iris = datasets.load_iris() +X = iris["data"][:, (2, 3)] # petal length, petal width +y = iris["target"] + +setosa_or_versicolor = (y == 0) | (y == 1) +X = X[setosa_or_versicolor] +y = y[setosa_or_versicolor] + + + +C = 5 +alpha = 1 / (C * len(X)) + +lin_clf = LinearSVC(loss="hinge", C=C, random_state=42) +svm_clf = SVC(kernel="linear", C=C) +sgd_clf = SGDClassifier(loss="hinge", learning_rate="constant", eta0=0.001, alpha=alpha, + max_iter=100000, random_state=42) + +scaler = StandardScaler() +X_scaled = scaler.fit_transform(X) + +lin_clf.fit(X_scaled, y) +svm_clf.fit(X_scaled, y) +sgd_clf.fit(X_scaled, y) + +print("LinearSVC: ", lin_clf.intercept_, lin_clf.coef_) +print("SVC: ", svm_clf.intercept_, svm_clf.coef_) +print("SGDClassifier(alpha={:.5f}):".format(sgd_clf.alpha), sgd_clf.intercept_, sgd_clf.coef_) + +# Compute the slope and bias of each decision boundary +w1 = -lin_clf.coef_[0, 0]/lin_clf.coef_[0, 1] +b1 = -lin_clf.intercept_[0]/lin_clf.coef_[0, 1] +w2 = -svm_clf.coef_[0, 0]/svm_clf.coef_[0, 1] +b2 = -svm_clf.intercept_[0]/svm_clf.coef_[0, 1] +w3 = -sgd_clf.coef_[0, 0]/sgd_clf.coef_[0, 1] +b3 = -sgd_clf.intercept_[0]/sgd_clf.coef_[0, 1] + +# Transform the decision boundary lines back to the original scale +line1 = scaler.inverse_transform([[-10, -10 * w1 + b1], [10, 10 * w1 + b1]]) +line2 = scaler.inverse_transform([[-10, -10 * w2 + b2], [10, 10 * w2 + b2]]) +line3 = scaler.inverse_transform([[-10, -10 * w3 + b3], [10, 10 * w3 + b3]]) + +# Plot all three decision boundaries +plt.figure(figsize=(11, 4)) +plt.plot(line1[:, 0], line1[:, 1], "k:", label="LinearSVC") +plt.plot(line2[:, 0], line2[:, 1], "b--", linewidth=2, label="SVC") +plt.plot(line3[:, 0], line3[:, 1], "r-", label="SGDClassifier") +plt.plot(X[:, 0][y==1], X[:, 1][y==1], "bs") # label="Iris-Versicolor" +plt.plot(X[:, 0][y==0], X[:, 1][y==0], "yo") # label="Iris-Setosa" +plt.xlabel("Petal length", fontsize=14) +plt.ylabel("Petal width", fontsize=14) +plt.legend(loc="upper center", fontsize=14) +plt.axis([0, 5.5, 0, 2]) + +plt.show() + +## What is a hyperplane? + +The aim of the SVM algorithm is to find a hyperplane in a +$p$-dimensional space, where $p$ is the number of features that +distinctly classifies the data points. + +In a $p$-dimensional space, a hyperplane is what we call an affine subspace of dimension of $p-1$. +As an example, in two dimension, a hyperplane is simply as straight line while in three dimensions it is +a two-dimensional subspace, or stated simply, a plane. + +In two dimensions, with the variables $x_1$ and $x_2$, the hyperplane is defined as + +$$ +b+w_1x_1+w_2x_2=0, +$$ + +where $b$ is the intercept and $w_1$ and $w_2$ define the elements of a vector orthogonal to the line +$b+w_1x_1+w_2x_2=0$. +In two dimensions we define the vectors $\boldsymbol{x} =[x1,x2]$ and $\boldsymbol{w}=[w1,w2]$. +We can then rewrite the above equation as + +$$ +\boldsymbol{x}^T\boldsymbol{w}+b=0. +$$ + +## A $p$-dimensional space of features + +We limit ourselves to two classes of outputs $y_i$ and assign these classes the values $y_i = \pm 1$. +In a $p$-dimensional space of say $p$ features we have a hyperplane defines as + +$$ +b+wx_1+w_2x_2+\dots +w_px_p=0. +$$ + +If we define a +matrix $\boldsymbol{X}=\left[\boldsymbol{x}_1,\boldsymbol{x}_2,\dots, \boldsymbol{x}_p\right]$ +of dimension $n\times p$, where $n$ represents the observations for each feature and each vector $x_i$ is a column vector of the matrix $\boldsymbol{X}$, + +$$ +\boldsymbol{x}_i = \begin{bmatrix} x_{i1} \\ x_{i2} \\ \dots \\ \dots \\ x_{ip} \end{bmatrix}. +$$ + +If the above condition is not met for a given vector $\boldsymbol{x}_i$ we have + +$$ +b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip} >0, +$$ + +if our output $y_i=1$. +In this case we say that $\boldsymbol{x}_i$ lies on one of the sides of the hyperplane and if + +$$ +b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip} < 0, +$$ + +for the class of observations $y_i=-1$, +then $\boldsymbol{x}_i$ lies on the other side. + +Equivalently, for the two classes of observations we have + +$$ +y_i\left(b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip}\right) > 0. +$$ + +When we try to separate hyperplanes, if it exists, we can use it to construct a natural classifier: a test observation is assigned a given class depending on which side of the hyperplane it is located. + + +## The two-dimensional case + +Let us try to develop our intuition about SVMs by limiting ourselves to a two-dimensional +plane. To separate the two classes of data points, there are many +possible lines (hyperplanes if you prefer a more strict naming) +that could be chosen. Our objective is to find a +plane that has the maximum margin, i.e the maximum distance between +data points of both classes. Maximizing the margin distance provides +some reinforcement so that future data points can be classified with +more confidence. + +What a linear classifier attempts to accomplish is to split the +feature space into two half spaces by placing a hyperplane between the +data points. This hyperplane will be our decision boundary. All +points on one side of the plane will belong to class one and all points +on the other side of the plane will belong to the second class two. + +Unfortunately there are many ways in which we can place a hyperplane +to divide the data. Below is an example of two candidate hyperplanes +for our data sample. + + +## Getting into the details + +Let us define the function + +$$ +f(x) = \boldsymbol{w}^T\boldsymbol{x}+b = 0, +$$ + +as the function that determines the line $L$ that separates two classes (our two features), see the figure here. + + +Any point defined by $\boldsymbol{x}_i$ and $\boldsymbol{x}_2$ on the line $L$ will satisfy $\boldsymbol{w}^T(\boldsymbol{x}_1-\boldsymbol{x}_2)=0$. + +The signed distance $\delta$ from any point defined by a vector $\boldsymbol{x}$ and a point $\boldsymbol{x}_0$ on the line $L$ is then + +$$ +\delta = \frac{1}{\vert\vert \boldsymbol{w}\vert\vert}(\boldsymbol{w}^T\boldsymbol{x}+b). +$$ + +## First attempt at a minimization approach + +How do we find the parameter $b$ and the vector $\boldsymbol{w}$? What we could +do is to define a cost function which now contains the set of all +misclassified points $M$ and attempt to minimize this function + +$$ +C(\boldsymbol{w},b) = -\sum_{i\in M} y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b). +$$ + +We could now for example define all values $y_i =1$ as misclassified in case we have $\boldsymbol{w}^T\boldsymbol{x}_i+b < 0$ and the opposite if we have $y_i=-1$. Taking the derivatives gives us + +$$ +\frac{\partial C}{\partial b} = -\sum_{i\in M} y_i, +$$ + +and + +$$ +\frac{\partial C}{\partial \boldsymbol{w}} = -\sum_{i\in M} y_ix_i. +$$ + +## Solving the equations + +We can now use the Newton-Raphson method or different variants of the gradient descent family (from plain gradient descent to various stochastic gradient descent approaches) to solve the equations + +$$ +b \leftarrow b +\eta \frac{\partial C}{\partial b}, +$$ + +and + +$$ +\boldsymbol{w} \leftarrow \boldsymbol{w} +\eta \frac{\partial C}{\partial \boldsymbol{w}}, +$$ + +where $\eta$ is our by now well-known learning rate. + + + +## Code Example + +The equations we discussed above can be coded rather easily (the +framework is similar to what we developed for logistic +regression). We are going to set up a simple case with two classes only and we want to find a line which separates them the best possible way. + +## Problems with the Simpler Approach + + +There are however problems with this approach, although it looks +pretty straightforward to implement. When running the above code, we see that we can easily end up with many diffeent lines which separate the two classes. + + +For small +gaps between the entries, we may also end up needing many iterations +before the solutions converge and if the data cannot be separated +properly into two distinct classes, we may not experience a converge +at all. + + +## A better approach + +A better approach is rather to try to define a large margin between +the two classes (if they are well separated from the beginning). + +Thus, we wish to find a margin $M$ with $\boldsymbol{w}$ normalized to +$\vert\vert \boldsymbol{w}\vert\vert =1$ subject to the condition + +$$ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq M \hspace{0.1cm}\forall i=1,2,\dots, p. +$$ + +All points are thus at a signed distance from the decision boundary defined by the line $L$. The parameters $b$ and $w_1$ and $w_2$ define this line. + +We seek thus the largest value $M$ defined by + +$$ +\frac{1}{\vert \vert \boldsymbol{w}\vert\vert}y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq M \hspace{0.1cm}\forall i=1,2,\dots, n, +$$ + +or just + +$$ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq M\vert \vert \boldsymbol{w}\vert\vert \hspace{0.1cm}\forall i. +$$ + +If we scale the equation so that $\vert \vert \boldsymbol{w}\vert\vert = 1/M$, we have to find the minimum of +$\boldsymbol{w}^T\boldsymbol{w}=\vert \vert \boldsymbol{w}\vert\vert$ (the norm) subject to the condition + +$$ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq 1 \hspace{0.1cm}\forall i. +$$ + +We have thus defined our margin as the invers of the norm of +$\boldsymbol{w}$. We want to minimize the norm in order to have a as large as +possible margin $M$. Before we proceed, we need to remind ourselves +about Lagrangian multipliers. + + +## A quick Reminder on Lagrangian Multipliers + +Consider a function of three independent variables $f(x,y,z)$ . For the function $f$ to be an +extreme we have + +$$ +df=0. +$$ + +A necessary and sufficient condition is + +$$ +\frac{\partial f}{\partial x} =\frac{\partial f}{\partial y}=\frac{\partial f}{\partial z}=0, +$$ + +due to + +$$ +df = \frac{\partial f}{\partial x}dx+\frac{\partial f}{\partial y}dy+\frac{\partial f}{\partial z}dz. +$$ + +In many problems the variables $x,y,z$ are often subject to constraints (such as those above for the margin) +so that they are no longer all independent. It is possible at least in principle to use each +constraint to eliminate one variable +and to proceed with a new and smaller set of independent varables. + +The use of so-called Lagrangian multipliers is an alternative technique when the elimination +of variables is incovenient or undesirable. Assume that we have an equation of constraint on +the variables $x,y,z$ + +$$ +\phi(x,y,z) = 0, +$$ + +resulting in + +$$ +d\phi = \frac{\partial \phi}{\partial x}dx+\frac{\partial \phi}{\partial y}dy+\frac{\partial \phi}{\partial z}dz =0. +$$ + +Now we cannot set anymore + +$$ +\frac{\partial f}{\partial x} =\frac{\partial f}{\partial y}=\frac{\partial f}{\partial z}=0, +$$ + +if $df=0$ is wanted +because there are now only two independent variables! Assume $x$ and $y$ are the independent +variables. +Then $dz$ is no longer arbitrary. + + +## Adding the Multiplier + +However, we can add to + +$$ +df = \frac{\partial f}{\partial x}dx+\frac{\partial f}{\partial y}dy+\frac{\partial f}{\partial z}dz, +$$ + +a multiplum of $d\phi$, viz. $\lambda d\phi$, resulting in + +$$ +df+\lambda d\phi = (\frac{\partial f}{\partial z}+\lambda +\frac{\partial \phi}{\partial x})dx+(\frac{\partial f}{\partial y}+\lambda\frac{\partial \phi}{\partial y})dy+ +(\frac{\partial f}{\partial z}+\lambda\frac{\partial \phi}{\partial z})dz =0. +$$ + +Our multiplier is chosen so that + +$$ +\frac{\partial f}{\partial z}+\lambda\frac{\partial \phi}{\partial z} =0. +$$ + +We need to remember that we took $dx$ and $dy$ to be arbitrary and thus we must have + +$$ +\frac{\partial f}{\partial x}+\lambda\frac{\partial \phi}{\partial x} =0, +$$ + +and + +$$ +\frac{\partial f}{\partial y}+\lambda\frac{\partial \phi}{\partial y} =0. +$$ + +When all these equations are satisfied, $df=0$. We have four unknowns, $x,y,z$ and +$\lambda$. Actually we want only $x,y,z$, $\lambda$ needs not to be determined, +it is therefore often called +Lagrange's undetermined multiplier. +If we have a set of constraints $\phi_k$ we have the equations + +$$ +\frac{\partial f}{\partial x_i}+\sum_k\lambda_k\frac{\partial \phi_k}{\partial x_i} =0. +$$ + +## Setting up the Problem +In order to solve the above problem, we define the following Lagrangian function to be minimized + +$$ +{\cal L}(\lambda,b,\boldsymbol{w})=\frac{1}{2}\boldsymbol{w}^T\boldsymbol{w}-\sum_{i=1}^n\lambda_i\left[y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)-1\right], +$$ + +where $\lambda_i$ is a so-called Lagrange multiplier subject to the condition $\lambda_i \geq 0$. + +Taking the derivatives with respect to $b$ and $\boldsymbol{w}$ we obtain + +$$ +\frac{\partial {\cal L}}{\partial b} = -\sum_{i} \lambda_iy_i=0, +$$ + +and + +$$ +\frac{\partial {\cal L}}{\partial \boldsymbol{w}} = 0 = \boldsymbol{w}-\sum_{i} \lambda_iy_i\boldsymbol{x}_i. +$$ + +Inserting these constraints into the equation for ${\cal L}$ we obtain + +$$ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{x}_j, +$$ + +subject to the constraints $\lambda_i\geq 0$ and $\sum_i\lambda_iy_i=0$. +We must in addition satisfy the [Karush-Kuhn-Tucker](https://en.wikipedia.org/wiki/Karush%E2%80%93Kuhn%E2%80%93Tucker_conditions) (KKT) condition + +$$ +\lambda_i\left[y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) -1\right] \hspace{0.1cm}\forall i. +$$ + +1. If $\lambda_i > 0$, then $y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1$ and we say that $x_i$ is on the boundary. + +2. If $y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)> 1$, we say $x_i$ is not on the boundary and we set $\lambda_i=0$. + +When $\lambda_i > 0$, the vectors $\boldsymbol{x}_i$ are called support vectors. They are the vectors closest to the line (or hyperplane) and define the margin $M$. + + +## The problem to solve + +We can rewrite + +$$ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{x}_j, +$$ + +and its constraints in terms of a matrix-vector problem where we minimize w.r.t. $\lambda$ the following problem + +$$ +\frac{1}{2} \boldsymbol{\lambda}^T\begin{bmatrix} y_1y_1\boldsymbol{x}_1^T\boldsymbol{x}_1 & y_1y_2\boldsymbol{x}_1^T\boldsymbol{x}_2 & \dots & \dots & y_1y_n\boldsymbol{x}_1^T\boldsymbol{x}_n \\ +y_2y_1\boldsymbol{x}_2^T\boldsymbol{x}_1 & y_2y_2\boldsymbol{x}_2^T\boldsymbol{x}_2 & \dots & \dots & y_1y_n\boldsymbol{x}_2^T\boldsymbol{x}_n \\ +\dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots \\ +y_ny_1\boldsymbol{x}_n^T\boldsymbol{x}_1 & y_ny_2\boldsymbol{x}_n^T\boldsymbol{x}_2 & \dots & \dots & y_ny_n\boldsymbol{x}_n^T\boldsymbol{x}_n \\ +\end{bmatrix}\boldsymbol{\lambda}-\mathbb{1}\boldsymbol{\lambda}, +$$ + +subject to $\boldsymbol{y}^T\boldsymbol{\lambda}=0$. Here we defined the vectors $\boldsymbol{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]$ and +$\boldsymbol{y}=[y_1,y_2,\dots,y_n]$. + + + +## The last steps + +Solving the above problem, yields the values of $\lambda_i$. +To find the coefficients of your hyperplane we need simply to compute + +$$ +\boldsymbol{w}=\sum_{i} \lambda_iy_i\boldsymbol{x}_i. +$$ + +With our vector $\boldsymbol{w}$ we can in turn find the value of the intercept $b$ (here in two dimensions) via + +$$ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1, +$$ + +resulting in + +$$ +b = \frac{1}{y_i}-\boldsymbol{w}^T\boldsymbol{x}_i, +$$ + +or if we write it out in terms of the support vectors only, with $N_s$ being their number, we have + +$$ +b = \frac{1}{N_s}\sum_{j\in N_s}\left(y_j-\sum_{i=1}^n\lambda_iy_i\boldsymbol{x}_i^T\boldsymbol{x}_j\right). +$$ + +With our hyperplane coefficients we can use our classifier to assign any observation by simply using + +$$ +y_i = \mathrm{sign}(\boldsymbol{w}^T\boldsymbol{x}_i+b). +$$ + +Below we discuss how to find the optimal values of $\lambda_i$. Before we proceed however, we discuss now the so-called soft classifier. + + +## A soft classifier + +Till now, the margin is strictly defined by the support vectors. This defines what is called a hard classifier, that is the margins are well defined. + +Suppose now that classes overlap in feature space, as shown in the +figure here. One way to deal with this problem before we define the +so-called **kernel approach**, is to allow a kind of slack in the sense +that we allow some points to be on the wrong side of the margin. + +We introduce thus the so-called **slack** variables $\boldsymbol{\xi} =[\xi_1,x_2,\dots,x_n]$ and +modify our previous equation + +$$ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1, +$$ + +to + +$$ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1-\xi_i, +$$ + +with the requirement $\xi_i\geq 0$. The total violation is now $\sum_i\xi$. +The value $\xi_i$ in the constraint the last constraint corresponds to the amount by which the prediction +$y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1$ is on the wrong side of its margin. Hence by bounding the sum $\sum_i \xi_i$, +we bound the total amount by which predictions fall on the wrong side of their margins. + +Misclassifications occur when $\xi_i > 1$. Thus bounding the total sum by some value $C$ bounds in turn the total number of +misclassifications. + + +## Soft optmization problem + + +This has in turn the consequences that we change our optmization problem to finding the minimum of + +$$ +{\cal L}=\frac{1}{2}\boldsymbol{w}^T\boldsymbol{w}-\sum_{i=1}^n\lambda_i\left[y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)-(1-\xi_)\right]+C\sum_{i=1}^n\xi_i-\sum_{i=1}^n\gamma_i\xi_i, +$$ + +subject to + +$$ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1-\xi_i \hspace{0.1cm}\forall i, +$$ + +with the requirement $\xi_i\geq 0$. + +Taking the derivatives with respect to $b$ and $\boldsymbol{w}$ we obtain + +$$ +\frac{\partial {\cal L}}{\partial b} = -\sum_{i} \lambda_iy_i=0, +$$ + +and + +$$ +\frac{\partial {\cal L}}{\partial \boldsymbol{w}} = 0 = \boldsymbol{w}-\sum_{i} \lambda_iy_i\boldsymbol{x}_i, +$$ + +and + +$$ +\lambda_i = C-\gamma_i \hspace{0.1cm}\forall i. +$$ + +Inserting these constraints into the equation for ${\cal L}$ we obtain the same equation as before + +$$ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{x}_j, +$$ + +but now subject to the constraints $\lambda_i\geq 0$, $\sum_i\lambda_iy_i=0$ and $0\leq\lambda_i \leq C$. +We must in addition satisfy the Karush-Kuhn-Tucker condition which now reads + +5 +0 + +< +< +< +! +! +M +A +T +H +_ +B +L +O +C +K + +$$ +\gamma_i\xi_i = 0, +$$ + +and + +$$ +y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) -(1-\xi_) \geq 0 \hspace{0.1cm}\forall i. +$$ + +## Kernels and non-linearity + +The cases we have studied till now, were all characterized by two classes +with a close to linear separability. The classifiers we have described +so far find linear boundaries in our input feature space. It is +possible to make our procedure more flexible by exploring the feature +space using other basis expansions such as higher-order polynomials, +wavelets, splines etc. + +If our feature space is not easy to separate, as shown in the figure +here, we can achieve a better separation by introducing more complex +basis functions. The ideal would be, as shown in the next figure, to, via a specific transformation to +obtain a separation between the classes which is almost linear. + +The change of basis, from $x\rightarrow z=\phi(x)$ leads to the same type of equations to be solved, except that +we need to introduce for example a polynomial transformation to a two-dimensional training set. + +import numpy as np +import os + +np.random.seed(42) + +# To plot pretty figures +import matplotlib +import matplotlib.pyplot as plt +plt.rcParams['axes.labelsize'] = 14 +plt.rcParams['xtick.labelsize'] = 12 +plt.rcParams['ytick.labelsize'] = 12 + + +from sklearn.svm import SVC +from sklearn import datasets + + + +X1D = np.linspace(-4, 4, 9).reshape(-1, 1) +X2D = np.c_[X1D, X1D**2] +y = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0]) + +plt.figure(figsize=(11, 4)) + +plt.subplot(121) +plt.grid(True, which='both') +plt.axhline(y=0, color='k') +plt.plot(X1D[:, 0][y==0], np.zeros(4), "bs") +plt.plot(X1D[:, 0][y==1], np.zeros(5), "g^") +plt.gca().get_yaxis().set_ticks([]) +plt.xlabel(r"$x_1$", fontsize=20) +plt.axis([-4.5, 4.5, -0.2, 0.2]) + +plt.subplot(122) +plt.grid(True, which='both') +plt.axhline(y=0, color='k') +plt.axvline(x=0, color='k') +plt.plot(X2D[:, 0][y==0], X2D[:, 1][y==0], "bs") +plt.plot(X2D[:, 0][y==1], X2D[:, 1][y==1], "g^") +plt.xlabel(r"$x_1$", fontsize=20) +plt.ylabel(r"$x_2$", fontsize=20, rotation=0) +plt.gca().get_yaxis().set_ticks([0, 4, 8, 12, 16]) +plt.plot([-4.5, 4.5], [6.5, 6.5], "r--", linewidth=3) +plt.axis([-4.5, 4.5, -1, 17]) +plt.subplots_adjust(right=1) +plt.show() + +## The equations + +Suppose we define a polynomial transformation of degree two only (we continue to live in a plane with $x_i$ and $y_i$ as variables) + +$$ +z = \phi(x_i) =\left(x_i^2, y_i^2, \sqrt{2}x_iy_i\right). +$$ + +With our new basis, the equations we solved earlier are basically the same, that is we have now (without the slack option for simplicity) + +$$ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{z}_i^T\boldsymbol{z}_j, +$$ + +subject to the constraints $\lambda_i\geq 0$, $\sum_i\lambda_iy_i=0$, and for the support vectors + +$$ +y_i(\boldsymbol{w}^T\boldsymbol{z}_i+b)= 1 \hspace{0.1cm}\forall i, +$$ + +from which we also find $b$. +To compute $\boldsymbol{z}_i^T\boldsymbol{z}_j$ we define the kernel $K(\boldsymbol{x}_i,\boldsymbol{x}_j)$ as + +$$ +K(\boldsymbol{x}_i,\boldsymbol{x}_j)=\boldsymbol{z}_i^T\boldsymbol{z}_j= \phi(\boldsymbol{x}_i)^T\phi(\boldsymbol{x}_j). +$$ + +For the above example, the kernel reads + +$$ +K(\boldsymbol{x}_i,\boldsymbol{x}_j)=[x_i^2, y_i^2, \sqrt{2}x_iy_i]^T\begin{bmatrix} x_j^2 \\ y_j^2 \\ \sqrt{2}x_jy_j \end{bmatrix}=x_i^2x_j^2+2x_ix_jy_iy_j+y_i^2y_j^2. +$$ + +We note that this is nothing but the dot product of the two original +vectors $(\boldsymbol{x}_i^T\boldsymbol{x}_j)^2$. Instead of thus computing the +product in the Lagrangian of $\boldsymbol{z}_i^T\boldsymbol{z}_j$ we simply compute +the dot product $(\boldsymbol{x}_i^T\boldsymbol{x}_j)^2$. + + +This leads to the so-called +kernel trick and the result leads to the same as if we went through +the trouble of performing the transformation +$\phi(\boldsymbol{x}_i)^T\phi(\boldsymbol{x}_j)$ during the SVM calculations. + + + +## The problem to solve +Using our definition of the kernel We can rewrite again the Lagrangian + +$$ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{z}_j, +$$ + +subject to the constraints $\lambda_i\geq 0$, $\sum_i\lambda_iy_i=0$ in terms of a convex optimization problem + +$$ +\frac{1}{2} \boldsymbol{\lambda}^T\begin{bmatrix} y_1y_1K(\boldsymbol{x}_1,\boldsymbol{x}_1) & y_1y_2K(\boldsymbol{x}_1,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_1,\boldsymbol{x}_n) \\ +y_2y_1K(\boldsymbol{x}_2,\boldsymbol{x}_1) & y_2y_2(\boldsymbol{x}_2,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_2,\boldsymbol{x}_n) \\ +\dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots \\ +y_ny_1K(\boldsymbol{x}_n,\boldsymbol{x}_1) & y_ny_2K(\boldsymbol{x}_n\boldsymbol{x}_2) & \dots & \dots & y_ny_nK(\boldsymbol{x}_n,\boldsymbol{x}_n) \\ +\end{bmatrix}\boldsymbol{\lambda}-\mathbb{1}\boldsymbol{\lambda}, +$$ + +subject to $\boldsymbol{y}^T\boldsymbol{\lambda}=0$. Here we defined the vectors $\boldsymbol{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]$ and +$\boldsymbol{y}=[y_1,y_2,\dots,y_n]$. +If we add the slack constants this leads to the additional constraint $0\leq \lambda_i \leq C$. + +We can rewrite this (see the solutions below) in terms of a convex optimization problem of the type + +$$ +\begin{align*} + &\mathrm{min}_{\lambda}\hspace{0.2cm} \frac{1}{2}\boldsymbol{\lambda}^T\boldsymbol{P}\boldsymbol{\lambda}+\boldsymbol{q}^T\boldsymbol{\lambda},\\ \nonumber + &\mathrm{subject\hspace{0.1cm}to} \hspace{0.2cm} \boldsymbol{G}\boldsymbol{\lambda} \preceq \boldsymbol{h} \hspace{0.2cm} \wedge \boldsymbol{A}\boldsymbol{\lambda}=f. +\end{align*} +$$ + +Below we discuss how to solve these equations. Here we note that the matrix $\boldsymbol{P}$ has matrix elements $p_{ij}=y_iy_jK(\boldsymbol{x}_i,\boldsymbol{x}_j)$. +Given a kernel $K$ and the targets $y_i$ this matrix is easy to set up. The constraint $\boldsymbol{y}^T\boldsymbol{\lambda}=0$ leads to $f=0$ and $\boldsymbol{A}=\boldsymbol{y}$. How to set up the matrix $\boldsymbol{G}$ is discussed later. Here note that the inequalities $0\leq \lambda_i \leq C$ can be split up into +$0\leq \lambda_i$ and $\lambda_i \leq C$. These two inequalities define then the matrix $\boldsymbol{G}$ and the vector $\boldsymbol{h}$. + + + +## Different kernels and Mercer's theorem + +There are several popular kernels being used. These are +1. Linear: $K(\boldsymbol{x},\boldsymbol{y})=\boldsymbol{x}^T\boldsymbol{y}$, + +2. Polynomial: $K(\boldsymbol{x},\boldsymbol{y})=(\boldsymbol{x}^T\boldsymbol{y}+\gamma)^d$, + +3. Gaussian Radial Basis Function: $K(\boldsymbol{x},\boldsymbol{y})=\exp{\left(-\gamma\vert\vert\boldsymbol{x}-\boldsymbol{y}\vert\vert^2\right)}$, + +4. Tanh: $K(\boldsymbol{x},\boldsymbol{y})=\tanh{(\boldsymbol{x}^T\boldsymbol{y}+\gamma)}$, + +and many other ones. + +An important theorem for us is [Mercer's +theorem](https://en.wikipedia.org/wiki/Mercer%27s_theorem). The +theorem states that if a kernel function $K$ is symmetric, continuous +and leads to a positive semi-definite matrix $\boldsymbol{P}$ then there +exists a function $\phi$ that maps $\boldsymbol{x}_i$ and $\boldsymbol{x}_j$ into +another space (possibly with much higher dimensions) such that + +$$ +K(\boldsymbol{x}_i,\boldsymbol{x}_j)=\phi(\boldsymbol{x}_i)^T\phi(\boldsymbol{x}_j). +$$ + +So you can use $K$ as a kernel since you know $\phi$ exists, even if +you don’t know what $\phi$ is. + +Note that some frequently used kernels (such as the Sigmoid kernel) +don’t respect all of Mercer’s conditions, yet they generally work well +in practice. + + + +## The moons example + +from __future__ import division, print_function, unicode_literals + +import numpy as np +np.random.seed(42) + +import matplotlib +import matplotlib.pyplot as plt +plt.rcParams['axes.labelsize'] = 14 +plt.rcParams['xtick.labelsize'] = 12 +plt.rcParams['ytick.labelsize'] = 12 + + +from sklearn.svm import SVC +from sklearn import datasets + + + +from sklearn.pipeline import Pipeline +from sklearn.preprocessing import StandardScaler +from sklearn.svm import LinearSVC + + +from sklearn.datasets import make_moons +X, y = make_moons(n_samples=100, noise=0.15, random_state=42) + +def plot_dataset(X, y, axes): + plt.plot(X[:, 0][y==0], X[:, 1][y==0], "bs") + plt.plot(X[:, 0][y==1], X[:, 1][y==1], "g^") + plt.axis(axes) + plt.grid(True, which='both') + plt.xlabel(r"$x_1$", fontsize=20) + plt.ylabel(r"$x_2$", fontsize=20, rotation=0) + +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) +plt.show() + +from sklearn.datasets import make_moons +from sklearn.pipeline import Pipeline +from sklearn.preprocessing import PolynomialFeatures + +polynomial_svm_clf = Pipeline([ + ("poly_features", PolynomialFeatures(degree=3)), + ("scaler", StandardScaler()), + ("svm_clf", LinearSVC(C=10, loss="hinge", random_state=42)) + ]) + +polynomial_svm_clf.fit(X, y) + +def plot_predictions(clf, axes): + x0s = np.linspace(axes[0], axes[1], 100) + x1s = np.linspace(axes[2], axes[3], 100) + x0, x1 = np.meshgrid(x0s, x1s) + X = np.c_[x0.ravel(), x1.ravel()] + y_pred = clf.predict(X).reshape(x0.shape) + y_decision = clf.decision_function(X).reshape(x0.shape) + plt.contourf(x0, x1, y_pred, cmap=plt.cm.brg, alpha=0.2) + plt.contourf(x0, x1, y_decision, cmap=plt.cm.brg, alpha=0.1) + +plot_predictions(polynomial_svm_clf, [-1.5, 2.5, -1, 1.5]) +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) + +plt.show() + + +from sklearn.svm import SVC + +poly_kernel_svm_clf = Pipeline([ + ("scaler", StandardScaler()), + ("svm_clf", SVC(kernel="poly", degree=3, coef0=1, C=5)) + ]) +poly_kernel_svm_clf.fit(X, y) + +poly100_kernel_svm_clf = Pipeline([ + ("scaler", StandardScaler()), + ("svm_clf", SVC(kernel="poly", degree=10, coef0=100, C=5)) + ]) +poly100_kernel_svm_clf.fit(X, y) + +plt.figure(figsize=(11, 4)) + +plt.subplot(121) +plot_predictions(poly_kernel_svm_clf, [-1.5, 2.5, -1, 1.5]) +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) +plt.title(r"$d=3, r=1, C=5$", fontsize=18) + +plt.subplot(122) +plot_predictions(poly100_kernel_svm_clf, [-1.5, 2.5, -1, 1.5]) +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) +plt.title(r"$d=10, r=100, C=5$", fontsize=18) + +plt.show() + +def gaussian_rbf(x, landmark, gamma): + return np.exp(-gamma * np.linalg.norm(x - landmark, axis=1)**2) + +gamma = 0.3 + +x1s = np.linspace(-4.5, 4.5, 200).reshape(-1, 1) +x2s = gaussian_rbf(x1s, -2, gamma) +x3s = gaussian_rbf(x1s, 1, gamma) + +XK = np.c_[gaussian_rbf(X1D, -2, gamma), gaussian_rbf(X1D, 1, gamma)] +yk = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0]) + +plt.figure(figsize=(11, 4)) + +plt.subplot(121) +plt.grid(True, which='both') +plt.axhline(y=0, color='k') +plt.scatter(x=[-2, 1], y=[0, 0], s=150, alpha=0.5, c="red") +plt.plot(X1D[:, 0][yk==0], np.zeros(4), "bs") +plt.plot(X1D[:, 0][yk==1], np.zeros(5), "g^") +plt.plot(x1s, x2s, "g--") +plt.plot(x1s, x3s, "b:") +plt.gca().get_yaxis().set_ticks([0, 0.25, 0.5, 0.75, 1]) +plt.xlabel(r"$x_1$", fontsize=20) +plt.ylabel(r"Similarity", fontsize=14) +plt.annotate(r'$\mathbf{x}$', + xy=(X1D[3, 0], 0), + xytext=(-0.5, 0.20), + ha="center", + arrowprops=dict(facecolor='black', shrink=0.1), + fontsize=18, + ) +plt.text(-2, 0.9, "$x_2$", ha="center", fontsize=20) +plt.text(1, 0.9, "$x_3$", ha="center", fontsize=20) +plt.axis([-4.5, 4.5, -0.1, 1.1]) + +plt.subplot(122) +plt.grid(True, which='both') +plt.axhline(y=0, color='k') +plt.axvline(x=0, color='k') +plt.plot(XK[:, 0][yk==0], XK[:, 1][yk==0], "bs") +plt.plot(XK[:, 0][yk==1], XK[:, 1][yk==1], "g^") +plt.xlabel(r"$x_2$", fontsize=20) +plt.ylabel(r"$x_3$ ", fontsize=20, rotation=0) +plt.annotate(r'$\phi\left(\mathbf{x}\right)$', + xy=(XK[3, 0], XK[3, 1]), + xytext=(0.65, 0.50), + ha="center", + arrowprops=dict(facecolor='black', shrink=0.1), + fontsize=18, + ) +plt.plot([-0.1, 1.1], [0.57, -0.1], "r--", linewidth=3) +plt.axis([-0.1, 1.1, -0.1, 1.1]) + +plt.subplots_adjust(right=1) + +plt.show() + + +x1_example = X1D[3, 0] +for landmark in (-2, 1): + k = gaussian_rbf(np.array([[x1_example]]), np.array([[landmark]]), gamma) + print("Phi({}, {}) = {}".format(x1_example, landmark, k)) + +rbf_kernel_svm_clf = Pipeline([ + ("scaler", StandardScaler()), + ("svm_clf", SVC(kernel="rbf", gamma=5, C=0.001)) + ]) +rbf_kernel_svm_clf.fit(X, y) + + +from sklearn.svm import SVC + +gamma1, gamma2 = 0.1, 5 +C1, C2 = 0.001, 1000 +hyperparams = (gamma1, C1), (gamma1, C2), (gamma2, C1), (gamma2, C2) + +svm_clfs = [] +for gamma, C in hyperparams: + rbf_kernel_svm_clf = Pipeline([ + ("scaler", StandardScaler()), + ("svm_clf", SVC(kernel="rbf", gamma=gamma, C=C)) + ]) + rbf_kernel_svm_clf.fit(X, y) + svm_clfs.append(rbf_kernel_svm_clf) + +plt.figure(figsize=(11, 7)) + +for i, svm_clf in enumerate(svm_clfs): + plt.subplot(221 + i) + plot_predictions(svm_clf, [-1.5, 2.5, -1, 1.5]) + plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) + gamma, C = hyperparams[i] + plt.title(r"$\gamma = {}, C = {}$".format(gamma, C), fontsize=16) + +plt.show() + +## Mathematical optimization of convex functions + +A mathematical (quadratic) optimization problem, or just optimization problem, has the form + +$$ +\begin{align*} + &\mathrm{min}_{\lambda}\hspace{0.2cm} \frac{1}{2}\boldsymbol{\lambda}^T\boldsymbol{P}\boldsymbol{\lambda}+\boldsymbol{q}^T\boldsymbol{\lambda},\\ \nonumber + &\mathrm{subject\hspace{0.1cm}to} \hspace{0.2cm} \boldsymbol{G}\boldsymbol{\lambda} \preceq \boldsymbol{h} \wedge \boldsymbol{A}\boldsymbol{\lambda}=f. +\end{align*} +$$ + +subject to some constraints for say a selected set $i=1,2,\dots, n$. +In our case we are optimizing with respect to the Lagrangian multipliers $\lambda_i$, and the +vector $\boldsymbol{\lambda}=[\lambda_1, \lambda_2,\dots, \lambda_n]$ is the optimization variable we are dealing with. + +In our case we are particularly interested in a class of optimization problems called convex optmization problems. +In our discussion on gradient descent methods we discussed at length the definition of a convex function. + +Convex optimization problems play a central role in applied mathematics and we recommend strongly [Boyd and Vandenberghe's text on the topics](http://web.stanford.edu/~boyd/cvxbook/). + + + + +## How do we solve these problems? + +If we use Python as programming language and wish to venture beyond +**scikit-learn**, **tensorflow** and similar software which makes our +lives so much easier, we need to dive into the wonderful world of +quadratic programming. We can, if we wish, solve the minimization +problem using say standard gradient methods or conjugate gradient +methods. However, these methods tend to exhibit a rather slow +converge. So, welcome to the promised land of quadratic programming. + +The functions we need are contained in the quadratic programming package **CVXOPT** and we need to import it together with **numpy** as + +import numpy +import cvxopt + +This will make our life much easier. You don't need t write your own optimizer. + + + +## A simple example + +We remind ourselves about the general problem we want to solve + +$$ +\begin{align*} + &\mathrm{min}_{x}\hspace{0.2cm} \frac{1}{2}\boldsymbol{x}^T\boldsymbol{P}\boldsymbol{x}+\boldsymbol{q}^T\boldsymbol{x},\\ \nonumber + &\mathrm{subject\hspace{0.1cm} to} \hspace{0.2cm} \boldsymbol{G}\boldsymbol{x} \preceq \boldsymbol{h} \wedge \boldsymbol{A}\boldsymbol{x}=f. +\end{align*} +$$ + +Let us show how to perform the optmization using a simple case. Assume we want to optimize the following problem + +$$ +\begin{align*} + &\mathrm{min}_{x}\hspace{0.2cm} \frac{1}{2}x^2+5x+3y \\ \nonumber + &\mathrm{subject to} \\ \nonumber + &x, y \geq 0 \\ \nonumber + &x+3y \geq 15 \\ \nonumber + &2x+5y \leq 100 \\ \nonumber + &3x+4y \leq 80. \\ \nonumber +\end{align*} +$$ + +The minimization problem can be rewritten in terms of vectors and matrices as (with $x$ and $y$ being the unknowns) + +$$ +\frac{1}{2}\begin{bmatrix} x\\ y \end{bmatrix}^T \begin{bmatrix} 1 & 0\\ 0 & 0 \end{bmatrix} \begin{bmatrix} x \\ y \end{bmatrix} + \begin{bmatrix}3\\ 4 \end{bmatrix}^T \begin{bmatrix}x \\ y \end{bmatrix}. +$$ + +Similarly, we can now set up the inequalities (we need to change $\geq$ to $\leq$ by multiplying with $-1$ on bot sides) as the following matrix-vector equation + +$$ +\begin{bmatrix} -1 & 0 \\ 0 & -1 \\ -1 & -3 \\ 2 & 5 \\ 3 & 4\end{bmatrix}\begin{bmatrix} x \\ y\end{bmatrix} \preceq \begin{bmatrix}0 \\ 0\\ -15 \\ 100 \\ 80\end{bmatrix}. +$$ + +We have collapsed all the inequalities into a single matrix $\boldsymbol{G}$. We see also that our matrix + +$$ +\boldsymbol{P} =\begin{bmatrix} 1 & 0\\ 0 & 0 \end{bmatrix} +$$ + +is clearly positive semi-definite (all eigenvalues larger or equal zero). +Finally, the vector $\boldsymbol{h}$ is defined as + +$$ +\boldsymbol{h} = \begin{bmatrix}0 \\ 0\\ -15 \\ 100 \\ 80\end{bmatrix}. +$$ + +Since we don't have any equalities the matrix $\boldsymbol{A}$ is set to zero +The following code solves the equations for us + +# Import the necessary packages +import numpy +from cvxopt import matrix +from cvxopt import solvers +P = matrix(numpy.diag([1,0]), tc=’d’) +q = matrix(numpy.array([3,4]), tc=’d’) +G = matrix(numpy.array([[-1,0],[0,-1],[-1,-3],[2,5],[3,4]]), tc=’d’) +h = matrix(numpy.array([0,0,-15,100,80]), tc=’d’) +# Construct the QP, invoke solver +sol = solvers.qp(P,q,G,h) +# Extract optimal value and solution +sol[’x’] +sol[’primal objective’] + +## Back to the more realistic cases + +We are now ready to return to our setup of the optmization problem for a more realistic case. Introducing the **slack** parameter $C$ we have + +$$ +\frac{1}{2} \boldsymbol{\lambda}^T\begin{bmatrix} y_1y_1K(\boldsymbol{x}_1,\boldsymbol{x}_1) & y_1y_2K(\boldsymbol{x}_1,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_1,\boldsymbol{x}_n) \\ +y_2y_1K(\boldsymbol{x}_2,\boldsymbol{x}_1) & y_2y_2K(\boldsymbol{x}_2,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_2,\boldsymbol{x}_n) \\ +\dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots \\ +y_ny_1K(\boldsymbol{x}_n,\boldsymbol{x}_1) & y_ny_2K(\boldsymbol{x}_n\boldsymbol{x}_2) & \dots & \dots & y_ny_nK(\boldsymbol{x}_n,\boldsymbol{x}_n) \\ +\end{bmatrix}\boldsymbol{\lambda}-\mathbb{I}\boldsymbol{\lambda}, +$$ + +subject to $\boldsymbol{y}^T\boldsymbol{\lambda}=0$. Here we defined the vectors $\boldsymbol{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]$ and +$\boldsymbol{y}=[y_1,y_2,\dots,y_n]$. +With the slack constants this leads to the additional constraint $0\leq \lambda_i \leq C$. + +**code will be added** \ No newline at end of file diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter7_109_0.png b/doc/src/LectureNotes/_build/jupyter_execute/chapter7_109_0.png new file mode 100644 index 0000000000000000000000000000000000000000..7188f63c716bd8b792d796a137e0e05c49aa433d GIT binary patch literal 5957 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 literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_0.png b/doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_0.png new file mode 100644 index 0000000000000000000000000000000000000000..659dee5956ab4de9ac41a3608e2b2cf1610b7f79 GIT binary patch literal 8229 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 X4*85Mw`~TtL7}}>Q~{SMn0)$QV{{R? literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_3.png b/doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_3.png new file mode 100644 index 0000000000000000000000000000000000000000..268924deaf59cdaf4c5a2bc13a951bad24625c5e GIT binary patch literal 23008 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 PW(rMpm|Cf-Y2g0=k;S;e literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_4.png b/doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_4.png new file mode 100644 index 0000000000000000000000000000000000000000..88bb051f73e3e42c0819b0ca42fba5c4ed1d8ca1 GIT binary patch literal 28808 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

    MJz-5;#A84098bgKWSM(@G5 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 G;C}&&U%;OL literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_6.png b/doc/src/LectureNotes/_build/jupyter_execute/chapter7_129_6.png new file mode 100644 index 0000000000000000000000000000000000000000..34cab365c5e1a292182ec4525688bfe754750901 GIT binary patch literal 53123 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 ?l1VGWSM>svDwr9qa_OGV#|7*Pg>ffe=| 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 dk6&}&gQ5IbX6 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%0AfROa&nRdoajN=@mYfF$juLvwS>EaWzKgY%nv6T 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 literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter8.ipynb b/doc/src/LectureNotes/_build/jupyter_execute/chapter8.ipynb new file mode 100644 index 000000000..3df8759dd --- /dev/null +++ b/doc/src/LectureNotes/_build/jupyter_execute/chapter8.ipynb @@ -0,0 +1,2404 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Dimensionality Reduction\n", + "\n", + "\n", + "## Reducing the number of degrees of freedom, overarching view\n", + "\n", + "Many Machine Learning problems involve thousands or even millions of\n", + "features for each training instance. Not only does this make training\n", + "extremely slow, it can also make it much harder to find a good\n", + "solution, as we will see. This problem is often referred to as the\n", + "curse of dimensionality. Fortunately, in real-world problems, it is\n", + "often possible to reduce the number of features considerably, turning\n", + "an intractable problem into a tractable one.\n", + "\n", + "Here we will discuss some of the most popular dimensionality reduction\n", + "techniques: the principal component analysis (PCA), Kernel PCA, and\n", + "Locally Linear Embedding (LLE). Furthermore, we will start by looking\n", + "at some simple preprocessing of the data which allow us to rescale the\n", + "data.\n", + "\n", + "Principal component analysis and its various variants deal with the\n", + "problem of fitting a low-dimensional [affine\n", + "subspace](https://en.wikipedia.org/wiki/Affine_space) to a set of of\n", + "data points in a high-dimensional space. With its family of methods it\n", + "is one of the most used tools in data modeling, compression and\n", + "visualization.\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Preprocessing our data\n", + "\n", + "Before we proceed however, we will discuss how to preprocess our\n", + "data. Till now and in connection with our previous examples we have\n", + "not met so many cases where we are too sensitive to the scaling of our\n", + "data. Normally the data may need a rescaling and/or may be sensitive\n", + "to extreme values. Scaling the data renders our inputs much more\n", + "suitable for the algorithms we want to employ.\n", + "\n", + "**Scikit-Learn** has several functions which allow us to rescale the\n", + "data, normally resulting in much better results in terms of various\n", + "accuracy scores. The **StandardScaler** function in **Scikit-Learn**\n", + "ensures that for each feature/predictor we study the mean value is\n", + "zero and the variance is one (every column in the design/feature\n", + "matrix). This scaling has the drawback that it does not ensure that\n", + "we have a particular maximum or minimum in our data set. Another\n", + "function included in **Scikit-Learn** is the **MinMaxScaler** which\n", + "ensures that all features are exactly between $0$ and $1$. The\n", + "\n", + "\n", + "## More preprocessing\n", + "\n", + "\n", + "The **Normalizer** scales each data\n", + "point such that the feature vector has a euclidean length of one. In other words, it\n", + "projects a data point on the circle (or sphere in the case of higher dimensions) with a\n", + "radius of 1. This means every data point is scaled by a different number (by the\n", + "inverse of it’s length).\n", + "This normalization is often used when only the direction (or angle) of the data matters,\n", + "not the length of the feature vector.\n", + "\n", + "The **RobustScaler** works similarly to the StandardScaler in that it\n", + "ensures statistical properties for each feature that guarantee that\n", + "they are on the same scale. However, the RobustScaler uses the median\n", + "and quartiles, instead of mean and variance. This makes the\n", + "RobustScaler ignore data points that are very different from the rest\n", + "(like measurement errors). These odd data points are also called\n", + "outliers, and might often lead to trouble for other scaling\n", + "techniques.\n", + "\n", + "\n", + "\n", + "\n", + "## Simple preprocessing examples, Franke function and regression" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "MSE before scaling: 0.01\n", + "R2 score before scaling 0.93\n", + "Feature min values before scaling:\n", + " [1.00000000e+00 7.43297505e-04 1.67887686e-04 5.52491181e-07\n", + " 1.24790498e-07 2.81862750e-08 4.10665316e-10 9.27564656e-11\n", + " 2.09507879e-11 4.73212847e-12 3.05246505e-13 6.89456494e-14\n", + " 1.55726683e-14 3.51737928e-15 7.94466097e-16 2.26888965e-16\n", + " 5.12471292e-17 1.15751255e-17 2.61445925e-18 5.90524667e-19\n", + " 1.33381074e-19]\n", + "Feature max values before scaling:\n", + " [1. 0.99422559 0.99481826 0.98848453 0.98907377 0.98966337\n", + " 0.98277662 0.98336246 0.98394865 0.98453519 0.97710167 0.97768412\n", + " 0.97826693 0.97885008 0.97943358 0.97145948 0.97203858 0.97261802\n", + " 0.9731978 0.97377793 0.97435841]\n", + "Feature min values after scaling:\n", + " [ 0. -1.7697784 -1.72415276 -1.14649434 -1.12953807 -1.11320874\n", + " -0.90535485 -0.8968819 -0.88864254 -0.88062733 -0.77069333 -0.76574003\n", + " -0.76089806 -0.7561637 -0.75153337 -0.68210821 -0.6789547 -0.67586334\n", + " -0.67283231 -0.66985986 -0.66694428]\n", + "Feature max values after scaling:\n", + " [0. 1.68453745 1.71039356 2.1618639 2.17707405 2.19168422\n", + " 2.54536814 2.55730765 2.56887875 2.58009023 2.87398064 2.88442648\n", + " 2.89461285 2.90454384 2.91422324 3.16472629 3.17449812 3.18407693\n", + " 3.19346461 3.20266288 3.21167335]\n", + "MSE after scaling: 0.00\n", + "R2 score for scaled data: 0.97\n" + ] + } + ], + "source": [ + "%matplotlib inline\n", + "\n", + "# Common imports\n", + "import os\n", + "import numpy as np\n", + "import pandas as pd\n", + "import matplotlib.pyplot as plt\n", + "import sklearn.linear_model as skl\n", + "from sklearn.metrics import mean_squared_error\n", + "from sklearn.model_selection import train_test_split\n", + "from sklearn.preprocessing import MinMaxScaler, StandardScaler, Normalizer\n", + "from sklearn.svm import SVR\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", + "\n", + "def FrankeFunction(x,y):\n", + "\tterm1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))\n", + "\tterm2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))\n", + "\tterm3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))\n", + "\tterm4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)\n", + "\treturn term1 + term2 + term3 + term4\n", + "\n", + "\n", + "def create_X(x, y, n ):\n", + "\tif len(x.shape) > 1:\n", + "\t\tx = np.ravel(x)\n", + "\t\ty = np.ravel(y)\n", + "\n", + "\tN = len(x)\n", + "\tl = int((n+1)*(n+2)/2)\t\t# Number of elements in beta\n", + "\tX = np.ones((N,l))\n", + "\n", + "\tfor i in range(1,n+1):\n", + "\t\tq = int((i)*(i+1)/2)\n", + "\t\tfor k in range(i+1):\n", + "\t\t\tX[:,q+k] = (x**(i-k))*(y**k)\n", + "\n", + "\treturn X\n", + "\n", + "\n", + "# Making meshgrid of datapoints and compute Franke's function\n", + "n = 5\n", + "N = 1000\n", + "x = np.sort(np.random.uniform(0, 1, N))\n", + "y = np.sort(np.random.uniform(0, 1, N))\n", + "z = FrankeFunction(x, y)\n", + "X = create_X(x, y, n=n) \n", + "# split in training and test data\n", + "X_train, X_test, y_train, y_test = train_test_split(X,z,test_size=0.2)\n", + "\n", + "\n", + "svm = SVR(gamma='auto',C=10.0)\n", + "svm.fit(X_train, y_train)\n", + "\n", + "# The mean squared error and R2 score\n", + "print(\"MSE before scaling: {:.2f}\".format(mean_squared_error(svm.predict(X_test), y_test)))\n", + "print(\"R2 score before scaling {:.2f}\".format(svm.score(X_test,y_test)))\n", + "\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", + "\n", + "print(\"Feature min values before scaling:\\n {}\".format(X_train.min(axis=0)))\n", + "print(\"Feature max values before scaling:\\n {}\".format(X_train.max(axis=0)))\n", + "\n", + "print(\"Feature min values after scaling:\\n {}\".format(X_train_scaled.min(axis=0)))\n", + "print(\"Feature max values after scaling:\\n {}\".format(X_train_scaled.max(axis=0)))\n", + "\n", + "svm = SVR(gamma='auto',C=10.0)\n", + "svm.fit(X_train_scaled, y_train)\n", + "\n", + "print(\"MSE after scaling: {:.2f}\".format(mean_squared_error(svm.predict(X_test_scaled), y_test)))\n", + "print(\"R2 score for scaled data: {:.2f}\".format(svm.score(X_test_scaled,y_test)))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Simple preprocessing examples, breast cancer data and classification, Support Vector Machines\n", + "\n", + "We show here how we can use a simple regression case on the breast\n", + "cancer data using support vector machines (SVM) as algorithm for\n", + "classification." + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "(426, 30)\n", + "(143, 30)\n", + "Test set accuracy: 0.94\n", + "Feature min values before scaling:\n", + " [6.981e+00 9.710e+00 4.379e+01 1.435e+02 5.263e-02 1.938e-02 0.000e+00\n", + " 0.000e+00 1.060e-01 4.996e-02 1.115e-01 3.628e-01 7.570e-01 7.228e+00\n", + " 1.713e-03 2.252e-03 0.000e+00 0.000e+00 7.882e-03 8.948e-04 7.930e+00\n", + " 1.202e+01 5.041e+01 1.852e+02 7.117e-02 2.729e-02 0.000e+00 0.000e+00\n", + " 1.565e-01 5.504e-02]\n", + "Feature max values before scaling:\n", + " [2.811e+01 3.381e+01 1.885e+02 2.501e+03 1.447e-01 3.114e-01 4.268e-01\n", + " 2.012e-01 3.040e-01 9.744e-02 2.873e+00 4.885e+00 2.198e+01 5.422e+02\n", + " 2.333e-02 1.064e-01 3.960e-01 5.279e-02 6.146e-02 2.984e-02 3.604e+01\n", + " 4.954e+01 2.512e+02 4.254e+03 2.226e-01 1.058e+00 1.252e+00 2.903e-01\n", + " 6.638e-01 2.075e-01]\n", + "Feature min values before scaling:\n", + " [0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0.\n", + " 0. 0. 0. 0. 0. 0.]" + ] + }, + { + "name": "stdout", + "output_type": "stream", + "text": [ + "\n", + "Feature max values before scaling:\n", + " [1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. 1.\n", + " 1. 1. 1. 1. 1. 1.]\n", + "Test set accuracy scaled data with Min-Max scaling: 0.97\n", + "Test set accuracy scaled data with Standar Scaler: 0.96\n" + ] + } + ], + "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", + "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", + "\n", + "svm = SVC(C=100)\n", + "svm.fit(X_train, y_train)\n", + "print(\"Test set accuracy: {:.2f}\".format(svm.score(X_test,y_test)))\n", + "\n", + "from sklearn.preprocessing import MinMaxScaler, StandardScaler\n", + "scaler = MinMaxScaler()\n", + "scaler.fit(X_train)\n", + "X_train_scaled = scaler.transform(X_train)\n", + "X_test_scaled = scaler.transform(X_test)\n", + "\n", + "print(\"Feature min values before scaling:\\n {}\".format(X_train.min(axis=0)))\n", + "print(\"Feature max values before scaling:\\n {}\".format(X_train.max(axis=0)))\n", + "\n", + "print(\"Feature min values before scaling:\\n {}\".format(X_train_scaled.min(axis=0)))\n", + "print(\"Feature max values before scaling:\\n {}\".format(X_train_scaled.max(axis=0)))\n", + "\n", + "\n", + "svm.fit(X_train_scaled, y_train)\n", + "print(\"Test set accuracy scaled data with Min-Max scaling: {:.2f}\".format(svm.score(X_test_scaled,y_test)))\n", + "\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", + "\n", + "svm.fit(X_train_scaled, y_train)\n", + "print(\"Test set accuracy scaled data with Standar Scaler: {:.2f}\".format(svm.score(X_test_scaled,y_test)))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## More on Cancer Data, now with Logistic Regression" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Test set accuracy: 0.95\n", + "Test set accuracy scaled data: 0.96\n" + ] + }, + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/Users/hjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/linear_model/_logistic.py:762: ConvergenceWarning: lbfgs failed to converge (status=1):\n", + "STOP: TOTAL NO. of ITERATIONS REACHED LIMIT.\n", + "\n", + "Increase the number of iterations (max_iter) or scale the data as shown in:\n", + " https://scikit-learn.org/stable/modules/preprocessing.html\n", + "Please also refer to the documentation for alternative solver options:\n", + " https://scikit-learn.org/stable/modules/linear_model.html#logistic-regression\n", + " n_iter_i = _check_optimize_result(\n" + ] + } + ], + "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.linear_model import LogisticRegression\n", + "cancer = load_breast_cancer()\n", + "\n", + "# Set up training data\n", + "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", + "logreg = LogisticRegression()\n", + "logreg.fit(X_train, y_train)\n", + "print(\"Test set accuracy: {:.2f}\".format(logreg.score(X_test,y_test)))\n", + "\n", + "# Scale 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", + "logreg.fit(X_train_scaled, y_train)\n", + "print(\"Test set accuracy scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Why should we think of reducing the dimensionality\n", + "\n", + "In addition to the plot of the features, we study now also the covariance (and the correlation matrix).\n", + "We use also **Pandas** to compute the correlation matrix." + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "data": { + "image/png": "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CixJyysBU4Cd6hFUv1eu4S7HDbr1wtKlS50Y15Ak1lhjDRYsWNDoUKxWqkmmnXibNb1KfyFvSER0JMak+ZXqE5KZ9TUnxrXl62lm1rwqTY5flLRNx4KkbYGXu9jfzMzMzKzpVDqs4qvAnyU9mZbXAfavT0hm1kinXfOfmpZ39Ic26XYfSRx00EGce252C8OyZctYZ5112GGHHbjyyivLHnfDDTdw6qmncuWVV3LFFVdw//33c9xxx9Us9q7MmDGDJ598kj322KNPzmdmZn2jouQ4Iu6QtBmwKdl3G8+OiNfqGplVzmPcrMkNGzaMmTNn8vLLLzN06FCuueYa1ltvvarK2Geffdhnn33qFOHbzZgxg2nTpjk5tsq4nTZrGpUOqwAYC2wFbA0cIOng+oRkZv3R7rvvzt///ncALrjgAg444IA3t91+++3stNNObL311uy000488MADbzv+rLPO4qijjgLg4YcfZty4cYwdO5YTTzyR4cOHA1lP84QJE9hvv/3YbLPNOPDAA+n4rveTTz6ZsWPHssUWW3DEEUe8uX7ChAkce+yxbL/99myyySb861//4tVXX+XEE0/koosuYsyYMVx00UV1vTZmZtZ3KkqOJZ0LnAqMJ0uSxwLb1TEuM+tnPvWpT3HhhReydOlS7rnnHnbYYYc3t2222WbcdNNN3HXXXZx88smccMIJXZY1adIkJk2axB133MG666673La77rqL008/nfvvv59HHnmEm2++GYCjjjqKO+64480e7PxwjmXLlnH77bdz+umn893vfpcVV1yRk08+mf33358ZM2aw//4eZdZQ1/+g9GRm1gOVjjneDnhPVPNb09Z4/hjPmshWW21Fe3s7F1xwwduGKjz//PMccsghPPjgg0jitde6HtU1depULr/8cgA+/elPM3ny5De3bb/99owaNQqAMWPG0N7ezvjx47n++uv58Y9/zEsvvcSzzz7L5ptvzt577w3Af//3fwOw7bbb0t7eXqsqm5lZAVU6rGIm8I56BmJmts8++zB58uTlhlQAfPvb32bnnXdm5syZ/O1vf+vVr/kNHjz4zfkBAwawbNkyli5dyhe/+EUuueQS7r33XiZOnLjcOTqO6djfzMxaV6U9xyOB+yXdDrzSsTIi+u7uF6sd9yhbQR1++OGsssoqbLnlltxwww1vrn/++effvEHvrLPO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\n", + "text/plain": [ + "
    " + ] + }, + "metadata": { + "filenames": { + "image/png": "/Users/hjensen/Teaching/FYS-STK4150/doc/src/LectureNotes/_build/jupyter_execute/chapter8_7_0.png" + }, + "needs_background": "light" + }, + "output_type": "display_data" + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
    " + ] + }, + "metadata": { + "filenames": { + "image/png": "/Users/hjensen/Teaching/FYS-STK4150/doc/src/LectureNotes/_build/jupyter_execute/chapter8_7_1.png" + }, + "needs_background": "light" + }, + "output_type": "display_data" + }, + { + "name": "stdout", + "output_type": "stream", + "text": [ + "[ 1.33026664e+01 5.69238112e+00 2.83259341e+00 1.99126621e+00\n", + " 1.69095941e+00 1.19614372e+00 7.13037918e-01 5.77804918e-01\n", + " 5.14549644e-01 4.30579019e-01 3.58977964e-01 -1.91269450e-01\n", + " 2.86195387e-01 -1.59310961e-01 -1.38483045e-01 2.44786221e-01\n", + " -8.79318674e-02 1.91811329e-01 1.70896266e-01 -7.17683028e-02\n", + " 1.39860289e-01 1.18721828e-01 -4.83194721e-02 8.92983892e-02\n", + " 6.81402316e-02 6.01968016e-02 3.31819744e-02 1.56432255e-02\n", + " -1.61028757e-02 -6.50565973e-03]\n" + ] + } + ], + "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.linear_model import LogisticRegression\n", + "cancer = load_breast_cancer()\n", + "import pandas as pd\n", + "# Making a data frame\n", + "cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)\n", + "\n", + "fig, axes = plt.subplots(15,2,figsize=(10,20))\n", + "malignant = cancer.data[cancer.target == 0]\n", + "benign = cancer.data[cancer.target == 1]\n", + "ax = axes.ravel()\n", + "\n", + "for i in range(30):\n", + " _, bins = np.histogram(cancer.data[:,i], bins =50)\n", + " ax[i].hist(malignant[:,i], bins = bins, alpha = 0.5)\n", + " ax[i].hist(benign[:,i], bins = bins, alpha = 0.5)\n", + " ax[i].set_title(cancer.feature_names[i])\n", + " ax[i].set_yticks(())\n", + "ax[0].set_xlabel(\"Feature magnitude\")\n", + "ax[0].set_ylabel(\"Frequency\")\n", + "ax[0].legend([\"Malignant\", \"Benign\"], loc =\"best\")\n", + "fig.tight_layout()\n", + "plt.show()\n", + "\n", + "import seaborn as sns\n", + "correlation_matrix = cancerpd.corr().round(1)\n", + "# use the heatmap function from seaborn to plot the correlation matrix\n", + "# annot = True to print the values inside the square\n", + "sns.heatmap(data=correlation_matrix, annot=True)\n", + "plt.show()\n", + "\n", + "#print eigvalues of correlation matrix\n", + "EigValues, EigVectors = np.linalg.eig(correlation_matrix)\n", + "print(EigValues)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the above example we note two things. In the first plot we display\n", + "the overlap of benign and malignant tumors as functions of the various\n", + "features in the Wisconsing breast cancer data set. We see that for\n", + "some of the features we can distinguish clearly the benign and\n", + "malignant cases while for other features we cannot. This can point to\n", + "us which features may be of greater interest when we wish to classify\n", + "a benign or not benign tumour.\n", + "\n", + "In the second figure we have computed the so-called correlation\n", + "matrix, which in our case with thirty features becomes a $30\\times 30$\n", + "matrix.\n", + "\n", + "We constructed this matrix using **pandas** via the statements" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and then" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "correlation_matrix = cancerpd.corr().round(1)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Diagonalizing this matrix we can in turn say something about which\n", + "features are of relevance and which are not. But before we proceed we\n", + "need to define covariance and correlation matrices. This leads us to\n", + "the classical Principal Component Analysis (PCA) theorem with\n", + "applications.\n", + "\n", + "\n", + "\n", + "\n", + "## Basic ideas of the Principal Component Analysis (PCA)\n", + "\n", + "The principal component analysis deals with the problem of fitting a\n", + "low-dimensional affine subspace $S$ of dimension $d$ much smaller than\n", + "the totaldimension $D$ of the problem at hand (our data\n", + "set). Mathematically it can be formulated as a statistical problem or\n", + "a geometric problem. In our discussion of the theorem for the\n", + "classical PCA, we will stay with a statistical approach. This is also\n", + "what set the scene historically which for the PCA.\n", + "\n", + "We have a data set defined by a design/feature matrix $\\boldsymbol{X}$ (see below for its definition) \n", + "* Each data point is determined by $p$ extrinsic (measurement) variables\n", + "\n", + "* We may want to ask the following question: Are there fewer intrinsic variables (say $d << p$) that still approximately describe the data?\n", + "\n", + "* If so, these intrinsic variables may tell us something important and finding these intrinsic variables is what dimension reduction methods do. \n", + "\n", + "## Introducing the Covariance and Correlation functions\n", + "\n", + "Before we discuss the PCA theorem, we need to remind ourselves about\n", + "the definition of the covariance and the correlation function. These are quantities \n", + "\n", + "Suppose we have defined two vectors\n", + "$\\hat{x}$ and $\\hat{y}$ with $n$ elements each. The covariance matrix $\\boldsymbol{C}$ is defined as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", + " \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{y}] \\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where for example" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] =\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})(y_i- \\overline{y}).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With this definition and recalling that the variance is defined as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{var}[\\boldsymbol{x}]=\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})^2,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "we can rewrite the covariance matrix as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", + " \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] & \\mathrm{var}[\\boldsymbol{y}] \\\\\n", + " \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The covariance takes values between zero and infinity and may thus\n", + "lead to problems with loss of numerical precision for particularly\n", + "large values. It is common to scale the covariance matrix by\n", + "introducing instead the correlation matrix defined via the so-called\n", + "correlation function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]=\\frac{\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}]}{\\sqrt{\\mathrm{var}[\\boldsymbol{x}] \\mathrm{var}[\\boldsymbol{y}]}}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The correlation function is then given by values $\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]\n", + "\\in [-1,1]$. This avoids eventual problems with too large values. We\n", + "can then define the correlation matrix for the two vectors $\\boldsymbol{x}$\n", + "and $\\boldsymbol{y}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{K}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} 1 & \\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", + " \\mathrm{corr}[\\boldsymbol{y},\\boldsymbol{x}] & 1 \\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the above example this is the function we constructed using **pandas**.\n", + "\n", + "\n", + "## Correlation Function and Design/Feature Matrix\n", + "\n", + "In our derivation of the various regression algorithms like **Ordinary Least Squares** or **Ridge regression**\n", + "we defined the design/feature matrix $\\boldsymbol{X}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{X}=\\begin{bmatrix}\n", + "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", + "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", + "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", + "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", + "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", + "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$, with the predictors/features $p$ refering to the column numbers and the\n", + "entries $n$ being the row elements.\n", + "We can rewrite the design/feature matrix in terms of its column vectors as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{X}=\\begin{bmatrix} \\boldsymbol{x}_0 & \\boldsymbol{x}_1 & \\boldsymbol{x}_2 & \\dots & \\dots & \\boldsymbol{x}_{p-1}\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with a given vector" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{x}_i^T = \\begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \\dots & \\dots x_{n-1,i}\\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With these definitions, we can now rewrite our $2\\times 2$\n", + "correaltion/covariance matrix in terms of a moe general design/feature\n", + "matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$. This leads to a $p\\times p$\n", + "covariance matrix for the vectors $\\boldsymbol{x}_i$ with $i=0,1,\\dots,p-1$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}] = \\begin{bmatrix}\n", + "\\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & \\mathrm{var}[\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & \\mathrm{var}[\\boldsymbol{x}_{p-1}]\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and the correlation matrix" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{K}[\\boldsymbol{x}] = \\begin{bmatrix}\n", + "1 & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & 1 & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & 1 & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & 1\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Covariance Matrix Examples\n", + "\n", + "\n", + "The Numpy function **np.cov** calculates the covariance elements using\n", + "the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have\n", + "the exact mean values. The following simple function uses the\n", + "**np.vstack** function which takes each vector of dimension $1\\times n$\n", + "and produces a $2\\times n$ matrix $\\boldsymbol{W}$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{W} = \\begin{bmatrix} x_0 & y_0 \\\\\n", + " x_1 & y_1 \\\\\n", + " x_2 & y_2\\\\\n", + " \\dots & \\dots \\\\\n", + " x_{n-2} & y_{n-2}\\\\\n", + " x_{n-1} & y_{n-1} & \n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which in turn is converted into into the $2\\times 2$ covariance matrix\n", + "$\\boldsymbol{C}$ via the Numpy function **np.cov()**. We note that we can also calculate\n", + "the mean value of each set of samples $\\boldsymbol{x}$ etc using the Numpy\n", + "function **np.mean(x)**. We can also extract the eigenvalues of the\n", + "covariance matrix through the **np.linalg.eig()** function." + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "0.039184456674535545\n", + "4.128680426693387\n", + "[[ 1.12297057 3.2186233 ]\n", + " [ 3.2186233 10.11517976]]\n" + ] + } + ], + "source": [ + "# Importing various packages\n", + "import numpy as np\n", + "n = 100\n", + "x = np.random.normal(size=n)\n", + "print(np.mean(x))\n", + "y = 4+3*x+np.random.normal(size=n)\n", + "print(np.mean(y))\n", + "W = np.vstack((x, y))\n", + "C = np.cov(W)\n", + "print(C)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Correlation Matrix\n", + "\n", + "The previous example can be converted into the correlation matrix by\n", + "simply scaling the matrix elements with the variances. We should also\n", + "subtract the mean values for each column. This leads to the following\n", + "code which sets up the correlations matrix for the previous example in\n", + "a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the $2\\times 2$ correlation matrix (since we have only two vectors)." + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "0.08474873038505544\n", + "1.7239002399681738\n", + "[[1. 0.62968416]\n", + " [0.62968416 1. ]]\n" + ] + } + ], + "source": [ + "import numpy as np\n", + "n = 100\n", + "# define two vectors \n", + "x = np.random.random(size=n)\n", + "y = 4+3*x+np.random.normal(size=n)\n", + "#scaling the x and y vectors \n", + "x = x - np.mean(x)\n", + "y = y - np.mean(y)\n", + "variance_x = np.sum(x@x)/n\n", + "variance_y = np.sum(y@y)/n\n", + "print(variance_x)\n", + "print(variance_y)\n", + "cov_xy = np.sum(x@y)/n\n", + "cov_xx = np.sum(x@x)/n\n", + "cov_yy = np.sum(y@y)/n\n", + "C = np.zeros((2,2))\n", + "C[0,0]= cov_xx/variance_x\n", + "C[1,1]= cov_yy/variance_y\n", + "C[0,1]= cov_xy/np.sqrt(variance_y*variance_x)\n", + "C[1,0]= C[0,1]\n", + "print(C)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We see that the matrix elements along the diagonal are one as they\n", + "should be and that the matrix is symmetric. Furthermore, diagonalizing\n", + "this matrix we easily see that it is a positive definite matrix.\n", + "\n", + "The above procedure with **numpy** can be made more compact if we use **pandas**.\n", + "\n", + "\n", + "## Correlation Matrix with Pandas\n", + "\n", + "We whow here how we can set up the correlation matrix using **pandas**, as done in this simple code" + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "[[ 0.29439863 1.90169666]\n", + " [ 1.67736015 3.10465335]\n", + " [-0.55604865 -0.71001501]\n", + " [-0.86385893 -3.79843757]\n", + " [-0.32231733 0.0602184 ]\n", + " [-1.30134141 -3.01442901]\n", + " [-0.46095356 0.49571687]\n", + " [ 0.83524925 1.94721304]\n", + " [-0.41069583 -1.37424606]\n", + " [ 1.10820768 1.38762934]]\n", + " 0 1\n", + "0 0.294399 1.901697\n", + "1 1.677360 3.104653\n", + "2 -0.556049 -0.710015\n", + "3 -0.863859 -3.798438\n", + "4 -0.322317 0.060218\n", + "5 -1.301341 -3.014429\n", + "6 -0.460954 0.495717\n", + "7 0.835249 1.947213\n", + "8 -0.410696 -1.374246\n", + "9 1.108208 1.387629\n", + " 0 1\n", + "0 1.000000 0.883341\n", + "1 0.883341 1.000000\n" + ] + } + ], + "source": [ + "import numpy as np\n", + "import pandas as pd\n", + "n = 10\n", + "x = np.random.normal(size=n)\n", + "x = x - np.mean(x)\n", + "y = 4+3*x+np.random.normal(size=n)\n", + "y = y - np.mean(y)\n", + "X = (np.vstack((x, y))).T\n", + "print(X)\n", + "Xpd = pd.DataFrame(X)\n", + "print(Xpd)\n", + "correlation_matrix = Xpd.corr()\n", + "print(correlation_matrix)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We expand this model to the Franke function discussed above.\n", + "\n", + "\n", + "## Correlation Matrix with Pandas and the Franke function" + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + " 0 1 2 3 4 5 6 7 \\\n", + "0 0.0 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 \n", + "1 0.0 0.088096 0.086427 0.083845 0.082640 0.081425 0.073689 0.072606 \n", + "2 0.0 0.086427 0.085149 0.082400 0.081356 0.080291 0.072444 0.071452 \n", + "3 0.0 0.083845 0.082400 0.085937 0.084688 0.083422 0.079032 0.077855 \n", + "4 0.0 0.082640 0.081356 0.084688 0.083531 0.082352 0.077865 0.076753 \n", + "5 0.0 0.081425 0.080291 0.083422 0.082352 0.081256 0.076682 0.075632 \n", + "6 0.0 0.073689 0.072444 0.079032 0.077865 0.076682 0.074903 0.073780 \n", + "7 0.0 0.072606 0.071452 0.077855 0.076753 0.075632 0.073780 0.072708 \n", + "8 0.0 0.071547 0.070480 0.076701 0.075660 0.074600 0.072677 0.071655 \n", + "9 0.0 0.070513 0.069529 0.075570 0.074589 0.073587 0.071595 0.070622 \n", + "10 0.0 0.064543 0.063450 0.071358 0.070294 0.069218 0.069100 0.068064 \n", + "11 0.0 0.063581 0.062551 0.070288 0.069275 0.068248 0.068065 0.067072 \n", + "12 0.0 0.062646 0.061677 0.069247 0.068283 0.067304 0.067057 0.066105 \n", + "13 0.0 0.061738 0.060828 0.068235 0.067318 0.066385 0.066075 0.065164 \n", + "14 0.0 0.060857 0.060003 0.067250 0.066378 0.065490 0.065119 0.064247 \n", + "\n", + " 8 9 10 11 12 13 14 \n", + "0 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 \n", + "1 0.071547 0.070513 0.064543 0.063581 0.062646 0.061738 0.060857 \n", + "2 0.070480 0.069529 0.063450 0.062551 0.061677 0.060828 0.060003 \n", + "3 0.076701 0.075570 0.071358 0.070288 0.069247 0.068235 0.067250 \n", + "4 0.075660 0.074589 0.070294 0.069275 0.068283 0.067318 0.066378 \n", + "5 0.074600 0.073587 0.069218 0.068248 0.067304 0.066385 0.065490 \n", + "6 0.072677 0.071595 0.069100 0.068065 0.067057 0.066075 0.065119 \n", + "7 0.071655 0.070622 0.068064 0.067072 0.066105 0.065164 0.064247 \n", + "8 0.070650 0.069664 0.067046 0.066096 0.065170 0.064268 0.063389 \n", + "9 0.069664 0.068722 0.066047 0.065138 0.064251 0.063387 0.062545 \n", + "10 0.067046 0.066047 0.064786 0.063821 0.062880 0.061964 0.061071 \n", + "11 0.066096 0.065138 0.063821 0.062893 0.061989 0.061108 0.060249 \n", + "12 0.065170 0.064251 0.062880 0.061989 0.061120 0.060273 0.059447 \n", + "13 0.064268 0.063387 0.061964 0.061108 0.060273 0.059458 0.058665 \n", + "14 0.063389 0.062545 0.061071 0.060249 0.059447 0.058665 0.057901 \n" + ] + } + ], + "source": [ + "# Common imports\n", + "import numpy as np\n", + "import pandas as pd\n", + "\n", + "\n", + "def FrankeFunction(x,y):\n", + "\tterm1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))\n", + "\tterm2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))\n", + "\tterm3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))\n", + "\tterm4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)\n", + "\treturn term1 + term2 + term3 + term4\n", + "\n", + "\n", + "def create_X(x, y, n ):\n", + "\tif len(x.shape) > 1:\n", + "\t\tx = np.ravel(x)\n", + "\t\ty = np.ravel(y)\n", + "\n", + "\tN = len(x)\n", + "\tl = int((n+1)*(n+2)/2)\t\t# Number of elements in beta\n", + "\tX = np.ones((N,l))\n", + "\n", + "\tfor i in range(1,n+1):\n", + "\t\tq = int((i)*(i+1)/2)\n", + "\t\tfor k in range(i+1):\n", + "\t\t\tX[:,q+k] = (x**(i-k))*(y**k)\n", + "\n", + "\treturn X\n", + "\n", + "\n", + "# Making meshgrid of datapoints and compute Franke's function\n", + "n = 4\n", + "N = 100\n", + "x = np.sort(np.random.uniform(0, 1, N))\n", + "y = np.sort(np.random.uniform(0, 1, N))\n", + "z = FrankeFunction(x, y)\n", + "X = create_X(x, y, n=n) \n", + "\n", + "Xpd = pd.DataFrame(X)\n", + "# subtract the mean values and set up the covariance matrix\n", + "Xpd = Xpd - Xpd.mean()\n", + "covariance_matrix = Xpd.cov()\n", + "print(covariance_matrix)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We note here that the covariance is zero for the first rows and\n", + "columns since all matrix elements in the design matrix were set to one\n", + "(we are fitting the function in terms of a polynomial of degree $n$).\n", + "\n", + "This means that the variance for these elements will be zero and will\n", + "cause problems when we set up the correlation matrix. We can simply\n", + "drop these elements and construct a correlation\n", + "matrix without these elements. \n", + "\n", + "\n", + "\n", + "## Rewriting the Covariance and/or Correlation Matrix\n", + "\n", + "We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix $\\boldsymbol{X}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}\\boldsymbol{X}^T= \\mathbb{E}[\\boldsymbol{X}\\boldsymbol{X}^T].\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "To see this let us simply look at a design matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{2\\times 2}$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{X}=\\begin{bmatrix}\n", + "x_{00} & x_{01}\\\\\n", + "x_{10} & x_{11}\\\\\n", + "\\end{bmatrix}=\\begin{bmatrix}\n", + "\\boldsymbol{x}_{0} & \\boldsymbol{x}_{1}\\\\\n", + "\\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If we then compute the expectation value" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbb{E}[\\boldsymbol{X}\\boldsymbol{X}^T] = \\frac{1}{n}\\boldsymbol{X}\\boldsymbol{X}^T=\\begin{bmatrix}\n", + "x_{00}^2+x_{01}^2 & x_{00}x_{10}+x_{01}x_{11}\\\\\n", + "x_{10}x_{00}+x_{11}x_{01} & x_{10}^2+x_{11}^2\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which is just" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]=\\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] \\\\\n", + " \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] \\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where we wrote $$\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]$$ to indicate that this the covariance of the vectors $\\boldsymbol{x}$ of the design/feature matrix $\\boldsymbol{X}$.\n", + "\n", + "It is easy to generalize this to a matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$.\n", + "\n", + "\n", + "\n", + "## Towards the PCA theorem\n", + "\n", + "We have that the covariance matrix (the correlation matrix involves a simple rescaling) is given as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}\\boldsymbol{X}^T= \\mathbb{E}[\\boldsymbol{X}\\boldsymbol{X}^T].\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Let us now assume that we can perform a series of orthogonal transformations where we employ some orthogonal matrices $\\boldsymbol{S}$.\n", + "These matrices are defined as $\\boldsymbol{S}\\in {\\mathbb{R}}^{p\\times p}$ and obey the orthogonality requirements $\\boldsymbol{S}\\boldsymbol{S}^T=\\boldsymbol{S}^T\\boldsymbol{S}=\\boldsymbol{I}$. The matrix can be written out in terms of the column vectors $\\boldsymbol{s}_i$ as $\\boldsymbol{S}=[\\boldsymbol{s}_0,\\boldsymbol{s}_1,\\dots,\\boldsymbol{s}_{p-1}]$ and $\\boldsymbol{s}_i \\in {\\mathbb{R}}^{p}$.\n", + "\n", + "Assume also that there is a transformation $\\boldsymbol{S}\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}^T=\\boldsymbol{C}[\\boldsymbol{y}]$ such that the new matrix $\\boldsymbol{C}[\\boldsymbol{y}]$ is diagonal with elements $[\\lambda_0,\\lambda_1,\\lambda_2,\\dots,\\lambda_{p-1}]$. \n", + "\n", + "That is we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{y}] = \\mathbb{E}[\\boldsymbol{S}\\boldsymbol{X}\\boldsymbol{X}^T\\boldsymbol{S}^T]=\\boldsymbol{S}\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}^T,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "since the matrix $\\boldsymbol{S}$ is not a data dependent matrix. Multiplying with $\\boldsymbol{S}^T$ from the left we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{S}^T\\boldsymbol{C}[\\boldsymbol{y}] = \\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}^T,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and since $\\boldsymbol{C}[\\boldsymbol{y}]$ is diagonal we have for a given eigenvalue $i$ of the covariance matrix that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{S}^T_i\\lambda_i = \\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}^T_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the derivation of the PCA theorem we will assume that the eigenvalues are ordered in descending order, that is\n", + "$\\lambda_0 > \\lambda_1 > \\dots > \\lambda_{p-1}$. \n", + "\n", + "\n", + "The eigenvalues tell us then how much we need to stretch the\n", + "corresponding eigenvectors. Dimensions with large eigenvalues have\n", + "thus large variations (large variance) and define therefore useful\n", + "dimensions. The data points are more spread out in the direction of\n", + "these eigenvectors. Smaller eigenvalues mean on the other hand that\n", + "the corresponding eigenvectors are shrunk accordingly and the data\n", + "points are tightly bunched together and there is not much variation in\n", + "these specific directions. Hopefully then we could leave it out\n", + "dimensions where the eigenvalues are very small. If $p$ is very large,\n", + "we could then aim at reducing $p$ to $l << p$ and handle only $l$\n", + "features/predictors.\n", + "\n", + "\n", + "## The Algorithm before theorem\n", + "\n", + "Here's how we would proceed in setting up the algorithm for the PCA, see also discussion below here. \n", + "* Set up the datapoints for the design/feature matrix $\\boldsymbol{X}$ with $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$, with the predictors/features $p$ referring to the column numbers and the entries $n$ being the row elements." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{X}=\\begin{bmatrix}\n", + "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", + "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", + "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", + "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", + "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", + "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "* Center the data by subtracting the mean value for each column. This leads to a new matrix $\\boldsymbol{X}\\rightarrow \\overline{\\boldsymbol{X}}$.\n", + "\n", + "* Compute then the covariance/correlation matrix $\\mathbb{E}[\\overline{\\boldsymbol{X}}\\overline{\\boldsymbol{X}}^T]$.\n", + "\n", + "* Find the eigenpairs of $\\boldsymbol{C}$ with eigenvalues $[\\lambda_0,\\lambda_1,\\dots,\\lambda_{p-1}]$ and eigenvectors $[\\boldsymbol{s}_0,\\boldsymbol{s}_1,\\dots,\\boldsymbol{s}_{p-1}]$.\n", + "\n", + "* Order the eigenvalue (and the eigenvectors accordingly) in order of decreasing eigenvalues.\n", + "\n", + "* Keep only those $l$ eigenvalues larger than a selected threshold value, discarding thus $p-l$ features since we expect small variations in the data here.\n", + "\n", + "## Writing our own PCA code\n", + "\n", + "We will use a simple example first with two-dimensional data\n", + "drawn from a multivariate normal distribution with the following mean and covariance matrix:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mu = (-1,2) \\qquad \\Sigma = \\begin{bmatrix} 4 & 2 \\\\\n", + "2 & 2\n", + "\\end{bmatrix}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that the mean refers to each column of data. \n", + "We will generate $n = 1000$ points $X = \\{ x_1, \\ldots, x_N \\}$ from\n", + "this distribution, and store them in the $1000 \\times 2$ matrix $\\boldsymbol{X}$.\n", + "\n", + "The following Python code aids in setting up the data and writing out the design matrix.\n", + "Note that the function **multivariate** returns also the covariance discussed above and that it is defined by dividing by $n-1$ instead of $n$." + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import pandas as pd\n", + "import matplotlib.pyplot as plt\n", + "from IPython.display import display\n", + "n = 10000\n", + "mean = (-1, 2)\n", + "cov = [[4, 2], [2, 2]]\n", + "X = np.random.multivariate_normal(mean, cov, n)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now we are going to implement the PCA algorithm. We will break it down into various substeps.\n", + "\n", + "### Compute the sample mean and center the data\n", + "\n", + "The first step of PCA is to compute the sample mean of the data and use it to center the data. Recall that the sample mean is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mu_n = \\frac{1}{n} \\sum_{i=1}^n x_i\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and the mean-centered data $\\bar{X} = \\{ \\bar{x}_1, \\ldots, \\bar{x}_n \\}$ takes the form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\bar{x}_i = x_i - \\mu_n.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "When you are done with these steps, print out $\\mu_n$ to verify it is\n", + "close to $\\mu$ and plot your mean centered data to verify it is\n", + "centered at the origin! Compare your code with the functionality from **Scikit-Learn** discussed above.\n", + "The following code elements perform these operations using **pandas** or using our own functionality for doing so. The latter, using **numpy** is rather simple through the **mean()** function." + ] + }, + { + "cell_type": "code", + "execution_count": 12, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "df = pd.DataFrame(X)\n", + "# Pandas does the centering for us\n", + "df = df -df.mean()\n", + "# we center it ourselves\n", + "X_centered = X - X.mean(axis=0)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Alternatively, we could use the functions we discussed\n", + "earlier for scaling the data set. That is, we could have used the\n", + "**StandardScaler** function in **Scikit-Learn**, a function which ensures\n", + "that for each feature/predictor we study the mean value is zero and\n", + "the variance is one (every column in the design/feature matrix). You\n", + "would then not get the same results, since we divide by the\n", + "variance. The diagonal covariance matrix elements will then be one,\n", + "while the non-diagonal ones need to be divided by $2\\sqrt{2}$ for our\n", + "specific case.\n", + "\n", + "### Compute the sample covariance\n", + "\n", + "Now we are going to use the mean centered data to compute the sample covariance of the data by using the following equation" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\Sigma_n = \\frac{1}{n-1} \\sum_{i=1}^n \\bar{x}_i^T \\bar{x}_i = \\frac{1}{n-1} \\sum_{i=1}^n (x_i - \\mu_n)^T (x_i - \\mu_n)\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where the data points $x_i \\in \\mathbb{R}^p$ (here in this example $p = 2$) are column vectors and $x^T$ is the transpose of $x$.\n", + "We can write our own code or simply use either the functionaly of **numpy** or that of **pandas**, as follows" + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + " 0 1\n", + "0 4.050693 2.010827\n", + "1 2.010827 1.974163\n", + "[[4.050693 2.01082738]\n", + " [2.01082738 1.97416255]]\n" + ] + } + ], + "source": [ + "print(df.cov())\n", + "print(np.cov(X_centered.T))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that the way we define the covariance matrix here has a factor $n-1$ instead of $n$. This is included in the **cov()** function by **numpy** and **pandas**. \n", + "Our own code here is not very elegant and asks for obvious improvements. It is tailored to this specific $2\\times 2$ covariance matrix." + ] + }, + { + "cell_type": "code", + "execution_count": 14, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Centered covariance using own code\n", + "[[4.050693 2.01082738]\n", + " [2.01082738 1.97416255]]\n" + ] + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
    " + ] + }, + "metadata": { + "filenames": { + "image/png": "/Users/hjensen/Teaching/FYS-STK4150/doc/src/LectureNotes/_build/jupyter_execute/chapter8_77_1.png" + }, + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "# extract the relevant columns from the centered design matrix of dim n x 2\n", + "x = X_centered[:,0]\n", + "y = X_centered[:,1]\n", + "Cov = np.zeros((2,2))\n", + "Cov[0,1] = np.sum(x.T@y)/(n-1.0)\n", + "Cov[0,0] = np.sum(x.T@x)/(n-1.0)\n", + "Cov[1,1] = np.sum(y.T@y)/(n-1.0)\n", + "Cov[1,0]= Cov[0,1]\n", + "print(\"Centered covariance using own code\")\n", + "print(Cov)\n", + "plt.plot(x, y, 'x')\n", + "plt.axis('equal')\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Depending on the number of points $n$, we will get results that are close to the covariance values defined above.\n", + "The plot shows how the data are clustered around a line with slope close to one. Is this expected?\n", + "\n", + "### Diagonalize the sample covariance matrix to obtain the principal components\n", + "\n", + "Now we are ready to solve for the principal components! To do so we\n", + "diagonalize the sample covariance matrix $\\Sigma$. We can use the\n", + "function **np.linalg.eig** to do so. It will return the eigenvalues and\n", + "eigenvectors of $\\Sigma$. Once we have these we can perform the \n", + "following tasks:\n", + "\n", + "* We compute the percentage of the total variance captured by the first principal component\n", + "\n", + "* We plot the mean centered data and lines along the first and second principal components\n", + "\n", + "* Then we project the mean centered data onto the first and second principal components, and plot the projected data. \n", + "\n", + "* Finally, we approximate the data as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_i \\approx \\tilde{x}_i = \\mu_n + \\langle x_i, v_0 \\rangle v_0\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $v_0$ is the first principal component. \n", + "\n", + "Collecting all these steps we can write our own PCA function and\n", + "compare this with the functionality included in **Scikit-Learn**. \n", + "\n", + "The code here outlines some of the elements we could include in the\n", + "analysis. Feel free to extend upon this in order to address the above\n", + "questions." + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Eigenvalues of Covariance matrix\n", + "5.275483542917728\n", + "0.7493720026008108\n", + "First eigenvector\n", + "[0.85404598 0.52019753]\n", + "Second eigenvector\n", + "[-0.52019753 0.85404598]\n", + "Eigenvector of largest eigenvalue\n", + "[0.85404598 0.52019753]\n" + ] + } + ], + "source": [ + "# diagonalize and obtain eigenvalues, not necessarily sorted\n", + "EigValues, EigVectors = np.linalg.eig(Cov)\n", + "# sort eigenvectors and eigenvalues\n", + "#permute = EigValues.argsort()\n", + "#EigValues = EigValues[permute]\n", + "#EigVectors = EigVectors[:,permute]\n", + "print(\"Eigenvalues of Covariance matrix\")\n", + "for i in range(2):\n", + " print(EigValues[i])\n", + "FirstEigvector = EigVectors[:,0]\n", + "SecondEigvector = EigVectors[:,1]\n", + "print(\"First eigenvector\")\n", + "print(FirstEigvector)\n", + "print(\"Second eigenvector\")\n", + "print(SecondEigvector)\n", + "#thereafter we do a PCA with Scikit-learn\n", + "from sklearn.decomposition import PCA\n", + "pca = PCA(n_components = 2)\n", + "X2Dsl = pca.fit_transform(X)\n", + "print(\"Eigenvector of largest eigenvalue\")\n", + "print(pca.components_.T[:, 0])" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This code does not contain all the above elements, but it shows how we can use **Scikit-Learn** to extract the eigenvector which corresponds to the largest eigenvalue. Try to address the questions we pose before the above code. Try also to change the values of the covariance matrix by making one of the diagonal elements much larger than the other. What do you observe then? \n", + "\n", + "\n", + "## Classical PCA Theorem\n", + "\n", + "We assume now that we have a design matrix $\\boldsymbol{X}$ which has been\n", + "centered as discussed above. For the sake of simplicity we skip the\n", + "overline symbol. The matrix is defined in terms of the various column\n", + "vectors $[\\boldsymbol{x}_0,\\boldsymbol{x}_1,\\dots, \\boldsymbol{x}_{p-1}]$ each with dimension\n", + "$\\boldsymbol{x}\\in {\\mathbb{R}}^{n}$.\n", + "\n", + "We assume also that we have an orthogonal transformation $\\boldsymbol{W}\\in {\\mathbb{R}}^{p\\times p}$. We define the reconstruction error (which is similar to the mean squared error we have seen before) as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{W},\\boldsymbol{Z}) = \\frac{1}{n}\\sum_i (\\boldsymbol{x}_i - \\overline{\\boldsymbol{x}}_i)^2,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $\\overline{\\boldsymbol{x}}_i = \\boldsymbol{W}\\boldsymbol{z}_i$, where $\\boldsymbol{z}_i$ is a row vector with dimension ${\\mathbb{R}}^{n}$ of the matrix\n", + "$\\boldsymbol{Z}\\in{\\mathbb{R}}^{p\\times n}$. When doing PCA we want to reduce this dimensionality. \n", + "\n", + "The PCA theorem states that minimizing the above reconstruction error\n", + "corresponds to setting $\\boldsymbol{W}=\\boldsymbol{S}$, the orthogonal matrix which\n", + "diagonalizes the empirical covariance(correlation) matrix. The optimal\n", + "low-dimensional encoding of the data is then given by a set of vectors\n", + "$\\boldsymbol{z}_i$ with at most $l$ vectors, with $l << p$, defined by the\n", + "orthogonal projection of the data onto the columns spanned by the\n", + "eigenvectors of the covariance(correlations matrix).\n", + "\n", + "The proof which follows will be updated by mid January 2020.\n", + "\n", + "\n", + "## Proof of the PCA Theorem\n", + "\n", + "To show the PCA theorem let us start with the assumption that there is one vector $\\boldsymbol{w}_0$ which corresponds to a solution which minimized the reconstruction error $J$. This is an orthogonal vector. It means that we now approximate the reconstruction error in terms of $\\boldsymbol{w}_0$ and $\\boldsymbol{z}_0$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{w}_0,\\boldsymbol{z}_0)= \\frac{1}{n}\\sum_i (\\boldsymbol{x}_i - z_{i0}\\boldsymbol{w}_0)^2=\\frac{1}{n}\\sum_i (\\boldsymbol{x}_i^T\\boldsymbol{x}_i - 2z_{i0}\\boldsymbol{w}_0^T\\boldsymbol{x}_i+z_{i0}^2\\boldsymbol{w}_0^T\\boldsymbol{w}_0),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which we can rewrite due to the orthogonality of $\\boldsymbol{w}_i$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{w}_0,\\boldsymbol{z}_0)=\\frac{1}{n}\\sum_i (\\boldsymbol{x}_i^T\\boldsymbol{x}_i - 2z_{i0}\\boldsymbol{w}_0^T\\boldsymbol{x}_i+z_{i0}^2).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Minimizing $J$ with respect to the unknown parameters $z_{0i}$ we obtain that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "z_{i0}=\\boldsymbol{w}_0^T\\boldsymbol{x}_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where the vectors on the rhs are known. \n", + "\n", + "\n", + "\n", + "## PCA Proof continued\n", + "\n", + "We have now found the unknown parameters $z_{i0}$. These correspond to the projected coordinates and we can write" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{w}_0)= \\frac{1}{p}\\sum_i (\\boldsymbol{x}_i^T\\boldsymbol{x}_i - z_{i0}^2)=\\mathrm{const}-\\frac{1}{n}\\sum_i z_{i0}^2.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We can show that the variance of the projected coordinates defined by $\\boldsymbol{w}_0^T\\boldsymbol{x}_i$ are given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{var}[\\boldsymbol{w}_0^T\\boldsymbol{x}_i] = \\frac{1}{n}\\sum_i z_{i0}^2,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "since the expectation value of" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbb{E}[\\boldsymbol{w}_0^T\\boldsymbol{x}_i] = \\mathbb{E}[z_{i0}]= \\boldsymbol{w}_0^T\\mathbb{E}[\\boldsymbol{x}_i]=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where we have used the fact that our data are centered.\n", + "\n", + "Recalling our definition of the covariance as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}\\boldsymbol{X}^T=\\mathbb{E}[\\boldsymbol{X}\\boldsymbol{X}^T],\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "we have thus that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{var}[\\boldsymbol{w}_0^T\\boldsymbol{x}_i] = \\frac{1}{n}\\sum_i z_{i0}^2=\\boldsymbol{w}_0^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We are almost there, we have obtained a relation between minimizing\n", + "the reconstruction error and the variance and the covariance\n", + "matrix. Minimizing the error is equivalent to maximizing the variance\n", + "of the projected data.\n", + "\n", + "\n", + "## The final step\n", + "\n", + "We could trivially maximize the variance of the projection (and\n", + "thereby minimize the error in the reconstruction function) by letting\n", + "the norm-2 of $\\boldsymbol{w}_0$ go to infinity. However, this norm since we\n", + "want the matrix $\\boldsymbol{W}$ to be an orthogonal matrix, is constrained by\n", + "$\\vert\\vert \\boldsymbol{w}_0 \\vert\\vert_2^2=1$. Imposing this condition via a\n", + "Lagrange multiplier we can then in turn maximize" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{w}_0)= \\boldsymbol{w}_0^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0+\\lambda_0(1-\\boldsymbol{w}_0^T\\boldsymbol{w}_0).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Taking the derivative with respect to $\\boldsymbol{w}_0$ we obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial J(\\boldsymbol{w}_0)}{\\partial \\boldsymbol{w}_0}= 2\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0-2\\lambda_0\\boldsymbol{w}_0=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "meaning that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0=\\lambda_0\\boldsymbol{w}_0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "**The direction that maximizes the variance (or minimizes the construction error) is an eigenvector of the covariance matrix**! If we left multiply with $\\boldsymbol{w}_0^T$ we have the variance of the projected data is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{w}_0^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0=\\lambda_0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If we want to maximize the variance (minimize the construction error)\n", + "we simply pick the eigenvector of the covariance matrix with the\n", + "largest eigenvalue. This establishes the link between the minimization\n", + "of the reconstruction function $J$ in terms of an orthogonal matrix\n", + "and the maximization of the variance and thereby the covariance of our\n", + "observations encoded in the design/feature matrix $\\boldsymbol{X}$.\n", + "\n", + "The proof\n", + "for the other eigenvectors $\\boldsymbol{w}_1,\\boldsymbol{w}_2,\\dots$ can be\n", + "established by applying the above arguments and using the fact that\n", + "our basis of eigenvectors is orthogonal, see [Murphy chapter\n", + "12.2](https://mitpress.mit.edu/books/machine-learning-1). The\n", + "discussion in chapter 12.2 of Murphy's text has also a nice link with\n", + "the Singular Value Decomposition theorem. For categorical data, see\n", + "chapter 12.4 and discussion therein.\n", + "\n", + "Additional part of the proof for the other eigenvectors will be added by mid January 2020.\n", + "\n", + "\n", + "## Geometric Interpretation and link with Singular Value Decomposition\n", + "\n", + "This material will be added by mid January 2020.\n", + "\n", + "\n", + "\n", + "## Principal Component Analysis\n", + "\n", + "Principal Component Analysis (PCA) is by far the most popular dimensionality reduction algorithm.\n", + "First it identifies the hyperplane that lies closest to the data, and then it projects the data onto it.\n", + "\n", + "The following Python code uses NumPy’s **svd()** function to obtain all the principal components of the\n", + "training set, then extracts the first two principal components. First we center the data using either **pandas** or our own code" + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "data": { + "text/html": [ + "
    \n", + "\n", + "\n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + "
    01234
    0-1.5744650.2591531.1973700.1474000.649382
    10.6895190.137652-1.0257090.210340-0.076938
    2-0.2827270.351636-0.5392611.2166830.340782
    30.070889-0.6148081.074067-0.038300-1.450257
    41.7942821.458078-0.207545-0.442600-0.147420
    51.1123830.6474731.4058900.073598-0.276263
    60.397700-1.526744-0.7120181.2162900.418506
    7-0.2806471.106095-1.646283-0.956563-1.564374
    8-0.369139-0.7516990.051649-0.2131030.967809
    9-1.557795-1.0668370.401842-1.2137431.138775
    \n", + "
    " + ], + "text/plain": [ + " 0 1 2 3 4\n", + "0 -1.574465 0.259153 1.197370 0.147400 0.649382\n", + "1 0.689519 0.137652 -1.025709 0.210340 -0.076938\n", + "2 -0.282727 0.351636 -0.539261 1.216683 0.340782\n", + "3 0.070889 -0.614808 1.074067 -0.038300 -1.450257\n", + "4 1.794282 1.458078 -0.207545 -0.442600 -0.147420\n", + "5 1.112383 0.647473 1.405890 0.073598 -0.276263\n", + "6 0.397700 -1.526744 -0.712018 1.216290 0.418506\n", + "7 -0.280647 1.106095 -1.646283 -0.956563 -1.564374\n", + "8 -0.369139 -0.751699 0.051649 -0.213103 0.967809\n", + "9 -1.557795 -1.066837 0.401842 -1.213743 1.138775" + ] + }, + "metadata": {}, + "output_type": "display_data" + }, + { + "name": "stdout", + "output_type": "stream", + "text": [ + " 0 1 2 3 4\n", + "0 0.0 0.0 0.0 0.0 0.0\n", + "1 0.0 0.0 0.0 0.0 0.0\n", + "2 0.0 0.0 0.0 0.0 0.0\n", + "3 0.0 0.0 0.0 0.0 0.0\n", + "4 0.0 0.0 0.0 0.0 0.0\n", + "5 0.0 0.0 0.0 0.0 0.0\n", + "6 0.0 0.0 0.0 0.0 0.0\n", + "7 0.0 0.0 0.0 0.0 0.0\n", + "8 0.0 0.0 0.0 0.0 0.0\n", + "9 0.0 0.0 0.0 0.0 0.0\n", + "[[-1.5378811 -0.94639099]\n", + " [ 0.86145244 0.89288636]\n", + " [-0.00445655 0.81633628]\n", + " [ 0.07145103 -1.00433417]\n", + " [ 2.03707133 -0.48476997]\n", + " [ 0.72174172 -1.4557763 ]\n", + " [-0.55854694 1.60673226]\n", + " [ 1.6999536 0.43766686]\n", + " [-1.10405456 0.31718909]\n", + " [-2.18673098 -0.17953942]]\n" + ] + } + ], + "source": [ + "import numpy as np\n", + "import pandas as pd\n", + "from IPython.display import display\n", + "np.random.seed(100)\n", + "# setting up a 10 x 5 vanilla matrix \n", + "rows = 10\n", + "cols = 5\n", + "X = np.random.randn(rows,cols)\n", + "df = pd.DataFrame(X)\n", + "# Pandas does the centering for us\n", + "df = df -df.mean()\n", + "display(df)\n", + "\n", + "# we center it ourselves\n", + "X_centered = X - X.mean(axis=0)\n", + "# Then check the difference between pandas and our own set up\n", + "print(X_centered-df)\n", + "#Now we do an SVD\n", + "U, s, V = np.linalg.svd(X_centered)\n", + "c1 = V.T[:, 0]\n", + "c2 = V.T[:, 1]\n", + "W2 = V.T[:, :2]\n", + "X2D = X_centered.dot(W2)\n", + "print(X2D)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "PCA assumes that the dataset is centered around the origin. Scikit-Learn’s PCA classes take care of centering\n", + "the data for you. However, if you implement PCA yourself (as in the preceding example), or if you use other libraries, don’t\n", + "forget to center the data first.\n", + "\n", + "Once you have identified all the principal components, you can reduce the dimensionality of the dataset\n", + "down to $d$ dimensions by projecting it onto the hyperplane defined by the first $d$ principal components.\n", + "Selecting this hyperplane ensures that the projection will preserve as much variance as possible." + ] + }, + { + "cell_type": "code", + "execution_count": 17, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "W2 = V.T[:, :2]\n", + "X2D = X_centered.dot(W2)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## PCA and scikit-learn\n", + "\n", + "Scikit-Learn’s PCA class implements PCA using SVD decomposition just like we did before. The\n", + "following code applies PCA to reduce the dimensionality of the dataset down to two dimensions (note\n", + "that it automatically takes care of centering the data):" + ] + }, + { + "cell_type": "code", + "execution_count": 18, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "[[ 1.5378811 -0.94639099]\n", + " [-0.86145244 0.89288636]\n", + " [ 0.00445655 0.81633628]\n", + " [-0.07145103 -1.00433417]\n", + " [-2.03707133 -0.48476997]\n", + " [-0.72174172 -1.4557763 ]\n", + " [ 0.55854694 1.60673226]\n", + " [-1.6999536 0.43766686]\n", + " [ 1.10405456 0.31718909]\n", + " [ 2.18673098 -0.17953942]]\n" + ] + } + ], + "source": [ + "#thereafter we do a PCA with Scikit-learn\n", + "from sklearn.decomposition import PCA\n", + "pca = PCA(n_components = 2)\n", + "X2D = pca.fit_transform(X)\n", + "print(X2D)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "After fitting the PCA transformer to the dataset, you can access the principal components using the\n", + "components variable (note that it contains the PCs as horizontal vectors, so, for example, the first\n", + "principal component is equal to" + ] + }, + { + "cell_type": "code", + "execution_count": 19, + "metadata": { + "collapsed": false + }, + "outputs": [ + { + "ename": "SyntaxError", + "evalue": "invalid syntax (, line 1)", + "output_type": "error", + "traceback": [ + "\u001b[0;36m File \u001b[0;32m\"\"\u001b[0;36m, line \u001b[0;32m1\u001b[0m\n\u001b[0;31m pca.components_.T[:, 0].\u001b[0m\n\u001b[0m ^\u001b[0m\n\u001b[0;31mSyntaxError\u001b[0m\u001b[0;31m:\u001b[0m invalid syntax\n" + ] + } + ], + "source": [ + "pca.components_.T[:, 0]." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Another very useful piece of information is the explained variance ratio of each principal component,\n", + "available via the $explained\\_variance\\_ratio$ variable. It indicates the proportion of the dataset’s\n", + "variance that lies along the axis of each principal component. \n", + "\n", + "\n", + "## Back to the Cancer Data\n", + "We can now repeat the above but applied to real data, in this case our breast cancer data.\n", + "Here we compute performance scores on the training data using logistic regression." + ] + }, + { + "cell_type": "code", + "execution_count": 20, + "metadata": { + "collapsed": false + }, + "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.linear_model import LogisticRegression\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", + "\n", + "logreg = LogisticRegression()\n", + "logreg.fit(X_train, y_train)\n", + "print(\"Train set accuracy from Logistic Regression: {:.2f}\".format(logreg.score(X_train,y_train)))\n", + "# We 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", + "# Then perform again a log reg fit\n", + "logreg.fit(X_train_scaled, y_train)\n", + "print(\"Train set accuracy scaled data: {:.2f}\".format(logreg.score(X_train_scaled,y_train)))\n", + "#thereafter we do a PCA with Scikit-learn\n", + "from sklearn.decomposition import PCA\n", + "pca = PCA(n_components = 2)\n", + "X2D_train = pca.fit_transform(X_train_scaled)\n", + "# and finally compute the log reg fit and the score on the training data\t\n", + "logreg.fit(X2D_train,y_train)\n", + "print(\"Train set accuracy scaled and PCA data: {:.2f}\".format(logreg.score(X2D_train,y_train)))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We see that our training data after the PCA decomposition has a performance similar to the non-scaled data. \n", + "\n", + "\n", + "## More on the PCA\n", + "\n", + "Instead of arbitrarily choosing the number of dimensions to reduce down to, it is generally preferable to\n", + "choose the number of dimensions that add up to a sufficiently large portion of the variance (e.g., 95%).\n", + "Unless, of course, you are reducing dimensionality for data visualization — in that case you will\n", + "generally want to reduce the dimensionality down to 2 or 3.\n", + "The following code computes PCA without reducing dimensionality, then computes the minimum number\n", + "of dimensions required to preserve 95% of the training set’s variance:" + ] + }, + { + "cell_type": "code", + "execution_count": 21, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "pca = PCA()\n", + "pca.fit(X)\n", + "cumsum = np.cumsum(pca.explained_variance_ratio_)\n", + "d = np.argmax(cumsum >= 0.95) + 1" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "You could then set $n\\_components=d$ and run PCA again. However, there is a much better option: instead\n", + "of specifying the number of principal components you want to preserve, you can set $n\\_components$ to be\n", + "a float between 0.0 and 1.0, indicating the ratio of variance you wish to preserve:" + ] + }, + { + "cell_type": "code", + "execution_count": 22, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "pca = PCA(n_components=0.95)\n", + "X_reduced = pca.fit_transform(X)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Incremental PCA\n", + "\n", + "One problem with the preceding implementation of PCA is that it requires the whole training set to fit in\n", + "memory in order for the SVD algorithm to run. Fortunately, Incremental PCA (IPCA) algorithms have\n", + "been developed: you can split the training set into mini-batches and feed an IPCA algorithm one minibatch\n", + "at a time. This is useful for large training sets, and also to apply PCA online (i.e., on the fly, as new\n", + "instances arrive).\n", + "\n", + "\n", + "## Randomized PCA\n", + "\n", + "Scikit-Learn offers yet another option to perform PCA, called Randomized PCA. This is a stochastic\n", + "algorithm that quickly finds an approximation of the first d principal components. Its computational\n", + "complexity is $O(m \\times d^2)+O(d^3)$, instead of $O(m \\times n^2) + O(n^3)$, so it is dramatically faster than the\n", + "previous algorithms when $d$ is much smaller than $n$.\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Kernel PCA\n", + "\n", + "The kernel trick is a mathematical technique that implicitly maps instances into a\n", + "very high-dimensional space (called the feature space), enabling nonlinear classification and regression\n", + "with Support Vector Machines. Recall that a linear decision boundary in the high-dimensional feature\n", + "space corresponds to a complex nonlinear decision boundary in the original space.\n", + "It turns out that the same trick can be applied to PCA, making it possible to perform complex nonlinear\n", + "projections for dimensionality reduction. This is called Kernel PCA (kPCA). It is often good at\n", + "preserving clusters of instances after projection, or sometimes even unrolling datasets that lie close to a\n", + "twisted manifold.\n", + "For example, the following code uses Scikit-Learn’s KernelPCA class to perform kPCA with an" + ] + }, + { + "cell_type": "code", + "execution_count": 23, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "from sklearn.decomposition import KernelPCA\n", + "rbf_pca = KernelPCA(n_components = 2, kernel=\"rbf\", gamma=0.04)\n", + "X_reduced = rbf_pca.fit_transform(X)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## LLE\n", + "\n", + "Locally Linear Embedding (LLE) is another very powerful nonlinear dimensionality reduction\n", + "(NLDR) technique. It is a Manifold Learning technique that does not rely on projections like the previous\n", + "algorithms. In a nutshell, LLE works by first measuring how each training instance linearly relates to its\n", + "closest neighbors (c.n.), and then looking for a low-dimensional representation of the training set where\n", + "these local relationships are best preserved (more details shortly). \n", + "\n", + "\n", + "\n", + "\n", + "## Other techniques\n", + "\n", + "\n", + "There are many other dimensionality reduction techniques, several of which are available in Scikit-Learn.\n", + "\n", + "Here are some of the most popular:\n", + "* **Multidimensional Scaling (MDS)** reduces dimensionality while trying to preserve the distances between the instances.\n", + "\n", + "* **Isomap** creates a graph by connecting each instance to its nearest neighbors, then reduces dimensionality while trying to preserve the geodesic distances between the instances.\n", + "\n", + "* **t-Distributed Stochastic Neighbor Embedding** (t-SNE) reduces dimensionality while trying to keep similar instances close and dissimilar instances apart. It is mostly used for visualization, in particular to visualize clusters of instances in high-dimensional space (e.g., to visualize the MNIST images in 2D).\n", + "\n", + "* Linear Discriminant Analysis (LDA) is actually a classification algorithm, but during training it learns the most discriminative axes between the classes, and these axes can then be used to define a hyperplane onto which to project the data. The benefit is that the projection will keep classes as far apart as possible, so LDA is a good technique to reduce dimensionality before running another classification algorithm such as a Support Vector Machine (SVM) classifier discussed in the SVM lectures." + ] + } + ], + "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.3" + } + }, + "nbformat": 4, + "nbformat_minor": 4 +} \ No newline at end of file diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter8.py b/doc/src/LectureNotes/_build/jupyter_execute/chapter8.py new file mode 100644 index 000000000..3724ed61b --- /dev/null +++ b/doc/src/LectureNotes/_build/jupyter_execute/chapter8.py @@ -0,0 +1,1198 @@ +# Dimensionality Reduction + + +## Reducing the number of degrees of freedom, overarching view + +Many Machine Learning problems involve thousands or even millions of +features for each training instance. Not only does this make training +extremely slow, it can also make it much harder to find a good +solution, as we will see. This problem is often referred to as the +curse of dimensionality. Fortunately, in real-world problems, it is +often possible to reduce the number of features considerably, turning +an intractable problem into a tractable one. + +Here we will discuss some of the most popular dimensionality reduction +techniques: the principal component analysis (PCA), Kernel PCA, and +Locally Linear Embedding (LLE). Furthermore, we will start by looking +at some simple preprocessing of the data which allow us to rescale the +data. + +Principal component analysis and its various variants deal with the +problem of fitting a low-dimensional [affine +subspace](https://en.wikipedia.org/wiki/Affine_space) to a set of of +data points in a high-dimensional space. With its family of methods it +is one of the most used tools in data modeling, compression and +visualization. + + + + + +## Preprocessing our data + +Before we proceed however, we will discuss how to preprocess our +data. Till now and in connection with our previous examples we have +not met so many cases where we are too sensitive to the scaling of our +data. Normally the data may need a rescaling and/or may be sensitive +to extreme values. Scaling the data renders our inputs much more +suitable for the algorithms we want to employ. + +**Scikit-Learn** has several functions which allow us to rescale the +data, normally resulting in much better results in terms of various +accuracy scores. The **StandardScaler** function in **Scikit-Learn** +ensures that for each feature/predictor we study the mean value is +zero and the variance is one (every column in the design/feature +matrix). This scaling has the drawback that it does not ensure that +we have a particular maximum or minimum in our data set. Another +function included in **Scikit-Learn** is the **MinMaxScaler** which +ensures that all features are exactly between $0$ and $1$. The + + +## More preprocessing + + +The **Normalizer** scales each data +point such that the feature vector has a euclidean length of one. In other words, it +projects a data point on the circle (or sphere in the case of higher dimensions) with a +radius of 1. This means every data point is scaled by a different number (by the +inverse of it’s length). +This normalization is often used when only the direction (or angle) of the data matters, +not the length of the feature vector. + +The **RobustScaler** works similarly to the StandardScaler in that it +ensures statistical properties for each feature that guarantee that +they are on the same scale. However, the RobustScaler uses the median +and quartiles, instead of mean and variance. This makes the +RobustScaler ignore data points that are very different from the rest +(like measurement errors). These odd data points are also called +outliers, and might often lead to trouble for other scaling +techniques. + + + + +## Simple preprocessing examples, Franke function and regression + +%matplotlib inline + +# Common imports +import os +import numpy as np +import pandas as pd +import matplotlib.pyplot as plt +import sklearn.linear_model as skl +from sklearn.metrics import mean_squared_error +from sklearn.model_selection import train_test_split +from sklearn.preprocessing import MinMaxScaler, StandardScaler, Normalizer +from sklearn.svm import SVR + +# Where to save the figures and data files +PROJECT_ROOT_DIR = "Results" +FIGURE_ID = "Results/FigureFiles" +DATA_ID = "DataFiles/" + +if not os.path.exists(PROJECT_ROOT_DIR): + os.mkdir(PROJECT_ROOT_DIR) + +if not os.path.exists(FIGURE_ID): + os.makedirs(FIGURE_ID) + +if not os.path.exists(DATA_ID): + os.makedirs(DATA_ID) + +def image_path(fig_id): + return os.path.join(FIGURE_ID, fig_id) + +def data_path(dat_id): + return os.path.join(DATA_ID, dat_id) + +def save_fig(fig_id): + plt.savefig(image_path(fig_id) + ".png", format='png') + + +def FrankeFunction(x,y): + term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2)) + term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1)) + term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2)) + term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2) + return term1 + term2 + term3 + term4 + + +def create_X(x, y, n ): + if len(x.shape) > 1: + x = np.ravel(x) + y = np.ravel(y) + + N = len(x) + l = int((n+1)*(n+2)/2) # Number of elements in beta + X = np.ones((N,l)) + + for i in range(1,n+1): + q = int((i)*(i+1)/2) + for k in range(i+1): + X[:,q+k] = (x**(i-k))*(y**k) + + return X + + +# Making meshgrid of datapoints and compute Franke's function +n = 5 +N = 1000 +x = np.sort(np.random.uniform(0, 1, N)) +y = np.sort(np.random.uniform(0, 1, N)) +z = FrankeFunction(x, y) +X = create_X(x, y, n=n) +# split in training and test data +X_train, X_test, y_train, y_test = train_test_split(X,z,test_size=0.2) + + +svm = SVR(gamma='auto',C=10.0) +svm.fit(X_train, y_train) + +# The mean squared error and R2 score +print("MSE before scaling: {:.2f}".format(mean_squared_error(svm.predict(X_test), y_test))) +print("R2 score before scaling {:.2f}".format(svm.score(X_test,y_test))) + +scaler = StandardScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) + +print("Feature min values before scaling:\n {}".format(X_train.min(axis=0))) +print("Feature max values before scaling:\n {}".format(X_train.max(axis=0))) + +print("Feature min values after scaling:\n {}".format(X_train_scaled.min(axis=0))) +print("Feature max values after scaling:\n {}".format(X_train_scaled.max(axis=0))) + +svm = SVR(gamma='auto',C=10.0) +svm.fit(X_train_scaled, y_train) + +print("MSE after scaling: {:.2f}".format(mean_squared_error(svm.predict(X_test_scaled), y_test))) +print("R2 score for scaled data: {:.2f}".format(svm.score(X_test_scaled,y_test))) + +## Simple preprocessing examples, breast cancer data and classification, Support Vector Machines + +We show here how we can use a simple regression case on the breast +cancer data using support vector machines (SVM) as algorithm for +classification. + +import matplotlib.pyplot as plt +import numpy as np +from sklearn.model_selection import train_test_split +from sklearn.datasets import load_breast_cancer +from sklearn.svm import SVC +cancer = load_breast_cancer() + +X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) +print(X_train.shape) +print(X_test.shape) + +svm = SVC(C=100) +svm.fit(X_train, y_train) +print("Test set accuracy: {:.2f}".format(svm.score(X_test,y_test))) + +from sklearn.preprocessing import MinMaxScaler, StandardScaler +scaler = MinMaxScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) + +print("Feature min values before scaling:\n {}".format(X_train.min(axis=0))) +print("Feature max values before scaling:\n {}".format(X_train.max(axis=0))) + +print("Feature min values before scaling:\n {}".format(X_train_scaled.min(axis=0))) +print("Feature max values before scaling:\n {}".format(X_train_scaled.max(axis=0))) + + +svm.fit(X_train_scaled, y_train) +print("Test set accuracy scaled data with Min-Max scaling: {:.2f}".format(svm.score(X_test_scaled,y_test))) + +scaler = StandardScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) + +svm.fit(X_train_scaled, y_train) +print("Test set accuracy scaled data with Standar Scaler: {:.2f}".format(svm.score(X_test_scaled,y_test))) + +## More on Cancer Data, now with Logistic Regression + +import matplotlib.pyplot as plt +import numpy as np +from sklearn.model_selection import train_test_split +from sklearn.datasets import load_breast_cancer +from sklearn.linear_model import LogisticRegression +cancer = load_breast_cancer() + +# Set up training data +X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) +logreg = LogisticRegression() +logreg.fit(X_train, y_train) +print("Test set accuracy: {:.2f}".format(logreg.score(X_test,y_test))) + +# Scale data +from sklearn.preprocessing import StandardScaler +scaler = StandardScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) +logreg.fit(X_train_scaled, y_train) +print("Test set accuracy scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test))) + +## Why should we think of reducing the dimensionality + +In addition to the plot of the features, we study now also the covariance (and the correlation matrix). +We use also **Pandas** to compute the correlation matrix. + +import matplotlib.pyplot as plt +import numpy as np +from sklearn.model_selection import train_test_split +from sklearn.datasets import load_breast_cancer +from sklearn.linear_model import LogisticRegression +cancer = load_breast_cancer() +import pandas as pd +# Making a data frame +cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names) + +fig, axes = plt.subplots(15,2,figsize=(10,20)) +malignant = cancer.data[cancer.target == 0] +benign = cancer.data[cancer.target == 1] +ax = axes.ravel() + +for i in range(30): + _, bins = np.histogram(cancer.data[:,i], bins =50) + ax[i].hist(malignant[:,i], bins = bins, alpha = 0.5) + ax[i].hist(benign[:,i], bins = bins, alpha = 0.5) + ax[i].set_title(cancer.feature_names[i]) + ax[i].set_yticks(()) +ax[0].set_xlabel("Feature magnitude") +ax[0].set_ylabel("Frequency") +ax[0].legend(["Malignant", "Benign"], loc ="best") +fig.tight_layout() +plt.show() + +import seaborn as sns +correlation_matrix = cancerpd.corr().round(1) +# use the heatmap function from seaborn to plot the correlation matrix +# annot = True to print the values inside the square +sns.heatmap(data=correlation_matrix, annot=True) +plt.show() + +#print eigvalues of correlation matrix +EigValues, EigVectors = np.linalg.eig(correlation_matrix) +print(EigValues) + +In the above example we note two things. In the first plot we display +the overlap of benign and malignant tumors as functions of the various +features in the Wisconsing breast cancer data set. We see that for +some of the features we can distinguish clearly the benign and +malignant cases while for other features we cannot. This can point to +us which features may be of greater interest when we wish to classify +a benign or not benign tumour. + +In the second figure we have computed the so-called correlation +matrix, which in our case with thirty features becomes a $30\times 30$ +matrix. + +We constructed this matrix using **pandas** via the statements + +cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names) + +and then + +correlation_matrix = cancerpd.corr().round(1) + +Diagonalizing this matrix we can in turn say something about which +features are of relevance and which are not. But before we proceed we +need to define covariance and correlation matrices. This leads us to +the classical Principal Component Analysis (PCA) theorem with +applications. + + + + +## Basic ideas of the Principal Component Analysis (PCA) + +The principal component analysis deals with the problem of fitting a +low-dimensional affine subspace $S$ of dimension $d$ much smaller than +the totaldimension $D$ of the problem at hand (our data +set). Mathematically it can be formulated as a statistical problem or +a geometric problem. In our discussion of the theorem for the +classical PCA, we will stay with a statistical approach. This is also +what set the scene historically which for the PCA. + +We have a data set defined by a design/feature matrix $\boldsymbol{X}$ (see below for its definition) +* Each data point is determined by $p$ extrinsic (measurement) variables + +* We may want to ask the following question: Are there fewer intrinsic variables (say $d << p$) that still approximately describe the data? + +* If so, these intrinsic variables may tell us something important and finding these intrinsic variables is what dimension reduction methods do. + +## Introducing the Covariance and Correlation functions + +Before we discuss the PCA theorem, we need to remind ourselves about +the definition of the covariance and the correlation function. These are quantities + +Suppose we have defined two vectors +$\hat{x}$ and $\hat{y}$ with $n$ elements each. The covariance matrix $\boldsymbol{C}$ is defined as + +$$ +\boldsymbol{C}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} \mathrm{cov}[\boldsymbol{x},\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] \\ + \mathrm{cov}[\boldsymbol{y},\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{y},\boldsymbol{y}] \\ + \end{bmatrix}, +$$ + +where for example + +$$ +\mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] =\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})(y_i- \overline{y}). +$$ + +With this definition and recalling that the variance is defined as + +$$ +\mathrm{var}[\boldsymbol{x}]=\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})^2, +$$ + +we can rewrite the covariance matrix as + +$$ +\boldsymbol{C}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} \mathrm{var}[\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] \\ + \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] & \mathrm{var}[\boldsymbol{y}] \\ + \end{bmatrix}. +$$ + +The covariance takes values between zero and infinity and may thus +lead to problems with loss of numerical precision for particularly +large values. It is common to scale the covariance matrix by +introducing instead the correlation matrix defined via the so-called +correlation function + +$$ +\mathrm{corr}[\boldsymbol{x},\boldsymbol{y}]=\frac{\mathrm{cov}[\boldsymbol{x},\boldsymbol{y}]}{\sqrt{\mathrm{var}[\boldsymbol{x}] \mathrm{var}[\boldsymbol{y}]}}. +$$ + +The correlation function is then given by values $\mathrm{corr}[\boldsymbol{x},\boldsymbol{y}] +\in [-1,1]$. This avoids eventual problems with too large values. We +can then define the correlation matrix for the two vectors $\boldsymbol{x}$ +and $\boldsymbol{y}$ as + +$$ +\boldsymbol{K}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} 1 & \mathrm{corr}[\boldsymbol{x},\boldsymbol{y}] \\ + \mathrm{corr}[\boldsymbol{y},\boldsymbol{x}] & 1 \\ + \end{bmatrix}, +$$ + +In the above example this is the function we constructed using **pandas**. + + +## Correlation Function and Design/Feature Matrix + +In our derivation of the various regression algorithms like **Ordinary Least Squares** or **Ridge regression** +we defined the design/feature matrix $\boldsymbol{X}$ as + +$$ +\boldsymbol{X}=\begin{bmatrix} +x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ +x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ +x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ +\dots & \dots & \dots & \dots \dots & \dots \\ +x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ +x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ +\end{bmatrix}, +$$ + +with $\boldsymbol{X}\in {\mathbb{R}}^{n\times p}$, with the predictors/features $p$ refering to the column numbers and the +entries $n$ being the row elements. +We can rewrite the design/feature matrix in terms of its column vectors as + +$$ +\boldsymbol{X}=\begin{bmatrix} \boldsymbol{x}_0 & \boldsymbol{x}_1 & \boldsymbol{x}_2 & \dots & \dots & \boldsymbol{x}_{p-1}\end{bmatrix}, +$$ + +with a given vector + +$$ +\boldsymbol{x}_i^T = \begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \dots & \dots x_{n-1,i}\end{bmatrix}. +$$ + +With these definitions, we can now rewrite our $2\times 2$ +correaltion/covariance matrix in terms of a moe general design/feature +matrix $\boldsymbol{X}\in {\mathbb{R}}^{n\times p}$. This leads to a $p\times p$ +covariance matrix for the vectors $\boldsymbol{x}_i$ with $i=0,1,\dots,p-1$ + +$$ +\boldsymbol{C}[\boldsymbol{x}] = \begin{bmatrix} +\mathrm{var}[\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_{p-1}]\\ +\mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_0] & \mathrm{var}[\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_{p-1}]\\ +\mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_1] & \mathrm{var}[\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_{p-1}]\\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_{2}] & \dots & \dots & \mathrm{var}[\boldsymbol{x}_{p-1}]\\ +\end{bmatrix}, +$$ + +and the correlation matrix + +$$ +\boldsymbol{K}[\boldsymbol{x}] = \begin{bmatrix} +1 & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_1] & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_2] & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_{p-1}]\\ +\mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_0] & 1 & \mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_2] & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_{p-1}]\\ +\mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_0] & \mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_1] & 1 & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_{p-1}]\\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_0] & \mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_1] & \mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_{2}] & \dots & \dots & 1\\ +\end{bmatrix}, +$$ + +## Covariance Matrix Examples + + +The Numpy function **np.cov** calculates the covariance elements using +the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have +the exact mean values. The following simple function uses the +**np.vstack** function which takes each vector of dimension $1\times n$ +and produces a $2\times n$ matrix $\boldsymbol{W}$ + +$$ +\boldsymbol{W} = \begin{bmatrix} x_0 & y_0 \\ + x_1 & y_1 \\ + x_2 & y_2\\ + \dots & \dots \\ + x_{n-2} & y_{n-2}\\ + x_{n-1} & y_{n-1} & + \end{bmatrix}, +$$ + +which in turn is converted into into the $2\times 2$ covariance matrix +$\boldsymbol{C}$ via the Numpy function **np.cov()**. We note that we can also calculate +the mean value of each set of samples $\boldsymbol{x}$ etc using the Numpy +function **np.mean(x)**. We can also extract the eigenvalues of the +covariance matrix through the **np.linalg.eig()** function. + +# Importing various packages +import numpy as np +n = 100 +x = np.random.normal(size=n) +print(np.mean(x)) +y = 4+3*x+np.random.normal(size=n) +print(np.mean(y)) +W = np.vstack((x, y)) +C = np.cov(W) +print(C) + +## Correlation Matrix + +The previous example can be converted into the correlation matrix by +simply scaling the matrix elements with the variances. We should also +subtract the mean values for each column. This leads to the following +code which sets up the correlations matrix for the previous example in +a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the $2\times 2$ correlation matrix (since we have only two vectors). + +import numpy as np +n = 100 +# define two vectors +x = np.random.random(size=n) +y = 4+3*x+np.random.normal(size=n) +#scaling the x and y vectors +x = x - np.mean(x) +y = y - np.mean(y) +variance_x = np.sum(x@x)/n +variance_y = np.sum(y@y)/n +print(variance_x) +print(variance_y) +cov_xy = np.sum(x@y)/n +cov_xx = np.sum(x@x)/n +cov_yy = np.sum(y@y)/n +C = np.zeros((2,2)) +C[0,0]= cov_xx/variance_x +C[1,1]= cov_yy/variance_y +C[0,1]= cov_xy/np.sqrt(variance_y*variance_x) +C[1,0]= C[0,1] +print(C) + +We see that the matrix elements along the diagonal are one as they +should be and that the matrix is symmetric. Furthermore, diagonalizing +this matrix we easily see that it is a positive definite matrix. + +The above procedure with **numpy** can be made more compact if we use **pandas**. + + +## Correlation Matrix with Pandas + +We whow here how we can set up the correlation matrix using **pandas**, as done in this simple code + +import numpy as np +import pandas as pd +n = 10 +x = np.random.normal(size=n) +x = x - np.mean(x) +y = 4+3*x+np.random.normal(size=n) +y = y - np.mean(y) +X = (np.vstack((x, y))).T +print(X) +Xpd = pd.DataFrame(X) +print(Xpd) +correlation_matrix = Xpd.corr() +print(correlation_matrix) + +We expand this model to the Franke function discussed above. + + +## Correlation Matrix with Pandas and the Franke function + +# Common imports +import numpy as np +import pandas as pd + + +def FrankeFunction(x,y): + term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2)) + term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1)) + term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2)) + term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2) + return term1 + term2 + term3 + term4 + + +def create_X(x, y, n ): + if len(x.shape) > 1: + x = np.ravel(x) + y = np.ravel(y) + + N = len(x) + l = int((n+1)*(n+2)/2) # Number of elements in beta + X = np.ones((N,l)) + + for i in range(1,n+1): + q = int((i)*(i+1)/2) + for k in range(i+1): + X[:,q+k] = (x**(i-k))*(y**k) + + return X + + +# Making meshgrid of datapoints and compute Franke's function +n = 4 +N = 100 +x = np.sort(np.random.uniform(0, 1, N)) +y = np.sort(np.random.uniform(0, 1, N)) +z = FrankeFunction(x, y) +X = create_X(x, y, n=n) + +Xpd = pd.DataFrame(X) +# subtract the mean values and set up the covariance matrix +Xpd = Xpd - Xpd.mean() +covariance_matrix = Xpd.cov() +print(covariance_matrix) + +We note here that the covariance is zero for the first rows and +columns since all matrix elements in the design matrix were set to one +(we are fitting the function in terms of a polynomial of degree $n$). + +This means that the variance for these elements will be zero and will +cause problems when we set up the correlation matrix. We can simply +drop these elements and construct a correlation +matrix without these elements. + + + +## Rewriting the Covariance and/or Correlation Matrix + +We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix $\boldsymbol{X}$ as + +$$ +\boldsymbol{C}[\boldsymbol{x}] = \frac{1}{n}\boldsymbol{X}\boldsymbol{X}^T= \mathbb{E}[\boldsymbol{X}\boldsymbol{X}^T]. +$$ + +To see this let us simply look at a design matrix $\boldsymbol{X}\in {\mathbb{R}}^{2\times 2}$ + +$$ +\boldsymbol{X}=\begin{bmatrix} +x_{00} & x_{01}\\ +x_{10} & x_{11}\\ +\end{bmatrix}=\begin{bmatrix} +\boldsymbol{x}_{0} & \boldsymbol{x}_{1}\\ +\end{bmatrix}. +$$ + +If we then compute the expectation value + +$$ +\mathbb{E}[\boldsymbol{X}\boldsymbol{X}^T] = \frac{1}{n}\boldsymbol{X}\boldsymbol{X}^T=\begin{bmatrix} +x_{00}^2+x_{01}^2 & x_{00}x_{10}+x_{01}x_{11}\\ +x_{10}x_{00}+x_{11}x_{01} & x_{10}^2+x_{11}^2\\ +\end{bmatrix}, +$$ + +which is just + +$$ +\boldsymbol{C}[\boldsymbol{x}_0,\boldsymbol{x}_1] = \boldsymbol{C}[\boldsymbol{x}]=\begin{bmatrix} \mathrm{var}[\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_1] \\ + \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_0] & \mathrm{var}[\boldsymbol{x}_1] \\ + \end{bmatrix}, +$$ + +where we wrote $$\boldsymbol{C}[\boldsymbol{x}_0,\boldsymbol{x}_1] = \boldsymbol{C}[\boldsymbol{x}]$$ to indicate that this the covariance of the vectors $\boldsymbol{x}$ of the design/feature matrix $\boldsymbol{X}$. + +It is easy to generalize this to a matrix $\boldsymbol{X}\in {\mathbb{R}}^{n\times p}$. + + + +## Towards the PCA theorem + +We have that the covariance matrix (the correlation matrix involves a simple rescaling) is given as + +$$ +\boldsymbol{C}[\boldsymbol{x}] = \frac{1}{n}\boldsymbol{X}\boldsymbol{X}^T= \mathbb{E}[\boldsymbol{X}\boldsymbol{X}^T]. +$$ + +Let us now assume that we can perform a series of orthogonal transformations where we employ some orthogonal matrices $\boldsymbol{S}$. +These matrices are defined as $\boldsymbol{S}\in {\mathbb{R}}^{p\times p}$ and obey the orthogonality requirements $\boldsymbol{S}\boldsymbol{S}^T=\boldsymbol{S}^T\boldsymbol{S}=\boldsymbol{I}$. The matrix can be written out in terms of the column vectors $\boldsymbol{s}_i$ as $\boldsymbol{S}=[\boldsymbol{s}_0,\boldsymbol{s}_1,\dots,\boldsymbol{s}_{p-1}]$ and $\boldsymbol{s}_i \in {\mathbb{R}}^{p}$. + +Assume also that there is a transformation $\boldsymbol{S}\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}^T=\boldsymbol{C}[\boldsymbol{y}]$ such that the new matrix $\boldsymbol{C}[\boldsymbol{y}]$ is diagonal with elements $[\lambda_0,\lambda_1,\lambda_2,\dots,\lambda_{p-1}]$. + +That is we have + +$$ +\boldsymbol{C}[\boldsymbol{y}] = \mathbb{E}[\boldsymbol{S}\boldsymbol{X}\boldsymbol{X}^T\boldsymbol{S}^T]=\boldsymbol{S}\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}^T, +$$ + +since the matrix $\boldsymbol{S}$ is not a data dependent matrix. Multiplying with $\boldsymbol{S}^T$ from the left we have + +$$ +\boldsymbol{S}^T\boldsymbol{C}[\boldsymbol{y}] = \boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}^T, +$$ + +and since $\boldsymbol{C}[\boldsymbol{y}]$ is diagonal we have for a given eigenvalue $i$ of the covariance matrix that + +$$ +\boldsymbol{S}^T_i\lambda_i = \boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}^T_i. +$$ + +In the derivation of the PCA theorem we will assume that the eigenvalues are ordered in descending order, that is +$\lambda_0 > \lambda_1 > \dots > \lambda_{p-1}$. + + +The eigenvalues tell us then how much we need to stretch the +corresponding eigenvectors. Dimensions with large eigenvalues have +thus large variations (large variance) and define therefore useful +dimensions. The data points are more spread out in the direction of +these eigenvectors. Smaller eigenvalues mean on the other hand that +the corresponding eigenvectors are shrunk accordingly and the data +points are tightly bunched together and there is not much variation in +these specific directions. Hopefully then we could leave it out +dimensions where the eigenvalues are very small. If $p$ is very large, +we could then aim at reducing $p$ to $l << p$ and handle only $l$ +features/predictors. + + +## The Algorithm before theorem + +Here's how we would proceed in setting up the algorithm for the PCA, see also discussion below here. +* Set up the datapoints for the design/feature matrix $\boldsymbol{X}$ with $\boldsymbol{X}\in {\mathbb{R}}^{n\times p}$, with the predictors/features $p$ referring to the column numbers and the entries $n$ being the row elements. + +$$ +\boldsymbol{X}=\begin{bmatrix} +x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ +x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ +x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ +\dots & \dots & \dots & \dots \dots & \dots \\ +x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ +x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ +\end{bmatrix}, +$$ + +* Center the data by subtracting the mean value for each column. This leads to a new matrix $\boldsymbol{X}\rightarrow \overline{\boldsymbol{X}}$. + +* Compute then the covariance/correlation matrix $\mathbb{E}[\overline{\boldsymbol{X}}\overline{\boldsymbol{X}}^T]$. + +* Find the eigenpairs of $\boldsymbol{C}$ with eigenvalues $[\lambda_0,\lambda_1,\dots,\lambda_{p-1}]$ and eigenvectors $[\boldsymbol{s}_0,\boldsymbol{s}_1,\dots,\boldsymbol{s}_{p-1}]$. + +* Order the eigenvalue (and the eigenvectors accordingly) in order of decreasing eigenvalues. + +* Keep only those $l$ eigenvalues larger than a selected threshold value, discarding thus $p-l$ features since we expect small variations in the data here. + +## Writing our own PCA code + +We will use a simple example first with two-dimensional data +drawn from a multivariate normal distribution with the following mean and covariance matrix: + +$$ +\mu = (-1,2) \qquad \Sigma = \begin{bmatrix} 4 & 2 \\ +2 & 2 +\end{bmatrix} +$$ + +Note that the mean refers to each column of data. +We will generate $n = 1000$ points $X = \{ x_1, \ldots, x_N \}$ from +this distribution, and store them in the $1000 \times 2$ matrix $\boldsymbol{X}$. + +The following Python code aids in setting up the data and writing out the design matrix. +Note that the function **multivariate** returns also the covariance discussed above and that it is defined by dividing by $n-1$ instead of $n$. + +import numpy as np +import pandas as pd +import matplotlib.pyplot as plt +from IPython.display import display +n = 10000 +mean = (-1, 2) +cov = [[4, 2], [2, 2]] +X = np.random.multivariate_normal(mean, cov, n) + +Now we are going to implement the PCA algorithm. We will break it down into various substeps. + +### Compute the sample mean and center the data + +The first step of PCA is to compute the sample mean of the data and use it to center the data. Recall that the sample mean is + +$$ +\mu_n = \frac{1}{n} \sum_{i=1}^n x_i +$$ + +and the mean-centered data $\bar{X} = \{ \bar{x}_1, \ldots, \bar{x}_n \}$ takes the form + +$$ +\bar{x}_i = x_i - \mu_n. +$$ + +When you are done with these steps, print out $\mu_n$ to verify it is +close to $\mu$ and plot your mean centered data to verify it is +centered at the origin! Compare your code with the functionality from **Scikit-Learn** discussed above. +The following code elements perform these operations using **pandas** or using our own functionality for doing so. The latter, using **numpy** is rather simple through the **mean()** function. + +df = pd.DataFrame(X) +# Pandas does the centering for us +df = df -df.mean() +# we center it ourselves +X_centered = X - X.mean(axis=0) + +Alternatively, we could use the functions we discussed +earlier for scaling the data set. That is, we could have used the +**StandardScaler** function in **Scikit-Learn**, a function which ensures +that for each feature/predictor we study the mean value is zero and +the variance is one (every column in the design/feature matrix). You +would then not get the same results, since we divide by the +variance. The diagonal covariance matrix elements will then be one, +while the non-diagonal ones need to be divided by $2\sqrt{2}$ for our +specific case. + +### Compute the sample covariance + +Now we are going to use the mean centered data to compute the sample covariance of the data by using the following equation + +$$ +\Sigma_n = \frac{1}{n-1} \sum_{i=1}^n \bar{x}_i^T \bar{x}_i = \frac{1}{n-1} \sum_{i=1}^n (x_i - \mu_n)^T (x_i - \mu_n) +$$ + +where the data points $x_i \in \mathbb{R}^p$ (here in this example $p = 2$) are column vectors and $x^T$ is the transpose of $x$. +We can write our own code or simply use either the functionaly of **numpy** or that of **pandas**, as follows + +print(df.cov()) +print(np.cov(X_centered.T)) + +Note that the way we define the covariance matrix here has a factor $n-1$ instead of $n$. This is included in the **cov()** function by **numpy** and **pandas**. +Our own code here is not very elegant and asks for obvious improvements. It is tailored to this specific $2\times 2$ covariance matrix. + +# extract the relevant columns from the centered design matrix of dim n x 2 +x = X_centered[:,0] +y = X_centered[:,1] +Cov = np.zeros((2,2)) +Cov[0,1] = np.sum(x.T@y)/(n-1.0) +Cov[0,0] = np.sum(x.T@x)/(n-1.0) +Cov[1,1] = np.sum(y.T@y)/(n-1.0) +Cov[1,0]= Cov[0,1] +print("Centered covariance using own code") +print(Cov) +plt.plot(x, y, 'x') +plt.axis('equal') +plt.show() + +Depending on the number of points $n$, we will get results that are close to the covariance values defined above. +The plot shows how the data are clustered around a line with slope close to one. Is this expected? + +### Diagonalize the sample covariance matrix to obtain the principal components + +Now we are ready to solve for the principal components! To do so we +diagonalize the sample covariance matrix $\Sigma$. We can use the +function **np.linalg.eig** to do so. It will return the eigenvalues and +eigenvectors of $\Sigma$. Once we have these we can perform the +following tasks: + +* We compute the percentage of the total variance captured by the first principal component + +* We plot the mean centered data and lines along the first and second principal components + +* Then we project the mean centered data onto the first and second principal components, and plot the projected data. + +* Finally, we approximate the data as + +$$ +x_i \approx \tilde{x}_i = \mu_n + \langle x_i, v_0 \rangle v_0 +$$ + +where $v_0$ is the first principal component. + +Collecting all these steps we can write our own PCA function and +compare this with the functionality included in **Scikit-Learn**. + +The code here outlines some of the elements we could include in the +analysis. Feel free to extend upon this in order to address the above +questions. + +# diagonalize and obtain eigenvalues, not necessarily sorted +EigValues, EigVectors = np.linalg.eig(Cov) +# sort eigenvectors and eigenvalues +#permute = EigValues.argsort() +#EigValues = EigValues[permute] +#EigVectors = EigVectors[:,permute] +print("Eigenvalues of Covariance matrix") +for i in range(2): + print(EigValues[i]) +FirstEigvector = EigVectors[:,0] +SecondEigvector = EigVectors[:,1] +print("First eigenvector") +print(FirstEigvector) +print("Second eigenvector") +print(SecondEigvector) +#thereafter we do a PCA with Scikit-learn +from sklearn.decomposition import PCA +pca = PCA(n_components = 2) +X2Dsl = pca.fit_transform(X) +print("Eigenvector of largest eigenvalue") +print(pca.components_.T[:, 0]) + +This code does not contain all the above elements, but it shows how we can use **Scikit-Learn** to extract the eigenvector which corresponds to the largest eigenvalue. Try to address the questions we pose before the above code. Try also to change the values of the covariance matrix by making one of the diagonal elements much larger than the other. What do you observe then? + + +## Classical PCA Theorem + +We assume now that we have a design matrix $\boldsymbol{X}$ which has been +centered as discussed above. For the sake of simplicity we skip the +overline symbol. The matrix is defined in terms of the various column +vectors $[\boldsymbol{x}_0,\boldsymbol{x}_1,\dots, \boldsymbol{x}_{p-1}]$ each with dimension +$\boldsymbol{x}\in {\mathbb{R}}^{n}$. + +We assume also that we have an orthogonal transformation $\boldsymbol{W}\in {\mathbb{R}}^{p\times p}$. We define the reconstruction error (which is similar to the mean squared error we have seen before) as + +$$ +J(\boldsymbol{W},\boldsymbol{Z}) = \frac{1}{n}\sum_i (\boldsymbol{x}_i - \overline{\boldsymbol{x}}_i)^2, +$$ + +with $\overline{\boldsymbol{x}}_i = \boldsymbol{W}\boldsymbol{z}_i$, where $\boldsymbol{z}_i$ is a row vector with dimension ${\mathbb{R}}^{n}$ of the matrix +$\boldsymbol{Z}\in{\mathbb{R}}^{p\times n}$. When doing PCA we want to reduce this dimensionality. + +The PCA theorem states that minimizing the above reconstruction error +corresponds to setting $\boldsymbol{W}=\boldsymbol{S}$, the orthogonal matrix which +diagonalizes the empirical covariance(correlation) matrix. The optimal +low-dimensional encoding of the data is then given by a set of vectors +$\boldsymbol{z}_i$ with at most $l$ vectors, with $l << p$, defined by the +orthogonal projection of the data onto the columns spanned by the +eigenvectors of the covariance(correlations matrix). + +The proof which follows will be updated by mid January 2020. + + +## Proof of the PCA Theorem + +To show the PCA theorem let us start with the assumption that there is one vector $\boldsymbol{w}_0$ which corresponds to a solution which minimized the reconstruction error $J$. This is an orthogonal vector. It means that we now approximate the reconstruction error in terms of $\boldsymbol{w}_0$ and $\boldsymbol{z}_0$ as + +$$ +J(\boldsymbol{w}_0,\boldsymbol{z}_0)= \frac{1}{n}\sum_i (\boldsymbol{x}_i - z_{i0}\boldsymbol{w}_0)^2=\frac{1}{n}\sum_i (\boldsymbol{x}_i^T\boldsymbol{x}_i - 2z_{i0}\boldsymbol{w}_0^T\boldsymbol{x}_i+z_{i0}^2\boldsymbol{w}_0^T\boldsymbol{w}_0), +$$ + +which we can rewrite due to the orthogonality of $\boldsymbol{w}_i$ as + +$$ +J(\boldsymbol{w}_0,\boldsymbol{z}_0)=\frac{1}{n}\sum_i (\boldsymbol{x}_i^T\boldsymbol{x}_i - 2z_{i0}\boldsymbol{w}_0^T\boldsymbol{x}_i+z_{i0}^2). +$$ + +Minimizing $J$ with respect to the unknown parameters $z_{0i}$ we obtain that + +$$ +z_{i0}=\boldsymbol{w}_0^T\boldsymbol{x}_i, +$$ + +where the vectors on the rhs are known. + + + +## PCA Proof continued + +We have now found the unknown parameters $z_{i0}$. These correspond to the projected coordinates and we can write + +$$ +J(\boldsymbol{w}_0)= \frac{1}{p}\sum_i (\boldsymbol{x}_i^T\boldsymbol{x}_i - z_{i0}^2)=\mathrm{const}-\frac{1}{n}\sum_i z_{i0}^2. +$$ + +We can show that the variance of the projected coordinates defined by $\boldsymbol{w}_0^T\boldsymbol{x}_i$ are given by + +$$ +\mathrm{var}[\boldsymbol{w}_0^T\boldsymbol{x}_i] = \frac{1}{n}\sum_i z_{i0}^2, +$$ + +since the expectation value of + +$$ +\mathbb{E}[\boldsymbol{w}_0^T\boldsymbol{x}_i] = \mathbb{E}[z_{i0}]= \boldsymbol{w}_0^T\mathbb{E}[\boldsymbol{x}_i]=0, +$$ + +where we have used the fact that our data are centered. + +Recalling our definition of the covariance as + +$$ +\boldsymbol{C}[\boldsymbol{x}] = \frac{1}{n}\boldsymbol{X}\boldsymbol{X}^T=\mathbb{E}[\boldsymbol{X}\boldsymbol{X}^T], +$$ + +we have thus that + +$$ +\mathrm{var}[\boldsymbol{w}_0^T\boldsymbol{x}_i] = \frac{1}{n}\sum_i z_{i0}^2=\boldsymbol{w}_0^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0. +$$ + +We are almost there, we have obtained a relation between minimizing +the reconstruction error and the variance and the covariance +matrix. Minimizing the error is equivalent to maximizing the variance +of the projected data. + + +## The final step + +We could trivially maximize the variance of the projection (and +thereby minimize the error in the reconstruction function) by letting +the norm-2 of $\boldsymbol{w}_0$ go to infinity. However, this norm since we +want the matrix $\boldsymbol{W}$ to be an orthogonal matrix, is constrained by +$\vert\vert \boldsymbol{w}_0 \vert\vert_2^2=1$. Imposing this condition via a +Lagrange multiplier we can then in turn maximize + +$$ +J(\boldsymbol{w}_0)= \boldsymbol{w}_0^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0+\lambda_0(1-\boldsymbol{w}_0^T\boldsymbol{w}_0). +$$ + +Taking the derivative with respect to $\boldsymbol{w}_0$ we obtain + +$$ +\frac{\partial J(\boldsymbol{w}_0)}{\partial \boldsymbol{w}_0}= 2\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0-2\lambda_0\boldsymbol{w}_0=0, +$$ + +meaning that + +$$ +\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0=\lambda_0\boldsymbol{w}_0. +$$ + +**The direction that maximizes the variance (or minimizes the construction error) is an eigenvector of the covariance matrix**! If we left multiply with $\boldsymbol{w}_0^T$ we have the variance of the projected data is + +$$ +\boldsymbol{w}_0^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0=\lambda_0. +$$ + +If we want to maximize the variance (minimize the construction error) +we simply pick the eigenvector of the covariance matrix with the +largest eigenvalue. This establishes the link between the minimization +of the reconstruction function $J$ in terms of an orthogonal matrix +and the maximization of the variance and thereby the covariance of our +observations encoded in the design/feature matrix $\boldsymbol{X}$. + +The proof +for the other eigenvectors $\boldsymbol{w}_1,\boldsymbol{w}_2,\dots$ can be +established by applying the above arguments and using the fact that +our basis of eigenvectors is orthogonal, see [Murphy chapter +12.2](https://mitpress.mit.edu/books/machine-learning-1). The +discussion in chapter 12.2 of Murphy's text has also a nice link with +the Singular Value Decomposition theorem. For categorical data, see +chapter 12.4 and discussion therein. + +Additional part of the proof for the other eigenvectors will be added by mid January 2020. + + +## Geometric Interpretation and link with Singular Value Decomposition + +This material will be added by mid January 2020. + + + +## Principal Component Analysis + +Principal Component Analysis (PCA) is by far the most popular dimensionality reduction algorithm. +First it identifies the hyperplane that lies closest to the data, and then it projects the data onto it. + +The following Python code uses NumPy’s **svd()** function to obtain all the principal components of the +training set, then extracts the first two principal components. First we center the data using either **pandas** or our own code + +import numpy as np +import pandas as pd +from IPython.display import display +np.random.seed(100) +# setting up a 10 x 5 vanilla matrix +rows = 10 +cols = 5 +X = np.random.randn(rows,cols) +df = pd.DataFrame(X) +# Pandas does the centering for us +df = df -df.mean() +display(df) + +# we center it ourselves +X_centered = X - X.mean(axis=0) +# Then check the difference between pandas and our own set up +print(X_centered-df) +#Now we do an SVD +U, s, V = np.linalg.svd(X_centered) +c1 = V.T[:, 0] +c2 = V.T[:, 1] +W2 = V.T[:, :2] +X2D = X_centered.dot(W2) +print(X2D) + +PCA assumes that the dataset is centered around the origin. Scikit-Learn’s PCA classes take care of centering +the data for you. However, if you implement PCA yourself (as in the preceding example), or if you use other libraries, don’t +forget to center the data first. + +Once you have identified all the principal components, you can reduce the dimensionality of the dataset +down to $d$ dimensions by projecting it onto the hyperplane defined by the first $d$ principal components. +Selecting this hyperplane ensures that the projection will preserve as much variance as possible. + +W2 = V.T[:, :2] +X2D = X_centered.dot(W2) + +## PCA and scikit-learn + +Scikit-Learn’s PCA class implements PCA using SVD decomposition just like we did before. The +following code applies PCA to reduce the dimensionality of the dataset down to two dimensions (note +that it automatically takes care of centering the data): + +#thereafter we do a PCA with Scikit-learn +from sklearn.decomposition import PCA +pca = PCA(n_components = 2) +X2D = pca.fit_transform(X) +print(X2D) + +After fitting the PCA transformer to the dataset, you can access the principal components using the +components variable (note that it contains the PCs as horizontal vectors, so, for example, the first +principal component is equal to + +pca.components_.T[:, 0]. + +Another very useful piece of information is the explained variance ratio of each principal component, +available via the $explained\_variance\_ratio$ variable. It indicates the proportion of the dataset’s +variance that lies along the axis of each principal component. + + +## Back to the Cancer Data +We can now repeat the above but applied to real data, in this case our breast cancer data. +Here we compute performance scores on the training data using logistic regression. + +import matplotlib.pyplot as plt +import numpy as np +from sklearn.model_selection import train_test_split +from sklearn.datasets import load_breast_cancer +from sklearn.linear_model import LogisticRegression +cancer = load_breast_cancer() + +X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) + +logreg = LogisticRegression() +logreg.fit(X_train, y_train) +print("Train set accuracy from Logistic Regression: {:.2f}".format(logreg.score(X_train,y_train))) +# We scale the data +from sklearn.preprocessing import StandardScaler +scaler = StandardScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) +# Then perform again a log reg fit +logreg.fit(X_train_scaled, y_train) +print("Train set accuracy scaled data: {:.2f}".format(logreg.score(X_train_scaled,y_train))) +#thereafter we do a PCA with Scikit-learn +from sklearn.decomposition import PCA +pca = PCA(n_components = 2) +X2D_train = pca.fit_transform(X_train_scaled) +# and finally compute the log reg fit and the score on the training data +logreg.fit(X2D_train,y_train) +print("Train set accuracy scaled and PCA data: {:.2f}".format(logreg.score(X2D_train,y_train))) + +We see that our training data after the PCA decomposition has a performance similar to the non-scaled data. + + +## More on the PCA + +Instead of arbitrarily choosing the number of dimensions to reduce down to, it is generally preferable to +choose the number of dimensions that add up to a sufficiently large portion of the variance (e.g., 95%). +Unless, of course, you are reducing dimensionality for data visualization — in that case you will +generally want to reduce the dimensionality down to 2 or 3. +The following code computes PCA without reducing dimensionality, then computes the minimum number +of dimensions required to preserve 95% of the training set’s variance: + +pca = PCA() +pca.fit(X) +cumsum = np.cumsum(pca.explained_variance_ratio_) +d = np.argmax(cumsum >= 0.95) + 1 + +You could then set $n\_components=d$ and run PCA again. However, there is a much better option: instead +of specifying the number of principal components you want to preserve, you can set $n\_components$ to be +a float between 0.0 and 1.0, indicating the ratio of variance you wish to preserve: + +pca = PCA(n_components=0.95) +X_reduced = pca.fit_transform(X) + +## Incremental PCA + +One problem with the preceding implementation of PCA is that it requires the whole training set to fit in +memory in order for the SVD algorithm to run. Fortunately, Incremental PCA (IPCA) algorithms have +been developed: you can split the training set into mini-batches and feed an IPCA algorithm one minibatch +at a time. This is useful for large training sets, and also to apply PCA online (i.e., on the fly, as new +instances arrive). + + +## Randomized PCA + +Scikit-Learn offers yet another option to perform PCA, called Randomized PCA. This is a stochastic +algorithm that quickly finds an approximation of the first d principal components. Its computational +complexity is $O(m \times d^2)+O(d^3)$, instead of $O(m \times n^2) + O(n^3)$, so it is dramatically faster than the +previous algorithms when $d$ is much smaller than $n$. + + + + + +## Kernel PCA + +The kernel trick is a mathematical technique that implicitly maps instances into a +very high-dimensional space (called the feature space), enabling nonlinear classification and regression +with Support Vector Machines. Recall that a linear decision boundary in the high-dimensional feature +space corresponds to a complex nonlinear decision boundary in the original space. +It turns out that the same trick can be applied to PCA, making it possible to perform complex nonlinear +projections for dimensionality reduction. This is called Kernel PCA (kPCA). It is often good at +preserving clusters of instances after projection, or sometimes even unrolling datasets that lie close to a +twisted manifold. +For example, the following code uses Scikit-Learn’s KernelPCA class to perform kPCA with an + +from sklearn.decomposition import KernelPCA +rbf_pca = KernelPCA(n_components = 2, kernel="rbf", gamma=0.04) +X_reduced = rbf_pca.fit_transform(X) + +## LLE + +Locally Linear Embedding (LLE) is another very powerful nonlinear dimensionality reduction +(NLDR) technique. It is a Manifold Learning technique that does not rely on projections like the previous +algorithms. In a nutshell, LLE works by first measuring how each training instance linearly relates to its +closest neighbors (c.n.), and then looking for a low-dimensional representation of the training set where +these local relationships are best preserved (more details shortly). + + + + +## Other techniques + + +There are many other dimensionality reduction techniques, several of which are available in Scikit-Learn. + +Here are some of the most popular: +* **Multidimensional Scaling (MDS)** reduces dimensionality while trying to preserve the distances between the instances. + +* **Isomap** creates a graph by connecting each instance to its nearest neighbors, then reduces dimensionality while trying to preserve the geodesic distances between the instances. + +* **t-Distributed Stochastic Neighbor Embedding** (t-SNE) reduces dimensionality while trying to keep similar instances close and dissimilar instances apart. It is mostly used for visualization, in particular to visualize clusters of instances in high-dimensional space (e.g., to visualize the MNIST images in 2D). + +* Linear Discriminant Analysis (LDA) is actually a classification algorithm, but during training it learns the most discriminative axes between the classes, and these axes can then be used to define a hyperplane onto which to project the data. The benefit is that the projection will keep classes as far apart as possible, so LDA is a good technique to reduce dimensionality before running another classification algorithm such as a Support Vector Machine (SVM) classifier discussed in the SVM lectures. \ No newline at end of file diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter8_77_1.png b/doc/src/LectureNotes/_build/jupyter_execute/chapter8_77_1.png new file mode 100644 index 0000000000000000000000000000000000000000..6509bb8be4c7e20ee8837ec76a49571109d2ddd2 GIT binary patch literal 26467 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 literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter8_7_0.png b/doc/src/LectureNotes/_build/jupyter_execute/chapter8_7_0.png new file mode 100644 index 0000000000000000000000000000000000000000..71f3c58f8e93f7af152173be70fe33096b6781f5 GIT binary patch literal 64956 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 literal 0 HcmV?d00001 diff --git a/doc/src/LectureNotes/_build/jupyter_execute/chapter8_7_1.png b/doc/src/LectureNotes/_build/jupyter_execute/chapter8_7_1.png new file mode 100644 index 0000000000000000000000000000000000000000..7c2b268201afa2182f6f3e28db0e2af2f8c09d3c GIT binary patch literal 104187 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,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "if our output $y_i=1$.\n", + "In this case we say that $\\boldsymbol{x}_i$ lies on one of the sides of the hyperplane and if" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b+w_1x_{i1}+w_2x_{i2}+\\dots +w_px_{ip} < 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "for the class of observations $y_i=-1$, \n", + "then $\\boldsymbol{x}_i$ lies on the other side. \n", + "\n", + "Equivalently, for the two classes of observations we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i\\left(b+w_1x_{i1}+w_2x_{i2}+\\dots +w_px_{ip}\\right) > 0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "When we try to separate hyperplanes, if it exists, we can use it to construct a natural classifier: a test observation is assigned a given class depending on which side of the hyperplane it is located.\n", + "\n", + "\n", + "## The two-dimensional case\n", + "\n", + "Let us try to develop our intuition about SVMs by limiting ourselves to a two-dimensional\n", + "plane. To separate the two classes of data points, there are many\n", + "possible lines (hyperplanes if you prefer a more strict naming) \n", + "that could be chosen. Our objective is to find a\n", + "plane that has the maximum margin, i.e the maximum distance between\n", + "data points of both classes. Maximizing the margin distance provides\n", + "some reinforcement so that future data points can be classified with\n", + "more confidence.\n", + "\n", + "What a linear classifier attempts to accomplish is to split the\n", + "feature space into two half spaces by placing a hyperplane between the\n", + "data points. This hyperplane will be our decision boundary. All\n", + "points on one side of the plane will belong to class one and all points\n", + "on the other side of the plane will belong to the second class two.\n", + "\n", + "Unfortunately there are many ways in which we can place a hyperplane\n", + "to divide the data. Below is an example of two candidate hyperplanes\n", + "for our data sample.\n", + "\n", + "\n", + "## Getting into the details\n", + "\n", + "Let us define the function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "f(x) = \\boldsymbol{w}^T\\boldsymbol{x}+b = 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "as the function that determines the line $L$ that separates two classes (our two features), see the figure here. \n", + "\n", + "\n", + "Any point defined by $\\boldsymbol{x}_i$ and $\\boldsymbol{x}_2$ on the line $L$ will satisfy $\\boldsymbol{w}^T(\\boldsymbol{x}_1-\\boldsymbol{x}_2)=0$. \n", + "\n", + "The signed distance $\\delta$ from any point defined by a vector $\\boldsymbol{x}$ and a point $\\boldsymbol{x}_0$ on the line $L$ is then" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\delta = \\frac{1}{\\vert\\vert \\boldsymbol{w}\\vert\\vert}(\\boldsymbol{w}^T\\boldsymbol{x}+b).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## First attempt at a minimization approach\n", + "\n", + "How do we find the parameter $b$ and the vector $\\boldsymbol{w}$? What we could\n", + "do is to define a cost function which now contains the set of all\n", + "misclassified points $M$ and attempt to minimize this function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "C(\\boldsymbol{w},b) = -\\sum_{i\\in M} y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We could now for example define all values $y_i =1$ as misclassified in case we have $\\boldsymbol{w}^T\\boldsymbol{x}_i+b < 0$ and the opposite if we have $y_i=-1$. Taking the derivatives gives us" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial C}{\\partial b} = -\\sum_{i\\in M} y_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial C}{\\partial \\boldsymbol{w}} = -\\sum_{i\\in M} y_ix_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Solving the equations\n", + "\n", + "We can now use the Newton-Raphson method or different variants of the gradient descent family (from plain gradient descent to various stochastic gradient descent approaches) to solve the equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b \\leftarrow b +\\eta \\frac{\\partial C}{\\partial b},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{w} \\leftarrow \\boldsymbol{w} +\\eta \\frac{\\partial C}{\\partial \\boldsymbol{w}},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $\\eta$ is our by now well-known learning rate. \n", + "\n", + "\n", + "\n", + "## Code Example\n", + "\n", + "The equations we discussed above can be coded rather easily (the\n", + "framework is similar to what we developed for logistic\n", + "regression). We are going to set up a simple case with two classes only and we want to find a line which separates them the best possible way." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Problems with the Simpler Approach\n", + "\n", + "\n", + "There are however problems with this approach, although it looks\n", + "pretty straightforward to implement. When running the above code, we see that we can easily end up with many diffeent lines which separate the two classes.\n", + "\n", + "\n", + "For small\n", + "gaps between the entries, we may also end up needing many iterations\n", + "before the solutions converge and if the data cannot be separated\n", + "properly into two distinct classes, we may not experience a converge\n", + "at all.\n", + "\n", + "\n", + "## A better approach\n", + "\n", + "A better approach is rather to try to define a large margin between\n", + "the two classes (if they are well separated from the beginning).\n", + "\n", + "Thus, we wish to find a margin $M$ with $\\boldsymbol{w}$ normalized to\n", + "$\\vert\\vert \\boldsymbol{w}\\vert\\vert =1$ subject to the condition" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M \\hspace{0.1cm}\\forall i=1,2,\\dots, p.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "All points are thus at a signed distance from the decision boundary defined by the line $L$. The parameters $b$ and $w_1$ and $w_2$ define this line. \n", + "\n", + "We seek thus the largest value $M$ defined by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{\\vert \\vert \\boldsymbol{w}\\vert\\vert}y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M \\hspace{0.1cm}\\forall i=1,2,\\dots, n,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or just" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M\\vert \\vert \\boldsymbol{w}\\vert\\vert \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If we scale the equation so that $\\vert \\vert \\boldsymbol{w}\\vert\\vert = 1/M$, we have to find the minimum of \n", + "$\\boldsymbol{w}^T\\boldsymbol{w}=\\vert \\vert \\boldsymbol{w}\\vert\\vert$ (the norm) subject to the condition" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq 1 \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We have thus defined our margin as the invers of the norm of\n", + "$\\boldsymbol{w}$. We want to minimize the norm in order to have a as large as\n", + "possible margin $M$. Before we proceed, we need to remind ourselves\n", + "about Lagrangian multipliers.\n", + "\n", + "\n", + "## A quick Reminder on Lagrangian Multipliers\n", + "\n", + "Consider a function of three independent variables $f(x,y,z)$ . For the function $f$ to be an\n", + "extreme we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "df=0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "A necessary and sufficient condition is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial x} =\\frac{\\partial f}{\\partial y}=\\frac{\\partial f}{\\partial z}=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "due to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "df = \\frac{\\partial f}{\\partial x}dx+\\frac{\\partial f}{\\partial y}dy+\\frac{\\partial f}{\\partial z}dz.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In many problems the variables $x,y,z$ are often subject to constraints (such as those above for the margin)\n", + "so that they are no longer all independent. It is possible at least in principle to use each \n", + "constraint to eliminate one variable\n", + "and to proceed with a new and smaller set of independent varables.\n", + "\n", + "The use of so-called Lagrangian multipliers is an alternative technique when the elimination\n", + "of variables is incovenient or undesirable. Assume that we have an equation of constraint on \n", + "the variables $x,y,z$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\phi(x,y,z) = 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "resulting in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "d\\phi = \\frac{\\partial \\phi}{\\partial x}dx+\\frac{\\partial \\phi}{\\partial y}dy+\\frac{\\partial \\phi}{\\partial z}dz =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now we cannot set anymore" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial x} =\\frac{\\partial f}{\\partial y}=\\frac{\\partial f}{\\partial z}=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "if $df=0$ is wanted\n", + "because there are now only two independent variables! Assume $x$ and $y$ are the independent \n", + "variables.\n", + "Then $dz$ is no longer arbitrary.\n", + "\n", + "\n", + "## Adding the Multiplier\n", + "\n", + "However, we can add to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "df = \\frac{\\partial f}{\\partial x}dx+\\frac{\\partial f}{\\partial y}dy+\\frac{\\partial f}{\\partial z}dz,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "a multiplum of $d\\phi$, viz. $\\lambda d\\phi$, resulting in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "df+\\lambda d\\phi = (\\frac{\\partial f}{\\partial z}+\\lambda\n", + "\\frac{\\partial \\phi}{\\partial x})dx+(\\frac{\\partial f}{\\partial y}+\\lambda\\frac{\\partial \\phi}{\\partial y})dy+\n", + "(\\frac{\\partial f}{\\partial z}+\\lambda\\frac{\\partial \\phi}{\\partial z})dz =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Our multiplier is chosen so that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial z}+\\lambda\\frac{\\partial \\phi}{\\partial z} =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We need to remember that we took $dx$ and $dy$ to be arbitrary and thus we must have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial x}+\\lambda\\frac{\\partial \\phi}{\\partial x} =0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial y}+\\lambda\\frac{\\partial \\phi}{\\partial y} =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "When all these equations are satisfied, $df=0$. We have four unknowns, $x,y,z$ and\n", + "$\\lambda$. Actually we want only $x,y,z$, $\\lambda$ needs not to be determined, \n", + "it is therefore often called\n", + "Lagrange's undetermined multiplier.\n", + "If we have a set of constraints $\\phi_k$ we have the equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial f}{\\partial x_i}+\\sum_k\\lambda_k\\frac{\\partial \\phi_k}{\\partial x_i} =0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Setting up the Problem\n", + "In order to solve the above problem, we define the following Lagrangian function to be minimized" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}(\\lambda,b,\\boldsymbol{w})=\\frac{1}{2}\\boldsymbol{w}^T\\boldsymbol{w}-\\sum_{i=1}^n\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)-1\\right],\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $\\lambda_i$ is a so-called Lagrange multiplier subject to the condition $\\lambda_i \\geq 0$.\n", + "\n", + "Taking the derivatives with respect to $b$ and $\\boldsymbol{w}$ we obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial {\\cal L}}{\\partial b} = -\\sum_{i} \\lambda_iy_i=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial {\\cal L}}{\\partial \\boldsymbol{w}} = 0 = \\boldsymbol{w}-\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Inserting these constraints into the equation for ${\\cal L}$ we obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to the constraints $\\lambda_i\\geq 0$ and $\\sum_i\\lambda_iy_i=0$. \n", + "We must in addition satisfy the [Karush-Kuhn-Tucker](https://en.wikipedia.org/wiki/Karush%E2%80%93Kuhn%E2%80%93Tucker_conditions) (KKT) condition" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) -1\\right] \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "1. If $\\lambda_i > 0$, then $y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1$ and we say that $x_i$ is on the boundary.\n", + "\n", + "2. If $y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)> 1$, we say $x_i$ is not on the boundary and we set $\\lambda_i=0$. \n", + "\n", + "When $\\lambda_i > 0$, the vectors $\\boldsymbol{x}_i$ are called support vectors. They are the vectors closest to the line (or hyperplane) and define the margin $M$. \n", + "\n", + "\n", + "## The problem to solve\n", + "\n", + "We can rewrite" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and its constraints in terms of a matrix-vector problem where we minimize w.r.t. $\\lambda$ the following problem" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1\\boldsymbol{x}_1^T\\boldsymbol{x}_1 & y_1y_2\\boldsymbol{x}_1^T\\boldsymbol{x}_2 & \\dots & \\dots & y_1y_n\\boldsymbol{x}_1^T\\boldsymbol{x}_n \\\\\n", + "y_2y_1\\boldsymbol{x}_2^T\\boldsymbol{x}_1 & y_2y_2\\boldsymbol{x}_2^T\\boldsymbol{x}_2 & \\dots & \\dots & y_1y_n\\boldsymbol{x}_2^T\\boldsymbol{x}_n \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "y_ny_1\\boldsymbol{x}_n^T\\boldsymbol{x}_1 & y_ny_2\\boldsymbol{x}_n^T\\boldsymbol{x}_2 & \\dots & \\dots & y_ny_n\\boldsymbol{x}_n^T\\boldsymbol{x}_n \\\\\n", + "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{1}\\boldsymbol{\\lambda},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", + "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", + "\n", + "\n", + "\n", + "## The last steps\n", + "\n", + "Solving the above problem, yields the values of $\\lambda_i$.\n", + "To find the coefficients of your hyperplane we need simply to compute" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{w}=\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With our vector $\\boldsymbol{w}$ we can in turn find the value of the intercept $b$ (here in two dimensions) via" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "resulting in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b = \\frac{1}{y_i}-\\boldsymbol{w}^T\\boldsymbol{x}_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or if we write it out in terms of the support vectors only, with $N_s$ being their number, we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b = \\frac{1}{N_s}\\sum_{j\\in N_s}\\left(y_j-\\sum_{i=1}^n\\lambda_iy_i\\boldsymbol{x}_i^T\\boldsymbol{x}_j\\right).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With our hyperplane coefficients we can use our classifier to assign any observation by simply using" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i = \\mathrm{sign}(\\boldsymbol{w}^T\\boldsymbol{x}_i+b).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Below we discuss how to find the optimal values of $\\lambda_i$. Before we proceed however, we discuss now the so-called soft classifier. \n", + "\n", + "\n", + "## A soft classifier\n", + "\n", + "Till now, the margin is strictly defined by the support vectors. This defines what is called a hard classifier, that is the margins are well defined.\n", + "\n", + "Suppose now that classes overlap in feature space, as shown in the\n", + "figure here. One way to deal with this problem before we define the\n", + "so-called **kernel approach**, is to allow a kind of slack in the sense\n", + "that we allow some points to be on the wrong side of the margin.\n", + "\n", + "We introduce thus the so-called **slack** variables $\\boldsymbol{\\xi} =[\\xi_1,x_2,\\dots,x_n]$ and \n", + "modify our previous equation" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1-\\xi_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with the requirement $\\xi_i\\geq 0$. The total violation is now $\\sum_i\\xi$. \n", + "The value $\\xi_i$ in the constraint the last constraint corresponds to the amount by which the prediction\n", + "$y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1$ is on the wrong side of its margin. Hence by bounding the sum $\\sum_i \\xi_i$,\n", + "we bound the total amount by which predictions fall on the wrong side of their margins.\n", + "\n", + "Misclassifications occur when $\\xi_i > 1$. Thus bounding the total sum by some value $C$ bounds in turn the total number of\n", + "misclassifications.\n", + "\n", + "\n", + "## Soft optmization problem\n", + "\n", + "\n", + "This has in turn the consequences that we change our optmization problem to finding the minimum of" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\frac{1}{2}\\boldsymbol{w}^T\\boldsymbol{w}-\\sum_{i=1}^n\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)-(1-\\xi_)\\right]+C\\sum_{i=1}^n\\xi_i-\\sum_{i=1}^n\\gamma_i\\xi_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1-\\xi_i \\hspace{0.1cm}\\forall i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with the requirement $\\xi_i\\geq 0$.\n", + "\n", + "Taking the derivatives with respect to $b$ and $\\boldsymbol{w}$ we obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial {\\cal L}}{\\partial b} = -\\sum_{i} \\lambda_iy_i=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial {\\cal L}}{\\partial \\boldsymbol{w}} = 0 = \\boldsymbol{w}-\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\lambda_i = C-\\gamma_i \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Inserting these constraints into the equation for ${\\cal L}$ we obtain the same equation as before" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "but now subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$ and $0\\leq\\lambda_i \\leq C$. \n", + "We must in addition satisfy the Karush-Kuhn-Tucker condition which now reads" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "5\n", + "0\n", + " \n", + "<\n", + "<\n", + "<\n", + "!\n", + "!\n", + "M\n", + "A\n", + "T\n", + "H\n", + "_\n", + "B\n", + "L\n", + "O\n", + "C\n", + "K" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\gamma_i\\xi_i = 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) -(1-\\xi_) \\geq 0 \\hspace{0.1cm}\\forall i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Kernels and non-linearity\n", + "\n", + "The cases we have studied till now, were all characterized by two classes\n", + "with a close to linear separability. The classifiers we have described\n", + "so far find linear boundaries in our input feature space. It is\n", + "possible to make our procedure more flexible by exploring the feature\n", + "space using other basis expansions such as higher-order polynomials,\n", + "wavelets, splines etc.\n", + "\n", + "If our feature space is not easy to separate, as shown in the figure\n", + "here, we can achieve a better separation by introducing more complex\n", + "basis functions. The ideal would be, as shown in the next figure, to, via a specific transformation to \n", + "obtain a separation between the classes which is almost linear. \n", + "\n", + "The change of basis, from $x\\rightarrow z=\\phi(x)$ leads to the same type of equations to be solved, except that\n", + "we need to introduce for example a polynomial transformation to a two-dimensional training set." + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import os\n", + "\n", + "np.random.seed(42)\n", + "\n", + "# To plot pretty figures\n", + "import matplotlib\n", + "import matplotlib.pyplot as plt\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", + "\n", + "\n", + "\n", + "X1D = np.linspace(-4, 4, 9).reshape(-1, 1)\n", + "X2D = np.c_[X1D, X1D**2]\n", + "y = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])\n", + "\n", + "plt.figure(figsize=(11, 4))\n", + "\n", + "plt.subplot(121)\n", + "plt.grid(True, which='both')\n", + "plt.axhline(y=0, color='k')\n", + "plt.plot(X1D[:, 0][y==0], np.zeros(4), \"bs\")\n", + "plt.plot(X1D[:, 0][y==1], np.zeros(5), \"g^\")\n", + "plt.gca().get_yaxis().set_ticks([])\n", + "plt.xlabel(r\"$x_1$\", fontsize=20)\n", + "plt.axis([-4.5, 4.5, -0.2, 0.2])\n", + "\n", + "plt.subplot(122)\n", + "plt.grid(True, which='both')\n", + "plt.axhline(y=0, color='k')\n", + "plt.axvline(x=0, color='k')\n", + "plt.plot(X2D[:, 0][y==0], X2D[:, 1][y==0], \"bs\")\n", + "plt.plot(X2D[:, 0][y==1], X2D[:, 1][y==1], \"g^\")\n", + "plt.xlabel(r\"$x_1$\", fontsize=20)\n", + "plt.ylabel(r\"$x_2$\", fontsize=20, rotation=0)\n", + "plt.gca().get_yaxis().set_ticks([0, 4, 8, 12, 16])\n", + "plt.plot([-4.5, 4.5], [6.5, 6.5], \"r--\", linewidth=3)\n", + "plt.axis([-4.5, 4.5, -1, 17])\n", + "plt.subplots_adjust(right=1)\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## The equations\n", + "\n", + "Suppose we define a polynomial transformation of degree two only (we continue to live in a plane with $x_i$ and $y_i$ as variables)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "z = \\phi(x_i) =\\left(x_i^2, y_i^2, \\sqrt{2}x_iy_i\\right).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With our new basis, the equations we solved earlier are basically the same, that is we have now (without the slack option for simplicity)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{z}_i^T\\boldsymbol{z}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$, and for the support vectors" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i(\\boldsymbol{w}^T\\boldsymbol{z}_i+b)= 1 \\hspace{0.1cm}\\forall i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "from which we also find $b$.\n", + "To compute $\\boldsymbol{z}_i^T\\boldsymbol{z}_j$ we define the kernel $K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=\\boldsymbol{z}_i^T\\boldsymbol{z}_j= \\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "For the above example, the kernel reads" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=[x_i^2, y_i^2, \\sqrt{2}x_iy_i]^T\\begin{bmatrix} x_j^2 \\\\ y_j^2 \\\\ \\sqrt{2}x_jy_j \\end{bmatrix}=x_i^2x_j^2+2x_ix_jy_iy_j+y_i^2y_j^2.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We note that this is nothing but the dot product of the two original\n", + "vectors $(\\boldsymbol{x}_i^T\\boldsymbol{x}_j)^2$. Instead of thus computing the\n", + "product in the Lagrangian of $\\boldsymbol{z}_i^T\\boldsymbol{z}_j$ we simply compute\n", + "the dot product $(\\boldsymbol{x}_i^T\\boldsymbol{x}_j)^2$.\n", + "\n", + "\n", + "This leads to the so-called\n", + "kernel trick and the result leads to the same as if we went through\n", + "the trouble of performing the transformation\n", + "$\\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j)$ during the SVM calculations.\n", + "\n", + "\n", + "\n", + "## The problem to solve\n", + "Using our definition of the kernel We can rewrite again the Lagrangian" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "{\\cal L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{z}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$ in terms of a convex optimization problem" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1K(\\boldsymbol{x}_1,\\boldsymbol{x}_1) & y_1y_2K(\\boldsymbol{x}_1,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_1,\\boldsymbol{x}_n) \\\\\n", + "y_2y_1K(\\boldsymbol{x}_2,\\boldsymbol{x}_1) & y_2y_2(\\boldsymbol{x}_2,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_2,\\boldsymbol{x}_n) \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "y_ny_1K(\\boldsymbol{x}_n,\\boldsymbol{x}_1) & y_ny_2K(\\boldsymbol{x}_n\\boldsymbol{x}_2) & \\dots & \\dots & y_ny_nK(\\boldsymbol{x}_n,\\boldsymbol{x}_n) \\\\\n", + "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{1}\\boldsymbol{\\lambda},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", + "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", + "If we add the slack constants this leads to the additional constraint $0\\leq \\lambda_i \\leq C$.\n", + "\n", + "We can rewrite this (see the solutions below) in terms of a convex optimization problem of the type" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + " &\\mathrm{min}_{\\lambda}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{\\lambda}^T\\boldsymbol{P}\\boldsymbol{\\lambda}+\\boldsymbol{q}^T\\boldsymbol{\\lambda},\\\\ \\nonumber\n", + " &\\mathrm{subject\\hspace{0.1cm}to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{\\lambda} \\preceq \\boldsymbol{h} \\hspace{0.2cm} \\wedge \\boldsymbol{A}\\boldsymbol{\\lambda}=f.\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Below we discuss how to solve these equations. Here we note that the matrix $\\boldsymbol{P}$ has matrix elements $p_{ij}=y_iy_jK(\\boldsymbol{x}_i,\\boldsymbol{x}_j)$.\n", + "Given a kernel $K$ and the targets $y_i$ this matrix is easy to set up. The constraint $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$ leads to $f=0$ and $\\boldsymbol{A}=\\boldsymbol{y}$. How to set up the matrix $\\boldsymbol{G}$ is discussed later. Here note that the inequalities $0\\leq \\lambda_i \\leq C$ can be split up into\n", + "$0\\leq \\lambda_i$ and $\\lambda_i \\leq C$. These two inequalities define then the matrix $\\boldsymbol{G}$ and the vector $\\boldsymbol{h}$.\n", + "\n", + "\n", + "\n", + "## Different kernels and Mercer's theorem\n", + "\n", + "There are several popular kernels being used. These are\n", + "1. Linear: $K(\\boldsymbol{x},\\boldsymbol{y})=\\boldsymbol{x}^T\\boldsymbol{y}$,\n", + "\n", + "2. Polynomial: $K(\\boldsymbol{x},\\boldsymbol{y})=(\\boldsymbol{x}^T\\boldsymbol{y}+\\gamma)^d$,\n", + "\n", + "3. Gaussian Radial Basis Function: $K(\\boldsymbol{x},\\boldsymbol{y})=\\exp{\\left(-\\gamma\\vert\\vert\\boldsymbol{x}-\\boldsymbol{y}\\vert\\vert^2\\right)}$,\n", + "\n", + "4. Tanh: $K(\\boldsymbol{x},\\boldsymbol{y})=\\tanh{(\\boldsymbol{x}^T\\boldsymbol{y}+\\gamma)}$,\n", + "\n", + "and many other ones.\n", + "\n", + "An important theorem for us is [Mercer's\n", + "theorem](https://en.wikipedia.org/wiki/Mercer%27s_theorem). The\n", + "theorem states that if a kernel function $K$ is symmetric, continuous\n", + "and leads to a positive semi-definite matrix $\\boldsymbol{P}$ then there\n", + "exists a function $\\phi$ that maps $\\boldsymbol{x}_i$ and $\\boldsymbol{x}_j$ into\n", + "another space (possibly with much higher dimensions) such that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=\\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "So you can use $K$ as a kernel since you know $\\phi$ exists, even if\n", + "you don’t know what $\\phi$ is. \n", + "\n", + "Note that some frequently used kernels (such as the Sigmoid kernel)\n", + "don’t respect all of Mercer’s conditions, yet they generally work well\n", + "in practice.\n", + "\n", + "\n", + "\n", + "## The moons example" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "from __future__ import division, print_function, unicode_literals\n", + "\n", + "import numpy as np\n", + "np.random.seed(42)\n", + "\n", + "import matplotlib\n", + "import matplotlib.pyplot as plt\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", + "\n", + "\n", + "\n", + "from sklearn.pipeline import Pipeline\n", + "from sklearn.preprocessing import StandardScaler\n", + "from sklearn.svm import LinearSVC\n", + "\n", + "\n", + "from sklearn.datasets import make_moons\n", + "X, y = make_moons(n_samples=100, noise=0.15, random_state=42)\n", + "\n", + "def plot_dataset(X, y, axes):\n", + " plt.plot(X[:, 0][y==0], X[:, 1][y==0], \"bs\")\n", + " plt.plot(X[:, 0][y==1], X[:, 1][y==1], \"g^\")\n", + " plt.axis(axes)\n", + " plt.grid(True, which='both')\n", + " plt.xlabel(r\"$x_1$\", fontsize=20)\n", + " plt.ylabel(r\"$x_2$\", fontsize=20, rotation=0)\n", + "\n", + "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + "plt.show()\n", + "\n", + "from sklearn.datasets import make_moons\n", + "from sklearn.pipeline import Pipeline\n", + "from sklearn.preprocessing import PolynomialFeatures\n", + "\n", + "polynomial_svm_clf = Pipeline([\n", + " (\"poly_features\", PolynomialFeatures(degree=3)),\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", LinearSVC(C=10, loss=\"hinge\", random_state=42))\n", + " ])\n", + "\n", + "polynomial_svm_clf.fit(X, y)\n", + "\n", + "def plot_predictions(clf, axes):\n", + " x0s = np.linspace(axes[0], axes[1], 100)\n", + " x1s = np.linspace(axes[2], axes[3], 100)\n", + " x0, x1 = np.meshgrid(x0s, x1s)\n", + " X = np.c_[x0.ravel(), x1.ravel()]\n", + " y_pred = clf.predict(X).reshape(x0.shape)\n", + " y_decision = clf.decision_function(X).reshape(x0.shape)\n", + " plt.contourf(x0, x1, y_pred, cmap=plt.cm.brg, alpha=0.2)\n", + " plt.contourf(x0, x1, y_decision, cmap=plt.cm.brg, alpha=0.1)\n", + "\n", + "plot_predictions(polynomial_svm_clf, [-1.5, 2.5, -1, 1.5])\n", + "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + "\n", + "plt.show()\n", + "\n", + "\n", + "from sklearn.svm import SVC\n", + "\n", + "poly_kernel_svm_clf = Pipeline([\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", SVC(kernel=\"poly\", degree=3, coef0=1, C=5))\n", + " ])\n", + "poly_kernel_svm_clf.fit(X, y)\n", + "\n", + "poly100_kernel_svm_clf = Pipeline([\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", SVC(kernel=\"poly\", degree=10, coef0=100, C=5))\n", + " ])\n", + "poly100_kernel_svm_clf.fit(X, y)\n", + "\n", + "plt.figure(figsize=(11, 4))\n", + "\n", + "plt.subplot(121)\n", + "plot_predictions(poly_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])\n", + "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + "plt.title(r\"$d=3, r=1, C=5$\", fontsize=18)\n", + "\n", + "plt.subplot(122)\n", + "plot_predictions(poly100_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])\n", + "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + "plt.title(r\"$d=10, r=100, C=5$\", fontsize=18)\n", + "\n", + "plt.show()\n", + "\n", + "def gaussian_rbf(x, landmark, gamma):\n", + " return np.exp(-gamma * np.linalg.norm(x - landmark, axis=1)**2)\n", + "\n", + "gamma = 0.3\n", + "\n", + "x1s = np.linspace(-4.5, 4.5, 200).reshape(-1, 1)\n", + "x2s = gaussian_rbf(x1s, -2, gamma)\n", + "x3s = gaussian_rbf(x1s, 1, gamma)\n", + "\n", + "XK = np.c_[gaussian_rbf(X1D, -2, gamma), gaussian_rbf(X1D, 1, gamma)]\n", + "yk = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])\n", + "\n", + "plt.figure(figsize=(11, 4))\n", + "\n", + "plt.subplot(121)\n", + "plt.grid(True, which='both')\n", + "plt.axhline(y=0, color='k')\n", + "plt.scatter(x=[-2, 1], y=[0, 0], s=150, alpha=0.5, c=\"red\")\n", + "plt.plot(X1D[:, 0][yk==0], np.zeros(4), \"bs\")\n", + "plt.plot(X1D[:, 0][yk==1], np.zeros(5), \"g^\")\n", + "plt.plot(x1s, x2s, \"g--\")\n", + "plt.plot(x1s, x3s, \"b:\")\n", + "plt.gca().get_yaxis().set_ticks([0, 0.25, 0.5, 0.75, 1])\n", + "plt.xlabel(r\"$x_1$\", fontsize=20)\n", + "plt.ylabel(r\"Similarity\", fontsize=14)\n", + "plt.annotate(r'$\\mathbf{x}$',\n", + " xy=(X1D[3, 0], 0),\n", + " xytext=(-0.5, 0.20),\n", + " ha=\"center\",\n", + " arrowprops=dict(facecolor='black', shrink=0.1),\n", + " fontsize=18,\n", + " )\n", + "plt.text(-2, 0.9, \"$x_2$\", ha=\"center\", fontsize=20)\n", + "plt.text(1, 0.9, \"$x_3$\", ha=\"center\", fontsize=20)\n", + "plt.axis([-4.5, 4.5, -0.1, 1.1])\n", + "\n", + "plt.subplot(122)\n", + "plt.grid(True, which='both')\n", + "plt.axhline(y=0, color='k')\n", + "plt.axvline(x=0, color='k')\n", + "plt.plot(XK[:, 0][yk==0], XK[:, 1][yk==0], \"bs\")\n", + "plt.plot(XK[:, 0][yk==1], XK[:, 1][yk==1], \"g^\")\n", + "plt.xlabel(r\"$x_2$\", fontsize=20)\n", + "plt.ylabel(r\"$x_3$ \", fontsize=20, rotation=0)\n", + "plt.annotate(r'$\\phi\\left(\\mathbf{x}\\right)$',\n", + " xy=(XK[3, 0], XK[3, 1]),\n", + " xytext=(0.65, 0.50),\n", + " ha=\"center\",\n", + " arrowprops=dict(facecolor='black', shrink=0.1),\n", + " fontsize=18,\n", + " )\n", + "plt.plot([-0.1, 1.1], [0.57, -0.1], \"r--\", linewidth=3)\n", + "plt.axis([-0.1, 1.1, -0.1, 1.1])\n", + " \n", + "plt.subplots_adjust(right=1)\n", + "\n", + "plt.show()\n", + "\n", + "\n", + "x1_example = X1D[3, 0]\n", + "for landmark in (-2, 1):\n", + " k = gaussian_rbf(np.array([[x1_example]]), np.array([[landmark]]), gamma)\n", + " print(\"Phi({}, {}) = {}\".format(x1_example, landmark, k))\n", + "\n", + "rbf_kernel_svm_clf = Pipeline([\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", SVC(kernel=\"rbf\", gamma=5, C=0.001))\n", + " ])\n", + "rbf_kernel_svm_clf.fit(X, y)\n", + "\n", + "\n", + "from sklearn.svm import SVC\n", + "\n", + "gamma1, gamma2 = 0.1, 5\n", + "C1, C2 = 0.001, 1000\n", + "hyperparams = (gamma1, C1), (gamma1, C2), (gamma2, C1), (gamma2, C2)\n", + "\n", + "svm_clfs = []\n", + "for gamma, C in hyperparams:\n", + " rbf_kernel_svm_clf = Pipeline([\n", + " (\"scaler\", StandardScaler()),\n", + " (\"svm_clf\", SVC(kernel=\"rbf\", gamma=gamma, C=C))\n", + " ])\n", + " rbf_kernel_svm_clf.fit(X, y)\n", + " svm_clfs.append(rbf_kernel_svm_clf)\n", + "\n", + "plt.figure(figsize=(11, 7))\n", + "\n", + "for i, svm_clf in enumerate(svm_clfs):\n", + " plt.subplot(221 + i)\n", + " plot_predictions(svm_clf, [-1.5, 2.5, -1, 1.5])\n", + " plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", + " gamma, C = hyperparams[i]\n", + " plt.title(r\"$\\gamma = {}, C = {}$\".format(gamma, C), fontsize=16)\n", + "\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Mathematical optimization of convex functions\n", + "\n", + "A mathematical (quadratic) optimization problem, or just optimization problem, has the form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + " &\\mathrm{min}_{\\lambda}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{\\lambda}^T\\boldsymbol{P}\\boldsymbol{\\lambda}+\\boldsymbol{q}^T\\boldsymbol{\\lambda},\\\\ \\nonumber\n", + " &\\mathrm{subject\\hspace{0.1cm}to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{\\lambda} \\preceq \\boldsymbol{h} \\wedge \\boldsymbol{A}\\boldsymbol{\\lambda}=f.\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to some constraints for say a selected set $i=1,2,\\dots, n$.\n", + "In our case we are optimizing with respect to the Lagrangian multipliers $\\lambda_i$, and the\n", + "vector $\\boldsymbol{\\lambda}=[\\lambda_1, \\lambda_2,\\dots, \\lambda_n]$ is the optimization variable we are dealing with.\n", + "\n", + "In our case we are particularly interested in a class of optimization problems called convex optmization problems. \n", + "In our discussion on gradient descent methods we discussed at length the definition of a convex function. \n", + "\n", + "Convex optimization problems play a central role in applied mathematics and we recommend strongly [Boyd and Vandenberghe's text on the topics](http://web.stanford.edu/~boyd/cvxbook/).\n", + "\n", + "\n", + "\n", + "\n", + "## How do we solve these problems?\n", + "\n", + "If we use Python as programming language and wish to venture beyond\n", + "**scikit-learn**, **tensorflow** and similar software which makes our\n", + "lives so much easier, we need to dive into the wonderful world of\n", + "quadratic programming. We can, if we wish, solve the minimization\n", + "problem using say standard gradient methods or conjugate gradient\n", + "methods. However, these methods tend to exhibit a rather slow\n", + "converge. So, welcome to the promised land of quadratic programming.\n", + "\n", + "The functions we need are contained in the quadratic programming package **CVXOPT** and we need to import it together with **numpy** as" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy\n", + "import cvxopt" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This will make our life much easier. You don't need t write your own optimizer.\n", + "\n", + "\n", + "\n", + "## A simple example\n", + "\n", + "We remind ourselves about the general problem we want to solve" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + " &\\mathrm{min}_{x}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{P}\\boldsymbol{x}+\\boldsymbol{q}^T\\boldsymbol{x},\\\\ \\nonumber\n", + " &\\mathrm{subject\\hspace{0.1cm} to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{x} \\preceq \\boldsymbol{h} \\wedge \\boldsymbol{A}\\boldsymbol{x}=f.\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Let us show how to perform the optmization using a simple case. Assume we want to optimize the following problem" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + " &\\mathrm{min}_{x}\\hspace{0.2cm} \\frac{1}{2}x^2+5x+3y \\\\ \\nonumber\n", + " &\\mathrm{subject to} \\\\ \\nonumber\n", + " &x, y \\geq 0 \\\\ \\nonumber\n", + " &x+3y \\geq 15 \\\\ \\nonumber\n", + " &2x+5y \\leq 100 \\\\ \\nonumber\n", + " &3x+4y \\leq 80. \\\\ \\nonumber\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The minimization problem can be rewritten in terms of vectors and matrices as (with $x$ and $y$ being the unknowns)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{2}\\begin{bmatrix} x\\\\ y \\end{bmatrix}^T \\begin{bmatrix} 1 & 0\\\\ 0 & 0 \\end{bmatrix} \\begin{bmatrix} x \\\\ y \\end{bmatrix} + \\begin{bmatrix}3\\\\ 4 \\end{bmatrix}^T \\begin{bmatrix}x \\\\ y \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Similarly, we can now set up the inequalities (we need to change $\\geq$ to $\\leq$ by multiplying with $-1$ on bot sides) as the following matrix-vector equation" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{bmatrix} -1 & 0 \\\\ 0 & -1 \\\\ -1 & -3 \\\\ 2 & 5 \\\\ 3 & 4\\end{bmatrix}\\begin{bmatrix} x \\\\ y\\end{bmatrix} \\preceq \\begin{bmatrix}0 \\\\ 0\\\\ -15 \\\\ 100 \\\\ 80\\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We have collapsed all the inequalities into a single matrix $\\boldsymbol{G}$. We see also that our matrix" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{P} =\\begin{bmatrix} 1 & 0\\\\ 0 & 0 \\end{bmatrix}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "is clearly positive semi-definite (all eigenvalues larger or equal zero). \n", + "Finally, the vector $\\boldsymbol{h}$ is defined as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{h} = \\begin{bmatrix}0 \\\\ 0\\\\ -15 \\\\ 100 \\\\ 80\\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Since we don't have any equalities the matrix $\\boldsymbol{A}$ is set to zero\n", + "The following code solves the equations for us" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "# Import the necessary packages\n", + "import numpy\n", + "from cvxopt import matrix\n", + "from cvxopt import solvers\n", + "P = matrix(numpy.diag([1,0]), tc=’d’)\n", + "q = matrix(numpy.array([3,4]), tc=’d’)\n", + "G = matrix(numpy.array([[-1,0],[0,-1],[-1,-3],[2,5],[3,4]]), tc=’d’)\n", + "h = matrix(numpy.array([0,0,-15,100,80]), tc=’d’)\n", + "# Construct the QP, invoke solver\n", + "sol = solvers.qp(P,q,G,h)\n", + "# Extract optimal value and solution\n", + "sol[’x’] \n", + "sol[’primal objective’]" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Back to the more realistic cases\n", + "\n", + "We are now ready to return to our setup of the optmization problem for a more realistic case. Introducing the **slack** parameter $C$ we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1K(\\boldsymbol{x}_1,\\boldsymbol{x}_1) & y_1y_2K(\\boldsymbol{x}_1,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_1,\\boldsymbol{x}_n) \\\\\n", + "y_2y_1K(\\boldsymbol{x}_2,\\boldsymbol{x}_1) & y_2y_2K(\\boldsymbol{x}_2,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_2,\\boldsymbol{x}_n) \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "y_ny_1K(\\boldsymbol{x}_n,\\boldsymbol{x}_1) & y_ny_2K(\\boldsymbol{x}_n\\boldsymbol{x}_2) & \\dots & \\dots & y_ny_nK(\\boldsymbol{x}_n,\\boldsymbol{x}_n) \\\\\n", + "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{I}\\boldsymbol{\\lambda},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", + "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", + "With the slack constants this leads to the additional constraint $0\\leq \\lambda_i \\leq C$.\n", + "\n", + "**code will be added**" + ] + } + ], + "metadata": {}, + "nbformat": 4, + "nbformat_minor": 4 +} diff --git a/doc/src/LectureNotes/chapter8.ipynb b/doc/src/LectureNotes/chapter8.ipynb new file mode 100644 index 000000000..86dc8a18f --- /dev/null +++ b/doc/src/LectureNotes/chapter8.ipynb @@ -0,0 +1,1923 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Dimensionality Reduction\n", + "\n", + "\n", + "## Reducing the number of degrees of freedom, overarching view\n", + "\n", + "Many Machine Learning problems involve thousands or even millions of\n", + "features for each training instance. Not only does this make training\n", + "extremely slow, it can also make it much harder to find a good\n", + "solution, as we will see. This problem is often referred to as the\n", + "curse of dimensionality. Fortunately, in real-world problems, it is\n", + "often possible to reduce the number of features considerably, turning\n", + "an intractable problem into a tractable one.\n", + "\n", + "Here we will discuss some of the most popular dimensionality reduction\n", + "techniques: the principal component analysis (PCA), Kernel PCA, and\n", + "Locally Linear Embedding (LLE). Furthermore, we will start by looking\n", + "at some simple preprocessing of the data which allow us to rescale the\n", + "data.\n", + "\n", + "Principal component analysis and its various variants deal with the\n", + "problem of fitting a low-dimensional [affine\n", + "subspace](https://en.wikipedia.org/wiki/Affine_space) to a set of of\n", + "data points in a high-dimensional space. With its family of methods it\n", + "is one of the most used tools in data modeling, compression and\n", + "visualization.\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Preprocessing our data\n", + "\n", + "Before we proceed however, we will discuss how to preprocess our\n", + "data. Till now and in connection with our previous examples we have\n", + "not met so many cases where we are too sensitive to the scaling of our\n", + "data. Normally the data may need a rescaling and/or may be sensitive\n", + "to extreme values. Scaling the data renders our inputs much more\n", + "suitable for the algorithms we want to employ.\n", + "\n", + "**Scikit-Learn** has several functions which allow us to rescale the\n", + "data, normally resulting in much better results in terms of various\n", + "accuracy scores. The **StandardScaler** function in **Scikit-Learn**\n", + "ensures that for each feature/predictor we study the mean value is\n", + "zero and the variance is one (every column in the design/feature\n", + "matrix). This scaling has the drawback that it does not ensure that\n", + "we have a particular maximum or minimum in our data set. Another\n", + "function included in **Scikit-Learn** is the **MinMaxScaler** which\n", + "ensures that all features are exactly between $0$ and $1$. The\n", + "\n", + "\n", + "## More preprocessing\n", + "\n", + "\n", + "The **Normalizer** scales each data\n", + "point such that the feature vector has a euclidean length of one. In other words, it\n", + "projects a data point on the circle (or sphere in the case of higher dimensions) with a\n", + "radius of 1. This means every data point is scaled by a different number (by the\n", + "inverse of it’s length).\n", + "This normalization is often used when only the direction (or angle) of the data matters,\n", + "not the length of the feature vector.\n", + "\n", + "The **RobustScaler** works similarly to the StandardScaler in that it\n", + "ensures statistical properties for each feature that guarantee that\n", + "they are on the same scale. However, the RobustScaler uses the median\n", + "and quartiles, instead of mean and variance. This makes the\n", + "RobustScaler ignore data points that are very different from the rest\n", + "(like measurement errors). These odd data points are also called\n", + "outliers, and might often lead to trouble for other scaling\n", + "techniques.\n", + "\n", + "\n", + "\n", + "\n", + "## Simple preprocessing examples, Franke function and regression" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "%matplotlib inline\n", + "\n", + "# Common imports\n", + "import os\n", + "import numpy as np\n", + "import pandas as pd\n", + "import matplotlib.pyplot as plt\n", + "import sklearn.linear_model as skl\n", + "from sklearn.metrics import mean_squared_error\n", + "from sklearn.model_selection import train_test_split\n", + "from sklearn.preprocessing import MinMaxScaler, StandardScaler, Normalizer\n", + "from sklearn.svm import SVR\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", + "\n", + "def FrankeFunction(x,y):\n", + "\tterm1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))\n", + "\tterm2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))\n", + "\tterm3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))\n", + "\tterm4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)\n", + "\treturn term1 + term2 + term3 + term4\n", + "\n", + "\n", + "def create_X(x, y, n ):\n", + "\tif len(x.shape) > 1:\n", + "\t\tx = np.ravel(x)\n", + "\t\ty = np.ravel(y)\n", + "\n", + "\tN = len(x)\n", + "\tl = int((n+1)*(n+2)/2)\t\t# Number of elements in beta\n", + "\tX = np.ones((N,l))\n", + "\n", + "\tfor i in range(1,n+1):\n", + "\t\tq = int((i)*(i+1)/2)\n", + "\t\tfor k in range(i+1):\n", + "\t\t\tX[:,q+k] = (x**(i-k))*(y**k)\n", + "\n", + "\treturn X\n", + "\n", + "\n", + "# Making meshgrid of datapoints and compute Franke's function\n", + "n = 5\n", + "N = 1000\n", + "x = np.sort(np.random.uniform(0, 1, N))\n", + "y = np.sort(np.random.uniform(0, 1, N))\n", + "z = FrankeFunction(x, y)\n", + "X = create_X(x, y, n=n) \n", + "# split in training and test data\n", + "X_train, X_test, y_train, y_test = train_test_split(X,z,test_size=0.2)\n", + "\n", + "\n", + "svm = SVR(gamma='auto',C=10.0)\n", + "svm.fit(X_train, y_train)\n", + "\n", + "# The mean squared error and R2 score\n", + "print(\"MSE before scaling: {:.2f}\".format(mean_squared_error(svm.predict(X_test), y_test)))\n", + "print(\"R2 score before scaling {:.2f}\".format(svm.score(X_test,y_test)))\n", + "\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", + "\n", + "print(\"Feature min values before scaling:\\n {}\".format(X_train.min(axis=0)))\n", + "print(\"Feature max values before scaling:\\n {}\".format(X_train.max(axis=0)))\n", + "\n", + "print(\"Feature min values after scaling:\\n {}\".format(X_train_scaled.min(axis=0)))\n", + "print(\"Feature max values after scaling:\\n {}\".format(X_train_scaled.max(axis=0)))\n", + "\n", + "svm = SVR(gamma='auto',C=10.0)\n", + "svm.fit(X_train_scaled, y_train)\n", + "\n", + "print(\"MSE after scaling: {:.2f}\".format(mean_squared_error(svm.predict(X_test_scaled), y_test)))\n", + "print(\"R2 score for scaled data: {:.2f}\".format(svm.score(X_test_scaled,y_test)))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Simple preprocessing examples, breast cancer data and classification, Support Vector Machines\n", + "\n", + "We show here how we can use a simple regression case on the breast\n", + "cancer data using support vector machines (SVM) as algorithm for\n", + "classification." + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "collapsed": false + }, + "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", + "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", + "\n", + "svm = SVC(C=100)\n", + "svm.fit(X_train, y_train)\n", + "print(\"Test set accuracy: {:.2f}\".format(svm.score(X_test,y_test)))\n", + "\n", + "from sklearn.preprocessing import MinMaxScaler, StandardScaler\n", + "scaler = MinMaxScaler()\n", + "scaler.fit(X_train)\n", + "X_train_scaled = scaler.transform(X_train)\n", + "X_test_scaled = scaler.transform(X_test)\n", + "\n", + "print(\"Feature min values before scaling:\\n {}\".format(X_train.min(axis=0)))\n", + "print(\"Feature max values before scaling:\\n {}\".format(X_train.max(axis=0)))\n", + "\n", + "print(\"Feature min values before scaling:\\n {}\".format(X_train_scaled.min(axis=0)))\n", + "print(\"Feature max values before scaling:\\n {}\".format(X_train_scaled.max(axis=0)))\n", + "\n", + "\n", + "svm.fit(X_train_scaled, y_train)\n", + "print(\"Test set accuracy scaled data with Min-Max scaling: {:.2f}\".format(svm.score(X_test_scaled,y_test)))\n", + "\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", + "\n", + "svm.fit(X_train_scaled, y_train)\n", + "print(\"Test set accuracy scaled data with Standar Scaler: {:.2f}\".format(svm.score(X_test_scaled,y_test)))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## More on Cancer Data, now with Logistic Regression" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": { + "collapsed": false + }, + "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.linear_model import LogisticRegression\n", + "cancer = load_breast_cancer()\n", + "\n", + "# Set up training data\n", + "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", + "logreg = LogisticRegression()\n", + "logreg.fit(X_train, y_train)\n", + "print(\"Test set accuracy: {:.2f}\".format(logreg.score(X_test,y_test)))\n", + "\n", + "# Scale 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", + "logreg.fit(X_train_scaled, y_train)\n", + "print(\"Test set accuracy scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Why should we think of reducing the dimensionality\n", + "\n", + "In addition to the plot of the features, we study now also the covariance (and the correlation matrix).\n", + "We use also **Pandas** to compute the correlation matrix." + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": { + "collapsed": false + }, + "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.linear_model import LogisticRegression\n", + "cancer = load_breast_cancer()\n", + "import pandas as pd\n", + "# Making a data frame\n", + "cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)\n", + "\n", + "fig, axes = plt.subplots(15,2,figsize=(10,20))\n", + "malignant = cancer.data[cancer.target == 0]\n", + "benign = cancer.data[cancer.target == 1]\n", + "ax = axes.ravel()\n", + "\n", + "for i in range(30):\n", + " _, bins = np.histogram(cancer.data[:,i], bins =50)\n", + " ax[i].hist(malignant[:,i], bins = bins, alpha = 0.5)\n", + " ax[i].hist(benign[:,i], bins = bins, alpha = 0.5)\n", + " ax[i].set_title(cancer.feature_names[i])\n", + " ax[i].set_yticks(())\n", + "ax[0].set_xlabel(\"Feature magnitude\")\n", + "ax[0].set_ylabel(\"Frequency\")\n", + "ax[0].legend([\"Malignant\", \"Benign\"], loc =\"best\")\n", + "fig.tight_layout()\n", + "plt.show()\n", + "\n", + "import seaborn as sns\n", + "correlation_matrix = cancerpd.corr().round(1)\n", + "# use the heatmap function from seaborn to plot the correlation matrix\n", + "# annot = True to print the values inside the square\n", + "sns.heatmap(data=correlation_matrix, annot=True)\n", + "plt.show()\n", + "\n", + "#print eigvalues of correlation matrix\n", + "EigValues, EigVectors = np.linalg.eig(correlation_matrix)\n", + "print(EigValues)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the above example we note two things. In the first plot we display\n", + "the overlap of benign and malignant tumors as functions of the various\n", + "features in the Wisconsing breast cancer data set. We see that for\n", + "some of the features we can distinguish clearly the benign and\n", + "malignant cases while for other features we cannot. This can point to\n", + "us which features may be of greater interest when we wish to classify\n", + "a benign or not benign tumour.\n", + "\n", + "In the second figure we have computed the so-called correlation\n", + "matrix, which in our case with thirty features becomes a $30\\times 30$\n", + "matrix.\n", + "\n", + "We constructed this matrix using **pandas** via the statements" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and then" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "correlation_matrix = cancerpd.corr().round(1)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Diagonalizing this matrix we can in turn say something about which\n", + "features are of relevance and which are not. But before we proceed we\n", + "need to define covariance and correlation matrices. This leads us to\n", + "the classical Principal Component Analysis (PCA) theorem with\n", + "applications.\n", + "\n", + "\n", + "\n", + "\n", + "## Basic ideas of the Principal Component Analysis (PCA)\n", + "\n", + "The principal component analysis deals with the problem of fitting a\n", + "low-dimensional affine subspace $S$ of dimension $d$ much smaller than\n", + "the totaldimension $D$ of the problem at hand (our data\n", + "set). Mathematically it can be formulated as a statistical problem or\n", + "a geometric problem. In our discussion of the theorem for the\n", + "classical PCA, we will stay with a statistical approach. This is also\n", + "what set the scene historically which for the PCA.\n", + "\n", + "We have a data set defined by a design/feature matrix $\\boldsymbol{X}$ (see below for its definition) \n", + "* Each data point is determined by $p$ extrinsic (measurement) variables\n", + "\n", + "* We may want to ask the following question: Are there fewer intrinsic variables (say $d << p$) that still approximately describe the data?\n", + "\n", + "* If so, these intrinsic variables may tell us something important and finding these intrinsic variables is what dimension reduction methods do. \n", + "\n", + "## Introducing the Covariance and Correlation functions\n", + "\n", + "Before we discuss the PCA theorem, we need to remind ourselves about\n", + "the definition of the covariance and the correlation function. These are quantities \n", + "\n", + "Suppose we have defined two vectors\n", + "$\\hat{x}$ and $\\hat{y}$ with $n$ elements each. The covariance matrix $\\boldsymbol{C}$ is defined as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", + " \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{y}] \\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where for example" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] =\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})(y_i- \\overline{y}).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With this definition and recalling that the variance is defined as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{var}[\\boldsymbol{x}]=\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})^2,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "we can rewrite the covariance matrix as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", + " \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] & \\mathrm{var}[\\boldsymbol{y}] \\\\\n", + " \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The covariance takes values between zero and infinity and may thus\n", + "lead to problems with loss of numerical precision for particularly\n", + "large values. It is common to scale the covariance matrix by\n", + "introducing instead the correlation matrix defined via the so-called\n", + "correlation function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]=\\frac{\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}]}{\\sqrt{\\mathrm{var}[\\boldsymbol{x}] \\mathrm{var}[\\boldsymbol{y}]}}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The correlation function is then given by values $\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]\n", + "\\in [-1,1]$. This avoids eventual problems with too large values. We\n", + "can then define the correlation matrix for the two vectors $\\boldsymbol{x}$\n", + "and $\\boldsymbol{y}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{K}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} 1 & \\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", + " \\mathrm{corr}[\\boldsymbol{y},\\boldsymbol{x}] & 1 \\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the above example this is the function we constructed using **pandas**.\n", + "\n", + "\n", + "## Correlation Function and Design/Feature Matrix\n", + "\n", + "In our derivation of the various regression algorithms like **Ordinary Least Squares** or **Ridge regression**\n", + "we defined the design/feature matrix $\\boldsymbol{X}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{X}=\\begin{bmatrix}\n", + "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", + "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", + "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", + "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", + "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", + "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$, with the predictors/features $p$ refering to the column numbers and the\n", + "entries $n$ being the row elements.\n", + "We can rewrite the design/feature matrix in terms of its column vectors as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{X}=\\begin{bmatrix} \\boldsymbol{x}_0 & \\boldsymbol{x}_1 & \\boldsymbol{x}_2 & \\dots & \\dots & \\boldsymbol{x}_{p-1}\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with a given vector" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{x}_i^T = \\begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \\dots & \\dots x_{n-1,i}\\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With these definitions, we can now rewrite our $2\\times 2$\n", + "correaltion/covariance matrix in terms of a moe general design/feature\n", + "matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$. This leads to a $p\\times p$\n", + "covariance matrix for the vectors $\\boldsymbol{x}_i$ with $i=0,1,\\dots,p-1$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}] = \\begin{bmatrix}\n", + "\\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & \\mathrm{var}[\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & \\mathrm{var}[\\boldsymbol{x}_{p-1}]\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and the correlation matrix" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{K}[\\boldsymbol{x}] = \\begin{bmatrix}\n", + "1 & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & 1 & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & 1 & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", + "\\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & 1\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Covariance Matrix Examples\n", + "\n", + "\n", + "The Numpy function **np.cov** calculates the covariance elements using\n", + "the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have\n", + "the exact mean values. The following simple function uses the\n", + "**np.vstack** function which takes each vector of dimension $1\\times n$\n", + "and produces a $2\\times n$ matrix $\\boldsymbol{W}$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{W} = \\begin{bmatrix} x_0 & y_0 \\\\\n", + " x_1 & y_1 \\\\\n", + " x_2 & y_2\\\\\n", + " \\dots & \\dots \\\\\n", + " x_{n-2} & y_{n-2}\\\\\n", + " x_{n-1} & y_{n-1} & \n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which in turn is converted into into the $2\\times 2$ covariance matrix\n", + "$\\boldsymbol{C}$ via the Numpy function **np.cov()**. We note that we can also calculate\n", + "the mean value of each set of samples $\\boldsymbol{x}$ etc using the Numpy\n", + "function **np.mean(x)**. We can also extract the eigenvalues of the\n", + "covariance matrix through the **np.linalg.eig()** function." + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "# Importing various packages\n", + "import numpy as np\n", + "n = 100\n", + "x = np.random.normal(size=n)\n", + "print(np.mean(x))\n", + "y = 4+3*x+np.random.normal(size=n)\n", + "print(np.mean(y))\n", + "W = np.vstack((x, y))\n", + "C = np.cov(W)\n", + "print(C)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Correlation Matrix\n", + "\n", + "The previous example can be converted into the correlation matrix by\n", + "simply scaling the matrix elements with the variances. We should also\n", + "subtract the mean values for each column. This leads to the following\n", + "code which sets up the correlations matrix for the previous example in\n", + "a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the $2\\times 2$ correlation matrix (since we have only two vectors)." + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "n = 100\n", + "# define two vectors \n", + "x = np.random.random(size=n)\n", + "y = 4+3*x+np.random.normal(size=n)\n", + "#scaling the x and y vectors \n", + "x = x - np.mean(x)\n", + "y = y - np.mean(y)\n", + "variance_x = np.sum(x@x)/n\n", + "variance_y = np.sum(y@y)/n\n", + "print(variance_x)\n", + "print(variance_y)\n", + "cov_xy = np.sum(x@y)/n\n", + "cov_xx = np.sum(x@x)/n\n", + "cov_yy = np.sum(y@y)/n\n", + "C = np.zeros((2,2))\n", + "C[0,0]= cov_xx/variance_x\n", + "C[1,1]= cov_yy/variance_y\n", + "C[0,1]= cov_xy/np.sqrt(variance_y*variance_x)\n", + "C[1,0]= C[0,1]\n", + "print(C)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We see that the matrix elements along the diagonal are one as they\n", + "should be and that the matrix is symmetric. Furthermore, diagonalizing\n", + "this matrix we easily see that it is a positive definite matrix.\n", + "\n", + "The above procedure with **numpy** can be made more compact if we use **pandas**.\n", + "\n", + "\n", + "## Correlation Matrix with Pandas\n", + "\n", + "We whow here how we can set up the correlation matrix using **pandas**, as done in this simple code" + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import pandas as pd\n", + "n = 10\n", + "x = np.random.normal(size=n)\n", + "x = x - np.mean(x)\n", + "y = 4+3*x+np.random.normal(size=n)\n", + "y = y - np.mean(y)\n", + "X = (np.vstack((x, y))).T\n", + "print(X)\n", + "Xpd = pd.DataFrame(X)\n", + "print(Xpd)\n", + "correlation_matrix = Xpd.corr()\n", + "print(correlation_matrix)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We expand this model to the Franke function discussed above.\n", + "\n", + "\n", + "## Correlation Matrix with Pandas and the Franke function" + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "# Common imports\n", + "import numpy as np\n", + "import pandas as pd\n", + "\n", + "\n", + "def FrankeFunction(x,y):\n", + "\tterm1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))\n", + "\tterm2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))\n", + "\tterm3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))\n", + "\tterm4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)\n", + "\treturn term1 + term2 + term3 + term4\n", + "\n", + "\n", + "def create_X(x, y, n ):\n", + "\tif len(x.shape) > 1:\n", + "\t\tx = np.ravel(x)\n", + "\t\ty = np.ravel(y)\n", + "\n", + "\tN = len(x)\n", + "\tl = int((n+1)*(n+2)/2)\t\t# Number of elements in beta\n", + "\tX = np.ones((N,l))\n", + "\n", + "\tfor i in range(1,n+1):\n", + "\t\tq = int((i)*(i+1)/2)\n", + "\t\tfor k in range(i+1):\n", + "\t\t\tX[:,q+k] = (x**(i-k))*(y**k)\n", + "\n", + "\treturn X\n", + "\n", + "\n", + "# Making meshgrid of datapoints and compute Franke's function\n", + "n = 4\n", + "N = 100\n", + "x = np.sort(np.random.uniform(0, 1, N))\n", + "y = np.sort(np.random.uniform(0, 1, N))\n", + "z = FrankeFunction(x, y)\n", + "X = create_X(x, y, n=n) \n", + "\n", + "Xpd = pd.DataFrame(X)\n", + "# subtract the mean values and set up the covariance matrix\n", + "Xpd = Xpd - Xpd.mean()\n", + "covariance_matrix = Xpd.cov()\n", + "print(covariance_matrix)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We note here that the covariance is zero for the first rows and\n", + "columns since all matrix elements in the design matrix were set to one\n", + "(we are fitting the function in terms of a polynomial of degree $n$).\n", + "\n", + "This means that the variance for these elements will be zero and will\n", + "cause problems when we set up the correlation matrix. We can simply\n", + "drop these elements and construct a correlation\n", + "matrix without these elements. \n", + "\n", + "\n", + "\n", + "## Rewriting the Covariance and/or Correlation Matrix\n", + "\n", + "We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix $\\boldsymbol{X}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}\\boldsymbol{X}^T= \\mathbb{E}[\\boldsymbol{X}\\boldsymbol{X}^T].\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "To see this let us simply look at a design matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{2\\times 2}$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{X}=\\begin{bmatrix}\n", + "x_{00} & x_{01}\\\\\n", + "x_{10} & x_{11}\\\\\n", + "\\end{bmatrix}=\\begin{bmatrix}\n", + "\\boldsymbol{x}_{0} & \\boldsymbol{x}_{1}\\\\\n", + "\\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If we then compute the expectation value" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbb{E}[\\boldsymbol{X}\\boldsymbol{X}^T] = \\frac{1}{n}\\boldsymbol{X}\\boldsymbol{X}^T=\\begin{bmatrix}\n", + "x_{00}^2+x_{01}^2 & x_{00}x_{10}+x_{01}x_{11}\\\\\n", + "x_{10}x_{00}+x_{11}x_{01} & x_{10}^2+x_{11}^2\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which is just" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]=\\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] \\\\\n", + " \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] \\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where we wrote $$\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]$$ to indicate that this the covariance of the vectors $\\boldsymbol{x}$ of the design/feature matrix $\\boldsymbol{X}$.\n", + "\n", + "It is easy to generalize this to a matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$.\n", + "\n", + "\n", + "\n", + "## Towards the PCA theorem\n", + "\n", + "We have that the covariance matrix (the correlation matrix involves a simple rescaling) is given as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}\\boldsymbol{X}^T= \\mathbb{E}[\\boldsymbol{X}\\boldsymbol{X}^T].\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Let us now assume that we can perform a series of orthogonal transformations where we employ some orthogonal matrices $\\boldsymbol{S}$.\n", + "These matrices are defined as $\\boldsymbol{S}\\in {\\mathbb{R}}^{p\\times p}$ and obey the orthogonality requirements $\\boldsymbol{S}\\boldsymbol{S}^T=\\boldsymbol{S}^T\\boldsymbol{S}=\\boldsymbol{I}$. The matrix can be written out in terms of the column vectors $\\boldsymbol{s}_i$ as $\\boldsymbol{S}=[\\boldsymbol{s}_0,\\boldsymbol{s}_1,\\dots,\\boldsymbol{s}_{p-1}]$ and $\\boldsymbol{s}_i \\in {\\mathbb{R}}^{p}$.\n", + "\n", + "Assume also that there is a transformation $\\boldsymbol{S}\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}^T=\\boldsymbol{C}[\\boldsymbol{y}]$ such that the new matrix $\\boldsymbol{C}[\\boldsymbol{y}]$ is diagonal with elements $[\\lambda_0,\\lambda_1,\\lambda_2,\\dots,\\lambda_{p-1}]$. \n", + "\n", + "That is we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{y}] = \\mathbb{E}[\\boldsymbol{S}\\boldsymbol{X}\\boldsymbol{X}^T\\boldsymbol{S}^T]=\\boldsymbol{S}\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}^T,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "since the matrix $\\boldsymbol{S}$ is not a data dependent matrix. Multiplying with $\\boldsymbol{S}^T$ from the left we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{S}^T\\boldsymbol{C}[\\boldsymbol{y}] = \\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}^T,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and since $\\boldsymbol{C}[\\boldsymbol{y}]$ is diagonal we have for a given eigenvalue $i$ of the covariance matrix that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{S}^T_i\\lambda_i = \\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}^T_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the derivation of the PCA theorem we will assume that the eigenvalues are ordered in descending order, that is\n", + "$\\lambda_0 > \\lambda_1 > \\dots > \\lambda_{p-1}$. \n", + "\n", + "\n", + "The eigenvalues tell us then how much we need to stretch the\n", + "corresponding eigenvectors. Dimensions with large eigenvalues have\n", + "thus large variations (large variance) and define therefore useful\n", + "dimensions. The data points are more spread out in the direction of\n", + "these eigenvectors. Smaller eigenvalues mean on the other hand that\n", + "the corresponding eigenvectors are shrunk accordingly and the data\n", + "points are tightly bunched together and there is not much variation in\n", + "these specific directions. Hopefully then we could leave it out\n", + "dimensions where the eigenvalues are very small. If $p$ is very large,\n", + "we could then aim at reducing $p$ to $l << p$ and handle only $l$\n", + "features/predictors.\n", + "\n", + "\n", + "## The Algorithm before theorem\n", + "\n", + "Here's how we would proceed in setting up the algorithm for the PCA, see also discussion below here. \n", + "* Set up the datapoints for the design/feature matrix $\\boldsymbol{X}$ with $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$, with the predictors/features $p$ referring to the column numbers and the entries $n$ being the row elements." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{X}=\\begin{bmatrix}\n", + "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", + "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", + "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", + "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", + "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", + "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", + "\\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "* Center the data by subtracting the mean value for each column. This leads to a new matrix $\\boldsymbol{X}\\rightarrow \\overline{\\boldsymbol{X}}$.\n", + "\n", + "* Compute then the covariance/correlation matrix $\\mathbb{E}[\\overline{\\boldsymbol{X}}\\overline{\\boldsymbol{X}}^T]$.\n", + "\n", + "* Find the eigenpairs of $\\boldsymbol{C}$ with eigenvalues $[\\lambda_0,\\lambda_1,\\dots,\\lambda_{p-1}]$ and eigenvectors $[\\boldsymbol{s}_0,\\boldsymbol{s}_1,\\dots,\\boldsymbol{s}_{p-1}]$.\n", + "\n", + "* Order the eigenvalue (and the eigenvectors accordingly) in order of decreasing eigenvalues.\n", + "\n", + "* Keep only those $l$ eigenvalues larger than a selected threshold value, discarding thus $p-l$ features since we expect small variations in the data here.\n", + "\n", + "## Writing our own PCA code\n", + "\n", + "We will use a simple example first with two-dimensional data\n", + "drawn from a multivariate normal distribution with the following mean and covariance matrix:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mu = (-1,2) \\qquad \\Sigma = \\begin{bmatrix} 4 & 2 \\\\\n", + "2 & 2\n", + "\\end{bmatrix}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that the mean refers to each column of data. \n", + "We will generate $n = 1000$ points $X = \\{ x_1, \\ldots, x_N \\}$ from\n", + "this distribution, and store them in the $1000 \\times 2$ matrix $\\boldsymbol{X}$.\n", + "\n", + "The following Python code aids in setting up the data and writing out the design matrix.\n", + "Note that the function **multivariate** returns also the covariance discussed above and that it is defined by dividing by $n-1$ instead of $n$." + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import pandas as pd\n", + "import matplotlib.pyplot as plt\n", + "from IPython.display import display\n", + "n = 10000\n", + "mean = (-1, 2)\n", + "cov = [[4, 2], [2, 2]]\n", + "X = np.random.multivariate_normal(mean, cov, n)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now we are going to implement the PCA algorithm. We will break it down into various substeps.\n", + "\n", + "### Compute the sample mean and center the data\n", + "\n", + "The first step of PCA is to compute the sample mean of the data and use it to center the data. Recall that the sample mean is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mu_n = \\frac{1}{n} \\sum_{i=1}^n x_i\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and the mean-centered data $\\bar{X} = \\{ \\bar{x}_1, \\ldots, \\bar{x}_n \\}$ takes the form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\bar{x}_i = x_i - \\mu_n.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "When you are done with these steps, print out $\\mu_n$ to verify it is\n", + "close to $\\mu$ and plot your mean centered data to verify it is\n", + "centered at the origin! Compare your code with the functionality from **Scikit-Learn** discussed above.\n", + "The following code elements perform these operations using **pandas** or using our own functionality for doing so. The latter, using **numpy** is rather simple through the **mean()** function." + ] + }, + { + "cell_type": "code", + "execution_count": 12, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "df = pd.DataFrame(X)\n", + "# Pandas does the centering for us\n", + "df = df -df.mean()\n", + "# we center it ourselves\n", + "X_centered = X - X.mean(axis=0)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Alternatively, we could use the functions we discussed\n", + "earlier for scaling the data set. That is, we could have used the\n", + "**StandardScaler** function in **Scikit-Learn**, a function which ensures\n", + "that for each feature/predictor we study the mean value is zero and\n", + "the variance is one (every column in the design/feature matrix). You\n", + "would then not get the same results, since we divide by the\n", + "variance. The diagonal covariance matrix elements will then be one,\n", + "while the non-diagonal ones need to be divided by $2\\sqrt{2}$ for our\n", + "specific case.\n", + "\n", + "### Compute the sample covariance\n", + "\n", + "Now we are going to use the mean centered data to compute the sample covariance of the data by using the following equation" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\Sigma_n = \\frac{1}{n-1} \\sum_{i=1}^n \\bar{x}_i^T \\bar{x}_i = \\frac{1}{n-1} \\sum_{i=1}^n (x_i - \\mu_n)^T (x_i - \\mu_n)\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where the data points $x_i \\in \\mathbb{R}^p$ (here in this example $p = 2$) are column vectors and $x^T$ is the transpose of $x$.\n", + "We can write our own code or simply use either the functionaly of **numpy** or that of **pandas**, as follows" + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "print(df.cov())\n", + "print(np.cov(X_centered.T))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that the way we define the covariance matrix here has a factor $n-1$ instead of $n$. This is included in the **cov()** function by **numpy** and **pandas**. \n", + "Our own code here is not very elegant and asks for obvious improvements. It is tailored to this specific $2\\times 2$ covariance matrix." + ] + }, + { + "cell_type": "code", + "execution_count": 14, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "# extract the relevant columns from the centered design matrix of dim n x 2\n", + "x = X_centered[:,0]\n", + "y = X_centered[:,1]\n", + "Cov = np.zeros((2,2))\n", + "Cov[0,1] = np.sum(x.T@y)/(n-1.0)\n", + "Cov[0,0] = np.sum(x.T@x)/(n-1.0)\n", + "Cov[1,1] = np.sum(y.T@y)/(n-1.0)\n", + "Cov[1,0]= Cov[0,1]\n", + "print(\"Centered covariance using own code\")\n", + "print(Cov)\n", + "plt.plot(x, y, 'x')\n", + "plt.axis('equal')\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Depending on the number of points $n$, we will get results that are close to the covariance values defined above.\n", + "The plot shows how the data are clustered around a line with slope close to one. Is this expected?\n", + "\n", + "### Diagonalize the sample covariance matrix to obtain the principal components\n", + "\n", + "Now we are ready to solve for the principal components! To do so we\n", + "diagonalize the sample covariance matrix $\\Sigma$. We can use the\n", + "function **np.linalg.eig** to do so. It will return the eigenvalues and\n", + "eigenvectors of $\\Sigma$. Once we have these we can perform the \n", + "following tasks:\n", + "\n", + "* We compute the percentage of the total variance captured by the first principal component\n", + "\n", + "* We plot the mean centered data and lines along the first and second principal components\n", + "\n", + "* Then we project the mean centered data onto the first and second principal components, and plot the projected data. \n", + "\n", + "* Finally, we approximate the data as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_i \\approx \\tilde{x}_i = \\mu_n + \\langle x_i, v_0 \\rangle v_0\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $v_0$ is the first principal component. \n", + "\n", + "Collecting all these steps we can write our own PCA function and\n", + "compare this with the functionality included in **Scikit-Learn**. \n", + "\n", + "The code here outlines some of the elements we could include in the\n", + "analysis. Feel free to extend upon this in order to address the above\n", + "questions." + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "# diagonalize and obtain eigenvalues, not necessarily sorted\n", + "EigValues, EigVectors = np.linalg.eig(Cov)\n", + "# sort eigenvectors and eigenvalues\n", + "#permute = EigValues.argsort()\n", + "#EigValues = EigValues[permute]\n", + "#EigVectors = EigVectors[:,permute]\n", + "print(\"Eigenvalues of Covariance matrix\")\n", + "for i in range(2):\n", + " print(EigValues[i])\n", + "FirstEigvector = EigVectors[:,0]\n", + "SecondEigvector = EigVectors[:,1]\n", + "print(\"First eigenvector\")\n", + "print(FirstEigvector)\n", + "print(\"Second eigenvector\")\n", + "print(SecondEigvector)\n", + "#thereafter we do a PCA with Scikit-learn\n", + "from sklearn.decomposition import PCA\n", + "pca = PCA(n_components = 2)\n", + "X2Dsl = pca.fit_transform(X)\n", + "print(\"Eigenvector of largest eigenvalue\")\n", + "print(pca.components_.T[:, 0])" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This code does not contain all the above elements, but it shows how we can use **Scikit-Learn** to extract the eigenvector which corresponds to the largest eigenvalue. Try to address the questions we pose before the above code. Try also to change the values of the covariance matrix by making one of the diagonal elements much larger than the other. What do you observe then? \n", + "\n", + "\n", + "## Classical PCA Theorem\n", + "\n", + "We assume now that we have a design matrix $\\boldsymbol{X}$ which has been\n", + "centered as discussed above. For the sake of simplicity we skip the\n", + "overline symbol. The matrix is defined in terms of the various column\n", + "vectors $[\\boldsymbol{x}_0,\\boldsymbol{x}_1,\\dots, \\boldsymbol{x}_{p-1}]$ each with dimension\n", + "$\\boldsymbol{x}\\in {\\mathbb{R}}^{n}$.\n", + "\n", + "We assume also that we have an orthogonal transformation $\\boldsymbol{W}\\in {\\mathbb{R}}^{p\\times p}$. We define the reconstruction error (which is similar to the mean squared error we have seen before) as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{W},\\boldsymbol{Z}) = \\frac{1}{n}\\sum_i (\\boldsymbol{x}_i - \\overline{\\boldsymbol{x}}_i)^2,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $\\overline{\\boldsymbol{x}}_i = \\boldsymbol{W}\\boldsymbol{z}_i$, where $\\boldsymbol{z}_i$ is a row vector with dimension ${\\mathbb{R}}^{n}$ of the matrix\n", + "$\\boldsymbol{Z}\\in{\\mathbb{R}}^{p\\times n}$. When doing PCA we want to reduce this dimensionality. \n", + "\n", + "The PCA theorem states that minimizing the above reconstruction error\n", + "corresponds to setting $\\boldsymbol{W}=\\boldsymbol{S}$, the orthogonal matrix which\n", + "diagonalizes the empirical covariance(correlation) matrix. The optimal\n", + "low-dimensional encoding of the data is then given by a set of vectors\n", + "$\\boldsymbol{z}_i$ with at most $l$ vectors, with $l << p$, defined by the\n", + "orthogonal projection of the data onto the columns spanned by the\n", + "eigenvectors of the covariance(correlations matrix).\n", + "\n", + "The proof which follows will be updated by mid January 2020.\n", + "\n", + "\n", + "## Proof of the PCA Theorem\n", + "\n", + "To show the PCA theorem let us start with the assumption that there is one vector $\\boldsymbol{w}_0$ which corresponds to a solution which minimized the reconstruction error $J$. This is an orthogonal vector. It means that we now approximate the reconstruction error in terms of $\\boldsymbol{w}_0$ and $\\boldsymbol{z}_0$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{w}_0,\\boldsymbol{z}_0)= \\frac{1}{n}\\sum_i (\\boldsymbol{x}_i - z_{i0}\\boldsymbol{w}_0)^2=\\frac{1}{n}\\sum_i (\\boldsymbol{x}_i^T\\boldsymbol{x}_i - 2z_{i0}\\boldsymbol{w}_0^T\\boldsymbol{x}_i+z_{i0}^2\\boldsymbol{w}_0^T\\boldsymbol{w}_0),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which we can rewrite due to the orthogonality of $\\boldsymbol{w}_i$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{w}_0,\\boldsymbol{z}_0)=\\frac{1}{n}\\sum_i (\\boldsymbol{x}_i^T\\boldsymbol{x}_i - 2z_{i0}\\boldsymbol{w}_0^T\\boldsymbol{x}_i+z_{i0}^2).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Minimizing $J$ with respect to the unknown parameters $z_{0i}$ we obtain that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "z_{i0}=\\boldsymbol{w}_0^T\\boldsymbol{x}_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where the vectors on the rhs are known. \n", + "\n", + "\n", + "\n", + "## PCA Proof continued\n", + "\n", + "We have now found the unknown parameters $z_{i0}$. These correspond to the projected coordinates and we can write" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{w}_0)= \\frac{1}{p}\\sum_i (\\boldsymbol{x}_i^T\\boldsymbol{x}_i - z_{i0}^2)=\\mathrm{const}-\\frac{1}{n}\\sum_i z_{i0}^2.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We can show that the variance of the projected coordinates defined by $\\boldsymbol{w}_0^T\\boldsymbol{x}_i$ are given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{var}[\\boldsymbol{w}_0^T\\boldsymbol{x}_i] = \\frac{1}{n}\\sum_i z_{i0}^2,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "since the expectation value of" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbb{E}[\\boldsymbol{w}_0^T\\boldsymbol{x}_i] = \\mathbb{E}[z_{i0}]= \\boldsymbol{w}_0^T\\mathbb{E}[\\boldsymbol{x}_i]=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where we have used the fact that our data are centered.\n", + "\n", + "Recalling our definition of the covariance as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}\\boldsymbol{X}^T=\\mathbb{E}[\\boldsymbol{X}\\boldsymbol{X}^T],\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "we have thus that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathrm{var}[\\boldsymbol{w}_0^T\\boldsymbol{x}_i] = \\frac{1}{n}\\sum_i z_{i0}^2=\\boldsymbol{w}_0^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We are almost there, we have obtained a relation between minimizing\n", + "the reconstruction error and the variance and the covariance\n", + "matrix. Minimizing the error is equivalent to maximizing the variance\n", + "of the projected data.\n", + "\n", + "\n", + "## The final step\n", + "\n", + "We could trivially maximize the variance of the projection (and\n", + "thereby minimize the error in the reconstruction function) by letting\n", + "the norm-2 of $\\boldsymbol{w}_0$ go to infinity. However, this norm since we\n", + "want the matrix $\\boldsymbol{W}$ to be an orthogonal matrix, is constrained by\n", + "$\\vert\\vert \\boldsymbol{w}_0 \\vert\\vert_2^2=1$. Imposing this condition via a\n", + "Lagrange multiplier we can then in turn maximize" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "J(\\boldsymbol{w}_0)= \\boldsymbol{w}_0^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0+\\lambda_0(1-\\boldsymbol{w}_0^T\\boldsymbol{w}_0).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Taking the derivative with respect to $\\boldsymbol{w}_0$ we obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial J(\\boldsymbol{w}_0)}{\\partial \\boldsymbol{w}_0}= 2\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0-2\\lambda_0\\boldsymbol{w}_0=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "meaning that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0=\\lambda_0\\boldsymbol{w}_0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "**The direction that maximizes the variance (or minimizes the construction error) is an eigenvector of the covariance matrix**! If we left multiply with $\\boldsymbol{w}_0^T$ we have the variance of the projected data is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\boldsymbol{w}_0^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0=\\lambda_0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If we want to maximize the variance (minimize the construction error)\n", + "we simply pick the eigenvector of the covariance matrix with the\n", + "largest eigenvalue. This establishes the link between the minimization\n", + "of the reconstruction function $J$ in terms of an orthogonal matrix\n", + "and the maximization of the variance and thereby the covariance of our\n", + "observations encoded in the design/feature matrix $\\boldsymbol{X}$.\n", + "\n", + "The proof\n", + "for the other eigenvectors $\\boldsymbol{w}_1,\\boldsymbol{w}_2,\\dots$ can be\n", + "established by applying the above arguments and using the fact that\n", + "our basis of eigenvectors is orthogonal, see [Murphy chapter\n", + "12.2](https://mitpress.mit.edu/books/machine-learning-1). The\n", + "discussion in chapter 12.2 of Murphy's text has also a nice link with\n", + "the Singular Value Decomposition theorem. For categorical data, see\n", + "chapter 12.4 and discussion therein.\n", + "\n", + "Additional part of the proof for the other eigenvectors will be added by mid January 2020.\n", + "\n", + "\n", + "## Geometric Interpretation and link with Singular Value Decomposition\n", + "\n", + "This material will be added by mid January 2020.\n", + "\n", + "\n", + "\n", + "## Principal Component Analysis\n", + "\n", + "Principal Component Analysis (PCA) is by far the most popular dimensionality reduction algorithm.\n", + "First it identifies the hyperplane that lies closest to the data, and then it projects the data onto it.\n", + "\n", + "The following Python code uses NumPy’s **svd()** function to obtain all the principal components of the\n", + "training set, then extracts the first two principal components. First we center the data using either **pandas** or our own code" + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import pandas as pd\n", + "from IPython.display import display\n", + "np.random.seed(100)\n", + "# setting up a 10 x 5 vanilla matrix \n", + "rows = 10\n", + "cols = 5\n", + "X = np.random.randn(rows,cols)\n", + "df = pd.DataFrame(X)\n", + "# Pandas does the centering for us\n", + "df = df -df.mean()\n", + "display(df)\n", + "\n", + "# we center it ourselves\n", + "X_centered = X - X.mean(axis=0)\n", + "# Then check the difference between pandas and our own set up\n", + "print(X_centered-df)\n", + "#Now we do an SVD\n", + "U, s, V = np.linalg.svd(X_centered)\n", + "c1 = V.T[:, 0]\n", + "c2 = V.T[:, 1]\n", + "W2 = V.T[:, :2]\n", + "X2D = X_centered.dot(W2)\n", + "print(X2D)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "PCA assumes that the dataset is centered around the origin. Scikit-Learn’s PCA classes take care of centering\n", + "the data for you. However, if you implement PCA yourself (as in the preceding example), or if you use other libraries, don’t\n", + "forget to center the data first.\n", + "\n", + "Once you have identified all the principal components, you can reduce the dimensionality of the dataset\n", + "down to $d$ dimensions by projecting it onto the hyperplane defined by the first $d$ principal components.\n", + "Selecting this hyperplane ensures that the projection will preserve as much variance as possible." + ] + }, + { + "cell_type": "code", + "execution_count": 17, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "W2 = V.T[:, :2]\n", + "X2D = X_centered.dot(W2)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## PCA and scikit-learn\n", + "\n", + "Scikit-Learn’s PCA class implements PCA using SVD decomposition just like we did before. The\n", + "following code applies PCA to reduce the dimensionality of the dataset down to two dimensions (note\n", + "that it automatically takes care of centering the data):" + ] + }, + { + "cell_type": "code", + "execution_count": 18, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "#thereafter we do a PCA with Scikit-learn\n", + "from sklearn.decomposition import PCA\n", + "pca = PCA(n_components = 2)\n", + "X2D = pca.fit_transform(X)\n", + "print(X2D)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "After fitting the PCA transformer to the dataset, you can access the principal components using the\n", + "components variable (note that it contains the PCs as horizontal vectors, so, for example, the first\n", + "principal component is equal to" + ] + }, + { + "cell_type": "code", + "execution_count": 19, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "pca.components_.T[:, 0]." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Another very useful piece of information is the explained variance ratio of each principal component,\n", + "available via the $explained\\_variance\\_ratio$ variable. It indicates the proportion of the dataset’s\n", + "variance that lies along the axis of each principal component. \n", + "\n", + "\n", + "## Back to the Cancer Data\n", + "We can now repeat the above but applied to real data, in this case our breast cancer data.\n", + "Here we compute performance scores on the training data using logistic regression." + ] + }, + { + "cell_type": "code", + "execution_count": 20, + "metadata": { + "collapsed": false + }, + "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.linear_model import LogisticRegression\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", + "\n", + "logreg = LogisticRegression()\n", + "logreg.fit(X_train, y_train)\n", + "print(\"Train set accuracy from Logistic Regression: {:.2f}\".format(logreg.score(X_train,y_train)))\n", + "# We 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", + "# Then perform again a log reg fit\n", + "logreg.fit(X_train_scaled, y_train)\n", + "print(\"Train set accuracy scaled data: {:.2f}\".format(logreg.score(X_train_scaled,y_train)))\n", + "#thereafter we do a PCA with Scikit-learn\n", + "from sklearn.decomposition import PCA\n", + "pca = PCA(n_components = 2)\n", + "X2D_train = pca.fit_transform(X_train_scaled)\n", + "# and finally compute the log reg fit and the score on the training data\t\n", + "logreg.fit(X2D_train,y_train)\n", + "print(\"Train set accuracy scaled and PCA data: {:.2f}\".format(logreg.score(X2D_train,y_train)))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We see that our training data after the PCA decomposition has a performance similar to the non-scaled data. \n", + "\n", + "\n", + "## More on the PCA\n", + "\n", + "Instead of arbitrarily choosing the number of dimensions to reduce down to, it is generally preferable to\n", + "choose the number of dimensions that add up to a sufficiently large portion of the variance (e.g., 95%).\n", + "Unless, of course, you are reducing dimensionality for data visualization — in that case you will\n", + "generally want to reduce the dimensionality down to 2 or 3.\n", + "The following code computes PCA without reducing dimensionality, then computes the minimum number\n", + "of dimensions required to preserve 95% of the training set’s variance:" + ] + }, + { + "cell_type": "code", + "execution_count": 21, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "pca = PCA()\n", + "pca.fit(X)\n", + "cumsum = np.cumsum(pca.explained_variance_ratio_)\n", + "d = np.argmax(cumsum >= 0.95) + 1" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "You could then set $n\\_components=d$ and run PCA again. However, there is a much better option: instead\n", + "of specifying the number of principal components you want to preserve, you can set $n\\_components$ to be\n", + "a float between 0.0 and 1.0, indicating the ratio of variance you wish to preserve:" + ] + }, + { + "cell_type": "code", + "execution_count": 22, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "pca = PCA(n_components=0.95)\n", + "X_reduced = pca.fit_transform(X)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Incremental PCA\n", + "\n", + "One problem with the preceding implementation of PCA is that it requires the whole training set to fit in\n", + "memory in order for the SVD algorithm to run. Fortunately, Incremental PCA (IPCA) algorithms have\n", + "been developed: you can split the training set into mini-batches and feed an IPCA algorithm one minibatch\n", + "at a time. This is useful for large training sets, and also to apply PCA online (i.e., on the fly, as new\n", + "instances arrive).\n", + "\n", + "\n", + "## Randomized PCA\n", + "\n", + "Scikit-Learn offers yet another option to perform PCA, called Randomized PCA. This is a stochastic\n", + "algorithm that quickly finds an approximation of the first d principal components. Its computational\n", + "complexity is $O(m \\times d^2)+O(d^3)$, instead of $O(m \\times n^2) + O(n^3)$, so it is dramatically faster than the\n", + "previous algorithms when $d$ is much smaller than $n$.\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Kernel PCA\n", + "\n", + "The kernel trick is a mathematical technique that implicitly maps instances into a\n", + "very high-dimensional space (called the feature space), enabling nonlinear classification and regression\n", + "with Support Vector Machines. Recall that a linear decision boundary in the high-dimensional feature\n", + "space corresponds to a complex nonlinear decision boundary in the original space.\n", + "It turns out that the same trick can be applied to PCA, making it possible to perform complex nonlinear\n", + "projections for dimensionality reduction. This is called Kernel PCA (kPCA). It is often good at\n", + "preserving clusters of instances after projection, or sometimes even unrolling datasets that lie close to a\n", + "twisted manifold.\n", + "For example, the following code uses Scikit-Learn’s KernelPCA class to perform kPCA with an" + ] + }, + { + "cell_type": "code", + "execution_count": 23, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "from sklearn.decomposition import KernelPCA\n", + "rbf_pca = KernelPCA(n_components = 2, kernel=\"rbf\", gamma=0.04)\n", + "X_reduced = rbf_pca.fit_transform(X)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## LLE\n", + "\n", + "Locally Linear Embedding (LLE) is another very powerful nonlinear dimensionality reduction\n", + "(NLDR) technique. It is a Manifold Learning technique that does not rely on projections like the previous\n", + "algorithms. In a nutshell, LLE works by first measuring how each training instance linearly relates to its\n", + "closest neighbors (c.n.), and then looking for a low-dimensional representation of the training set where\n", + "these local relationships are best preserved (more details shortly). \n", + "\n", + "\n", + "\n", + "\n", + "## Other techniques\n", + "\n", + "\n", + "There are many other dimensionality reduction techniques, several of which are available in Scikit-Learn.\n", + "\n", + "Here are some of the most popular:\n", + "* **Multidimensional Scaling (MDS)** reduces dimensionality while trying to preserve the distances between the instances.\n", + "\n", + "* **Isomap** creates a graph by connecting each instance to its nearest neighbors, then reduces dimensionality while trying to preserve the geodesic distances between the instances.\n", + "\n", + "* **t-Distributed Stochastic Neighbor Embedding** (t-SNE) reduces dimensionality while trying to keep similar instances close and dissimilar instances apart. It is mostly used for visualization, in particular to visualize clusters of instances in high-dimensional space (e.g., to visualize the MNIST images in 2D).\n", + "\n", + "* Linear Discriminant Analysis (LDA) is actually a classification algorithm, but during training it learns the most discriminative axes between the classes, and these axes can then be used to define a hyperplane onto which to project the data. The benefit is that the projection will keep classes as far apart as possible, so LDA is a good technique to reduce dimensionality before running another classification algorithm such as a Support Vector Machine (SVM) classifier discussed in the SVM lectures." + ] + } + ], + "metadata": {}, + "nbformat": 4, + "nbformat_minor": 4 +} diff --git a/doc/src/LectureNotes/gaussian.pdf b/doc/src/LectureNotes/gaussian.pdf index 6ab8f203cf61e8ae68fea68cad6ee44001326ca5..e88db4b7b7cfe15fe94f0dc2b8d731637a170374 100644 GIT binary patch delta 29 lcmdnm%(u0fuc3vpg=q`(u3C0WBO? 0.5$ and the no +default case $y_i \leq 0.5$. + +We would then have our +weighted linear combination, namely +!bt +\begin{equation} +\hat{y} = \hat{X}^T\hat{\beta} + \hat{\epsilon}, +\end{equation} +!et +where $\hat{y}$ is a vector representing the possible outcomes, $\hat{X}$ is our +$n\times p$ design matrix and $\hat{\beta}$ represents our estimators/predictors. + + +The main problem with our function is that it takes values on the +entire real axis. In the case of logistic regression, however, the +labels $y_i$ are discrete variables. A typical example is the credit +card data discussed below here, where we can set the state of +defaulting the debt to $y_i=1$ and not to $y_i=0$ for one the persons +in the data set (see the full example below). + +One simple way to get a discrete output is to have sign +functions that map the output of a linear regressor to values $\{0,1\}$, +$f(s_i)=sign(s_i)=1$ if $s_i\ge 0$ and 0 if otherwise. +We will encounter this model in our first demonstration of neural networks. Historically it is called the ``perceptron" model in the machine learning +literature. This model is extremely simple. However, in many cases it is more +favorable to use a ``soft" classifier that outputs +the probability of a given category. This leads us to the logistic function. + + + +===== The logistic function ===== + +The perceptron is an example of a ``hard classification'' model. We +will encounter this model when we discuss neural networks as +well. Each datapoint is deterministically assigned to a category (i.e +$y_i=0$ or $y_i=1$). In many cases, it is favorable to have a ``soft'' +classifier that outputs the probability of a given category rather +than a single value. For example, given $x_i$, the classifier +outputs the probability of being in a category $k$. Logistic regression +is the most common example of a so-called soft classifier. In logistic +regression, the probability that a data point $x_i$ +belongs to a category $y_i=\{0,1\}$ is given by the so-called logit function (or Sigmoid) which is meant to represent the likelihood for a given event, +!bt +\[ +p(t) = \frac{1}{1+\mathrm \exp{-t}}=\frac{\exp{t}}{1+\mathrm \exp{t}}. +\] +!et +Note that $1-p(t)= p(-t)$. + + +The following code plots the logistic function, the step function and other functions we will encounter from here and on. + + +!bc pycod +"""The sigmoid function (or the logistic curve) is a +function that takes any real number, z, and outputs a number (0,1). +It is useful in neural networks for assigning weights on a relative scale. +The value z is the weighted sum of parameters involved in the learning algorithm.""" + +import numpy +import matplotlib.pyplot as plt +import math as mt + +z = numpy.arange(-5, 5, .1) +sigma_fn = numpy.vectorize(lambda z: 1/(1+numpy.exp(-z))) +sigma = sigma_fn(z) + +fig = plt.figure() +ax = fig.add_subplot(111) +ax.plot(z, sigma) +ax.set_ylim([-0.1, 1.1]) +ax.set_xlim([-5,5]) +ax.grid(True) +ax.set_xlabel('z') +ax.set_title('sigmoid function') + +plt.show() + +"""Step Function""" +z = numpy.arange(-5, 5, .02) +step_fn = numpy.vectorize(lambda z: 1.0 if z >= 0.0 else 0.0) +step = step_fn(z) + +fig = plt.figure() +ax = fig.add_subplot(111) +ax.plot(z, step) +ax.set_ylim([-0.5, 1.5]) +ax.set_xlim([-5,5]) +ax.grid(True) +ax.set_xlabel('z') +ax.set_title('step function') + +plt.show() + +"""tanh Function""" +z = numpy.arange(-2*mt.pi, 2*mt.pi, 0.1) +t = numpy.tanh(z) + +fig = plt.figure() +ax = fig.add_subplot(111) +ax.plot(z, t) +ax.set_ylim([-1.0, 1.0]) +ax.set_xlim([-2*mt.pi,2*mt.pi]) +ax.grid(True) +ax.set_xlabel('z') +ax.set_title('tanh function') + +plt.show() +!ec + + +===== Two parameters ===== + +We assume now that we have two classes with $y_i$ either $0$ or $1$. Furthermore we assume also that we have only two parameters $\beta$ in our fitting of the Sigmoid function, that is we define probabilities +!bt +\begin{align*} +p(y_i=1|x_i,\hat{\beta}) &= \frac{\exp{(\beta_0+\beta_1x_i)}}{1+\exp{(\beta_0+\beta_1x_i)}},\nonumber\\ +p(y_i=0|x_i,\hat{\beta}) &= 1 - p(y_i=1|x_i,\hat{\beta}), +\end{align*} +!et +where $\hat{\beta}$ are the weights we wish to extract from data, in our case $\beta_0$ and $\beta_1$. + +Note that we used +!bt +\[ +p(y_i=0\vert x_i, \hat{\beta}) = 1-p(y_i=1\vert x_i, \hat{\beta}). +\] +!et + +===== Maximum likelihood ===== + +In order to define the total likelihood for all possible outcomes from a +dataset $\mathcal{D}=\{(y_i,x_i)\}$, with the binary labels +$y_i\in\{0,1\}$ and where the data points are drawn independently, we use the so-called "Maximum Likelihood Estimation":"https://en.wikipedia.org/wiki/Maximum_likelihood_estimation" (MLE) principle. +We aim thus at maximizing +the probability of seeing the observed data. We can then approximate the +likelihood in terms of the product of the individual probabilities of a specific outcome $y_i$, that is +!bt +\begin{align*} +P(\mathcal{D}|\hat{\beta})& = \prod_{i=1}^n \left[p(y_i=1|x_i,\hat{\beta})\right]^{y_i}\left[1-p(y_i=1|x_i,\hat{\beta}))\right]^{1-y_i}\nonumber \\ +\end{align*} +!et +from which we obtain the log-likelihood and our _cost/loss_ function +!bt +\[ +\mathcal{C}(\hat{\beta}) = \sum_{i=1}^n \left( y_i\log{p(y_i=1|x_i,\hat{\beta})} + (1-y_i)\log\left[1-p(y_i=1|x_i,\hat{\beta}))\right]\right). +\] +!et + + +Reordering the logarithms, we can rewrite the _cost/loss_ function as +!bt +\[ +\mathcal{C}(\hat{\beta}) = \sum_{i=1}^n \left(y_i(\beta_0+\beta_1x_i) -\log{(1+\exp{(\beta_0+\beta_1x_i)})}\right). +\] +!et + +The maximum likelihood estimator is defined as the set of parameters that maximize the log-likelihood where we maximize with respect to $\beta$. +Since the cost (error) function is just the negative log-likelihood, for logistic regression we have that +!bt +\[ +\mathcal{C}(\hat{\beta})=-\sum_{i=1}^n \left(y_i(\beta_0+\beta_1x_i) -\log{(1+\exp{(\beta_0+\beta_1x_i)})}\right). +\] +!et +This equation is known in statistics as the _cross entropy_. Finally, we note that just as in linear regression, +in practice we often supplement the cross-entropy with additional regularization terms, usually $L_1$ and $L_2$ regularization as we did for Ridge and Lasso regression. + + +The cross entropy is a convex function of the weights $\hat{\beta}$ and, +therefore, any local minimizer is a global minimizer. + + +Minimizing this +cost function with respect to the two parameters $\beta_0$ and $\beta_1$ we obtain + +!bt +\[ +\frac{\partial \mathcal{C}(\hat{\beta})}{\partial \beta_0} = -\sum_{i=1}^n \left(y_i -\frac{\exp{(\beta_0+\beta_1x_i)}}{1+\exp{(\beta_0+\beta_1x_i)}}\right), +\] +!et +and +!bt +\[ +\frac{\partial \mathcal{C}(\hat{\beta})}{\partial \beta_1} = -\sum_{i=1}^n \left(y_ix_i -x_i\frac{\exp{(\beta_0+\beta_1x_i)}}{1+\exp{(\beta_0+\beta_1x_i)}}\right). +\] +!et + +Let us now define a vector $\hat{y}$ with $n$ elements $y_i$, an +$n\times p$ matrix $\hat{X}$ which contains the $x_i$ values and a +vector $\hat{p}$ of fitted probabilities $p(y_i\vert x_i,\hat{\beta})$. We can rewrite in a more compact form the first +derivative of cost function as + +!bt +\[ +\frac{\partial \mathcal{C}(\hat{\beta})}{\partial \hat{\beta}} = -\hat{X}^T\left(\hat{y}-\hat{p}\right). +\] +!et + +If we in addition define a diagonal matrix $\hat{W}$ with elements +$p(y_i\vert x_i,\hat{\beta})(1-p(y_i\vert x_i,\hat{\beta})$, we can obtain a compact expression of the second derivative as + +!bt +\[ +\frac{\partial^2 \mathcal{C}(\hat{\beta})}{\partial \hat{\beta}\partial \hat{\beta}^T} = \hat{X}^T\hat{W}\hat{X}. +\] +!et + + +Within a binary classification problem, we can easily expand our model to include multiple predictors. Our ratio between likelihoods is then with $p$ predictors +!bt +\[ +\log{ \frac{p(\hat{\beta}\hat{x})}{1-p(\hat{\beta}\hat{x})}} = \beta_0+\beta_1x_1+\beta_2x_2+\dots+\beta_px_p. +\] +!et +Here we defined $\hat{x}=[1,x_1,x_2,\dots,x_p]$ and $\hat{\beta}=[\beta_0, \beta_1, \dots, \beta_p]$ leading to +!bt +\[ +p(\hat{\beta}\hat{x})=\frac{ \exp{(\beta_0+\beta_1x_1+\beta_2x_2+\dots+\beta_px_p)}}{1+\exp{(\beta_0+\beta_1x_1+\beta_2x_2+\dots+\beta_px_p)}}. +\] +!et + + +===== Including more classes ===== + +Till now we have mainly focused on two classes, the so-called binary +system. Suppose we wish to extend to $K$ classes. Let us for the sake +of simplicity assume we have only two predictors. We have then +following model + +!bt +\[ +\log{\frac{p(C=1\vert x)}{p(K\vert x)}} = \beta_{10}+\beta_{11}x_1, +\] +!et +!bt +\[ +\log{\frac{p(C=2\vert x)}{p(K\vert x)}} = \beta_{20}+\beta_{21}x_1, +\] +!et +and so on till the class $C=K-1$ class +!bt +\[ +\log{\frac{p(C=K-1\vert x)}{p(K\vert x)}} = \beta_{(K-1)0}+\beta_{(K-1)1}x_1, +\] +!et + +and the model is specified in term of $K-1$ so-called log-odds or +_logit_ transformations. + + + +In our discussion of neural networks we will encounter the above again +in terms of a slightly modified function, the so-called _Softmax_ function. + +The softmax function is used in various multiclass classification +methods, such as multinomial logistic regression (also known as +softmax regression), multiclass linear discriminant analysis, naive +Bayes classifiers, and artificial neural networks. Specifically, in +multinomial logistic regression and linear discriminant analysis, the +input to the function is the result of $K$ distinct linear functions, +and the predicted probability for the $k$-th class given a sample +vector $\hat{x}$ and a weighting vector $\hat{\beta}$ is (with two +predictors): + +!bt +\[ +p(C=k\vert \mathbf {x} )=\frac{\exp{(\beta_{k0}+\beta_{k1}x_1)}}{1+\sum_{l=1}^{K-1}\exp{(\beta_{l0}+\beta_{l1}x_1)}}. +\] +!et +It is easy to extend to more predictors. The final class is +!bt +\[ +p(C=K\vert \mathbf {x} )=\frac{1}{1+\sum_{l=1}^{K-1}\exp{(\beta_{l0}+\beta_{l1}x_1)}}, +\] +!et + +and they sum to one. Our earlier discussions were all specialized to +the case with two classes only. It is easy to see from the above that +what we derived earlier is compatible with these equations. + +To find the optimal parameters we would typically use a gradient +descent method. Newton's method and gradient descent methods are +discussed in the material on "optimization +methods":"https://compphysics.github.io/MachineLearning/doc/pub/Splines/html/Splines-bs.html". + + + + + diff --git a/doc/src/NeuralNet/chapter6.dlog b/doc/src/NeuralNet/chapter6.dlog new file mode 100644 index 000000000..7cc5f0c3e --- /dev/null +++ b/doc/src/NeuralNet/chapter6.dlog @@ -0,0 +1,4 @@ +translating doconce text in chapter6.do.txt to ipynb +Failed to remove ans_at_end environment +Failed to remove sol_at_end environment +output in chapter6.ipynb diff --git a/doc/src/NeuralNet/chapter6.do.txt b/doc/src/NeuralNet/chapter6.do.txt new file mode 100644 index 000000000..cb962573f --- /dev/null +++ b/doc/src/NeuralNet/chapter6.do.txt @@ -0,0 +1,2462 @@ +======= Neural networks, from the simple perceptron to deep learning ======= + +===== To do list ===== + +* write code for single perceptron model and make link with linear regression +* revise initial info and add references +* Update tensorflow material, with keras +* think of adding material about pytorch +* rework pulsar example and breast cancer example +* add ising model example for both regression and classification +* make data on gravitational problem, add reference to articles on uncovering physical laws from ML +* think of genetic data + + + +===== Neural networks ===== + +Artificial neural networks are computational systems that can learn to +perform tasks by considering examples, generally without being +programmed with any task-specific rules. It is supposed to mimic a +biological system, wherein neurons interact by sending signals in the +form of mathematical functions between layers. All layers can contain +an arbitrary number of neurons, and each connection is represented by +a weight variable. + + + +===== Artificial neurons ===== + +The field of artificial neural networks has a long history of +development, and is closely connected with the advancement of computer +science and computers in general. A model of artificial neurons was +first developed by McCulloch and Pitts in 1943 to study signal +processing in the brain and has later been refined by others. The +general idea is to mimic neural networks in the human brain, which is +composed of billions of neurons that communicate with each other by +sending electrical signals. Each neuron accumulates its incoming +signals, which must exceed an activation threshold to yield an +output. If the threshold is not overcome, the neuron remains inactive, +i.e. has zero output. + +This behaviour has inspired a simple mathematical model for an artificial neuron. + +!bt +\begin{equation} + y = f\left(\sum_{i=1}^n w_ix_i\right) = f(u) + label{artificialNeuron} +\end{equation} +!et +Here, the output $y$ of the neuron is the value of its activation function, which have as input +a weighted sum of signals $x_i, \dots ,x_n$ received by $n$ other neurons. + +Conceptually, it is helpful to divide neural networks into four +categories: +o general purpose neural networks for supervised learning, +o neural networks designed specifically for image processing, the most prominent example of this class being Convolutional Neural Networks (CNNs), +o neural networks for sequential data such as Recurrent Neural Networks (RNNs), and +o neural networks for unsupervised learning such as Deep Boltzmann Machines. + + +In natural science, DNNs and CNNs have already found numerous +applications. In statistical physics, they have been applied to detect +phase transitions in 2D Ising and Potts models, lattice gauge +theories, and different phases of polymers, or solving the +Navier-Stokes equation in weather forecasting. Deep learning has also +found interesting applications in quantum physics. Various quantum +phase transitions can be detected and studied using DNNs and CNNs, +topological phases, and even non-equilibrium many-body +localization. Representing quantum states as DNNs quantum state +tomography are among some of the impressive achievements to reveal the +potential of DNNs to facilitate the study of quantum systems. + +In quantum information theory, it has been shown that one can perform +gate decompositions with the help of neural. + +The applications are not limited to the natural sciences. There is a +plethora of applications in essentially all disciplines, from the +humanities to life science and medicine. + + +===== Neural network types ===== + +An artificial neural network (ANN), is a computational model that +consists of layers of connected neurons, or nodes or units. We will +refer to these interchangeably as units or nodes, and sometimes as +neurons. + +It is supposed to mimic a biological nervous system by letting each +neuron interact with other neurons by sending signals in the form of +mathematical functions between layers. A wide variety of different +ANNs have been developed, but most of them consist of an input layer, +an output layer and eventual layers in-between, called *hidden +layers*. All layers can contain an arbitrary number of nodes, and each +connection between two nodes is associated with a weight variable. + +Neural networks (also called neural nets) are neural-inspired +nonlinear models for supervised learning. As we will see, neural nets +can be viewed as natural, more powerful extensions of supervised +learning methods such as linear and logistic regression and soft-max +methods we discussed earlier. + + + +===== Feed-forward neural networks ===== + +The feed-forward neural network (FFNN) was the first and simplest type +of ANNs that were devised. In this network, the information moves in +only one direction: forward through the layers. + +Nodes are represented by circles, while the arrows display the +connections between the nodes, including the direction of information +flow. Additionally, each arrow corresponds to a weight variable +(figure to come). We observe that each node in a layer is connected +to *all* nodes in the subsequent layer, making this a so-called +*fully-connected* FFNN. + + + + +===== Convolutional Neural Network ===== + +A different variant of FFNNs are *convolutional neural networks* +(CNNs), which have a connectivity pattern inspired by the animal +visual cortex. Individual neurons in the visual cortex only respond to +stimuli from small sub-regions of the visual field, called a receptive +field. This makes the neurons well-suited to exploit the strong +spatially local correlation present in natural images. The response of +each neuron can be approximated mathematically as a convolution +operation. (figure to come) + +Convolutional neural networks emulate the behaviour of neurons in the +visual cortex by enforcing a *local* connectivity pattern between +nodes of adjacent layers: Each node in a convolutional layer is +connected only to a subset of the nodes in the previous layer, in +contrast to the fully-connected FFNN. Often, CNNs consist of several +convolutional layers that learn local features of the input, with a +fully-connected layer at the end, which gathers all the local data and +produces the outputs. They have wide applications in image and video +recognition. + + +===== Recurrent neural networks ===== + +So far we have only mentioned ANNs where information flows in one +direction: forward. *Recurrent neural networks* on the other hand, +have connections between nodes that form directed *cycles*. This +creates a form of internal memory which are able to capture +information on what has been calculated before; the output is +dependent on the previous computations. Recurrent NNs make use of +sequential information by performing the same task for every element +in a sequence, where each element depends on previous elements. An +example of such information is sentences, making recurrent NNs +especially well-suited for handwriting and speech recognition. + + +===== Other types of networks ===== + +There are many other kinds of ANNs that have been developed. One type +that is specifically designed for interpolation in multidimensional +space is the radial basis function (RBF) network. RBFs are typically +made up of three layers: an input layer, a hidden layer with +non-linear radial symmetric activation functions and a linear output +layer (''linear'' here means that each node in the output layer has a +linear activation function). The layers are normally fully-connected +and there are no cycles, thus RBFs can be viewed as a type of +fully-connected FFNN. They are however usually treated as a separate +type of NN due the unusual activation functions. + + +===== Multilayer perceptrons ===== + +One uses often so-called fully-connected feed-forward neural networks +with three or more layers (an input layer, one or more hidden layers +and an output layer) consisting of neurons that have non-linear +activation functions. + +Such networks are often called *multilayer perceptrons* (MLPs). + + +===== Why multilayer perceptrons? ===== + +According to the *Universal approximation theorem*, a feed-forward +neural network with just a single hidden layer containing a finite +number of neurons can approximate a continuous multidimensional +function to arbitrary accuracy, assuming the activation function for +the hidden layer is a _non-constant, bounded and +monotonically-increasing continuous function_. + +Note that the requirements on the activation function only applies to +the hidden layer, the output nodes are always assumed to be linear, so +as to not restrict the range of output values. + + + +===== Mathematical model ===== + +The output $y$ is produced via the activation function $f$ +!bt +\[ + y = f\left(\sum_{i=1}^n w_ix_i + b_i\right) = f(z), +\] +!et +This function receives $x_i$ as inputs. +Here the activation $z=(\sum_{i=1}^n w_ix_i+b_i)$. +In an FFNN of such neurons, the *inputs* $x_i$ are the *outputs* of +the neurons in the preceding layer. Furthermore, an MLP is +fully-connected, which means that each neuron receives a weighted sum +of the outputs of *all* neurons in the previous layer. + + +===== Mathematical model ===== + +First, for each node $i$ in the first hidden layer, we calculate a weighted sum $z_i^1$ of the input coordinates $x_j$, + +!bt +\begin{equation} z_i^1 = \sum_{j=1}^{M} w_{ij}^1 x_j + b_i^1 +\end{equation} +!et + +Here $b_i$ is the so-called bias which is normally needed in +case of zero activation weights or inputs. How to fix the biases and +the weights will be discussed below. The value of $z_i^1$ is the +argument to the activation function $f_i$ of each node $i$, The +variable $M$ stands for all possible inputs to a given node $i$ in the +first layer. We define the output $y_i^1$ of all neurons in layer 1 as + +!bt +\begin{equation} + y_i^1 = f(z_i^1) = f\left(\sum_{j=1}^M w_{ij}^1 x_j + b_i^1\right) + label{outputLayer1} +\end{equation} +!et + +where we assume that all nodes in the same layer have identical +activation functions, hence the notation $f$. In general, we could assume in the more general case that different layers have different activation functions. +In this case we would identify these functions with a superscript $l$ for the $l$-th layer, + +!bt +\begin{equation} + y_i^l = f^l(u_i^l) = f^l\left(\sum_{j=1}^{N_{l-1}} w_{ij}^l y_j^{l-1} + b_i^l\right) + label{generalLayer} +\end{equation} +!et + +where $N_l$ is the number of nodes in layer $l$. When the output of +all the nodes in the first hidden layer are computed, the values of +the subsequent layer can be calculated and so forth until the output +is obtained. + + + + +===== Mathematical model ===== + +The output of neuron $i$ in layer 2 is thus, + +!bt +\begin{align} + y_i^2 &= f^2\left(\sum_{j=1}^N w_{ij}^2 y_j^1 + b_i^2\right) \\ + &= f^2\left[\sum_{j=1}^N w_{ij}^2f^1\left(\sum_{k=1}^M w_{jk}^1 x_k + b_j^1\right) + b_i^2\right] + label{outputLayer2} +\end{align} +!et +where we have substituted $y_k^1$ with the inputs $x_k$. Finally, the ANN output reads + +!bt +\begin{align} + y_i^3 &= f^3\left(\sum_{j=1}^N w_{ij}^3 y_j^2 + b_i^3\right) \\ + &= f_3\left[\sum_{j} w_{ij}^3 f^2\left(\sum_{k} w_{jk}^2 f^1\left(\sum_{m} w_{km}^1 x_m + b_k^1\right) + b_j^2\right) + + b_1^3\right] +\end{align} +!et + + +===== Mathematical model ===== + +We can generalize this expression to an MLP with $l$ hidden +layers. The complete functional form is, + +!bt +\begin{align} +&y^{l+1}_i = f^{l+1}\left[\!\sum_{j=1}^{N_l} w_{ij}^3 f^l\left(\sum_{k=1}^{N_{l-1}}w_{jk}^{l-1}\left(\dots f^1\left(\sum_{n=1}^{N_0} w_{mn}^1 x_n+ b_m^1\right)\dots\right)+b_k^2\right)+b_1^3\right] && + label{completeNN} +\end{align} +!et + +which illustrates a basic property of MLPs: The only independent +variables are the input values $x_n$. + + +===== Mathematical model ===== + +This confirms that an MLP, despite its quite convoluted mathematical +form, is nothing more than an analytic function, specifically a +mapping of real-valued vectors $\hat{x} \in \mathbb{R}^n \rightarrow +\hat{y} \in \mathbb{R}^m$. + +Furthermore, the flexibility and universality of an MLP can be +illustrated by realizing that the expression is essentially a nested +sum of scaled activation functions of the form + +!bt +\begin{equation} + f(x) = c_1 f(c_2 x + c_3) + c_4 +\end{equation} +!et + +where the parameters $c_i$ are weights and biases. By adjusting these +parameters, the activation functions can be shifted up and down or +left and right, change slope or be rescaled which is the key to the +flexibility of a neural network. + + +=== Matrix-vector notation === + +We can introduce a more convenient notation for the activations in an A NN. + +Additionally, we can represent the biases and activations +as layer-wise column vectors $\hat{b}_l$ and $\hat{y}_l$, so that the $i$-th element of each vector +is the bias $b_i^l$ and activation $y_i^l$ of node $i$ in layer $l$ respectively. + +We have that $\mathrm{W}_l$ is an $N_{l-1} \times N_l$ matrix, while $\hat{b}_l$ and $\hat{y}_l$ are $N_l \times 1$ column vectors. +With this notation, the sum becomes a matrix-vector multiplication, and we can write +the equation for the activations of hidden layer 2 (assuming three nodes for simplicity) as +!bt +\begin{equation} + \hat{y}_2 = f_2(\mathrm{W}_2 \hat{y}_{1} + \hat{b}_{2}) = + f_2\left(\left[\begin{array}{ccc} + w^2_{11} &w^2_{12} &w^2_{13} \\ + w^2_{21} &w^2_{22} &w^2_{23} \\ + w^2_{31} &w^2_{32} &w^2_{33} \\ + \end{array} \right] \cdot + \left[\begin{array}{c} + y^1_1 \\ + y^1_2 \\ + y^1_3 \\ + \end{array}\right] + + \left[\begin{array}{c} + b^2_1 \\ + b^2_2 \\ + b^2_3 \\ + \end{array}\right]\right). +\end{equation} +!et + + +=== Matrix-vector notation and activation === + +The activation of node $i$ in layer 2 is + +!bt +\begin{equation} + y^2_i = f_2\Bigr(w^2_{i1}y^1_1 + w^2_{i2}y^1_2 + w^2_{i3}y^1_3 + b^2_i\Bigr) = + f_2\left(\sum_{j=1}^3 w^2_{ij} y_j^1 + b^2_i\right). +\end{equation} +!et + +This is not just a convenient and compact notation, but also a useful +and intuitive way to think about MLPs: The output is calculated by a +series of matrix-vector multiplications and vector additions that are +used as input to the activation functions. For each operation +$\mathrm{W}_l \hat{y}_{l-1}$ we move forward one layer. + + + +=== Activation functions === + + +A property that characterizes a neural network, other than its +connectivity, is the choice of activation function(s). As described +in, the following restrictions are imposed on an activation function +for a FFNN to fulfill the universal approximation theorem + + * Non-constant + + * Bounded + + * Monotonically-increasing + + * Continuous + + +=== Activation functions, Logistic and Hyperbolic ones === + +The second requirement excludes all linear functions. Furthermore, in +a MLP with only linear activation functions, each layer simply +performs a linear transformation of its inputs. + +Regardless of the number of layers, the output of the NN will be +nothing but a linear function of the inputs. Thus we need to introduce +some kind of non-linearity to the NN to be able to fit non-linear +functions Typical examples are the logistic *Sigmoid* + +!bt +\[ + f(x) = \frac{1}{1 + e^{-x}}, +\] +!et +and the *hyperbolic tangent* function +!bt +\[ + f(x) = \tanh(x) +\] +!et + + +=== Relevance === + +The *sigmoid* function are more biologically plausible because the +output of inactive neurons are zero. Such activation function are +called *one-sided*. However, it has been shown that the hyperbolic +tangent performs better than the sigmoid for training MLPs. has +become the most popular for *deep neural networks* + +!bc pycod +"""The sigmoid function (or the logistic curve) is a +function that takes any real number, z, and outputs a number (0,1). +It is useful in neural networks for assigning weights on a relative scale. +The value z is the weighted sum of parameters involved in the learning algorithm.""" + +import numpy +import matplotlib.pyplot as plt +import math as mt + +z = numpy.arange(-5, 5, .1) +sigma_fn = numpy.vectorize(lambda z: 1/(1+numpy.exp(-z))) +sigma = sigma_fn(z) + +fig = plt.figure() +ax = fig.add_subplot(111) +ax.plot(z, sigma) +ax.set_ylim([-0.1, 1.1]) +ax.set_xlim([-5,5]) +ax.grid(True) +ax.set_xlabel('z') +ax.set_title('sigmoid function') + +plt.show() + +"""Step Function""" +z = numpy.arange(-5, 5, .02) +step_fn = numpy.vectorize(lambda z: 1.0 if z >= 0.0 else 0.0) +step = step_fn(z) + +fig = plt.figure() +ax = fig.add_subplot(111) +ax.plot(z, step) +ax.set_ylim([-0.5, 1.5]) +ax.set_xlim([-5,5]) +ax.grid(True) +ax.set_xlabel('z') +ax.set_title('step function') + +plt.show() + +"""Sine Function""" +z = numpy.arange(-2*mt.pi, 2*mt.pi, 0.1) +t = numpy.sin(z) + +fig = plt.figure() +ax = fig.add_subplot(111) +ax.plot(z, t) +ax.set_ylim([-1.0, 1.0]) +ax.set_xlim([-2*mt.pi,2*mt.pi]) +ax.grid(True) +ax.set_xlabel('z') +ax.set_title('sine function') + +plt.show() + +"""Plots a graph of the squashing function used by a rectified linear +unit""" +z = numpy.arange(-2, 2, .1) +zero = numpy.zeros(len(z)) +y = numpy.max([zero, z], axis=0) + +fig = plt.figure() +ax = fig.add_subplot(111) +ax.plot(z, y) +ax.set_ylim([-2.0, 2.0]) +ax.set_xlim([-2.0, 2.0]) +ax.grid(True) +ax.set_xlabel('z') +ax.set_title('Rectified linear unit') + +plt.show() +!ec + + + +===== The multilayer perceptron (MLP) ===== + +The multilayer perceptron is a very popular, and easy to implement approach, to deep learning. It consists of +o A neural network with one or more layers of nodes between the input and the output nodes. +o The multilayer network structure, or architecture, or topology, consists of an input layer, one or more hidden layers, and one output layer. +o The input nodes pass values to the first hidden layer, its nodes pass the information on to the second and so on till we reach the output layer. + +As a convention it is normal to call a network with one layer of input units, one layer of hidden +units and one layer of output units as a two-layer network. A network with two layers of hidden units is called a three-layer network etc etc. + +For an MLP network there is no direct connection between the output nodes/neurons/units and the input nodes/neurons/units. +Hereafter we will call the various entities of a layer for nodes. +There are also no connections within a single layer. + +The number of input nodes does not need to equal the number of output +nodes. This applies also to the hidden layers. Each layer may have its +own number of nodes and activation functions. + +The hidden layers have their name from the fact that they are not +linked to observables and as we will see below when we define the +so-called activation $\hat{z}$, we can think of this as a basis +expansion of the original inputs $\hat{x}$. The difference however +between neural networks and say linear regression is that now these +basis functions (which will correspond to the weights in the network) +are learned from data. This results in an important difference between +neural networks and deep learning approaches on one side and methods +like logistic regression or linear regression and their modifications on the other side. + + + +===== From one to many layers, the universal approximation theorem ===== + + +A neural network with only one layer, what we called the simple +perceptron, is best suited if we have a standard binary model with +clear (linear) boundaries between the outcomes. As such it could +equally well be replaced by standard linear regression or logistic +regression. Networks with one or more hidden layers approximate +systems with more complex boundaries. + +As stated earlier, +an important theorem in studies of neural networks, restated without +proof here, is the "universal approximation +theorem":"http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.441.7873&rep=rep1&type=pdf". + +It states that a feed-forward network with a single hidden layer +containing a finite number of neurons can approximate continuous +functions on compact subsets of real functions. The theorem thus +states that simple neural networks can represent a wide variety of +interesting functions when given appropriate parameters. It is the +multilayer feedforward architecture itself which gives neural networks +the potential of being universal approximators. + + + +===== Deriving the back propagation code for a multilayer perceptron model ===== + + +_Note: figures will be inserted later!_ + +As we have seen now in a feed forward network, we can express the final output of our network in terms of basic matrix-vector multiplications. +The unknowwn quantities are our weights $w_{ij}$ and we need to find an algorithm for changing them so that our errors are as small as possible. +This leads us to the famous "back propagation algorithm":"https://www.nature.com/articles/323533a0". + +The questions we want to ask are how do changes in the biases and the +weights in our network change the cost function and how can we use the +final output to modify the weights? + +To derive these equations let us start with a plain regression problem +and define our cost function as + +!bt +\[ +{\cal C}(\hat{W}) = \frac{1}{2}\sum_{i=1}^n\left(y_i - t_i\right)^2, +\] +!et + +where the $t_i$s are our $n$ targets (the values we want to +reproduce), while the outputs of the network after having propagated +all inputs $\hat{x}$ are given by $y_i$. Below we will demonstrate +how the basic equations arising from the back propagation algorithm +can be modified in order to study classification problems with $K$ +classes. + + +===== Definitions ===== + +With our definition of the targets $\hat{t}$, the outputs of the +network $\hat{y}$ and the inputs $\hat{x}$ we +define now the activation $z_j^l$ of node/neuron/unit $j$ of the +$l$-th layer as a function of the bias, the weights which add up from +the previous layer $l-1$ and the forward passes/outputs +$\hat{a}^{l-1}$ from the previous layer as + + +!bt +\[ +z_j^l = \sum_{i=1}^{M_{l-1}}w_{ij}^la_i^{l-1}+b_j^l, +\] +!et + +where $b_k^l$ are the biases from layer $l$. Here $M_{l-1}$ +represents the total number of nodes/neurons/units of layer $l-1$. The +figure here illustrates this equation. We can rewrite this in a more +compact form as the matrix-vector products we discussed earlier, + +!bt +\[ +\hat{z}^l = \left(\hat{W}^l\right)^T\hat{a}^{l-1}+\hat{b}^l. +\] +!et + +With the activation values $\hat{z}^l$ we can in turn define the +output of layer $l$ as $\hat{a}^l = f(\hat{z}^l)$ where $f$ is our +activation function. In the examples here we will use the sigmoid +function discussed in our logistic regression lectures. We will also use the same activation function $f$ for all layers +and their nodes. It means we have + +!bt +\[ +a_j^l = f(z_j^l) = \frac{1}{1+\exp{-(z_j^l)}}. +\] +!et + + + +===== Derivatives and the chain rule ===== + +From the definition of the activation $z_j^l$ we have +!bt +\[ +\frac{\partial z_j^l}{\partial w_{ij}^l} = a_i^{l-1}, +\] +!et +and +!bt +\[ +\frac{\partial z_j^l}{\partial a_i^{l-1}} = w_{ji}^l. +\] +!et + +With our definition of the activation function we have that (note that this function depends only on $z_j^l$) +!bt +\[ +\frac{\partial a_j^l}{\partial z_j^{l}} = a_j^l(1-a_j^l)=f(z_j^l)(1-f(z_j^l)). +\] +!et + + + +===== Derivative of the cost function ===== + +With these definitions we can now compute the derivative of the cost function in terms of the weights. + +Let us specialize to the output layer $l=L$. Our cost function is +!bt +\[ +{\cal C}(\hat{W^L}) = \frac{1}{2}\sum_{i=1}^n\left(y_i - t_i\right)^2=\frac{1}{2}\sum_{i=1}^n\left(a_i^L - t_i\right)^2, +\] +!et +The derivative of this function with respect to the weights is + +!bt +\[ +\frac{\partial{\cal C}(\hat{W^L})}{\partial w_{jk}^L} = \left(a_j^L - t_j\right)\frac{\partial a_j^L}{\partial w_{jk}^{L}}, +\] +!et +The last partial derivative can easily be computed and reads (by applying the chain rule) +!bt +\[ +\frac{\partial a_j^L}{\partial w_{jk}^{L}} = \frac{\partial a_j^L}{\partial z_{j}^{L}}\frac{\partial z_j^L}{\partial w_{jk}^{L}}=a_j^L(1-a_j^L)a_k^{L-1}, +\] +!et + + + + +===== Bringing it together, first back propagation equation ===== + +We have thus +!bt +\[ +\frac{\partial{\cal C}(\hat{W^L})}{\partial w_{jk}^L} = \left(a_j^L - t_j\right)a_j^L(1-a_j^L)a_k^{L-1}, +\] +!et + +Defining +!bt +\[ +\delta_j^L = a_j^L(1-a_j^L)\left(a_j^L - t_j\right) = f'(z_j^L)\frac{\partial {\cal C}}{\partial (a_j^L)}, +\] +!et +and using the Hadamard product of two vectors we can write this as +!bt +\[ +\hat{\delta}^L = f'(\hat{z}^L)\circ\frac{\partial {\cal C}}{\partial (\hat{a}^L)}. +\] +!et + +This is an important expression. The second term on the right handside +measures how fast the cost function is changing as a function of the $j$th +output activation. If, for example, the cost function doesn't depend +much on a particular output node $j$, then $\delta_j^L$ will be small, +which is what we would expect. The first term on the right, measures +how fast the activation function $f$ is changing at a given activation +value $z_j^L$. + +Notice that everything in the above equations is easily computed. In +particular, we compute $z_j^L$ while computing the behaviour of the +network, and it is only a small additional overhead to compute +$f'(z^L_j)$. The exact form of the derivative with respect to the +output depends on the form of the cost function. +However, provided the cost function is known there should be little +trouble in calculating + +!bt +\[ +\frac{\partial {\cal C}}{\partial (a_j^L)} +\] +!et + +With the definition of $\delta_j^L$ we have a more compact definition of the derivative of the cost function in terms of the weights, namely +!bt +\[ +\frac{\partial{\cal C}(\hat{W^L})}{\partial w_{jk}^L} = \delta_j^La_k^{L-1}. +\] +!et + + +===== Derivatives in terms of $z_j^L$ ===== + +It is also easy to see that our previous equation can be written as + +!bt +\[ +\delta_j^L =\frac{\partial {\cal C}}{\partial z_j^L}= \frac{\partial {\cal C}}{\partial a_j^L}\frac{\partial a_j^L}{\partial z_j^L}, +\] +!et +which can also be interpreted as the partial derivative of the cost function with respect to the biases $b_j^L$, namely +!bt +\[ +\delta_j^L = \frac{\partial {\cal C}}{\partial b_j^L}\frac{\partial b_j^L}{\partial z_j^L}=\frac{\partial {\cal C}}{\partial b_j^L}, +\] +!et +That is, the error $\delta_j^L$ is exactly equal to the rate of change of the cost function as a function of the bias. + +===== Bringing it together ===== + +We have now three equations that are essential for the computations of the derivatives of the cost function at the output layer. These equations are needed to start the algorithm and they are + +!bblock The starting equations + +!bt +\begin{equation} +\frac{\partial{\cal C}(\hat{W^L})}{\partial w_{jk}^L} = \delta_j^La_k^{L-1}, +\end{equation} +!et +and +!bt +\begin{equation} +\delta_j^L = f'(z_j^L)\frac{\partial {\cal C}}{\partial (a_j^L)}, +\end{equation} +!et +and + +!bt +\begin{equation} +\delta_j^L = \frac{\partial {\cal C}}{\partial b_j^L}, +\end{equation} +!et +!eblock + + +An interesting consequence of the above equations is that when the +activation $a_k^{L-1}$ is small, the gradient term, that is the +derivative of the cost function with respect to the weights, will also +tend to be small. We say then that the weight learns slowly, meaning +that it changes slowly when we minimize the weights via say gradient +descent. In this case we say the system learns slowly. + +Another interesting feature is that is when the activation function, +represented by the sigmoid function here, is rather flat when we move towards +its end values $0$ and $1$ (see the above Python codes). In these +cases, the derivatives of the activation function will also be close +to zero, meaning again that the gradients will be small and the +network learns slowly again. + + + +We need a fourth equation and we are set. We are going to propagate +backwards in order to the determine the weights and biases. In order +to do so we need to represent the error in the layer before the final +one $L-1$ in terms of the errors in the final output layer. + + +===== Final back propagating equation ===== + +We have that (replacing $L$ with a general layer $l$) +!bt +\[ +\delta_j^l =\frac{\partial {\cal C}}{\partial z_j^l}. +\] +!et +We want to express this in terms of the equations for layer $l+1$. Using the chain rule and summing over all $k$ entries we have + +!bt +\[ +\delta_j^l =\sum_k \frac{\partial {\cal C}}{\partial z_k^{l+1}}\frac{\partial z_k^{l+1}}{\partial z_j^{l}}=\sum_k \delta_k^{l+1}\frac{\partial z_k^{l+1}}{\partial z_j^{l}}, +\] +!et +and recalling that +!bt +\[ +z_j^{l+1} = \sum_{i=1}^{M_{l}}w_{ij}^{l+1}a_i^{l}+b_j^{l+1}, +\] +!et +with $M_l$ being the number of nodes in layer $l$, we obtain +!bt +\[ +\delta_j^l =\sum_k \delta_k^{l+1}w_{kj}^{l+1}f'(z_j^l), +\] +!et +This is our final equation. + +We are now ready to set up the algorithm for back propagation and learning the weights and biases. + + +===== Setting up the Back propagation algorithm ===== + + + +The four equations provide us with a way of computing the gradient of the cost function. Let us write this out in the form of an algorithm. + +!bblock +First, we set up the input data $\hat{x}$ and the activations +$\hat{z}_1$ of the input layer and compute the activation function and +the pertinent outputs $\hat{a}^1$. +!eblock + +!bblock +Secondly, we perform then the feed forward till we reach the output +layer and compute all $\hat{z}_l$ of the input layer and compute the +activation function and the pertinent outputs $\hat{a}^l$ for +$l=2,3,\dots,L$. +!eblock + +!bblock +Thereafter we compute the ouput error $\hat{\delta}^L$ by computing all +!bt +\[ +\delta_j^L = f'(z_j^L)\frac{\partial {\cal C}}{\partial (a_j^L)}. +\] +!et +!eblock + +!bblock +Then we compute the back propagate error for each $l=L-1,L-2,\dots,2$ as +!bt +\[ +\delta_j^l = \sum_k \delta_k^{l+1}w_{kj}^{l+1}f'(z_j^l). +\] +!et +!eblock + +!bblock +Finally, we update the weights and the biases using gradient descent for each $l=L-1,L-2,\dots,2$ and update the weights and biases according to the rules +!bt +\[ +w_{jk}^l\leftarrow = w_{jk}^l- \eta \delta_j^la_k^{l-1}, +\] +!et + +!bt +\[ +b_j^l \leftarrow b_j^l-\eta \frac{\partial {\cal C}}{\partial b_j^l}=b_j^l-\eta \delta_j^l, +\] +!et +!eblock + +The parameter $\eta$ is the learning parameter discussed in connection with the gradient descent methods. +Here it is convenient to use stochastic gradient descent (see the examples below) with mini-batches with an outer loop that steps through multiple epochs of training. + + + +===== Setting up a Multi-layer perceptron model for classification ===== + +We are now gong to develop an example based on the MNIST data +base. This is a classification problem and we need to use our +cross-entropy function we discussed in connection with logistic +regression. The cross-entropy defines our cost function for the +classificaton problems with neural networks. + +In binary classification with two classes $(0, 1)$ we define the +logistic/sigmoid function as the probability that a particular input +is in class $0$ or $1$. This is possible because the logistic +function takes any input from the real numbers and inputs a number +between 0 and 1, and can therefore be interpreted as a probability. It +also has other nice properties, such as a derivative that is simple to +calculate. + +For an input $\boldsymbol{a}$ from the hidden layer, the probability that the input $\boldsymbol{x}$ +is in class 0 or 1 is just. We let $\theta$ represent the unknown weights and biases to be adjusted by our equations). The variable $x$ +represents our activation values $z$. We have +!bt +\[ +P(y = 0 \mid \hat{x}, \hat{\theta}) = \frac{1}{1 + \exp{(- \hat{x}})} , +\] +!et +and +!bt +\[ +P(y = 1 \mid \hat{x}, \hat{\theta}) = 1 - P(y = 0 \mid \hat{x}, \hat{\theta}) , +\] +!et + +where $y \in \{0, 1\}$ and $\hat{\theta}$ represents the weights and biases +of our network. + + + +===== Defining the cost function ===== + +Our cost function is given as (see the Logistic regression lectures) +!bt +\[ +\mathcal{C}(\hat{\theta}) = - \ln P(\mathcal{D} \mid \hat{\theta}) = - \sum_{i=1}^n +y_i \ln[P(y_i = 0)] + (1 - y_i) \ln [1 - P(y_i = 0)] = \sum_{i=1}^n \mathcal{L}_i(\hat{\theta}) . +\] +!et + +This last equality means that we can interpret our *cost* function as a sum over the *loss* function +for each point in the dataset $\mathcal{L}_i(\hat{\theta})$. +The negative sign is just so that we can think about our algorithm as minimizing a positive number, rather +than maximizing a negative number. + +In *multiclass* classification it is common to treat each integer label as a so called *one-hot* vector: + +$y = 5 \quad \rightarrow \quad \hat{y} = (0, 0, 0, 0, 0, 1, 0, 0, 0, 0) ,$ and + + +$y = 1 \quad \rightarrow \quad \hat{y} = (0, 1, 0, 0, 0, 0, 0, 0, 0, 0) ,$ + + +i.e. a binary bit string of length $C$, where $C = 10$ is the number of classes in the MNIST dataset (numbers from $0$ to $9$).. + +If $\hat{x}_i$ is the $i$-th input (image), $y_{ic}$ refers to the $c$-th component of the $i$-th +output vector $\hat{y}_i$. +The probability of $\hat{x}_i$ being in class $c$ will be given by the softmax function: + +!bt +\[ +P(y_{ic} = 1 \mid \hat{x}_i, \hat{\theta}) = \frac{\exp{((\hat{a}_i^{hidden})^T \hat{w}_c)}} +{\sum_{c'=0}^{C-1} \exp{((\hat{a}_i^{hidden})^T \hat{w}_{c'})}} , +\] +!et + +which reduces to the logistic function in the binary case. +The likelihood of this $C$-class classifier +is now given as: + +!bt +\[ +P(\mathcal{D} \mid \hat{\theta}) = \prod_{i=1}^n \prod_{c=0}^{C-1} [P(y_{ic} = 1)]^{y_{ic}} . +\] +!et +Again we take the negative log-likelihood to define our cost function: + +!bt +\[ +\mathcal{C}(\hat{\theta}) = - \log{P(\mathcal{D} \mid \hat{\theta})}. +\] +!et +See the logistic regression lectures for a full definition of the cost function. + +The back propagation equations need now only a small change, namely the definition of a new cost function. We are thus ready to use the same equations as before! + + +===== Example: binary classification problem ===== + +As an example of the above, relevant for project 2 as well, let us consider a binary class. As discussed in our logistic regression lectures, we defined a cost function in terms of the parameters $\beta$ as +!bt +\[ +\mathcal{C}(\hat{\beta}) = - \sum_{i=1}^n \left(y_i\log{p(y_i \vert x_i,\hat{\beta})}+(1-y_i)\log{1-p(y_i \vert x_i,\hat{\beta})}\right), +\] +!et +where we had defined the logistic (sigmoid) function +!bt +\[ +p(y_i =1\vert x_i,\hat{\beta})=\frac{\exp{(\beta_0+\beta_1 x_i)}}{1+\exp{(\beta_0+\beta_1 x_i)}}, +\] +!et +and +!bt +\[ +p(y_i =0\vert x_i,\hat{\beta})=1-p(y_i =1\vert x_i,\hat{\beta}). +\] +!et +The parameters $\hat{\beta}$ were defined using a minimization method like gradient descent or Newton-Raphson's method. + +Now we replace $x_i$ with the activation $z_i^l$ for a given layer $l$ and the outputs as $y_i=a_i^l=f(z_i^l)$, with $z_i^l$ now being a function of the weights $w_{ij}^l$ and biases $b_i^l$. +We have then +!bt +\[ +a_i^l = y_i = \frac{\exp{(z_i^l)}}{1+\exp{(z_i^l)}}, +\] +!et +with +!bt +\[ +z_i^l = \sum_{j}w_{ij}^l a_j^{l-1}+b_i^l, +\] +!et +where the superscript $l-1$ indicates that these are the outputs from layer $l-1$. +Our cost function at the final layer $l=L$ is now +!bt +\[ +\mathcal{C}(\hat{W}) = - \sum_{i=1}^n \left(t_i\log{a_i^L}+(1-t_i)\log{(1-a_i^L)}\right), +\] +!et +where we have defined the targets $t_i$. The derivatives of the cost function with respect to the output $a_i^L$ are then easily calculated and we get +!bt +\[ +\frac{\partial \mathcal{C}(\hat{W})}{\partial a_i^L} = \frac{a_i^L-t_i}{a_i^L(1-a_i^L)}. +\] +!et +In case we use another activation function than the logistic one, we need to evaluate other derivatives. + + + +===== The Softmax function ===== +In case we employ the more general case given by the Softmax equation, we need to evaluate the derivative of the activation function with respect to the activation $z_i^l$, that is we need +!bt +\[ +\frac{\partial f(z_i^l)}{\partial w_{jk}^l} = +\frac{\partial f(z_i^l)}{\partial z_j^l} \frac{\partial z_j^l}{\partial w_{jk}^l}= \frac{\partial f(z_i^l)}{\partial z_j^l}a_k^{l-1}. +\] +!et +For the Softmax function we have +!bt +\[ +f(z_i^l) = \frac{\exp{(z_i^l)}}{\sum_{m=1}^K\exp{(z_m^l)}}. +\] +!et +Its derivative with respect to $z_j^l$ gives +!bt +\[ +\frac{\partial f(z_i^l)}{\partial z_j^l}= f(z_i^l)\left(\delta_{ij}-f(z_j^l)\right), +\] +!et +which in case of the simply binary model reduces to having $i=j$. + + +===== Developing a code for doing neural networks with back propagation ===== + + +One can identify a set of key steps when using neural networks to solve supervised learning problems: + +o Collect and pre-process data +o Define model and architecture +o Choose cost function and optimizer +o Train the model +o Evaluate model performance on test data +o Adjust hyperparameters (if necessary, network architecture) + + +===== Collect and pre-process data ===== + +Here we will be using the MNIST dataset, which is readily available through the _scikit-learn_ +package. You may also find it for example "here":"http://yann.lecun.com/exdb/mnist/". +The *MNIST* (Modified National Institute of Standards and Technology) database is a large database +of handwritten digits that is commonly used for training various image processing systems. +The MNIST dataset consists of 70 000 images of size $28\times 28$ pixels, each labeled from 0 to 9. +The scikit-learn dataset we will use consists of a selection of 1797 images of size $8\times 8$ collected and processed from this database. + +To feed data into a feed-forward neural network we need to represent +the inputs as a design/feature matrix $X = (n_{inputs}, n_{features})$. Each +row represents an *input*, in this case a handwritten digit, and +each column represents a *feature*, in this case a pixel. The +correct answers, also known as *labels* or *targets* are +represented as a 1D array of integers +$Y = (n_{inputs}) = (5, 3, 1, 8,...)$. + +As an example, say we want to build a neural network using supervised learning to predict Body-Mass Index (BMI) from +measurements of height (in m) +and weight (in kg). If we have measurements of 5 people the design/feature matrix could be for example: + +$$ X = \begin{bmatrix} +1.85 & 81\\ +1.71 & 65\\ +1.95 & 103\\ +1.55 & 42\\ +1.63 & 56 +\end{bmatrix} ,$$ + +and the targets would be: + +$$ Y = (23.7, 22.2, 27.1, 17.5, 21.1) $$ + +Since each input image is a 2D matrix, we need to flatten the image +(i.e. "unravel" the 2D matrix into a 1D array) to turn the data into a +design/feature matrix. This means we lose all spatial information in the +image, such as locality and translational invariance. More complicated +architectures such as Convolutional Neural Networks can take advantage +of such information, and are most commonly applied when analyzing +images. + + +!bc pycod +# import necessary packages +import numpy as np +import matplotlib.pyplot as plt +from sklearn import datasets + + +# ensure the same random numbers appear every time +np.random.seed(0) + +# display images in notebook +%matplotlib inline +plt.rcParams['figure.figsize'] = (12,12) + + +# download MNIST dataset +digits = datasets.load_digits() + +# define inputs and labels +inputs = digits.images +labels = digits.target + +print("inputs = (n_inputs, pixel_width, pixel_height) = " + str(inputs.shape)) +print("labels = (n_inputs) = " + str(labels.shape)) + + +# flatten the image +# the value -1 means dimension is inferred from the remaining dimensions: 8x8 = 64 +n_inputs = len(inputs) +inputs = inputs.reshape(n_inputs, -1) +print("X = (n_inputs, n_features) = " + str(inputs.shape)) + + +# choose some random images to display +indices = np.arange(n_inputs) +random_indices = np.random.choice(indices, size=5) + +for i, image in enumerate(digits.images[random_indices]): + plt.subplot(1, 5, i+1) + plt.axis('off') + plt.imshow(image, cmap=plt.cm.gray_r, interpolation='nearest') + plt.title("Label: %d" % digits.target[random_indices[i]]) +plt.show() +!ec + + +===== Train and test datasets ===== + +Performing analysis before partitioning the dataset is a major error, that can lead to incorrect conclusions. + +We will reserve $80 \%$ of our dataset for training and $20 \%$ for testing. + +It is important that the train and test datasets are drawn randomly from our dataset, to ensure +no bias in the sampling. +Say you are taking measurements of weather data to predict the weather in the coming 5 days. +You don't want to train your model on measurements taken from the hours 00.00 to 12.00, and then test it on data +collected from 12.00 to 24.00. + + +!bc pycod +from sklearn.model_selection import train_test_split + +# one-liner from scikit-learn library +train_size = 0.8 +test_size = 1 - train_size +X_train, X_test, Y_train, Y_test = train_test_split(inputs, labels, train_size=train_size, + test_size=test_size) + +# equivalently in numpy +def train_test_split_numpy(inputs, labels, train_size, test_size): + n_inputs = len(inputs) + inputs_shuffled = inputs.copy() + labels_shuffled = labels.copy() + + np.random.shuffle(inputs_shuffled) + np.random.shuffle(labels_shuffled) + + train_end = int(n_inputs*train_size) + X_train, X_test = inputs_shuffled[:train_end], inputs_shuffled[train_end:] + Y_train, Y_test = labels_shuffled[:train_end], labels_shuffled[train_end:] + + return X_train, X_test, Y_train, Y_test + +#X_train, X_test, Y_train, Y_test = train_test_split_numpy(inputs, labels, train_size, test_size) + +print("Number of training images: " + str(len(X_train))) +print("Number of test images: " + str(len(X_test))) +!ec + + +===== Define model and architecture ===== + +Our simple feed-forward neural network will consist of an *input* layer, a single *hidden* layer and an *output* layer. The activation $y$ of each neuron is a weighted sum of inputs, passed through an activation function. In case of the simple perceptron model we have + +$$ z = \sum_{i=1}^n w_i a_i ,$$ + +$$ y = f(z) ,$$ + +where $f$ is the activation function, $a_i$ represents input from neuron $i$ in the preceding layer +and $w_i$ is the weight to input $i$. +The activation of the neurons in the input layer is just the features (e.g. a pixel value). + +The simplest activation function for a neuron is the *Heaviside* function: + +$$ f(z) = +\begin{cases} +1, & z > 0\\ +0, & \text{otherwise} +\end{cases} +$$ + +A feed-forward neural network with this activation is known as a *perceptron*. +For a binary classifier (i.e. two classes, 0 or 1, dog or not-dog) we can also use this in our output layer. +This activation can be generalized to $k$ classes (using e.g. the *one-against-all* strategy), +and we call these architectures *multiclass perceptrons*. + +However, it is now common to use the terms Single Layer Perceptron (SLP) (1 hidden layer) and +Multilayer Perceptron (MLP) (2 or more hidden layers) to refer to feed-forward neural networks with any activation function. + +Typical choices for activation functions include the sigmoid function, hyperbolic tangent, and Rectified Linear Unit (ReLU). +We will be using the sigmoid function $\sigma(x)$: + +$$ f(x) = \sigma(x) = \frac{1}{1 + e^{-x}} ,$$ + +which is inspired by probability theory (see logistic regression) and was most commonly used until about 2011. See the discussion below concerning other activation functions. + + +===== Layers ===== + +* Input +Since each input image has 8x8 = 64 pixels or features, we have an input layer of 64 neurons. + +* Hidden layer +We will use 50 neurons in the hidden layer receiving input from the neurons in the input layer. +Since each neuron in the hidden layer is connected to the 64 inputs we have 64x50 = 3200 weights to the hidden layer. + +* Output +If we were building a binary classifier, it would be sufficient with a single neuron in the output layer, +which could output 0 or 1 according to the Heaviside function. This would be an example of a *hard* classifier, meaning it outputs the class of the input directly. However, if we are dealing with noisy data it is often beneficial to use a *soft* classifier, which outputs the probability of being in class 0 or 1. + +For a soft binary classifier, we could use a single neuron and interpret the output as either being the probability of being in class 0 or the probability of being in class 1. Alternatively we could use 2 neurons, and interpret each neuron as the probability of being in each class. + +Since we are doing multiclass classification, with 10 categories, it is natural to use 10 neurons in the output layer. We number the neurons $j = 0,1,...,9$. The activation of each output neuron $j$ will be according to the *softmax* function: + +$$ P(\text{class $j$} \mid \text{input $\hat{a}$}) = \frac{\exp{(\hat{a}^T \hat{w}_j)}} +{\sum_{c=0}^{9} \exp{(\hat{a}^T \hat{w}_c)}} ,$$ + +i.e. each neuron $j$ outputs the probability of being in class $j$ given an input from the hidden layer $\hat{a}$, with $\hat{w}_j$ the weights of neuron $j$ to the inputs. +The denominator is a normalization factor to ensure the outputs (probabilities) sum up to 1. +The exponent is just the weighted sum of inputs as before: + +$$ z_j = \sum_{i=1}^n w_ {ij} a_i+b_j.$$ + +Since each neuron in the output layer is connected to the 50 inputs from the hidden layer we have 50x10 = 500 +weights to the output layer. + + +===== Weights and biases ===== + +Typically weights are initialized with small values distributed around zero, drawn from a uniform +or normal distribution. Setting all weights to zero means all neurons give the same output, making the network useless. + +Adding a bias value to the weighted sum of inputs allows the neural network to represent a greater range +of values. Without it, any input with the value 0 will be mapped to zero (before being passed through the activation). The bias unit has an output of 1, and a weight to each neuron $j$, $b_j$: + +$$ z_j = \sum_{i=1}^n w_ {ij} a_i + b_j.$$ + +The bias weights $\hat{b}$ are often initialized to zero, but a small value like $0.01$ ensures all neurons have some output which can be backpropagated in the first training cycle. +!bc pycod +# building our neural network + +n_inputs, n_features = X_train.shape +n_hidden_neurons = 50 +n_categories = 10 + +# we make the weights normally distributed using numpy.random.randn + +# weights and bias in the hidden layer +hidden_weights = np.random.randn(n_features, n_hidden_neurons) +hidden_bias = np.zeros(n_hidden_neurons) + 0.01 + +# weights and bias in the output layer +output_weights = np.random.randn(n_hidden_neurons, n_categories) +output_bias = np.zeros(n_categories) + 0.01 +!ec + + +===== Feed-forward pass ===== + +Denote $F$ the number of features, $H$ the number of hidden neurons and $C$ the number of categories. +For each input image we calculate a weighted sum of input features (pixel values) to each neuron $j$ in the hidden layer $l$: + +$$ z_{j}^{l} = \sum_{i=1}^{F} w_{ij}^{l} x_i + b_{j}^{l},$$ + +this is then passed through our activation function + +$$ a_{j}^{l} = f(z_{j}^{l}) .$$ + +We calculate a weighted sum of inputs (activations in the hidden layer) to each neuron $j$ in the output layer: + +$$ z_{j}^{L} = \sum_{i=1}^{H} w_{ij}^{L} a_{i}^{l} + b_{j}^{L}.$$ + +Finally we calculate the output of neuron $j$ in the output layer using the softmax function: + +$$ a_{j}^{L} = \frac{\exp{(z_j^{L})}} +{\sum_{c=0}^{C-1} \exp{(z_c^{L})}} .$$ + + +===== Matrix multiplications ===== + +Since our data has the dimensions $X = (n_{inputs}, n_{features})$ and our weights to the hidden +layer have the dimensions +$W_{hidden} = (n_{features}, n_{hidden})$, +we can easily feed the network all our training data in one go by taking the matrix product + +$$ X W^{h} = (n_{inputs}, n_{hidden}),$$ + +and obtain a matrix that holds the weighted sum of inputs to the hidden layer +for each input image and each hidden neuron. +We also add the bias to obtain a matrix of weighted sums to the hidden layer $Z^{h}$: + +$$ \hat{z}^{l} = \hat{X} \hat{W}^{l} + \hat{b}^{l} ,$$ + +meaning the same bias (1D array with size equal number of hidden neurons) is added to each input image. +This is then passed through the activation: + +$$ \hat{a}^{l} = f(\hat{z}^l) .$$ + +This is fed to the output layer: + +$$ \hat{z}^{L} = \hat{a}^{L} \hat{W}^{L} + \hat{b}^{L} .$$ + +Finally we receive our output values for each image and each category by passing it through the softmax function: + +$$ output = softmax (\hat{z}^{L}) = (n_{inputs}, n_{categories}) .$$ + + +!bc pycod +# setup the feed-forward pass, subscript h = hidden layer + +def sigmoid(x): + return 1/(1 + np.exp(-x)) + +def feed_forward(X): + # weighted sum of inputs to the hidden layer + z_h = np.matmul(X, hidden_weights) + hidden_bias + # activation in the hidden layer + a_h = sigmoid(z_h) + + # weighted sum of inputs to the output layer + z_o = np.matmul(a_h, output_weights) + output_bias + # softmax output + # axis 0 holds each input and axis 1 the probabilities of each category + exp_term = np.exp(z_o) + probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True) + + return probabilities + +probabilities = feed_forward(X_train) +print("probabilities = (n_inputs, n_categories) = " + str(probabilities.shape)) +print("probability that image 0 is in category 0,1,2,...,9 = \n" + str(probabilities[0])) +print("probabilities sum up to: " + str(probabilities[0].sum())) +print() + +# we obtain a prediction by taking the class with the highest likelihood +def predict(X): + probabilities = feed_forward(X) + return np.argmax(probabilities, axis=1) + +predictions = predict(X_train) +print("predictions = (n_inputs) = " + str(predictions.shape)) +print("prediction for image 0: " + str(predictions[0])) +print("correct label for image 0: " + str(Y_train[0])) +!ec + + +===== Choose cost function and optimizer ===== + +To measure how well our neural network is doing we need to introduce a cost function. +We will call the function that gives the error of a single sample output the *loss* function, and the function +that gives the total error of our network across all samples the *cost* function. +A typical choice for multiclass classification is the *cross-entropy* loss, also known as the negative log likelihood. + +In *multiclass* classification it is common to treat each integer label as a so called *one-hot* vector: + +$$ y = 5 \quad \rightarrow \quad \hat{y} = (0, 0, 0, 0, 0, 1, 0, 0, 0, 0) ,$$ + + +$$ y = 1 \quad \rightarrow \quad \hat{y} = (0, 1, 0, 0, 0, 0, 0, 0, 0, 0) ,$$ + + +i.e. a binary bit string of length $C$, where $C = 10$ is the number of classes in the MNIST dataset. + +Let $y_{ic}$ denote the $c$-th component of the $i$-th one-hot vector. +We define the cost function $\mathcal{C}$ as a sum over the cross-entropy loss for each point $\hat{x}_i$ in the dataset. + +In the one-hot representation only one of the terms in the loss function is non-zero, namely the +probability of the correct category $c'$ +(i.e. the category $c'$ such that $y_{ic'} = 1$). This means that the cross entropy loss only punishes you for how wrong +you got the correct label. The probability of category $c$ is given by the softmax function. The vector $\hat{\theta}$ represents the parameters of our network, i.e. all the weights and biases. + + + +===== Optimizing the cost function ===== + +The network is trained by finding the weights and biases that minimize the cost function. One of the most widely used classes of methods is *gradient descent* and its generalizations. The idea behind gradient descent +is simply to adjust the weights in the direction where the gradient of the cost function is large and negative. This ensures we flow toward a *local* minimum of the cost function. +Each parameter $\theta$ is iteratively adjusted according to the rule + +$$ \theta_{i+1} = \theta_i - \eta \nabla \mathcal{C}(\theta_i) ,$$ + +where $\eta$ is known as the *learning rate*, which controls how big a step we take towards the minimum. +This update can be repeated for any number of iterations, or until we are satisfied with the result. + +A simple and effective improvement is a variant called *Batch Gradient Descent*. +Instead of calculating the gradient on the whole dataset, we calculate an approximation of the gradient +on a subset of the data called a *minibatch*. +If there are $N$ data points and we have a minibatch size of $M$, the total number of batches +is $N/M$. +We denote each minibatch $B_k$, with $k = 1, 2,...,N/M$. The gradient then becomes: + +$$ \nabla \mathcal{C}(\theta) = \frac{1}{N} \sum_{i=1}^N \nabla \mathcal{L}_i(\theta) \quad \rightarrow \quad +\frac{1}{M} \sum_{i \in B_k} \nabla \mathcal{L}_i(\theta) ,$$ + +i.e. instead of averaging the loss over the entire dataset, we average over a minibatch. + +This has two important benefits: +o Introducing stochasticity decreases the chance that the algorithm becomes stuck in a local minima. +o It significantly speeds up the calculation, since we do not have to use the entire dataset to calculate the gradient. + +The various optmization methods, with codes and algorithms, are discussed in our lectures on "Gradient descent approaches":"https://compphysics.github.io/MachineLearning/doc/pub/Splines/html/Splines-bs.html". + + +===== Regularization ===== + +It is common to add an extra term to the cost function, proportional +to the size of the weights. This is equivalent to constraining the +size of the weights, so that they do not grow out of control. +Constraining the size of the weights means that the weights cannot +grow arbitrarily large to fit the training data, and in this way +reduces *overfitting*. + +We will measure the size of the weights using the so called *L2-norm*, meaning our cost function becomes: + +$$ \mathcal{C}(\theta) = \frac{1}{N} \sum_{i=1}^N \mathcal{L}_i(\theta) \quad \rightarrow \quad +\frac{1}{N} \sum_{i=1}^N \mathcal{L}_i(\theta) + \lambda \lvert \lvert \hat{w} \rvert \rvert_2^2 += \frac{1}{N} \sum_{i=1}^N \mathcal{L}(\theta) + \lambda \sum_{ij} w_{ij}^2,$$ + +i.e. we sum up all the weights squared. The factor $\lambda$ is known as a regularization parameter. + + +In order to train the model, we need to calculate the derivative of +the cost function with respect to every bias and weight in the +network. In total our network has $(64 + 1)\times 50=3250$ weights in +the hidden layer and $(50 + 1)\times 10=510$ weights to the output +layer ($+1$ for the bias), and the gradient must be calculated for +every parameter. We use the *backpropagation* algorithm discussed +above. This is a clever use of the chain rule that allows us to +calculate the gradient efficently. + + + +===== Matrix multiplication ===== + +To more efficently train our network these equations are implemented using matrix operations. +The error in the output layer is calculated simply as, with $\hat{t}$ being our targets, + +$$ \delta_L = \hat{t} - \hat{y} = (n_{inputs}, n_{categories}) .$$ + +The gradient for the output weights is calculated as + +$$ \nabla W_{L} = \hat{a}^T \delta_L = (n_{hidden}, n_{categories}) ,$$ + +where $\hat{a} = (n_{inputs}, n_{hidden})$. This simply means that we are summing up the gradients for each input. +Since we are going backwards we have to transpose the activation matrix. + +The gradient with respect to the output bias is then + +$$ \nabla \hat{b}_{L} = \sum_{i=1}^{n_{inputs}} \delta_L = (n_{categories}) .$$ + +The error in the hidden layer is + +$$ \Delta_h = \delta_L W_{L}^T \circ f'(z_{h}) = \delta_L W_{L}^T \circ a_{h} \circ (1 - a_{h}) = (n_{inputs}, n_{hidden}) ,$$ + +where $f'(a_{h})$ is the derivative of the activation in the hidden layer. The matrix products mean +that we are summing up the products for each neuron in the output layer. The symbol $\circ$ denotes +the *Hadamard product*, meaning element-wise multiplication. + +This again gives us the gradients in the hidden layer: + +$$ \nabla W_{h} = X^T \delta_h = (n_{features}, n_{hidden}) ,$$ + +$$ \nabla b_{h} = \sum_{i=1}^{n_{inputs}} \delta_h = (n_{hidden}) .$$ + + +!bc pycod +# to categorical turns our integer vector into a onehot representation +from sklearn.metrics import accuracy_score + +# one-hot in numpy +def to_categorical_numpy(integer_vector): + n_inputs = len(integer_vector) + n_categories = np.max(integer_vector) + 1 + onehot_vector = np.zeros((n_inputs, n_categories)) + onehot_vector[range(n_inputs), integer_vector] = 1 + + return onehot_vector + +#Y_train_onehot, Y_test_onehot = to_categorical(Y_train), to_categorical(Y_test) +Y_train_onehot, Y_test_onehot = to_categorical_numpy(Y_train), to_categorical_numpy(Y_test) + +def feed_forward_train(X): + # weighted sum of inputs to the hidden layer + z_h = np.matmul(X, hidden_weights) + hidden_bias + # activation in the hidden layer + a_h = sigmoid(z_h) + + # weighted sum of inputs to the output layer + z_o = np.matmul(a_h, output_weights) + output_bias + # softmax output + # axis 0 holds each input and axis 1 the probabilities of each category + exp_term = np.exp(z_o) + probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True) + + # for backpropagation need activations in hidden and output layers + return a_h, probabilities + +def backpropagation(X, Y): + a_h, probabilities = feed_forward_train(X) + + # error in the output layer + error_output = probabilities - Y + # error in the hidden layer + error_hidden = np.matmul(error_output, output_weights.T) * a_h * (1 - a_h) + + # gradients for the output layer + output_weights_gradient = np.matmul(a_h.T, error_output) + output_bias_gradient = np.sum(error_output, axis=0) + + # gradient for the hidden layer + hidden_weights_gradient = np.matmul(X.T, error_hidden) + hidden_bias_gradient = np.sum(error_hidden, axis=0) + + return output_weights_gradient, output_bias_gradient, hidden_weights_gradient, hidden_bias_gradient + +print("Old accuracy on training data: " + str(accuracy_score(predict(X_train), Y_train))) + +eta = 0.01 +lmbd = 0.01 +for i in range(1000): + # calculate gradients + dWo, dBo, dWh, dBh = backpropagation(X_train, Y_train_onehot) + + # regularization term gradients + dWo += lmbd * output_weights + dWh += lmbd * hidden_weights + + # update weights and biases + output_weights -= eta * dWo + output_bias -= eta * dBo + hidden_weights -= eta * dWh + hidden_bias -= eta * dBh + +print("New accuracy on training data: " + str(accuracy_score(predict(X_train), Y_train))) +!ec + + +===== Improving performance ===== + +As we can see the network does not seem to be learning at all. It seems to be just guessing the label for each image. +In order to obtain a network that does something useful, we will have to do a bit more work. + +The choice of *hyperparameters* such as learning rate and regularization parameter is hugely influential for the performance of the network. Typically a *grid-search* is performed, wherein we test different hyperparameters separated by orders of magnitude. For example we could test the learning rates $\eta = 10^{-6}, 10^{-5},...,10^{-1}$ with different regularization parameters $\lambda = 10^{-6},...,10^{-0}$. + +Next, we haven't implemented minibatching yet, which introduces stochasticity and is though to act as an important regularizer on the weights. We call a feed-forward + backward pass with a minibatch an *iteration*, and a full training period +going through the entire dataset ($n/M$ batches) an *epoch*. + +If this does not improve network performance, you may want to consider altering the network architecture, adding more neurons or hidden layers. +Andrew Ng goes through some of these considerations in this "video":"https://youtu.be/F1ka6a13S9I". You can find a summary of the video "here":"https://kevinzakka.github.io/2016/09/26/applying-deep-learning/". + + +===== Full object-oriented implementation ===== + +It is very natural to think of the network as an object, with specific instances of the network +being realizations of this object with different hyperparameters. An implementation using Python classes provides a clean structure and interface, and the full implementation of our neural network is given below. + + +!bc pycod +class NeuralNetwork: + def __init__( + self, + X_data, + Y_data, + n_hidden_neurons=50, + n_categories=10, + epochs=10, + batch_size=100, + eta=0.1, + lmbd=0.0): + + self.X_data_full = X_data + self.Y_data_full = Y_data + + self.n_inputs = X_data.shape[0] + self.n_features = X_data.shape[1] + self.n_hidden_neurons = n_hidden_neurons + self.n_categories = n_categories + + self.epochs = epochs + self.batch_size = batch_size + self.iterations = self.n_inputs // self.batch_size + self.eta = eta + self.lmbd = lmbd + + self.create_biases_and_weights() + + def create_biases_and_weights(self): + self.hidden_weights = np.random.randn(self.n_features, self.n_hidden_neurons) + self.hidden_bias = np.zeros(self.n_hidden_neurons) + 0.01 + + self.output_weights = np.random.randn(self.n_hidden_neurons, self.n_categories) + self.output_bias = np.zeros(self.n_categories) + 0.01 + + def feed_forward(self): + # feed-forward for training + self.z_h = np.matmul(self.X_data, self.hidden_weights) + self.hidden_bias + self.a_h = sigmoid(self.z_h) + + self.z_o = np.matmul(self.a_h, self.output_weights) + self.output_bias + + exp_term = np.exp(self.z_o) + self.probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True) + + def feed_forward_out(self, X): + # feed-forward for output + z_h = np.matmul(X, self.hidden_weights) + self.hidden_bias + a_h = sigmoid(z_h) + + z_o = np.matmul(a_h, self.output_weights) + self.output_bias + + exp_term = np.exp(z_o) + probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True) + return probabilities + + def backpropagation(self): + error_output = self.probabilities - self.Y_data + error_hidden = np.matmul(error_output, self.output_weights.T) * self.a_h * (1 - self.a_h) + + self.output_weights_gradient = np.matmul(self.a_h.T, error_output) + self.output_bias_gradient = np.sum(error_output, axis=0) + + self.hidden_weights_gradient = np.matmul(self.X_data.T, error_hidden) + self.hidden_bias_gradient = np.sum(error_hidden, axis=0) + + if self.lmbd > 0.0: + self.output_weights_gradient += self.lmbd * self.output_weights + self.hidden_weights_gradient += self.lmbd * self.hidden_weights + + self.output_weights -= self.eta * self.output_weights_gradient + self.output_bias -= self.eta * self.output_bias_gradient + self.hidden_weights -= self.eta * self.hidden_weights_gradient + self.hidden_bias -= self.eta * self.hidden_bias_gradient + + def predict(self, X): + probabilities = self.feed_forward_out(X) + return np.argmax(probabilities, axis=1) + + def predict_probabilities(self, X): + probabilities = self.feed_forward_out(X) + return probabilities + + def train(self): + data_indices = np.arange(self.n_inputs) + + for i in range(self.epochs): + for j in range(self.iterations): + # pick datapoints with replacement + chosen_datapoints = np.random.choice( + data_indices, size=self.batch_size, replace=False + ) + + # minibatch training data + self.X_data = self.X_data_full[chosen_datapoints] + self.Y_data = self.Y_data_full[chosen_datapoints] + + self.feed_forward() + self.backpropagation() +!ec + + +===== Evaluate model performance on test data ===== + +To measure the performance of our network we evaluate how well it does it data it has never seen before, i.e. the test data. +We measure the performance of the network using the *accuracy* score. +The accuracy is as you would expect just the number of images correctly labeled divided by the total number of images. A perfect classifier will have an accuracy score of $1$. + +$$ \text{Accuracy} = \frac{\sum_{i=1}^n I(\hat{y}_i = y_i)}{n} ,$$ + +where $I$ is the indicator function, $1$ if $\hat{y}_i = y_i$ and $0$ otherwise. + + +!bc pycod +epochs = 100 +batch_size = 100 + +dnn = NeuralNetwork(X_train, Y_train_onehot, eta=eta, lmbd=lmbd, epochs=epochs, batch_size=batch_size, + n_hidden_neurons=n_hidden_neurons, n_categories=n_categories) +dnn.train() +test_predict = dnn.predict(X_test) + +# accuracy score from scikit library +print("Accuracy score on test set: ", accuracy_score(Y_test, test_predict)) + +# equivalent in numpy +def accuracy_score_numpy(Y_test, Y_pred): + return np.sum(Y_test == Y_pred) / len(Y_test) + +#print("Accuracy score on test set: ", accuracy_score_numpy(Y_test, test_predict)) +!ec + + +===== Adjust hyperparameters ===== + +We now perform a grid search to find the optimal hyperparameters for the network. +Note that we are only using 1 layer with 50 neurons, and human performance is estimated to be around $98\%$ ($2\%$ error rate). + +!bc pycod +eta_vals = np.logspace(-5, 1, 7) +lmbd_vals = np.logspace(-5, 1, 7) +# store the models for later use +DNN_numpy = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object) + +# grid search +for i, eta in enumerate(eta_vals): + for j, lmbd in enumerate(lmbd_vals): + dnn = NeuralNetwork(X_train, Y_train_onehot, eta=eta, lmbd=lmbd, epochs=epochs, batch_size=batch_size, + n_hidden_neurons=n_hidden_neurons, n_categories=n_categories) + dnn.train() + + DNN_numpy[i][j] = dnn + + test_predict = dnn.predict(X_test) + + print("Learning rate = ", eta) + print("Lambda = ", lmbd) + print("Accuracy score on test set: ", accuracy_score(Y_test, test_predict)) + print() +!ec + + +===== Visualization ===== + +!bc pycod +# visual representation of grid search +# uses seaborn heatmap, you can also do this with matplotlib imshow +import seaborn as sns + +sns.set() + +train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) +test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) + +for i in range(len(eta_vals)): + for j in range(len(lmbd_vals)): + dnn = DNN_numpy[i][j] + + train_pred = dnn.predict(X_train) + test_pred = dnn.predict(X_test) + + train_accuracy[i][j] = accuracy_score(Y_train, train_pred) + test_accuracy[i][j] = accuracy_score(Y_test, test_pred) + + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Training Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Test Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() +!ec + + +===== scikit-learn implementation ===== + +_scikit-learn_ focuses more +on traditional machine learning methods, such as regression, +clustering, decision trees, etc. As such, it has only two types of +neural networks: Multi Layer Perceptron outputting continuous values, +*MPLRegressor*, and Multi Layer Perceptron outputting labels, +*MLPClassifier*. We will see how simple it is to use these classes. + +_scikit-learn_ implements a few improvements from our neural network, +such as early stopping, a varying learning rate, different +optimization methods, etc. We would therefore expect a better +performance overall. + +!bc pycod +from sklearn.neural_network import MLPClassifier +# store models for later use +DNN_scikit = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object) + +for i, eta in enumerate(eta_vals): + for j, lmbd in enumerate(lmbd_vals): + dnn = MLPClassifier(hidden_layer_sizes=(n_hidden_neurons), activation='logistic', + alpha=lmbd, learning_rate_init=eta, max_iter=epochs) + dnn.fit(X_train, Y_train) + + DNN_scikit[i][j] = dnn + + print("Learning rate = ", eta) + print("Lambda = ", lmbd) + print("Accuracy score on test set: ", dnn.score(X_test, Y_test)) + print() +!ec + + + +===== Visualization ===== +!bc pycod +# optional +# visual representation of grid search +# uses seaborn heatmap, could probably do this in matplotlib +import seaborn as sns + +sns.set() + +train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) +test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) + +for i in range(len(eta_vals)): + for j in range(len(lmbd_vals)): + dnn = DNN_scikit[i][j] + + train_pred = dnn.predict(X_train) + test_pred = dnn.predict(X_test) + + train_accuracy[i][j] = accuracy_score(Y_train, train_pred) + test_accuracy[i][j] = accuracy_score(Y_test, test_pred) + + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Training Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Test Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() +!ec + + + +===== Building neural networks in Tensorflow and Keras ===== + +Now we want to build on the experience gained from our neural network implementation in NumPy and scikit-learn +and use it to construct a neural network in Tensorflow. Once we have constructed a neural network in NumPy +and Tensorflow, building one in Keras is really quite trivial, though the performance may suffer. + +In our previous example we used only one hidden layer, and in this we will use two. From this it should be quite +clear how to build one using an arbitrary number of hidden layers, using data structures such as Python lists or +NumPy arrays. + + +===== Tensorflow ===== + +Tensorflow is an open source library machine learning library +developed by the Google Brain team for internal use. It was released +under the Apache 2.0 open source license in November 9, 2015. + +Tensorflow is a computational framework that allows you to construct +machine learning models at different levels of abstraction, from +high-level, object-oriented APIs like Keras, down to the C++ kernels +that Tensorflow is built upon. The higher levels of abstraction are +simpler to use, but less flexible, and our choice of implementation +should reflect the problems we are trying to solve. + +"Tensorflow uses":"https://www.tensorflow.org/guide/graphs" so-called graphs to represent your computation +in terms of the dependencies between individual operations, such that you first build a Tensorflow *graph* +to represent your model, and then create a Tensorflow *session* to run the graph. + +In this guide we will analyze the same data as we did in our NumPy and +scikit-learn tutorial, gathered from the MNIST database of images. We +will give an introduction to the lower level Python Application +Program Interfaces (APIs), and see how we use them to build our graph. +Then we will build (effectively) the same graph in Keras, to see just +how simple solving a machine learning problem can be. + +To install tensorflow on Unix/Linux systems, use pip as +!bc pycod +pip3 install tensorflow +!ec +and/or if you use _anaconda_, just write (or install from the graphical user interface) +!bc pycod +conda install tensorflow +!ec + + +===== Collect and pre-process data ===== + +!bc pycod +# import necessary packages +import numpy as np +import matplotlib.pyplot as plt +from sklearn import datasets + + +# ensure the same random numbers appear every time +np.random.seed(0) + +# display images in notebook +%matplotlib inline +plt.rcParams['figure.figsize'] = (12,12) + + +# download MNIST dataset +digits = datasets.load_digits() + +# define inputs and labels +inputs = digits.images +labels = digits.target + +print("inputs = (n_inputs, pixel_width, pixel_height) = " + str(inputs.shape)) +print("labels = (n_inputs) = " + str(labels.shape)) + + +# flatten the image +# the value -1 means dimension is inferred from the remaining dimensions: 8x8 = 64 +n_inputs = len(inputs) +inputs = inputs.reshape(n_inputs, -1) +print("X = (n_inputs, n_features) = " + str(inputs.shape)) + + +# choose some random images to display +indices = np.arange(n_inputs) +random_indices = np.random.choice(indices, size=5) + +for i, image in enumerate(digits.images[random_indices]): + plt.subplot(1, 5, i+1) + plt.axis('off') + plt.imshow(image, cmap=plt.cm.gray_r, interpolation='nearest') + plt.title("Label: %d" % digits.target[random_indices[i]]) +plt.show() +!ec + +!bc pycod +from keras.utils import to_categorical +from sklearn.model_selection import train_test_split + +# one-hot representation of labels +labels = to_categorical(labels) + +# split into train and test data +train_size = 0.8 +test_size = 1 - train_size +X_train, X_test, Y_train, Y_test = train_test_split(inputs, labels, train_size=train_size, + test_size=test_size) +!ec + + +===== Using TensorFlow backend ===== + +o Define model and architecture +o Choose cost function and optimizer + +!bc pycod +import tensorflow as tf + +class NeuralNetworkTensorflow: + def __init__( + self, + X_train, + Y_train, + X_test, + Y_test, + n_neurons_layer1=100, + n_neurons_layer2=50, + n_categories=2, + epochs=10, + batch_size=100, + eta=0.1, + lmbd=0.0): + + # keep track of number of steps + self.global_step = tf.Variable(0, dtype=tf.int32, trainable=False, name='global_step') + + self.X_train = X_train + self.Y_train = Y_train + self.X_test = X_test + self.Y_test = Y_test + + self.n_inputs = X_train.shape[0] + self.n_features = X_train.shape[1] + self.n_neurons_layer1 = n_neurons_layer1 + self.n_neurons_layer2 = n_neurons_layer2 + self.n_categories = n_categories + + self.epochs = epochs + self.batch_size = batch_size + self.iterations = self.n_inputs // self.batch_size + self.eta = eta + self.lmbd = lmbd + + # build network piece by piece + # name scopes (with) are used to enforce creation of new variables + # https://www.tensorflow.org/guide/variables + self.create_placeholders() + self.create_DNN() + self.create_loss() + self.create_optimiser() + self.create_accuracy() + + def create_placeholders(self): + # placeholders are fine here, but "Datasets" are the preferred method + # of streaming data into a model + with tf.name_scope('data'): + self.X = tf.placeholder(tf.float32, shape=(None, self.n_features), name='X_data') + self.Y = tf.placeholder(tf.float32, shape=(None, self.n_categories), name='Y_data') + + def create_DNN(self): + with tf.name_scope('DNN'): + # the weights are stored to calculate regularization loss later + + # Fully connected layer 1 + self.W_fc1 = self.weight_variable([self.n_features, self.n_neurons_layer1], name='fc1', dtype=tf.float32) + b_fc1 = self.bias_variable([self.n_neurons_layer1], name='fc1', dtype=tf.float32) + a_fc1 = tf.nn.sigmoid(tf.matmul(self.X, self.W_fc1) + b_fc1) + + # Fully connected layer 2 + self.W_fc2 = self.weight_variable([self.n_neurons_layer1, self.n_neurons_layer2], name='fc2', dtype=tf.float32) + b_fc2 = self.bias_variable([self.n_neurons_layer2], name='fc2', dtype=tf.float32) + a_fc2 = tf.nn.sigmoid(tf.matmul(a_fc1, self.W_fc2) + b_fc2) + + # Output layer + self.W_out = self.weight_variable([self.n_neurons_layer2, self.n_categories], name='out', dtype=tf.float32) + b_out = self.bias_variable([self.n_categories], name='out', dtype=tf.float32) + self.z_out = tf.matmul(a_fc2, self.W_out) + b_out + + def create_loss(self): + with tf.name_scope('loss'): + softmax_loss = tf.reduce_mean(tf.nn.softmax_cross_entropy_with_logits_v2(labels=self.Y, logits=self.z_out)) + + regularizer_loss_fc1 = tf.nn.l2_loss(self.W_fc1) + regularizer_loss_fc2 = tf.nn.l2_loss(self.W_fc2) + regularizer_loss_out = tf.nn.l2_loss(self.W_out) + regularizer_loss = self.lmbd*(regularizer_loss_fc1 + regularizer_loss_fc2 + regularizer_loss_out) + + self.loss = softmax_loss + regularizer_loss + + def create_accuracy(self): + with tf.name_scope('accuracy'): + probabilities = tf.nn.softmax(self.z_out) + predictions = tf.argmax(probabilities, axis=1) + labels = tf.argmax(self.Y, axis=1) + + correct_predictions = tf.equal(predictions, labels) + correct_predictions = tf.cast(correct_predictions, tf.float32) + self.accuracy = tf.reduce_mean(correct_predictions) + + def create_optimiser(self): + with tf.name_scope('optimizer'): + self.optimizer = tf.train.GradientDescentOptimizer(learning_rate=self.eta).minimize(self.loss, global_step=self.global_step) + + def weight_variable(self, shape, name='', dtype=tf.float32): + initial = tf.truncated_normal(shape, stddev=0.1) + return tf.Variable(initial, name=name, dtype=dtype) + + def bias_variable(self, shape, name='', dtype=tf.float32): + initial = tf.constant(0.1, shape=shape) + return tf.Variable(initial, name=name, dtype=dtype) + + def fit(self): + data_indices = np.arange(self.n_inputs) + + with tf.Session() as sess: + sess.run(tf.global_variables_initializer()) + for i in range(self.epochs): + for j in range(self.iterations): + chosen_datapoints = np.random.choice(data_indices, size=self.batch_size, replace=False) + batch_X, batch_Y = self.X_train[chosen_datapoints], self.Y_train[chosen_datapoints] + + sess.run([DNN.loss, DNN.optimizer], + feed_dict={DNN.X: batch_X, + DNN.Y: batch_Y}) + accuracy = sess.run(DNN.accuracy, + feed_dict={DNN.X: batch_X, + DNN.Y: batch_Y}) + step = sess.run(DNN.global_step) + + self.train_loss, self.train_accuracy = sess.run([DNN.loss, DNN.accuracy], + feed_dict={DNN.X: self.X_train, + DNN.Y: self.Y_train}) + + self.test_loss, self.test_accuracy = sess.run([DNN.loss, DNN.accuracy], + feed_dict={DNN.X: self.X_test, + DNN.Y: self.Y_test}) +!ec + + + +===== Optimizing and using gradient descent ===== + +!bc pycod +epochs = 100 +batch_size = 100 +n_neurons_layer1 = 100 +n_neurons_layer2 = 50 +n_categories = 10 +eta_vals = np.logspace(-5, 1, 7) +lmbd_vals = np.logspace(-5, 1, 7) +!ec + + +!bc pycod +DNN_tf = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object) + +for i, eta in enumerate(eta_vals): + for j, lmbd in enumerate(lmbd_vals): + DNN = NeuralNetworkTensorflow(X_train, Y_train, X_test, Y_test, + n_neurons_layer1, n_neurons_layer2, n_categories, + epochs=epochs, batch_size=batch_size, eta=eta, lmbd=lmbd) + DNN.fit() + + DNN_tf[i][j] = DNN + + print("Learning rate = ", eta) + print("Lambda = ", lmbd) + print("Test accuracy: %.3f" % DNN.test_accuracy) + print() +!ec + +!bc pycod +# optional +# visual representation of grid search +# uses seaborn heatmap, could probably do this in matplotlib +import seaborn as sns + +sns.set() + +train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) +test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) + +for i in range(len(eta_vals)): + for j in range(len(lmbd_vals)): + DNN = DNN_tf[i][j] + + train_accuracy[i][j] = DNN.train_accuracy + test_accuracy[i][j] = DNN.test_accuracy + + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Training Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Test Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() +!ec + +!bc pycod +# optional +# we can use log files to visualize our graph in Tensorboard +writer = tf.summary.FileWriter('logs/') +writer.add_graph(tf.get_default_graph()) +!ec + + + +===== Using Keras ===== + +Keras is a high level "neural network":"https://en.wikipedia.org/wiki/Application_programming_interface" +that supports Tensorflow, CTNK and Theano as backends. +If you have Tensorflow installed Keras is available through the *tf.keras* module. +If you have Anaconda installed you may run the following command +!bc pycod +conda install keras +!ec + +Alternatively, if you have Tensorflow or one of the other supported backends install you may use the pip package manager: + +!bc pycod +pip3 install keras +!ec +or look up the "instructions here":"https://keras.io/". + +!bc pycod +from keras.models import Sequential +from keras.layers import Dense +from keras.regularizers import l2 +from keras.optimizers import SGD + +def create_neural_network_keras(n_neurons_layer1, n_neurons_layer2, n_categories, eta, lmbd): + model = Sequential() + model.add(Dense(n_neurons_layer1, activation='sigmoid', kernel_regularizer=l2(lmbd))) + model.add(Dense(n_neurons_layer2, activation='sigmoid', kernel_regularizer=l2(lmbd))) + model.add(Dense(n_categories, activation='softmax')) + + sgd = SGD(lr=eta) + model.compile(loss='categorical_crossentropy', optimizer=sgd, metrics=['accuracy']) + + return model +!ec + +!bc pycod +DNN_keras = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object) + +for i, eta in enumerate(eta_vals): + for j, lmbd in enumerate(lmbd_vals): + DNN = create_neural_network_keras(n_neurons_layer1, n_neurons_layer2, n_categories, + eta=eta, lmbd=lmbd) + DNN.fit(X_train, Y_train, epochs=epochs, batch_size=batch_size, verbose=0) + scores = DNN.evaluate(X_test, Y_test) + + DNN_keras[i][j] = DNN + + print("Learning rate = ", eta) + print("Lambda = ", lmbd) + print("Test accuracy: %.3f" % scores[1]) + print() +!ec + +!bc pycod +# optional +# visual representation of grid search +# uses seaborn heatmap, could probably do this in matplotlib +import seaborn as sns + +sns.set() + +train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) +test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) + +for i in range(len(eta_vals)): + for j in range(len(lmbd_vals)): + DNN = DNN_keras[i][j] + + train_accuracy[i][j] = DNN.evaluate(X_train, Y_train)[1] + test_accuracy[i][j] = DNN.evaluate(X_test, Y_test)[1] + + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Training Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Test Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() +!ec + + + + + +===== Which activation function should I use? ===== + +The Back propagation algorithm we derived above works by going from +the output layer to the input layer, propagating the error gradient on +the way. Once the algorithm has computed the gradient of the cost +function with regards to each parameter in the network, it uses these +gradients to update each parameter with a Gradient Descent (GD) step. + + +Unfortunately for us, the gradients often get smaller and smaller as the +algorithm progresses down to the first hidden layers. As a result, the +GD update leaves the lower layer connection weights +virtually unchanged, and training never converges to a good +solution. This is known in the literature as +_the vanishing gradients problem_. + +In other cases, the opposite can happen, namely the the gradients can grow bigger and +bigger. The result is that many of the layers get large updates of the +weights the +algorithm diverges. This is the _exploding gradients problem_, which is +mostly encountered in recurrent neural networks. More generally, deep +neural networks suffer from unstable gradients, different layers may +learn at widely different speeds + + +===== Is the Logistic activation function (Sigmoid) our choice? ===== + +Although this unfortunate behavior has been empirically observed for +quite a while (it was one of the reasons why deep neural networks were +mostly abandoned for a long time), it is only around 2010 that +significant progress was made in understanding it. + +A paper titled "Understanding the Difficulty of Training Deep +Feedforward Neural Networks by Xavier Glorot and Yoshua Bengio":"http://proceedings.mlr.press/v9/glorot10a.html" found that +the problems with the popular logistic +sigmoid activation function and the weight initialization technique +that was most popular at the time, namely random initialization using +a normal distribution with a mean of 0 and a standard deviation of +1. + +They showed that with this activation function and this +initialization scheme, the variance of the outputs of each layer is +much greater than the variance of its inputs. Going forward in the +network, the variance keeps increasing after each layer until the +activation function saturates at the top layers. This is actually made +worse by the fact that the logistic function has a mean of 0.5, not 0 +(the hyperbolic tangent function has a mean of 0 and behaves slightly +better than the logistic function in deep networks). + + + +===== The derivative of the Logistic funtion ===== + +Looking at the logistic activation function, when inputs become large +(negative or positive), the function saturates at 0 or 1, with a +derivative extremely close to 0. Thus when backpropagation kicks in, +it has virtually no gradient to propagate back through the network, +and what little gradient exists keeps getting diluted as +backpropagation progresses down through the top layers, so there is +really nothing left for the lower layers. + +In their paper, Glorot and Bengio propose a way to significantly +alleviate this problem. We need the signal to flow properly in both +directions: in the forward direction when making predictions, and in +the reverse direction when backpropagating gradients. We don’t want +the signal to die out, nor do we want it to explode and saturate. For +the signal to flow properly, the authors argue that we need the +variance of the outputs of each layer to be equal to the variance of +its inputs, and we also need the gradients to have equal variance +before and after flowing through a layer in the reverse direction. + + + +One of the insights in the 2010 paper by Glorot and Bengio was that +the vanishing/exploding gradients problems were in part due to a poor +choice of activation function. Until then most people had assumed that +if Nature had chosen to use roughly sigmoid activation functions in +biological neurons, they must be an excellent choice. But it turns out +that other activation functions behave much better in deep neural +networks, in particular the ReLU activation function, mostly because +it does not saturate for positive values (and also because it is quite +fast to compute). + + + +===== The RELU function family ===== + +The ReLU activation function suffers from a problem known as the dying +ReLUs: during training, some neurons effectively die, meaning they +stop outputting anything other than 0. + +In some cases, you may find that half of your network’s neurons are +dead, especially if you used a large learning rate. During training, +if a neuron’s weights get updated such that the weighted sum of the +neuron’s inputs is negative, it will start outputting 0. When this +happen, the neuron is unlikely to come back to life since the gradient +of the ReLU function is 0 when its input is negative. + +To solve this problem, nowadays practitioners use a variant of the ReLU +function, such as the leaky ReLU discussed above or the so-called +exponential linear unit (ELU) function + + +!bt +\[ +ELU(z) = \left\{\begin{array}{cc} \alpha\left( \exp{(z)}-1\right) & z < 0,\\ z & z \ge 0.\end{array}\right. +\] +!et + + +===== Which activation function should we use? ===== + +In general it seems that the ELU activation function is better than +the leaky ReLU function (and its variants), which is better than +ReLU. ReLU performs better than $\tanh$ which in turn performs better +than the logistic function. + +If runtime +performance is an issue, then you may opt for the leaky ReLU function over the +ELU function If you don’t +want to tweak yet another hyperparameter, you may just use the default +$\alpha$ of $0.01$ for the leaky ReLU, and $1$ for ELU. If you have +spare time and computing power, you can use cross-validation or +bootstrap to evaluate other activation functions. + + + +===== A top-down perspective on Neural networks ===== + + +The first thing we would like to do is divide the data into two or three +parts. A training set, a validation or dev (development) set, and a +test set. The test set is the data on which we want to make +predictions. The dev set is a subset of the training data we use to +check how well we are doing out-of-sample, after training the model on +the training dataset. We use the validation error as a proxy for the +test error in order to make tweaks to our model. It is crucial that we +do not use any of the test data to train the algorithm. This is a +cardinal sin in ML. Then: + + +* Estimate optimal error rate + +* Minimize underfitting (bias) on training data set. + +* Make sure you are not overfitting. + +If the validation and test sets are drawn from the same distributions, +then a good performance on the validation set should lead to similarly +good performance on the test set. + +However, sometimes +the training data and test data differ in subtle ways because, for +example, they are collected using slightly different methods, or +because it is cheaper to collect data in one way versus another. In +this case, there can be a mismatch between the training and test +data. This can lead to the neural network overfitting these small +differences between the test and training sets, and a poor performance +on the test set despite having a good performance on the validation +set. To rectify this, Andrew Ng suggests making two validation or dev +sets, one constructed from the training data and one constructed from +the test data. The difference between the performance of the algorithm +on these two validation sets quantifies the train-test mismatch. This +can serve as another important diagnostic when using DNNs for +supervised learning. + + +===== Limitations of supervised learning with deep networks ===== + +Like all statistical methods, supervised learning using neural +networks has important limitations. This is especially important when +one seeks to apply these methods, especially to physics problems. Like +all tools, DNNs are not a universal solution. Often, the same or +better performance on a task can be achieved by using a few +hand-engineered features (or even a collection of random +features). + +Here we list some of the important limitations of supervised neural network based models. + + + +* _Need labeled data_. All supervised learning methods, DNNs for supervised learning require labeled data. Often, labeled data is harder to acquire than unlabeled data (e.g. one must pay for human experts to label images). +* _Supervised neural networks are extremely data intensive._ DNNs are data hungry. They perform best when data is plentiful. This is doubly so for supervised methods where the data must also be labeled. The utility of DNNs is extremely limited if data is hard to acquire or the datasets are small (hundreds to a few thousand samples). In this case, the performance of other methods that utilize hand-engineered features can exceed that of DNNs. +* _Homogeneous data._ Almost all DNNs deal with homogeneous data of one type. It is very hard to design architectures that mix and match data types (i.e.~some continuous variables, some discrete variables, some time series). In applications beyond images, video, and language, this is often what is required. In contrast, ensemble models like random forests or gradient-boosted trees have no difficulty handling mixed data types. +* _Many problems are not about prediction._ In natural science we are often interested in learning something about the underlying distribution that generates the data. In this case, it is often difficult to cast these ideas in a supervised learning setting. While the problems are related, it is possible to make good predictions with a *wrong* model. The model might or might not be useful for understanding the underlying science. + +Some of these remarks are particular to DNNs, others are shared by all supervised learning methods. This motivates the use of unsupervised methods which in part circumvent these problems. + + diff --git a/doc/src/NeuralNet/chapter6.do.txt~ b/doc/src/NeuralNet/chapter6.do.txt~ new file mode 100644 index 000000000..03fc84106 --- /dev/null +++ b/doc/src/NeuralNet/chapter6.do.txt~ @@ -0,0 +1,2466 @@ +TITLE: Data Analysis and Machine Learning: Neural networks, from the simple perceptron to deep learning +AUTHOR: Morten Hjorth-Jensen {copyright, 1999-present|CC BY-NC} at Department of Physics, University of Oslo & Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University +DATE: today + + +!split +===== To do list ===== + +* write code for single perceptron model and make link with linear regression +* revise initial info and add references +* Update tensorflow material, with keras +* think of adding material about pytorch +* rework pulsar example and breast cancer example +* add ising model example for both regression and classification +* make data on gravitational problem, add reference to articles on uncovering physical laws from ML +* think of genetic data + + +!split +===== Neural networks ===== + +Artificial neural networks are computational systems that can learn to +perform tasks by considering examples, generally without being +programmed with any task-specific rules. It is supposed to mimic a +biological system, wherein neurons interact by sending signals in the +form of mathematical functions between layers. All layers can contain +an arbitrary number of neurons, and each connection is represented by +a weight variable. + + +!split +===== Artificial neurons ===== + +The field of artificial neural networks has a long history of +development, and is closely connected with the advancement of computer +science and computers in general. A model of artificial neurons was +first developed by McCulloch and Pitts in 1943 to study signal +processing in the brain and has later been refined by others. The +general idea is to mimic neural networks in the human brain, which is +composed of billions of neurons that communicate with each other by +sending electrical signals. Each neuron accumulates its incoming +signals, which must exceed an activation threshold to yield an +output. If the threshold is not overcome, the neuron remains inactive, +i.e. has zero output. + +This behaviour has inspired a simple mathematical model for an artificial neuron. + +!bt +\begin{equation} + y = f\left(\sum_{i=1}^n w_ix_i\right) = f(u) + label{artificialNeuron} +\end{equation} +!et +Here, the output $y$ of the neuron is the value of its activation function, which have as input +a weighted sum of signals $x_i, \dots ,x_n$ received by $n$ other neurons. + +Conceptually, it is helpful to divide neural networks into four +categories: +o general purpose neural networks for supervised learning, +o neural networks designed specifically for image processing, the most prominent example of this class being Convolutional Neural Networks (CNNs), +o neural networks for sequential data such as Recurrent Neural Networks (RNNs), and +o neural networks for unsupervised learning such as Deep Boltzmann Machines. + + +In natural science, DNNs and CNNs have already found numerous +applications. In statistical physics, they have been applied to detect +phase transitions in 2D Ising and Potts models, lattice gauge +theories, and different phases of polymers, or solving the +Navier-Stokes equation in weather forecasting. Deep learning has also +found interesting applications in quantum physics. Various quantum +phase transitions can be detected and studied using DNNs and CNNs, +topological phases, and even non-equilibrium many-body +localization. Representing quantum states as DNNs quantum state +tomography are among some of the impressive achievements to reveal the +potential of DNNs to facilitate the study of quantum systems. + +In quantum information theory, it has been shown that one can perform +gate decompositions with the help of neural. + +The applications are not limited to the natural sciences. There is a +plethora of applications in essentially all disciplines, from the +humanities to life science and medicine. + +!split +===== Neural network types ===== + +An artificial neural network (ANN), is a computational model that +consists of layers of connected neurons, or nodes or units. We will +refer to these interchangeably as units or nodes, and sometimes as +neurons. + +It is supposed to mimic a biological nervous system by letting each +neuron interact with other neurons by sending signals in the form of +mathematical functions between layers. A wide variety of different +ANNs have been developed, but most of them consist of an input layer, +an output layer and eventual layers in-between, called *hidden +layers*. All layers can contain an arbitrary number of nodes, and each +connection between two nodes is associated with a weight variable. + +Neural networks (also called neural nets) are neural-inspired +nonlinear models for supervised learning. As we will see, neural nets +can be viewed as natural, more powerful extensions of supervised +learning methods such as linear and logistic regression and soft-max +methods we discussed earlier. + + +!split +===== Feed-forward neural networks ===== + +The feed-forward neural network (FFNN) was the first and simplest type +of ANNs that were devised. In this network, the information moves in +only one direction: forward through the layers. + +Nodes are represented by circles, while the arrows display the +connections between the nodes, including the direction of information +flow. Additionally, each arrow corresponds to a weight variable +(figure to come). We observe that each node in a layer is connected +to *all* nodes in the subsequent layer, making this a so-called +*fully-connected* FFNN. + + + +!split +===== Convolutional Neural Network ===== + +A different variant of FFNNs are *convolutional neural networks* +(CNNs), which have a connectivity pattern inspired by the animal +visual cortex. Individual neurons in the visual cortex only respond to +stimuli from small sub-regions of the visual field, called a receptive +field. This makes the neurons well-suited to exploit the strong +spatially local correlation present in natural images. The response of +each neuron can be approximated mathematically as a convolution +operation. (figure to come) + +Convolutional neural networks emulate the behaviour of neurons in the +visual cortex by enforcing a *local* connectivity pattern between +nodes of adjacent layers: Each node in a convolutional layer is +connected only to a subset of the nodes in the previous layer, in +contrast to the fully-connected FFNN. Often, CNNs consist of several +convolutional layers that learn local features of the input, with a +fully-connected layer at the end, which gathers all the local data and +produces the outputs. They have wide applications in image and video +recognition. + +!split +===== Recurrent neural networks ===== + +So far we have only mentioned ANNs where information flows in one +direction: forward. *Recurrent neural networks* on the other hand, +have connections between nodes that form directed *cycles*. This +creates a form of internal memory which are able to capture +information on what has been calculated before; the output is +dependent on the previous computations. Recurrent NNs make use of +sequential information by performing the same task for every element +in a sequence, where each element depends on previous elements. An +example of such information is sentences, making recurrent NNs +especially well-suited for handwriting and speech recognition. + +!split +===== Other types of networks ===== + +There are many other kinds of ANNs that have been developed. One type +that is specifically designed for interpolation in multidimensional +space is the radial basis function (RBF) network. RBFs are typically +made up of three layers: an input layer, a hidden layer with +non-linear radial symmetric activation functions and a linear output +layer (''linear'' here means that each node in the output layer has a +linear activation function). The layers are normally fully-connected +and there are no cycles, thus RBFs can be viewed as a type of +fully-connected FFNN. They are however usually treated as a separate +type of NN due the unusual activation functions. + +!split +===== Multilayer perceptrons ===== + +One uses often so-called fully-connected feed-forward neural networks +with three or more layers (an input layer, one or more hidden layers +and an output layer) consisting of neurons that have non-linear +activation functions. + +Such networks are often called *multilayer perceptrons* (MLPs). + +!split +===== Why multilayer perceptrons? ===== + +According to the *Universal approximation theorem*, a feed-forward +neural network with just a single hidden layer containing a finite +number of neurons can approximate a continuous multidimensional +function to arbitrary accuracy, assuming the activation function for +the hidden layer is a _non-constant, bounded and +monotonically-increasing continuous function_. + +Note that the requirements on the activation function only applies to +the hidden layer, the output nodes are always assumed to be linear, so +as to not restrict the range of output values. + + +!split +===== Mathematical model ===== + +The output $y$ is produced via the activation function $f$ +!bt +\[ + y = f\left(\sum_{i=1}^n w_ix_i + b_i\right) = f(z), +\] +!et +This function receives $x_i$ as inputs. +Here the activation $z=(\sum_{i=1}^n w_ix_i+b_i)$. +In an FFNN of such neurons, the *inputs* $x_i$ are the *outputs* of +the neurons in the preceding layer. Furthermore, an MLP is +fully-connected, which means that each neuron receives a weighted sum +of the outputs of *all* neurons in the previous layer. + +!split +===== Mathematical model ===== + +First, for each node $i$ in the first hidden layer, we calculate a weighted sum $z_i^1$ of the input coordinates $x_j$, + +!bt +\begin{equation} z_i^1 = \sum_{j=1}^{M} w_{ij}^1 x_j + b_i^1 +\end{equation} +!et + +Here $b_i$ is the so-called bias which is normally needed in +case of zero activation weights or inputs. How to fix the biases and +the weights will be discussed below. The value of $z_i^1$ is the +argument to the activation function $f_i$ of each node $i$, The +variable $M$ stands for all possible inputs to a given node $i$ in the +first layer. We define the output $y_i^1$ of all neurons in layer 1 as + +!bt +\begin{equation} + y_i^1 = f(z_i^1) = f\left(\sum_{j=1}^M w_{ij}^1 x_j + b_i^1\right) + label{outputLayer1} +\end{equation} +!et + +where we assume that all nodes in the same layer have identical +activation functions, hence the notation $f$. In general, we could assume in the more general case that different layers have different activation functions. +In this case we would identify these functions with a superscript $l$ for the $l$-th layer, + +!bt +\begin{equation} + y_i^l = f^l(u_i^l) = f^l\left(\sum_{j=1}^{N_{l-1}} w_{ij}^l y_j^{l-1} + b_i^l\right) + label{generalLayer} +\end{equation} +!et + +where $N_l$ is the number of nodes in layer $l$. When the output of +all the nodes in the first hidden layer are computed, the values of +the subsequent layer can be calculated and so forth until the output +is obtained. + + + +!split +===== Mathematical model ===== + +The output of neuron $i$ in layer 2 is thus, + +!bt +\begin{align} + y_i^2 &= f^2\left(\sum_{j=1}^N w_{ij}^2 y_j^1 + b_i^2\right) \\ + &= f^2\left[\sum_{j=1}^N w_{ij}^2f^1\left(\sum_{k=1}^M w_{jk}^1 x_k + b_j^1\right) + b_i^2\right] + label{outputLayer2} +\end{align} +!et +where we have substituted $y_k^1$ with the inputs $x_k$. Finally, the ANN output reads + +!bt +\begin{align} + y_i^3 &= f^3\left(\sum_{j=1}^N w_{ij}^3 y_j^2 + b_i^3\right) \\ + &= f_3\left[\sum_{j} w_{ij}^3 f^2\left(\sum_{k} w_{jk}^2 f^1\left(\sum_{m} w_{km}^1 x_m + b_k^1\right) + b_j^2\right) + + b_1^3\right] +\end{align} +!et + +!split +===== Mathematical model ===== + +We can generalize this expression to an MLP with $l$ hidden +layers. The complete functional form is, + +!bt +\begin{align} +&y^{l+1}_i = f^{l+1}\left[\!\sum_{j=1}^{N_l} w_{ij}^3 f^l\left(\sum_{k=1}^{N_{l-1}}w_{jk}^{l-1}\left(\dots f^1\left(\sum_{n=1}^{N_0} w_{mn}^1 x_n+ b_m^1\right)\dots\right)+b_k^2\right)+b_1^3\right] && + label{completeNN} +\end{align} +!et + +which illustrates a basic property of MLPs: The only independent +variables are the input values $x_n$. + +!split +===== Mathematical model ===== + +This confirms that an MLP, despite its quite convoluted mathematical +form, is nothing more than an analytic function, specifically a +mapping of real-valued vectors $\hat{x} \in \mathbb{R}^n \rightarrow +\hat{y} \in \mathbb{R}^m$. + +Furthermore, the flexibility and universality of an MLP can be +illustrated by realizing that the expression is essentially a nested +sum of scaled activation functions of the form + +!bt +\begin{equation} + f(x) = c_1 f(c_2 x + c_3) + c_4 +\end{equation} +!et + +where the parameters $c_i$ are weights and biases. By adjusting these +parameters, the activation functions can be shifted up and down or +left and right, change slope or be rescaled which is the key to the +flexibility of a neural network. + +!split +=== Matrix-vector notation === + +We can introduce a more convenient notation for the activations in an A NN. + +Additionally, we can represent the biases and activations +as layer-wise column vectors $\hat{b}_l$ and $\hat{y}_l$, so that the $i$-th element of each vector +is the bias $b_i^l$ and activation $y_i^l$ of node $i$ in layer $l$ respectively. + +We have that $\mathrm{W}_l$ is an $N_{l-1} \times N_l$ matrix, while $\hat{b}_l$ and $\hat{y}_l$ are $N_l \times 1$ column vectors. +With this notation, the sum becomes a matrix-vector multiplication, and we can write +the equation for the activations of hidden layer 2 (assuming three nodes for simplicity) as +!bt +\begin{equation} + \hat{y}_2 = f_2(\mathrm{W}_2 \hat{y}_{1} + \hat{b}_{2}) = + f_2\left(\left[\begin{array}{ccc} + w^2_{11} &w^2_{12} &w^2_{13} \\ + w^2_{21} &w^2_{22} &w^2_{23} \\ + w^2_{31} &w^2_{32} &w^2_{33} \\ + \end{array} \right] \cdot + \left[\begin{array}{c} + y^1_1 \\ + y^1_2 \\ + y^1_3 \\ + \end{array}\right] + + \left[\begin{array}{c} + b^2_1 \\ + b^2_2 \\ + b^2_3 \\ + \end{array}\right]\right). +\end{equation} +!et + +!split +=== Matrix-vector notation and activation === + +The activation of node $i$ in layer 2 is + +!bt +\begin{equation} + y^2_i = f_2\Bigr(w^2_{i1}y^1_1 + w^2_{i2}y^1_2 + w^2_{i3}y^1_3 + b^2_i\Bigr) = + f_2\left(\sum_{j=1}^3 w^2_{ij} y_j^1 + b^2_i\right). +\end{equation} +!et + +This is not just a convenient and compact notation, but also a useful +and intuitive way to think about MLPs: The output is calculated by a +series of matrix-vector multiplications and vector additions that are +used as input to the activation functions. For each operation +$\mathrm{W}_l \hat{y}_{l-1}$ we move forward one layer. + + +!split +=== Activation functions === + + +A property that characterizes a neural network, other than its +connectivity, is the choice of activation function(s). As described +in, the following restrictions are imposed on an activation function +for a FFNN to fulfill the universal approximation theorem + + * Non-constant + + * Bounded + + * Monotonically-increasing + + * Continuous + +!split +=== Activation functions, Logistic and Hyperbolic ones === + +The second requirement excludes all linear functions. Furthermore, in +a MLP with only linear activation functions, each layer simply +performs a linear transformation of its inputs. + +Regardless of the number of layers, the output of the NN will be +nothing but a linear function of the inputs. Thus we need to introduce +some kind of non-linearity to the NN to be able to fit non-linear +functions Typical examples are the logistic *Sigmoid* + +!bt +\[ + f(x) = \frac{1}{1 + e^{-x}}, +\] +!et +and the *hyperbolic tangent* function +!bt +\[ + f(x) = \tanh(x) +\] +!et + +!split +=== Relevance === + +The *sigmoid* function are more biologically plausible because the +output of inactive neurons are zero. Such activation function are +called *one-sided*. However, it has been shown that the hyperbolic +tangent performs better than the sigmoid for training MLPs. has +become the most popular for *deep neural networks* + +!bc pycod +"""The sigmoid function (or the logistic curve) is a +function that takes any real number, z, and outputs a number (0,1). +It is useful in neural networks for assigning weights on a relative scale. +The value z is the weighted sum of parameters involved in the learning algorithm.""" + +import numpy +import matplotlib.pyplot as plt +import math as mt + +z = numpy.arange(-5, 5, .1) +sigma_fn = numpy.vectorize(lambda z: 1/(1+numpy.exp(-z))) +sigma = sigma_fn(z) + +fig = plt.figure() +ax = fig.add_subplot(111) +ax.plot(z, sigma) +ax.set_ylim([-0.1, 1.1]) +ax.set_xlim([-5,5]) +ax.grid(True) +ax.set_xlabel('z') +ax.set_title('sigmoid function') + +plt.show() + +"""Step Function""" +z = numpy.arange(-5, 5, .02) +step_fn = numpy.vectorize(lambda z: 1.0 if z >= 0.0 else 0.0) +step = step_fn(z) + +fig = plt.figure() +ax = fig.add_subplot(111) +ax.plot(z, step) +ax.set_ylim([-0.5, 1.5]) +ax.set_xlim([-5,5]) +ax.grid(True) +ax.set_xlabel('z') +ax.set_title('step function') + +plt.show() + +"""Sine Function""" +z = numpy.arange(-2*mt.pi, 2*mt.pi, 0.1) +t = numpy.sin(z) + +fig = plt.figure() +ax = fig.add_subplot(111) +ax.plot(z, t) +ax.set_ylim([-1.0, 1.0]) +ax.set_xlim([-2*mt.pi,2*mt.pi]) +ax.grid(True) +ax.set_xlabel('z') +ax.set_title('sine function') + +plt.show() + +"""Plots a graph of the squashing function used by a rectified linear +unit""" +z = numpy.arange(-2, 2, .1) +zero = numpy.zeros(len(z)) +y = numpy.max([zero, z], axis=0) + +fig = plt.figure() +ax = fig.add_subplot(111) +ax.plot(z, y) +ax.set_ylim([-2.0, 2.0]) +ax.set_xlim([-2.0, 2.0]) +ax.grid(True) +ax.set_xlabel('z') +ax.set_title('Rectified linear unit') + +plt.show() +!ec + + +!split +===== The multilayer perceptron (MLP) ===== + +The multilayer perceptron is a very popular, and easy to implement approach, to deep learning. It consists of +o A neural network with one or more layers of nodes between the input and the output nodes. +o The multilayer network structure, or architecture, or topology, consists of an input layer, one or more hidden layers, and one output layer. +o The input nodes pass values to the first hidden layer, its nodes pass the information on to the second and so on till we reach the output layer. + +As a convention it is normal to call a network with one layer of input units, one layer of hidden +units and one layer of output units as a two-layer network. A network with two layers of hidden units is called a three-layer network etc etc. + +For an MLP network there is no direct connection between the output nodes/neurons/units and the input nodes/neurons/units. +Hereafter we will call the various entities of a layer for nodes. +There are also no connections within a single layer. + +The number of input nodes does not need to equal the number of output +nodes. This applies also to the hidden layers. Each layer may have its +own number of nodes and activation functions. + +The hidden layers have their name from the fact that they are not +linked to observables and as we will see below when we define the +so-called activation $\hat{z}$, we can think of this as a basis +expansion of the original inputs $\hat{x}$. The difference however +between neural networks and say linear regression is that now these +basis functions (which will correspond to the weights in the network) +are learned from data. This results in an important difference between +neural networks and deep learning approaches on one side and methods +like logistic regression or linear regression and their modifications on the other side. + + +!split +===== From one to many layers, the universal approximation theorem ===== + + +A neural network with only one layer, what we called the simple +perceptron, is best suited if we have a standard binary model with +clear (linear) boundaries between the outcomes. As such it could +equally well be replaced by standard linear regression or logistic +regression. Networks with one or more hidden layers approximate +systems with more complex boundaries. + +As stated earlier, +an important theorem in studies of neural networks, restated without +proof here, is the "universal approximation +theorem":"http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.441.7873&rep=rep1&type=pdf". + +It states that a feed-forward network with a single hidden layer +containing a finite number of neurons can approximate continuous +functions on compact subsets of real functions. The theorem thus +states that simple neural networks can represent a wide variety of +interesting functions when given appropriate parameters. It is the +multilayer feedforward architecture itself which gives neural networks +the potential of being universal approximators. + + +!split +===== Deriving the back propagation code for a multilayer perceptron model ===== + + +_Note: figures will be inserted later!_ + +As we have seen now in a feed forward network, we can express the final output of our network in terms of basic matrix-vector multiplications. +The unknowwn quantities are our weights $w_{ij}$ and we need to find an algorithm for changing them so that our errors are as small as possible. +This leads us to the famous "back propagation algorithm":"https://www.nature.com/articles/323533a0". + +The questions we want to ask are how do changes in the biases and the +weights in our network change the cost function and how can we use the +final output to modify the weights? + +To derive these equations let us start with a plain regression problem +and define our cost function as + +!bt +\[ +{\cal C}(\hat{W}) = \frac{1}{2}\sum_{i=1}^n\left(y_i - t_i\right)^2, +\] +!et + +where the $t_i$s are our $n$ targets (the values we want to +reproduce), while the outputs of the network after having propagated +all inputs $\hat{x}$ are given by $y_i$. Below we will demonstrate +how the basic equations arising from the back propagation algorithm +can be modified in order to study classification problems with $K$ +classes. + +!split +===== Definitions ===== + +With our definition of the targets $\hat{t}$, the outputs of the +network $\hat{y}$ and the inputs $\hat{x}$ we +define now the activation $z_j^l$ of node/neuron/unit $j$ of the +$l$-th layer as a function of the bias, the weights which add up from +the previous layer $l-1$ and the forward passes/outputs +$\hat{a}^{l-1}$ from the previous layer as + + +!bt +\[ +z_j^l = \sum_{i=1}^{M_{l-1}}w_{ij}^la_i^{l-1}+b_j^l, +\] +!et + +where $b_k^l$ are the biases from layer $l$. Here $M_{l-1}$ +represents the total number of nodes/neurons/units of layer $l-1$. The +figure here illustrates this equation. We can rewrite this in a more +compact form as the matrix-vector products we discussed earlier, + +!bt +\[ +\hat{z}^l = \left(\hat{W}^l\right)^T\hat{a}^{l-1}+\hat{b}^l. +\] +!et + +With the activation values $\hat{z}^l$ we can in turn define the +output of layer $l$ as $\hat{a}^l = f(\hat{z}^l)$ where $f$ is our +activation function. In the examples here we will use the sigmoid +function discussed in our logistic regression lectures. We will also use the same activation function $f$ for all layers +and their nodes. It means we have + +!bt +\[ +a_j^l = f(z_j^l) = \frac{1}{1+\exp{-(z_j^l)}}. +\] +!et + + +!split +===== Derivatives and the chain rule ===== + +From the definition of the activation $z_j^l$ we have +!bt +\[ +\frac{\partial z_j^l}{\partial w_{ij}^l} = a_i^{l-1}, +\] +!et +and +!bt +\[ +\frac{\partial z_j^l}{\partial a_i^{l-1}} = w_{ji}^l. +\] +!et + +With our definition of the activation function we have that (note that this function depends only on $z_j^l$) +!bt +\[ +\frac{\partial a_j^l}{\partial z_j^{l}} = a_j^l(1-a_j^l)=f(z_j^l)(1-f(z_j^l)). +\] +!et + + +!split +===== Derivative of the cost function ===== + +With these definitions we can now compute the derivative of the cost function in terms of the weights. + +Let us specialize to the output layer $l=L$. Our cost function is +!bt +\[ +{\cal C}(\hat{W^L}) = \frac{1}{2}\sum_{i=1}^n\left(y_i - t_i\right)^2=\frac{1}{2}\sum_{i=1}^n\left(a_i^L - t_i\right)^2, +\] +!et +The derivative of this function with respect to the weights is + +!bt +\[ +\frac{\partial{\cal C}(\hat{W^L})}{\partial w_{jk}^L} = \left(a_j^L - t_j\right)\frac{\partial a_j^L}{\partial w_{jk}^{L}}, +\] +!et +The last partial derivative can easily be computed and reads (by applying the chain rule) +!bt +\[ +\frac{\partial a_j^L}{\partial w_{jk}^{L}} = \frac{\partial a_j^L}{\partial z_{j}^{L}}\frac{\partial z_j^L}{\partial w_{jk}^{L}}=a_j^L(1-a_j^L)a_k^{L-1}, +\] +!et + + + +!split +===== Bringing it together, first back propagation equation ===== + +We have thus +!bt +\[ +\frac{\partial{\cal C}(\hat{W^L})}{\partial w_{jk}^L} = \left(a_j^L - t_j\right)a_j^L(1-a_j^L)a_k^{L-1}, +\] +!et + +Defining +!bt +\[ +\delta_j^L = a_j^L(1-a_j^L)\left(a_j^L - t_j\right) = f'(z_j^L)\frac{\partial {\cal C}}{\partial (a_j^L)}, +\] +!et +and using the Hadamard product of two vectors we can write this as +!bt +\[ +\hat{\delta}^L = f'(\hat{z}^L)\circ\frac{\partial {\cal C}}{\partial (\hat{a}^L)}. +\] +!et + +This is an important expression. The second term on the right handside +measures how fast the cost function is changing as a function of the $j$th +output activation. If, for example, the cost function doesn't depend +much on a particular output node $j$, then $\delta_j^L$ will be small, +which is what we would expect. The first term on the right, measures +how fast the activation function $f$ is changing at a given activation +value $z_j^L$. + +Notice that everything in the above equations is easily computed. In +particular, we compute $z_j^L$ while computing the behaviour of the +network, and it is only a small additional overhead to compute +$f'(z^L_j)$. The exact form of the derivative with respect to the +output depends on the form of the cost function. +However, provided the cost function is known there should be little +trouble in calculating + +!bt +\[ +\frac{\partial {\cal C}}{\partial (a_j^L)} +\] +!et + +With the definition of $\delta_j^L$ we have a more compact definition of the derivative of the cost function in terms of the weights, namely +!bt +\[ +\frac{\partial{\cal C}(\hat{W^L})}{\partial w_{jk}^L} = \delta_j^La_k^{L-1}. +\] +!et + +!split +===== Derivatives in terms of $z_j^L$ ===== + +It is also easy to see that our previous equation can be written as + +!bt +\[ +\delta_j^L =\frac{\partial {\cal C}}{\partial z_j^L}= \frac{\partial {\cal C}}{\partial a_j^L}\frac{\partial a_j^L}{\partial z_j^L}, +\] +!et +which can also be interpreted as the partial derivative of the cost function with respect to the biases $b_j^L$, namely +!bt +\[ +\delta_j^L = \frac{\partial {\cal C}}{\partial b_j^L}\frac{\partial b_j^L}{\partial z_j^L}=\frac{\partial {\cal C}}{\partial b_j^L}, +\] +!et +That is, the error $\delta_j^L$ is exactly equal to the rate of change of the cost function as a function of the bias. +!split +===== Bringing it together ===== + +We have now three equations that are essential for the computations of the derivatives of the cost function at the output layer. These equations are needed to start the algorithm and they are + +!bblock The starting equations + +!bt +\begin{equation} +\frac{\partial{\cal C}(\hat{W^L})}{\partial w_{jk}^L} = \delta_j^La_k^{L-1}, +\end{equation} +!et +and +!bt +\begin{equation} +\delta_j^L = f'(z_j^L)\frac{\partial {\cal C}}{\partial (a_j^L)}, +\end{equation} +!et +and + +!bt +\begin{equation} +\delta_j^L = \frac{\partial {\cal C}}{\partial b_j^L}, +\end{equation} +!et +!eblock + + +An interesting consequence of the above equations is that when the +activation $a_k^{L-1}$ is small, the gradient term, that is the +derivative of the cost function with respect to the weights, will also +tend to be small. We say then that the weight learns slowly, meaning +that it changes slowly when we minimize the weights via say gradient +descent. In this case we say the system learns slowly. + +Another interesting feature is that is when the activation function, +represented by the sigmoid function here, is rather flat when we move towards +its end values $0$ and $1$ (see the above Python codes). In these +cases, the derivatives of the activation function will also be close +to zero, meaning again that the gradients will be small and the +network learns slowly again. + + + +We need a fourth equation and we are set. We are going to propagate +backwards in order to the determine the weights and biases. In order +to do so we need to represent the error in the layer before the final +one $L-1$ in terms of the errors in the final output layer. + +!split +===== Final back propagating equation ===== + +We have that (replacing $L$ with a general layer $l$) +!bt +\[ +\delta_j^l =\frac{\partial {\cal C}}{\partial z_j^l}. +\] +!et +We want to express this in terms of the equations for layer $l+1$. Using the chain rule and summing over all $k$ entries we have + +!bt +\[ +\delta_j^l =\sum_k \frac{\partial {\cal C}}{\partial z_k^{l+1}}\frac{\partial z_k^{l+1}}{\partial z_j^{l}}=\sum_k \delta_k^{l+1}\frac{\partial z_k^{l+1}}{\partial z_j^{l}}, +\] +!et +and recalling that +!bt +\[ +z_j^{l+1} = \sum_{i=1}^{M_{l}}w_{ij}^{l+1}a_i^{l}+b_j^{l+1}, +\] +!et +with $M_l$ being the number of nodes in layer $l$, we obtain +!bt +\[ +\delta_j^l =\sum_k \delta_k^{l+1}w_{kj}^{l+1}f'(z_j^l), +\] +!et +This is our final equation. + +We are now ready to set up the algorithm for back propagation and learning the weights and biases. + +!split +===== Setting up the Back propagation algorithm ===== + + + +The four equations provide us with a way of computing the gradient of the cost function. Let us write this out in the form of an algorithm. + +!bblock +First, we set up the input data $\hat{x}$ and the activations +$\hat{z}_1$ of the input layer and compute the activation function and +the pertinent outputs $\hat{a}^1$. +!eblock + +!bblock +Secondly, we perform then the feed forward till we reach the output +layer and compute all $\hat{z}_l$ of the input layer and compute the +activation function and the pertinent outputs $\hat{a}^l$ for +$l=2,3,\dots,L$. +!eblock + +!bblock +Thereafter we compute the ouput error $\hat{\delta}^L$ by computing all +!bt +\[ +\delta_j^L = f'(z_j^L)\frac{\partial {\cal C}}{\partial (a_j^L)}. +\] +!et +!eblock + +!bblock +Then we compute the back propagate error for each $l=L-1,L-2,\dots,2$ as +!bt +\[ +\delta_j^l = \sum_k \delta_k^{l+1}w_{kj}^{l+1}f'(z_j^l). +\] +!et +!eblock + +!bblock +Finally, we update the weights and the biases using gradient descent for each $l=L-1,L-2,\dots,2$ and update the weights and biases according to the rules +!bt +\[ +w_{jk}^l\leftarrow = w_{jk}^l- \eta \delta_j^la_k^{l-1}, +\] +!et + +!bt +\[ +b_j^l \leftarrow b_j^l-\eta \frac{\partial {\cal C}}{\partial b_j^l}=b_j^l-\eta \delta_j^l, +\] +!et +!eblock + +The parameter $\eta$ is the learning parameter discussed in connection with the gradient descent methods. +Here it is convenient to use stochastic gradient descent (see the examples below) with mini-batches with an outer loop that steps through multiple epochs of training. + + +!split +===== Setting up a Multi-layer perceptron model for classification ===== + +We are now gong to develop an example based on the MNIST data +base. This is a classification problem and we need to use our +cross-entropy function we discussed in connection with logistic +regression. The cross-entropy defines our cost function for the +classificaton problems with neural networks. + +In binary classification with two classes $(0, 1)$ we define the +logistic/sigmoid function as the probability that a particular input +is in class $0$ or $1$. This is possible because the logistic +function takes any input from the real numbers and inputs a number +between 0 and 1, and can therefore be interpreted as a probability. It +also has other nice properties, such as a derivative that is simple to +calculate. + +For an input $\boldsymbol{a}$ from the hidden layer, the probability that the input $\boldsymbol{x}$ +is in class 0 or 1 is just. We let $\theta$ represent the unknown weights and biases to be adjusted by our equations). The variable $x$ +represents our activation values $z$. We have +!bt +\[ +P(y = 0 \mid \hat{x}, \hat{\theta}) = \frac{1}{1 + \exp{(- \hat{x}})} , +\] +!et +and +!bt +\[ +P(y = 1 \mid \hat{x}, \hat{\theta}) = 1 - P(y = 0 \mid \hat{x}, \hat{\theta}) , +\] +!et + +where $y \in \{0, 1\}$ and $\hat{\theta}$ represents the weights and biases +of our network. + + +!split +===== Defining the cost function ===== + +Our cost function is given as (see the Logistic regression lectures) +!bt +\[ +\mathcal{C}(\hat{\theta}) = - \ln P(\mathcal{D} \mid \hat{\theta}) = - \sum_{i=1}^n +y_i \ln[P(y_i = 0)] + (1 - y_i) \ln [1 - P(y_i = 0)] = \sum_{i=1}^n \mathcal{L}_i(\hat{\theta}) . +\] +!et + +This last equality means that we can interpret our *cost* function as a sum over the *loss* function +for each point in the dataset $\mathcal{L}_i(\hat{\theta})$. +The negative sign is just so that we can think about our algorithm as minimizing a positive number, rather +than maximizing a negative number. + +In *multiclass* classification it is common to treat each integer label as a so called *one-hot* vector: + +$y = 5 \quad \rightarrow \quad \hat{y} = (0, 0, 0, 0, 0, 1, 0, 0, 0, 0) ,$ and + + +$y = 1 \quad \rightarrow \quad \hat{y} = (0, 1, 0, 0, 0, 0, 0, 0, 0, 0) ,$ + + +i.e. a binary bit string of length $C$, where $C = 10$ is the number of classes in the MNIST dataset (numbers from $0$ to $9$).. + +If $\hat{x}_i$ is the $i$-th input (image), $y_{ic}$ refers to the $c$-th component of the $i$-th +output vector $\hat{y}_i$. +The probability of $\hat{x}_i$ being in class $c$ will be given by the softmax function: + +!bt +\[ +P(y_{ic} = 1 \mid \hat{x}_i, \hat{\theta}) = \frac{\exp{((\hat{a}_i^{hidden})^T \hat{w}_c)}} +{\sum_{c'=0}^{C-1} \exp{((\hat{a}_i^{hidden})^T \hat{w}_{c'})}} , +\] +!et + +which reduces to the logistic function in the binary case. +The likelihood of this $C$-class classifier +is now given as: + +!bt +\[ +P(\mathcal{D} \mid \hat{\theta}) = \prod_{i=1}^n \prod_{c=0}^{C-1} [P(y_{ic} = 1)]^{y_{ic}} . +\] +!et +Again we take the negative log-likelihood to define our cost function: + +!bt +\[ +\mathcal{C}(\hat{\theta}) = - \log{P(\mathcal{D} \mid \hat{\theta})}. +\] +!et +See the logistic regression lectures for a full definition of the cost function. + +The back propagation equations need now only a small change, namely the definition of a new cost function. We are thus ready to use the same equations as before! + +!split +===== Example: binary classification problem ===== + +As an example of the above, relevant for project 2 as well, let us consider a binary class. As discussed in our logistic regression lectures, we defined a cost function in terms of the parameters $\beta$ as +!bt +\[ +\mathcal{C}(\hat{\beta}) = - \sum_{i=1}^n \left(y_i\log{p(y_i \vert x_i,\hat{\beta})}+(1-y_i)\log{1-p(y_i \vert x_i,\hat{\beta})}\right), +\] +!et +where we had defined the logistic (sigmoid) function +!bt +\[ +p(y_i =1\vert x_i,\hat{\beta})=\frac{\exp{(\beta_0+\beta_1 x_i)}}{1+\exp{(\beta_0+\beta_1 x_i)}}, +\] +!et +and +!bt +\[ +p(y_i =0\vert x_i,\hat{\beta})=1-p(y_i =1\vert x_i,\hat{\beta}). +\] +!et +The parameters $\hat{\beta}$ were defined using a minimization method like gradient descent or Newton-Raphson's method. + +Now we replace $x_i$ with the activation $z_i^l$ for a given layer $l$ and the outputs as $y_i=a_i^l=f(z_i^l)$, with $z_i^l$ now being a function of the weights $w_{ij}^l$ and biases $b_i^l$. +We have then +!bt +\[ +a_i^l = y_i = \frac{\exp{(z_i^l)}}{1+\exp{(z_i^l)}}, +\] +!et +with +!bt +\[ +z_i^l = \sum_{j}w_{ij}^l a_j^{l-1}+b_i^l, +\] +!et +where the superscript $l-1$ indicates that these are the outputs from layer $l-1$. +Our cost function at the final layer $l=L$ is now +!bt +\[ +\mathcal{C}(\hat{W}) = - \sum_{i=1}^n \left(t_i\log{a_i^L}+(1-t_i)\log{(1-a_i^L)}\right), +\] +!et +where we have defined the targets $t_i$. The derivatives of the cost function with respect to the output $a_i^L$ are then easily calculated and we get +!bt +\[ +\frac{\partial \mathcal{C}(\hat{W})}{\partial a_i^L} = \frac{a_i^L-t_i}{a_i^L(1-a_i^L)}. +\] +!et +In case we use another activation function than the logistic one, we need to evaluate other derivatives. + + +!split +===== The Softmax function ===== +In case we employ the more general case given by the Softmax equation, we need to evaluate the derivative of the activation function with respect to the activation $z_i^l$, that is we need +!bt +\[ +\frac{\partial f(z_i^l)}{\partial w_{jk}^l} = +\frac{\partial f(z_i^l)}{\partial z_j^l} \frac{\partial z_j^l}{\partial w_{jk}^l}= \frac{\partial f(z_i^l)}{\partial z_j^l}a_k^{l-1}. +\] +!et +For the Softmax function we have +!bt +\[ +f(z_i^l) = \frac{\exp{(z_i^l)}}{\sum_{m=1}^K\exp{(z_m^l)}}. +\] +!et +Its derivative with respect to $z_j^l$ gives +!bt +\[ +\frac{\partial f(z_i^l)}{\partial z_j^l}= f(z_i^l)\left(\delta_{ij}-f(z_j^l)\right), +\] +!et +which in case of the simply binary model reduces to having $i=j$. + +!split +===== Developing a code for doing neural networks with back propagation ===== + + +One can identify a set of key steps when using neural networks to solve supervised learning problems: + +o Collect and pre-process data +o Define model and architecture +o Choose cost function and optimizer +o Train the model +o Evaluate model performance on test data +o Adjust hyperparameters (if necessary, network architecture) + +!split +===== Collect and pre-process data ===== + +Here we will be using the MNIST dataset, which is readily available through the _scikit-learn_ +package. You may also find it for example "here":"http://yann.lecun.com/exdb/mnist/". +The *MNIST* (Modified National Institute of Standards and Technology) database is a large database +of handwritten digits that is commonly used for training various image processing systems. +The MNIST dataset consists of 70 000 images of size $28\times 28$ pixels, each labeled from 0 to 9. +The scikit-learn dataset we will use consists of a selection of 1797 images of size $8\times 8$ collected and processed from this database. + +To feed data into a feed-forward neural network we need to represent +the inputs as a design/feature matrix $X = (n_{inputs}, n_{features})$. Each +row represents an *input*, in this case a handwritten digit, and +each column represents a *feature*, in this case a pixel. The +correct answers, also known as *labels* or *targets* are +represented as a 1D array of integers +$Y = (n_{inputs}) = (5, 3, 1, 8,...)$. + +As an example, say we want to build a neural network using supervised learning to predict Body-Mass Index (BMI) from +measurements of height (in m) +and weight (in kg). If we have measurements of 5 people the design/feature matrix could be for example: + +$$ X = \begin{bmatrix} +1.85 & 81\\ +1.71 & 65\\ +1.95 & 103\\ +1.55 & 42\\ +1.63 & 56 +\end{bmatrix} ,$$ + +and the targets would be: + +$$ Y = (23.7, 22.2, 27.1, 17.5, 21.1) $$ + +Since each input image is a 2D matrix, we need to flatten the image +(i.e. "unravel" the 2D matrix into a 1D array) to turn the data into a +design/feature matrix. This means we lose all spatial information in the +image, such as locality and translational invariance. More complicated +architectures such as Convolutional Neural Networks can take advantage +of such information, and are most commonly applied when analyzing +images. + + +!bc pycod +# import necessary packages +import numpy as np +import matplotlib.pyplot as plt +from sklearn import datasets + + +# ensure the same random numbers appear every time +np.random.seed(0) + +# display images in notebook +%matplotlib inline +plt.rcParams['figure.figsize'] = (12,12) + + +# download MNIST dataset +digits = datasets.load_digits() + +# define inputs and labels +inputs = digits.images +labels = digits.target + +print("inputs = (n_inputs, pixel_width, pixel_height) = " + str(inputs.shape)) +print("labels = (n_inputs) = " + str(labels.shape)) + + +# flatten the image +# the value -1 means dimension is inferred from the remaining dimensions: 8x8 = 64 +n_inputs = len(inputs) +inputs = inputs.reshape(n_inputs, -1) +print("X = (n_inputs, n_features) = " + str(inputs.shape)) + + +# choose some random images to display +indices = np.arange(n_inputs) +random_indices = np.random.choice(indices, size=5) + +for i, image in enumerate(digits.images[random_indices]): + plt.subplot(1, 5, i+1) + plt.axis('off') + plt.imshow(image, cmap=plt.cm.gray_r, interpolation='nearest') + plt.title("Label: %d" % digits.target[random_indices[i]]) +plt.show() +!ec + +!split +===== Train and test datasets ===== + +Performing analysis before partitioning the dataset is a major error, that can lead to incorrect conclusions. + +We will reserve $80 \%$ of our dataset for training and $20 \%$ for testing. + +It is important that the train and test datasets are drawn randomly from our dataset, to ensure +no bias in the sampling. +Say you are taking measurements of weather data to predict the weather in the coming 5 days. +You don't want to train your model on measurements taken from the hours 00.00 to 12.00, and then test it on data +collected from 12.00 to 24.00. + + +!bc pycod +from sklearn.model_selection import train_test_split + +# one-liner from scikit-learn library +train_size = 0.8 +test_size = 1 - train_size +X_train, X_test, Y_train, Y_test = train_test_split(inputs, labels, train_size=train_size, + test_size=test_size) + +# equivalently in numpy +def train_test_split_numpy(inputs, labels, train_size, test_size): + n_inputs = len(inputs) + inputs_shuffled = inputs.copy() + labels_shuffled = labels.copy() + + np.random.shuffle(inputs_shuffled) + np.random.shuffle(labels_shuffled) + + train_end = int(n_inputs*train_size) + X_train, X_test = inputs_shuffled[:train_end], inputs_shuffled[train_end:] + Y_train, Y_test = labels_shuffled[:train_end], labels_shuffled[train_end:] + + return X_train, X_test, Y_train, Y_test + +#X_train, X_test, Y_train, Y_test = train_test_split_numpy(inputs, labels, train_size, test_size) + +print("Number of training images: " + str(len(X_train))) +print("Number of test images: " + str(len(X_test))) +!ec + +!split +===== Define model and architecture ===== + +Our simple feed-forward neural network will consist of an *input* layer, a single *hidden* layer and an *output* layer. The activation $y$ of each neuron is a weighted sum of inputs, passed through an activation function. In case of the simple perceptron model we have + +$$ z = \sum_{i=1}^n w_i a_i ,$$ + +$$ y = f(z) ,$$ + +where $f$ is the activation function, $a_i$ represents input from neuron $i$ in the preceding layer +and $w_i$ is the weight to input $i$. +The activation of the neurons in the input layer is just the features (e.g. a pixel value). + +The simplest activation function for a neuron is the *Heaviside* function: + +$$ f(z) = +\begin{cases} +1, & z > 0\\ +0, & \text{otherwise} +\end{cases} +$$ + +A feed-forward neural network with this activation is known as a *perceptron*. +For a binary classifier (i.e. two classes, 0 or 1, dog or not-dog) we can also use this in our output layer. +This activation can be generalized to $k$ classes (using e.g. the *one-against-all* strategy), +and we call these architectures *multiclass perceptrons*. + +However, it is now common to use the terms Single Layer Perceptron (SLP) (1 hidden layer) and +Multilayer Perceptron (MLP) (2 or more hidden layers) to refer to feed-forward neural networks with any activation function. + +Typical choices for activation functions include the sigmoid function, hyperbolic tangent, and Rectified Linear Unit (ReLU). +We will be using the sigmoid function $\sigma(x)$: + +$$ f(x) = \sigma(x) = \frac{1}{1 + e^{-x}} ,$$ + +which is inspired by probability theory (see logistic regression) and was most commonly used until about 2011. See the discussion below concerning other activation functions. + +!split +===== Layers ===== + +* Input +Since each input image has 8x8 = 64 pixels or features, we have an input layer of 64 neurons. + +* Hidden layer +We will use 50 neurons in the hidden layer receiving input from the neurons in the input layer. +Since each neuron in the hidden layer is connected to the 64 inputs we have 64x50 = 3200 weights to the hidden layer. + +* Output +If we were building a binary classifier, it would be sufficient with a single neuron in the output layer, +which could output 0 or 1 according to the Heaviside function. This would be an example of a *hard* classifier, meaning it outputs the class of the input directly. However, if we are dealing with noisy data it is often beneficial to use a *soft* classifier, which outputs the probability of being in class 0 or 1. + +For a soft binary classifier, we could use a single neuron and interpret the output as either being the probability of being in class 0 or the probability of being in class 1. Alternatively we could use 2 neurons, and interpret each neuron as the probability of being in each class. + +Since we are doing multiclass classification, with 10 categories, it is natural to use 10 neurons in the output layer. We number the neurons $j = 0,1,...,9$. The activation of each output neuron $j$ will be according to the *softmax* function: + +$$ P(\text{class $j$} \mid \text{input $\hat{a}$}) = \frac{\exp{(\hat{a}^T \hat{w}_j)}} +{\sum_{c=0}^{9} \exp{(\hat{a}^T \hat{w}_c)}} ,$$ + +i.e. each neuron $j$ outputs the probability of being in class $j$ given an input from the hidden layer $\hat{a}$, with $\hat{w}_j$ the weights of neuron $j$ to the inputs. +The denominator is a normalization factor to ensure the outputs (probabilities) sum up to 1. +The exponent is just the weighted sum of inputs as before: + +$$ z_j = \sum_{i=1}^n w_ {ij} a_i+b_j.$$ + +Since each neuron in the output layer is connected to the 50 inputs from the hidden layer we have 50x10 = 500 +weights to the output layer. + +!split +===== Weights and biases ===== + +Typically weights are initialized with small values distributed around zero, drawn from a uniform +or normal distribution. Setting all weights to zero means all neurons give the same output, making the network useless. + +Adding a bias value to the weighted sum of inputs allows the neural network to represent a greater range +of values. Without it, any input with the value 0 will be mapped to zero (before being passed through the activation). The bias unit has an output of 1, and a weight to each neuron $j$, $b_j$: + +$$ z_j = \sum_{i=1}^n w_ {ij} a_i + b_j.$$ + +The bias weights $\hat{b}$ are often initialized to zero, but a small value like $0.01$ ensures all neurons have some output which can be backpropagated in the first training cycle. +!bc pycod +# building our neural network + +n_inputs, n_features = X_train.shape +n_hidden_neurons = 50 +n_categories = 10 + +# we make the weights normally distributed using numpy.random.randn + +# weights and bias in the hidden layer +hidden_weights = np.random.randn(n_features, n_hidden_neurons) +hidden_bias = np.zeros(n_hidden_neurons) + 0.01 + +# weights and bias in the output layer +output_weights = np.random.randn(n_hidden_neurons, n_categories) +output_bias = np.zeros(n_categories) + 0.01 +!ec + +!split +===== Feed-forward pass ===== + +Denote $F$ the number of features, $H$ the number of hidden neurons and $C$ the number of categories. +For each input image we calculate a weighted sum of input features (pixel values) to each neuron $j$ in the hidden layer $l$: + +$$ z_{j}^{l} = \sum_{i=1}^{F} w_{ij}^{l} x_i + b_{j}^{l},$$ + +this is then passed through our activation function + +$$ a_{j}^{l} = f(z_{j}^{l}) .$$ + +We calculate a weighted sum of inputs (activations in the hidden layer) to each neuron $j$ in the output layer: + +$$ z_{j}^{L} = \sum_{i=1}^{H} w_{ij}^{L} a_{i}^{l} + b_{j}^{L}.$$ + +Finally we calculate the output of neuron $j$ in the output layer using the softmax function: + +$$ a_{j}^{L} = \frac{\exp{(z_j^{L})}} +{\sum_{c=0}^{C-1} \exp{(z_c^{L})}} .$$ + +!split +===== Matrix multiplications ===== + +Since our data has the dimensions $X = (n_{inputs}, n_{features})$ and our weights to the hidden +layer have the dimensions +$W_{hidden} = (n_{features}, n_{hidden})$, +we can easily feed the network all our training data in one go by taking the matrix product + +$$ X W^{h} = (n_{inputs}, n_{hidden}),$$ + +and obtain a matrix that holds the weighted sum of inputs to the hidden layer +for each input image and each hidden neuron. +We also add the bias to obtain a matrix of weighted sums to the hidden layer $Z^{h}$: + +$$ \hat{z}^{l} = \hat{X} \hat{W}^{l} + \hat{b}^{l} ,$$ + +meaning the same bias (1D array with size equal number of hidden neurons) is added to each input image. +This is then passed through the activation: + +$$ \hat{a}^{l} = f(\hat{z}^l) .$$ + +This is fed to the output layer: + +$$ \hat{z}^{L} = \hat{a}^{L} \hat{W}^{L} + \hat{b}^{L} .$$ + +Finally we receive our output values for each image and each category by passing it through the softmax function: + +$$ output = softmax (\hat{z}^{L}) = (n_{inputs}, n_{categories}) .$$ + + +!bc pycod +# setup the feed-forward pass, subscript h = hidden layer + +def sigmoid(x): + return 1/(1 + np.exp(-x)) + +def feed_forward(X): + # weighted sum of inputs to the hidden layer + z_h = np.matmul(X, hidden_weights) + hidden_bias + # activation in the hidden layer + a_h = sigmoid(z_h) + + # weighted sum of inputs to the output layer + z_o = np.matmul(a_h, output_weights) + output_bias + # softmax output + # axis 0 holds each input and axis 1 the probabilities of each category + exp_term = np.exp(z_o) + probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True) + + return probabilities + +probabilities = feed_forward(X_train) +print("probabilities = (n_inputs, n_categories) = " + str(probabilities.shape)) +print("probability that image 0 is in category 0,1,2,...,9 = \n" + str(probabilities[0])) +print("probabilities sum up to: " + str(probabilities[0].sum())) +print() + +# we obtain a prediction by taking the class with the highest likelihood +def predict(X): + probabilities = feed_forward(X) + return np.argmax(probabilities, axis=1) + +predictions = predict(X_train) +print("predictions = (n_inputs) = " + str(predictions.shape)) +print("prediction for image 0: " + str(predictions[0])) +print("correct label for image 0: " + str(Y_train[0])) +!ec + +!split +===== Choose cost function and optimizer ===== + +To measure how well our neural network is doing we need to introduce a cost function. +We will call the function that gives the error of a single sample output the *loss* function, and the function +that gives the total error of our network across all samples the *cost* function. +A typical choice for multiclass classification is the *cross-entropy* loss, also known as the negative log likelihood. + +In *multiclass* classification it is common to treat each integer label as a so called *one-hot* vector: + +$$ y = 5 \quad \rightarrow \quad \hat{y} = (0, 0, 0, 0, 0, 1, 0, 0, 0, 0) ,$$ + + +$$ y = 1 \quad \rightarrow \quad \hat{y} = (0, 1, 0, 0, 0, 0, 0, 0, 0, 0) ,$$ + + +i.e. a binary bit string of length $C$, where $C = 10$ is the number of classes in the MNIST dataset. + +Let $y_{ic}$ denote the $c$-th component of the $i$-th one-hot vector. +We define the cost function $\mathcal{C}$ as a sum over the cross-entropy loss for each point $\hat{x}_i$ in the dataset. + +In the one-hot representation only one of the terms in the loss function is non-zero, namely the +probability of the correct category $c'$ +(i.e. the category $c'$ such that $y_{ic'} = 1$). This means that the cross entropy loss only punishes you for how wrong +you got the correct label. The probability of category $c$ is given by the softmax function. The vector $\hat{\theta}$ represents the parameters of our network, i.e. all the weights and biases. + + +!split +===== Optimizing the cost function ===== + +The network is trained by finding the weights and biases that minimize the cost function. One of the most widely used classes of methods is *gradient descent* and its generalizations. The idea behind gradient descent +is simply to adjust the weights in the direction where the gradient of the cost function is large and negative. This ensures we flow toward a *local* minimum of the cost function. +Each parameter $\theta$ is iteratively adjusted according to the rule + +$$ \theta_{i+1} = \theta_i - \eta \nabla \mathcal{C}(\theta_i) ,$$ + +where $\eta$ is known as the *learning rate*, which controls how big a step we take towards the minimum. +This update can be repeated for any number of iterations, or until we are satisfied with the result. + +A simple and effective improvement is a variant called *Batch Gradient Descent*. +Instead of calculating the gradient on the whole dataset, we calculate an approximation of the gradient +on a subset of the data called a *minibatch*. +If there are $N$ data points and we have a minibatch size of $M$, the total number of batches +is $N/M$. +We denote each minibatch $B_k$, with $k = 1, 2,...,N/M$. The gradient then becomes: + +$$ \nabla \mathcal{C}(\theta) = \frac{1}{N} \sum_{i=1}^N \nabla \mathcal{L}_i(\theta) \quad \rightarrow \quad +\frac{1}{M} \sum_{i \in B_k} \nabla \mathcal{L}_i(\theta) ,$$ + +i.e. instead of averaging the loss over the entire dataset, we average over a minibatch. + +This has two important benefits: +o Introducing stochasticity decreases the chance that the algorithm becomes stuck in a local minima. +o It significantly speeds up the calculation, since we do not have to use the entire dataset to calculate the gradient. + +The various optmization methods, with codes and algorithms, are discussed in our lectures on "Gradient descent approaches":"https://compphysics.github.io/MachineLearning/doc/pub/Splines/html/Splines-bs.html". + +!split +===== Regularization ===== + +It is common to add an extra term to the cost function, proportional +to the size of the weights. This is equivalent to constraining the +size of the weights, so that they do not grow out of control. +Constraining the size of the weights means that the weights cannot +grow arbitrarily large to fit the training data, and in this way +reduces *overfitting*. + +We will measure the size of the weights using the so called *L2-norm*, meaning our cost function becomes: + +$$ \mathcal{C}(\theta) = \frac{1}{N} \sum_{i=1}^N \mathcal{L}_i(\theta) \quad \rightarrow \quad +\frac{1}{N} \sum_{i=1}^N \mathcal{L}_i(\theta) + \lambda \lvert \lvert \hat{w} \rvert \rvert_2^2 += \frac{1}{N} \sum_{i=1}^N \mathcal{L}(\theta) + \lambda \sum_{ij} w_{ij}^2,$$ + +i.e. we sum up all the weights squared. The factor $\lambda$ is known as a regularization parameter. + + +In order to train the model, we need to calculate the derivative of +the cost function with respect to every bias and weight in the +network. In total our network has $(64 + 1)\times 50=3250$ weights in +the hidden layer and $(50 + 1)\times 10=510$ weights to the output +layer ($+1$ for the bias), and the gradient must be calculated for +every parameter. We use the *backpropagation* algorithm discussed +above. This is a clever use of the chain rule that allows us to +calculate the gradient efficently. + + +!split +===== Matrix multiplication ===== + +To more efficently train our network these equations are implemented using matrix operations. +The error in the output layer is calculated simply as, with $\hat{t}$ being our targets, + +$$ \delta_L = \hat{t} - \hat{y} = (n_{inputs}, n_{categories}) .$$ + +The gradient for the output weights is calculated as + +$$ \nabla W_{L} = \hat{a}^T \delta_L = (n_{hidden}, n_{categories}) ,$$ + +where $\hat{a} = (n_{inputs}, n_{hidden})$. This simply means that we are summing up the gradients for each input. +Since we are going backwards we have to transpose the activation matrix. + +The gradient with respect to the output bias is then + +$$ \nabla \hat{b}_{L} = \sum_{i=1}^{n_{inputs}} \delta_L = (n_{categories}) .$$ + +The error in the hidden layer is + +$$ \Delta_h = \delta_L W_{L}^T \circ f'(z_{h}) = \delta_L W_{L}^T \circ a_{h} \circ (1 - a_{h}) = (n_{inputs}, n_{hidden}) ,$$ + +where $f'(a_{h})$ is the derivative of the activation in the hidden layer. The matrix products mean +that we are summing up the products for each neuron in the output layer. The symbol $\circ$ denotes +the *Hadamard product*, meaning element-wise multiplication. + +This again gives us the gradients in the hidden layer: + +$$ \nabla W_{h} = X^T \delta_h = (n_{features}, n_{hidden}) ,$$ + +$$ \nabla b_{h} = \sum_{i=1}^{n_{inputs}} \delta_h = (n_{hidden}) .$$ + + +!bc pycod +# to categorical turns our integer vector into a onehot representation +from sklearn.metrics import accuracy_score + +# one-hot in numpy +def to_categorical_numpy(integer_vector): + n_inputs = len(integer_vector) + n_categories = np.max(integer_vector) + 1 + onehot_vector = np.zeros((n_inputs, n_categories)) + onehot_vector[range(n_inputs), integer_vector] = 1 + + return onehot_vector + +#Y_train_onehot, Y_test_onehot = to_categorical(Y_train), to_categorical(Y_test) +Y_train_onehot, Y_test_onehot = to_categorical_numpy(Y_train), to_categorical_numpy(Y_test) + +def feed_forward_train(X): + # weighted sum of inputs to the hidden layer + z_h = np.matmul(X, hidden_weights) + hidden_bias + # activation in the hidden layer + a_h = sigmoid(z_h) + + # weighted sum of inputs to the output layer + z_o = np.matmul(a_h, output_weights) + output_bias + # softmax output + # axis 0 holds each input and axis 1 the probabilities of each category + exp_term = np.exp(z_o) + probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True) + + # for backpropagation need activations in hidden and output layers + return a_h, probabilities + +def backpropagation(X, Y): + a_h, probabilities = feed_forward_train(X) + + # error in the output layer + error_output = probabilities - Y + # error in the hidden layer + error_hidden = np.matmul(error_output, output_weights.T) * a_h * (1 - a_h) + + # gradients for the output layer + output_weights_gradient = np.matmul(a_h.T, error_output) + output_bias_gradient = np.sum(error_output, axis=0) + + # gradient for the hidden layer + hidden_weights_gradient = np.matmul(X.T, error_hidden) + hidden_bias_gradient = np.sum(error_hidden, axis=0) + + return output_weights_gradient, output_bias_gradient, hidden_weights_gradient, hidden_bias_gradient + +print("Old accuracy on training data: " + str(accuracy_score(predict(X_train), Y_train))) + +eta = 0.01 +lmbd = 0.01 +for i in range(1000): + # calculate gradients + dWo, dBo, dWh, dBh = backpropagation(X_train, Y_train_onehot) + + # regularization term gradients + dWo += lmbd * output_weights + dWh += lmbd * hidden_weights + + # update weights and biases + output_weights -= eta * dWo + output_bias -= eta * dBo + hidden_weights -= eta * dWh + hidden_bias -= eta * dBh + +print("New accuracy on training data: " + str(accuracy_score(predict(X_train), Y_train))) +!ec + +!split +===== Improving performance ===== + +As we can see the network does not seem to be learning at all. It seems to be just guessing the label for each image. +In order to obtain a network that does something useful, we will have to do a bit more work. + +The choice of *hyperparameters* such as learning rate and regularization parameter is hugely influential for the performance of the network. Typically a *grid-search* is performed, wherein we test different hyperparameters separated by orders of magnitude. For example we could test the learning rates $\eta = 10^{-6}, 10^{-5},...,10^{-1}$ with different regularization parameters $\lambda = 10^{-6},...,10^{-0}$. + +Next, we haven't implemented minibatching yet, which introduces stochasticity and is though to act as an important regularizer on the weights. We call a feed-forward + backward pass with a minibatch an *iteration*, and a full training period +going through the entire dataset ($n/M$ batches) an *epoch*. + +If this does not improve network performance, you may want to consider altering the network architecture, adding more neurons or hidden layers. +Andrew Ng goes through some of these considerations in this "video":"https://youtu.be/F1ka6a13S9I". You can find a summary of the video "here":"https://kevinzakka.github.io/2016/09/26/applying-deep-learning/". + +!split +===== Full object-oriented implementation ===== + +It is very natural to think of the network as an object, with specific instances of the network +being realizations of this object with different hyperparameters. An implementation using Python classes provides a clean structure and interface, and the full implementation of our neural network is given below. + + +!bc pycod +class NeuralNetwork: + def __init__( + self, + X_data, + Y_data, + n_hidden_neurons=50, + n_categories=10, + epochs=10, + batch_size=100, + eta=0.1, + lmbd=0.0): + + self.X_data_full = X_data + self.Y_data_full = Y_data + + self.n_inputs = X_data.shape[0] + self.n_features = X_data.shape[1] + self.n_hidden_neurons = n_hidden_neurons + self.n_categories = n_categories + + self.epochs = epochs + self.batch_size = batch_size + self.iterations = self.n_inputs // self.batch_size + self.eta = eta + self.lmbd = lmbd + + self.create_biases_and_weights() + + def create_biases_and_weights(self): + self.hidden_weights = np.random.randn(self.n_features, self.n_hidden_neurons) + self.hidden_bias = np.zeros(self.n_hidden_neurons) + 0.01 + + self.output_weights = np.random.randn(self.n_hidden_neurons, self.n_categories) + self.output_bias = np.zeros(self.n_categories) + 0.01 + + def feed_forward(self): + # feed-forward for training + self.z_h = np.matmul(self.X_data, self.hidden_weights) + self.hidden_bias + self.a_h = sigmoid(self.z_h) + + self.z_o = np.matmul(self.a_h, self.output_weights) + self.output_bias + + exp_term = np.exp(self.z_o) + self.probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True) + + def feed_forward_out(self, X): + # feed-forward for output + z_h = np.matmul(X, self.hidden_weights) + self.hidden_bias + a_h = sigmoid(z_h) + + z_o = np.matmul(a_h, self.output_weights) + self.output_bias + + exp_term = np.exp(z_o) + probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True) + return probabilities + + def backpropagation(self): + error_output = self.probabilities - self.Y_data + error_hidden = np.matmul(error_output, self.output_weights.T) * self.a_h * (1 - self.a_h) + + self.output_weights_gradient = np.matmul(self.a_h.T, error_output) + self.output_bias_gradient = np.sum(error_output, axis=0) + + self.hidden_weights_gradient = np.matmul(self.X_data.T, error_hidden) + self.hidden_bias_gradient = np.sum(error_hidden, axis=0) + + if self.lmbd > 0.0: + self.output_weights_gradient += self.lmbd * self.output_weights + self.hidden_weights_gradient += self.lmbd * self.hidden_weights + + self.output_weights -= self.eta * self.output_weights_gradient + self.output_bias -= self.eta * self.output_bias_gradient + self.hidden_weights -= self.eta * self.hidden_weights_gradient + self.hidden_bias -= self.eta * self.hidden_bias_gradient + + def predict(self, X): + probabilities = self.feed_forward_out(X) + return np.argmax(probabilities, axis=1) + + def predict_probabilities(self, X): + probabilities = self.feed_forward_out(X) + return probabilities + + def train(self): + data_indices = np.arange(self.n_inputs) + + for i in range(self.epochs): + for j in range(self.iterations): + # pick datapoints with replacement + chosen_datapoints = np.random.choice( + data_indices, size=self.batch_size, replace=False + ) + + # minibatch training data + self.X_data = self.X_data_full[chosen_datapoints] + self.Y_data = self.Y_data_full[chosen_datapoints] + + self.feed_forward() + self.backpropagation() +!ec + +!split +===== Evaluate model performance on test data ===== + +To measure the performance of our network we evaluate how well it does it data it has never seen before, i.e. the test data. +We measure the performance of the network using the *accuracy* score. +The accuracy is as you would expect just the number of images correctly labeled divided by the total number of images. A perfect classifier will have an accuracy score of $1$. + +$$ \text{Accuracy} = \frac{\sum_{i=1}^n I(\hat{y}_i = y_i)}{n} ,$$ + +where $I$ is the indicator function, $1$ if $\hat{y}_i = y_i$ and $0$ otherwise. + + +!bc pycod +epochs = 100 +batch_size = 100 + +dnn = NeuralNetwork(X_train, Y_train_onehot, eta=eta, lmbd=lmbd, epochs=epochs, batch_size=batch_size, + n_hidden_neurons=n_hidden_neurons, n_categories=n_categories) +dnn.train() +test_predict = dnn.predict(X_test) + +# accuracy score from scikit library +print("Accuracy score on test set: ", accuracy_score(Y_test, test_predict)) + +# equivalent in numpy +def accuracy_score_numpy(Y_test, Y_pred): + return np.sum(Y_test == Y_pred) / len(Y_test) + +#print("Accuracy score on test set: ", accuracy_score_numpy(Y_test, test_predict)) +!ec + +!split +===== Adjust hyperparameters ===== + +We now perform a grid search to find the optimal hyperparameters for the network. +Note that we are only using 1 layer with 50 neurons, and human performance is estimated to be around $98\%$ ($2\%$ error rate). + +!bc pycod +eta_vals = np.logspace(-5, 1, 7) +lmbd_vals = np.logspace(-5, 1, 7) +# store the models for later use +DNN_numpy = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object) + +# grid search +for i, eta in enumerate(eta_vals): + for j, lmbd in enumerate(lmbd_vals): + dnn = NeuralNetwork(X_train, Y_train_onehot, eta=eta, lmbd=lmbd, epochs=epochs, batch_size=batch_size, + n_hidden_neurons=n_hidden_neurons, n_categories=n_categories) + dnn.train() + + DNN_numpy[i][j] = dnn + + test_predict = dnn.predict(X_test) + + print("Learning rate = ", eta) + print("Lambda = ", lmbd) + print("Accuracy score on test set: ", accuracy_score(Y_test, test_predict)) + print() +!ec + +!split +===== Visualization ===== + +!bc pycod +# visual representation of grid search +# uses seaborn heatmap, you can also do this with matplotlib imshow +import seaborn as sns + +sns.set() + +train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) +test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) + +for i in range(len(eta_vals)): + for j in range(len(lmbd_vals)): + dnn = DNN_numpy[i][j] + + train_pred = dnn.predict(X_train) + test_pred = dnn.predict(X_test) + + train_accuracy[i][j] = accuracy_score(Y_train, train_pred) + test_accuracy[i][j] = accuracy_score(Y_test, test_pred) + + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Training Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Test Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() +!ec + +!split +===== scikit-learn implementation ===== + +_scikit-learn_ focuses more +on traditional machine learning methods, such as regression, +clustering, decision trees, etc. As such, it has only two types of +neural networks: Multi Layer Perceptron outputting continuous values, +*MPLRegressor*, and Multi Layer Perceptron outputting labels, +*MLPClassifier*. We will see how simple it is to use these classes. + +_scikit-learn_ implements a few improvements from our neural network, +such as early stopping, a varying learning rate, different +optimization methods, etc. We would therefore expect a better +performance overall. + +!bc pycod +from sklearn.neural_network import MLPClassifier +# store models for later use +DNN_scikit = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object) + +for i, eta in enumerate(eta_vals): + for j, lmbd in enumerate(lmbd_vals): + dnn = MLPClassifier(hidden_layer_sizes=(n_hidden_neurons), activation='logistic', + alpha=lmbd, learning_rate_init=eta, max_iter=epochs) + dnn.fit(X_train, Y_train) + + DNN_scikit[i][j] = dnn + + print("Learning rate = ", eta) + print("Lambda = ", lmbd) + print("Accuracy score on test set: ", dnn.score(X_test, Y_test)) + print() +!ec + + +!split +===== Visualization ===== +!bc pycod +# optional +# visual representation of grid search +# uses seaborn heatmap, could probably do this in matplotlib +import seaborn as sns + +sns.set() + +train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) +test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) + +for i in range(len(eta_vals)): + for j in range(len(lmbd_vals)): + dnn = DNN_scikit[i][j] + + train_pred = dnn.predict(X_train) + test_pred = dnn.predict(X_test) + + train_accuracy[i][j] = accuracy_score(Y_train, train_pred) + test_accuracy[i][j] = accuracy_score(Y_test, test_pred) + + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Training Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Test Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() +!ec + + +!split +===== Building neural networks in Tensorflow and Keras ===== + +Now we want to build on the experience gained from our neural network implementation in NumPy and scikit-learn +and use it to construct a neural network in Tensorflow. Once we have constructed a neural network in NumPy +and Tensorflow, building one in Keras is really quite trivial, though the performance may suffer. + +In our previous example we used only one hidden layer, and in this we will use two. From this it should be quite +clear how to build one using an arbitrary number of hidden layers, using data structures such as Python lists or +NumPy arrays. + +!split +===== Tensorflow ===== + +Tensorflow is an open source library machine learning library +developed by the Google Brain team for internal use. It was released +under the Apache 2.0 open source license in November 9, 2015. + +Tensorflow is a computational framework that allows you to construct +machine learning models at different levels of abstraction, from +high-level, object-oriented APIs like Keras, down to the C++ kernels +that Tensorflow is built upon. The higher levels of abstraction are +simpler to use, but less flexible, and our choice of implementation +should reflect the problems we are trying to solve. + +"Tensorflow uses":"https://www.tensorflow.org/guide/graphs" so-called graphs to represent your computation +in terms of the dependencies between individual operations, such that you first build a Tensorflow *graph* +to represent your model, and then create a Tensorflow *session* to run the graph. + +In this guide we will analyze the same data as we did in our NumPy and +scikit-learn tutorial, gathered from the MNIST database of images. We +will give an introduction to the lower level Python Application +Program Interfaces (APIs), and see how we use them to build our graph. +Then we will build (effectively) the same graph in Keras, to see just +how simple solving a machine learning problem can be. + +To install tensorflow on Unix/Linux systems, use pip as +!bc pycod +pip3 install tensorflow +!ec +and/or if you use _anaconda_, just write (or install from the graphical user interface) +!bc pycod +conda install tensorflow +!ec + +!split +===== Collect and pre-process data ===== + +!bc pycod +# import necessary packages +import numpy as np +import matplotlib.pyplot as plt +from sklearn import datasets + + +# ensure the same random numbers appear every time +np.random.seed(0) + +# display images in notebook +%matplotlib inline +plt.rcParams['figure.figsize'] = (12,12) + + +# download MNIST dataset +digits = datasets.load_digits() + +# define inputs and labels +inputs = digits.images +labels = digits.target + +print("inputs = (n_inputs, pixel_width, pixel_height) = " + str(inputs.shape)) +print("labels = (n_inputs) = " + str(labels.shape)) + + +# flatten the image +# the value -1 means dimension is inferred from the remaining dimensions: 8x8 = 64 +n_inputs = len(inputs) +inputs = inputs.reshape(n_inputs, -1) +print("X = (n_inputs, n_features) = " + str(inputs.shape)) + + +# choose some random images to display +indices = np.arange(n_inputs) +random_indices = np.random.choice(indices, size=5) + +for i, image in enumerate(digits.images[random_indices]): + plt.subplot(1, 5, i+1) + plt.axis('off') + plt.imshow(image, cmap=plt.cm.gray_r, interpolation='nearest') + plt.title("Label: %d" % digits.target[random_indices[i]]) +plt.show() +!ec + +!bc pycod +from keras.utils import to_categorical +from sklearn.model_selection import train_test_split + +# one-hot representation of labels +labels = to_categorical(labels) + +# split into train and test data +train_size = 0.8 +test_size = 1 - train_size +X_train, X_test, Y_train, Y_test = train_test_split(inputs, labels, train_size=train_size, + test_size=test_size) +!ec + +!split +===== Using TensorFlow backend ===== + +o Define model and architecture +o Choose cost function and optimizer + +!bc pycod +import tensorflow as tf + +class NeuralNetworkTensorflow: + def __init__( + self, + X_train, + Y_train, + X_test, + Y_test, + n_neurons_layer1=100, + n_neurons_layer2=50, + n_categories=2, + epochs=10, + batch_size=100, + eta=0.1, + lmbd=0.0): + + # keep track of number of steps + self.global_step = tf.Variable(0, dtype=tf.int32, trainable=False, name='global_step') + + self.X_train = X_train + self.Y_train = Y_train + self.X_test = X_test + self.Y_test = Y_test + + self.n_inputs = X_train.shape[0] + self.n_features = X_train.shape[1] + self.n_neurons_layer1 = n_neurons_layer1 + self.n_neurons_layer2 = n_neurons_layer2 + self.n_categories = n_categories + + self.epochs = epochs + self.batch_size = batch_size + self.iterations = self.n_inputs // self.batch_size + self.eta = eta + self.lmbd = lmbd + + # build network piece by piece + # name scopes (with) are used to enforce creation of new variables + # https://www.tensorflow.org/guide/variables + self.create_placeholders() + self.create_DNN() + self.create_loss() + self.create_optimiser() + self.create_accuracy() + + def create_placeholders(self): + # placeholders are fine here, but "Datasets" are the preferred method + # of streaming data into a model + with tf.name_scope('data'): + self.X = tf.placeholder(tf.float32, shape=(None, self.n_features), name='X_data') + self.Y = tf.placeholder(tf.float32, shape=(None, self.n_categories), name='Y_data') + + def create_DNN(self): + with tf.name_scope('DNN'): + # the weights are stored to calculate regularization loss later + + # Fully connected layer 1 + self.W_fc1 = self.weight_variable([self.n_features, self.n_neurons_layer1], name='fc1', dtype=tf.float32) + b_fc1 = self.bias_variable([self.n_neurons_layer1], name='fc1', dtype=tf.float32) + a_fc1 = tf.nn.sigmoid(tf.matmul(self.X, self.W_fc1) + b_fc1) + + # Fully connected layer 2 + self.W_fc2 = self.weight_variable([self.n_neurons_layer1, self.n_neurons_layer2], name='fc2', dtype=tf.float32) + b_fc2 = self.bias_variable([self.n_neurons_layer2], name='fc2', dtype=tf.float32) + a_fc2 = tf.nn.sigmoid(tf.matmul(a_fc1, self.W_fc2) + b_fc2) + + # Output layer + self.W_out = self.weight_variable([self.n_neurons_layer2, self.n_categories], name='out', dtype=tf.float32) + b_out = self.bias_variable([self.n_categories], name='out', dtype=tf.float32) + self.z_out = tf.matmul(a_fc2, self.W_out) + b_out + + def create_loss(self): + with tf.name_scope('loss'): + softmax_loss = tf.reduce_mean(tf.nn.softmax_cross_entropy_with_logits_v2(labels=self.Y, logits=self.z_out)) + + regularizer_loss_fc1 = tf.nn.l2_loss(self.W_fc1) + regularizer_loss_fc2 = tf.nn.l2_loss(self.W_fc2) + regularizer_loss_out = tf.nn.l2_loss(self.W_out) + regularizer_loss = self.lmbd*(regularizer_loss_fc1 + regularizer_loss_fc2 + regularizer_loss_out) + + self.loss = softmax_loss + regularizer_loss + + def create_accuracy(self): + with tf.name_scope('accuracy'): + probabilities = tf.nn.softmax(self.z_out) + predictions = tf.argmax(probabilities, axis=1) + labels = tf.argmax(self.Y, axis=1) + + correct_predictions = tf.equal(predictions, labels) + correct_predictions = tf.cast(correct_predictions, tf.float32) + self.accuracy = tf.reduce_mean(correct_predictions) + + def create_optimiser(self): + with tf.name_scope('optimizer'): + self.optimizer = tf.train.GradientDescentOptimizer(learning_rate=self.eta).minimize(self.loss, global_step=self.global_step) + + def weight_variable(self, shape, name='', dtype=tf.float32): + initial = tf.truncated_normal(shape, stddev=0.1) + return tf.Variable(initial, name=name, dtype=dtype) + + def bias_variable(self, shape, name='', dtype=tf.float32): + initial = tf.constant(0.1, shape=shape) + return tf.Variable(initial, name=name, dtype=dtype) + + def fit(self): + data_indices = np.arange(self.n_inputs) + + with tf.Session() as sess: + sess.run(tf.global_variables_initializer()) + for i in range(self.epochs): + for j in range(self.iterations): + chosen_datapoints = np.random.choice(data_indices, size=self.batch_size, replace=False) + batch_X, batch_Y = self.X_train[chosen_datapoints], self.Y_train[chosen_datapoints] + + sess.run([DNN.loss, DNN.optimizer], + feed_dict={DNN.X: batch_X, + DNN.Y: batch_Y}) + accuracy = sess.run(DNN.accuracy, + feed_dict={DNN.X: batch_X, + DNN.Y: batch_Y}) + step = sess.run(DNN.global_step) + + self.train_loss, self.train_accuracy = sess.run([DNN.loss, DNN.accuracy], + feed_dict={DNN.X: self.X_train, + DNN.Y: self.Y_train}) + + self.test_loss, self.test_accuracy = sess.run([DNN.loss, DNN.accuracy], + feed_dict={DNN.X: self.X_test, + DNN.Y: self.Y_test}) +!ec + + +!split +===== Optimizing and using gradient descent ===== + +!bc pycod +epochs = 100 +batch_size = 100 +n_neurons_layer1 = 100 +n_neurons_layer2 = 50 +n_categories = 10 +eta_vals = np.logspace(-5, 1, 7) +lmbd_vals = np.logspace(-5, 1, 7) +!ec + + +!bc pycod +DNN_tf = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object) + +for i, eta in enumerate(eta_vals): + for j, lmbd in enumerate(lmbd_vals): + DNN = NeuralNetworkTensorflow(X_train, Y_train, X_test, Y_test, + n_neurons_layer1, n_neurons_layer2, n_categories, + epochs=epochs, batch_size=batch_size, eta=eta, lmbd=lmbd) + DNN.fit() + + DNN_tf[i][j] = DNN + + print("Learning rate = ", eta) + print("Lambda = ", lmbd) + print("Test accuracy: %.3f" % DNN.test_accuracy) + print() +!ec + +!bc pycod +# optional +# visual representation of grid search +# uses seaborn heatmap, could probably do this in matplotlib +import seaborn as sns + +sns.set() + +train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) +test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) + +for i in range(len(eta_vals)): + for j in range(len(lmbd_vals)): + DNN = DNN_tf[i][j] + + train_accuracy[i][j] = DNN.train_accuracy + test_accuracy[i][j] = DNN.test_accuracy + + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Training Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Test Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() +!ec + +!bc pycod +# optional +# we can use log files to visualize our graph in Tensorboard +writer = tf.summary.FileWriter('logs/') +writer.add_graph(tf.get_default_graph()) +!ec + + +!split +===== Using Keras ===== + +Keras is a high level "neural network":"https://en.wikipedia.org/wiki/Application_programming_interface" +that supports Tensorflow, CTNK and Theano as backends. +If you have Tensorflow installed Keras is available through the *tf.keras* module. +If you have Anaconda installed you may run the following command +!bc pycod +conda install keras +!ec + +Alternatively, if you have Tensorflow or one of the other supported backends install you may use the pip package manager: + +!bc pycod +pip3 install keras +!ec +or look up the "instructions here":"https://keras.io/". + +!bc pycod +from keras.models import Sequential +from keras.layers import Dense +from keras.regularizers import l2 +from keras.optimizers import SGD + +def create_neural_network_keras(n_neurons_layer1, n_neurons_layer2, n_categories, eta, lmbd): + model = Sequential() + model.add(Dense(n_neurons_layer1, activation='sigmoid', kernel_regularizer=l2(lmbd))) + model.add(Dense(n_neurons_layer2, activation='sigmoid', kernel_regularizer=l2(lmbd))) + model.add(Dense(n_categories, activation='softmax')) + + sgd = SGD(lr=eta) + model.compile(loss='categorical_crossentropy', optimizer=sgd, metrics=['accuracy']) + + return model +!ec + +!bc pycod +DNN_keras = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object) + +for i, eta in enumerate(eta_vals): + for j, lmbd in enumerate(lmbd_vals): + DNN = create_neural_network_keras(n_neurons_layer1, n_neurons_layer2, n_categories, + eta=eta, lmbd=lmbd) + DNN.fit(X_train, Y_train, epochs=epochs, batch_size=batch_size, verbose=0) + scores = DNN.evaluate(X_test, Y_test) + + DNN_keras[i][j] = DNN + + print("Learning rate = ", eta) + print("Lambda = ", lmbd) + print("Test accuracy: %.3f" % scores[1]) + print() +!ec + +!bc pycod +# optional +# visual representation of grid search +# uses seaborn heatmap, could probably do this in matplotlib +import seaborn as sns + +sns.set() + +train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) +test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) + +for i in range(len(eta_vals)): + for j in range(len(lmbd_vals)): + DNN = DNN_keras[i][j] + + train_accuracy[i][j] = DNN.evaluate(X_train, Y_train)[1] + test_accuracy[i][j] = DNN.evaluate(X_test, Y_test)[1] + + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Training Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() + +fig, ax = plt.subplots(figsize = (10, 10)) +sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis") +ax.set_title("Test Accuracy") +ax.set_ylabel("$\eta$") +ax.set_xlabel("$\lambda$") +plt.show() +!ec + + + + +!split +===== Which activation function should I use? ===== + +The Back propagation algorithm we derived above works by going from +the output layer to the input layer, propagating the error gradient on +the way. Once the algorithm has computed the gradient of the cost +function with regards to each parameter in the network, it uses these +gradients to update each parameter with a Gradient Descent (GD) step. + + +Unfortunately for us, the gradients often get smaller and smaller as the +algorithm progresses down to the first hidden layers. As a result, the +GD update leaves the lower layer connection weights +virtually unchanged, and training never converges to a good +solution. This is known in the literature as +_the vanishing gradients problem_. + +In other cases, the opposite can happen, namely the the gradients can grow bigger and +bigger. The result is that many of the layers get large updates of the +weights the +algorithm diverges. This is the _exploding gradients problem_, which is +mostly encountered in recurrent neural networks. More generally, deep +neural networks suffer from unstable gradients, different layers may +learn at widely different speeds + +!split +===== Is the Logistic activation function (Sigmoid) our choice? ===== + +Although this unfortunate behavior has been empirically observed for +quite a while (it was one of the reasons why deep neural networks were +mostly abandoned for a long time), it is only around 2010 that +significant progress was made in understanding it. + +A paper titled "Understanding the Difficulty of Training Deep +Feedforward Neural Networks by Xavier Glorot and Yoshua Bengio":"http://proceedings.mlr.press/v9/glorot10a.html" found that +the problems with the popular logistic +sigmoid activation function and the weight initialization technique +that was most popular at the time, namely random initialization using +a normal distribution with a mean of 0 and a standard deviation of +1. + +They showed that with this activation function and this +initialization scheme, the variance of the outputs of each layer is +much greater than the variance of its inputs. Going forward in the +network, the variance keeps increasing after each layer until the +activation function saturates at the top layers. This is actually made +worse by the fact that the logistic function has a mean of 0.5, not 0 +(the hyperbolic tangent function has a mean of 0 and behaves slightly +better than the logistic function in deep networks). + + +!split +===== The derivative of the Logistic funtion ===== + +Looking at the logistic activation function, when inputs become large +(negative or positive), the function saturates at 0 or 1, with a +derivative extremely close to 0. Thus when backpropagation kicks in, +it has virtually no gradient to propagate back through the network, +and what little gradient exists keeps getting diluted as +backpropagation progresses down through the top layers, so there is +really nothing left for the lower layers. + +In their paper, Glorot and Bengio propose a way to significantly +alleviate this problem. We need the signal to flow properly in both +directions: in the forward direction when making predictions, and in +the reverse direction when backpropagating gradients. We don’t want +the signal to die out, nor do we want it to explode and saturate. For +the signal to flow properly, the authors argue that we need the +variance of the outputs of each layer to be equal to the variance of +its inputs, and we also need the gradients to have equal variance +before and after flowing through a layer in the reverse direction. + + + +One of the insights in the 2010 paper by Glorot and Bengio was that +the vanishing/exploding gradients problems were in part due to a poor +choice of activation function. Until then most people had assumed that +if Nature had chosen to use roughly sigmoid activation functions in +biological neurons, they must be an excellent choice. But it turns out +that other activation functions behave much better in deep neural +networks, in particular the ReLU activation function, mostly because +it does not saturate for positive values (and also because it is quite +fast to compute). + + +!split +===== The RELU function family ===== + +The ReLU activation function suffers from a problem known as the dying +ReLUs: during training, some neurons effectively die, meaning they +stop outputting anything other than 0. + +In some cases, you may find that half of your network’s neurons are +dead, especially if you used a large learning rate. During training, +if a neuron’s weights get updated such that the weighted sum of the +neuron’s inputs is negative, it will start outputting 0. When this +happen, the neuron is unlikely to come back to life since the gradient +of the ReLU function is 0 when its input is negative. + +To solve this problem, nowadays practitioners use a variant of the ReLU +function, such as the leaky ReLU discussed above or the so-called +exponential linear unit (ELU) function + + +!bt +\[ +ELU(z) = \left\{\begin{array}{cc} \alpha\left( \exp{(z)}-1\right) & z < 0,\\ z & z \ge 0.\end{array}\right. +\] +!et + +!split +===== Which activation function should we use? ===== + +In general it seems that the ELU activation function is better than +the leaky ReLU function (and its variants), which is better than +ReLU. ReLU performs better than $\tanh$ which in turn performs better +than the logistic function. + +If runtime +performance is an issue, then you may opt for the leaky ReLU function over the +ELU function If you don’t +want to tweak yet another hyperparameter, you may just use the default +$\alpha$ of $0.01$ for the leaky ReLU, and $1$ for ELU. If you have +spare time and computing power, you can use cross-validation or +bootstrap to evaluate other activation functions. + + +!split +===== A top-down perspective on Neural networks ===== + + +The first thing we would like to do is divide the data into two or three +parts. A training set, a validation or dev (development) set, and a +test set. The test set is the data on which we want to make +predictions. The dev set is a subset of the training data we use to +check how well we are doing out-of-sample, after training the model on +the training dataset. We use the validation error as a proxy for the +test error in order to make tweaks to our model. It is crucial that we +do not use any of the test data to train the algorithm. This is a +cardinal sin in ML. Then: + + +* Estimate optimal error rate + +* Minimize underfitting (bias) on training data set. + +* Make sure you are not overfitting. + +If the validation and test sets are drawn from the same distributions, +then a good performance on the validation set should lead to similarly +good performance on the test set. + +However, sometimes +the training data and test data differ in subtle ways because, for +example, they are collected using slightly different methods, or +because it is cheaper to collect data in one way versus another. In +this case, there can be a mismatch between the training and test +data. This can lead to the neural network overfitting these small +differences between the test and training sets, and a poor performance +on the test set despite having a good performance on the validation +set. To rectify this, Andrew Ng suggests making two validation or dev +sets, one constructed from the training data and one constructed from +the test data. The difference between the performance of the algorithm +on these two validation sets quantifies the train-test mismatch. This +can serve as another important diagnostic when using DNNs for +supervised learning. + +!split +===== Limitations of supervised learning with deep networks ===== + +Like all statistical methods, supervised learning using neural +networks has important limitations. This is especially important when +one seeks to apply these methods, especially to physics problems. Like +all tools, DNNs are not a universal solution. Often, the same or +better performance on a task can be achieved by using a few +hand-engineered features (or even a collection of random +features). + +Here we list some of the important limitations of supervised neural network based models. + + + +* _Need labeled data_. All supervised learning methods, DNNs for supervised learning require labeled data. Often, labeled data is harder to acquire than unlabeled data (e.g. one must pay for human experts to label images). +* _Supervised neural networks are extremely data intensive._ DNNs are data hungry. They perform best when data is plentiful. This is doubly so for supervised methods where the data must also be labeled. The utility of DNNs is extremely limited if data is hard to acquire or the datasets are small (hundreds to a few thousand samples). In this case, the performance of other methods that utilize hand-engineered features can exceed that of DNNs. +* _Homogeneous data._ Almost all DNNs deal with homogeneous data of one type. It is very hard to design architectures that mix and match data types (i.e.~some continuous variables, some discrete variables, some time series). In applications beyond images, video, and language, this is often what is required. In contrast, ensemble models like random forests or gradient-boosted trees have no difficulty handling mixed data types. +* _Many problems are not about prediction._ In natural science we are often interested in learning something about the underlying distribution that generates the data. In this case, it is often difficult to cast these ideas in a supervised learning setting. While the problems are related, it is possible to make good predictions with a *wrong* model. The model might or might not be useful for understanding the underlying science. + +Some of these remarks are particular to DNNs, others are shared by all supervised learning methods. This motivates the use of unsupervised methods which in part circumvent these problems. + + diff --git a/doc/src/Regression/chapter4.dlog b/doc/src/Regression/chapter4.dlog new file mode 100644 index 000000000..722f26133 --- /dev/null +++ b/doc/src/Regression/chapter4.dlog @@ -0,0 +1,73 @@ +translating doconce text in chapter4.do.txt to ipynb +*** replacing \bm{...} by \boldsymbol{...} (\bm is not supported by MathJax) +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{eqnarray*} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +Failed to remove ans_at_end environment +Failed to remove sol_at_end environment +output in chapter4.ipynb diff --git a/doc/src/Regression/chapter4.do.txt b/doc/src/Regression/chapter4.do.txt new file mode 100644 index 000000000..3642021c9 --- /dev/null +++ b/doc/src/Regression/chapter4.do.txt @@ -0,0 +1,3825 @@ +======= Linear Regression and more Advanced Regression Analysis ======= + + +!split +===== Why Linear Regression (aka Ordinary Least Squares and family) ===== + +Fitting a continuous function with linear parameterization in terms of the parameters $\bm{\beta}$. +* Method of choice for fitting a continuous function! +* Gives an excellent introduction to central Machine Learning features with _understandable pedagogical_ links to other methods like _Neural Networks_, _Support Vector Machines_ etc +* Analytical expression for the fitting parameters $\bm{\beta}$ +* Analytical expressions for statistical propertiers like mean values, variances, confidence intervals and more +* Analytical relation with probabilistic interpretations +* Easy to introduce basic concepts like bias-variance tradeoff, cross-validation, resampling and regularization techniques and many other ML topics +* Easy to code! And links well with classification problems and logistic regression and neural networks +* Allows for _easy_ hands-on understanding of gradient descent methods +* and many more features + +For more discussions of Ridge and Lasso regression, "Wessel van Wieringen's":"https://arxiv.org/abs/1509.09169" article is highly recommended. +Similarly, "Mehta et al's article":"https://arxiv.org/abs/1803.08823" is also recommended. + + +!split +===== Regression analysis, overarching aims ===== +!bblock + +Regression modeling deals with the description of the sampling distribution of a given random variable $y$ and how it varies as function of another variable or a set of such variables $\bm{x} =[x_0, x_1,\dots, x_{n-1}]^T$. +The first variable is called the _dependent_, the _outcome_ or the _response_ variable while the set of variables $\bm{x}$ is called the independent variable, or the predictor variable or the explanatory variable. + +A regression model aims at finding a likelihood function $p(\bm{y}\vert \bm{x})$, that is the conditional distribution for $\bm{y}$ with a given $\bm{x}$. The estimation of $p(\bm{y}\vert \bm{x})$ is made using a data set with +* $n$ cases $i = 0, 1, 2, \dots, n-1$ +* Response (target, dependent or outcome) variable $y_i$ with $i = 0, 1, 2, \dots, n-1$ +* $p$ so-called explanatory (independent or predictor) variables $\bm{x}_i=[x_{i0}, x_{i1}, \dots, x_{ip-1}]$ with $i = 0, 1, 2, \dots, n-1$ and explanatory variables running from $0$ to $p-1$. See below for more explicit examples. + The goal of the regression analysis is to extract/exploit relationship between $\bm{y}$ and $\bm{x}$ in or to infer causal dependencies, approximations to the likelihood functions, functional relationships and to make predictions, making fits and many other things. +!eblock + +!split +===== Regression analysis, overarching aims II ===== +!bblock + + +Consider an experiment in which $p$ characteristics of $n$ samples are +measured. The data from this experiment, for various explanatory variables $p$ are normally represented by a matrix +$\mathbf{X}$. + +The matrix $\mathbf{X}$ is called the *design +matrix*. Additional information of the samples is available in the +form of $\bm{y}$ (also as above). The variable $\bm{y}$ is +generally referred to as the *response variable*. The aim of +regression analysis is to explain $\bm{y}$ in terms of +$\bm{X}$ through a functional relationship like $y_i = +f(\mathbf{X}_{i,\ast})$. When no prior knowledge on the form of +$f(\cdot)$ is available, it is common to assume a linear relationship +between $\bm{X}$ and $\bm{y}$. This assumption gives rise to +the *linear regression model* where $\bm{\beta} = [\beta_0, \ldots, +\beta_{p-1}]^{T}$ are the *regression parameters*. + +Linear regression gives us a set of analytical equations for the parameters $\beta_j$. + +!eblock + + + +!split +===== Examples ===== +!bblock +In order to understand the relation among the predictors $p$, the set of data $n$ and the target (outcome, output etc) $\bm{y}$, +consider the model we discussed for describing nuclear binding energies. + +There we assumed that we could parametrize the data using a polynomial approximation based on the liquid drop model. +Assuming +!bt +\[ +BE(A) = a_0+a_1A+a_2A^{2/3}+a_3A^{-1/3}+a_4A^{-1}, +\] +!et +we have five predictors, that is the intercept, the $A$ dependent term, the $A^{2/3}$ term and the $A^{-1/3}$ and $A^{-1}$ terms. +This gives $p=0,1,2,3,4$. Furthermore we have $n$ entries for each predictor. It means that our design matrix is a +$p\times n$ matrix $\bm{X}$. + +Here the predictors are based on a model we have made. A popular data set which is widely encountered in ML applications is the +so-called "credit card default data from Taiwan":"https://www.sciencedirect.com/science/article/pii/S0957417407006719?via%3Dihub". The data set contains data on $n=30000$ credit card holders with predictors like gender, marital status, age, profession, education, etc. In total there are $24$ such predictors or attributes leading to a design matrix of dimensionality $24 \times 30000$. This is however a classification problem and we will come back to it when we discuss Logistic Regression. + +!eblock + + + + + +!split +===== General linear models ===== +!bblock +Before we proceed let us study a case from linear algebra where we aim at fitting a set of data $\bm{y}=[y_0,y_1,\dots,y_{n-1}]$. We could think of these data as a result of an experiment or a complicated numerical experiment. These data are functions of a series of variables $\bm{x}=[x_0,x_1,\dots,x_{n-1}]$, that is $y_i = y(x_i)$ with $i=0,1,2,\dots,n-1$. The variables $x_i$ could represent physical quantities like time, temperature, position etc. We assume that $y(x)$ is a smooth function. + +Since obtaining these data points may not be trivial, we want to use these data to fit a function which can allow us to make predictions for values of $y$ which are not in the present set. The perhaps simplest approach is to assume we can parametrize our function in terms of a polynomial of degree $n-1$ with $n$ points, that is +!bt +\[ +y=y(x) \rightarrow y(x_i)=\tilde{y}_i+\epsilon_i=\sum_{j=0}^{n-1} \beta_j x_i^j+\epsilon_i, +\] +!et +where $\epsilon_i$ is the error in our approximation. + +!eblock + + +!split +===== Rewriting the fitting procedure as a linear algebra problem ===== +!bblock +For every set of values $y_i,x_i$ we have thus the corresponding set of equations +!bt +\begin{align*} +y_0&=\beta_0+\beta_1x_0^1+\beta_2x_0^2+\dots+\beta_{n-1}x_0^{n-1}+\epsilon_0\\ +y_1&=\beta_0+\beta_1x_1^1+\beta_2x_1^2+\dots+\beta_{n-1}x_1^{n-1}+\epsilon_1\\ +y_2&=\beta_0+\beta_1x_2^1+\beta_2x_2^2+\dots+\beta_{n-1}x_2^{n-1}+\epsilon_2\\ +\dots & \dots \\ +y_{n-1}&=\beta_0+\beta_1x_{n-1}^1+\beta_2x_{n-1}^2+\dots+\beta_{n-1}x_{n-1}^{n-1}+\epsilon_{n-1}.\\ +\end{align*} +!et +!eblock + + +!split +===== Rewriting the fitting procedure as a linear algebra problem, more details ===== +!bblock +Defining the vectors +!bt +\[ +\bm{y} = [y_0,y_1, y_2,\dots, y_{n-1}]^T, +\] +!et +and +!bt +\[ +\bm{\beta} = [\beta_0,\beta_1, \beta_2,\dots, \beta_{n-1}]^T, +\] +!et +and +!bt +\[ +\bm{\epsilon} = [\epsilon_0,\epsilon_1, \epsilon_2,\dots, \epsilon_{n-1}]^T, +\] +!et +and the design matrix +!bt +\[ +\bm{X}= +\begin{bmatrix} +1& x_{0}^1 &x_{0}^2& \dots & \dots &x_{0}^{n-1}\\ +1& x_{1}^1 &x_{1}^2& \dots & \dots &x_{1}^{n-1}\\ +1& x_{2}^1 &x_{2}^2& \dots & \dots &x_{2}^{n-1}\\ +\dots& \dots &\dots& \dots & \dots &\dots\\ +1& x_{n-1}^1 &x_{n-1}^2& \dots & \dots &x_{n-1}^{n-1}\\ +\end{bmatrix} +\] +!et +we can rewrite our equations as +!bt +\[ +\bm{y} = \bm{X}\bm{\beta}+\bm{\epsilon}. +\] +!et +The above design matrix is called a "Vandermonde matrix":"https://en.wikipedia.org/wiki/Vandermonde_matrix". +!eblock + + +!split +===== Generalizing the fitting procedure as a linear algebra problem ===== +!bblock + +We are obviously not limited to the above polynomial expansions. We +could replace the various powers of $x$ with elements of Fourier +series or instead of $x_i^j$ we could have $\cos{(j x_i)}$ or $\sin{(j +x_i)}$, or time series or other orthogonal functions. For every set +of values $y_i,x_i$ we can then generalize the equations to + +!bt +\begin{align*} +y_0&=\beta_0x_{00}+\beta_1x_{01}+\beta_2x_{02}+\dots+\beta_{n-1}x_{0n-1}+\epsilon_0\\ +y_1&=\beta_0x_{10}+\beta_1x_{11}+\beta_2x_{12}+\dots+\beta_{n-1}x_{1n-1}+\epsilon_1\\ +y_2&=\beta_0x_{20}+\beta_1x_{21}+\beta_2x_{22}+\dots+\beta_{n-1}x_{2n-1}+\epsilon_2\\ +\dots & \dots \\ +y_{i}&=\beta_0x_{i0}+\beta_1x_{i1}+\beta_2x_{i2}+\dots+\beta_{n-1}x_{in-1}+\epsilon_i\\ +\dots & \dots \\ +y_{n-1}&=\beta_0x_{n-1,0}+\beta_1x_{n-1,2}+\beta_2x_{n-1,2}+\dots+\beta_{n-1}x_{n-1,n-1}+\epsilon_{n-1}.\\ +\end{align*} +!et + +_Note that we have $p=n$ here. The matrix is symmetric. This is generally not the case!_ +!eblock + + +!split +===== Generalizing the fitting procedure as a linear algebra problem ===== +!bblock +We redefine in turn the matrix $\bm{X}$ as +!bt +\[ +\bm{X}= +\begin{bmatrix} +x_{00}& x_{01} &x_{02}& \dots & \dots &x_{0,n-1}\\ +x_{10}& x_{11} &x_{12}& \dots & \dots &x_{1,n-1}\\ +x_{20}& x_{21} &x_{22}& \dots & \dots &x_{2,n-1}\\ +\dots& \dots &\dots& \dots & \dots &\dots\\ +x_{n-1,0}& x_{n-1,1} &x_{n-1,2}& \dots & \dots &x_{n-1,n-1}\\ +\end{bmatrix} +\] +!et +and without loss of generality we rewrite again our equations as +!bt +\[ +\bm{y} = \bm{X}\bm{\beta}+\bm{\epsilon}. +\] +!et +The left-hand side of this equation is kwown. Our error vector $\bm{\epsilon}$ and the parameter vector $\bm{\beta}$ are our unknow quantities. How can we obtain the optimal set of $\beta_i$ values? +!eblock + + +!split +===== Optimizing our parameters ===== +!bblock +We have defined the matrix $\bm{X}$ via the equations +!bt +\begin{align*} +y_0&=\beta_0x_{00}+\beta_1x_{01}+\beta_2x_{02}+\dots+\beta_{n-1}x_{0n-1}+\epsilon_0\\ +y_1&=\beta_0x_{10}+\beta_1x_{11}+\beta_2x_{12}+\dots+\beta_{n-1}x_{1n-1}+\epsilon_1\\ +y_2&=\beta_0x_{20}+\beta_1x_{21}+\beta_2x_{22}+\dots+\beta_{n-1}x_{2n-1}+\epsilon_1\\ +\dots & \dots \\ +y_{i}&=\beta_0x_{i0}+\beta_1x_{i1}+\beta_2x_{i2}+\dots+\beta_{n-1}x_{in-1}+\epsilon_1\\ +\dots & \dots \\ +y_{n-1}&=\beta_0x_{n-1,0}+\beta_1x_{n-1,2}+\beta_2x_{n-1,2}+\dots+\beta_{n-1}x_{n-1,n-1}+\epsilon_{n-1}.\\ +\end{align*} +!et + +As we noted above, we stayed with a system with the design matrix + $\bm{X}\in {\mathbb{R}}^{n\times n}$, that is we have $p=n$. For reasons to come later (algorithmic arguments) we will hereafter define +our matrix as $\bm{X}\in {\mathbb{R}}^{n\times p}$, with the predictors refering to the column numbers and the entries $n$ being the row elements. + +!eblock + + +!split +===== Our model for the nuclear binding energies ===== + +In our "introductory notes":"https://compphysics.github.io/MachineLearning/doc/pub/How2ReadData/html/How2ReadData.html" we looked at the so-called "liquid drop model":"https://en.wikipedia.org/wiki/Semi-empirical_mass_formula". Let us remind ourselves about what we did by looking at the code. + +We restate the parts of the code we are most interested in. +!bc pycod +# Common imports +import numpy as np +import pandas as pd +import matplotlib.pyplot as plt +from IPython.display import display +import os + +# Where to save the figures and data files +PROJECT_ROOT_DIR = "Results" +FIGURE_ID = "Results/FigureFiles" +DATA_ID = "DataFiles/" + +if not os.path.exists(PROJECT_ROOT_DIR): + os.mkdir(PROJECT_ROOT_DIR) + +if not os.path.exists(FIGURE_ID): + os.makedirs(FIGURE_ID) + +if not os.path.exists(DATA_ID): + os.makedirs(DATA_ID) + +def image_path(fig_id): + return os.path.join(FIGURE_ID, fig_id) + +def data_path(dat_id): + return os.path.join(DATA_ID, dat_id) + +def save_fig(fig_id): + plt.savefig(image_path(fig_id) + ".png", format='png') + +infile = open(data_path("MassEval2016.dat"),'r') + + +# Read the experimental data with Pandas +Masses = pd.read_fwf(infile, usecols=(2,3,4,6,11), + names=('N', 'Z', 'A', 'Element', 'Ebinding'), + widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1), + header=39, + index_col=False) + +# Extrapolated values are indicated by '#' in place of the decimal place, so +# the Ebinding column won't be numeric. Coerce to float and drop these entries. +Masses['Ebinding'] = pd.to_numeric(Masses['Ebinding'], errors='coerce') +Masses = Masses.dropna() +# Convert from keV to MeV. +Masses['Ebinding'] /= 1000 + +# Group the DataFrame by nucleon number, A. +Masses = Masses.groupby('A') +# Find the rows of the grouped DataFrame with the maximum binding energy. +Masses = Masses.apply(lambda t: t[t.Ebinding==t.Ebinding.max()]) +A = Masses['A'] +Z = Masses['Z'] +N = Masses['N'] +Element = Masses['Element'] +Energies = Masses['Ebinding'] + +# Now we set up the design matrix X +X = np.zeros((len(A),5)) +X[:,0] = 1 +X[:,1] = A +X[:,2] = A**(2.0/3.0) +X[:,3] = A**(-1.0/3.0) +X[:,4] = A**(-1.0) +# Then nice printout using pandas +DesignMatrix = pd.DataFrame(X) +DesignMatrix.index = A +DesignMatrix.columns = ['1', 'A', 'A^(2/3)', 'A^(-1/3)', '1/A'] +display(DesignMatrix) +!ec + +With $\bm{\beta}\in {\mathbb{R}}^{p\times 1}$, it means that we will hereafter write our equations for the approximation as +!bt +\[ +\bm{\tilde{y}}= \bm{X}\bm{\beta}, +\] +!et +throughout these lectures. + + +!split +===== Optimizing our parameters, more details ===== +!bblock +With the above we use the design matrix to define the approximation $\bm{\tilde{y}}$ via the unknown quantity $\bm{\beta}$ as +!bt +\[ +\bm{\tilde{y}}= \bm{X}\bm{\beta}, +\] +!et +and in order to find the optimal parameters $\beta_i$ instead of solving the above linear algebra problem, we define a function which gives a measure of the spread between the values $y_i$ (which represent hopefully the exact values) and the parameterized values $\tilde{y}_i$, namely +!bt +\[ +C(\bm{\beta})=\frac{1}{n}\sum_{i=0}^{n-1}\left(y_i-\tilde{y}_i\right)^2=\frac{1}{n}\left\{\left(\bm{y}-\bm{\tilde{y}}\right)^T\left(\bm{y}-\bm{\tilde{y}}\right)\right\}, +\] +!et +or using the matrix $\bm{X}$ and in a more compact matrix-vector notation as +!bt +\[ +C(\bm{\beta})=\frac{1}{n}\left\{\left(\bm{y}-\bm{X}\bm{\beta}\right)^T\left(\bm{y}-\bm{X}\bm{\beta}\right)\right\}. +\] +!et +This function is one possible way to define the so-called cost function. + + + +It is also common to define +the function $C$ as + +!bt +\[ +C(\bm{\beta})=\frac{1}{2n}\sum_{i=0}^{n-1}\left(y_i-\tilde{y}_i\right)^2, +\] +!et +since when taking the first derivative with respect to the unknown parameters $\beta$, the factor of $2$ cancels out. +!eblock + + +!split +===== Interpretations and optimizing our parameters ===== +!bblock + +The function +!bt +\[ +C(\bm{\beta})=\frac{1}{n}\left\{\left(\bm{y}-\bm{X}\bm{\beta}\right)^T\left(\bm{y}-\bm{X}\bm{\beta}\right)\right\}, +\] +!et +can be linked to the variance of the quantity $y_i$ if we interpret the latter as the mean value. +When linking (see the discussion below) with the maximum likelihood approach below, we will indeed interpret $y_i$ as a mean value +!bt +\[ +y_{i}=\langle y_i \rangle = \beta_0x_{i,0}+\beta_1x_{i,1}+\beta_2x_{i,2}+\dots+\beta_{n-1}x_{i,n-1}+\epsilon_i, +\] +!et + +where $\langle y_i \rangle$ is the mean value. Keep in mind also that +till now we have treated $y_i$ as the exact value. Normally, the +response (dependent or outcome) variable $y_i$ the outcome of a +numerical experiment or another type of experiment and is thus only an +approximation to the true value. It is then always accompanied by an +error estimate, often limited to a statistical error estimate given by +the standard deviation discussed earlier. In the discussion here we +will treat $y_i$ as our exact value for the response variable. + +In order to find the parameters $\beta_i$ we will then minimize the spread of $C(\bm{\beta})$, that is we are going to solve the problem +!bt +\[ +{\displaystyle \min_{\bm{\beta}\in +{\mathbb{R}}^{p}}}\frac{1}{n}\left\{\left(\bm{y}-\bm{X}\bm{\beta}\right)^T\left(\bm{y}-\bm{X}\bm{\beta}\right)\right\}. +\] +!et +In practical terms it means we will require +!bt +\[ +\frac{\partial C(\bm{\beta})}{\partial \beta_j} = \frac{\partial }{\partial \beta_j}\left[ \frac{1}{n}\sum_{i=0}^{n-1}\left(y_i-\beta_0x_{i,0}-\beta_1x_{i,1}-\beta_2x_{i,2}-\dots-\beta_{n-1}x_{i,n-1}\right)^2\right]=0, +\] +!et +which results in +!bt +\[ +\frac{\partial C(\bm{\beta})}{\partial \beta_j} = -\frac{2}{n}\left[ \sum_{i=0}^{n-1}x_{ij}\left(y_i-\beta_0x_{i,0}-\beta_1x_{i,1}-\beta_2x_{i,2}-\dots-\beta_{n-1}x_{i,n-1}\right)\right]=0, +\] +!et +or in a matrix-vector form as +!bt +\[ +\frac{\partial C(\bm{\beta})}{\partial \bm{\beta}} = 0 = \bm{X}^T\left( \bm{y}-\bm{X}\bm{\beta}\right). +\] +!et + + +!eblock + + +!split +===== Interpretations and optimizing our parameters ===== +!bblock +We can rewrite +!bt +\[ +\frac{\partial C(\bm{\beta})}{\partial \bm{\beta}} = 0 = \bm{X}^T\left( \bm{y}-\bm{X}\bm{\beta}\right), +\] +!et +as +!bt +\[ +\bm{X}^T\bm{y} = \bm{X}^T\bm{X}\bm{\beta}, +\] +!et +and if the matrix $\bm{X}^T\bm{X}$ is invertible we have the solution +!bt +\[ +\bm{\beta} =\left(\bm{X}^T\bm{X}\right)^{-1}\bm{X}^T\bm{y}. +\] +!et + +We note also that since our design matrix is defined as $\bm{X}\in +{\mathbb{R}}^{n\times p}$, the product $\bm{X}^T\bm{X} \in +{\mathbb{R}}^{p\times p}$. In the above case we have that $p \ll n$, +in our case $p=5$ meaning that we end up with inverting a small +$5\times 5$ matrix. This is a rather common situation, in many cases we end up with low-dimensional +matrices to invert. The methods discussed here and for many other +supervised learning algorithms like classification with logistic +regression or support vector machines, exhibit dimensionalities which +allow for the usage of direct linear algebra methods such as _LU_ decomposition or _Singular Value Decomposition_ (SVD) for finding the inverse of the matrix +$\bm{X}^T\bm{X}$. +!eblock + +!bblock +_Small question_: Do you think the example we have at hand here (the nuclear binding energies) can lead to problems in inverting the matrix $\bm{X}^T\bm{X}$? What kind of problems can we expect? +!eblock + +!split +===== Some useful matrix and vector expressions ===== + +The following matrix and vector relation will be useful here and for the rest of the course. Vectors are always written as boldfaced lower case letters and +matrices as upper case boldfaced letters. + +!bt +\[ +\frac{\partial (\bm{b}^T\bm{a})}{\partial \bm{a}} = \bm{b}, +\] +!et +!bt +\[ +\frac{\partial (\bm{a}^T\bm{A}\bm{a})}{\partial \bm{a}} = (\bm{A}+\bm{A}^T)\bm{a}, +\] +!et +!bt +\[ +\frac{\partial tr(\bm{B}\bm{A})}{\partial \bm{A}} = \bm{B}^T, +\] +!et +!bt +\[ +\frac{\partial \log{\vert\bm{A}\vert}}{\partial \bm{A}} = (\bm{A}^{-1})^T. +\] +!et +!split +===== Interpretations and optimizing our parameters ===== +!bblock +The residuals $\bm{\epsilon}$ are in turn given by +!bt +\[ +\bm{\epsilon} = \bm{y}-\bm{\tilde{y}} = \bm{y}-\bm{X}\bm{\beta}, +\] +!et +and with +!bt +\[ +\bm{X}^T\left( \bm{y}-\bm{X}\bm{\beta}\right)= 0, +\] +!et +we have +!bt +\[ +\bm{X}^T\bm{\epsilon}=\bm{X}^T\left( \bm{y}-\bm{X}\bm{\beta}\right)= 0, +\] +!et +meaning that the solution for $\bm{\beta}$ is the one which minimizes the residuals. Later we will link this with the maximum likelihood approach. + +!eblock + + +Let us now return to our nuclear binding energies and simply code the above equations. + +!split +===== Own code for Ordinary Least Squares ===== + +It is rather straightforward to implement the matrix inversion and obtain the parameters $\bm{\beta}$. After having defined the matrix $\bm{X}$ we simply need to +write +!bc pycod +# matrix inversion to find beta +beta = np.linalg.inv(X.T.dot(X)).dot(X.T).dot(Energies) +# and then make the prediction +ytilde = X @ beta +!ec +Alternatively, you can use the least squares functionality in _Numpy_ as +!bc pycod +fit = np.linalg.lstsq(X, Energies, rcond =None)[0] +ytildenp = np.dot(fit,X.T) +!ec + +And finally we plot our fit with and compare with data +!bc pycod +Masses['Eapprox'] = ytilde +# Generate a plot comparing the experimental with the fitted values values. +fig, ax = plt.subplots() +ax.set_xlabel(r'$A = N + Z$') +ax.set_ylabel(r'$E_\mathrm{bind}\,/\mathrm{MeV}$') +ax.plot(Masses['A'], Masses['Ebinding'], alpha=0.7, lw=2, + label='Ame2016') +ax.plot(Masses['A'], Masses['Eapprox'], alpha=0.7, lw=2, c='m', + label='Fit') +ax.legend() +save_fig("Masses2016OLS") +plt.show() +!ec + +!split +===== Adding error analysis and training set up ===== + +We can easily test our fit by computing the $R2$ score that we discussed in connection with the functionality of _Scikit-Learn_ in the introductory slides. +Since we are not using _Scikit-Learn_ here we can define our own $R2$ function as +!bc pycod +def R2(y_data, y_model): + return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2) +!ec +and we would be using it as +!bc pycod +print(R2(Energies,ytilde)) +!ec + +We can easily add our _MSE_ score as +!bc pycod +def MSE(y_data,y_model): + n = np.size(y_model) + return np.sum((y_data-y_model)**2)/n + +print(MSE(Energies,ytilde)) +!ec +and finally the relative error as +!bc pycod +def RelativeError(y_data,y_model): + return abs((y_data-y_model)/y_data) +print(RelativeError(Energies, ytilde)) +!ec + + + +!split +===== The $\chi^2$ function ===== +!bblock + +Normally, the response (dependent or outcome) variable $y_i$ is the +outcome of a numerical experiment or another type of experiment and is +thus only an approximation to the true value. It is then always +accompanied by an error estimate, often limited to a statistical error +estimate given by the standard deviation discussed earlier. In the +discussion here we will treat $y_i$ as our exact value for the +response variable. + +Introducing the standard deviation $\sigma_i$ for each measurement +$y_i$, we define now the $\chi^2$ function (omitting the $1/n$ term) +as + +!bt +\[ +\chi^2(\bm{\beta})=\frac{1}{n}\sum_{i=0}^{n-1}\frac{\left(y_i-\tilde{y}_i\right)^2}{\sigma_i^2}=\frac{1}{n}\left\{\left(\bm{y}-\bm{\tilde{y}}\right)^T\frac{1}{\bm{\Sigma^2}}\left(\bm{y}-\bm{\tilde{y}}\right)\right\}, +\] +!et +where the matrix $\bm{\Sigma}$ is a diagonal matrix with $\sigma_i$ as matrix elements. + +!eblock + +!split +===== The $\chi^2$ function ===== +!bblock + +In order to find the parameters $\beta_i$ we will then minimize the spread of $\chi^2(\bm{\beta})$ by requiring +!bt +\[ +\frac{\partial \chi^2(\bm{\beta})}{\partial \beta_j} = \frac{\partial }{\partial \beta_j}\left[ \frac{1}{n}\sum_{i=0}^{n-1}\left(\frac{y_i-\beta_0x_{i,0}-\beta_1x_{i,1}-\beta_2x_{i,2}-\dots-\beta_{n-1}x_{i,n-1}}{\sigma_i}\right)^2\right]=0, +\] +!et +which results in +!bt +\[ +\frac{\partial \chi^2(\bm{\beta})}{\partial \beta_j} = -\frac{2}{n}\left[ \sum_{i=0}^{n-1}\frac{x_{ij}}{\sigma_i}\left(\frac{y_i-\beta_0x_{i,0}-\beta_1x_{i,1}-\beta_2x_{i,2}-\dots-\beta_{n-1}x_{i,n-1}}{\sigma_i}\right)\right]=0, +\] +!et +or in a matrix-vector form as +!bt +\[ +\frac{\partial \chi^2(\bm{\beta})}{\partial \bm{\beta}} = 0 = \bm{A}^T\left( \bm{b}-\bm{A}\bm{\beta}\right). +\] +!et +where we have defined the matrix $\bm{A} =\bm{X}/\bm{\Sigma}$ with matrix elements $a_{ij} = x_{ij}/\sigma_i$ and the vector $\bm{b}$ with elements $b_i = y_i/\sigma_i$. +!eblock + +!split +===== The $\chi^2$ function ===== +!bblock + +We can rewrite +!bt +\[ +\frac{\partial \chi^2(\bm{\beta})}{\partial \bm{\beta}} = 0 = \bm{A}^T\left( \bm{b}-\bm{A}\bm{\beta}\right), +\] +!et +as +!bt +\[ +\bm{A}^T\bm{b} = \bm{A}^T\bm{A}\bm{\beta}, +\] +!et +and if the matrix $\bm{A}^T\bm{A}$ is invertible we have the solution +!bt +\[ +\bm{\beta} =\left(\bm{A}^T\bm{A}\right)^{-1}\bm{A}^T\bm{b}. +\] +!et +!eblock + +!split +===== The $\chi^2$ function ===== +!bblock + +If we then introduce the matrix +!bt +\[ +\bm{H} = \left(\bm{A}^T\bm{A}\right)^{-1}, +\] +!et +we have then the following expression for the parameters $\beta_j$ (the matrix elements of $\bm{H}$ are $h_{ij}$) +!bt +\[ +\beta_j = \sum_{k=0}^{p-1}h_{jk}\sum_{i=0}^{n-1}\frac{y_i}{\sigma_i}\frac{x_{ik}}{\sigma_i} = \sum_{k=0}^{p-1}h_{jk}\sum_{i=0}^{n-1}b_ia_{ik} +\] +!et +We state without proof the expression for the uncertainty in the parameters $\beta_j$ as (we leave this as an exercise) +!bt +\[ +\sigma^2(\beta_j) = \sum_{i=0}^{n-1}\sigma_i^2\left( \frac{\partial \beta_j}{\partial y_i}\right)^2, +\] +!et +resulting in +!bt +\[ +\sigma^2(\beta_j) = \left(\sum_{k=0}^{p-1}h_{jk}\sum_{i=0}^{n-1}a_{ik}\right)\left(\sum_{l=0}^{p-1}h_{jl}\sum_{m=0}^{n-1}a_{ml}\right) = h_{jj}! +\] +!et +!eblock + +!split +===== The $\chi^2$ function ===== +!bblock +The first step here is to approximate the function $y$ with a first-order polynomial, that is we write +!bt +\[ +y=y(x) \rightarrow y(x_i) \approx \beta_0+\beta_1 x_i. +\] +!et +By computing the derivatives of $\chi^2$ with respect to $\beta_0$ and $\beta_1$ show that these are given by +!bt +\[ +\frac{\partial \chi^2(\bm{\beta})}{\partial \beta_0} = -2\left[ \frac{1}{n}\sum_{i=0}^{n-1}\left(\frac{y_i-\beta_0-\beta_1x_{i}}{\sigma_i^2}\right)\right]=0, +\] +!et +and +!bt +\[ +\frac{\partial \chi^2(\bm{\beta})}{\partial \beta_1} = -\frac{2}{n}\left[ \sum_{i=0}^{n-1}x_i\left(\frac{y_i-\beta_0-\beta_1x_{i}}{\sigma_i^2}\right)\right]=0. +\] +!et +!eblock + +!split +===== The $\chi^2$ function ===== +!bblock + +For a linear fit (a first-order polynomial) we don't need to invert a matrix!! +Defining +!bt +\[ +\gamma = \sum_{i=0}^{n-1}\frac{1}{\sigma_i^2}, +\] +!et + +!bt +\[ +\gamma_x = \sum_{i=0}^{n-1}\frac{x_{i}}{\sigma_i^2}, +\] +!et + +!bt +\[ +\gamma_y = \sum_{i=0}^{n-1}\left(\frac{y_i}{\sigma_i^2}\right), +\] +!et + +!bt +\[ +\gamma_{xx} = \sum_{i=0}^{n-1}\frac{x_ix_{i}}{\sigma_i^2}, +\] +!et + +!bt +\[ +\gamma_{xy} = \sum_{i=0}^{n-1}\frac{y_ix_{i}}{\sigma_i^2}, +\] +!et + +we obtain + +!bt +\[ +\beta_0 = \frac{\gamma_{xx}\gamma_y-\gamma_x\gamma_y}{\gamma\gamma_{xx}-\gamma_x^2}, +\] +!et + +!bt +\[ +\beta_1 = \frac{\gamma_{xy}\gamma-\gamma_x\gamma_y}{\gamma\gamma_{xx}-\gamma_x^2}. +\] +!et + +This approach (different linear and non-linear regression) suffers +often from both being underdetermined and overdetermined in the +unknown coefficients $\beta_i$. A better approach is to use the +Singular Value Decomposition (SVD) method discussed below. Or using +Lasso and Ridge regression. See below. + +!eblock + + +!split +===== Fitting an Equation of State for Dense Nuclear Matter ===== + +Before we continue, let us introduce yet another example. We are going to fit the +nuclear equation of state using results from many-body calculations. +The equation of state we have made available here, as function of +density, has been derived using modern nucleon-nucleon potentials with +"the addition of three-body +forces":"https://www.sciencedirect.com/science/article/pii/S0370157399001106". This +time the file is presented as a standard _csv_ file. + +The beginning of the Python code here is similar to what you have seen +before, with the same initializations and declarations. We use also +_pandas_ again, rather extensively in order to organize our data. + +The difference now is that we use _Scikit-Learn's_ regression tools +instead of our own matrix inversion implementation. Furthermore, we +sneak in _Ridge_ regression (to be discussed below) which includes a +hyperparameter $\lambda$, also to be explained below. + +!split +===== The code ===== + +!bc pycod +# Common imports +import os +import numpy as np +import pandas as pd +import matplotlib.pyplot as plt +import matplotlib.pyplot as plt +import sklearn.linear_model as skl +from sklearn.metrics import mean_squared_error, r2_score, mean_absolute_error + +# Where to save the figures and data files +PROJECT_ROOT_DIR = "Results" +FIGURE_ID = "Results/FigureFiles" +DATA_ID = "DataFiles/" + +if not os.path.exists(PROJECT_ROOT_DIR): + os.mkdir(PROJECT_ROOT_DIR) + +if not os.path.exists(FIGURE_ID): + os.makedirs(FIGURE_ID) + +if not os.path.exists(DATA_ID): + os.makedirs(DATA_ID) + +def image_path(fig_id): + return os.path.join(FIGURE_ID, fig_id) + +def data_path(dat_id): + return os.path.join(DATA_ID, dat_id) + +def save_fig(fig_id): + plt.savefig(image_path(fig_id) + ".png", format='png') + +infile = open(data_path("EoS.csv"),'r') + +# Read the EoS data as csv file and organize the data into two arrays with density and energies +EoS = pd.read_csv(infile, names=('Density', 'Energy')) +EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce') +EoS = EoS.dropna() +Energies = EoS['Energy'] +Density = EoS['Density'] +# The design matrix now as function of various polytrops +X = np.zeros((len(Density),4)) +X[:,3] = Density**(4.0/3.0) +X[:,2] = Density +X[:,1] = Density**(2.0/3.0) +X[:,0] = 1 + +# We use now Scikit-Learn's linear regressor and ridge regressor +# OLS part +clf = skl.LinearRegression().fit(X, Energies) +ytilde = clf.predict(X) +EoS['Eols'] = ytilde +# The mean squared error +print("Mean squared error: %.2f" % mean_squared_error(Energies, ytilde)) +# Explained variance score: 1 is perfect prediction +print('Variance score: %.2f' % r2_score(Energies, ytilde)) +# Mean absolute error +print('Mean absolute error: %.2f' % mean_absolute_error(Energies, ytilde)) +print(clf.coef_, clf.intercept_) + +# The Ridge regression with a hyperparameter lambda = 0.1 +_lambda = 0.1 +clf_ridge = skl.Ridge(alpha=_lambda).fit(X, Energies) +yridge = clf_ridge.predict(X) +EoS['Eridge'] = yridge +# The mean squared error +print("Mean squared error: %.2f" % mean_squared_error(Energies, yridge)) +# Explained variance score: 1 is perfect prediction +print('Variance score: %.2f' % r2_score(Energies, yridge)) +# Mean absolute error +print('Mean absolute error: %.2f' % mean_absolute_error(Energies, yridge)) +print(clf_ridge.coef_, clf_ridge.intercept_) + +fig, ax = plt.subplots() +ax.set_xlabel(r'$\rho[\mathrm{fm}^{-3}]$') +ax.set_ylabel(r'Energy per particle') +ax.plot(EoS['Density'], EoS['Energy'], alpha=0.7, lw=2, + label='Theoretical data') +ax.plot(EoS['Density'], EoS['Eols'], alpha=0.7, lw=2, c='m', + label='OLS') +ax.plot(EoS['Density'], EoS['Eridge'], alpha=0.7, lw=2, c='g', + label='Ridge $\lambda = 0.1$') +ax.legend() +save_fig("EoSfitting") +plt.show() +!ec + +The above simple polynomial in density $\rho$ gives an excellent fit +to the data. + +We note also that there is a small deviation between the +standard OLS and the Ridge regression at higher densities. We discuss this in more detail +below. + + +!split +===== Splitting our Data in Training and Test data ===== + +It is normal in essentially all Machine Learning studies to split the +data in a training set and a test set (sometimes also an additional +validation set). _Scikit-Learn_ has an own function for this. There +is no explicit recipe for how much data should be included as training +data and say test data. An accepted rule of thumb is to use +approximately $2/3$ to $4/5$ of the data as training data. We will +postpone a discussion of this splitting to the end of these notes and +our discussion of the so-called _bias-variance_ tradeoff. Here we +limit ourselves to repeat the above equation of state fitting example +but now splitting the data into a training set and a test set. + +!bc pycod +import os +import numpy as np +import pandas as pd +import matplotlib.pyplot as plt +from sklearn.model_selection import train_test_split +# Where to save the figures and data files +PROJECT_ROOT_DIR = "Results" +FIGURE_ID = "Results/FigureFiles" +DATA_ID = "DataFiles/" + +if not os.path.exists(PROJECT_ROOT_DIR): + os.mkdir(PROJECT_ROOT_DIR) + +if not os.path.exists(FIGURE_ID): + os.makedirs(FIGURE_ID) + +if not os.path.exists(DATA_ID): + os.makedirs(DATA_ID) + +def image_path(fig_id): + return os.path.join(FIGURE_ID, fig_id) + +def data_path(dat_id): + return os.path.join(DATA_ID, dat_id) + +def save_fig(fig_id): + plt.savefig(image_path(fig_id) + ".png", format='png') + +def R2(y_data, y_model): + return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2) +def MSE(y_data,y_model): + n = np.size(y_model) + return np.sum((y_data-y_model)**2)/n + +infile = open(data_path("EoS.csv"),'r') + +# Read the EoS data as csv file and organized into two arrays with density and energies +EoS = pd.read_csv(infile, names=('Density', 'Energy')) +EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce') +EoS = EoS.dropna() +Energies = EoS['Energy'] +Density = EoS['Density'] +# The design matrix now as function of various polytrops +X = np.zeros((len(Density),5)) +X[:,0] = 1 +X[:,1] = Density**(2.0/3.0) +X[:,2] = Density +X[:,3] = Density**(4.0/3.0) +X[:,4] = Density**(5.0/3.0) +# We split the data in test and training data +X_train, X_test, y_train, y_test = train_test_split(X, Energies, test_size=0.2) +# matrix inversion to find beta +beta = np.linalg.inv(X_train.T.dot(X_train)).dot(X_train.T).dot(y_train) +# and then make the prediction +ytilde = X_train @ beta +print("Training R2") +print(R2(y_train,ytilde)) +print("Training MSE") +print(MSE(y_train,ytilde)) +ypredict = X_test @ beta +print("Test R2") +print(R2(y_test,ypredict)) +print("Test MSE") +print(MSE(y_test,ypredict)) +!ec + + +!split +===== The Boston housing data example ===== + +The Boston housing +data set was originally a part of UCI Machine Learning Repository +and has been removed now. The data set is now included in _Scikit-Learn_'s +library. There are 506 samples and 13 feature (predictor) variables +in this data set. The objective is to predict the value of prices of +the house using the features (predictors) listed here. + +The features/predictors are + o CRIM: Per capita crime rate by town + o ZN: Proportion of residential land zoned for lots over 25000 square feet + o INDUS: Proportion of non-retail business acres per town + o CHAS: Charles River dummy variable (= 1 if tract bounds river; 0 otherwise) + o NOX: Nitric oxide concentration (parts per 10 million) + o RM: Average number of rooms per dwelling + o AGE: Proportion of owner-occupied units built prior to 1940 + o DIS: Weighted distances to five Boston employment centers + o RAD: Index of accessibility to radial highways + o TAX: Full-value property tax rate per USD10000 + o B: $1000(Bk - 0.63)^2$, where $Bk$ is the proportion of [people of African American descent] by town + o LSTAT: Percentage of lower status of the population + o MEDV: Median value of owner-occupied homes in USD 1000s + +!split +===== Housing data, the code ===== +We start by importing the libraries +!bc pycod +import numpy as np +import matplotlib.pyplot as plt + +import pandas as pd +import seaborn as sns +!ec +and load the Boston Housing DataSet from _Scikit-Learn_ + + +!bc pycod +from sklearn.datasets import load_boston + +boston_dataset = load_boston() + +# boston_dataset is a dictionary +# let's check what it contains +boston_dataset.keys() +!ec +Then we invoke Pandas +!bc pycod +boston = pd.DataFrame(boston_dataset.data, columns=boston_dataset.feature_names) +boston.head() +boston['MEDV'] = boston_dataset.target +!ec +and preprocess the data +!bc pycod +# check for missing values in all the columns +boston.isnull().sum() +!ec +We can then visualize the data +!bc pycod +# set the size of the figure +sns.set(rc={'figure.figsize':(11.7,8.27)}) + +# plot a histogram showing the distribution of the target values +sns.distplot(boston['MEDV'], bins=30) +plt.show() +!ec + +It is now useful to look at the correlation matrix +!bc pycod +# compute the pair wise correlation for all columns +correlation_matrix = boston.corr().round(2) +# use the heatmap function from seaborn to plot the correlation matrix +# annot = True to print the values inside the square +sns.heatmap(data=correlation_matrix, annot=True) +!ec +From the above coorelation plot we can see that _MEDV_ is strongly correlated to _LSTAT_ and _RM_. We see also that _RAD_ and _TAX_ are stronly correlated, but we don't include this in our features together to avoid multi-colinearity + +!bc pycod +plt.figure(figsize=(20, 5)) + +features = ['LSTAT', 'RM'] +target = boston['MEDV'] + +for i, col in enumerate(features): + plt.subplot(1, len(features) , i+1) + x = boston[col] + y = target + plt.scatter(x, y, marker='o') + plt.title(col) + plt.xlabel(col) + plt.ylabel('MEDV') +!ec +Now we start training our model +!bc pycod +X = pd.DataFrame(np.c_[boston['LSTAT'], boston['RM']], columns = ['LSTAT','RM']) +Y = boston['MEDV'] +!ec +We split the data into training and test sets + +!bc pycod +from sklearn.model_selection import train_test_split + +# splits the training and test data set in 80% : 20% +# assign random_state to any value.This ensures consistency. +X_train, X_test, Y_train, Y_test = train_test_split(X, Y, test_size = 0.2, random_state=5) +print(X_train.shape) +print(X_test.shape) +print(Y_train.shape) +print(Y_test.shape) +!ec +Then we use the linear regression functionality from _Scikit-Learn_ +!bc pycod +from sklearn.linear_model import LinearRegression +from sklearn.metrics import mean_squared_error, r2_score + +lin_model = LinearRegression() +lin_model.fit(X_train, Y_train) + +# model evaluation for training set + +y_train_predict = lin_model.predict(X_train) +rmse = (np.sqrt(mean_squared_error(Y_train, y_train_predict))) +r2 = r2_score(Y_train, y_train_predict) + +print("The model performance for training set") +print("--------------------------------------") +print('RMSE is {}'.format(rmse)) +print('R2 score is {}'.format(r2)) +print("\n") + +# model evaluation for testing set + +y_test_predict = lin_model.predict(X_test) +# root mean square error of the model +rmse = (np.sqrt(mean_squared_error(Y_test, y_test_predict))) + +# r-squared score of the model +r2 = r2_score(Y_test, y_test_predict) + +print("The model performance for testing set") +print("--------------------------------------") +print('RMSE is {}'.format(rmse)) +print('R2 score is {}'.format(r2)) +!ec + +!bc pycod +# plotting the y_test vs y_pred +# ideally should have been a straight line +plt.scatter(Y_test, y_test_predict) +plt.show() +!ec + + +!split +===== Reducing the number of degrees of freedom, overarching view ===== +!bblock + +Many Machine Learning problems involve thousands or even millions of +features for each training instance. Not only does this make training +extremely slow, it can also make it much harder to find a good +solution, as we will see. This problem is often referred to as the +curse of dimensionality. Fortunately, in real-world problems, it is +often possible to reduce the number of features considerably, turning +an intractable problem into a tractable one. + +Later we will discuss some of the most popular dimensionality reduction +techniques: the principal component analysis (PCA), Kernel PCA, and +Locally Linear Embedding (LLE). + + +Principal component analysis and its various variants deal with the +problem of fitting a low-dimensional "affine +subspace":"https://en.wikipedia.org/wiki/Affine_space" to a set of of +data points in a high-dimensional space. With its family of methods it +is one of the most used tools in data modeling, compression and +visualization. + +!eblock + + +!split +===== Preprocessing our data ===== +!bblock + +Before we proceed however, we will discuss how to preprocess our +data. Till now and in connection with our previous examples we have +not met so many cases where we are too sensitive to the scaling of our +data. Normally the data may need a rescaling and/or may be sensitive +to extreme values. Scaling the data renders our inputs much more +suitable for the algorithms we want to employ. + +_Scikit-Learn_ has several functions which allow us to rescale the +data, normally resulting in much better results in terms of various +accuracy scores. The _StandardScaler_ function in _Scikit-Learn_ +ensures that for each feature/predictor we study the mean value is +zero and the variance is one (every column in the design/feature +matrix). This scaling has the drawback that it does not ensure that +we have a particular maximum or minimum in our data set. Another +function included in _Scikit-Learn_ is the _MinMaxScaler_ which +ensures that all features are exactly between $0$ and $1$. The + +!split +===== More preprocessing ===== + + +The _Normalizer_ scales each data +point such that the feature vector has a euclidean length of one. In other words, it +projects a data point on the circle (or sphere in the case of higher dimensions) with a +radius of 1. This means every data point is scaled by a different number (by the +inverse of it’s length). +This normalization is often used when only the direction (or angle) of the data matters, +not the length of the feature vector. + +The _RobustScaler_ works similarly to the StandardScaler in that it +ensures statistical properties for each feature that guarantee that +they are on the same scale. However, the RobustScaler uses the median +and quartiles, instead of mean and variance. This makes the +RobustScaler ignore data points that are very different from the rest +(like measurement errors). These odd data points are also called +outliers, and might often lead to trouble for other scaling +techniques. + +!eblock + +!split +===== Simple preprocessing examples, Franke function and regression ===== + +!bc pycod +# Common imports +import os +import numpy as np +import pandas as pd +import matplotlib.pyplot as plt +import sklearn.linear_model as skl +from sklearn.metrics import mean_squared_error +from sklearn.model_selection import train_test_split +from sklearn.preprocessing import MinMaxScaler, StandardScaler, Normalizer + +# Where to save the figures and data files +PROJECT_ROOT_DIR = "Results" +FIGURE_ID = "Results/FigureFiles" +DATA_ID = "DataFiles/" + +if not os.path.exists(PROJECT_ROOT_DIR): + os.mkdir(PROJECT_ROOT_DIR) + +if not os.path.exists(FIGURE_ID): + os.makedirs(FIGURE_ID) + +if not os.path.exists(DATA_ID): + os.makedirs(DATA_ID) + +def image_path(fig_id): + return os.path.join(FIGURE_ID, fig_id) + +def data_path(dat_id): + return os.path.join(DATA_ID, dat_id) + +def save_fig(fig_id): + plt.savefig(image_path(fig_id) + ".png", format='png') + + +def FrankeFunction(x,y): + term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2)) + term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1)) + term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2)) + term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2) + return term1 + term2 + term3 + term4 + + +def create_X(x, y, n ): + if len(x.shape) > 1: + x = np.ravel(x) + y = np.ravel(y) + + N = len(x) + l = int((n+1)*(n+2)/2) # Number of elements in beta + X = np.ones((N,l)) + + for i in range(1,n+1): + q = int((i)*(i+1)/2) + for k in range(i+1): + X[:,q+k] = (x**(i-k))*(y**k) + + return X + + +# Making meshgrid of datapoints and compute Franke's function +n = 5 +N = 1000 +x = np.sort(np.random.uniform(0, 1, N)) +y = np.sort(np.random.uniform(0, 1, N)) +z = FrankeFunction(x, y) +X = create_X(x, y, n=n) +# split in training and test data +X_train, X_test, y_train, y_test = train_test_split(X,z,test_size=0.2) + + +clf = skl.LinearRegression().fit(X_train, y_train) + +# The mean squared error and R2 score +print("MSE before scaling: {:.2f}".format(mean_squared_error(clf.predict(X_test), y_test))) +print("R2 score before scaling {:.2f}".format(clf.score(X_test,y_test))) + +scaler = StandardScaler() +scaler.fit(X_train) +X_train_scaled = scaler.transform(X_train) +X_test_scaled = scaler.transform(X_test) + +print("Feature min values before scaling:\n {}".format(X_train.min(axis=0))) +print("Feature max values before scaling:\n {}".format(X_train.max(axis=0))) + +print("Feature min values after scaling:\n {}".format(X_train_scaled.min(axis=0))) +print("Feature max values after scaling:\n {}".format(X_train_scaled.max(axis=0))) + +clf = skl.LinearRegression().fit(X_train_scaled, y_train) + + +print("MSE after scaling: {:.2f}".format(mean_squared_error(clf.predict(X_test_scaled), y_test))) +print("R2 score for scaled data: {:.2f}".format(clf.score(X_test_scaled,y_test))) + +!ec + + + + + + + +!split +===== The singular value decomposition ===== + +!bblock + +The examples we have looked at so far are cases where we normally can +invert the matrix $\bm{X}^T\bm{X}$. Using a polynomial expansion as we +did both for the masses and the fitting of the equation of state, +leads to row vectors of the design matrix which are essentially +orthogonal due to the polynomial character of our model. Obtaining the inverse of the design matrix is then often done via a so-called LU, QR or Cholesky decomposition. + + + +This may +however not the be case in general and a standard matrix inversion +algorithm based on say LU, QR or Cholesky decomposition may lead to singularities. We will see examples of this below. + +There is however a way to partially circumvent this problem and also gain some insights about the ordinary least squares approach, and later shrinkage methods like Ridge and Lasso regressions. + +This is given by the _Singular Value Decomposition_ algorithm, perhaps +the most powerful linear algebra algorithm. Let us look at a +different example where we may have problems with the standard matrix +inversion algorithm. Thereafter we dive into the math of the SVD. + +!eblock + + + +!split +===== Linear Regression Problems ===== + +One of the typical problems we encounter with linear regression, in particular +when the matrix $\bm{X}$ (our so-called design matrix) is high-dimensional, +are problems with near singular or singular matrices. The column vectors of $\bm{X}$ +may be linearly dependent, normally referred to as super-collinearity. +This means that the matrix may be rank deficient and it is basically impossible to +to model the data using linear regression. As an example, consider the matrix +!bt +\begin{align*} +\mathbf{X} & = \left[ +\begin{array}{rrr} +1 & -1 & 2 +\\ +1 & 0 & 1 +\\ +1 & 2 & -1 +\\ +1 & 1 & 0 +\end{array} \right] +\end{align*} +!et + +The columns of $\bm{X}$ are linearly dependent. We see this easily since the +the first column is the row-wise sum of the other two columns. The rank (more correct, +the column rank) of a matrix is the dimension of the space spanned by the +column vectors. Hence, the rank of $\mathbf{X}$ is equal to the number +of linearly independent columns. In this particular case the matrix has rank 2. + +Super-collinearity of an $(n \times p)$-dimensional design matrix $\mathbf{X}$ implies +that the inverse of the matrix $\bm{X}^T\bm{X}$ (the matrix we need to invert to solve the linear regression equations) is non-invertible. If we have a square matrix that does not have an inverse, we say this matrix singular. The example here demonstrates this +!bt +\begin{align*} +\bm{X} & = \left[ +\begin{array}{rr} +1 & -1 +\\ +1 & -1 +\end{array} \right]. +\end{align*} +!et +We see easily that $\mbox{det}(\bm{X}) = x_{11} x_{22} - x_{12} x_{21} = 1 \times (-1) - 1 \times (-1) = 0$. Hence, $\mathbf{X}$ is singular and its inverse is undefined. +This is equivalent to saying that the matrix $\bm{X}$ has at least an eigenvalue which is zero. + + +!split +===== Fixing the singularity ===== + +If our design matrix $\bm{X}$ which enters the linear regression problem +!bt +\begin{align} +\bm{\beta} & = (\bm{X}^{T} \bm{X})^{-1} \bm{X}^{T} \bm{y}, +\end{align} +!et +has linearly dependent column vectors, we will not be able to compute the inverse +of $\bm{X}^T\bm{X}$ and we cannot find the parameters (estimators) $\beta_i$. +The estimators are only well-defined if $(\bm{X}^{T}\bm{X})^{-1}$ exits. +This is more likely to happen when the matrix $\bm{X}$ is high-dimensional. In this case it is likely to encounter a situation where +the regression parameters $\beta_i$ cannot be estimated. + +A cheap *ad hoc* approach is simply to add a small diagonal component to the matrix to invert, that is we change +!bt +\[ +\bm{X}^{T} \bm{X} \rightarrow \bm{X}^{T} \bm{X}+\lambda \bm{I}, +\] +!et +where $\bm{I}$ is the identity matrix. When we discuss _Ridge_ regression this is actually what we end up evaluating. The parameter $\lambda$ is called a hyperparameter. More about this later. + + + +!split +===== Basic math of the SVD ===== + + +From standard linear algebra we know that a square matrix $\bm{X}$ can be diagonalized if and only it is +a so-called "normal matrix":"https://en.wikipedia.org/wiki/Normal_matrix", that is if $\bm{X}\in {\mathbb{R}}^{n\times n}$ +we have $\bm{X}\bm{X}^T=\bm{X}^T\bm{X}$ or if $\bm{X}\in {\mathbb{C}}^{n\times n}$ we have $\bm{X}\bm{X}^{\dagger}=\bm{X}^{\dagger}\bm{X}$. +The matrix has then a set of eigenpairs + +!bt +\[ +(\lambda_1,\bm{u}_1),\dots, (\lambda_n,\bm{u}_n), +!et +and the eigenvalues are given by the diagonal matrix +!bt +\[ +\bm{\Sigma}=\mathrm{Diag}(\lambda_1, \dots,\lambda_n). +\] +!et +The matrix $\bm{X}$ can be written in terms of an orthogonal/unitary transformation $\bm{U}$ +!bt +\[ +\bm{X} = \bm{U}\bm{\Sigma}\bm{V}^T, +\] +!et +with $\bm{U}\bm{U}^T=\bm{I}$ or $\bm{U}\bm{U}^{\dagger}=\bm{I}$. + +Not all square matrices are diagonalizable. A matrix like the one discussed above +!bt +\[ +\bm{X} = \begin{bmatrix} +1& -1 \\ +1& -1\\ +\end{bmatrix} +\] +!et +is not diagonalizable, it is a so-called "defective matrix":"https://en.wikipedia.org/wiki/Defective_matrix". It is easy to see that the condition +$\bm{X}\bm{X}^T=\bm{X}^T\bm{X}$ is not fulfilled. + + +!split +===== The SVD, a Fantastic Algorithm ===== + + +However, and this is the strength of the SVD algorithm, any general +matrix $\bm{X}$ can be decomposed in terms of a diagonal matrix and +two orthogonal/unitary matrices. The "Singular Value Decompostion +(SVD) theorem":"https://en.wikipedia.org/wiki/Singular_value_decomposition" +states that a general $m\times n$ matrix $\bm{X}$ can be written in +terms of a diagonal matrix $\bm{\Sigma}$ of dimensionality $m\times n$ +and two orthognal matrices $\bm{U}$ and $\bm{V}$, where the first has +dimensionality $m \times m$ and the last dimensionality $n\times n$. +We have then + +!bt +\[ +\bm{X} = \bm{U}\bm{\Sigma}\bm{V}^T +\] +!et + +As an example, the above defective matrix can be decomposed as + +!bt +\[ +\bm{X} = \frac{1}{\sqrt{2}}\begin{bmatrix} 1& 1 \\ 1& -1\\ \end{bmatrix} \begin{bmatrix} 2& 0 \\ 0& 0\\ \end{bmatrix} \frac{1}{\sqrt{2}}\begin{bmatrix} 1& -1 \\ 1& 1\\ \end{bmatrix}=\bm{U}\bm{\Sigma}\bm{V}^T, +\] +!et + +with eigenvalues $\sigma_1=2$ and $\sigma_2=0$. +The SVD exits always! + +The SVD +decomposition (singular values) gives eigenvalues +$\sigma_i\geq\sigma_{i+1}$ for all $i$ and for dimensions larger than $i=p$, the +eigenvalues (singular values) are zero. + +In the general case, where our design matrix $\bm{X}$ has dimension +$n\times p$, the matrix is thus decomposed into an $n\times n$ +orthogonal matrix $\bm{U}$, a $p\times p$ orthogonal matrix $\bm{V}$ +and a diagonal matrix $\bm{\Sigma}$ with $r=\mathrm{min}(n,p)$ +singular values $\sigma_i\geq 0$ on the main diagonal and zeros filling +the rest of the matrix. There are at most $p$ singular values +assuming that $n > p$. In our regression examples for the nuclear +masses and the equation of state this is indeed the case, while for +the Ising model we have $p > n$. These are often cases that lead to +near singular or singular matrices. + +The columns of $\bm{U}$ are called the left singular vectors while the columns of $\bm{V}$ are the right singular vectors. + +!split +===== Economy-size SVD ===== + +If we assume that $n > p$, then our matrix $\bm{U}$ has dimension $n +\times n$. The last $n-p$ columns of $\bm{U}$ become however +irrelevant in our calculations since they are multiplied with the +zeros in $\bm{\Sigma}$. + +The economy-size decomposition removes extra rows or columns of zeros +from the diagonal matrix of singular values, $\bm{\Sigma}$, along with the columns +in either $\bm{U}$ or $\bm{V}$ that multiply those zeros in the expression. +Removing these zeros and columns can improve execution time +and reduce storage requirements without compromising the accuracy of +the decomposition. + +If $n > p$, we keep only the first $p$ columns of $\bm{U}$ and $\bm{\Sigma}$ has dimension $p\times p$. +If $p > n$, then only the first $n$ columns of $\bm{V}$ are computed and $\bm{\Sigma}$ has dimension $n\times n$. +The $n=p$ case is obvious, we retain the full SVD. +In general the economy-size SVD leads to less FLOPS and still conserving the desired accuracy. + +!split +===== Codes for the SVD ===== + +!bc pycod +import numpy as np +# SVD inversion +def SVDinv(A): + ''' Takes as input a numpy matrix A and returns inv(A) based on singular value decomposition (SVD). + SVD is numerically more stable than the inversion algorithms provided by + numpy and scipy.linalg at the cost of being slower. + ''' + U, s, VT = np.linalg.svd(A) +# print('test U') +# print( (np.transpose(U) @ U - U @np.transpose(U))) +# print('test VT') +# print( (np.transpose(VT) @ VT - VT @np.transpose(VT))) + print(U) + print(s) + print(VT) + + D = np.zeros((len(U),len(VT))) + for i in range(0,len(VT)): + D[i,i]=s[i] + UT = np.transpose(U); V = np.transpose(VT); invD = np.linalg.inv(D) + return np.matmul(V,np.matmul(invD,UT)) + + +X = np.array([ [1.0, -1.0, 2.0], [1.0, 0.0, 1.0], [1.0, 2.0, -1.0], [1.0, 1.0, 0.0] ]) +print(X) +A = np.transpose(X) @ X +print(A) +# Brute force inversion of super-collinear matrix +#B = np.linalg.inv(A) +#print(B) +C = SVDinv(A) +print(C) + +!ec + +The matrix $\bm{X}$ has columns that are linearly dependent. The first +column is the row-wise sum of the other two columns. The rank of a +matrix (the column rank) is the dimension of space spanned by the +column vectors. The rank of the matrix is the number of linearly +independent columns, in this case just $2$. We see this from the +singular values when running the above code. Running the standard +inversion algorithm for matrix inversion with $\bm{X}^T\bm{X}$ results +in the program terminating due to a singular matrix. + + + +!split +===== Mathematical Properties ===== + +There are several interesting mathematical properties which will be +relevant when we are going to discuss the differences between say +ordinary least squares (OLS) and _Ridge_ regression. + +We have from OLS that the parameters of the linear approximation are given by +!bt +\[ +\bm{\tilde{y}} = \bm{X}\bm{\beta} = \bm{X}\left(\bm{X}^T\bm{X}\right)^{-1}\bm{X}^T\bm{y}. +\] +!et + +The matrix to invert can be rewritten in terms of our SVD decomposition as + +!bt +\[ +\bm{X}^T\bm{X} = \bm{V}\bm{\Sigma}^T\bm{U}^T\bm{U}\bm{\Sigma}\bm{V}^T. +\] +!et +Using the orthogonality properties of $\bm{U}$ we have + +!bt +\[ +\bm{X}^T\bm{X} = \bm{V}\bm{\Sigma}^T\bm{\Sigma}\bm{V}^T = \bm{V}\bm{D}\bm{V}^T, +\] +!et +with $\bm{D}$ being a diagonal matrix with values along the diagonal given by the singular values squared. + +This means that +!bt +\[ +(\bm{X}^T\bm{X})\bm{V} = \bm{V}\bm{D}, +\] +!et +that is the eigenvectors of $(\bm{X}^T\bm{X})$ are given by the columns of the right singular matrix of $\bm{X}$ and the eigenvalues are the squared singular values. It is easy to show (show this) that +!bt +\[ +(\bm{X}\bm{X}^T)\bm{U} = \bm{U}\bm{D}, +\] +!et +that is, the eigenvectors of $(\bm{X}\bm{X})^T$ are the columns of the left singular matrix and the eigenvalues are the same. + +Going back to our OLS equation we have +!bt +\[ +\bm{X}\bm{\beta} = \bm{X}\left(\bm{V}\bm{D}\bm{V}^T \right)^{-1}\bm{X}^T\bm{y}=\bm{U\Sigma V^T}\left(\bm{V}\bm{D}\bm{V}^T \right)^{-1}(\bm{U\Sigma V^T})^T\bm{y}=\bm{U}\bm{U}^T\bm{y}. +\] +!et +We will come back to this expression when we discuss Ridge regression. + + +$$ \tilde{y}^{OLS}=\bm{X}\hat{\beta}^{OLS}=\sum_{j=1}^p \bm{u}_j\bm{u}_j^T\bm{y}$$ and for Ridge we have  + +$$ \tilde{y}^{Ridge}=\bm{X}\hat{\beta}^{Ridge}=\sum_{j=1}^p \bm{u}_j\frac{\sigma_j^2}{\sigma_j^2+\lambda}\bm{u}_j^T\bm{y}$$ .  + +It is indeed the economy-sized SVD, note the summation runs up tp $$p$$ only and not $$n$$.  + +Here we have that $$\bm{X} = \bm{U}\bm{\Sigma}\bm{V}^T$$, with $$\Sigma$$ being an $$ n\times p$$ matrix and $$\bm{V}$$ being a $$ p\times p$$ matrix. We also have assumed here that $$ n > p$$.  + + +!split +===== Ridge and LASSO Regression ===== + +Let us remind ourselves about the expression for the standard Mean Squared Error (MSE) which we used to define our cost function and the equations for the ordinary least squares (OLS) method, that is +our optimization problem is +!bt +\[ +{\displaystyle \min_{\bm{\beta}\in {\mathbb{R}}^{p}}}\frac{1}{n}\left\{\left(\bm{y}-\bm{X}\bm{\beta}\right)^T\left(\bm{y}-\bm{X}\bm{\beta}\right)\right\}. +\] +!et +or we can state it as +!bt +\[ +{\displaystyle \min_{\bm{\beta}\in +{\mathbb{R}}^{p}}}\frac{1}{n}\sum_{i=0}^{n-1}\left(y_i-\tilde{y}_i\right)^2=\frac{1}{n}\vert\vert \bm{y}-\bm{X}\bm{\beta}\vert\vert_2^2, +\] +!et +where we have used the definition of a norm-2 vector, that is +!bt +\[ +\vert\vert \bm{x}\vert\vert_2 = \sqrt{\sum_i x_i^2}. +\] +!et + +By minimizing the above equation with respect to the parameters +$\bm{\beta}$ we could then obtain an analytical expression for the +parameters $\bm{\beta}$. We can add a regularization parameter $\lambda$ by +defining a new cost function to be optimized, that is + +!bt +\[ +{\displaystyle \min_{\bm{\beta}\in +{\mathbb{R}}^{p}}}\frac{1}{n}\vert\vert \bm{y}-\bm{X}\bm{\beta}\vert\vert_2^2+\lambda\vert\vert \bm{\beta}\vert\vert_2^2 +\] +!et + +which leads to the Ridge regression minimization problem where we +require that $\vert\vert \bm{\beta}\vert\vert_2^2\le t$, where $t$ is +a finite number larger than zero. By defining + +!bt +\[ +C(\bm{X},\bm{\beta})=\frac{1}{n}\vert\vert \bm{y}-\bm{X}\bm{\beta}\vert\vert_2^2+\lambda\vert\vert \bm{\beta}\vert\vert_1, +\] +!et + +we have a new optimization equation +!bt +\[ +{\displaystyle \min_{\bm{\beta}\in +{\mathbb{R}}^{p}}}\frac{1}{n}\vert\vert \bm{y}-\bm{X}\bm{\beta}\vert\vert_2^2+\lambda\vert\vert \bm{\beta}\vert\vert_1 +\] +!et +which leads to Lasso regression. Lasso stands for least absolute shrinkage and selection operator. + +Here we have defined the norm-1 as +!bt +\[ +\vert\vert \bm{x}\vert\vert_1 = \sum_i \vert x_i\vert. +\] +!et + + +!split +===== More on Ridge Regression ===== + +Using the matrix-vector expression for Ridge regression, + +!bt +\[ +C(\bm{X},\bm{\beta})=\frac{1}{n}\left\{(\bm{y}-\bm{X}\bm{\beta})^T(\bm{y}-\bm{X}\bm{\beta})\right\}+\lambda\bm{\beta}^T\bm{\beta}, +\] +!et + +by taking the derivatives with respect to $\bm{\beta}$ we obtain then +a slightly modified matrix inversion problem which for finite values +of $\lambda$ does not suffer from singularity problems. We obtain + +!bt +\[ +\bm{\beta}^{\mathrm{Ridge}} = \left(\bm{X}^T\bm{X}+\lambda\bm{I}\right)^{-1}\bm{X}^T\bm{y}, +\] +!et + +with $\bm{I}$ being a $p\times p$ identity matrix with the constraint that + +!bt +\[ +\sum_{i=0}^{p-1} \beta_i^2 \leq t, +\] +!et + +with $t$ a finite positive number. + +We see that Ridge regression is nothing but the standard +OLS with a modified diagonal term added to $\bm{X}^T\bm{X}$. The +consequences, in particular for our discussion of the bias-variance tradeoff +are rather interesting. + +Furthermore, if we use the result above in terms of the SVD decomposition (our analysis was done for the OLS method), we had +!bt +\[ +(\bm{X}\bm{X}^T)\bm{U} = \bm{U}\bm{D}. +\] +!et + +We can analyse the OLS solutions in terms of the eigenvectors (the columns) of the right singular value matrix $\bm{U}$ as +!bt +\[ +\bm{X}\bm{\beta} = \bm{X}\left(\bm{V}\bm{D}\bm{V}^T \right)^{-1}\bm{X}^T\bm{y}=\bm{U\Sigma V^T}\left(\bm{V}\bm{D}\bm{V}^T \right)^{-1}(\bm{U\Sigma V^T})^T\bm{y}=\bm{U}\bm{U}^T\bm{y} +\] +!et + + +For Ridge regression this becomes + +!bt +\[ +\bm{X}\bm{\beta}^{\mathrm{Ridge}} = \bm{U\Sigma V^T}\left(\bm{V}\bm{D}\bm{V}^T+\lambda\bm{I} \right)^{-1}(\bm{U\Sigma V^T})^T\bm{y}=\sum_{j=0}^{p-1}\bm{u}_j\bm{u}_j^T\frac{\sigma_j^2}{\sigma_j^2+\lambda}\bm{y}, +\] +!et + +with the vectors $\bm{u}_j$ being the columns of $\bm{U}$. + +!split +===== Interpreting the Ridge results ===== + +Since $\lambda \geq 0$, it means that compared to OLS, we have + +!bt +\[ +\frac{\sigma_j^2}{\sigma_j^2+\lambda} \leq 1. +\] +!et + +Ridge regression finds the coordinates of $\bm{y}$ with respect to the +orthonormal basis $\bm{U}$, it then shrinks the coordinates by +$\frac{\sigma_j^2}{\sigma_j^2+\lambda}$. Recall that the SVD has +eigenvalues ordered in a descending way, that is $\sigma_i \geq +\sigma_{i+1}$. + +For small eigenvalues $\sigma_i$ it means that their contributions become less important, a fact which can be used to reduce the number of degrees of freedom. +Actually, calculating the variance of $\bm{X}\bm{v}_j$ shows that this quantity is equal to $\sigma_j^2/n$. +With a parameter $\lambda$ we can thus shrink the role of specific parameters. + + +!split +===== More interpretations ===== + +For the sake of simplicity, let us assume that the design matrix is orthonormal, that is + +!bt +\[ +\bm{X}^T\bm{X}=(\bm{X}^T\bm{X})^{-1} =\bm{I}. +\] +!et + +In this case the standard OLS results in +!bt +\[ +\bm{\beta}^{\mathrm{OLS}} = \bm{X}^T\bm{y}=\sum_{i=0}^{p-1}\bm{u}_j\bm{u}_j^T\bm{y}, +\] +!et + +and + +!bt +\[ +\bm{\beta}^{\mathrm{Ridge}} = \left(\bm{I}+\lambda\bm{I}\right)^{-1}\bm{X}^T\bm{y}=\left(1+\lambda\right)^{-1}\bm{\beta}^{\mathrm{OLS}}, +\] +!et + +that is the Ridge estimator scales the OLS estimator by the inverse of a factor $1+\lambda$, and +the Ridge estimator converges to zero when the hyperparameter goes to +infinity. + +We will come back to more interpreations after we have gone through some of the statistical analysis part. + +For more discussions of Ridge and Lasso regression, "Wessel van Wieringen's":"https://arxiv.org/abs/1509.09169" article is highly recommended. +Similarly, "Mehta et al's article":"https://arxiv.org/abs/1803.08823" is also recommended. + + +!split +===== A better understanding of regularization ===== + +The parameter $\lambda$ that we have introduced in the Ridge (and +Lasso as well) regression is often called a regularization parameter +or shrinkage parameter. It is common to call it a hyperparameter. What does it mean mathemtically? + +Here we will first look at how to analyze the difference between the +standard OLS equations and the Ridge expressions in terms of a linear +algebra analysis using the SVD algorithm. Thereafter, we will link +(see the material on the bias-variance tradeoff below) these +observation to the statisical analysis of the results. In particular +we consider how the variance of the parameters $\bm{\beta}$ is +affected by changing the parameter $\lambda$. + +!split +===== Decomposing the OLS and Ridge expressions ===== + +We have our design matrix + $\bm{X}\in {\mathbb{R}}^{n\times p}$. With the SVD we decompose it as + +!bt +\[ +\bm{X} = \bm{U\Sigma V^T}, +\] +!et + +with $\bm{U}\in {\mathbb{R}}^{n\times n}$, $\bm{\Sigma}\in {\mathbb{R}}^{n\times p}$ +and $\bm{V}\in {\mathbb{R}}^{p\times p}$. + +The matrices $\bm{U}$ and $\bm{V}$ are unitary/orthonormal matrices, that is in case the matrices are real we have $\bm{U}^T\bm{U}=\bm{U}\bm{U}^T=\bm{I}$ and $\bm{V}^T\bm{V}=\bm{V}\bm{V}^T=\bm{I}$. + + + +!split +===== Introducing the Covariance and Correlation functions ===== + +Before we discuss the link between for example Ridge regression and the singular value decomposition, we need to remind ourselves about +the definition of the covariance and the correlation function. These are quantities + +Suppose we have defined two vectors +$\hat{x}$ and $\hat{y}$ with $n$ elements each. The covariance matrix $\bm{C}$ is defined as +!bt +\[ +\bm{C}[\bm{x},\bm{y}] = \begin{bmatrix} \mathrm{cov}[\bm{x},\bm{x}] & \mathrm{cov}[\bm{x},\bm{y}] \\ + \mathrm{cov}[\bm{y},\bm{x}] & \mathrm{cov}[\bm{y},\bm{y}] \\ + \end{bmatrix}, +\] +!et +where for example +!bt +\[ +\mathrm{cov}[\bm{x},\bm{y}] =\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})(y_i- \overline{y}). +\] +!et +With this definition and recalling that the variance is defined as +!bt +\[ +\mathrm{var}[\bm{x}]=\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})^2, +\] +!et +we can rewrite the covariance matrix as +!bt +\[ +\bm{C}[\bm{x},\bm{y}] = \begin{bmatrix} \mathrm{var}[\bm{x}] & \mathrm{cov}[\bm{x},\bm{y}] \\ + \mathrm{cov}[\bm{x},\bm{y}] & \mathrm{var}[\bm{y}] \\ + \end{bmatrix}. +\] +!et + +The covariance takes values between zero and infinity and may thus +lead to problems with loss of numerical precision for particularly +large values. It is common to scale the covariance matrix by +introducing instead the correlation matrix defined via the so-called +correlation function + +!bt +\[ +\mathrm{corr}[\bm{x},\bm{y}]=\frac{\mathrm{cov}[\bm{x},\bm{y}]}{\sqrt{\mathrm{var}[\bm{x}] \mathrm{var}[\bm{y}]}}. +\] +!et + +The correlation function is then given by values $\mathrm{corr}[\bm{x},\bm{y}] +\in [-1,1]$. This avoids eventual problems with too large values. We +can then define the correlation matrix for the two vectors $\bm{x}$ +and $\bm{y}$ as + +!bt +\[ +\bm{K}[\bm{x},\bm{y}] = \begin{bmatrix} 1 & \mathrm{corr}[\bm{x},\bm{y}] \\ + \mathrm{corr}[\bm{y},\bm{x}] & 1 \\ + \end{bmatrix}, +\] +!et + +In the above example this is the function we constructed using _pandas_. + +!split +===== Correlation Function and Design/Feature Matrix ===== + +In our derivation of the various regression algorithms like _Ordinary Least Squares_ or _Ridge regression_ +we defined the design/feature matrix $\bm{X}$ as + +!bt +\[ +\bm{X}=\begin{bmatrix} +x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ +x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ +x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ +\dots & \dots & \dots & \dots \dots & \dots \\ +x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ +x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ +\end{bmatrix}, +\] +!et +with $\bm{X}\in {\mathbb{R}}^{n\times p}$, with the predictors/features $p$ refering to the column numbers and the +entries $n$ being the row elements. +We can rewrite the design/feature matrix in terms of its column vectors as +!bt +\[ +\bm{X}=\begin{bmatrix} \bm{x}_0 & \bm{x}_1 & \bm{x}_2 & \dots & \dots & \bm{x}_{p-1}\end{bmatrix}, +\] +!et +with a given vector +!bt +\[ +\bm{x}_i^T = \begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \dots & \dots x_{n-1,i}\end{bmatrix}. +\] +!et + +With these definitions, we can now rewrite our $2\times 2$ +correaltion/covariance matrix in terms of a moe general design/feature +matrix $\bm{X}\in {\mathbb{R}}^{n\times p}$. This leads to a $p\times p$ +covariance matrix for the vectors $\bm{x}_i$ with $i=0,1,\dots,p-1$ + +!bt +\[ +\bm{C}[\bm{x}] = \begin{bmatrix} +\mathrm{var}[\bm{x}_0] & \mathrm{cov}[\bm{x}_0,\bm{x}_1] & \mathrm{cov}[\bm{x}_0,\bm{x}_2] & \dots & \dots & \mathrm{cov}[\bm{x}_0,\bm{x}_{p-1}]\\ +\mathrm{cov}[\bm{x}_1,\bm{x}_0] & \mathrm{var}[\bm{x}_1] & \mathrm{cov}[\bm{x}_1,\bm{x}_2] & \dots & \dots & \mathrm{cov}[\bm{x}_1,\bm{x}_{p-1}]\\ +\mathrm{cov}[\bm{x}_2,\bm{x}_0] & \mathrm{cov}[\bm{x}_2,\bm{x}_1] & \mathrm{var}[\bm{x}_2] & \dots & \dots & \mathrm{cov}[\bm{x}_2,\bm{x}_{p-1}]\\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\mathrm{cov}[\bm{x}_{p-1},\bm{x}_0] & \mathrm{cov}[\bm{x}_{p-1},\bm{x}_1] & \mathrm{cov}[\bm{x}_{p-1},\bm{x}_{2}] & \dots & \dots & \mathrm{var}[\bm{x}_{p-1}]\\ +\end{bmatrix}, +\] +!et +and the correlation matrix +!bt +\[ +\bm{K}[\bm{x}] = \begin{bmatrix} +1 & \mathrm{corr}[\bm{x}_0,\bm{x}_1] & \mathrm{corr}[\bm{x}_0,\bm{x}_2] & \dots & \dots & \mathrm{corr}[\bm{x}_0,\bm{x}_{p-1}]\\ +\mathrm{corr}[\bm{x}_1,\bm{x}_0] & 1 & \mathrm{corr}[\bm{x}_1,\bm{x}_2] & \dots & \dots & \mathrm{corr}[\bm{x}_1,\bm{x}_{p-1}]\\ +\mathrm{corr}[\bm{x}_2,\bm{x}_0] & \mathrm{corr}[\bm{x}_2,\bm{x}_1] & 1 & \dots & \dots & \mathrm{corr}[\bm{x}_2,\bm{x}_{p-1}]\\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots & \dots \\ +\mathrm{corr}[\bm{x}_{p-1},\bm{x}_0] & \mathrm{corr}[\bm{x}_{p-1},\bm{x}_1] & \mathrm{corr}[\bm{x}_{p-1},\bm{x}_{2}] & \dots & \dots & 1\\ +\end{bmatrix}, +\] +!et + + +!split +===== Covariance Matrix Examples ===== + + +The Numpy function _np.cov_ calculates the covariance elements using +the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have +the exact mean values. The following simple function uses the +_np.vstack_ function which takes each vector of dimension $1\times n$ +and produces a $2\times n$ matrix $\bm{W}$ + + +!bt +\[ +\bm{W} = \begin{bmatrix} x_0 & y_0 \\ + x_1 & y_1 \\ + x_2 & y_2\\ + \dots & \dots \\ + x_{n-2} & y_{n-2}\\ + x_{n-1} & y_{n-1} & + \end{bmatrix}, +\] +!et + +which in turn is converted into into the $2\times 2$ covariance matrix +$\bm{C}$ via the Numpy function _np.cov()_. We note that we can also calculate +the mean value of each set of samples $\bm{x}$ etc using the Numpy +function _np.mean(x)_. We can also extract the eigenvalues of the +covariance matrix through the _np.linalg.eig()_ function. + +!bc pycod +# Importing various packages +import numpy as np +n = 100 +x = np.random.normal(size=n) +print(np.mean(x)) +y = 4+3*x+np.random.normal(size=n) +print(np.mean(y)) +W = np.vstack((x, y)) +C = np.cov(W) +print(C) +!ec + +!split +===== Correlation Matrix ===== + +The previous example can be converted into the correlation matrix by +simply scaling the matrix elements with the variances. We should also +subtract the mean values for each column. This leads to the following +code which sets up the correlations matrix for the previous example in +a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the $2\times 2$ correlation matrix (since we have only two vectors). + +!bc pycod +import numpy as np +n = 100 +# define two vectors +x = np.random.random(size=n) +y = 4+3*x+np.random.normal(size=n) +#scaling the x and y vectors +x = x - np.mean(x) +y = y - np.mean(y) +variance_x = np.sum(x@x)/n +variance_y = np.sum(y@y)/n +print(variance_x) +print(variance_y) +cov_xy = np.sum(x@y)/n +cov_xx = np.sum(x@x)/n +cov_yy = np.sum(y@y)/n +C = np.zeros((2,2)) +C[0,0]= cov_xx/variance_x +C[1,1]= cov_yy/variance_y +C[0,1]= cov_xy/np.sqrt(variance_y*variance_x) +C[1,0]= C[0,1] +print(C) +!ec + +We see that the matrix elements along the diagonal are one as they +should be and that the matrix is symmetric. Furthermore, diagonalizing +this matrix we easily see that it is a positive definite matrix. + +The above procedure with _numpy_ can be made more compact if we use _pandas_. + +!split +===== Correlation Matrix with Pandas ===== + +We whow here how we can set up the correlation matrix using _pandas_, as done in this simple code +!bc pycod +import numpy as np +import pandas as pd +n = 10 +x = np.random.normal(size=n) +x = x - np.mean(x) +y = 4+3*x+np.random.normal(size=n) +y = y - np.mean(y) +X = (np.vstack((x, y))).T +print(X) +Xpd = pd.DataFrame(X) +print(Xpd) +correlation_matrix = Xpd.corr() +print(correlation_matrix) +!ec + + +We expand this model to the Franke function discussed above. + +!split +===== Correlation Matrix with Pandas and the Franke function ===== + +!bc pycod +# Common imports +import numpy as np +import pandas as pd + + +def FrankeFunction(x,y): + term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2)) + term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1)) + term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2)) + term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2) + return term1 + term2 + term3 + term4 + + +def create_X(x, y, n ): + if len(x.shape) > 1: + x = np.ravel(x) + y = np.ravel(y) + + N = len(x) + l = int((n+1)*(n+2)/2) # Number of elements in beta + X = np.ones((N,l)) + + for i in range(1,n+1): + q = int((i)*(i+1)/2) + for k in range(i+1): + X[:,q+k] = (x**(i-k))*(y**k) + + return X + + +# Making meshgrid of datapoints and compute Franke's function +n = 4 +N = 100 +x = np.sort(np.random.uniform(0, 1, N)) +y = np.sort(np.random.uniform(0, 1, N)) +z = FrankeFunction(x, y) +X = create_X(x, y, n=n) + +Xpd = pd.DataFrame(X) +# subtract the mean values and set up the covariance matrix +Xpd = Xpd - Xpd.mean() +covariance_matrix = Xpd.cov() +print(covariance_matrix) +!ec + +We note here that the covariance is zero for the first rows and +columns since all matrix elements in the design matrix were set to one +(we are fitting the function in terms of a polynomial of degree $n$). + +This means that the variance for these elements will be zero and will +cause problems when we set up the correlation matrix. We can simply +drop these elements and construct a correlation +matrix without these elements. + + +!split +===== Rewriting the Covariance and/or Correlation Matrix ===== + +We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix $\bm{X}$ as +!bt +\[ +\bm{C}[\bm{x}] = \frac{1}{n}\bm{X}^T\bm{X}= \mathbb{E}[\bm{X}^T\bm{X}]. +\] +!et + +To see this let us simply look at a design matrix $\bm{X}\in {\mathbb{R}}^{2\times 2}$ +!bt +\[ +\bm{X}=\begin{bmatrix} +x_{00} & x_{01}\\ +x_{10} & x_{11}\\ +\end{bmatrix}=\begin{bmatrix} +\bm{x}_{0} & \bm{x}_{1}\\ +\end{bmatrix}. +\] +!et + +If we then compute the expectation value +!bt +\[ +\mathbb{E}[\bm{X}^T\bm{X}] = \frac{1}{n}\bm{X}^T\bm{X}=\begin{bmatrix} +x_{00}^2+x_{01}^2 & x_{00}x_{10}+x_{01}x_{11}\\ +x_{10}x_{00}+x_{11}x_{01} & x_{10}^2+x_{11}^2\\ +\end{bmatrix}, +\] +!et +which is just +!bt +\[ +\bm{C}[\bm{x}_0,\bm{x}_1] = \bm{C}[\bm{x}]=\begin{bmatrix} \mathrm{var}[\bm{x}_0] & \mathrm{cov}[\bm{x}_0,\bm{x}_1] \\ + \mathrm{cov}[\bm{x}_1,\bm{x}_0] & \mathrm{var}[\bm{x}_1] \\ + \end{bmatrix}, +\] +!et +where we wrote $$\bm{C}[\bm{x}_0,\bm{x}_1] = \bm{C}[\bm{x}]$$ to indicate that this the covariance of the vectors $\bm{x}$ of the design/feature matrix $\bm{X}$. + +It is easy to generalize this to a matrix $\bm{X}\in {\mathbb{R}}^{n\times p}$. + + +!split +===== Linking with SVD ===== + +See lecture september 11. More text to be added here soon. + + + + +!split +===== Where are we going? ===== + +Before we proceed, we need to rethink what we have been doing. In our +eager to fit the data, we have omitted several important elements in +our regression analysis. In what follows we will +o look at statistical properties, including a discussion of mean values, variance and the so-called bias-variance tradeoff +o introduce resampling techniques like cross-validation, bootstrapping and jackknife and more + +This will allow us to link the standard linear algebra methods we have discussed above to a statistical interpretation of the methods. + + + + + +!split +===== Resampling methods ===== +!bblock +Resampling methods are an indispensable tool in modern +statistics. They involve repeatedly drawing samples from a training +set and refitting a model of interest on each sample in order to +obtain additional information about the fitted model. For example, in +order to estimate the variability of a linear regression fit, we can +repeatedly draw different samples from the training data, fit a linear +regression to each new sample, and then examine the extent to which +the resulting fits differ. Such an approach may allow us to obtain +information that would not be available from fitting the model only +once using the original training sample. + +Two resampling methods are often used in Machine Learning analyses, +o The _bootstrap method_ +o and _Cross-Validation_ + +In addition there are several other methods such as the Jackknife and the Blocking methods. We will discuss in particular +cross-validation and the bootstrap method. + + +!eblock + + +!split +===== Resampling approaches can be computationally expensive ===== +!bblock + +Resampling approaches can be computationally expensive, because they +involve fitting the same statistical method multiple times using +different subsets of the training data. However, due to recent +advances in computing power, the computational requirements of +resampling methods generally are not prohibitive. In this chapter, we +discuss two of the most commonly used resampling methods, +cross-validation and the bootstrap. Both methods are important tools +in the practical application of many statistical learning +procedures. For example, cross-validation can be used to estimate the +test error associated with a given statistical learning method in +order to evaluate its performance, or to select the appropriate level +of flexibility. The process of evaluating a model’s performance is +known as model assessment, whereas the process of selecting the proper +level of flexibility for a model is known as model selection. The +bootstrap is widely used. + +!eblock + +!split +===== Why resampling methods ? ===== +!bblock Statistical analysis + +* Our simulations can be treated as *computer experiments*. This is particularly the case for Monte Carlo methods +* The results can be analysed with the same statistical tools as we would use analysing experimental data. +* As in all experiments, we are looking for expectation values and an estimate of how accurate they are, i.e., possible sources for errors. + + +!eblock + +!split +===== Statistical analysis ===== +!bblock + +* As in other experiments, many numerical experiments have two classes of errors: + * Statistical errors + * Systematical errors +* Statistical errors can be estimated using standard tools from statistics +* Systematical errors are method specific and must be treated differently from case to case. +!eblock + + + + +!split +===== Linking the regression analysis with a statistical interpretation ===== + + +The +advantage of doing linear regression is that we actually end up with +analytical expressions for several statistical quantities. +Standard least squares and Ridge regression allow us to +derive quantities like the variance and other expectation values in a +rather straightforward way. + + +It is assumed that $\varepsilon_i +\sim \mathcal{N}(0, \sigma^2)$ and the $\varepsilon_{i}$ are +independent, i.e.: +!bt +\begin{align*} +\mbox{Cov}(\varepsilon_{i_1}, +\varepsilon_{i_2}) & = \left\{ \begin{array}{lcc} \sigma^2 & \mbox{if} +& i_1 = i_2, \\ 0 & \mbox{if} & i_1 \not= i_2. \end{array} \right. +\end{align*} +!et +The randomness of $\varepsilon_i$ implies that +$\mathbf{y}_i$ is also a random variable. In particular, +$\mathbf{y}_i$ is normally distributed, because $\varepsilon_i \sim +\mathcal{N}(0, \sigma^2)$ and $\mathbf{X}_{i,\ast} \, \bm{\beta}$ is a +non-random scalar. To specify the parameters of the distribution of +$\mathbf{y}_i$ we need to calculate its first two moments. + +Recall that $\bm{X}$ is a matrix of dimensionality $n\times p$. The +notation above $\mathbf{X}_{i,\ast}$ means that we are looking at the +row number $i$ and perform a sum over all values $p$. + + +!split +===== Assumptions made ===== + +The assumption we have made here can be summarized as (and this is going to be useful when we discuss the bias-variance trade off) +that there exists a function $f(\bm{x})$ and a normal distributed error $\bm{\varepsilon}\sim \mathcal{N}(0, \sigma^2)$ +which describe our data +!bt +\[ +\bm{y} = f(\bm{x})+\bm{\varepsilon} +\] +!et + +We approximate this function with our model from the solution of the linear regression equations, that is our +function $f$ is approximated by $\bm{\tilde{y}}$ where we want to minimize $(\bm{y}-\bm{\tilde{y}})^2$, our MSE, with +!bt +\[ +\bm{\tilde{y}} = \bm{X}\bm{\beta}. +\] +!et + +!split +===== Expectation value and variance ===== + +We can calculate the expectation value of $\bm{y}$ for a given element $i$ +!bt +\begin{align*} +\mathbb{E}(y_i) & = +\mathbb{E}(\mathbf{X}_{i, \ast} \, \bm{\beta}) + \mathbb{E}(\varepsilon_i) +\, \, \, = \, \, \, \mathbf{X}_{i, \ast} \, \beta, +\end{align*} +!et +while +its variance is +!bt +\begin{align*} \mbox{Var}(y_i) & = \mathbb{E} \{ [y_i +- \mathbb{E}(y_i)]^2 \} \, \, \, = \, \, \, \mathbb{E} ( y_i^2 ) - +[\mathbb{E}(y_i)]^2 \\ & = \mathbb{E} [ ( \mathbf{X}_{i, \ast} \, +\beta + \varepsilon_i )^2] - ( \mathbf{X}_{i, \ast} \, \bm{\beta})^2 \\ & += \mathbb{E} [ ( \mathbf{X}_{i, \ast} \, \bm{\beta})^2 + 2 \varepsilon_i +\mathbf{X}_{i, \ast} \, \bm{\beta} + \varepsilon_i^2 ] - ( \mathbf{X}_{i, +\ast} \, \beta)^2 \\ & = ( \mathbf{X}_{i, \ast} \, \bm{\beta})^2 + 2 +\mathbb{E}(\varepsilon_i) \mathbf{X}_{i, \ast} \, \bm{\beta} + +\mathbb{E}(\varepsilon_i^2 ) - ( \mathbf{X}_{i, \ast} \, \bm{\beta})^2 +\\ & = \mathbb{E}(\varepsilon_i^2 ) \, \, \, = \, \, \, +\mbox{Var}(\varepsilon_i) \, \, \, = \, \, \, \sigma^2. +\end{align*} +!et +Hence, $y_i \sim \mathcal{N}( \mathbf{X}_{i, \ast} \, \bm{\beta}, \sigma^2)$, that is $\bm{y}$ follows a normal distribution with +mean value $\bm{X}\bm{\beta}$ and variance $\sigma^2$ (not be confused with the singular values of the SVD). + +!split +===== Expectation value and variance for $\bm{\beta}$ ===== + +With the OLS expressions for the parameters $\bm{\beta}$ we can evaluate the expectation value +!bt +\[ +\mathbb{E}(\bm{\beta}) = \mathbb{E}[ (\mathbf{X}^{\top} \mathbf{X})^{-1}\mathbf{X}^{T} \mathbf{Y}]=(\mathbf{X}^{T} \mathbf{X})^{-1}\mathbf{X}^{T} \mathbb{E}[ \mathbf{Y}]=(\mathbf{X}^{T} \mathbf{X})^{-1} \mathbf{X}^{T}\mathbf{X}\bm{\beta}=\bm{\beta}. +\] +!et +This means that the estimator of the regression parameters is unbiased. + +We can also calculate the variance + +The variance of $\bm{\beta}$ is +!bt +\begin{eqnarray*} +\mbox{Var}(\bm{\beta}) & = & \mathbb{E} \{ [\bm{\beta} - \mathbb{E}(\bm{\beta})] [\bm{\beta} - \mathbb{E}(\bm{\beta})]^{T} \} +\\ +& = & \mathbb{E} \{ [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} - \bm{\beta}] \, [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} - \bm{\beta}]^{T} \} +\\ +% & = & \mathbb{E} \{ [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y}] \, [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y}]^{T} \} - \bm{\beta} \, \bm{\beta}^{T} +% \\ +% & = & \mathbb{E} \{ (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} \, \mathbf{Y}^{T} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} \} - \bm{\beta} \, \bm{\beta}^{T} +% \\ +& = & (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \, \mathbb{E} \{ \mathbf{Y} \, \mathbf{Y}^{T} \} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \bm{\beta} \, \bm{\beta}^{T} +\\ +& = & (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \, \{ \mathbf{X} \, \bm{\beta} \, \bm{\beta}^{T} \, \mathbf{X}^{T} + \sigma^2 \} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \bm{\beta} \, \bm{\beta}^{T} +% \\ +% & = & (\mathbf{X}^T \mathbf{X})^{-1} \, \mathbf{X}^T \, \mathbf{X} \, \bm{\beta} \, \bm{\beta}^T \, \mathbf{X}^T \, \mathbf{X} \, (\mathbf{X}^T % \mathbf{X})^{-1} +% \\ +% & & + \, \, \sigma^2 \, (\mathbf{X}^T \mathbf{X})^{-1} \, \mathbf{X}^T \, \mathbf{X} \, (\mathbf{X}^T \mathbf{X})^{-1} - \bm{\beta} \bm{\beta}^T +\\ +& = & \bm{\beta} \, \bm{\beta}^{T} + \sigma^2 \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \bm{\beta} \, \bm{\beta}^{T} +\, \, \, = \, \, \, \sigma^2 \, (\mathbf{X}^{T} \mathbf{X})^{-1}, +\end{eqnarray*} +!et + +where we have used that $\mathbb{E} (\mathbf{Y} \mathbf{Y}^{T}) = +\mathbf{X} \, \bm{\beta} \, \bm{\beta}^{T} \, \mathbf{X}^{T} + +\sigma^2 \, \mathbf{I}_{nn}$. From $\mbox{Var}(\bm{\beta}) = \sigma^2 +\, (\mathbf{X}^{T} \mathbf{X})^{-1}$, one obtains an estimate of the +variance of the estimate of the $j$-th regression coefficient: +$\bm{\sigma}^2 (\bm{\beta}_j ) = \bm{\sigma}^2 \sqrt{ +[(\mathbf{X}^{T} \mathbf{X})^{-1}]_{jj} }$. This may be used to +construct a confidence interval for the estimates. + + +In a similar way, we can obtain analytical expressions for say the +expectation values of the parameters $\bm{\beta}$ and their variance +when we employ Ridge regression, allowing us again to define a confidence interval. + +It is rather straightforward to show that +!bt +\[ +\mathbb{E} \big[ \bm{\beta}^{\mathrm{Ridge}} \big]=(\mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I}_{pp})^{-1} (\mathbf{X}^{\top} \mathbf{X})\bm{\beta}^{\mathrm{OLS}}. +\] +!et +We see clearly that +$\mathbb{E} \big[ \bm{\beta}^{\mathrm{Ridge}} \big] \not= \bm{\beta}^{\mathrm{OLS}}$ for any $\lambda > 0$. We say then that the ridge estimator is biased. + +We can also compute the variance as + +!bt +\[ +\mbox{Var}[\bm{\beta}^{\mathrm{Ridge}}]=\sigma^2[ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1} \mathbf{X}^{T} \mathbf{X} \{ [ \mathbf{X}^{\top} \mathbf{X} + \lambda \mathbf{I} ]^{-1}\}^{T}, +\] +!et +and it is easy to see that if the parameter $\lambda$ goes to infinity then the variance of Ridge parameters $\bm{\beta}$ goes to zero. + +With this, we can compute the difference + +!bt +\[ +\mbox{Var}[\bm{\beta}^{\mathrm{OLS}}]-\mbox{Var}(\bm{\beta}^{\mathrm{Ridge}})=\sigma^2 [ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1}[ 2\lambda\mathbf{I} + \lambda^2 (\mathbf{X}^{T} \mathbf{X})^{-1} ] \{ [ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1}\}^{T}. +\] +!et +The difference is non-negative definite since each component of the +matrix product is non-negative definite. +This means the variance we obtain with the standard OLS will always for $\lambda > 0$ be larger than the variance of $\bm{\beta}$ obtained with the Ridge estimator. This has interesting consequences when we discuss the so-called bias-variance trade-off below. + + +!split +===== Resampling methods ===== + +With all these analytical equations for both the OLS and Ridge +regression, we will now outline how to assess a given model. This will +lead us to a discussion of the so-called bias-variance tradeoff (see +below) and so-called resampling methods. + +One of the quantities we have discussed as a way to measure errors is +the mean-squared error (MSE), mainly used for fitting of continuous +functions. Another choice is the absolute error. + +In the discussions below we will focus on the MSE and in particular since we will split the data into test and training data, +we discuss the +o prediction error or simply the _test error_ $\mathrm{Err_{Test}}$, where we have a fixed training set and the test error is the MSE arising from the data reserved for testing. We discuss also the +o training error $\mathrm{Err_{Train}}$, which is the average loss over the training data. + +As our model becomes more and more complex, more of the training data tends to used. The training may thence adapt to more complicated structures in the data. This may lead to a decrease in the bias (see below for code example) and a slight increase of the variance for the test error. +For a certain level of complexity the test error will reach minimum, before starting to increase again. The +training error reaches a saturation. + + + + +!split +===== Resampling methods: Jackknife and Bootstrap ===== + +Two famous +resampling methods are the _independent bootstrap_ and _the jackknife_. + +The jackknife is a special case of the independent bootstrap. Still, the jackknife was made +popular prior to the independent bootstrap. And as the popularity of +the independent bootstrap soared, new variants, such as _the dependent bootstrap_. + +The Jackknife and independent bootstrap work for +independent, identically distributed random variables. +If these conditions are not +satisfied, the methods will fail. Yet, it should be said that if the data are +independent, identically distributed, and we only want to estimate the +variance of $\overline{X}$ (which often is the case), then there is no +need for bootstrapping. + +!split +===== Resampling methods: Jackknife ===== + +The Jackknife works by making many replicas of the estimator $\widehat{\theta}$. +The jackknife is a resampling method where we systematically leave out one observation from the vector of observed values $\bm{x} = (x_1,x_2,\cdots,X_n)$. +Let $\bm{x}_i$ denote the vector +!bt +\[ +\bm{x}_i = (x_1,x_2,\cdots,x_{i-1},x_{i+1},\cdots,x_n), +\] +!et + +which equals the vector $\bm{x}$ with the exception that observation +number $i$ is left out. Using this notation, define +$\widehat{\theta}_i$ to be the estimator +$\widehat{\theta}$ computed using $\vec{X}_i$. + + +!split +===== Jackknife code example ===== +!bc pycod +from numpy import * +from numpy.random import randint, randn +from time import time + +def jackknife(data, stat): + n = len(data);t = zeros(n); inds = arange(n); t0 = time() + ## 'jackknifing' by leaving out an observation for each i + for i in range(n): + t[i] = stat(delete(data,i) ) + + # analysis + print("Runtime: %g sec" % (time()-t0)); print("Jackknife Statistics :") + print("original bias std. error") + print("%8g %14g %15g" % (stat(data),(n-1)*mean(t)/n, (n*var(t))**.5)) + + return t + + +# Returns mean of data samples +def stat(data): + return mean(data) + + +mu, sigma = 100, 15 +datapoints = 10000 +x = mu + sigma*random.randn(datapoints) +# jackknife returns the data sample +t = jackknife(x, stat) + +!ec + + +!split +===== Resampling methods: Bootstrap ===== +!bblock +Bootstrapping is a nonparametric approach to statistical inference +that substitutes computation for more traditional distributional +assumptions and asymptotic results. Bootstrapping offers a number of +advantages: +o The bootstrap is quite general, although there are some cases in which it fails. +o Because it does not require distributional assumptions (such as normally distributed errors), the bootstrap can provide more accurate inferences when the data are not well behaved or when the sample size is small. +o It is possible to apply the bootstrap to statistics with sampling distributions that are difficult to derive, even asymptotically. +o It is relatively simple to apply the bootstrap to complex data-collection plans (such as stratified and clustered samples). +!eblock + + +!split +===== Resampling methods: Bootstrap background ===== + +Since $\widehat{\theta} = \widehat{\theta}(\bm{X})$ is a function of random variables, +$\widehat{\theta}$ itself must be a random variable. Thus it has +a pdf, call this function $p(\bm{t})$. The aim of the bootstrap is to +estimate $p(\bm{t})$ by the relative frequency of +$\widehat{\theta}$. You can think of this as using a histogram +in the place of $p(\bm{t})$. If the relative frequency closely +resembles $p(\vec{t})$, then using numerics, it is straight forward to +estimate all the interesting parameters of $p(\bm{t})$ using point +estimators. + + +!split +===== Resampling methods: More Bootstrap background ===== + +In the case that $\widehat{\theta}$ has +more than one component, and the components are independent, we use the +same estimator on each component separately. If the probability +density function of $X_i$, $p(x)$, had been known, then it would have +been straight forward to do this by: +o Drawing lots of numbers from $p(x)$, suppose we call one such set of numbers $(X_1^*, X_2^*, \cdots, X_n^*)$. +o Then using these numbers, we could compute a replica of $\widehat{\theta}$ called $\widehat{\theta}^*$. + +By repeated use of (1) and (2), many +estimates of $\widehat{\theta}$ could have been obtained. The +idea is to use the relative frequency of $\widehat{\theta}^*$ +(think of a histogram) as an estimate of $p(\bm{t})$. + +!split +===== Resampling methods: Bootstrap approach ===== + +But +unless there is enough information available about the process that +generated $X_1,X_2,\cdots,X_n$, $p(x)$ is in general +unknown. Therefore, "Efron in 1979":"https://projecteuclid.org/euclid.aos/1176344552" asked the +question: What if we replace $p(x)$ by the relative frequency +of the observation $X_i$; if we draw observations in accordance with +the relative frequency of the observations, will we obtain the same +result in some asymptotic sense? The answer is yes. + + +Instead of generating the histogram for the relative +frequency of the observation $X_i$, just draw the values +$(X_1^*,X_2^*,\cdots,X_n^*)$ with replacement from the vector +$\bm{X}$. + +!split +===== Resampling methods: Bootstrap steps ===== + +The independent bootstrap works like this: + +o Draw with replacement $n$ numbers for the observed variables $\bm{x} = (x_1,x_2,\cdots,x_n)$. +o Define a vector $\bm{x}^*$ containing the values which were drawn from $\bm{x}$. +o Using the vector $\bm{x}^*$ compute $\widehat{\theta}^*$ by evaluating $\widehat \theta$ under the observations $\bm{x}^*$. +o Repeat this process $k$ times. + +When you are done, you can draw a histogram of the relative frequency +of $\widehat \theta^*$. This is your estimate of the probability +distribution $p(t)$. Using this probability distribution you can +estimate any statistics thereof. In principle you never draw the +histogram of the relative frequency of $\widehat{\theta}^*$. Instead +you use the estimators corresponding to the statistic of interest. For +example, if you are interested in estimating the variance of $\widehat +\theta$, apply the etsimator $\widehat \sigma^2$ to the values +$\widehat \theta ^*$. + + +!split +===== Code example for the Bootstrap method ===== + +The following code starts with a Gaussian distribution with mean value +$\mu =100$ and variance $\sigma=15$. We use this to generate the data +used in the bootstrap analysis. The bootstrap analysis returns a data +set after a given number of bootstrap operations (as many as we have +data points). This data set consists of estimated mean values for each +bootstrap operation. The histogram generated by the bootstrap method +shows that the distribution for these mean values is also a Gaussian, +centered around the mean value $\mu=100$ but with standard deviation +$\sigma/\sqrt{n}$, where $n$ is the number of bootstrap samples (in +this case the same as the number of original data points). The value +of the standard deviation is what we expect from the central limit +theorem. + + +!bc pycod +from numpy import * +from numpy.random import randint, randn +from time import time +import matplotlib.mlab as mlab +import matplotlib.pyplot as plt + +# Returns mean of bootstrap samples +def stat(data): + return mean(data) + +# Bootstrap algorithm +def bootstrap(data, statistic, R): + t = zeros(R); n = len(data); inds = arange(n); t0 = time() + # non-parametric bootstrap + for i in range(R): + t[i] = statistic(data[randint(0,n,n)]) + + # analysis + print("Runtime: %g sec" % (time()-t0)); print("Bootstrap Statistics :") + print("original bias std. error") + print("%8g %8g %14g %15g" % (statistic(data), std(data),mean(t),std(t))) + return t + + +mu, sigma = 100, 15 +datapoints = 10000 +x = mu + sigma*random.randn(datapoints) +# bootstrap returns the data sample +t = bootstrap(x, stat, datapoints) +# the histogram of the bootstrapped data +n, binsboot, patches = plt.hist(t, 50, normed=1, facecolor='red', alpha=0.75) + +# add a 'best fit' line +y = mlab.normpdf( binsboot, mean(t), std(t)) +lt = plt.plot(binsboot, y, 'r--', linewidth=1) +plt.xlabel('Smarts') +plt.ylabel('Probability') +plt.axis([99.5, 100.6, 0, 3.0]) +plt.grid(True) + +plt.show() + +!ec + + +!split +===== Various steps in cross-validation ===== + +When the repetitive splitting of the data set is done randomly, +samples may accidently end up in a fast majority of the splits in +either training or test set. Such samples may have an unbalanced +influence on either model building or prediction evaluation. To avoid +this $k$-fold cross-validation structures the data splitting. The +samples are divided into $k$ more or less equally sized exhaustive and +mutually exclusive subsets. In turn (at each split) one of these +subsets plays the role of the test set while the union of the +remaining subsets constitutes the training set. Such a splitting +warrants a balanced representation of each sample in both training and +test set over the splits. Still the division into the $k$ subsets +involves a degree of randomness. This may be fully excluded when +choosing $k=n$. This particular case is referred to as leave-one-out +cross-validation (LOOCV). + +!split +===== How to set up the cross-validation for Ridge and/or Lasso ===== + +* Define a range of interest for the penalty parameter. + +* Divide the data set into training and test set comprising samples $\{1, \ldots, n\} \setminus i$ and $\{ i \}$, respectively. + +* Fit the linear regression model by means of ridge estimation for each $\lambda$ in the grid using the training set, and the corresponding estimate of the error variance $\bm{\sigma}_{-i}^2(\lambda)$, as +!bt +\begin{align*} +\bm{\beta}_{-i}(\lambda) & = ( \bm{X}_{-i, \ast}^{T} +\bm{X}_{-i, \ast} + \lambda \bm{I}_{pp})^{-1} +\bm{X}_{-i, \ast}^{T} \bm{y}_{-i} +\end{align*} +!et + +* Evaluate the prediction performance of these models on the test set by $\log\{L[y_i, \bm{X}_{i, \ast}; \bm{\beta}_{-i}(\lambda), \bm{\sigma}_{-i}^2(\lambda)]\}$. Or, by the prediction error $|y_i - \bm{X}_{i, \ast} \bm{\beta}_{-i}(\lambda)|$, the relative error, the error squared or the R2 score function. + +* Repeat the first three steps such that each sample plays the role of the test set once. + +* Average the prediction performances of the test sets at each grid point of the penalty bias/parameter. It is an estimate of the prediction performance of the model corresponding to this value of the penalty parameter on novel data. It is defined as +!bt +\begin{align*} +\frac{1}{n} \sum_{i = 1}^n \log\{L[y_i, \mathbf{X}_{i, \ast}; \bm{\beta}_{-i}(\lambda), \bm{\sigma}_{-i}^2(\lambda)]\}. +\end{align*} +!et + +!split +===== Cross-validation in brief ===== + +For the various values of $k$ + +o shuffle the dataset randomly. +o Split the dataset into $k$ groups. +o For each unique group: + o Decide which group to use as set for test data + o Take the remaining groups as a training data set + o Fit a model on the training set and evaluate it on the test set + o Retain the evaluation score and discard the model +o Summarize the model using the sample of model evaluation scores + + + +!split +===== Code Example for Cross-validation and $k$-fold Cross-validation ===== + +The code here uses Ridge regression with cross-validation (CV) resampling and $k$-fold CV in order to fit a specific polynomial. +!bc pycod +import numpy as np +import matplotlib.pyplot as plt +from sklearn.model_selection import KFold +from sklearn.linear_model import Ridge +from sklearn.model_selection import cross_val_score +from sklearn.preprocessing import PolynomialFeatures + +# A seed just to ensure that the random numbers are the same for every run. +# Useful for eventual debugging. +np.random.seed(3155) + +# Generate the data. +nsamples = 100 +x = np.random.randn(nsamples) +y = 3*x**2 + np.random.randn(nsamples) + +## Cross-validation on Ridge regression using KFold only + +# Decide degree on polynomial to fit +poly = PolynomialFeatures(degree = 6) + +# Decide which values of lambda to use +nlambdas = 500 +lambdas = np.logspace(-3, 5, nlambdas) + +# Initialize a KFold instance +k = 5 +kfold = KFold(n_splits = k) + +# Perform the cross-validation to estimate MSE +scores_KFold = np.zeros((nlambdas, k)) + +i = 0 +for lmb in lambdas: + ridge = Ridge(alpha = lmb) + j = 0 + for train_inds, test_inds in kfold.split(x): + xtrain = x[train_inds] + ytrain = y[train_inds] + + xtest = x[test_inds] + ytest = y[test_inds] + + Xtrain = poly.fit_transform(xtrain[:, np.newaxis]) + ridge.fit(Xtrain, ytrain[:, np.newaxis]) + + Xtest = poly.fit_transform(xtest[:, np.newaxis]) + ypred = ridge.predict(Xtest) + + scores_KFold[i,j] = np.sum((ypred - ytest[:, np.newaxis])**2)/np.size(ypred) + + j += 1 + i += 1 + + +estimated_mse_KFold = np.mean(scores_KFold, axis = 1) + +## Cross-validation using cross_val_score from sklearn along with KFold + +# kfold is an instance initialized above as: +# kfold = KFold(n_splits = k) + +estimated_mse_sklearn = np.zeros(nlambdas) +i = 0 +for lmb in lambdas: + ridge = Ridge(alpha = lmb) + + X = poly.fit_transform(x[:, np.newaxis]) + estimated_mse_folds = cross_val_score(ridge, X, y[:, np.newaxis], scoring='neg_mean_squared_error', cv=kfold) + + # cross_val_score return an array containing the estimated negative mse for every fold. + # we have to the the mean of every array in order to get an estimate of the mse of the model + estimated_mse_sklearn[i] = np.mean(-estimated_mse_folds) + + i += 1 + +## Plot and compare the slightly different ways to perform cross-validation + +plt.figure() + +plt.plot(np.log10(lambdas), estimated_mse_sklearn, label = 'cross_val_score') +plt.plot(np.log10(lambdas), estimated_mse_KFold, 'r--', label = 'KFold') + +plt.xlabel('log10(lambda)') +plt.ylabel('mse') + +plt.legend() + +plt.show() + +!ec + + +!split +===== The bias-variance tradeoff ===== + + +We will discuss the bias-variance tradeoff in the context of +continuous predictions such as regression. However, many of the +intuitions and ideas discussed here also carry over to classification +tasks. Consider a dataset $\mathcal{L}$ consisting of the data +$\mathbf{X}_\mathcal{L}=\{(y_j, \boldsymbol{x}_j), j=0\ldots n-1\}$. + +Let us assume that the true data is generated from a noisy model + +!bt +\[ +\bm{y}=f(\boldsymbol{x}) + \bm{\epsilon} +\] +!et + +where $\epsilon$ is normally distributed with mean zero and standard deviation $\sigma^2$. + +In our derivation of the ordinary least squares method we defined then +an approximation to the function $f$ in terms of the parameters +$\bm{\beta}$ and the design matrix $\bm{X}$ which embody our model, +that is $\bm{\tilde{y}}=\bm{X}\bm{\beta}$. + +Thereafter we found the parameters $\bm{\beta}$ by optimizing the means squared error via the so-called cost function +!bt +\[ +C(\bm{X},\bm{\beta}) =\frac{1}{n}\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2=\mathbb{E}\left[(\bm{y}-\bm{\tilde{y}})^2\right]. +\] +!et + +We can rewrite this as +!bt +\[ +\mathbb{E}\left[(\bm{y}-\bm{\tilde{y}})^2\right]=\frac{1}{n}\sum_i(f_i-\mathbb{E}\left[\bm{\tilde{y}}\right])^2+\frac{1}{n}\sum_i(\tilde{y}_i-\mathbb{E}\left[\bm{\tilde{y}}\right])^2+\sigma^2. +\] +!et + +The three terms represent the square of the bias of the learning +method, which can be thought of as the error caused by the simplifying +assumptions built into the method. The second term represents the +variance of the chosen model and finally the last terms is variance of +the error $\bm{\epsilon}$. + +To derive this equation, we need to recall that the variance of $\bm{y}$ and $\bm{\epsilon}$ are both equal to $\sigma^2$. The mean value of $\bm{\epsilon}$ is by definition equal to zero. Furthermore, the function $f$ is not a stochastics variable, idem for $\bm{\tilde{y}}$. +We use a more compact notation in terms of the expectation value +!bt +\[ +\mathbb{E}\left[(\bm{y}-\bm{\tilde{y}})^2\right]=\mathbb{E}\left[(\bm{f}+\bm{\epsilon}-\bm{\tilde{y}})^2\right], +\] +!et +and adding and subtracting $\mathbb{E}\left[\bm{\tilde{y}}\right]$ we get +!bt +\[ +\mathbb{E}\left[(\bm{y}-\bm{\tilde{y}})^2\right]=\mathbb{E}\left[(\bm{f}+\bm{\epsilon}-\bm{\tilde{y}}+\mathbb{E}\left[\bm{\tilde{y}}\right]-\mathbb{E}\left[\bm{\tilde{y}}\right])^2\right], +\] +!et +which, using the abovementioned expectation values can be rewritten as +!bt +\[ +\mathbb{E}\left[(\bm{y}-\bm{\tilde{y}})^2\right]=\mathbb{E}\left[(\bm{y}-\mathbb{E}\left[\bm{\tilde{y}}\right])^2\right]+\mathrm{Var}\left[\bm{\tilde{y}}\right]+\sigma^2, +\] +!et +that is the rewriting in terms of the so-called bias, the variance of the model $\bm{\tilde{y}}$ and the variance of $\bm{\epsilon}$. + + + + + +!split +===== Example code for Bias-Variance tradeoff ===== +!bc pycod +import matplotlib.pyplot as plt +import numpy as np +from sklearn.linear_model import LinearRegression, Ridge, Lasso +from sklearn.preprocessing import PolynomialFeatures +from sklearn.model_selection import train_test_split +from sklearn.pipeline import make_pipeline +from sklearn.utils import resample + +np.random.seed(2018) + +n = 500 +n_boostraps = 100 +degree = 18 # A quite high value, just to show. +noise = 0.1 + +# Make data set. +x = np.linspace(-1, 3, n).reshape(-1, 1) +y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2) + np.random.normal(0, 0.1, x.shape) + +# Hold out some test data that is never used in training. +x_train, x_test, y_train, y_test = train_test_split(x, y, test_size=0.2) + +# Combine x transformation and model into one operation. +# Not neccesary, but convenient. +model = make_pipeline(PolynomialFeatures(degree=degree), LinearRegression(fit_intercept=False)) + +# The following (m x n_bootstraps) matrix holds the column vectors y_pred +# for each bootstrap iteration. +y_pred = np.empty((y_test.shape[0], n_boostraps)) +for i in range(n_boostraps): + x_, y_ = resample(x_train, y_train) + + # Evaluate the new model on the same test data each time. + y_pred[:, i] = model.fit(x_, y_).predict(x_test).ravel() + +# Note: Expectations and variances taken w.r.t. different training +# data sets, hence the axis=1. Subsequent means are taken across the test data +# set in order to obtain a total value, but before this we have error/bias/variance +# calculated per data point in the test set. +# Note 2: The use of keepdims=True is important in the calculation of bias as this +# maintains the column vector form. Dropping this yields very unexpected results. +error = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) ) +bias = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 ) +variance = np.mean( np.var(y_pred, axis=1, keepdims=True) ) +print('Error:', error) +print('Bias^2:', bias) +print('Var:', variance) +print('{} >= {} + {} = {}'.format(error, bias, variance, bias+variance)) + +plt.plot(x[::5, :], y[::5, :], label='f(x)') +plt.scatter(x_test, y_test, label='Data points') +plt.scatter(x_test, np.mean(y_pred, axis=1), label='Pred') +plt.legend() +plt.show() + +!ec + + +!split +===== Understanding what happens ===== +!bc pycod +import matplotlib.pyplot as plt +import numpy as np +from sklearn.linear_model import LinearRegression, Ridge, Lasso +from sklearn.preprocessing import PolynomialFeatures +from sklearn.model_selection import train_test_split +from sklearn.pipeline import make_pipeline +from sklearn.utils import resample + +np.random.seed(2018) + +n = 40 +n_boostraps = 100 +maxdegree = 14 + + +# Make data set. +x = np.linspace(-3, 3, n).reshape(-1, 1) +y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape) +error = np.zeros(maxdegree) +bias = np.zeros(maxdegree) +variance = np.zeros(maxdegree) +polydegree = np.zeros(maxdegree) +x_train, x_test, y_train, y_test = train_test_split(x, y, test_size=0.2) + +for degree in range(maxdegree): + model = make_pipeline(PolynomialFeatures(degree=degree), LinearRegression(fit_intercept=False)) + y_pred = np.empty((y_test.shape[0], n_boostraps)) + for i in range(n_boostraps): + x_, y_ = resample(x_train, y_train) + y_pred[:, i] = model.fit(x_, y_).predict(x_test).ravel() + + polydegree[degree] = degree + error[degree] = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) ) + bias[degree] = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 ) + variance[degree] = np.mean( np.var(y_pred, axis=1, keepdims=True) ) + print('Polynomial degree:', degree) + print('Error:', error[degree]) + print('Bias^2:', bias[degree]) + print('Var:', variance[degree]) + print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree])) + +plt.plot(polydegree, error, label='Error') +plt.plot(polydegree, bias, label='bias') +plt.plot(polydegree, variance, label='Variance') +plt.legend() +plt.show() + + + + +!ec + +!split +===== Summing up ===== + + + + +The bias-variance tradeoff summarizes the fundamental tension in +machine learning, particularly supervised learning, between the +complexity of a model and the amount of training data needed to train +it. Since data is often limited, in practice it is often useful to +use a less-complex model with higher bias, that is a model whose asymptotic +performance is worse than another model because it is easier to +train and less sensitive to sampling noise arising from having a +finite-sized training dataset (smaller variance). + + + +The above equations tell us that in +order to minimize the expected test error, we need to select a +statistical learning method that simultaneously achieves low variance +and low bias. Note that variance is inherently a nonnegative quantity, +and squared bias is also nonnegative. Hence, we see that the expected +test MSE can never lie below $Var(\epsilon)$, the irreducible error. + + +What do we mean by the variance and bias of a statistical learning +method? The variance refers to the amount by which our model would change if we +estimated it using a different training data set. Since the training +data are used to fit the statistical learning method, different +training data sets will result in a different estimate. But ideally the +estimate for our model should not vary too much between training +sets. However, if a method has high variance then small changes in +the training data can result in large changes in the model. In general, more +flexible statistical methods have higher variance. + + +You may also find this recent "article":"https://www.pnas.org/content/116/32/15849" of interest. + +!split +===== Another Example from Scikit-Learn's Repository ===== +!bc pycod +""" +============================ +Underfitting vs. Overfitting +============================ + +This example demonstrates the problems of underfitting and overfitting and +how we can use linear regression with polynomial features to approximate +nonlinear functions. The plot shows the function that we want to approximate, +which is a part of the cosine function. In addition, the samples from the +real function and the approximations of different models are displayed. The +models have polynomial features of different degrees. We can see that a +linear function (polynomial with degree 1) is not sufficient to fit the +training samples. This is called **underfitting**. A polynomial of degree 4 +approximates the true function almost perfectly. However, for higher degrees +the model will **overfit** the training data, i.e. it learns the noise of the +training data. +We evaluate quantitatively **overfitting** / **underfitting** by using +cross-validation. We calculate the mean squared error (MSE) on the validation +set, the higher, the less likely the model generalizes correctly from the +training data. +""" + +print(__doc__) + +import numpy as np +import matplotlib.pyplot as plt +from sklearn.pipeline import Pipeline +from sklearn.preprocessing import PolynomialFeatures +from sklearn.linear_model import LinearRegression +from sklearn.model_selection import cross_val_score + + +def true_fun(X): + return np.cos(1.5 * np.pi * X) + +np.random.seed(0) + +n_samples = 30 +degrees = [1, 4, 15] + +X = np.sort(np.random.rand(n_samples)) +y = true_fun(X) + np.random.randn(n_samples) * 0.1 + +plt.figure(figsize=(14, 5)) +for i in range(len(degrees)): + ax = plt.subplot(1, len(degrees), i + 1) + plt.setp(ax, xticks=(), yticks=()) + + polynomial_features = PolynomialFeatures(degree=degrees[i], + include_bias=False) + linear_regression = LinearRegression() + pipeline = Pipeline([("polynomial_features", polynomial_features), + ("linear_regression", linear_regression)]) + pipeline.fit(X[:, np.newaxis], y) + + # Evaluate the models using crossvalidation + scores = cross_val_score(pipeline, X[:, np.newaxis], y, + scoring="neg_mean_squared_error", cv=10) + + X_test = np.linspace(0, 1, 100) + plt.plot(X_test, pipeline.predict(X_test[:, np.newaxis]), label="Model") + plt.plot(X_test, true_fun(X_test), label="True function") + plt.scatter(X, y, edgecolor='b', s=20, label="Samples") + plt.xlabel("x") + plt.ylabel("y") + plt.xlim((0, 1)) + plt.ylim((-2, 2)) + plt.legend(loc="best") + plt.title("Degree {}\nMSE = {:.2e}(+/- {:.2e})".format( + degrees[i], -scores.mean(), scores.std())) +plt.show() +!ec + + +!split +===== More examples on bootstrap and cross-validation and errors ===== + +!bc pycod +# Common imports +import os +import numpy as np +import pandas as pd +import matplotlib.pyplot as plt +from sklearn.linear_model import LinearRegression, Ridge, Lasso +from sklearn.model_selection import train_test_split +from sklearn.utils import resample +from sklearn.metrics import mean_squared_error +# Where to save the figures and data files +PROJECT_ROOT_DIR = "Results" +FIGURE_ID = "Results/FigureFiles" +DATA_ID = "DataFiles/" + +if not os.path.exists(PROJECT_ROOT_DIR): + os.mkdir(PROJECT_ROOT_DIR) + +if not os.path.exists(FIGURE_ID): + os.makedirs(FIGURE_ID) + +if not os.path.exists(DATA_ID): + os.makedirs(DATA_ID) + +def image_path(fig_id): + return os.path.join(FIGURE_ID, fig_id) + +def data_path(dat_id): + return os.path.join(DATA_ID, dat_id) + +def save_fig(fig_id): + plt.savefig(image_path(fig_id) + ".png", format='png') + +infile = open(data_path("EoS.csv"),'r') + +# Read the EoS data as csv file and organize the data into two arrays with density and energies +EoS = pd.read_csv(infile, names=('Density', 'Energy')) +EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce') +EoS = EoS.dropna() +Energies = EoS['Energy'] +Density = EoS['Density'] +# The design matrix now as function of various polytrops + +Maxpolydegree = 30 +X = np.zeros((len(Density),Maxpolydegree)) +X[:,0] = 1.0 +testerror = np.zeros(Maxpolydegree) +trainingerror = np.zeros(Maxpolydegree) +polynomial = np.zeros(Maxpolydegree) + +trials = 100 +for polydegree in range(1, Maxpolydegree): + polynomial[polydegree] = polydegree + for degree in range(polydegree): + X[:,degree] = Density**(degree/3.0) + +# loop over trials in order to estimate the expectation value of the MSE + testerror[polydegree] = 0.0 + trainingerror[polydegree] = 0.0 + for samples in range(trials): + x_train, x_test, y_train, y_test = train_test_split(X, Energies, test_size=0.2) + model = LinearRegression(fit_intercept=True).fit(x_train, y_train) + ypred = model.predict(x_train) + ytilde = model.predict(x_test) + testerror[polydegree] += mean_squared_error(y_test, ytilde) + trainingerror[polydegree] += mean_squared_error(y_train, ypred) + + testerror[polydegree] /= trials + trainingerror[polydegree] /= trials + print("Degree of polynomial: %3d"% polynomial[polydegree]) + print("Mean squared error on training data: %.8f" % trainingerror[polydegree]) + print("Mean squared error on test data: %.8f" % testerror[polydegree]) + +plt.plot(polynomial, np.log10(trainingerror), label='Training Error') +plt.plot(polynomial, np.log10(testerror), label='Test Error') +plt.xlabel('Polynomial degree') +plt.ylabel('log10[MSE]') +plt.legend() +plt.show() + +!ec + + +!split +===== The same example but now with cross-validation ===== + +!bc pycod +# Common imports +import os +import numpy as np +import pandas as pd +import matplotlib.pyplot as plt +from sklearn.linear_model import LinearRegression, Ridge, Lasso +from sklearn.metrics import mean_squared_error +from sklearn.model_selection import KFold +from sklearn.model_selection import cross_val_score + + +# Where to save the figures and data files +PROJECT_ROOT_DIR = "Results" +FIGURE_ID = "Results/FigureFiles" +DATA_ID = "DataFiles/" + +if not os.path.exists(PROJECT_ROOT_DIR): + os.mkdir(PROJECT_ROOT_DIR) + +if not os.path.exists(FIGURE_ID): + os.makedirs(FIGURE_ID) + +if not os.path.exists(DATA_ID): + os.makedirs(DATA_ID) + +def image_path(fig_id): + return os.path.join(FIGURE_ID, fig_id) + +def data_path(dat_id): + return os.path.join(DATA_ID, dat_id) + +def save_fig(fig_id): + plt.savefig(image_path(fig_id) + ".png", format='png') + +infile = open(data_path("EoS.csv"),'r') + +# Read the EoS data as csv file and organize the data into two arrays with density and energies +EoS = pd.read_csv(infile, names=('Density', 'Energy')) +EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce') +EoS = EoS.dropna() +Energies = EoS['Energy'] +Density = EoS['Density'] +# The design matrix now as function of various polytrops + +Maxpolydegree = 30 +X = np.zeros((len(Density),Maxpolydegree)) +X[:,0] = 1.0 +estimated_mse_sklearn = np.zeros(Maxpolydegree) +polynomial = np.zeros(Maxpolydegree) +k =5 +kfold = KFold(n_splits = k) + +for polydegree in range(1, Maxpolydegree): + polynomial[polydegree] = polydegree + for degree in range(polydegree): + X[:,degree] = Density**(degree/3.0) + OLS = LinearRegression() +# loop over trials in order to estimate the expectation value of the MSE + estimated_mse_folds = cross_val_score(OLS, X, Energies, scoring='neg_mean_squared_error', cv=kfold) +#[:, np.newaxis] + estimated_mse_sklearn[polydegree] = np.mean(-estimated_mse_folds) + +plt.plot(polynomial, np.log10(estimated_mse_sklearn), label='Test Error') +plt.xlabel('Polynomial degree') +plt.ylabel('log10[MSE]') +plt.legend() +plt.show() + +!ec + +!split +===== Cross-validation with Ridge ===== +!bc pycod +import numpy as np +import matplotlib.pyplot as plt +from sklearn.model_selection import KFold +from sklearn.linear_model import Ridge +from sklearn.model_selection import cross_val_score +from sklearn.preprocessing import PolynomialFeatures + +# A seed just to ensure that the random numbers are the same for every run. +np.random.seed(3155) +# Generate the data. +n = 100 +x = np.linspace(-3, 3, n).reshape(-1, 1) +y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape) +# Decide degree on polynomial to fit +poly = PolynomialFeatures(degree = 10) + +# Decide which values of lambda to use +nlambdas = 500 +lambdas = np.logspace(-3, 5, nlambdas) +# Initialize a KFold instance +k = 5 +kfold = KFold(n_splits = k) +estimated_mse_sklearn = np.zeros(nlambdas) +i = 0 +for lmb in lambdas: + ridge = Ridge(alpha = lmb) + estimated_mse_folds = cross_val_score(ridge, x, y, scoring='neg_mean_squared_error', cv=kfold) + estimated_mse_sklearn[i] = np.mean(-estimated_mse_folds) + i += 1 +plt.figure() +plt.plot(np.log10(lambdas), estimated_mse_sklearn, label = 'cross_val_score') +plt.xlabel('log10(lambda)') +plt.ylabel('MSE') +plt.legend() +plt.show() + + +!ec + + + + + + + + + + +!split +===== The Ising model ===== + +The one-dimensional Ising model with nearest neighbor interaction, no +external field and a constant coupling constant $J$ is given by + +!bt +\begin{align} + H = -J \sum_{k}^L s_k s_{k + 1}, +\end{align} +!et + +where $s_i \in \{-1, 1\}$ and $s_{N + 1} = s_1$. The number of spins +in the system is determined by $L$. For the one-dimensional system +there is no phase transition. + +We will look at a system of $L = 40$ spins with a coupling constant of +$J = 1$. To get enough training data we will generate 10000 states +with their respective energies. + + +!bc pycod +import numpy as np +import matplotlib.pyplot as plt +from mpl_toolkits.axes_grid1 import make_axes_locatable +import seaborn as sns +import scipy.linalg as scl +from sklearn.model_selection import train_test_split +import tqdm +sns.set(color_codes=True) +cmap_args=dict(vmin=-1., vmax=1., cmap='seismic') + +L = 40 +n = int(1e4) + +spins = np.random.choice([-1, 1], size=(n, L)) +J = 1.0 + +energies = np.zeros(n) + +for i in range(n): + energies[i] = - J * np.dot(spins[i], np.roll(spins[i], 1)) +!ec + +Here we use ordinary least squares +regression to predict the energy for the nearest neighbor +one-dimensional Ising model on a ring, i.e., the endpoints wrap +around. We will use linear regression to fit a value for +the coupling constant to achieve this. + +!split +===== Reformulating the problem to suit regression ===== + +A more general form for the one-dimensional Ising model is + +!bt +\begin{align} + H = - \sum_j^L \sum_k^L s_j s_k J_{jk}. +\end{align} +!et + +Here we allow for interactions beyond the nearest neighbors and a state dependent +coupling constant. This latter expression can be formulated as +a matrix-product +!bt +\begin{align} + \bm{H} = \bm{X} J, +\end{align} +!et + +where $X_{jk} = s_j s_k$ and $J$ is a matrix which consists of the +elements $-J_{jk}$. This form of writing the energy fits perfectly +with the form utilized in linear regression, that is + +!bt +\begin{align} + \bm{y} = \bm{X}\bm{\beta} + \bm{\epsilon}, +\end{align} +!et + +We split the data in training and test data as discussed in the previous example + +!bc pycod +X = np.zeros((n, L ** 2)) +for i in range(n): + X[i] = np.outer(spins[i], spins[i]).ravel() +y = energies +X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2) +!ec + +!split +===== Linear regression ===== + +In the ordinary least squares method we choose the cost function + +!bt +\begin{align} + C(\bm{X}, \bm{\beta})= \frac{1}{n}\left\{(\bm{X}\bm{\beta} - \bm{y})^T(\bm{X}\bm{\beta} - \bm{y})\right\}. +\end{align} +!et + +We then find the extremal point of $C$ by taking the derivative with respect to $\bm{\beta}$ as discussed above. +This yields the expression for $\bm{\beta}$ to be + +!bt +\[ + \bm{\beta} = \frac{\bm{X}^T \bm{y}}{\bm{X}^T \bm{X}}, +\] +!et + +which immediately imposes some requirements on $\bm{X}$ as there must exist +an inverse of $\bm{X}^T \bm{X}$. If the expression we are modeling contains an +intercept, i.e., a constant term, we must make sure that the +first column of $\bm{X}$ consists of $1$. We do this here + +!bc pycod +X_train_own = np.concatenate( + (np.ones(len(X_train))[:, np.newaxis], X_train), + axis=1 +) +X_test_own = np.concatenate( + (np.ones(len(X_test))[:, np.newaxis], X_test), + axis=1 +) +!ec + +!bc pycod +def ols_inv(x: np.ndarray, y: np.ndarray) -> np.ndarray: + return scl.inv(x.T @ x) @ (x.T @ y) +beta = ols_inv(X_train_own, y_train) +!ec + + +!split +===== Singular Value decomposition ===== + +Doing the inversion directly turns out to be a bad idea since the matrix +$\bm{X}^T\bm{X}$ is singular. An alternative approach is to use the _singular +value decomposition_. Using the definition of the Moore-Penrose +pseudoinverse we can write the equation for $\bm{\beta}$ as + +!bt +\[ + \bm{\beta} = \bm{X}^{+}\bm{y}, +\] +!et + +where the pseudoinverse of $\bm{X}$ is given by + +!bt +\[ + \bm{X}^{+} = \frac{\bm{X}^T}{\bm{X}^T\bm{X}}. +\] +!et + +Using singular value decomposition we can decompose the matrix $\bm{X} = \bm{U}\bm{\Sigma} \bm{V}^T$, +where $\bm{U}$ and $\bm{V}$ are orthogonal(unitary) matrices and $\bm{\Sigma}$ contains the singular values (more details below). +where $X^{+} = V\Sigma^{+} U^T$. This reduces the equation for +$\omega$ to +!bt +\begin{align} + \bm{\beta} = \bm{V}\bm{\Sigma}^{+} \bm{U}^T \bm{y}. +\end{align} +!et + +Note that solving this equation by actually doing the pseudoinverse +(which is what we will do) is not a good idea as this operation scales +as $\mathcal{O}(n^3)$, where $n$ is the number of elements in a +general matrix. Instead, doing $QR$-factorization and solving the +linear system as an equation would reduce this down to +$\mathcal{O}(n^2)$ operations. + + +!bc pycod +def ols_svd(x: np.ndarray, y: np.ndarray) -> np.ndarray: + u, s, v = scl.svd(x) + return v.T @ scl.pinv(scl.diagsvd(s, u.shape[0], v.shape[0])) @ u.T @ y +!ec + +!bc pycod +beta = ols_svd(X_train_own,y_train) +!ec + +When extracting the $J$-matrix we need to make sure that we remove the intercept, as is done here + +!bc pycod +J = beta[1:].reshape(L, L) +!ec + +A way of looking at the coefficients in $J$ is to plot the matrices as images. + + +!bc pycod +fig = plt.figure(figsize=(20, 14)) +im = plt.imshow(J, **cmap_args) +plt.title("OLS", fontsize=18) +plt.xticks(fontsize=18) +plt.yticks(fontsize=18) +cb = fig.colorbar(im) +cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18) +plt.show() +!ec +It is interesting to note that OLS +considers both $J_{j, j + 1} = -0.5$ and $J_{j, j - 1} = -0.5$ as +valid matrix elements for $J$. +In our discussion below on hyperparameters and Ridge and Lasso regression we will see that +this problem can be removed, partly and only with Lasso regression. + +In this case our matrix inversion was actually possible. The obvious question now is what is the mathematics behind the SVD? + + + + + +!split +===== The one-dimensional Ising model ===== + +Let us bring back the Ising model again, but now with an additional +focus on Ridge and Lasso regression as well. We repeat some of the +basic parts of the Ising model and the setup of the training and test +data. The one-dimensional Ising model with nearest neighbor +interaction, no external field and a constant coupling constant $J$ is +given by + +!bt +\begin{align} + H = -J \sum_{k}^L s_k s_{k + 1}, +\end{align} +!et +where $s_i \in \{-1, 1\}$ and $s_{N + 1} = s_1$. The number of spins in the system is determined by $L$. For the one-dimensional system there is no phase transition. + +We will look at a system of $L = 40$ spins with a coupling constant of $J = 1$. To get enough training data we will generate 10000 states with their respective energies. + + +!bc pycod +import numpy as np +import matplotlib.pyplot as plt +from mpl_toolkits.axes_grid1 import make_axes_locatable +import seaborn as sns +import scipy.linalg as scl +from sklearn.model_selection import train_test_split +import sklearn.linear_model as skl +import tqdm +sns.set(color_codes=True) +cmap_args=dict(vmin=-1., vmax=1., cmap='seismic') + +L = 40 +n = int(1e4) + +spins = np.random.choice([-1, 1], size=(n, L)) +J = 1.0 + +energies = np.zeros(n) + +for i in range(n): + energies[i] = - J * np.dot(spins[i], np.roll(spins[i], 1)) +!ec + +A more general form for the one-dimensional Ising model is + +!bt +\begin{align} + H = - \sum_j^L \sum_k^L s_j s_k J_{jk}. +\end{align} +!et + +Here we allow for interactions beyond the nearest neighbors and a more +adaptive coupling matrix. This latter expression can be formulated as +a matrix-product on the form +!bt +\begin{align} + H = X J, +\end{align} +!et + +where $X_{jk} = s_j s_k$ and $J$ is the matrix consisting of the +elements $-J_{jk}$. This form of writing the energy fits perfectly +with the form utilized in linear regression, viz. +!bt +\begin{align} + \bm{y} = \bm{X}\bm{\beta} + \bm{\epsilon}. +\end{align} +!et +We organize the data as we did above +!bc pycod +X = np.zeros((n, L ** 2)) +for i in range(n): + X[i] = np.outer(spins[i], spins[i]).ravel() +y = energies +X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.96) + +X_train_own = np.concatenate( + (np.ones(len(X_train))[:, np.newaxis], X_train), + axis=1 +) + +X_test_own = np.concatenate( + (np.ones(len(X_test))[:, np.newaxis], X_test), + axis=1 +) +!ec + +We will do all fitting with _Scikit-Learn_, + +!bc pycod +clf = skl.LinearRegression().fit(X_train, y_train) +!ec +When extracting the $J$-matrix we make sure to remove the intercept +!bc pycod +J_sk = clf.coef_.reshape(L, L) +!ec +And then we plot the results +!bc pycod +fig = plt.figure(figsize=(20, 14)) +im = plt.imshow(J_sk, **cmap_args) +plt.title("LinearRegression from Scikit-learn", fontsize=18) +plt.xticks(fontsize=18) +plt.yticks(fontsize=18) +cb = fig.colorbar(im) +cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18) +plt.show() +!ec +The results perfectly with our previous discussion where we used our own code. + +!split +===== Ridge regression ===== + +Having explored the ordinary least squares we move on to ridge +regression. In ridge regression we include a _regularizer_. This +involves a new cost function which leads to a new estimate for the +weights $\bm{\beta}$. This results in a penalized regression problem. The +cost function is given by + +!bt +\begin{align} + C(\bm{X}, \bm{\beta}; \lambda) = (\bm{X}\bm{\beta} - \bm{y})^T(\bm{X}\bm{\beta} - \bm{y}) + \lambda \bm{\beta}^T\bm{\beta}. +\end{align} +!et +!bc pycod +_lambda = 0.1 +clf_ridge = skl.Ridge(alpha=_lambda).fit(X_train, y_train) +J_ridge_sk = clf_ridge.coef_.reshape(L, L) +fig = plt.figure(figsize=(20, 14)) +im = plt.imshow(J_ridge_sk, **cmap_args) +plt.title("Ridge from Scikit-learn", fontsize=18) +plt.xticks(fontsize=18) +plt.yticks(fontsize=18) +cb = fig.colorbar(im) +cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18) + +plt.show() +!ec + +!split +===== LASSO regression ===== + +In the _Least Absolute Shrinkage and Selection Operator_ (LASSO)-method we get a third cost function. + +!bt +\begin{align} + C(\bm{X}, \bm{\beta}; \lambda) = (\bm{X}\bm{\beta} - \bm{y})^T(\bm{X}\bm{\beta} - \bm{y}) + \lambda \sqrt{\bm{\beta}^T\bm{\beta}}. +\end{align} +!et + +Finding the extremal point of this cost function is not so straight-forward as in least squares and ridge. We will therefore rely solely on the function ``Lasso`` from _Scikit-Learn_. + +!bc pycod +clf_lasso = skl.Lasso(alpha=_lambda).fit(X_train, y_train) +J_lasso_sk = clf_lasso.coef_.reshape(L, L) +fig = plt.figure(figsize=(20, 14)) +im = plt.imshow(J_lasso_sk, **cmap_args) +plt.title("Lasso from Scikit-learn", fontsize=18) +plt.xticks(fontsize=18) +plt.yticks(fontsize=18) +cb = fig.colorbar(im) +cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18) + +plt.show() +!ec + +It is quite striking how LASSO breaks the symmetry of the coupling +constant as opposed to ridge and OLS. We get a sparse solution with +$J_{j, j + 1} = -1$. + + + +!split +===== Performance as function of the regularization parameter ===== + +We see how the different models perform for a different set of values for $\lambda$. + + +!bc pycod +lambdas = np.logspace(-4, 5, 10) + +train_errors = { + "ols_sk": np.zeros(lambdas.size), + "ridge_sk": np.zeros(lambdas.size), + "lasso_sk": np.zeros(lambdas.size) +} + +test_errors = { + "ols_sk": np.zeros(lambdas.size), + "ridge_sk": np.zeros(lambdas.size), + "lasso_sk": np.zeros(lambdas.size) +} + +plot_counter = 1 + +fig = plt.figure(figsize=(32, 54)) + +for i, _lambda in enumerate(tqdm.tqdm(lambdas)): + for key, method in zip( + ["ols_sk", "ridge_sk", "lasso_sk"], + [skl.LinearRegression(), skl.Ridge(alpha=_lambda), skl.Lasso(alpha=_lambda)] + ): + method = method.fit(X_train, y_train) + + train_errors[key][i] = method.score(X_train, y_train) + test_errors[key][i] = method.score(X_test, y_test) + + omega = method.coef_.reshape(L, L) + + plt.subplot(10, 5, plot_counter) + plt.imshow(omega, **cmap_args) + plt.title(r"%s, $\lambda = %.4f$" % (key, _lambda)) + plot_counter += 1 + +plt.show() +!ec + +We see that LASSO reaches a good solution for low +values of $\lambda$, but will "wither" when we increase $\lambda$ too +much. Ridge is more stable over a larger range of values for +$\lambda$, but eventually also fades away. + +!split +===== Finding the optimal value of $\lambda$ ===== + +To determine which value of $\lambda$ is best we plot the accuracy of +the models when predicting the training and the testing set. We expect +the accuracy of the training set to be quite good, but if the accuracy +of the testing set is much lower this tells us that we might be +subject to an overfit model. The ideal scenario is an accuracy on the +testing set that is close to the accuracy of the training set. + + +!bc pycod +fig = plt.figure(figsize=(20, 14)) + +colors = { + "ols_sk": "r", + "ridge_sk": "y", + "lasso_sk": "c" +} + +for key in train_errors: + plt.semilogx( + lambdas, + train_errors[key], + colors[key], + label="Train {0}".format(key), + linewidth=4.0 + ) + +for key in test_errors: + plt.semilogx( + lambdas, + test_errors[key], + colors[key] + "--", + label="Test {0}".format(key), + linewidth=4.0 + ) +plt.legend(loc="best", fontsize=18) +plt.xlabel(r"$\lambda$", fontsize=18) +plt.ylabel(r"$R^2$", fontsize=18) +plt.tick_params(labelsize=18) +plt.show() +!ec + +From the above figure we can see that LASSO with $\lambda = 10^{-2}$ +achieves a very good accuracy on the test set. This by far surpasses the +other models for all values of $\lambda$. + + + + + + diff --git a/doc/src/Statistics/Statistics.dlog b/doc/src/Statistics/Statistics.dlog new file mode 100644 index 000000000..ddfa3d0b5 --- /dev/null +++ b/doc/src/Statistics/Statistics.dlog @@ -0,0 +1,4 @@ +translating doconce text in Statistics.do.txt to ipynb +Failed to remove ans_at_end environment +Failed to remove sol_at_end environment +output in Statistics.ipynb diff --git a/doc/src/SupportVMachines/chapter7.dlog b/doc/src/SupportVMachines/chapter7.dlog new file mode 100644 index 000000000..354add915 --- /dev/null +++ b/doc/src/SupportVMachines/chapter7.dlog @@ -0,0 +1,62 @@ +*** error: file has a mako construction ${\cal L}' + but seemingly no definition in <%...%>' + (it is not a command-line given mako variable either). + However, if this is a variable in a Makefile or Bash script + run with --no_mako - and you cannot use mako and Makefile or Bash variables + in the same document! + +*** error: file has a mako construction ${\cal L}' + but seemingly no definition in <%...%>' + (it is not a command-line given mako variable either). + However, if this is a variable in a Makefile or Bash script + run with --no_mako - and you cannot use mako and Makefile or Bash variables + in the same document! + +*** error: file has a mako construction ${\cal L}' + but seemingly no definition in <%...%>' + (it is not a command-line given mako variable either). + However, if this is a variable in a Makefile or Bash script + run with --no_mako - and you cannot use mako and Makefile or Bash variables + in the same document! + +translating doconce text in chapter7.do.txt to ipynb +*** replacing \bm{...} by \boldsymbol{...} (\bm is not supported by MathJax) +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +*** warning: latex envir \begin{bmatrix} does not work well in Markdown. + Stick to \[ ... \], equation, equation*, align, or align* + environments in math environments. + +Failed to remove ans_at_end environment +Failed to remove sol_at_end environment +output in chapter7.ipynb diff --git a/doc/src/SupportVMachines/chapter7.do.txt b/doc/src/SupportVMachines/chapter7.do.txt new file mode 100644 index 000000000..fdbf529c1 --- /dev/null +++ b/doc/src/SupportVMachines/chapter7.do.txt @@ -0,0 +1,1138 @@ +======= Support Vector Machines, overarching aims ======= + +A Support Vector Machine (SVM) is a very powerful and versatile +Machine Learning method, capable of performing linear or nonlinear +classification, regression, and even outlier detection. It is one of +the most popular models in Machine Learning, and anyone interested in +Machine Learning should have it in their toolbox. SVMs are +particularly well suited for classification of complex but small-sized or +medium-sized datasets. + +The case with two well-separated classes only can be understood in an +intuitive way in terms of lines in a two-dimensional space separating +the two classes (see figure below). + +The basic mathematics behind the SVM is however less familiar to most of us. +It relies on the definition of hyperplanes and the +definition of a _margin_ which separates classes (in case of +classification problems) of variables. It is also used for regression +problems. + +With SVMs we distinguish between hard margin and soft margins. The +latter introduces a so-called softening parameter to be discussed +below. We distinguish also between linear and non-linear +approaches. The latter are the most frequent ones since it is rather +unlikely that we can separate classes easily by say straight lines. + + +===== Hyperplanes and all that ===== + +The theory behind support vector machines (SVM hereafter) is based on +the mathematical description of so-called hyperplanes. Let us start +with a two-dimensional case. This will also allow us to introduce our +first SVM examples. These will be tailored to the case of two specific +classes, as displayed in the figure here based on the usage of the petal data. + +We assume here that our data set can be well separated into two +domains, where a straight line does the job in the separating the two +classes. Here the two classes are represented by either squares or +circles. +!bc pycod +from sklearn import datasets +from sklearn.svm import SVC, LinearSVC +from sklearn.linear_model import SGDClassifier +from sklearn.preprocessing import StandardScaler +import matplotlib +import matplotlib.pyplot as plt +plt.rcParams['axes.labelsize'] = 14 +plt.rcParams['xtick.labelsize'] = 12 +plt.rcParams['ytick.labelsize'] = 12 + + +iris = datasets.load_iris() +X = iris["data"][:, (2, 3)] # petal length, petal width +y = iris["target"] + +setosa_or_versicolor = (y == 0) | (y == 1) +X = X[setosa_or_versicolor] +y = y[setosa_or_versicolor] + + + +C = 5 +alpha = 1 / (C * len(X)) + +lin_clf = LinearSVC(loss="hinge", C=C, random_state=42) +svm_clf = SVC(kernel="linear", C=C) +sgd_clf = SGDClassifier(loss="hinge", learning_rate="constant", eta0=0.001, alpha=alpha, + max_iter=100000, random_state=42) + +scaler = StandardScaler() +X_scaled = scaler.fit_transform(X) + +lin_clf.fit(X_scaled, y) +svm_clf.fit(X_scaled, y) +sgd_clf.fit(X_scaled, y) + +print("LinearSVC: ", lin_clf.intercept_, lin_clf.coef_) +print("SVC: ", svm_clf.intercept_, svm_clf.coef_) +print("SGDClassifier(alpha={:.5f}):".format(sgd_clf.alpha), sgd_clf.intercept_, sgd_clf.coef_) + +# Compute the slope and bias of each decision boundary +w1 = -lin_clf.coef_[0, 0]/lin_clf.coef_[0, 1] +b1 = -lin_clf.intercept_[0]/lin_clf.coef_[0, 1] +w2 = -svm_clf.coef_[0, 0]/svm_clf.coef_[0, 1] +b2 = -svm_clf.intercept_[0]/svm_clf.coef_[0, 1] +w3 = -sgd_clf.coef_[0, 0]/sgd_clf.coef_[0, 1] +b3 = -sgd_clf.intercept_[0]/sgd_clf.coef_[0, 1] + +# Transform the decision boundary lines back to the original scale +line1 = scaler.inverse_transform([[-10, -10 * w1 + b1], [10, 10 * w1 + b1]]) +line2 = scaler.inverse_transform([[-10, -10 * w2 + b2], [10, 10 * w2 + b2]]) +line3 = scaler.inverse_transform([[-10, -10 * w3 + b3], [10, 10 * w3 + b3]]) + +# Plot all three decision boundaries +plt.figure(figsize=(11, 4)) +plt.plot(line1[:, 0], line1[:, 1], "k:", label="LinearSVC") +plt.plot(line2[:, 0], line2[:, 1], "b--", linewidth=2, label="SVC") +plt.plot(line3[:, 0], line3[:, 1], "r-", label="SGDClassifier") +plt.plot(X[:, 0][y==1], X[:, 1][y==1], "bs") # label="Iris-Versicolor" +plt.plot(X[:, 0][y==0], X[:, 1][y==0], "yo") # label="Iris-Setosa" +plt.xlabel("Petal length", fontsize=14) +plt.ylabel("Petal width", fontsize=14) +plt.legend(loc="upper center", fontsize=14) +plt.axis([0, 5.5, 0, 2]) + +plt.show() + + + +!ec + + + + + +===== What is a hyperplane? ===== + +The aim of the SVM algorithm is to find a hyperplane in a +$p$-dimensional space, where $p$ is the number of features that +distinctly classifies the data points. + +In a $p$-dimensional space, a hyperplane is what we call an affine subspace of dimension of $p-1$. +As an example, in two dimension, a hyperplane is simply as straight line while in three dimensions it is +a two-dimensional subspace, or stated simply, a plane. + +In two dimensions, with the variables $x_1$ and $x_2$, the hyperplane is defined as +!bt +\[ +b+w_1x_1+w_2x_2=0, +\] +!et + +where $b$ is the intercept and $w_1$ and $w_2$ define the elements of a vector orthogonal to the line +$b+w_1x_1+w_2x_2=0$. +In two dimensions we define the vectors $\bm{x} =[x1,x2]$ and $\bm{w}=[w1,w2]$. +We can then rewrite the above equation as + +!bt +\[ +\bm{x}^T\bm{w}+b=0. +\] +!et + + +===== A $p$-dimensional space of features ===== + +We limit ourselves to two classes of outputs $y_i$ and assign these classes the values $y_i = \pm 1$. +In a $p$-dimensional space of say $p$ features we have a hyperplane defines as +!bt +\[ +b+wx_1+w_2x_2+\dots +w_px_p=0. +\] +!et +If we define a +matrix $\bm{X}=\left[\bm{x}_1,\bm{x}_2,\dots, \bm{x}_p\right]$ +of dimension $n\times p$, where $n$ represents the observations for each feature and each vector $x_i$ is a column vector of the matrix $\bm{X}$, +!bt +\[ +\bm{x}_i = \begin{bmatrix} x_{i1} \\ x_{i2} \\ \dots \\ \dots \\ x_{ip} \end{bmatrix}. +\] +!et +If the above condition is not met for a given vector $\bm{x}_i$ we have +!bt +\[ +b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip} >0, +\] +!et +if our output $y_i=1$. +In this case we say that $\bm{x}_i$ lies on one of the sides of the hyperplane and if +!bt +\[ +b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip} < 0, +\] +!et +for the class of observations $y_i=-1$, +then $\bm{x}_i$ lies on the other side. + +Equivalently, for the two classes of observations we have +!bt +\[ +y_i\left(b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip}\right) > 0. +\] +!et + +When we try to separate hyperplanes, if it exists, we can use it to construct a natural classifier: a test observation is assigned a given class depending on which side of the hyperplane it is located. + + +===== The two-dimensional case ===== + +Let us try to develop our intuition about SVMs by limiting ourselves to a two-dimensional +plane. To separate the two classes of data points, there are many +possible lines (hyperplanes if you prefer a more strict naming) +that could be chosen. Our objective is to find a +plane that has the maximum margin, i.e the maximum distance between +data points of both classes. Maximizing the margin distance provides +some reinforcement so that future data points can be classified with +more confidence. + +What a linear classifier attempts to accomplish is to split the +feature space into two half spaces by placing a hyperplane between the +data points. This hyperplane will be our decision boundary. All +points on one side of the plane will belong to class one and all points +on the other side of the plane will belong to the second class two. + +Unfortunately there are many ways in which we can place a hyperplane +to divide the data. Below is an example of two candidate hyperplanes +for our data sample. + + +===== Getting into the details ===== + +Let us define the function +!bt +\[ +f(x) = \bm{w}^T\bm{x}+b = 0, +\] +!et +as the function that determines the line $L$ that separates two classes (our two features), see the figure here. + + +Any point defined by $\bm{x}_i$ and $\bm{x}_2$ on the line $L$ will satisfy $\bm{w}^T(\bm{x}_1-\bm{x}_2)=0$. + +The signed distance $\delta$ from any point defined by a vector $\bm{x}$ and a point $\bm{x}_0$ on the line $L$ is then +!bt +\[ +\delta = \frac{1}{\vert\vert \bm{w}\vert\vert}(\bm{w}^T\bm{x}+b). +\] +!et + + +===== First attempt at a minimization approach ===== + +How do we find the parameter $b$ and the vector $\bm{w}$? What we could +do is to define a cost function which now contains the set of all +misclassified points $M$ and attempt to minimize this function + +!bt +\[ +C(\bm{w},b) = -\sum_{i\in M} y_i(\bm{w}^T\bm{x}_i+b). +\] +!et + +We could now for example define all values $y_i =1$ as misclassified in case we have $\bm{w}^T\bm{x}_i+b < 0$ and the opposite if we have $y_i=-1$. Taking the derivatives gives us +!bt +\[ +\frac{\partial C}{\partial b} = -\sum_{i\in M} y_i, +\] +!et +and +!bt +\[ +\frac{\partial C}{\partial \bm{w}} = -\sum_{i\in M} y_ix_i. +\] +!et + + +===== Solving the equations ===== + +We can now use the Newton-Raphson method or different variants of the gradient descent family (from plain gradient descent to various stochastic gradient descent approaches) to solve the equations +!bt +\[ +b \leftarrow b +\eta \frac{\partial C}{\partial b}, +\] +!et +and +!bt +\[ +\bm{w} \leftarrow \bm{w} +\eta \frac{\partial C}{\partial \bm{w}}, +\] +!et +where $\eta$ is our by now well-known learning rate. + + + +===== Code Example ===== + +The equations we discussed above can be coded rather easily (the +framework is similar to what we developed for logistic +regression). We are going to set up a simple case with two classes only and we want to find a line which separates them the best possible way. +!bc pycod + +!ec + + +===== Problems with the Simpler Approach ===== + + +There are however problems with this approach, although it looks +pretty straightforward to implement. When running the above code, we see that we can easily end up with many diffeent lines which separate the two classes. + + +For small +gaps between the entries, we may also end up needing many iterations +before the solutions converge and if the data cannot be separated +properly into two distinct classes, we may not experience a converge +at all. + + +===== A better approach ===== + +A better approach is rather to try to define a large margin between +the two classes (if they are well separated from the beginning). + +Thus, we wish to find a margin $M$ with $\bm{w}$ normalized to +$\vert\vert \bm{w}\vert\vert =1$ subject to the condition + +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b) \geq M \hspace{0.1cm}\forall i=1,2,\dots, p. +\] +!et +All points are thus at a signed distance from the decision boundary defined by the line $L$. The parameters $b$ and $w_1$ and $w_2$ define this line. + +We seek thus the largest value $M$ defined by +!bt +\[ +\frac{1}{\vert \vert \bm{w}\vert\vert}y_i(\bm{w}^T\bm{x}_i+b) \geq M \hspace{0.1cm}\forall i=1,2,\dots, n, +\] +!et +or just +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b) \geq M\vert \vert \bm{w}\vert\vert \hspace{0.1cm}\forall i. +\] +!et +If we scale the equation so that $\vert \vert \bm{w}\vert\vert = 1/M$, we have to find the minimum of +$\bm{w}^T\bm{w}=\vert \vert \bm{w}\vert\vert$ (the norm) subject to the condition +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b) \geq 1 \hspace{0.1cm}\forall i. +\] +!et + +We have thus defined our margin as the invers of the norm of +$\bm{w}$. We want to minimize the norm in order to have a as large as +possible margin $M$. Before we proceed, we need to remind ourselves +about Lagrangian multipliers. + + +===== A quick Reminder on Lagrangian Multipliers ===== + +Consider a function of three independent variables $f(x,y,z)$ . For the function $f$ to be an +extreme we have +!bt +\[ +df=0. +\] +!et +A necessary and sufficient condition is +!bt +\[ +\frac{\partial f}{\partial x} =\frac{\partial f}{\partial y}=\frac{\partial f}{\partial z}=0, +\] +!et +due to +!bt +\[ +df = \frac{\partial f}{\partial x}dx+\frac{\partial f}{\partial y}dy+\frac{\partial f}{\partial z}dz. +\] +!et +In many problems the variables $x,y,z$ are often subject to constraints (such as those above for the margin) +so that they are no longer all independent. It is possible at least in principle to use each +constraint to eliminate one variable +and to proceed with a new and smaller set of independent varables. + +The use of so-called Lagrangian multipliers is an alternative technique when the elimination +of variables is incovenient or undesirable. Assume that we have an equation of constraint on +the variables $x,y,z$ +!bt +\[ +\phi(x,y,z) = 0, +\] +!et + resulting in +!bt +\[ +d\phi = \frac{\partial \phi}{\partial x}dx+\frac{\partial \phi}{\partial y}dy+\frac{\partial \phi}{\partial z}dz =0. +\] +!et +Now we cannot set anymore +!bt +\[ +\frac{\partial f}{\partial x} =\frac{\partial f}{\partial y}=\frac{\partial f}{\partial z}=0, +\] +!et +if $df=0$ is wanted +because there are now only two independent variables! Assume $x$ and $y$ are the independent +variables. +Then $dz$ is no longer arbitrary. + + +===== Adding the Multiplier ===== + +However, we can add to +!bt +\[ +df = \frac{\partial f}{\partial x}dx+\frac{\partial f}{\partial y}dy+\frac{\partial f}{\partial z}dz, +\] +!et +a multiplum of $d\phi$, viz. $\lambda d\phi$, resulting in +!bt +\[ +df+\lambda d\phi = (\frac{\partial f}{\partial z}+\lambda +\frac{\partial \phi}{\partial x})dx+(\frac{\partial f}{\partial y}+\lambda\frac{\partial \phi}{\partial y})dy+ +(\frac{\partial f}{\partial z}+\lambda\frac{\partial \phi}{\partial z})dz =0. +\] +!et +Our multiplier is chosen so that +!bt +\[ +\frac{\partial f}{\partial z}+\lambda\frac{\partial \phi}{\partial z} =0. +\] +!et + +We need to remember that we took $dx$ and $dy$ to be arbitrary and thus we must have +!bt +\[ +\frac{\partial f}{\partial x}+\lambda\frac{\partial \phi}{\partial x} =0, +\] +!et +and +!bt +\[ +\frac{\partial f}{\partial y}+\lambda\frac{\partial \phi}{\partial y} =0. +\] +!et +When all these equations are satisfied, $df=0$. We have four unknowns, $x,y,z$ and +$\lambda$. Actually we want only $x,y,z$, $\lambda$ needs not to be determined, +it is therefore often called +Lagrange's undetermined multiplier. +If we have a set of constraints $\phi_k$ we have the equations +!bt +\[ +\frac{\partial f}{\partial x_i}+\sum_k\lambda_k\frac{\partial \phi_k}{\partial x_i} =0. +\] +!et + + +===== Setting up the Problem ===== +In order to solve the above problem, we define the following Lagrangian function to be minimized +!bt +\[ +{\cal L}(\lambda,b,\bm{w})=\frac{1}{2}\bm{w}^T\bm{w}-\sum_{i=1}^n\lambda_i\left[y_i(\bm{w}^T\bm{x}_i+b)-1\right], +\] +!et +where $\lambda_i$ is a so-called Lagrange multiplier subject to the condition $\lambda_i \geq 0$. + +Taking the derivatives with respect to $b$ and $\bm{w}$ we obtain +!bt +\[ +\frac{\partial {\cal L}}{\partial b} = -\sum_{i} \lambda_iy_i=0, +\] +!et +and +!bt +\[ +\frac{\partial {\cal L}}{\partial \bm{w}} = 0 = \bm{w}-\sum_{i} \lambda_iy_i\bm{x}_i. +\] +!et +Inserting these constraints into the equation for ${\cal L}$ we obtain +!bt +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\bm{x}_i^T\bm{x}_j, +\] +!et +subject to the constraints $\lambda_i\geq 0$ and $\sum_i\lambda_iy_i=0$. +We must in addition satisfy the "Karush-Kuhn-Tucker":"https://en.wikipedia.org/wiki/Karush%E2%80%93Kuhn%E2%80%93Tucker_conditions" (KKT) condition +!bt +\[ +\lambda_i\left[y_i(\bm{w}^T\bm{x}_i+b) -1\right] \hspace{0.1cm}\forall i. +\] +!et +o If $\lambda_i > 0$, then $y_i(\bm{w}^T\bm{x}_i+b)=1$ and we say that $x_i$ is on the boundary. +o If $y_i(\bm{w}^T\bm{x}_i+b)> 1$, we say $x_i$ is not on the boundary and we set $\lambda_i=0$. +When $\lambda_i > 0$, the vectors $\bm{x}_i$ are called support vectors. They are the vectors closest to the line (or hyperplane) and define the margin $M$. + + +===== The problem to solve ===== + +We can rewrite +!bt +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\bm{x}_i^T\bm{x}_j, +\] +!et +and its constraints in terms of a matrix-vector problem where we minimize w.r.t. $\lambda$ the following problem +!bt +\[ +\frac{1}{2} \bm{\lambda}^T\begin{bmatrix} y_1y_1\bm{x}_1^T\bm{x}_1 & y_1y_2\bm{x}_1^T\bm{x}_2 & \dots & \dots & y_1y_n\bm{x}_1^T\bm{x}_n \\ +y_2y_1\bm{x}_2^T\bm{x}_1 & y_2y_2\bm{x}_2^T\bm{x}_2 & \dots & \dots & y_1y_n\bm{x}_2^T\bm{x}_n \\ +\dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots \\ +y_ny_1\bm{x}_n^T\bm{x}_1 & y_ny_2\bm{x}_n^T\bm{x}_2 & \dots & \dots & y_ny_n\bm{x}_n^T\bm{x}_n \\ +\end{bmatrix}\bm{\lambda}-\mathbb{1}\bm{\lambda}, +\] +!et +subject to $\bm{y}^T\bm{\lambda}=0$. Here we defined the vectors $\bm{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]$ and +$\bm{y}=[y_1,y_2,\dots,y_n]$. + + + +===== The last steps ===== + +Solving the above problem, yields the values of $\lambda_i$. +To find the coefficients of your hyperplane we need simply to compute +!bt +\[ +\bm{w}=\sum_{i} \lambda_iy_i\bm{x}_i. +\] +!et +With our vector $\bm{w}$ we can in turn find the value of the intercept $b$ (here in two dimensions) via +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b)=1, +\] +!et +resulting in +!bt +\[ +b = \frac{1}{y_i}-\bm{w}^T\bm{x}_i, +\] +!et +or if we write it out in terms of the support vectors only, with $N_s$ being their number, we have +!bt +\[ +b = \frac{1}{N_s}\sum_{j\in N_s}\left(y_j-\sum_{i=1}^n\lambda_iy_i\bm{x}_i^T\bm{x}_j\right). +\] +!et +With our hyperplane coefficients we can use our classifier to assign any observation by simply using +!bt +\[ +y_i = \mathrm{sign}(\bm{w}^T\bm{x}_i+b). +\] +!et +Below we discuss how to find the optimal values of $\lambda_i$. Before we proceed however, we discuss now the so-called soft classifier. + + +===== A soft classifier ===== + +Till now, the margin is strictly defined by the support vectors. This defines what is called a hard classifier, that is the margins are well defined. + +Suppose now that classes overlap in feature space, as shown in the +figure here. One way to deal with this problem before we define the +so-called _kernel approach_, is to allow a kind of slack in the sense +that we allow some points to be on the wrong side of the margin. + +We introduce thus the so-called _slack_ variables $\bm{\xi} =[\xi_1,x_2,\dots,x_n]$ and +modify our previous equation +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b)=1, +\] +!et +to +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b)=1-\xi_i, +\] +!et +with the requirement $\xi_i\geq 0$. The total violation is now $\sum_i\xi$. +The value $\xi_i$ in the constraint the last constraint corresponds to the amount by which the prediction +$y_i(\bm{w}^T\bm{x}_i+b)=1$ is on the wrong side of its margin. Hence by bounding the sum $\sum_i \xi_i$, +we bound the total amount by which predictions fall on the wrong side of their margins. + +Misclassifications occur when $\xi_i > 1$. Thus bounding the total sum by some value $C$ bounds in turn the total number of +misclassifications. + + +===== Soft optmization problem ===== + + +This has in turn the consequences that we change our optmization problem to finding the minimum of +!bt +\[ +{\cal L}=\frac{1}{2}\bm{w}^T\bm{w}-\sum_{i=1}^n\lambda_i\left[y_i(\bm{w}^T\bm{x}_i+b)-(1-\xi_)\right]+C\sum_{i=1}^n\xi_i-\sum_{i=1}^n\gamma_i\xi_i, +\] +!et +subject to +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b)=1-\xi_i \hspace{0.1cm}\forall i, +\] +!et +with the requirement $\xi_i\geq 0$. + +Taking the derivatives with respect to $b$ and $\bm{w}$ we obtain +!bt +\[ +\frac{\partial {\cal L}}{\partial b} = -\sum_{i} \lambda_iy_i=0, +\] +!et +and +!bt +\[ +\frac{\partial {\cal L}}{\partial \bm{w}} = 0 = \bm{w}-\sum_{i} \lambda_iy_i\bm{x}_i, +\] +!et +and +!bt +\[ +\lambda_i = C-\gamma_i \hspace{0.1cm}\forall i. +\] +!et +Inserting these constraints into the equation for ${\cal L}$ we obtain the same equation as before +!bt +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\bm{x}_i^T\bm{x}_j, +\] +!et +but now subject to the constraints $\lambda_i\geq 0$, $\sum_i\lambda_iy_i=0$ and $0\leq\lambda_i \leq C$. +We must in addition satisfy the Karush-Kuhn-Tucker condition which now reads +!bt +\[ +\lambda_i\left[y_i(\bm{w}^T\bm{x}_i+b) -(1-\xi_)\right]=0 \hspace{0.1cm}\forall i, +\] +!et +!bt +\[ +\gamma_i\xi_i = 0, +\] +!et +and +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b) -(1-\xi_) \geq 0 \hspace{0.1cm}\forall i. +\] +!et + + +===== Kernels and non-linearity ===== + +The cases we have studied till now, were all characterized by two classes +with a close to linear separability. The classifiers we have described +so far find linear boundaries in our input feature space. It is +possible to make our procedure more flexible by exploring the feature +space using other basis expansions such as higher-order polynomials, +wavelets, splines etc. + +If our feature space is not easy to separate, as shown in the figure +here, we can achieve a better separation by introducing more complex +basis functions. The ideal would be, as shown in the next figure, to, via a specific transformation to +obtain a separation between the classes which is almost linear. + +The change of basis, from $x\rightarrow z=\phi(x)$ leads to the same type of equations to be solved, except that +we need to introduce for example a polynomial transformation to a two-dimensional training set. + +!bc pycod +import numpy as np +import os + +np.random.seed(42) + +# To plot pretty figures +import matplotlib +import matplotlib.pyplot as plt +plt.rcParams['axes.labelsize'] = 14 +plt.rcParams['xtick.labelsize'] = 12 +plt.rcParams['ytick.labelsize'] = 12 + + +from sklearn.svm import SVC +from sklearn import datasets + + + +X1D = np.linspace(-4, 4, 9).reshape(-1, 1) +X2D = np.c_[X1D, X1D**2] +y = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0]) + +plt.figure(figsize=(11, 4)) + +plt.subplot(121) +plt.grid(True, which='both') +plt.axhline(y=0, color='k') +plt.plot(X1D[:, 0][y==0], np.zeros(4), "bs") +plt.plot(X1D[:, 0][y==1], np.zeros(5), "g^") +plt.gca().get_yaxis().set_ticks([]) +plt.xlabel(r"$x_1$", fontsize=20) +plt.axis([-4.5, 4.5, -0.2, 0.2]) + +plt.subplot(122) +plt.grid(True, which='both') +plt.axhline(y=0, color='k') +plt.axvline(x=0, color='k') +plt.plot(X2D[:, 0][y==0], X2D[:, 1][y==0], "bs") +plt.plot(X2D[:, 0][y==1], X2D[:, 1][y==1], "g^") +plt.xlabel(r"$x_1$", fontsize=20) +plt.ylabel(r"$x_2$", fontsize=20, rotation=0) +plt.gca().get_yaxis().set_ticks([0, 4, 8, 12, 16]) +plt.plot([-4.5, 4.5], [6.5, 6.5], "r--", linewidth=3) +plt.axis([-4.5, 4.5, -1, 17]) +plt.subplots_adjust(right=1) +plt.show() + +!ec + + + + +===== The equations ===== + +Suppose we define a polynomial transformation of degree two only (we continue to live in a plane with $x_i$ and $y_i$ as variables) +!bt +\[ +z = \phi(x_i) =\left(x_i^2, y_i^2, \sqrt{2}x_iy_i\right). +\] +!et + +With our new basis, the equations we solved earlier are basically the same, that is we have now (without the slack option for simplicity) +!bt +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\bm{z}_i^T\bm{z}_j, +\] +!et +subject to the constraints $\lambda_i\geq 0$, $\sum_i\lambda_iy_i=0$, and for the support vectors +!bt +\[ +y_i(\bm{w}^T\bm{z}_i+b)= 1 \hspace{0.1cm}\forall i, +\] +!et +from which we also find $b$. +To compute $\bm{z}_i^T\bm{z}_j$ we define the kernel $K(\bm{x}_i,\bm{x}_j)$ as +!bt +\[ +K(\bm{x}_i,\bm{x}_j)=\bm{z}_i^T\bm{z}_j= \phi(\bm{x}_i)^T\phi(\bm{x}_j). +\] +!et +For the above example, the kernel reads +!bt +\[ +K(\bm{x}_i,\bm{x}_j)=[x_i^2, y_i^2, \sqrt{2}x_iy_i]^T\begin{bmatrix} x_j^2 \\ y_j^2 \\ \sqrt{2}x_jy_j \end{bmatrix}=x_i^2x_j^2+2x_ix_jy_iy_j+y_i^2y_j^2. +\] +!et + +We note that this is nothing but the dot product of the two original +vectors $(\bm{x}_i^T\bm{x}_j)^2$. Instead of thus computing the +product in the Lagrangian of $\bm{z}_i^T\bm{z}_j$ we simply compute +the dot product $(\bm{x}_i^T\bm{x}_j)^2$. + + +This leads to the so-called +kernel trick and the result leads to the same as if we went through +the trouble of performing the transformation +$\phi(\bm{x}_i)^T\phi(\bm{x}_j)$ during the SVM calculations. + + + +===== The problem to solve ===== +Using our definition of the kernel We can rewrite again the Lagrangian +!bt +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\bm{x}_i^T\bm{z}_j, +\] +!et +subject to the constraints $\lambda_i\geq 0$, $\sum_i\lambda_iy_i=0$ in terms of a convex optimization problem +!bt +\[ +\frac{1}{2} \bm{\lambda}^T\begin{bmatrix} y_1y_1K(\bm{x}_1,\bm{x}_1) & y_1y_2K(\bm{x}_1,\bm{x}_2) & \dots & \dots & y_1y_nK(\bm{x}_1,\bm{x}_n) \\ +y_2y_1K(\bm{x}_2,\bm{x}_1) & y_2y_2(\bm{x}_2,\bm{x}_2) & \dots & \dots & y_1y_nK(\bm{x}_2,\bm{x}_n) \\ +\dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots \\ +y_ny_1K(\bm{x}_n,\bm{x}_1) & y_ny_2K(\bm{x}_n\bm{x}_2) & \dots & \dots & y_ny_nK(\bm{x}_n,\bm{x}_n) \\ +\end{bmatrix}\bm{\lambda}-\mathbb{1}\bm{\lambda}, +\] +!et +subject to $\bm{y}^T\bm{\lambda}=0$. Here we defined the vectors $\bm{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]$ and +$\bm{y}=[y_1,y_2,\dots,y_n]$. +If we add the slack constants this leads to the additional constraint $0\leq \lambda_i \leq C$. + +We can rewrite this (see the solutions below) in terms of a convex optimization problem of the type +!bt +\begin{align*} + &\mathrm{min}_{\lambda}\hspace{0.2cm} \frac{1}{2}\bm{\lambda}^T\bm{P}\bm{\lambda}+\bm{q}^T\bm{\lambda},\\ \nonumber + &\mathrm{subject\hspace{0.1cm}to} \hspace{0.2cm} \bm{G}\bm{\lambda} \preceq \bm{h} \hspace{0.2cm} \wedge \bm{A}\bm{\lambda}=f. +\end{align*} +!et +Below we discuss how to solve these equations. Here we note that the matrix $\bm{P}$ has matrix elements $p_{ij}=y_iy_jK(\bm{x}_i,\bm{x}_j)$. +Given a kernel $K$ and the targets $y_i$ this matrix is easy to set up. The constraint $\bm{y}^T\bm{\lambda}=0$ leads to $f=0$ and $\bm{A}=\bm{y}$. How to set up the matrix $\bm{G}$ is discussed later. Here note that the inequalities $0\leq \lambda_i \leq C$ can be split up into +$0\leq \lambda_i$ and $\lambda_i \leq C$. These two inequalities define then the matrix $\bm{G}$ and the vector $\bm{h}$. + + + +===== Different kernels and Mercer's theorem ===== + +There are several popular kernels being used. These are +o Linear: $K(\bm{x},\bm{y})=\bm{x}^T\bm{y}$, +o Polynomial: $K(\bm{x},\bm{y})=(\bm{x}^T\bm{y}+\gamma)^d$, +o Gaussian Radial Basis Function: $K(\bm{x},\bm{y})=\exp{\left(-\gamma\vert\vert\bm{x}-\bm{y}\vert\vert^2\right)}$, +o Tanh: $K(\bm{x},\bm{y})=\tanh{(\bm{x}^T\bm{y}+\gamma)}$, +and many other ones. + +An important theorem for us is "Mercer's +theorem":"https://en.wikipedia.org/wiki/Mercer%27s_theorem". The +theorem states that if a kernel function $K$ is symmetric, continuous +and leads to a positive semi-definite matrix $\bm{P}$ then there +exists a function $\phi$ that maps $\bm{x}_i$ and $\bm{x}_j$ into +another space (possibly with much higher dimensions) such that + +!bt +\[ +K(\bm{x}_i,\bm{x}_j)=\phi(\bm{x}_i)^T\phi(\bm{x}_j). +\] +!et + +So you can use $K$ as a kernel since you know $\phi$ exists, even if +you don’t know what $\phi$ is. + +Note that some frequently used kernels (such as the Sigmoid kernel) +don’t respect all of Mercer’s conditions, yet they generally work well +in practice. + + + +===== The moons example ===== +!bc pycod +from __future__ import division, print_function, unicode_literals + +import numpy as np +np.random.seed(42) + +import matplotlib +import matplotlib.pyplot as plt +plt.rcParams['axes.labelsize'] = 14 +plt.rcParams['xtick.labelsize'] = 12 +plt.rcParams['ytick.labelsize'] = 12 + + +from sklearn.svm import SVC +from sklearn import datasets + + + +from sklearn.pipeline import Pipeline +from sklearn.preprocessing import StandardScaler +from sklearn.svm import LinearSVC + + +from sklearn.datasets import make_moons +X, y = make_moons(n_samples=100, noise=0.15, random_state=42) + +def plot_dataset(X, y, axes): + plt.plot(X[:, 0][y==0], X[:, 1][y==0], "bs") + plt.plot(X[:, 0][y==1], X[:, 1][y==1], "g^") + plt.axis(axes) + plt.grid(True, which='both') + plt.xlabel(r"$x_1$", fontsize=20) + plt.ylabel(r"$x_2$", fontsize=20, rotation=0) + +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) +plt.show() + +from sklearn.datasets import make_moons +from sklearn.pipeline import Pipeline +from sklearn.preprocessing import PolynomialFeatures + +polynomial_svm_clf = Pipeline([ + ("poly_features", PolynomialFeatures(degree=3)), + ("scaler", StandardScaler()), + ("svm_clf", LinearSVC(C=10, loss="hinge", random_state=42)) + ]) + +polynomial_svm_clf.fit(X, y) + +def plot_predictions(clf, axes): + x0s = np.linspace(axes[0], axes[1], 100) + x1s = np.linspace(axes[2], axes[3], 100) + x0, x1 = np.meshgrid(x0s, x1s) + X = np.c_[x0.ravel(), x1.ravel()] + y_pred = clf.predict(X).reshape(x0.shape) + y_decision = clf.decision_function(X).reshape(x0.shape) + plt.contourf(x0, x1, y_pred, cmap=plt.cm.brg, alpha=0.2) + plt.contourf(x0, x1, y_decision, cmap=plt.cm.brg, alpha=0.1) + +plot_predictions(polynomial_svm_clf, [-1.5, 2.5, -1, 1.5]) +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) + +plt.show() + + +from sklearn.svm import SVC + +poly_kernel_svm_clf = Pipeline([ + ("scaler", StandardScaler()), + ("svm_clf", SVC(kernel="poly", degree=3, coef0=1, C=5)) + ]) +poly_kernel_svm_clf.fit(X, y) + +poly100_kernel_svm_clf = Pipeline([ + ("scaler", StandardScaler()), + ("svm_clf", SVC(kernel="poly", degree=10, coef0=100, C=5)) + ]) +poly100_kernel_svm_clf.fit(X, y) + +plt.figure(figsize=(11, 4)) + +plt.subplot(121) +plot_predictions(poly_kernel_svm_clf, [-1.5, 2.5, -1, 1.5]) +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) +plt.title(r"$d=3, r=1, C=5$", fontsize=18) + +plt.subplot(122) +plot_predictions(poly100_kernel_svm_clf, [-1.5, 2.5, -1, 1.5]) +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) +plt.title(r"$d=10, r=100, C=5$", fontsize=18) + +plt.show() + +def gaussian_rbf(x, landmark, gamma): + return np.exp(-gamma * np.linalg.norm(x - landmark, axis=1)**2) + +gamma = 0.3 + +x1s = np.linspace(-4.5, 4.5, 200).reshape(-1, 1) +x2s = gaussian_rbf(x1s, -2, gamma) +x3s = gaussian_rbf(x1s, 1, gamma) + +XK = np.c_[gaussian_rbf(X1D, -2, gamma), gaussian_rbf(X1D, 1, gamma)] +yk = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0]) + +plt.figure(figsize=(11, 4)) + +plt.subplot(121) +plt.grid(True, which='both') +plt.axhline(y=0, color='k') +plt.scatter(x=[-2, 1], y=[0, 0], s=150, alpha=0.5, c="red") +plt.plot(X1D[:, 0][yk==0], np.zeros(4), "bs") +plt.plot(X1D[:, 0][yk==1], np.zeros(5), "g^") +plt.plot(x1s, x2s, "g--") +plt.plot(x1s, x3s, "b:") +plt.gca().get_yaxis().set_ticks([0, 0.25, 0.5, 0.75, 1]) +plt.xlabel(r"$x_1$", fontsize=20) +plt.ylabel(r"Similarity", fontsize=14) +plt.annotate(r'$\mathbf{x}$', + xy=(X1D[3, 0], 0), + xytext=(-0.5, 0.20), + ha="center", + arrowprops=dict(facecolor='black', shrink=0.1), + fontsize=18, + ) +plt.text(-2, 0.9, "$x_2$", ha="center", fontsize=20) +plt.text(1, 0.9, "$x_3$", ha="center", fontsize=20) +plt.axis([-4.5, 4.5, -0.1, 1.1]) + +plt.subplot(122) +plt.grid(True, which='both') +plt.axhline(y=0, color='k') +plt.axvline(x=0, color='k') +plt.plot(XK[:, 0][yk==0], XK[:, 1][yk==0], "bs") +plt.plot(XK[:, 0][yk==1], XK[:, 1][yk==1], "g^") +plt.xlabel(r"$x_2$", fontsize=20) +plt.ylabel(r"$x_3$ ", fontsize=20, rotation=0) +plt.annotate(r'$\phi\left(\mathbf{x}\right)$', + xy=(XK[3, 0], XK[3, 1]), + xytext=(0.65, 0.50), + ha="center", + arrowprops=dict(facecolor='black', shrink=0.1), + fontsize=18, + ) +plt.plot([-0.1, 1.1], [0.57, -0.1], "r--", linewidth=3) +plt.axis([-0.1, 1.1, -0.1, 1.1]) + +plt.subplots_adjust(right=1) + +plt.show() + + +x1_example = X1D[3, 0] +for landmark in (-2, 1): + k = gaussian_rbf(np.array([[x1_example]]), np.array([[landmark]]), gamma) + print("Phi({}, {}) = {}".format(x1_example, landmark, k)) + +rbf_kernel_svm_clf = Pipeline([ + ("scaler", StandardScaler()), + ("svm_clf", SVC(kernel="rbf", gamma=5, C=0.001)) + ]) +rbf_kernel_svm_clf.fit(X, y) + + +from sklearn.svm import SVC + +gamma1, gamma2 = 0.1, 5 +C1, C2 = 0.001, 1000 +hyperparams = (gamma1, C1), (gamma1, C2), (gamma2, C1), (gamma2, C2) + +svm_clfs = [] +for gamma, C in hyperparams: + rbf_kernel_svm_clf = Pipeline([ + ("scaler", StandardScaler()), + ("svm_clf", SVC(kernel="rbf", gamma=gamma, C=C)) + ]) + rbf_kernel_svm_clf.fit(X, y) + svm_clfs.append(rbf_kernel_svm_clf) + +plt.figure(figsize=(11, 7)) + +for i, svm_clf in enumerate(svm_clfs): + plt.subplot(221 + i) + plot_predictions(svm_clf, [-1.5, 2.5, -1, 1.5]) + plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) + gamma, C = hyperparams[i] + plt.title(r"$\gamma = {}, C = {}$".format(gamma, C), fontsize=16) + +plt.show() + +!ec + + + + +===== Mathematical optimization of convex functions ===== + +A mathematical (quadratic) optimization problem, or just optimization problem, has the form +!bt +\begin{align*} + &\mathrm{min}_{\lambda}\hspace{0.2cm} \frac{1}{2}\bm{\lambda}^T\bm{P}\bm{\lambda}+\bm{q}^T\bm{\lambda},\\ \nonumber + &\mathrm{subject\hspace{0.1cm}to} \hspace{0.2cm} \bm{G}\bm{\lambda} \preceq \bm{h} \wedge \bm{A}\bm{\lambda}=f. +\end{align*} +!et +subject to some constraints for say a selected set $i=1,2,\dots, n$. +In our case we are optimizing with respect to the Lagrangian multipliers $\lambda_i$, and the +vector $\bm{\lambda}=[\lambda_1, \lambda_2,\dots, \lambda_n]$ is the optimization variable we are dealing with. + +In our case we are particularly interested in a class of optimization problems called convex optmization problems. +In our discussion on gradient descent methods we discussed at length the definition of a convex function. + +Convex optimization problems play a central role in applied mathematics and we recommend strongly "Boyd and Vandenberghe's text on the topics":"http://web.stanford.edu/~boyd/cvxbook/". + + + + +===== How do we solve these problems? ===== + +If we use Python as programming language and wish to venture beyond +_scikit-learn_, _tensorflow_ and similar software which makes our +lives so much easier, we need to dive into the wonderful world of +quadratic programming. We can, if we wish, solve the minimization +problem using say standard gradient methods or conjugate gradient +methods. However, these methods tend to exhibit a rather slow +converge. So, welcome to the promised land of quadratic programming. + +The functions we need are contained in the quadratic programming package _CVXOPT_ and we need to import it together with _numpy_ as + +!bc pycod +import numpy +import cvxopt +!ec + +This will make our life much easier. You don't need t write your own optimizer. + + + +===== A simple example ===== + +We remind ourselves about the general problem we want to solve +!bt +\begin{align*} + &\mathrm{min}_{x}\hspace{0.2cm} \frac{1}{2}\bm{x}^T\bm{P}\bm{x}+\bm{q}^T\bm{x},\\ \nonumber + &\mathrm{subject\hspace{0.1cm} to} \hspace{0.2cm} \bm{G}\bm{x} \preceq \bm{h} \wedge \bm{A}\bm{x}=f. +\end{align*} +!et + +Let us show how to perform the optmization using a simple case. Assume we want to optimize the following problem +!bt +\begin{align*} + &\mathrm{min}_{x}\hspace{0.2cm} \frac{1}{2}x^2+5x+3y \\ \nonumber + &\mathrm{subject to} \\ \nonumber + &x, y \geq 0 \\ \nonumber + &x+3y \geq 15 \\ \nonumber + &2x+5y \leq 100 \\ \nonumber + &3x+4y \leq 80. \\ \nonumber +\end{align*} +!et +The minimization problem can be rewritten in terms of vectors and matrices as (with $x$ and $y$ being the unknowns) +!bt +\[ +\frac{1}{2}\begin{bmatrix} x\\ y \end{bmatrix}^T \begin{bmatrix} 1 & 0\\ 0 & 0 \end{bmatrix} \begin{bmatrix} x \\ y \end{bmatrix} + \begin{bmatrix}3\\ 4 \end{bmatrix}^T \begin{bmatrix}x \\ y \end{bmatrix}. +\] +!et +Similarly, we can now set up the inequalities (we need to change $\geq$ to $\leq$ by multiplying with $-1$ on bot sides) as the following matrix-vector equation +!bt +\[ +\begin{bmatrix} -1 & 0 \\ 0 & -1 \\ -1 & -3 \\ 2 & 5 \\ 3 & 4\end{bmatrix}\begin{bmatrix} x \\ y\end{bmatrix} \preceq \begin{bmatrix}0 \\ 0\\ -15 \\ 100 \\ 80\end{bmatrix}. +\] +!et +We have collapsed all the inequalities into a single matrix $\bm{G}$. We see also that our matrix +!bt +\[ +\bm{P} =\begin{bmatrix} 1 & 0\\ 0 & 0 \end{bmatrix} +\] +!et +is clearly positive semi-definite (all eigenvalues larger or equal zero). +Finally, the vector $\bm{h}$ is defined as +!bt +\[ +\bm{h} = \begin{bmatrix}0 \\ 0\\ -15 \\ 100 \\ 80\end{bmatrix}. +\] +!et + + +Since we don't have any equalities the matrix $\bm{A}$ is set to zero +The following code solves the equations for us +!bc pycod +# Import the necessary packages +import numpy +from cvxopt import matrix +from cvxopt import solvers +P = matrix(numpy.diag([1,0]), tc=’d’) +q = matrix(numpy.array([3,4]), tc=’d’) +G = matrix(numpy.array([[-1,0],[0,-1],[-1,-3],[2,5],[3,4]]), tc=’d’) +h = matrix(numpy.array([0,0,-15,100,80]), tc=’d’) +# Construct the QP, invoke solver +sol = solvers.qp(P,q,G,h) +# Extract optimal value and solution +sol[’x’] +sol[’primal objective’] +!ec + + +===== Back to the more realistic cases ===== + +We are now ready to return to our setup of the optmization problem for a more realistic case. Introducing the _slack_ parameter $C$ we have +!bt +\[ +\frac{1}{2} \bm{\lambda}^T\begin{bmatrix} y_1y_1K(\bm{x}_1,\bm{x}_1) & y_1y_2K(\bm{x}_1,\bm{x}_2) & \dots & \dots & y_1y_nK(\bm{x}_1,\bm{x}_n) \\ +y_2y_1K(\bm{x}_2,\bm{x}_1) & y_2y_2K(\bm{x}_2,\bm{x}_2) & \dots & \dots & y_1y_nK(\bm{x}_2,\bm{x}_n) \\ +\dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots \\ +y_ny_1K(\bm{x}_n,\bm{x}_1) & y_ny_2K(\bm{x}_n\bm{x}_2) & \dots & \dots & y_ny_nK(\bm{x}_n,\bm{x}_n) \\ +\end{bmatrix}\bm{\lambda}-\mathbb{I}\bm{\lambda}, +\] +!et +subject to $\bm{y}^T\bm{\lambda}=0$. Here we defined the vectors $\bm{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]$ and +$\bm{y}=[y_1,y_2,\dots,y_n]$. +With the slack constants this leads to the additional constraint $0\leq \lambda_i \leq C$. + +_code will be added_ + + diff --git a/doc/src/SupportVMachines/chapter7.do.txt~ b/doc/src/SupportVMachines/chapter7.do.txt~ new file mode 100644 index 000000000..4ce89c8ef --- /dev/null +++ b/doc/src/SupportVMachines/chapter7.do.txt~ @@ -0,0 +1,1143 @@ +TITLE: Data Analysis and Machine Learning: Support Vector Machines +AUTHOR: Morten Hjorth-Jensen {copyright, 1999-present|CC BY-NC} at Department of Physics, University of Oslo & Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University +DATE: today + +!split +===== Support Vector Machines, overarching aims ===== + +A Support Vector Machine (SVM) is a very powerful and versatile +Machine Learning method, capable of performing linear or nonlinear +classification, regression, and even outlier detection. It is one of +the most popular models in Machine Learning, and anyone interested in +Machine Learning should have it in their toolbox. SVMs are +particularly well suited for classification of complex but small-sized or +medium-sized datasets. + +The case with two well-separated classes only can be understood in an +intuitive way in terms of lines in a two-dimensional space separating +the two classes (see figure below). + +The basic mathematics behind the SVM is however less familiar to most of us. +It relies on the definition of hyperplanes and the +definition of a _margin_ which separates classes (in case of +classification problems) of variables. It is also used for regression +problems. + +With SVMs we distinguish between hard margin and soft margins. The +latter introduces a so-called softening parameter to be discussed +below. We distinguish also between linear and non-linear +approaches. The latter are the most frequent ones since it is rather +unlikely that we can separate classes easily by say straight lines. + +!split +===== Hyperplanes and all that ===== + +The theory behind support vector machines (SVM hereafter) is based on +the mathematical description of so-called hyperplanes. Let us start +with a two-dimensional case. This will also allow us to introduce our +first SVM examples. These will be tailored to the case of two specific +classes, as displayed in the figure here based on the usage of the petal data. + +We assume here that our data set can be well separated into two +domains, where a straight line does the job in the separating the two +classes. Here the two classes are represented by either squares or +circles. +!bc pycod +from sklearn import datasets +from sklearn.svm import SVC, LinearSVC +from sklearn.linear_model import SGDClassifier +from sklearn.preprocessing import StandardScaler +import matplotlib +import matplotlib.pyplot as plt +plt.rcParams['axes.labelsize'] = 14 +plt.rcParams['xtick.labelsize'] = 12 +plt.rcParams['ytick.labelsize'] = 12 + + +iris = datasets.load_iris() +X = iris["data"][:, (2, 3)] # petal length, petal width +y = iris["target"] + +setosa_or_versicolor = (y == 0) | (y == 1) +X = X[setosa_or_versicolor] +y = y[setosa_or_versicolor] + + + +C = 5 +alpha = 1 / (C * len(X)) + +lin_clf = LinearSVC(loss="hinge", C=C, random_state=42) +svm_clf = SVC(kernel="linear", C=C) +sgd_clf = SGDClassifier(loss="hinge", learning_rate="constant", eta0=0.001, alpha=alpha, + max_iter=100000, random_state=42) + +scaler = StandardScaler() +X_scaled = scaler.fit_transform(X) + +lin_clf.fit(X_scaled, y) +svm_clf.fit(X_scaled, y) +sgd_clf.fit(X_scaled, y) + +print("LinearSVC: ", lin_clf.intercept_, lin_clf.coef_) +print("SVC: ", svm_clf.intercept_, svm_clf.coef_) +print("SGDClassifier(alpha={:.5f}):".format(sgd_clf.alpha), sgd_clf.intercept_, sgd_clf.coef_) + +# Compute the slope and bias of each decision boundary +w1 = -lin_clf.coef_[0, 0]/lin_clf.coef_[0, 1] +b1 = -lin_clf.intercept_[0]/lin_clf.coef_[0, 1] +w2 = -svm_clf.coef_[0, 0]/svm_clf.coef_[0, 1] +b2 = -svm_clf.intercept_[0]/svm_clf.coef_[0, 1] +w3 = -sgd_clf.coef_[0, 0]/sgd_clf.coef_[0, 1] +b3 = -sgd_clf.intercept_[0]/sgd_clf.coef_[0, 1] + +# Transform the decision boundary lines back to the original scale +line1 = scaler.inverse_transform([[-10, -10 * w1 + b1], [10, 10 * w1 + b1]]) +line2 = scaler.inverse_transform([[-10, -10 * w2 + b2], [10, 10 * w2 + b2]]) +line3 = scaler.inverse_transform([[-10, -10 * w3 + b3], [10, 10 * w3 + b3]]) + +# Plot all three decision boundaries +plt.figure(figsize=(11, 4)) +plt.plot(line1[:, 0], line1[:, 1], "k:", label="LinearSVC") +plt.plot(line2[:, 0], line2[:, 1], "b--", linewidth=2, label="SVC") +plt.plot(line3[:, 0], line3[:, 1], "r-", label="SGDClassifier") +plt.plot(X[:, 0][y==1], X[:, 1][y==1], "bs") # label="Iris-Versicolor" +plt.plot(X[:, 0][y==0], X[:, 1][y==0], "yo") # label="Iris-Setosa" +plt.xlabel("Petal length", fontsize=14) +plt.ylabel("Petal width", fontsize=14) +plt.legend(loc="upper center", fontsize=14) +plt.axis([0, 5.5, 0, 2]) + +plt.show() + + + +!ec + + + + +!split +===== What is a hyperplane? ===== + +The aim of the SVM algorithm is to find a hyperplane in a +$p$-dimensional space, where $p$ is the number of features that +distinctly classifies the data points. + +In a $p$-dimensional space, a hyperplane is what we call an affine subspace of dimension of $p-1$. +As an example, in two dimension, a hyperplane is simply as straight line while in three dimensions it is +a two-dimensional subspace, or stated simply, a plane. + +In two dimensions, with the variables $x_1$ and $x_2$, the hyperplane is defined as +!bt +\[ +b+w_1x_1+w_2x_2=0, +\] +!et + +where $b$ is the intercept and $w_1$ and $w_2$ define the elements of a vector orthogonal to the line +$b+w_1x_1+w_2x_2=0$. +In two dimensions we define the vectors $\bm{x} =[x1,x2]$ and $\bm{w}=[w1,w2]$. +We can then rewrite the above equation as + +!bt +\[ +\bm{x}^T\bm{w}+b=0. +\] +!et + +!split +===== A $p$-dimensional space of features ===== + +We limit ourselves to two classes of outputs $y_i$ and assign these classes the values $y_i = \pm 1$. +In a $p$-dimensional space of say $p$ features we have a hyperplane defines as +!bt +\[ +b+wx_1+w_2x_2+\dots +w_px_p=0. +\] +!et +If we define a +matrix $\bm{X}=\left[\bm{x}_1,\bm{x}_2,\dots, \bm{x}_p\right]$ +of dimension $n\times p$, where $n$ represents the observations for each feature and each vector $x_i$ is a column vector of the matrix $\bm{X}$, +!bt +\[ +\bm{x}_i = \begin{bmatrix} x_{i1} \\ x_{i2} \\ \dots \\ \dots \\ x_{ip} \end{bmatrix}. +\] +!et +If the above condition is not met for a given vector $\bm{x}_i$ we have +!bt +\[ +b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip} >0, +\] +!et +if our output $y_i=1$. +In this case we say that $\bm{x}_i$ lies on one of the sides of the hyperplane and if +!bt +\[ +b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip} < 0, +\] +!et +for the class of observations $y_i=-1$, +then $\bm{x}_i$ lies on the other side. + +Equivalently, for the two classes of observations we have +!bt +\[ +y_i\left(b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip}\right) > 0. +\] +!et + +When we try to separate hyperplanes, if it exists, we can use it to construct a natural classifier: a test observation is assigned a given class depending on which side of the hyperplane it is located. + +!split +===== The two-dimensional case ===== + +Let us try to develop our intuition about SVMs by limiting ourselves to a two-dimensional +plane. To separate the two classes of data points, there are many +possible lines (hyperplanes if you prefer a more strict naming) +that could be chosen. Our objective is to find a +plane that has the maximum margin, i.e the maximum distance between +data points of both classes. Maximizing the margin distance provides +some reinforcement so that future data points can be classified with +more confidence. + +What a linear classifier attempts to accomplish is to split the +feature space into two half spaces by placing a hyperplane between the +data points. This hyperplane will be our decision boundary. All +points on one side of the plane will belong to class one and all points +on the other side of the plane will belong to the second class two. + +Unfortunately there are many ways in which we can place a hyperplane +to divide the data. Below is an example of two candidate hyperplanes +for our data sample. + +!split +===== Getting into the details ===== + +Let us define the function +!bt +\[ +f(x) = \bm{w}^T\bm{x}+b = 0, +\] +!et +as the function that determines the line $L$ that separates two classes (our two features), see the figure here. + + +Any point defined by $\bm{x}_i$ and $\bm{x}_2$ on the line $L$ will satisfy $\bm{w}^T(\bm{x}_1-\bm{x}_2)=0$. + +The signed distance $\delta$ from any point defined by a vector $\bm{x}$ and a point $\bm{x}_0$ on the line $L$ is then +!bt +\[ +\delta = \frac{1}{\vert\vert \bm{w}\vert\vert}(\bm{w}^T\bm{x}+b). +\] +!et + +!split +===== First attempt at a minimization approach ===== + +How do we find the parameter $b$ and the vector $\bm{w}$? What we could +do is to define a cost function which now contains the set of all +misclassified points $M$ and attempt to minimize this function + +!bt +\[ +C(\bm{w},b) = -\sum_{i\in M} y_i(\bm{w}^T\bm{x}_i+b). +\] +!et + +We could now for example define all values $y_i =1$ as misclassified in case we have $\bm{w}^T\bm{x}_i+b < 0$ and the opposite if we have $y_i=-1$. Taking the derivatives gives us +!bt +\[ +\frac{\partial C}{\partial b} = -\sum_{i\in M} y_i, +\] +!et +and +!bt +\[ +\frac{\partial C}{\partial \bm{w}} = -\sum_{i\in M} y_ix_i. +\] +!et + +!split +===== Solving the equations ===== + +We can now use the Newton-Raphson method or different variants of the gradient descent family (from plain gradient descent to various stochastic gradient descent approaches) to solve the equations +!bt +\[ +b \leftarrow b +\eta \frac{\partial C}{\partial b}, +\] +!et +and +!bt +\[ +\bm{w} \leftarrow \bm{w} +\eta \frac{\partial C}{\partial \bm{w}}, +\] +!et +where $\eta$ is our by now well-known learning rate. + + +!split +===== Code Example ===== + +The equations we discussed above can be coded rather easily (the +framework is similar to what we developed for logistic +regression). We are going to set up a simple case with two classes only and we want to find a line which separates them the best possible way. +!bc pycod + +!ec + +!split +===== Problems with the Simpler Approach ===== + + +There are however problems with this approach, although it looks +pretty straightforward to implement. When running the above code, we see that we can easily end up with many diffeent lines which separate the two classes. + + +For small +gaps between the entries, we may also end up needing many iterations +before the solutions converge and if the data cannot be separated +properly into two distinct classes, we may not experience a converge +at all. + +!split +===== A better approach ===== + +A better approach is rather to try to define a large margin between +the two classes (if they are well separated from the beginning). + +Thus, we wish to find a margin $M$ with $\bm{w}$ normalized to +$\vert\vert \bm{w}\vert\vert =1$ subject to the condition + +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b) \geq M \hspace{0.1cm}\forall i=1,2,\dots, p. +\] +!et +All points are thus at a signed distance from the decision boundary defined by the line $L$. The parameters $b$ and $w_1$ and $w_2$ define this line. + +We seek thus the largest value $M$ defined by +!bt +\[ +\frac{1}{\vert \vert \bm{w}\vert\vert}y_i(\bm{w}^T\bm{x}_i+b) \geq M \hspace{0.1cm}\forall i=1,2,\dots, n, +\] +!et +or just +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b) \geq M\vert \vert \bm{w}\vert\vert \hspace{0.1cm}\forall i. +\] +!et +If we scale the equation so that $\vert \vert \bm{w}\vert\vert = 1/M$, we have to find the minimum of +$\bm{w}^T\bm{w}=\vert \vert \bm{w}\vert\vert$ (the norm) subject to the condition +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b) \geq 1 \hspace{0.1cm}\forall i. +\] +!et + +We have thus defined our margin as the invers of the norm of +$\bm{w}$. We want to minimize the norm in order to have a as large as +possible margin $M$. Before we proceed, we need to remind ourselves +about Lagrangian multipliers. + +!split +===== A quick Reminder on Lagrangian Multipliers ===== + +Consider a function of three independent variables $f(x,y,z)$ . For the function $f$ to be an +extreme we have +!bt +\[ +df=0. +\] +!et +A necessary and sufficient condition is +!bt +\[ +\frac{\partial f}{\partial x} =\frac{\partial f}{\partial y}=\frac{\partial f}{\partial z}=0, +\] +!et +due to +!bt +\[ +df = \frac{\partial f}{\partial x}dx+\frac{\partial f}{\partial y}dy+\frac{\partial f}{\partial z}dz. +\] +!et +In many problems the variables $x,y,z$ are often subject to constraints (such as those above for the margin) +so that they are no longer all independent. It is possible at least in principle to use each +constraint to eliminate one variable +and to proceed with a new and smaller set of independent varables. + +The use of so-called Lagrangian multipliers is an alternative technique when the elimination +of variables is incovenient or undesirable. Assume that we have an equation of constraint on +the variables $x,y,z$ +!bt +\[ +\phi(x,y,z) = 0, +\] +!et + resulting in +!bt +\[ +d\phi = \frac{\partial \phi}{\partial x}dx+\frac{\partial \phi}{\partial y}dy+\frac{\partial \phi}{\partial z}dz =0. +\] +!et +Now we cannot set anymore +!bt +\[ +\frac{\partial f}{\partial x} =\frac{\partial f}{\partial y}=\frac{\partial f}{\partial z}=0, +\] +!et +if $df=0$ is wanted +because there are now only two independent variables! Assume $x$ and $y$ are the independent +variables. +Then $dz$ is no longer arbitrary. + +!split +===== Adding the Multiplier ===== + +However, we can add to +!bt +\[ +df = \frac{\partial f}{\partial x}dx+\frac{\partial f}{\partial y}dy+\frac{\partial f}{\partial z}dz, +\] +!et +a multiplum of $d\phi$, viz. $\lambda d\phi$, resulting in +!bt +\[ +df+\lambda d\phi = (\frac{\partial f}{\partial z}+\lambda +\frac{\partial \phi}{\partial x})dx+(\frac{\partial f}{\partial y}+\lambda\frac{\partial \phi}{\partial y})dy+ +(\frac{\partial f}{\partial z}+\lambda\frac{\partial \phi}{\partial z})dz =0. +\] +!et +Our multiplier is chosen so that +!bt +\[ +\frac{\partial f}{\partial z}+\lambda\frac{\partial \phi}{\partial z} =0. +\] +!et + +We need to remember that we took $dx$ and $dy$ to be arbitrary and thus we must have +!bt +\[ +\frac{\partial f}{\partial x}+\lambda\frac{\partial \phi}{\partial x} =0, +\] +!et +and +!bt +\[ +\frac{\partial f}{\partial y}+\lambda\frac{\partial \phi}{\partial y} =0. +\] +!et +When all these equations are satisfied, $df=0$. We have four unknowns, $x,y,z$ and +$\lambda$. Actually we want only $x,y,z$, $\lambda$ needs not to be determined, +it is therefore often called +Lagrange's undetermined multiplier. +If we have a set of constraints $\phi_k$ we have the equations +!bt +\[ +\frac{\partial f}{\partial x_i}+\sum_k\lambda_k\frac{\partial \phi_k}{\partial x_i} =0. +\] +!et + +!split +===== Setting up the Problem ===== +In order to solve the above problem, we define the following Lagrangian function to be minimized +!bt +\[ +{\cal L}(\lambda,b,\bm{w})=\frac{1}{2}\bm{w}^T\bm{w}-\sum_{i=1}^n\lambda_i\left[y_i(\bm{w}^T\bm{x}_i+b)-1\right], +\] +!et +where $\lambda_i$ is a so-called Lagrange multiplier subject to the condition $\lambda_i \geq 0$. + +Taking the derivatives with respect to $b$ and $\bm{w}$ we obtain +!bt +\[ +\frac{\partial {\cal L}}{\partial b} = -\sum_{i} \lambda_iy_i=0, +\] +!et +and +!bt +\[ +\frac{\partial {\cal L}}{\partial \bm{w}} = 0 = \bm{w}-\sum_{i} \lambda_iy_i\bm{x}_i. +\] +!et +Inserting these constraints into the equation for ${\cal L}$ we obtain +!bt +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\bm{x}_i^T\bm{x}_j, +\] +!et +subject to the constraints $\lambda_i\geq 0$ and $\sum_i\lambda_iy_i=0$. +We must in addition satisfy the "Karush-Kuhn-Tucker":"https://en.wikipedia.org/wiki/Karush%E2%80%93Kuhn%E2%80%93Tucker_conditions" (KKT) condition +!bt +\[ +\lambda_i\left[y_i(\bm{w}^T\bm{x}_i+b) -1\right] \hspace{0.1cm}\forall i. +\] +!et +o If $\lambda_i > 0$, then $y_i(\bm{w}^T\bm{x}_i+b)=1$ and we say that $x_i$ is on the boundary. +o If $y_i(\bm{w}^T\bm{x}_i+b)> 1$, we say $x_i$ is not on the boundary and we set $\lambda_i=0$. +When $\lambda_i > 0$, the vectors $\bm{x}_i$ are called support vectors. They are the vectors closest to the line (or hyperplane) and define the margin $M$. + +!split +===== The problem to solve ===== + +We can rewrite +!bt +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\bm{x}_i^T\bm{x}_j, +\] +!et +and its constraints in terms of a matrix-vector problem where we minimize w.r.t. $\lambda$ the following problem +!bt +\[ +\frac{1}{2} \bm{\lambda}^T\begin{bmatrix} y_1y_1\bm{x}_1^T\bm{x}_1 & y_1y_2\bm{x}_1^T\bm{x}_2 & \dots & \dots & y_1y_n\bm{x}_1^T\bm{x}_n \\ +y_2y_1\bm{x}_2^T\bm{x}_1 & y_2y_2\bm{x}_2^T\bm{x}_2 & \dots & \dots & y_1y_n\bm{x}_2^T\bm{x}_n \\ +\dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots \\ +y_ny_1\bm{x}_n^T\bm{x}_1 & y_ny_2\bm{x}_n^T\bm{x}_2 & \dots & \dots & y_ny_n\bm{x}_n^T\bm{x}_n \\ +\end{bmatrix}\bm{\lambda}-\mathbb{1}\bm{\lambda}, +\] +!et +subject to $\bm{y}^T\bm{\lambda}=0$. Here we defined the vectors $\bm{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]$ and +$\bm{y}=[y_1,y_2,\dots,y_n]$. + + +!split +===== The last steps ===== + +Solving the above problem, yields the values of $\lambda_i$. +To find the coefficients of your hyperplane we need simply to compute +!bt +\[ +\bm{w}=\sum_{i} \lambda_iy_i\bm{x}_i. +\] +!et +With our vector $\bm{w}$ we can in turn find the value of the intercept $b$ (here in two dimensions) via +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b)=1, +\] +!et +resulting in +!bt +\[ +b = \frac{1}{y_i}-\bm{w}^T\bm{x}_i, +\] +!et +or if we write it out in terms of the support vectors only, with $N_s$ being their number, we have +!bt +\[ +b = \frac{1}{N_s}\sum_{j\in N_s}\left(y_j-\sum_{i=1}^n\lambda_iy_i\bm{x}_i^T\bm{x}_j\right). +\] +!et +With our hyperplane coefficients we can use our classifier to assign any observation by simply using +!bt +\[ +y_i = \mathrm{sign}(\bm{w}^T\bm{x}_i+b). +\] +!et +Below we discuss how to find the optimal values of $\lambda_i$. Before we proceed however, we discuss now the so-called soft classifier. + +!split +===== A soft classifier ===== + +Till now, the margin is strictly defined by the support vectors. This defines what is called a hard classifier, that is the margins are well defined. + +Suppose now that classes overlap in feature space, as shown in the +figure here. One way to deal with this problem before we define the +so-called _kernel approach_, is to allow a kind of slack in the sense +that we allow some points to be on the wrong side of the margin. + +We introduce thus the so-called _slack_ variables $\bm{\xi} =[\xi_1,x_2,\dots,x_n]$ and +modify our previous equation +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b)=1, +\] +!et +to +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b)=1-\xi_i, +\] +!et +with the requirement $\xi_i\geq 0$. The total violation is now $\sum_i\xi$. +The value $\xi_i$ in the constraint the last constraint corresponds to the amount by which the prediction +$y_i(\bm{w}^T\bm{x}_i+b)=1$ is on the wrong side of its margin. Hence by bounding the sum $\sum_i \xi_i$, +we bound the total amount by which predictions fall on the wrong side of their margins. + +Misclassifications occur when $\xi_i > 1$. Thus bounding the total sum by some value $C$ bounds in turn the total number of +misclassifications. + +!split +===== Soft optmization problem ===== + + +This has in turn the consequences that we change our optmization problem to finding the minimum of +!bt +\[ +{\cal L}=\frac{1}{2}\bm{w}^T\bm{w}-\sum_{i=1}^n\lambda_i\left[y_i(\bm{w}^T\bm{x}_i+b)-(1-\xi_)\right]+C\sum_{i=1}^n\xi_i-\sum_{i=1}^n\gamma_i\xi_i, +\] +!et +subject to +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b)=1-\xi_i \hspace{0.1cm}\forall i, +\] +!et +with the requirement $\xi_i\geq 0$. + +Taking the derivatives with respect to $b$ and $\bm{w}$ we obtain +!bt +\[ +\frac{\partial {\cal L}}{\partial b} = -\sum_{i} \lambda_iy_i=0, +\] +!et +and +!bt +\[ +\frac{\partial {\cal L}}{\partial \bm{w}} = 0 = \bm{w}-\sum_{i} \lambda_iy_i\bm{x}_i, +\] +!et +and +!bt +\[ +\lambda_i = C-\gamma_i \hspace{0.1cm}\forall i. +\] +!et +Inserting these constraints into the equation for ${\cal L}$ we obtain the same equation as before +!bt +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\bm{x}_i^T\bm{x}_j, +\] +!et +but now subject to the constraints $\lambda_i\geq 0$, $\sum_i\lambda_iy_i=0$ and $0\leq\lambda_i \leq C$. +We must in addition satisfy the Karush-Kuhn-Tucker condition which now reads +!bt +\[ +\lambda_i\left[y_i(\bm{w}^T\bm{x}_i+b) -(1-\xi_)\right]=0 \hspace{0.1cm}\forall i, +\] +!et +!bt +\[ +\gamma_i\xi_i = 0, +\] +!et +and +!bt +\[ +y_i(\bm{w}^T\bm{x}_i+b) -(1-\xi_) \geq 0 \hspace{0.1cm}\forall i. +\] +!et + +!split +===== Kernels and non-linearity ===== + +The cases we have studied till now, were all characterized by two classes +with a close to linear separability. The classifiers we have described +so far find linear boundaries in our input feature space. It is +possible to make our procedure more flexible by exploring the feature +space using other basis expansions such as higher-order polynomials, +wavelets, splines etc. + +If our feature space is not easy to separate, as shown in the figure +here, we can achieve a better separation by introducing more complex +basis functions. The ideal would be, as shown in the next figure, to, via a specific transformation to +obtain a separation between the classes which is almost linear. + +The change of basis, from $x\rightarrow z=\phi(x)$ leads to the same type of equations to be solved, except that +we need to introduce for example a polynomial transformation to a two-dimensional training set. + +!bc pycod +import numpy as np +import os + +np.random.seed(42) + +# To plot pretty figures +import matplotlib +import matplotlib.pyplot as plt +plt.rcParams['axes.labelsize'] = 14 +plt.rcParams['xtick.labelsize'] = 12 +plt.rcParams['ytick.labelsize'] = 12 + + +from sklearn.svm import SVC +from sklearn import datasets + + + +X1D = np.linspace(-4, 4, 9).reshape(-1, 1) +X2D = np.c_[X1D, X1D**2] +y = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0]) + +plt.figure(figsize=(11, 4)) + +plt.subplot(121) +plt.grid(True, which='both') +plt.axhline(y=0, color='k') +plt.plot(X1D[:, 0][y==0], np.zeros(4), "bs") +plt.plot(X1D[:, 0][y==1], np.zeros(5), "g^") +plt.gca().get_yaxis().set_ticks([]) +plt.xlabel(r"$x_1$", fontsize=20) +plt.axis([-4.5, 4.5, -0.2, 0.2]) + +plt.subplot(122) +plt.grid(True, which='both') +plt.axhline(y=0, color='k') +plt.axvline(x=0, color='k') +plt.plot(X2D[:, 0][y==0], X2D[:, 1][y==0], "bs") +plt.plot(X2D[:, 0][y==1], X2D[:, 1][y==1], "g^") +plt.xlabel(r"$x_1$", fontsize=20) +plt.ylabel(r"$x_2$", fontsize=20, rotation=0) +plt.gca().get_yaxis().set_ticks([0, 4, 8, 12, 16]) +plt.plot([-4.5, 4.5], [6.5, 6.5], "r--", linewidth=3) +plt.axis([-4.5, 4.5, -1, 17]) +plt.subplots_adjust(right=1) +plt.show() + +!ec + + + +!split +===== The equations ===== + +Suppose we define a polynomial transformation of degree two only (we continue to live in a plane with $x_i$ and $y_i$ as variables) +!bt +\[ +z = \phi(x_i) =\left(x_i^2, y_i^2, \sqrt{2}x_iy_i\right). +\] +!et + +With our new basis, the equations we solved earlier are basically the same, that is we have now (without the slack option for simplicity) +!bt +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\bm{z}_i^T\bm{z}_j, +\] +!et +subject to the constraints $\lambda_i\geq 0$, $\sum_i\lambda_iy_i=0$, and for the support vectors +!bt +\[ +y_i(\bm{w}^T\bm{z}_i+b)= 1 \hspace{0.1cm}\forall i, +\] +!et +from which we also find $b$. +To compute $\bm{z}_i^T\bm{z}_j$ we define the kernel $K(\bm{x}_i,\bm{x}_j)$ as +!bt +\[ +K(\bm{x}_i,\bm{x}_j)=\bm{z}_i^T\bm{z}_j= \phi(\bm{x}_i)^T\phi(\bm{x}_j). +\] +!et +For the above example, the kernel reads +!bt +\[ +K(\bm{x}_i,\bm{x}_j)=[x_i^2, y_i^2, \sqrt{2}x_iy_i]^T\begin{bmatrix} x_j^2 \\ y_j^2 \\ \sqrt{2}x_jy_j \end{bmatrix}=x_i^2x_j^2+2x_ix_jy_iy_j+y_i^2y_j^2. +\] +!et + +We note that this is nothing but the dot product of the two original +vectors $(\bm{x}_i^T\bm{x}_j)^2$. Instead of thus computing the +product in the Lagrangian of $\bm{z}_i^T\bm{z}_j$ we simply compute +the dot product $(\bm{x}_i^T\bm{x}_j)^2$. + + +This leads to the so-called +kernel trick and the result leads to the same as if we went through +the trouble of performing the transformation +$\phi(\bm{x}_i)^T\phi(\bm{x}_j)$ during the SVM calculations. + + +!split +===== The problem to solve ===== +Using our definition of the kernel We can rewrite again the Lagrangian +!bt +\[ +{\cal L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\bm{x}_i^T\bm{z}_j, +\] +!et +subject to the constraints $\lambda_i\geq 0$, $\sum_i\lambda_iy_i=0$ in terms of a convex optimization problem +!bt +\[ +\frac{1}{2} \bm{\lambda}^T\begin{bmatrix} y_1y_1K(\bm{x}_1,\bm{x}_1) & y_1y_2K(\bm{x}_1,\bm{x}_2) & \dots & \dots & y_1y_nK(\bm{x}_1,\bm{x}_n) \\ +y_2y_1K(\bm{x}_2,\bm{x}_1) & y_2y_2(\bm{x}_2,\bm{x}_2) & \dots & \dots & y_1y_nK(\bm{x}_2,\bm{x}_n) \\ +\dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots \\ +y_ny_1K(\bm{x}_n,\bm{x}_1) & y_ny_2K(\bm{x}_n\bm{x}_2) & \dots & \dots & y_ny_nK(\bm{x}_n,\bm{x}_n) \\ +\end{bmatrix}\bm{\lambda}-\mathbb{1}\bm{\lambda}, +\] +!et +subject to $\bm{y}^T\bm{\lambda}=0$. Here we defined the vectors $\bm{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]$ and +$\bm{y}=[y_1,y_2,\dots,y_n]$. +If we add the slack constants this leads to the additional constraint $0\leq \lambda_i \leq C$. + +We can rewrite this (see the solutions below) in terms of a convex optimization problem of the type +!bt +\begin{align*} + &\mathrm{min}_{\lambda}\hspace{0.2cm} \frac{1}{2}\bm{\lambda}^T\bm{P}\bm{\lambda}+\bm{q}^T\bm{\lambda},\\ \nonumber + &\mathrm{subject\hspace{0.1cm}to} \hspace{0.2cm} \bm{G}\bm{\lambda} \preceq \bm{h} \hspace{0.2cm} \wedge \bm{A}\bm{\lambda}=f. +\end{align*} +!et +Below we discuss how to solve these equations. Here we note that the matrix $\bm{P}$ has matrix elements $p_{ij}=y_iy_jK(\bm{x}_i,\bm{x}_j)$. +Given a kernel $K$ and the targets $y_i$ this matrix is easy to set up. The constraint $\bm{y}^T\bm{\lambda}=0$ leads to $f=0$ and $\bm{A}=\bm{y}$. How to set up the matrix $\bm{G}$ is discussed later. Here note that the inequalities $0\leq \lambda_i \leq C$ can be split up into +$0\leq \lambda_i$ and $\lambda_i \leq C$. These two inequalities define then the matrix $\bm{G}$ and the vector $\bm{h}$. + + +!split +===== Different kernels and Mercer's theorem ===== + +There are several popular kernels being used. These are +o Linear: $K(\bm{x},\bm{y})=\bm{x}^T\bm{y}$, +o Polynomial: $K(\bm{x},\bm{y})=(\bm{x}^T\bm{y}+\gamma)^d$, +o Gaussian Radial Basis Function: $K(\bm{x},\bm{y})=\exp{\left(-\gamma\vert\vert\bm{x}-\bm{y}\vert\vert^2\right)}$, +o Tanh: $K(\bm{x},\bm{y})=\tanh{(\bm{x}^T\bm{y}+\gamma)}$, +and many other ones. + +An important theorem for us is "Mercer's +theorem":"https://en.wikipedia.org/wiki/Mercer%27s_theorem". The +theorem states that if a kernel function $K$ is symmetric, continuous +and leads to a positive semi-definite matrix $\bm{P}$ then there +exists a function $\phi$ that maps $\bm{x}_i$ and $\bm{x}_j$ into +another space (possibly with much higher dimensions) such that + +!bt +\[ +K(\bm{x}_i,\bm{x}_j)=\phi(\bm{x}_i)^T\phi(\bm{x}_j). +\] +!et + +So you can use $K$ as a kernel since you know $\phi$ exists, even if +you don’t know what $\phi$ is. + +Note that some frequently used kernels (such as the Sigmoid kernel) +don’t respect all of Mercer’s conditions, yet they generally work well +in practice. + + +!split +===== The moons example ===== +!bc pycod +from __future__ import division, print_function, unicode_literals + +import numpy as np +np.random.seed(42) + +import matplotlib +import matplotlib.pyplot as plt +plt.rcParams['axes.labelsize'] = 14 +plt.rcParams['xtick.labelsize'] = 12 +plt.rcParams['ytick.labelsize'] = 12 + + +from sklearn.svm import SVC +from sklearn import datasets + + + +from sklearn.pipeline import Pipeline +from sklearn.preprocessing import StandardScaler +from sklearn.svm import LinearSVC + + +from sklearn.datasets import make_moons +X, y = make_moons(n_samples=100, noise=0.15, random_state=42) + +def plot_dataset(X, y, axes): + plt.plot(X[:, 0][y==0], X[:, 1][y==0], "bs") + plt.plot(X[:, 0][y==1], X[:, 1][y==1], "g^") + plt.axis(axes) + plt.grid(True, which='both') + plt.xlabel(r"$x_1$", fontsize=20) + plt.ylabel(r"$x_2$", fontsize=20, rotation=0) + +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) +plt.show() + +from sklearn.datasets import make_moons +from sklearn.pipeline import Pipeline +from sklearn.preprocessing import PolynomialFeatures + +polynomial_svm_clf = Pipeline([ + ("poly_features", PolynomialFeatures(degree=3)), + ("scaler", StandardScaler()), + ("svm_clf", LinearSVC(C=10, loss="hinge", random_state=42)) + ]) + +polynomial_svm_clf.fit(X, y) + +def plot_predictions(clf, axes): + x0s = np.linspace(axes[0], axes[1], 100) + x1s = np.linspace(axes[2], axes[3], 100) + x0, x1 = np.meshgrid(x0s, x1s) + X = np.c_[x0.ravel(), x1.ravel()] + y_pred = clf.predict(X).reshape(x0.shape) + y_decision = clf.decision_function(X).reshape(x0.shape) + plt.contourf(x0, x1, y_pred, cmap=plt.cm.brg, alpha=0.2) + plt.contourf(x0, x1, y_decision, cmap=plt.cm.brg, alpha=0.1) + +plot_predictions(polynomial_svm_clf, [-1.5, 2.5, -1, 1.5]) +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) + +plt.show() + + +from sklearn.svm import SVC + +poly_kernel_svm_clf = Pipeline([ + ("scaler", StandardScaler()), + ("svm_clf", SVC(kernel="poly", degree=3, coef0=1, C=5)) + ]) +poly_kernel_svm_clf.fit(X, y) + +poly100_kernel_svm_clf = Pipeline([ + ("scaler", StandardScaler()), + ("svm_clf", SVC(kernel="poly", degree=10, coef0=100, C=5)) + ]) +poly100_kernel_svm_clf.fit(X, y) + +plt.figure(figsize=(11, 4)) + +plt.subplot(121) +plot_predictions(poly_kernel_svm_clf, [-1.5, 2.5, -1, 1.5]) +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) +plt.title(r"$d=3, r=1, C=5$", fontsize=18) + +plt.subplot(122) +plot_predictions(poly100_kernel_svm_clf, [-1.5, 2.5, -1, 1.5]) +plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) +plt.title(r"$d=10, r=100, C=5$", fontsize=18) + +plt.show() + +def gaussian_rbf(x, landmark, gamma): + return np.exp(-gamma * np.linalg.norm(x - landmark, axis=1)**2) + +gamma = 0.3 + +x1s = np.linspace(-4.5, 4.5, 200).reshape(-1, 1) +x2s = gaussian_rbf(x1s, -2, gamma) +x3s = gaussian_rbf(x1s, 1, gamma) + +XK = np.c_[gaussian_rbf(X1D, -2, gamma), gaussian_rbf(X1D, 1, gamma)] +yk = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0]) + +plt.figure(figsize=(11, 4)) + +plt.subplot(121) +plt.grid(True, which='both') +plt.axhline(y=0, color='k') +plt.scatter(x=[-2, 1], y=[0, 0], s=150, alpha=0.5, c="red") +plt.plot(X1D[:, 0][yk==0], np.zeros(4), "bs") +plt.plot(X1D[:, 0][yk==1], np.zeros(5), "g^") +plt.plot(x1s, x2s, "g--") +plt.plot(x1s, x3s, "b:") +plt.gca().get_yaxis().set_ticks([0, 0.25, 0.5, 0.75, 1]) +plt.xlabel(r"$x_1$", fontsize=20) +plt.ylabel(r"Similarity", fontsize=14) +plt.annotate(r'$\mathbf{x}$', + xy=(X1D[3, 0], 0), + xytext=(-0.5, 0.20), + ha="center", + arrowprops=dict(facecolor='black', shrink=0.1), + fontsize=18, + ) +plt.text(-2, 0.9, "$x_2$", ha="center", fontsize=20) +plt.text(1, 0.9, "$x_3$", ha="center", fontsize=20) +plt.axis([-4.5, 4.5, -0.1, 1.1]) + +plt.subplot(122) +plt.grid(True, which='both') +plt.axhline(y=0, color='k') +plt.axvline(x=0, color='k') +plt.plot(XK[:, 0][yk==0], XK[:, 1][yk==0], "bs") +plt.plot(XK[:, 0][yk==1], XK[:, 1][yk==1], "g^") +plt.xlabel(r"$x_2$", fontsize=20) +plt.ylabel(r"$x_3$ ", fontsize=20, rotation=0) +plt.annotate(r'$\phi\left(\mathbf{x}\right)$', + xy=(XK[3, 0], XK[3, 1]), + xytext=(0.65, 0.50), + ha="center", + arrowprops=dict(facecolor='black', shrink=0.1), + fontsize=18, + ) +plt.plot([-0.1, 1.1], [0.57, -0.1], "r--", linewidth=3) +plt.axis([-0.1, 1.1, -0.1, 1.1]) + +plt.subplots_adjust(right=1) + +plt.show() + + +x1_example = X1D[3, 0] +for landmark in (-2, 1): + k = gaussian_rbf(np.array([[x1_example]]), np.array([[landmark]]), gamma) + print("Phi({}, {}) = {}".format(x1_example, landmark, k)) + +rbf_kernel_svm_clf = Pipeline([ + ("scaler", StandardScaler()), + ("svm_clf", SVC(kernel="rbf", gamma=5, C=0.001)) + ]) +rbf_kernel_svm_clf.fit(X, y) + + +from sklearn.svm import SVC + +gamma1, gamma2 = 0.1, 5 +C1, C2 = 0.001, 1000 +hyperparams = (gamma1, C1), (gamma1, C2), (gamma2, C1), (gamma2, C2) + +svm_clfs = [] +for gamma, C in hyperparams: + rbf_kernel_svm_clf = Pipeline([ + ("scaler", StandardScaler()), + ("svm_clf", SVC(kernel="rbf", gamma=gamma, C=C)) + ]) + rbf_kernel_svm_clf.fit(X, y) + svm_clfs.append(rbf_kernel_svm_clf) + +plt.figure(figsize=(11, 7)) + +for i, svm_clf in enumerate(svm_clfs): + plt.subplot(221 + i) + plot_predictions(svm_clf, [-1.5, 2.5, -1, 1.5]) + plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) + gamma, C = hyperparams[i] + plt.title(r"$\gamma = {}, C = {}$".format(gamma, C), fontsize=16) + +plt.show() + +!ec + + + +!split +===== Mathematical optimization of convex functions ===== + +A mathematical (quadratic) optimization problem, or just optimization problem, has the form +!bt +\begin{align*} + &\mathrm{min}_{\lambda}\hspace{0.2cm} \frac{1}{2}\bm{\lambda}^T\bm{P}\bm{\lambda}+\bm{q}^T\bm{\lambda},\\ \nonumber + &\mathrm{subject\hspace{0.1cm}to} \hspace{0.2cm} \bm{G}\bm{\lambda} \preceq \bm{h} \wedge \bm{A}\bm{\lambda}=f. +\end{align*} +!et +subject to some constraints for say a selected set $i=1,2,\dots, n$. +In our case we are optimizing with respect to the Lagrangian multipliers $\lambda_i$, and the +vector $\bm{\lambda}=[\lambda_1, \lambda_2,\dots, \lambda_n]$ is the optimization variable we are dealing with. + +In our case we are particularly interested in a class of optimization problems called convex optmization problems. +In our discussion on gradient descent methods we discussed at length the definition of a convex function. + +Convex optimization problems play a central role in applied mathematics and we recommend strongly "Boyd and Vandenberghe's text on the topics":"http://web.stanford.edu/~boyd/cvxbook/". + + + +!split +===== How do we solve these problems? ===== + +If we use Python as programming language and wish to venture beyond +_scikit-learn_, _tensorflow_ and similar software which makes our +lives so much easier, we need to dive into the wonderful world of +quadratic programming. We can, if we wish, solve the minimization +problem using say standard gradient methods or conjugate gradient +methods. However, these methods tend to exhibit a rather slow +converge. So, welcome to the promised land of quadratic programming. + +The functions we need are contained in the quadratic programming package _CVXOPT_ and we need to import it together with _numpy_ as + +!bc pycod +import numpy +import cvxopt +!ec + +This will make our life much easier. You don't need t write your own optimizer. + + +!split +===== A simple example ===== + +We remind ourselves about the general problem we want to solve +!bt +\begin{align*} + &\mathrm{min}_{x}\hspace{0.2cm} \frac{1}{2}\bm{x}^T\bm{P}\bm{x}+\bm{q}^T\bm{x},\\ \nonumber + &\mathrm{subject\hspace{0.1cm} to} \hspace{0.2cm} \bm{G}\bm{x} \preceq \bm{h} \wedge \bm{A}\bm{x}=f. +\end{align*} +!et + +Let us show how to perform the optmization using a simple case. Assume we want to optimize the following problem +!bt +\begin{align*} + &\mathrm{min}_{x}\hspace{0.2cm} \frac{1}{2}x^2+5x+3y \\ \nonumber + &\mathrm{subject to} \\ \nonumber + &x, y \geq 0 \\ \nonumber + &x+3y \geq 15 \\ \nonumber + &2x+5y \leq 100 \\ \nonumber + &3x+4y \leq 80. \\ \nonumber +\end{align*} +!et +The minimization problem can be rewritten in terms of vectors and matrices as (with $x$ and $y$ being the unknowns) +!bt +\[ +\frac{1}{2}\begin{bmatrix} x\\ y \end{bmatrix}^T \begin{bmatrix} 1 & 0\\ 0 & 0 \end{bmatrix} \begin{bmatrix} x \\ y \end{bmatrix} + \begin{bmatrix}3\\ 4 \end{bmatrix}^T \begin{bmatrix}x \\ y \end{bmatrix}. +\] +!et +Similarly, we can now set up the inequalities (we need to change $\geq$ to $\leq$ by multiplying with $-1$ on bot sides) as the following matrix-vector equation +!bt +\[ +\begin{bmatrix} -1 & 0 \\ 0 & -1 \\ -1 & -3 \\ 2 & 5 \\ 3 & 4\end{bmatrix}\begin{bmatrix} x \\ y\end{bmatrix} \preceq \begin{bmatrix}0 \\ 0\\ -15 \\ 100 \\ 80\end{bmatrix}. +\] +!et +We have collapsed all the inequalities into a single matrix $\bm{G}$. We see also that our matrix +!bt +\[ +\bm{P} =\begin{bmatrix} 1 & 0\\ 0 & 0 \end{bmatrix} +\] +!et +is clearly positive semi-definite (all eigenvalues larger or equal zero). +Finally, the vector $\bm{h}$ is defined as +!bt +\[ +\bm{h} = \begin{bmatrix}0 \\ 0\\ -15 \\ 100 \\ 80\end{bmatrix}. +\] +!et + + +Since we don't have any equalities the matrix $\bm{A}$ is set to zero +The following code solves the equations for us +!bc pycod +# Import the necessary packages +import numpy +from cvxopt import matrix +from cvxopt import solvers +P = matrix(numpy.diag([1,0]), tc=’d’) +q = matrix(numpy.array([3,4]), tc=’d’) +G = matrix(numpy.array([[-1,0],[0,-1],[-1,-3],[2,5],[3,4]]), tc=’d’) +h = matrix(numpy.array([0,0,-15,100,80]), tc=’d’) +# Construct the QP, invoke solver +sol = solvers.qp(P,q,G,h) +# Extract optimal value and solution +sol[’x’] +sol[’primal objective’] +!ec + +!split +===== Back to the more realistic cases ===== + +We are now ready to return to our setup of the optmization problem for a more realistic case. Introducing the _slack_ parameter $C$ we have +!bt +\[ +\frac{1}{2} \bm{\lambda}^T\begin{bmatrix} y_1y_1K(\bm{x}_1,\bm{x}_1) & y_1y_2K(\bm{x}_1,\bm{x}_2) & \dots & \dots & y_1y_nK(\bm{x}_1,\bm{x}_n) \\ +y_2y_1K(\bm{x}_2,\bm{x}_1) & y_2y_2K(\bm{x}_2,\bm{x}_2) & \dots & \dots & y_1y_nK(\bm{x}_2,\bm{x}_n) \\ +\dots & \dots & \dots & \dots & \dots \\ +\dots & \dots & \dots & \dots & \dots \\ +y_ny_1K(\bm{x}_n,\bm{x}_1) & y_ny_2K(\bm{x}_n\bm{x}_2) & \dots & \dots & y_ny_nK(\bm{x}_n,\bm{x}_n) \\ +\end{bmatrix}\bm{\lambda}-\mathbb{I}\bm{\lambda}, +\] +!et +subject to $\bm{y}^T\bm{\lambda}=0$. Here we defined the vectors $\bm{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]$ and +$\bm{y}=[y_1,y_2,\dots,y_n]$. +With the slack constants this leads to the additional constraint $0\leq \lambda_i \leq C$. + +_code will be added_ + +