{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Momentum from scratch\n", "\n", "As discussed in the [previous chapter](./gd-sgd.ipynb), \n", "at each iteration stochastic gradient descent (SGD) finds the direction \n", "where the objective function can be reduced fastest on a given example. \n", "Thus, gradient descent is also known as the method of steepest descent. \n", "Essentially, SGD is a myopic algorithm. \n", "It doesn't look very far into the past and it doesn't think much about the future.\n", "At each step, SGD just does whatever looks right just at that moment. \n", "\n", "You might wonder, can we do something smarter? \n", "It turns out that we can. \n", "One class of methods use an idea called *momentum*.\n", "The idea of momentum-based optimizers is to \n", "remember the previous gradients from recent optimization steps\n", "and to use them to help to do a better job of choosing the direction to move next,\n", "acting less like a drunk student walking downhill and more like a rolling ball.In this chapter we'll motivate and explain SGD with momentum.\n" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Motivating example\n", "\n", "In order to motivate the method, let's start by visualizing a simple quadratic objective function \n", "$f: \\mathbb{R}^2 \\rightarrow \\mathbb{R}$ taking a two-dimensional vector \n", "$\\mathbf{x} = [x_1, x_2]^\\top$ as the input. \n", "In the following figure, each contour line indicates points of equivalent value $f(\\mathbf{x})$. \n", "The objective function is minimized in the center and the outer rings have progressively worse values.\n", "\n", "The red triangle indicates the starting point for our stochastic gradient descent optimizer.\n", "The lines and arrows that follow indicate each step of SGD. \n", "You might wonder why the lines don't just point directly towards the center.\n", "That's because the gradient estimates in SGD are noisy, due to the small sample size. \n", "So the gradient steps are noisy even if they are correct on average (unbiased). \n", "As you can see, SGD wastes too much time swinging back and forth \n", "along the direction in parallel with the $x_2$-axis \n", "while advancing too slowly along the direction of the $x_1$-axis.\n", "\n", "![](../img/gd-move.png)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Curvature and Hessian matrix\n", "\n", "Even if we just did plain old gradient descent, we'd expect our function to bounce around quite a lot. \n", "That's because our gradient is changing as we move around in parameter space due to the curvature of the function.\n", "\n", "We can reason about the curvature of objective function by considering their second derivative. The second derivative says how much the gradient changes as we move in parameter space.\n", "In one dimension, a second derivative of a function \n", "indicates how fast the first derivative changes when the input changes. \n", "Thus, it is often considered as a measure of the **curvature** of a function. \n", "*It is the rate of change of the rate of change*. \n", "If you've never done calculus before, that might sound rather *meta*,\n", "but you'll get over it.\n", "\n", "Consider the objective function $f: \\mathbb{R}^d \\rightarrow \\mathbb{R}$ \n", "that takes a multi-dimensional vector $\\mathbf{x} = [x_1, x_2, \\ldots, x_d]^\\top$ as the input.\n", "Its **Hessian matrix** $\\mathbf{H} \\in \\mathbb{R}^{d \\times d}$ collects its second derivatives.\n", "Each entry $(i, j)$ says how much the gradient of the objective with respect to parameter $i$ changes,\n", "with a small change in parameter $j$.\n", "\n", "$$\\mathbf{H}_{i,j} = \\frac{\\partial^2 f(\\mathbf{x})}{\\partial x_i \\partial x_j}$$\n", "\n", "for all $i, j = 1, \\ldots, d$. Since $\\mathbf{H}$ is a real symmetric matrix, by spectral theorem, it is orthogonally diagonalizable as\n", "\n", "$$ \\mathbf{S}^\\top \\mathbf{H} \\mathbf{S} = \\mathbf{\\Lambda},$$\n", "\n", "where $\\mathbf{S}$ is an orthonormal eigenbasis composed of eigenvectors of $\\mathbf{H}$ with corresponding eigenvalues in a diagonal matrix $\\mathbf{\\Lambda}$: the eigenvalue $\\mathbf{\\Lambda}_{i, i}$ corresponds to the eigenvector in the $i^{\\text{th}}$ column of $\\mathbf{S}$. The second derivative (curvature) of the objective function $f$ in any direction $\\mathbf{d}$ (unit vector) is a quadratic form $\\mathbf{d}^\\top \\mathbf{H} \\mathbf{d}$. Specifically, if the direction $\\mathbf{d}$ is an eigenvector of $\\mathbf{H}$, the curvature of $f$ in that direction is equal to the corresponding eigenvalue of $\\mathbf{d}$. Since the curvature of the objective function in any direction is a weighted average of all the eigenvalues of the Hessian matrix, the curvature is bounded by the minimum and maximum eigenvalues of the Hessian matrix $\\mathbf{H}$. The ratio of the maximum to the minimum eigenvalue is the **condition number** of the Hessian matrix $\\mathbf{H}$. " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Gradient descent in ill-conditioned problems\n", "\n", "How does the condition number of the Hessian matrix of the objective function affect the performance of gradient descent? Let us revisit the problem in the motivating example. " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Recall that gradient descent is a greedy approach that selects the steepest gradient at the current point as the direction of advancement. At the starting point, the search by gradient descent advances more aggressively in the direction of the $x_2$-axis than that of the $x_1$-axis. \n", "\n", "In the plotted problem of the motivating example, the curvature in the direction of the $x_2$-axis is much larger than that of the $x_1$-axis. Thus, gradient descent tends to overshoot the bottom of the function that is projected to the plane in parallel with the $x_2$-axis. At the next iteration, if the gradient along the direction in parallel with the $x_2$-axis remains larger, the search continues to advance more aggressively along the direction in parallel with the $x_2$-axis and the overshooting continues to take place. As a result, gradient descent wastes too much time swinging back and forth in parallel with the $x_2$-axis due to overshooting while the advancement in the direction of the $x_1$-axis is too slow.\n", "\n", "To generalize, the problem in the motivating example is an ill-conditioned problem. In an ill-conditioned problem, the condition number of the Hessian matrix of the objective function is large. In other words, the ratio of the largest curvature to the smallest is high." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## The momentum algorithm\n", "\n", "The aforementioned ill-conditioned problems are challenging for gradient descent. By treating gradient descent as a special form of stochastic gradient descent, we can address the challenge with the following momentum algorithm for stochastic gradient descent.\n", "\n", "$$\n", "\\begin{align*}\n", "\\mathbf{v} &:= \\gamma \\mathbf{v} + \\eta \\nabla f_\\mathcal{B}(\\mathbf{x}),\\\\\n", "\\mathbf{x} &:= \\mathbf{x} - \\mathbf{v},\n", "\\end{align*}\n", "$$\n", "\n", "where $\\mathbf{v}$ is the current velocity and $\\gamma$ is the momentum parameter. The learning rate $\\eta$ and the stochastic gradient $\\nabla f_\\mathcal{B}(\\mathbf{x})$ with respect to the sampled mini-batch $\\mathcal{B}$ are both defined in the [previous chapter](./gd-sgd.ipynb).\n", "\n", "It is important to highlight that, the scale of advancement at each iteration now also depends on how aligned the directions of the past gradients are. This scale is the largest when all the past gradients are perfectly aligned to the same direction. \n", "\n", "To better understand the momentum parameter $\\gamma$, let us simplify the scenario by assuming the stochastic gradients $\\nabla f_\\mathcal{B}(\\mathbf{x})$ are the same as $\\mathbf{g}$ throughout the iterations. Since all the gradients are perfectly aligned to the same direction, the momentum algorithm accelerates the advancement along the same direction of $\\mathbf{g}$ as\n", "\n", "$$\n", "\\begin{align*}\n", "\\mathbf{v}_1 &:= \\eta\\mathbf{g},\\\\\n", "\\mathbf{v}_2 &:= \\gamma \\mathbf{v}_1 + \\eta\\mathbf{g} = \\eta\\mathbf{g} (\\gamma + 1),\\\\\n", "\\mathbf{v}_3 &:= \\gamma \\mathbf{v}_2 + \\eta\\mathbf{g} = \\eta\\mathbf{g} (\\gamma^2 + \\gamma + 1),\\\\\n", "&\\ldots\\\\\n", "\\mathbf{v}_\\inf &:= \\frac{\\eta\\mathbf{g}}{1 - \\gamma}.\n", "\\end{align*}\n", "$$\n", "\n", "Thus, if $\\gamma = 0.99$, the final velocity is 100 times faster than that of the corresponding gradient descent where the gradient is $\\mathbf{g}$. \n", "\n", "Now with the momentum algorithm, a sample search path can be improved as illustrated in the following figure.\n", "\n", "![](../img/momentum-move.png)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Experiments\n", "\n", "For demonstrating the momentum algorithm, we still use the regression problem in the [linear regression chapter](../chapter02_supervised-learning/linear-regression-scratch.ipynb) as a case study. Specifically, we investigate stochastic gradient descent with momentum.\n" ] }, { "cell_type": "code", "execution_count": 1, "metadata": { "ExecuteTime": { "end_time": "2017-10-22T11:36:05.650884Z", "start_time": "2017-10-22T11:36:05.637683Z" } }, "outputs": [], "source": [ "\n", "def sgd_momentum(params, vs, lr, mom, batch_size):\n", " for param, v in zip(params, vs):\n", " v[:] = mom * v + lr * param.grad / batch_size\n", " param[:] = param - v" ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "ExecuteTime": { "end_time": "2017-10-22T11:36:06.372941Z", "start_time": "2017-10-22T11:36:05.655231Z" } }, "outputs": [], "source": [ "import mxnet as mx\n", "from mxnet import autograd\n", "from mxnet import ndarray as nd\n", "from mxnet import gluon\n", "import random\n", "\n", "mx.random.seed(1)\n", "random.seed(1)\n", "\n", "# Generate data.\n", "num_inputs = 2\n", "num_examples = 1000\n", "true_w = [2, -3.4]\n", "true_b = 4.2\n", "X = nd.random_normal(scale=1, shape=(num_examples, num_inputs))\n", "y = true_w[0] * X[:, 0] + true_w[1] * X[:, 1] + true_b\n", "y += .01 * nd.random_normal(scale=1, shape=y.shape)\n", "dataset = gluon.data.ArrayDataset(X, y)\n", "\n", "\n", "# Construct data iterator.\n", "def data_iter(batch_size):\n", " idx = list(range(num_examples))\n", " random.shuffle(idx)\n", " for batch_i, i in enumerate(range(0, num_examples, batch_size)):\n", " j = nd.array(idx[i: min(i + batch_size, num_examples)])\n", " yield batch_i, X.take(j), y.take(j)\n", "\n", "# Initialize model parameters.\n", "def init_params():\n", " w = nd.random_normal(scale=1, shape=(num_inputs, 1))\n", " b = nd.zeros(shape=(1,))\n", " params = [w, b]\n", " vs = []\n", " for param in params:\n", " param.attach_grad()\n", " # \n", " vs.append(param.zeros_like())\n", " return params, vs\n", "\n", "# Linear regression.\n", "def net(X, w, b):\n", " return nd.dot(X, w) + b\n", "\n", "# Loss function.\n", "def square_loss(yhat, y):\n", " return (yhat - y.reshape(yhat.shape)) ** 2 / 2" ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "ExecuteTime": { "end_time": "2017-10-22T11:36:06.602619Z", "start_time": "2017-10-22T11:36:06.374712Z" } }, "outputs": [], "source": [ "%matplotlib inline\n", "import matplotlib as mpl\n", "mpl.rcParams['figure.dpi']= 120\n", "import matplotlib.pyplot as plt\n", "import numpy as np\n", "\n", "def train(batch_size, lr, mom, epochs, period):\n", " assert period >= batch_size and period % batch_size == 0\n", " [w, b], vs = init_params()\n", " total_loss = [np.mean(square_loss(net(X, w, b), y).asnumpy())]\n", "\n", " # Epoch starts from 1.\n", " for epoch in range(1, epochs + 1):\n", " # Decay learning rate.\n", " if epoch > 2:\n", " lr *= 0.1\n", " for batch_i, data, label in data_iter(batch_size):\n", " with autograd.record():\n", " output = net(data, w, b)\n", " loss = square_loss(output, label)\n", " loss.backward()\n", " sgd_momentum([w, b], vs, lr, mom, batch_size)\n", " if batch_i * batch_size % period == 0:\n", " total_loss.append(np.mean(square_loss(net(X, w, b), y).asnumpy()))\n", " print(\"Batch size %d, Learning rate %f, Epoch %d, loss %.4e\" % \n", " (batch_size, lr, epoch, total_loss[-1]))\n", " print('w:', np.reshape(w.asnumpy(), (1, -1)), \n", " 'b:', b.asnumpy()[0], '\\n')\n", " x_axis = np.linspace(0, epochs, len(total_loss), endpoint=True)\n", " plt.semilogy(x_axis, total_loss)\n", " plt.xlabel('epoch')\n", " plt.ylabel('loss')\n", " plt.show()" ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "ExecuteTime": { "end_time": "2017-10-22T11:36:07.752280Z", "start_time": "2017-10-22T11:36:06.604411Z" } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Batch size 10, Learning rate 0.200000, Epoch 1, loss 3.4819e-04\n", "Batch size 10, Learning rate 0.200000, Epoch 2, loss 6.6014e-05\n", "Batch size 10, Learning rate 0.020000, Epoch 3, loss 5.0524e-05\n", "w: [[ 1.99991071 -3.39920688]] b: 4.19865 \n", "\n" ] }, { "data": { "image/png": "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\nREREROL2/wGsL35CEzRvHwAAAABJRU5ErkJggg==\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "train(batch_size=10, lr=0.2, mom=0.9, epochs=3, period=10)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Next\n", "[Momentum with Gluon](../chapter06_optimization/momentum-gluon.ipynb)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "For whinges or inquiries, [open an issue on GitHub.](https://github.com/zackchase/mxnet-the-straight-dope)" ] } ], "metadata": { "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.6.1" } }, "nbformat": 4, "nbformat_minor": 2 }