{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# Single layer models\n",
"\n",
"In this lab we will implement a single-layer network model consisting of solely of an affine transformation of the inputs. The relevant material for this was covered in [the slides of the first lecture](http://www.inf.ed.ac.uk/teaching/courses/mlp/2016/mlp01-intro.pdf). \n",
"\n",
"We will first implement the forward propagation of inputs to the network to produce predicted outputs. We will then move on to considering how to use gradients of an error function evaluated on the outputs to compute the gradients with respect to the model parameters to allow us to perform an iterative gradient-descent training procedure. In the final exercise you will use an interactive visualisation to explore the role of some of the different hyperparameters of gradient-descent based training methods.\n",
"\n",
"#### A note on random number generators\n",
"\n",
"It is generally a good practice (for machine learning applications **not** for cryptography!) to seed a pseudo-random number generator once at the beginning of each experiment. This makes it easier to reproduce results as the same random draws will produced each time the experiment is run (e.g. the same random initialisations used for parameters). Therefore generally when we need to generate random values during this course, we will create a seeded random number generator object as we do in the cell below."
]
},
{
"cell_type": "code",
"execution_count": 1,
"metadata": {},
"outputs": [],
"source": [
"import numpy as np\n",
"seed = 27092016 \n",
"rng = np.random.RandomState(seed)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Exercise 1: linear and affine transforms\n",
"\n",
"Any *linear transform* (also called a linear map) of a finite-dimensional vector space can be parametrised by a matrix. So for example if we consider $\\boldsymbol{x} \\in \\mathbb{R}^{D}$ as the input space of a model with $D$ dimensional real-valued inputs, then a matrix $\\mathbf{W} \\in \\mathbb{R}^{K\\times D}$ can be used to define a prediction model consisting solely of a linear transform of the inputs\n",
"\n",
"\\begin{equation}\n",
" \\boldsymbol{y} = \\mathbf{W} \\boldsymbol{x}\n",
" \\qquad\n",
" \\Leftrightarrow\n",
" \\qquad\n",
" y_k = \\sum_{d=1}^D \\left( W_{kd} x_d \\right) \\quad \\forall k \\in \\left\\lbrace 1 \\dots K\\right\\rbrace\n",
"\\end{equation}\n",
"\n",
"with here $\\boldsymbol{y} \\in \\mathbb{R}^K$ the $K$-dimensional real-valued output of the model. Geometrically we can think of a linear transform doing some combination of rotation, scaling, reflection and shearing of the input.\n",
"\n",
"An *affine transform* consists of a linear transform plus an additional translation parameterised by a vector $\\boldsymbol{b} \\in \\mathbb{R}^K$. A model consisting of an affine transformation of the inputs can then be defined as\n",
"\n",
"\\begin{equation}\n",
" \\boldsymbol{y} = \\mathbf{W}\\boldsymbol{x} + \\boldsymbol{b}\n",
" \\qquad\n",
" \\Leftrightarrow\n",
" \\qquad\n",
" y_k = \\sum_{d=1}^D \\left( W_{kd} x_d \\right) + b_k \\quad \\forall k \\in \\left\\lbrace 1 \\dots K\\right\\rbrace\n",
"\\end{equation}\n",
"\n",
"In machine learning we will usually refer to the matrix $\\mathbf{W}$ as a *weight matrix* and the vector $\\boldsymbol{b}$ as a *bias vector*.\n",
"\n",
"Generally rather than working with a single data vector $\\boldsymbol{x}$ we will work with batches of datapoints $\\left\\lbrace \\boldsymbol{x}^{(b)}\\right\\rbrace_{b=1}^B$. We could calculate the outputs for each input in the batch sequentially\n",
"\n",
"\\begin{align}\n",
" \\boldsymbol{y}^{(1)} &= \\mathbf{W}\\boldsymbol{x}^{(1)} + \\boldsymbol{b}\\\\\n",
" \\boldsymbol{y}^{(2)} &= \\mathbf{W}\\boldsymbol{x}^{(2)} + \\boldsymbol{b}\\\\\n",
" \\dots &\\\\\n",
" \\boldsymbol{y}^{(B)} &= \\mathbf{W}\\boldsymbol{x}^{(B)} + \\boldsymbol{b}\\\\\n",
"\\end{align}\n",
"\n",
"by looping over each input in the batch and calculating the output. However in general loops in Python are slow (particularly compared to compiled and typed languages such as C). This is due at least in part to the large overhead in dynamically inferring variable types. In general therefore wherever possible we want to avoid having loops in which such overhead will become the dominant computational cost.\n",
"\n",
"For array based numerical operations, one way of overcoming this bottleneck is to *vectorise* operations. NumPy `ndarrays` are typed arrays for which operations such as basic elementwise arithmetic and linear algebra operations such as computing matrix-matrix or matrix-vector products are implemented by calls to highly-optimised compiled libraries. Therefore if you can implement code directly using NumPy operations on arrays rather than by looping over array elements it is often possible to make very substantial performance gains.\n",
"\n",
"As a simple example we can consider adding up two arrays `a` and `b` and writing the result to a third array `c`. First lets initialise `a` and `b` with arbitrary values by running the cell below."
]
},
{
"cell_type": "code",
"execution_count": 2,
"metadata": {},
"outputs": [],
"source": [
"size = 1000\n",
"a = np.arange(size)\n",
"b = np.ones(size)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Now let's time how long it takes to add up each pair of values in the two array and write the results to a third array using a loop-based implementation. We will use the `%%timeit` magic briefly mentioned in the previous lab notebook specifying the number of times to loop the code as 100 and to give the best of 3 repeats. Run the cell below to get a print out of the average time taken."
]
},
{
"cell_type": "code",
"execution_count": 3,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"2.05 ms ± 148 µs per loop (mean ± std. dev. of 3 runs, 100 loops each)\n"
]
}
],
"source": [
"%%timeit -n 100 -r 3\n",
"c = np.empty(size)\n",
"for i in range(size):\n",
" c[i] = a[i] + b[i]"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"And now we will perform the corresponding summation with the overloaded addition operator of NumPy arrays. Again run the cell below to get a print out of the average time taken."
]
},
{
"cell_type": "code",
"execution_count": 4,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"3.01 µs ± 1.53 µs per loop (mean ± std. dev. of 3 runs, 100 loops each)\n"
]
}
],
"source": [
"%%timeit -n 100 -r 3\n",
"c = a + b"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The first loop-based implementation should have taken on the order of milliseconds ($10^{-3}$s) while the vectorised implementation should have taken on the order of microseconds ($10^{-6}$s), i.e. a $\\sim1000\\times$ speedup. Hopefully this simple example should make it clear why we want to vectorise operations whenever possible!\n",
"\n",
"Getting back to our affine model, ideally rather than individually computing the output corresponding to each input we should compute the outputs for all inputs in a batch using a vectorised implementation. As you saw last week, data providers return batches of inputs as arrays of shape `(batch_size, input_dim)`. In the mathematical notation used earlier we can consider this as a matrix $\\mathbf{X}$ of dimensionality $B \\times D$, and in particular\n",
"\n",
"\\begin{equation}\n",
" \\mathbf{X} = \\left[ \\boldsymbol{x}^{(1)} ~ \\boldsymbol{x}^{(2)} ~ \\dots ~ \\boldsymbol{x}^{(B)} \\right]^\\mathrm{T}\n",
"\\end{equation}\n",
"\n",
"i.e. the $b^{\\textrm{th}}$ input vector $\\boldsymbol{x}^{(b)}$ corresponds to the $b^{\\textrm{th}}$ row of $\\mathbf{X}$. If we define the $B \\times K$ matrix of outputs $\\mathbf{Y}$ similarly as\n",
"\n",
"\\begin{equation}\n",
" \\mathbf{Y} = \\left[ \\boldsymbol{y}^{(1)} ~ \\boldsymbol{y}^{(2)} ~ \\dots ~ \\boldsymbol{y}^{(B)} \\right]^\\mathrm{T}\n",
"\\end{equation}\n",
"\n",
"then we can express the relationship between $\\mathbf{X}$ and $\\mathbf{Y}$ using [matrix multiplication](https://en.wikipedia.org/wiki/Matrix_multiplication) and addition as\n",
"\n",
"\\begin{equation}\n",
" \\mathbf{Y} = \\mathbf{X} \\mathbf{W}^\\mathrm{T} + \\mathbf{B}\n",
"\\end{equation}\n",
"\n",
"where $\\mathbf{B} = \\left[ \\boldsymbol{b} ~ \\boldsymbol{b} ~ \\dots ~ \\boldsymbol{b} \\right]^\\mathrm{T}$ i.e. a $B \\times K$ matrix with each row corresponding to the bias vector. The weight matrix needs to be transposed here as the inner dimensions of a matrix multiplication must match i.e. for $\\mathbf{C} = \\mathbf{A} \\mathbf{B}$ then if $\\mathbf{A}$ is of dimensionality $K \\times L$ and $\\mathbf{B}$ is of dimensionality $M \\times N$ then it must be the case that $L = M$ and $\\mathbf{C}$ will be of dimensionality $K \\times N$.\n",
"\n",
"The first exercise for this lab is to implement *forward propagation* for a single-layer model consisting of an affine transformation of the inputs in the `fprop` function given as skeleton code in the cell below. This should work for a batch of inputs of shape `(batch_size, input_dim)` producing a batch of outputs of shape `(batch_size, output_dim)`.\n",
" \n",
"You will probably want to use the NumPy `dot` function and [broadcasting features](http://docs.scipy.org/doc/numpy/user/basics.broadcasting.html) to implement this efficiently. If you are not familiar with either / both of these you may wish to read the [hints](#Hints:-Using-the-dot-function-and-broadcasting) section below which gives some details on these before attempting the exercise."
]
},
{
"cell_type": "code",
"execution_count": 5,
"metadata": {},
"outputs": [],
"source": [
"def fprop(inputs, weights, biases):\n",
" \"\"\"Forward propagates activations through the layer transformation.\n",
"\n",
" For inputs `x`, outputs `y`, weights `W` and biases `b` the layer\n",
" corresponds to `y = W x + b`.\n",
"\n",
" Args:\n",
" inputs: Array of layer inputs of shape (batch_size, input_dim).\n",
" weights: Array of weight parameters of shape \n",
" (output_dim, input_dim).\n",
" biases: Array of bias parameters of shape (output_dim, ).\n",
"\n",
" Returns:\n",
" outputs: Array of layer outputs of shape (batch_size, output_dim).\n",
" \"\"\"\n",
" return inputs.dot(weights.T) + biases"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Once you have implemented `fprop` in the cell above you can test your implementation by running the cell below."
]
},
{
"cell_type": "code",
"execution_count": 6,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"All outputs correct!\n"
]
}
],
"source": [
"inputs = np.array([[0., -1., 2.], [-6., 3., 1.]])\n",
"weights = np.array([[2., -3., -1.], [-5., 7., 2.]])\n",
"biases = np.array([5., -3.])\n",
"true_outputs = np.array([[6., -6.], [-17., 50.]])\n",
"\n",
"if not np.allclose(fprop(inputs, weights, biases), true_outputs):\n",
" print('Wrong outputs computed.')\n",
"else:\n",
" print('All outputs correct!')"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Hints: Using the `dot` function and broadcasting\n",
"\n",
"For those new to NumPy below are some details on the `dot` function and broadcasting feature of NumPy that you may want to use for implementing the first exercise. If you are already familiar with these and have already completed the first exercise you can move on straight to [second exercise](#Exercise-2:-visualising-random-models).\n",
"\n",
"#### `numpy.dot` function\n",
"\n",
"Matrix-matrix, matrix-vector and vector-vector (dot) products can all be computed in NumPy using the [`dot`](http://docs.scipy.org/doc/numpy/reference/generated/numpy.dot.html) function. For example if `A` and `B` are both two dimensional arrays, then `C = np.dot(A, B)` or equivalently `C = A.dot(B)` will both compute the matrix product of `A` and `B` assuming `A` and `B` have compatible dimensions. Similarly if `a` and `b` are one dimensional arrays then `c = np.dot(a, b)` (which is equivalent to `c = a.dot(b)`) will compute the [scalar / dot product](https://en.wikipedia.org/wiki/Dot_product) of the two arrays. If `A` is a two-dimensional array and `b` a one-dimensional array `np.dot(A, b)` (which is equivalent to `A.dot(b)`) will compute the matrix-vector product of `A` and `b`. Examples of all three of these product types are shown in the cell below:"
]
},
{
"cell_type": "code",
"execution_count": 7,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[[ 6. 6. 6.]\n",
" [ 24. 24. 24.]\n",
" [ 42. 42. 42.]]\n",
"[[ 18. 24. 30.]\n",
" [ 18. 24. 30.]\n",
" [ 18. 24. 30.]]\n",
"[ 0.8 2.6 4.4]\n",
"[ 2.4 3. 3.6]\n",
"0.2\n"
]
}
],
"source": [
"# Initiliase arrays with arbitrary values\n",
"A = np.arange(9).reshape((3, 3))\n",
"B = np.ones((3, 3)) * 2\n",
"a = np.array([-1., 0., 1.])\n",
"b = np.array([0.1, 0.2, 0.3])\n",
"print(A.dot(B)) # Matrix-matrix product\n",
"print(B.dot(A)) # Reversed product of above A.dot(B) != B.dot(A) in general\n",
"print(A.dot(b)) # Matrix-vector product\n",
"print(b.dot(A)) # Again A.dot(b) != b.dot(A) unless A is symmetric i.e. A == A.T\n",
"print(a.dot(b)) # Vector-vector scalar product"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"#### Broadcasting\n",
"\n",
"Another NumPy feature it will be helpful to get familiar with is [broadcasting](http://docs.scipy.org/doc/numpy/user/basics.broadcasting.html). Broadcasting allows you to apply operations to arrays of different shapes, for example to add a one-dimensional array to a two-dimensional array or multiply a multidimensional array by a scalar. The complete set of rules for broadcasting as explained in the official documentation page just linked to can sound a bit complex: you might find the [visual explanation on this page](http://www.scipy-lectures.org/intro/numpy/operations.html#broadcasting) more intuitive. The cell below gives a few examples:"
]
},
{
"cell_type": "code",
"execution_count": 8,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[[ 0.1 1.2]\n",
" [ 2.1 3.2]\n",
" [ 4.1 5.2]]\n",
"[[-1. 0.]\n",
" [ 2. 3.]\n",
" [ 5. 6.]]\n",
"[[ 0. 0.2]\n",
" [ 0.2 0.6]\n",
" [ 0.4 1. ]]\n"
]
}
],
"source": [
"# Initiliase arrays with arbitrary values\n",
"A = np.arange(6).reshape((3, 2))\n",
"b = np.array([0.1, 0.2])\n",
"c = np.array([-1., 0., 1.])\n",
"print(A + b) # Add b elementwise to all rows of A\n",
"print((A.T + c).T) # Add b elementwise to all columns of A\n",
"print(A * b) # Multiply each row of A elementise by b "
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Exercise 2: visualising random models"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"In this exercise you will use your `fprop` implementation to visualise the outputs of a single-layer affine transform model with two-dimensional inputs and a one-dimensional output. In this simple case we can visualise the joint input-output space on a 3D axis.\n",
"\n",
"For this task and the learning experiments later in the notebook we will use a regression dataset from the [UCI machine learning repository](http://archive.ics.uci.edu/ml/index.html). In particular we will use a version of the [Combined Cycle Power Plant dataset](http://archive.ics.uci.edu/ml/datasets/Combined+Cycle+Power+Plant), where the task is to predict the energy output of a power plant given observations of the local ambient conditions (e.g. temperature, pressure and humidity).\n",
"\n",
"The original dataset has four input dimensions and a single target output dimension. We have preprocessed the dataset by [whitening](https://en.wikipedia.org/wiki/Whitening_transformation) it, a common preprocessing step. We will only use the first two dimensions of the whitened inputs (corresponding to the first two principal components of the inputs) so we can easily visualise the joint input-output space.\n",
"\n",
"The dataset has been wrapped in the `CCPPDataProvider` class in the `mlp.data_providers` module and the data included as a compressed file in the data directory as `ccpp_data.npz`. Running the cell below will initialise an instance of this class, get a single batch of inputs and outputs and import the necessary `matplotlib` objects."
]
},
{
"cell_type": "code",
"execution_count": 9,
"metadata": {},
"outputs": [],
"source": [
"import matplotlib.pyplot as plt\n",
"from mpl_toolkits.mplot3d import Axes3D\n",
"from mlp.data_providers import CCPPDataProvider\n",
"%matplotlib notebook\n",
"\n",
"data_provider = CCPPDataProvider(\n",
" which_set='train',\n",
" input_dims=[0, 1],\n",
" batch_size=5000, \n",
" max_num_batches=1, \n",
" shuffle_order=False\n",
")\n",
"\n",
"input_dim, output_dim = 2, 1\n",
"\n",
"inputs, targets = data_provider.next()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Here we used the `%matplotlib notebook` magic command rather than the `%matplotlib inline` we used in the previous lab as this allows us to produce interactive 3D plots which you can rotate and zoom in/out by dragging with the mouse and scrolling the mouse-wheel respectively. Once you have finished interacting with a plot you can close it to produce a static inline plot using the button in the top-right corner.\n",
"\n",
"Now run the cell below to plot the predicted outputs of a randomly initialised model across the two dimensional input space as well as the true target outputs. This sort of visualisation can be a useful method (in low dimensions) to assess how well the model is likely to be able to fit the data and to judge appropriate initialisation scales for the parameters. Each time you re-run the cell a new set of random parameters will be sampled\n",
"\n",
"Some questions to consider:\n",
"\n",
" * How do the weights and bias initialisation scale affect the sort of predicted input-output relationships?\n",
" * Does the linear form of the model seem appropriate for the data here?"
]
},
{
"cell_type": "code",
"execution_count": 10,
"metadata": {},
"outputs": [
{
"data": {
"application/javascript": [
"/* Put everything inside the global mpl namespace */\n",
"window.mpl = {};\n",
"\n",
"\n",
"mpl.get_websocket_type = function() {\n",
" if (typeof(WebSocket) !== 'undefined') {\n",
" return WebSocket;\n",
" } else if (typeof(MozWebSocket) !== 'undefined') {\n",
" return MozWebSocket;\n",
" } else {\n",
" alert('Your browser does not have WebSocket support.' +\n",
" 'Please try Chrome, Safari or Firefox ≥ 6. ' +\n",
" 'Firefox 4 and 5 are also supported but you ' +\n",
" 'have to enable WebSockets in about:config.');\n",
" };\n",
"}\n",
"\n",
"mpl.figure = function(figure_id, websocket, ondownload, parent_element) {\n",
" this.id = figure_id;\n",
"\n",
" this.ws = websocket;\n",
"\n",
" this.supports_binary = (this.ws.binaryType != undefined);\n",
"\n",
" if (!this.supports_binary) {\n",
" var warnings = document.getElementById(\"mpl-warnings\");\n",
" if (warnings) {\n",
" warnings.style.display = 'block';\n",
" warnings.textContent = (\n",
" \"This browser does not support binary websocket messages. \" +\n",
" \"Performance may be slow.\");\n",
" }\n",
" }\n",
"\n",
" this.imageObj = new Image();\n",
"\n",
" this.context = undefined;\n",
" this.message = undefined;\n",
" this.canvas = undefined;\n",
" this.rubberband_canvas = undefined;\n",
" this.rubberband_context = undefined;\n",
" this.format_dropdown = undefined;\n",
"\n",
" this.image_mode = 'full';\n",
"\n",
" this.root = $('');\n",
" this._root_extra_style(this.root)\n",
" this.root.attr('style', 'display: inline-block');\n",
"\n",
" $(parent_element).append(this.root);\n",
"\n",
" this._init_header(this);\n",
" this._init_canvas(this);\n",
" this._init_toolbar(this);\n",
"\n",
" var fig = this;\n",
"\n",
" this.waiting = false;\n",
"\n",
" this.ws.onopen = function () {\n",
" fig.send_message(\"supports_binary\", {value: fig.supports_binary});\n",
" fig.send_message(\"send_image_mode\", {});\n",
" if (mpl.ratio != 1) {\n",
" fig.send_message(\"set_dpi_ratio\", {'dpi_ratio': mpl.ratio});\n",
" }\n",
" fig.send_message(\"refresh\", {});\n",
" }\n",
"\n",
" this.imageObj.onload = function() {\n",
" if (fig.image_mode == 'full') {\n",
" // Full images could contain transparency (where diff images\n",
" // almost always do), so we need to clear the canvas so that\n",
" // there is no ghosting.\n",
" fig.context.clearRect(0, 0, fig.canvas.width, fig.canvas.height);\n",
" }\n",
" fig.context.drawImage(fig.imageObj, 0, 0);\n",
" };\n",
"\n",
" this.imageObj.onunload = function() {\n",
" this.ws.close();\n",
" }\n",
"\n",
" this.ws.onmessage = this._make_on_message_function(this);\n",
"\n",
" this.ondownload = ondownload;\n",
"}\n",
"\n",
"mpl.figure.prototype._init_header = function() {\n",
" var titlebar = $(\n",
" '');\n",
" var titletext = $(\n",
" '');\n",
" titlebar.append(titletext)\n",
" this.root.append(titlebar);\n",
" this.header = titletext[0];\n",
"}\n",
"\n",
"\n",
"\n",
"mpl.figure.prototype._canvas_extra_style = function(canvas_div) {\n",
"\n",
"}\n",
"\n",
"\n",
"mpl.figure.prototype._root_extra_style = function(canvas_div) {\n",
"\n",
"}\n",
"\n",
"mpl.figure.prototype._init_canvas = function() {\n",
" var fig = this;\n",
"\n",
" var canvas_div = $('');\n",
"\n",
" canvas_div.attr('style', 'position: relative; clear: both; outline: 0');\n",
"\n",
" function canvas_keyboard_event(event) {\n",
" return fig.key_event(event, event['data']);\n",
" }\n",
"\n",
" canvas_div.keydown('key_press', canvas_keyboard_event);\n",
" canvas_div.keyup('key_release', canvas_keyboard_event);\n",
" this.canvas_div = canvas_div\n",
" this._canvas_extra_style(canvas_div)\n",
" this.root.append(canvas_div);\n",
"\n",
" var canvas = $('');\n",
" canvas.addClass('mpl-canvas');\n",
" canvas.attr('style', \"left: 0; top: 0; z-index: 0; outline: 0\")\n",
"\n",
" this.canvas = canvas[0];\n",
" this.context = canvas[0].getContext(\"2d\");\n",
"\n",
" var backingStore = this.context.backingStorePixelRatio ||\n",
"\tthis.context.webkitBackingStorePixelRatio ||\n",
"\tthis.context.mozBackingStorePixelRatio ||\n",
"\tthis.context.msBackingStorePixelRatio ||\n",
"\tthis.context.oBackingStorePixelRatio ||\n",
"\tthis.context.backingStorePixelRatio || 1;\n",
"\n",
" mpl.ratio = (window.devicePixelRatio || 1) / backingStore;\n",
"\n",
" var rubberband = $('');\n",
" rubberband.attr('style', \"position: absolute; left: 0; top: 0; z-index: 1;\")\n",
"\n",
" var pass_mouse_events = true;\n",
"\n",
" canvas_div.resizable({\n",
" start: function(event, ui) {\n",
" pass_mouse_events = false;\n",
" },\n",
" resize: function(event, ui) {\n",
" fig.request_resize(ui.size.width, ui.size.height);\n",
" },\n",
" stop: function(event, ui) {\n",
" pass_mouse_events = true;\n",
" fig.request_resize(ui.size.width, ui.size.height);\n",
" },\n",
" });\n",
"\n",
" function mouse_event_fn(event) {\n",
" if (pass_mouse_events)\n",
" return fig.mouse_event(event, event['data']);\n",
" }\n",
"\n",
" rubberband.mousedown('button_press', mouse_event_fn);\n",
" rubberband.mouseup('button_release', mouse_event_fn);\n",
" // Throttle sequential mouse events to 1 every 20ms.\n",
" rubberband.mousemove('motion_notify', mouse_event_fn);\n",
"\n",
" rubberband.mouseenter('figure_enter', mouse_event_fn);\n",
" rubberband.mouseleave('figure_leave', mouse_event_fn);\n",
"\n",
" canvas_div.on(\"wheel\", function (event) {\n",
" event = event.originalEvent;\n",
" event['data'] = 'scroll'\n",
" if (event.deltaY < 0) {\n",
" event.step = 1;\n",
" } else {\n",
" event.step = -1;\n",
" }\n",
" mouse_event_fn(event);\n",
" });\n",
"\n",
" canvas_div.append(canvas);\n",
" canvas_div.append(rubberband);\n",
"\n",
" this.rubberband = rubberband;\n",
" this.rubberband_canvas = rubberband[0];\n",
" this.rubberband_context = rubberband[0].getContext(\"2d\");\n",
" this.rubberband_context.strokeStyle = \"#000000\";\n",
"\n",
" this._resize_canvas = function(width, height) {\n",
" // Keep the size of the canvas, canvas container, and rubber band\n",
" // canvas in synch.\n",
" canvas_div.css('width', width)\n",
" canvas_div.css('height', height)\n",
"\n",
" canvas.attr('width', width * mpl.ratio);\n",
" canvas.attr('height', height * mpl.ratio);\n",
" canvas.attr('style', 'width: ' + width + 'px; height: ' + height + 'px;');\n",
"\n",
" rubberband.attr('width', width);\n",
" rubberband.attr('height', height);\n",
" }\n",
"\n",
" // Set the figure to an initial 600x600px, this will subsequently be updated\n",
" // upon first draw.\n",
" this._resize_canvas(600, 600);\n",
"\n",
" // Disable right mouse context menu.\n",
" $(this.rubberband_canvas).bind(\"contextmenu\",function(e){\n",
" return false;\n",
" });\n",
"\n",
" function set_focus () {\n",
" canvas.focus();\n",
" canvas_div.focus();\n",
" }\n",
"\n",
" window.setTimeout(set_focus, 100);\n",
"}\n",
"\n",
"mpl.figure.prototype._init_toolbar = function() {\n",
" var fig = this;\n",
"\n",
" var nav_element = $('')\n",
" nav_element.attr('style', 'width: 100%');\n",
" this.root.append(nav_element);\n",
"\n",
" // Define a callback function for later on.\n",
" function toolbar_event(event) {\n",
" return fig.toolbar_button_onclick(event['data']);\n",
" }\n",
" function toolbar_mouse_event(event) {\n",
" return fig.toolbar_button_onmouseover(event['data']);\n",
" }\n",
"\n",
" for(var toolbar_ind in mpl.toolbar_items) {\n",
" var name = mpl.toolbar_items[toolbar_ind][0];\n",
" var tooltip = mpl.toolbar_items[toolbar_ind][1];\n",
" var image = mpl.toolbar_items[toolbar_ind][2];\n",
" var method_name = mpl.toolbar_items[toolbar_ind][3];\n",
"\n",
" if (!name) {\n",
" // put a spacer in here.\n",
" continue;\n",
" }\n",
" var button = $('');\n",
" button.addClass('ui-button ui-widget ui-state-default ui-corner-all ' +\n",
" 'ui-button-icon-only');\n",
" button.attr('role', 'button');\n",
" button.attr('aria-disabled', 'false');\n",
" button.click(method_name, toolbar_event);\n",
" button.mouseover(tooltip, toolbar_mouse_event);\n",
"\n",
" var icon_img = $('');\n",
" icon_img.addClass('ui-button-icon-primary ui-icon');\n",
" icon_img.addClass(image);\n",
" icon_img.addClass('ui-corner-all');\n",
"\n",
" var tooltip_span = $('');\n",
" tooltip_span.addClass('ui-button-text');\n",
" tooltip_span.html(tooltip);\n",
"\n",
" button.append(icon_img);\n",
" button.append(tooltip_span);\n",
"\n",
" nav_element.append(button);\n",
" }\n",
"\n",
" var fmt_picker_span = $('');\n",
"\n",
" var fmt_picker = $('');\n",
" fmt_picker.addClass('mpl-toolbar-option ui-widget ui-widget-content');\n",
" fmt_picker_span.append(fmt_picker);\n",
" nav_element.append(fmt_picker_span);\n",
" this.format_dropdown = fmt_picker[0];\n",
"\n",
" for (var ind in mpl.extensions) {\n",
" var fmt = mpl.extensions[ind];\n",
" var option = $(\n",
" '', {selected: fmt === mpl.default_extension}).html(fmt);\n",
" fmt_picker.append(option)\n",
" }\n",
"\n",
" // Add hover states to the ui-buttons\n",
" $( \".ui-button\" ).hover(\n",
" function() { $(this).addClass(\"ui-state-hover\");},\n",
" function() { $(this).removeClass(\"ui-state-hover\");}\n",
" );\n",
"\n",
" var status_bar = $('');\n",
" nav_element.append(status_bar);\n",
" this.message = status_bar[0];\n",
"}\n",
"\n",
"mpl.figure.prototype.request_resize = function(x_pixels, y_pixels) {\n",
" // Request matplotlib to resize the figure. Matplotlib will then trigger a resize in the client,\n",
" // which will in turn request a refresh of the image.\n",
" this.send_message('resize', {'width': x_pixels, 'height': y_pixels});\n",
"}\n",
"\n",
"mpl.figure.prototype.send_message = function(type, properties) {\n",
" properties['type'] = type;\n",
" properties['figure_id'] = this.id;\n",
" this.ws.send(JSON.stringify(properties));\n",
"}\n",
"\n",
"mpl.figure.prototype.send_draw_message = function() {\n",
" if (!this.waiting) {\n",
" this.waiting = true;\n",
" this.ws.send(JSON.stringify({type: \"draw\", figure_id: this.id}));\n",
" }\n",
"}\n",
"\n",
"\n",
"mpl.figure.prototype.handle_save = function(fig, msg) {\n",
" var format_dropdown = fig.format_dropdown;\n",
" var format = format_dropdown.options[format_dropdown.selectedIndex].value;\n",
" fig.ondownload(fig, format);\n",
"}\n",
"\n",
"\n",
"mpl.figure.prototype.handle_resize = function(fig, msg) {\n",
" var size = msg['size'];\n",
" if (size[0] != fig.canvas.width || size[1] != fig.canvas.height) {\n",
" fig._resize_canvas(size[0], size[1]);\n",
" fig.send_message(\"refresh\", {});\n",
" };\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_rubberband = function(fig, msg) {\n",
" var x0 = msg['x0'] / mpl.ratio;\n",
" var y0 = (fig.canvas.height - msg['y0']) / mpl.ratio;\n",
" var x1 = msg['x1'] / mpl.ratio;\n",
" var y1 = (fig.canvas.height - msg['y1']) / mpl.ratio;\n",
" x0 = Math.floor(x0) + 0.5;\n",
" y0 = Math.floor(y0) + 0.5;\n",
" x1 = Math.floor(x1) + 0.5;\n",
" y1 = Math.floor(y1) + 0.5;\n",
" var min_x = Math.min(x0, x1);\n",
" var min_y = Math.min(y0, y1);\n",
" var width = Math.abs(x1 - x0);\n",
" var height = Math.abs(y1 - y0);\n",
"\n",
" fig.rubberband_context.clearRect(\n",
" 0, 0, fig.canvas.width, fig.canvas.height);\n",
"\n",
" fig.rubberband_context.strokeRect(min_x, min_y, width, height);\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_figure_label = function(fig, msg) {\n",
" // Updates the figure title.\n",
" fig.header.textContent = msg['label'];\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_cursor = function(fig, msg) {\n",
" var cursor = msg['cursor'];\n",
" switch(cursor)\n",
" {\n",
" case 0:\n",
" cursor = 'pointer';\n",
" break;\n",
" case 1:\n",
" cursor = 'default';\n",
" break;\n",
" case 2:\n",
" cursor = 'crosshair';\n",
" break;\n",
" case 3:\n",
" cursor = 'move';\n",
" break;\n",
" }\n",
" fig.rubberband_canvas.style.cursor = cursor;\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_message = function(fig, msg) {\n",
" fig.message.textContent = msg['message'];\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_draw = function(fig, msg) {\n",
" // Request the server to send over a new figure.\n",
" fig.send_draw_message();\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_image_mode = function(fig, msg) {\n",
" fig.image_mode = msg['mode'];\n",
"}\n",
"\n",
"mpl.figure.prototype.updated_canvas_event = function() {\n",
" // Called whenever the canvas gets updated.\n",
" this.send_message(\"ack\", {});\n",
"}\n",
"\n",
"// A function to construct a web socket function for onmessage handling.\n",
"// Called in the figure constructor.\n",
"mpl.figure.prototype._make_on_message_function = function(fig) {\n",
" return function socket_on_message(evt) {\n",
" if (evt.data instanceof Blob) {\n",
" /* FIXME: We get \"Resource interpreted as Image but\n",
" * transferred with MIME type text/plain:\" errors on\n",
" * Chrome. But how to set the MIME type? It doesn't seem\n",
" * to be part of the websocket stream */\n",
" evt.data.type = \"image/png\";\n",
"\n",
" /* Free the memory for the previous frames */\n",
" if (fig.imageObj.src) {\n",
" (window.URL || window.webkitURL).revokeObjectURL(\n",
" fig.imageObj.src);\n",
" }\n",
"\n",
" fig.imageObj.src = (window.URL || window.webkitURL).createObjectURL(\n",
" evt.data);\n",
" fig.updated_canvas_event();\n",
" fig.waiting = false;\n",
" return;\n",
" }\n",
" else if (typeof evt.data === 'string' && evt.data.slice(0, 21) == \"data:image/png;base64\") {\n",
" fig.imageObj.src = evt.data;\n",
" fig.updated_canvas_event();\n",
" fig.waiting = false;\n",
" return;\n",
" }\n",
"\n",
" var msg = JSON.parse(evt.data);\n",
" var msg_type = msg['type'];\n",
"\n",
" // Call the \"handle_{type}\" callback, which takes\n",
" // the figure and JSON message as its only arguments.\n",
" try {\n",
" var callback = fig[\"handle_\" + msg_type];\n",
" } catch (e) {\n",
" console.log(\"No handler for the '\" + msg_type + \"' message type: \", msg);\n",
" return;\n",
" }\n",
"\n",
" if (callback) {\n",
" try {\n",
" // console.log(\"Handling '\" + msg_type + \"' message: \", msg);\n",
" callback(fig, msg);\n",
" } catch (e) {\n",
" console.log(\"Exception inside the 'handler_\" + msg_type + \"' callback:\", e, e.stack, msg);\n",
" }\n",
" }\n",
" };\n",
"}\n",
"\n",
"// from http://stackoverflow.com/questions/1114465/getting-mouse-location-in-canvas\n",
"mpl.findpos = function(e) {\n",
" //this section is from http://www.quirksmode.org/js/events_properties.html\n",
" var targ;\n",
" if (!e)\n",
" e = window.event;\n",
" if (e.target)\n",
" targ = e.target;\n",
" else if (e.srcElement)\n",
" targ = e.srcElement;\n",
" if (targ.nodeType == 3) // defeat Safari bug\n",
" targ = targ.parentNode;\n",
"\n",
" // jQuery normalizes the pageX and pageY\n",
" // pageX,Y are the mouse positions relative to the document\n",
" // offset() returns the position of the element relative to the document\n",
" var x = e.pageX - $(targ).offset().left;\n",
" var y = e.pageY - $(targ).offset().top;\n",
"\n",
" return {\"x\": x, \"y\": y};\n",
"};\n",
"\n",
"/*\n",
" * return a copy of an object with only non-object keys\n",
" * we need this to avoid circular references\n",
" * http://stackoverflow.com/a/24161582/3208463\n",
" */\n",
"function simpleKeys (original) {\n",
" return Object.keys(original).reduce(function (obj, key) {\n",
" if (typeof original[key] !== 'object')\n",
" obj[key] = original[key]\n",
" return obj;\n",
" }, {});\n",
"}\n",
"\n",
"mpl.figure.prototype.mouse_event = function(event, name) {\n",
" var canvas_pos = mpl.findpos(event)\n",
"\n",
" if (name === 'button_press')\n",
" {\n",
" this.canvas.focus();\n",
" this.canvas_div.focus();\n",
" }\n",
"\n",
" var x = canvas_pos.x * mpl.ratio;\n",
" var y = canvas_pos.y * mpl.ratio;\n",
"\n",
" this.send_message(name, {x: x, y: y, button: event.button,\n",
" step: event.step,\n",
" guiEvent: simpleKeys(event)});\n",
"\n",
" /* This prevents the web browser from automatically changing to\n",
" * the text insertion cursor when the button is pressed. We want\n",
" * to control all of the cursor setting manually through the\n",
" * 'cursor' event from matplotlib */\n",
" event.preventDefault();\n",
" return false;\n",
"}\n",
"\n",
"mpl.figure.prototype._key_event_extra = function(event, name) {\n",
" // Handle any extra behaviour associated with a key event\n",
"}\n",
"\n",
"mpl.figure.prototype.key_event = function(event, name) {\n",
"\n",
" // Prevent repeat events\n",
" if (name == 'key_press')\n",
" {\n",
" if (event.which === this._key)\n",
" return;\n",
" else\n",
" this._key = event.which;\n",
" }\n",
" if (name == 'key_release')\n",
" this._key = null;\n",
"\n",
" var value = '';\n",
" if (event.ctrlKey && event.which != 17)\n",
" value += \"ctrl+\";\n",
" if (event.altKey && event.which != 18)\n",
" value += \"alt+\";\n",
" if (event.shiftKey && event.which != 16)\n",
" value += \"shift+\";\n",
"\n",
" value += 'k';\n",
" value += event.which.toString();\n",
"\n",
" this._key_event_extra(event, name);\n",
"\n",
" this.send_message(name, {key: value,\n",
" guiEvent: simpleKeys(event)});\n",
" return false;\n",
"}\n",
"\n",
"mpl.figure.prototype.toolbar_button_onclick = function(name) {\n",
" if (name == 'download') {\n",
" this.handle_save(this, null);\n",
" } else {\n",
" this.send_message(\"toolbar_button\", {name: name});\n",
" }\n",
"};\n",
"\n",
"mpl.figure.prototype.toolbar_button_onmouseover = function(tooltip) {\n",
" this.message.textContent = tooltip;\n",
"};\n",
"mpl.toolbar_items = [[\"Home\", \"Reset original view\", \"fa fa-home icon-home\", \"home\"], [\"Back\", \"Back to previous view\", \"fa fa-arrow-left icon-arrow-left\", \"back\"], [\"Forward\", \"Forward to next view\", \"fa fa-arrow-right icon-arrow-right\", \"forward\"], [\"\", \"\", \"\", \"\"], [\"Pan\", \"Pan axes with left mouse, zoom with right\", \"fa fa-arrows icon-move\", \"pan\"], [\"Zoom\", \"Zoom to rectangle\", \"fa fa-square-o icon-check-empty\", \"zoom\"], [\"\", \"\", \"\", \"\"], [\"Download\", \"Download plot\", \"fa fa-floppy-o icon-save\", \"download\"]];\n",
"\n",
"mpl.extensions = [\"eps\", \"pdf\", \"png\", \"ps\", \"raw\", \"svg\"];\n",
"\n",
"mpl.default_extension = \"png\";var comm_websocket_adapter = function(comm) {\n",
" // Create a \"websocket\"-like object which calls the given IPython comm\n",
" // object with the appropriate methods. Currently this is a non binary\n",
" // socket, so there is still some room for performance tuning.\n",
" var ws = {};\n",
"\n",
" ws.close = function() {\n",
" comm.close()\n",
" };\n",
" ws.send = function(m) {\n",
" //console.log('sending', m);\n",
" comm.send(m);\n",
" };\n",
" // Register the callback with on_msg.\n",
" comm.on_msg(function(msg) {\n",
" //console.log('receiving', msg['content']['data'], msg);\n",
" // Pass the mpl event to the overriden (by mpl) onmessage function.\n",
" ws.onmessage(msg['content']['data'])\n",
" });\n",
" return ws;\n",
"}\n",
"\n",
"mpl.mpl_figure_comm = function(comm, msg) {\n",
" // This is the function which gets called when the mpl process\n",
" // starts-up an IPython Comm through the \"matplotlib\" channel.\n",
"\n",
" var id = msg.content.data.id;\n",
" // Get hold of the div created by the display call when the Comm\n",
" // socket was opened in Python.\n",
" var element = $(\"#\" + id);\n",
" var ws_proxy = comm_websocket_adapter(comm)\n",
"\n",
" function ondownload(figure, format) {\n",
" window.open(figure.imageObj.src);\n",
" }\n",
"\n",
" var fig = new mpl.figure(id, ws_proxy,\n",
" ondownload,\n",
" element.get(0));\n",
"\n",
" // Call onopen now - mpl needs it, as it is assuming we've passed it a real\n",
" // web socket which is closed, not our websocket->open comm proxy.\n",
" ws_proxy.onopen();\n",
"\n",
" fig.parent_element = element.get(0);\n",
" fig.cell_info = mpl.find_output_cell(\"\");\n",
" if (!fig.cell_info) {\n",
" console.error(\"Failed to find cell for figure\", id, fig);\n",
" return;\n",
" }\n",
"\n",
" var output_index = fig.cell_info[2]\n",
" var cell = fig.cell_info[0];\n",
"\n",
"};\n",
"\n",
"mpl.figure.prototype.handle_close = function(fig, msg) {\n",
" var width = fig.canvas.width/mpl.ratio\n",
" fig.root.unbind('remove')\n",
"\n",
" // Update the output cell to use the data from the current canvas.\n",
" fig.push_to_output();\n",
" var dataURL = fig.canvas.toDataURL();\n",
" // Re-enable the keyboard manager in IPython - without this line, in FF,\n",
" // the notebook keyboard shortcuts fail.\n",
" IPython.keyboard_manager.enable()\n",
" $(fig.parent_element).html('');\n",
" fig.close_ws(fig, msg);\n",
"}\n",
"\n",
"mpl.figure.prototype.close_ws = function(fig, msg){\n",
" fig.send_message('closing', msg);\n",
" // fig.ws.close()\n",
"}\n",
"\n",
"mpl.figure.prototype.push_to_output = function(remove_interactive) {\n",
" // Turn the data on the canvas into data in the output cell.\n",
" var width = this.canvas.width/mpl.ratio\n",
" var dataURL = this.canvas.toDataURL();\n",
" this.cell_info[1]['text/html'] = '';\n",
"}\n",
"\n",
"mpl.figure.prototype.updated_canvas_event = function() {\n",
" // Tell IPython that the notebook contents must change.\n",
" IPython.notebook.set_dirty(true);\n",
" this.send_message(\"ack\", {});\n",
" var fig = this;\n",
" // Wait a second, then push the new image to the DOM so\n",
" // that it is saved nicely (might be nice to debounce this).\n",
" setTimeout(function () { fig.push_to_output() }, 1000);\n",
"}\n",
"\n",
"mpl.figure.prototype._init_toolbar = function() {\n",
" var fig = this;\n",
"\n",
" var nav_element = $('')\n",
" nav_element.attr('style', 'width: 100%');\n",
" this.root.append(nav_element);\n",
"\n",
" // Define a callback function for later on.\n",
" function toolbar_event(event) {\n",
" return fig.toolbar_button_onclick(event['data']);\n",
" }\n",
" function toolbar_mouse_event(event) {\n",
" return fig.toolbar_button_onmouseover(event['data']);\n",
" }\n",
"\n",
" for(var toolbar_ind in mpl.toolbar_items){\n",
" var name = mpl.toolbar_items[toolbar_ind][0];\n",
" var tooltip = mpl.toolbar_items[toolbar_ind][1];\n",
" var image = mpl.toolbar_items[toolbar_ind][2];\n",
" var method_name = mpl.toolbar_items[toolbar_ind][3];\n",
"\n",
" if (!name) { continue; };\n",
"\n",
" var button = $('');\n",
" button.click(method_name, toolbar_event);\n",
" button.mouseover(tooltip, toolbar_mouse_event);\n",
" nav_element.append(button);\n",
" }\n",
"\n",
" // Add the status bar.\n",
" var status_bar = $('');\n",
" nav_element.append(status_bar);\n",
" this.message = status_bar[0];\n",
"\n",
" // Add the close button to the window.\n",
" var buttongrp = $('');\n",
" var button = $('');\n",
" button.click(function (evt) { fig.handle_close(fig, {}); } );\n",
" button.mouseover('Stop Interaction', toolbar_mouse_event);\n",
" buttongrp.append(button);\n",
" var titlebar = this.root.find($('.ui-dialog-titlebar'));\n",
" titlebar.prepend(buttongrp);\n",
"}\n",
"\n",
"mpl.figure.prototype._root_extra_style = function(el){\n",
" var fig = this\n",
" el.on(\"remove\", function(){\n",
"\tfig.close_ws(fig, {});\n",
" });\n",
"}\n",
"\n",
"mpl.figure.prototype._canvas_extra_style = function(el){\n",
" // this is important to make the div 'focusable\n",
" el.attr('tabindex', 0)\n",
" // reach out to IPython and tell the keyboard manager to turn it's self\n",
" // off when our div gets focus\n",
"\n",
" // location in version 3\n",
" if (IPython.notebook.keyboard_manager) {\n",
" IPython.notebook.keyboard_manager.register_events(el);\n",
" }\n",
" else {\n",
" // location in version 2\n",
" IPython.keyboard_manager.register_events(el);\n",
" }\n",
"\n",
"}\n",
"\n",
"mpl.figure.prototype._key_event_extra = function(event, name) {\n",
" var manager = IPython.notebook.keyboard_manager;\n",
" if (!manager)\n",
" manager = IPython.keyboard_manager;\n",
"\n",
" // Check for shift+enter\n",
" if (event.shiftKey && event.which == 13) {\n",
" this.canvas_div.blur();\n",
" // select the cell after this one\n",
" var index = IPython.notebook.find_cell_index(this.cell_info[0]);\n",
" IPython.notebook.select(index + 1);\n",
" }\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_save = function(fig, msg) {\n",
" fig.ondownload(fig, null);\n",
"}\n",
"\n",
"\n",
"mpl.find_output_cell = function(html_output) {\n",
" // Return the cell and output element which can be found *uniquely* in the notebook.\n",
" // Note - this is a bit hacky, but it is done because the \"notebook_saving.Notebook\"\n",
" // IPython event is triggered only after the cells have been serialised, which for\n",
" // our purposes (turning an active figure into a static one), is too late.\n",
" var cells = IPython.notebook.get_cells();\n",
" var ncells = cells.length;\n",
" for (var i=0; i= 3 moved mimebundle to data attribute of output\n",
" data = data.data;\n",
" }\n",
" if (data['text/html'] == html_output) {\n",
" return [cell, data, j];\n",
" }\n",
" }\n",
" }\n",
" }\n",
"}\n",
"\n",
"// Register the function which deals with the matplotlib target/channel.\n",
"// The kernel may be null if the page has been refreshed.\n",
"if (IPython.notebook.kernel != null) {\n",
" IPython.notebook.kernel.comm_manager.register_target('matplotlib', mpl.mpl_figure_comm);\n",
"}\n"
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
""
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"weights_init_range = 0.5\n",
"biases_init_range = 0.1\n",
"\n",
"# Randomly initialise weights matrix\n",
"weights = rng.uniform(\n",
" low=-weights_init_range, \n",
" high=weights_init_range, \n",
" size=(output_dim, input_dim)\n",
")\n",
"\n",
"# Randomly initialise biases vector\n",
"biases = rng.uniform(\n",
" low=-biases_init_range, \n",
" high=biases_init_range, \n",
" size=output_dim\n",
")\n",
"# Calculate predicted model outputs\n",
"outputs = fprop(inputs, weights, biases)\n",
"\n",
"# Plot target and predicted outputs against inputs on same axis\n",
"fig = plt.figure(figsize=(8, 8))\n",
"ax = fig.add_subplot(111, projection='3d')\n",
"ax.plot(inputs[:, 0], inputs[:, 1], targets[:, 0], 'r.', ms=2)\n",
"ax.plot(inputs[:, 0], inputs[:, 1], outputs[:, 0], 'b.', ms=2)\n",
"ax.set_xlabel('Input dim 1')\n",
"ax.set_ylabel('Input dim 2')\n",
"ax.set_zlabel('Output')\n",
"ax.legend(['Targets', 'Predictions'], frameon=False)\n",
"fig.tight_layout()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Exercise 3: computing the error function and its gradient\n",
"\n",
"Here we will consider the task of regression as covered in the first lecture slides. The aim in a regression problem is given inputs $\\left\\lbrace \\boldsymbol{x}^{(n)}\\right\\rbrace_{n=1}^N$ to produce outputs $\\left\\lbrace \\boldsymbol{y}^{(n)}\\right\\rbrace_{n=1}^N$ that are as 'close' as possible to a set of target outputs $\\left\\lbrace \\boldsymbol{t}^{(n)}\\right\\rbrace_{n=1}^N$. The measure of 'closeness' or distance between target and predicted outputs is a design choice. \n",
"\n",
"A very common choice is the squared Euclidean distance between the predicted and target outputs. This can be computed as the sum of the squared differences between each element in the target and predicted outputs. A common convention is to multiply this value by $\\frac{1}{2}$ as this gives a slightly nicer expression for the error gradient. The error for the $n^{\\textrm{th}}$ training example is then\n",
"\n",
"\\begin{equation}\n",
" E^{(n)} = \\frac{1}{2} \\sum_{k=1}^K \\left\\lbrace \\left( y^{(n)}_k - t^{(n)}_k \\right)^2 \\right\\rbrace.\n",
"\\end{equation}\n",
"\n",
"The overall error is then the *average* of this value across all training examples\n",
"\n",
"\\begin{equation}\n",
" \\bar{E} = \\frac{1}{N} \\sum_{n=1}^N \\left\\lbrace E^{(n)} \\right\\rbrace. \n",
"\\end{equation}\n",
"\n",
"*Note here we are using a slightly different convention from the lectures. There the overall error was considered to be the sum of the individual error terms rather than the mean. To differentiate between the two we will use $\\bar{E}$ to represent the average error here as opposed to sum of errors $E$ as used in the slides with $\\bar{E} = \\frac{E}{N}$. Normalising by the number of training examples is helpful to do in practice as this means we can more easily compare errors across data sets / batches of different sizes, and more importantly it means the size of our gradient updates will be independent of the number of training examples summed over.*\n",
"\n",
"The regression problem is then to find parameters of the model which minimise $\\bar{E}$. For our simple single-layer affine model here that corresponds to finding weights $\\mathbf{W}$ and biases $\\boldsymbol{b}$ which minimise $\\bar{E}$. \n",
"\n",
"As mentioned in the lecture, for this simple case there is actually a closed form solution for the optimal weights and bias parameters. This is the linear least-squares solution those doing MLPR will have come across.\n",
"\n",
"However in general we will be interested in models where closed form solutions do not exist. We will therefore generally use iterative, gradient descent based training methods to find parameters which (locally) minimise the error function. A basic requirement of being able to do gradient-descent based training is (unsuprisingly) the ability to evaluate gradients of the error function.\n",
"\n",
"In the next exercise we will consider how to calculate gradients of the error function with respect to the model parameters $\\mathbf{W}$ and $\\boldsymbol{b}$, but as a first step here we will consider the gradient of the error function with respect to the model outputs $\\left\\lbrace \\boldsymbol{y}^{(n)}\\right\\rbrace_{n=1}^N$. This can be written\n",
"\n",
"\\begin{equation}\n",
" \\frac{\\partial \\bar{E}}{\\partial \\boldsymbol{y}^{(n)}} = \\frac{1}{N} \\left( \\boldsymbol{y}^{(n)} - \\boldsymbol{t}^{(n)} \\right)\n",
" \\qquad \\Leftrightarrow \\qquad\n",
" \\frac{\\partial \\bar{E}}{\\partial y^{(n)}_k} = \\frac{1}{N} \\left( y^{(n)}_k - t^{(n)}_k \\right) \\quad \\forall k \\in \\left\\lbrace 1 \\dots K\\right\\rbrace\n",
"\\end{equation}\n",
"\n",
"i.e. the gradient of the error function with respect to the $n^{\\textrm{th}}$ model output is just the difference between the $n^{\\textrm{th}}$ model and target outputs, corresponding to the $\\boldsymbol{\\delta}^{(n)}$ terms mentioned in the lecture slides.\n",
"\n",
"The third exercise is, using the equations given above, to implement functions computing the mean sum of squared differences error and its gradient with respect to the model outputs. You should implement the functions using the provided skeleton definitions in the cell below."
]
},
{
"cell_type": "code",
"execution_count": 11,
"metadata": {},
"outputs": [],
"source": [
"def error(outputs, targets):\n",
" \"\"\"Calculates error function given a batch of outputs and targets.\n",
"\n",
" Args:\n",
" outputs: Array of model outputs of shape (batch_size, output_dim).\n",
" targets: Array of target outputs of shape (batch_size, output_dim).\n",
"\n",
" Returns:\n",
" Scalar error function value.\n",
" \"\"\"\n",
" return 0.5 * ((outputs - targets)**2).sum() / outputs.shape[0]\n",
" \n",
"def error_grad(outputs, targets):\n",
" \"\"\"Calculates gradient of error function with respect to model outputs.\n",
"\n",
" Args:\n",
" outputs: Array of model outputs of shape (batch_size, output_dim).\n",
" targets: Array of target outputs of shape (batch_size, output_dim).\n",
"\n",
" Returns:\n",
" Gradient of error function with respect to outputs.\n",
" This will be an array of shape (batch_size, output_dim).\n",
" \"\"\"\n",
" return (outputs - targets) / outputs.shape[0]"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Check your implementation by running the test cell below."
]
},
{
"cell_type": "code",
"execution_count": 12,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Error function and gradient computed correctly!\n"
]
}
],
"source": [
"outputs = np.array([[1., 2.], [-1., 0.], [6., -5.], [-1., 1.]])\n",
"targets = np.array([[0., 1.], [3., -2.], [7., -3.], [1., -2.]])\n",
"true_error = 5.\n",
"true_error_grad = np.array([[0.25, 0.25], [-1., 0.5], [-0.25, -0.5], [-0.5, 0.75]])\n",
"\n",
"if not error(outputs, targets) == true_error:\n",
" print('Error calculated incorrectly.')\n",
"elif not np.allclose(error_grad(outputs, targets), true_error_grad):\n",
" print('Error gradient calculated incorrectly.')\n",
"else:\n",
" print('Error function and gradient computed correctly!')"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Exercise 4: computing gradients with respect to the parameters\n",
"\n",
"In the previous exercise you implemented a function computing the gradient of the error function with respect to the model outputs. For gradient-descent based training, we need to be able to evaluate the gradient of the error function with respect to the model parameters.\n",
"\n",
"Using the [chain rule for derivatives](https://en.wikipedia.org/wiki/Chain_rule#Higher_dimensions) we can write the partial deriviative of the error function with respect to single elements of the weight matrix and bias vector as\n",
"\n",
"\\begin{equation}\n",
" \\frac{\\partial E}{\\partial W_{kj}} = \\sum_{n=1}^N \\left\\lbrace \\frac{\\partial E}{\\partial y^{(n)}_k} \\frac{\\partial y^{(n)}_k}{\\partial W_{kj}} \\right\\rbrace\n",
" \\quad \\textrm{and} \\quad\n",
" \\frac{\\partial E}{\\partial b_k} = \\sum_{n=1}^N \\left\\lbrace \\frac{\\partial E}{\\partial y^{(n)}_k} \\frac{\\partial y^{(n)}_k}{\\partial b_k} \\right\\rbrace.\n",
"\\end{equation}\n",
"\n",
"From the definition of our model at the beginning we have \n",
"\n",
"\\begin{equation}\n",
" y^{(n)}_k = \\sum_{d=1}^D \\left\\lbrace W_{kd} x^{(n)}_d \\right\\rbrace + b_k\n",
" \\quad \\Rightarrow \\quad\n",
" \\frac{\\partial y^{(n)}_k}{\\partial W_{kj}} = x^{(n)}_j\n",
" \\quad \\textrm{and} \\quad\n",
" \\frac{\\partial y^{(n)}_k}{\\partial b_k} = 1.\n",
"\\end{equation}\n",
"\n",
"Putting this together we get that\n",
"\n",
"\\begin{equation}\n",
" \\frac{\\partial E}{\\partial W_{kj}} = \n",
" \\sum_{n=1}^N \\left\\lbrace \\frac{\\partial E}{\\partial y^{(n)}_k} x^{(n)}_j \\right\\rbrace\n",
" \\quad \\textrm{and} \\quad\n",
" \\frac{\\partial E}{\\partial b_{k}} = \n",
" \\sum_{n=1}^N \\left\\lbrace \\frac{\\partial E}{\\partial y^{(n)}_k} \\right\\rbrace.\n",
"\\end{equation}\n",
"\n",
"Although this may seem a bit of a roundabout way to get to these results, this method of decomposing the error gradient with respect to the parameters in terms of the gradient of the error function with respect to the model outputs and the derivatives of the model outputs with respect to the model parameters, will be key when calculating the parameter gradients of more complex models later in the course.\n",
"\n",
"Your task in this exercise is to implement a function calculating the gradient of the error function with respect to the weight and bias parameters of the model given the already computed gradient of the error function with respect to the model outputs. You should implement this in the `grads_wrt_params` function in the cell below."
]
},
{
"cell_type": "code",
"execution_count": 13,
"metadata": {},
"outputs": [],
"source": [
"def grads_wrt_params(inputs, grads_wrt_outputs):\n",
" \"\"\"Calculates gradients with respect to model parameters.\n",
"\n",
" Args:\n",
" inputs: array of inputs to model of shape (batch_size, input_dim)\n",
" grads_wrt_to_outputs: array of gradients of with respect to the model\n",
" outputs of shape (batch_size, output_dim).\n",
"\n",
" Returns:\n",
" list of arrays of gradients with respect to the model parameters\n",
" `[grads_wrt_weights, grads_wrt_biases]`.\n",
" \"\"\"\n",
" grads_wrt_weights = grads_wrt_outputs.T.dot(inputs)\n",
" grads_wrt_biases = grads_wrt_outputs.sum(0)\n",
" return [grads_wrt_weights, grads_wrt_biases]"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Check your implementation by running the test cell below."
]
},
{
"cell_type": "code",
"execution_count": 14,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"All parameter gradients calculated correctly!\n"
]
}
],
"source": [
"inputs = np.array([[1., 2., 3.], [-1., 4., -9.]])\n",
"grads_wrt_outputs = np.array([[-1., 1.], [2., -3.]])\n",
"true_grads_wrt_weights = np.array([[-3., 6., -21.], [4., -10., 30.]])\n",
"true_grads_wrt_biases = np.array([1., -2.])\n",
"\n",
"grads_wrt_weights, grads_wrt_biases = grads_wrt_params(\n",
" inputs, grads_wrt_outputs)\n",
"\n",
"if not np.allclose(true_grads_wrt_weights, grads_wrt_weights):\n",
" print('Gradients with respect to weights incorrect.')\n",
"elif not np.allclose(true_grads_wrt_biases, grads_wrt_biases):\n",
" print('Gradients with respect to biases incorrect.')\n",
"else:\n",
" print('All parameter gradients calculated correctly!')"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Exercise 5: wrapping the functions into reusable components\n",
"\n",
"In exercises 1, 3 and 4 you implemented methods to compute the predicted outputs of our model, evaluate the error function and its gradient on the outputs and finally to calculate the gradients of the error with respect to the model parameters. Together they constitute all the basic ingredients we need to implement a gradient-descent based iterative learning procedure for the model.\n",
"\n",
"Although you could implement training code which directly uses the functions you defined, this would only be usable for this particular model architecture. In subsequent labs we will want to use the affine transform functions as the basis for more interesting multi-layer models. We will therefore wrap the implementations you just wrote in to reusable components that we can build more complex models with later in the course.\n",
"\n",
" * In the [`mlp.layers`](/edit/mlp/layers.py) module, use your implementations of `fprop` and `grad_wrt_params` above to implement the corresponding methods in the skeleton `AffineLayer` class provided.\n",
" * In the [`mlp.errors`](/edit/mlp/errors.py) module use your implementation of `error` and `error_grad` to implement the `__call__` and `grad` methods respectively of the skeleton `SumOfSquaredDiffsError` class provided. Note `__call__` is a special Python method that allows an object to be used with a function call syntax.\n",
"\n",
"Run the cell below to use your completed `AffineLayer` and `SumOfSquaredDiffsError` implementations to train a single-layer model using batch gradient descent on the CCPP dataset."
]
},
{
"cell_type": "code",
"execution_count": 16,
"metadata": {},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"Epoch 1: 0.0s to complete\n",
" error(train)=1.67e-01\n",
"Epoch 2: 0.0s to complete\n",
" error(train)=9.30e-02\n",
"Epoch 3: 0.0s to complete\n",
" error(train)=7.95e-02\n",
"Epoch 4: 0.0s to complete\n",
" error(train)=7.71e-02\n",
"Epoch 5: 0.0s to complete\n",
" error(train)=7.66e-02\n",
"Epoch 6: 0.0s to complete\n",
" error(train)=7.65e-02\n",
"Epoch 7: 0.0s to complete\n",
" error(train)=7.65e-02\n",
"Epoch 8: 0.0s to complete\n",
" error(train)=7.65e-02\n",
"Epoch 9: 0.0s to complete\n",
" error(train)=7.63e-02\n",
"Epoch 10: 0.0s to complete\n",
" error(train)=7.64e-02\n"
]
},
{
"data": {
"application/javascript": [
"/* Put everything inside the global mpl namespace */\n",
"window.mpl = {};\n",
"\n",
"\n",
"mpl.get_websocket_type = function() {\n",
" if (typeof(WebSocket) !== 'undefined') {\n",
" return WebSocket;\n",
" } else if (typeof(MozWebSocket) !== 'undefined') {\n",
" return MozWebSocket;\n",
" } else {\n",
" alert('Your browser does not have WebSocket support.' +\n",
" 'Please try Chrome, Safari or Firefox ≥ 6. ' +\n",
" 'Firefox 4 and 5 are also supported but you ' +\n",
" 'have to enable WebSockets in about:config.');\n",
" };\n",
"}\n",
"\n",
"mpl.figure = function(figure_id, websocket, ondownload, parent_element) {\n",
" this.id = figure_id;\n",
"\n",
" this.ws = websocket;\n",
"\n",
" this.supports_binary = (this.ws.binaryType != undefined);\n",
"\n",
" if (!this.supports_binary) {\n",
" var warnings = document.getElementById(\"mpl-warnings\");\n",
" if (warnings) {\n",
" warnings.style.display = 'block';\n",
" warnings.textContent = (\n",
" \"This browser does not support binary websocket messages. \" +\n",
" \"Performance may be slow.\");\n",
" }\n",
" }\n",
"\n",
" this.imageObj = new Image();\n",
"\n",
" this.context = undefined;\n",
" this.message = undefined;\n",
" this.canvas = undefined;\n",
" this.rubberband_canvas = undefined;\n",
" this.rubberband_context = undefined;\n",
" this.format_dropdown = undefined;\n",
"\n",
" this.image_mode = 'full';\n",
"\n",
" this.root = $('');\n",
" this._root_extra_style(this.root)\n",
" this.root.attr('style', 'display: inline-block');\n",
"\n",
" $(parent_element).append(this.root);\n",
"\n",
" this._init_header(this);\n",
" this._init_canvas(this);\n",
" this._init_toolbar(this);\n",
"\n",
" var fig = this;\n",
"\n",
" this.waiting = false;\n",
"\n",
" this.ws.onopen = function () {\n",
" fig.send_message(\"supports_binary\", {value: fig.supports_binary});\n",
" fig.send_message(\"send_image_mode\", {});\n",
" if (mpl.ratio != 1) {\n",
" fig.send_message(\"set_dpi_ratio\", {'dpi_ratio': mpl.ratio});\n",
" }\n",
" fig.send_message(\"refresh\", {});\n",
" }\n",
"\n",
" this.imageObj.onload = function() {\n",
" if (fig.image_mode == 'full') {\n",
" // Full images could contain transparency (where diff images\n",
" // almost always do), so we need to clear the canvas so that\n",
" // there is no ghosting.\n",
" fig.context.clearRect(0, 0, fig.canvas.width, fig.canvas.height);\n",
" }\n",
" fig.context.drawImage(fig.imageObj, 0, 0);\n",
" };\n",
"\n",
" this.imageObj.onunload = function() {\n",
" this.ws.close();\n",
" }\n",
"\n",
" this.ws.onmessage = this._make_on_message_function(this);\n",
"\n",
" this.ondownload = ondownload;\n",
"}\n",
"\n",
"mpl.figure.prototype._init_header = function() {\n",
" var titlebar = $(\n",
" '');\n",
" var titletext = $(\n",
" '');\n",
" titlebar.append(titletext)\n",
" this.root.append(titlebar);\n",
" this.header = titletext[0];\n",
"}\n",
"\n",
"\n",
"\n",
"mpl.figure.prototype._canvas_extra_style = function(canvas_div) {\n",
"\n",
"}\n",
"\n",
"\n",
"mpl.figure.prototype._root_extra_style = function(canvas_div) {\n",
"\n",
"}\n",
"\n",
"mpl.figure.prototype._init_canvas = function() {\n",
" var fig = this;\n",
"\n",
" var canvas_div = $('');\n",
"\n",
" canvas_div.attr('style', 'position: relative; clear: both; outline: 0');\n",
"\n",
" function canvas_keyboard_event(event) {\n",
" return fig.key_event(event, event['data']);\n",
" }\n",
"\n",
" canvas_div.keydown('key_press', canvas_keyboard_event);\n",
" canvas_div.keyup('key_release', canvas_keyboard_event);\n",
" this.canvas_div = canvas_div\n",
" this._canvas_extra_style(canvas_div)\n",
" this.root.append(canvas_div);\n",
"\n",
" var canvas = $('');\n",
" canvas.addClass('mpl-canvas');\n",
" canvas.attr('style', \"left: 0; top: 0; z-index: 0; outline: 0\")\n",
"\n",
" this.canvas = canvas[0];\n",
" this.context = canvas[0].getContext(\"2d\");\n",
"\n",
" var backingStore = this.context.backingStorePixelRatio ||\n",
"\tthis.context.webkitBackingStorePixelRatio ||\n",
"\tthis.context.mozBackingStorePixelRatio ||\n",
"\tthis.context.msBackingStorePixelRatio ||\n",
"\tthis.context.oBackingStorePixelRatio ||\n",
"\tthis.context.backingStorePixelRatio || 1;\n",
"\n",
" mpl.ratio = (window.devicePixelRatio || 1) / backingStore;\n",
"\n",
" var rubberband = $('');\n",
" rubberband.attr('style', \"position: absolute; left: 0; top: 0; z-index: 1;\")\n",
"\n",
" var pass_mouse_events = true;\n",
"\n",
" canvas_div.resizable({\n",
" start: function(event, ui) {\n",
" pass_mouse_events = false;\n",
" },\n",
" resize: function(event, ui) {\n",
" fig.request_resize(ui.size.width, ui.size.height);\n",
" },\n",
" stop: function(event, ui) {\n",
" pass_mouse_events = true;\n",
" fig.request_resize(ui.size.width, ui.size.height);\n",
" },\n",
" });\n",
"\n",
" function mouse_event_fn(event) {\n",
" if (pass_mouse_events)\n",
" return fig.mouse_event(event, event['data']);\n",
" }\n",
"\n",
" rubberband.mousedown('button_press', mouse_event_fn);\n",
" rubberband.mouseup('button_release', mouse_event_fn);\n",
" // Throttle sequential mouse events to 1 every 20ms.\n",
" rubberband.mousemove('motion_notify', mouse_event_fn);\n",
"\n",
" rubberband.mouseenter('figure_enter', mouse_event_fn);\n",
" rubberband.mouseleave('figure_leave', mouse_event_fn);\n",
"\n",
" canvas_div.on(\"wheel\", function (event) {\n",
" event = event.originalEvent;\n",
" event['data'] = 'scroll'\n",
" if (event.deltaY < 0) {\n",
" event.step = 1;\n",
" } else {\n",
" event.step = -1;\n",
" }\n",
" mouse_event_fn(event);\n",
" });\n",
"\n",
" canvas_div.append(canvas);\n",
" canvas_div.append(rubberband);\n",
"\n",
" this.rubberband = rubberband;\n",
" this.rubberband_canvas = rubberband[0];\n",
" this.rubberband_context = rubberband[0].getContext(\"2d\");\n",
" this.rubberband_context.strokeStyle = \"#000000\";\n",
"\n",
" this._resize_canvas = function(width, height) {\n",
" // Keep the size of the canvas, canvas container, and rubber band\n",
" // canvas in synch.\n",
" canvas_div.css('width', width)\n",
" canvas_div.css('height', height)\n",
"\n",
" canvas.attr('width', width * mpl.ratio);\n",
" canvas.attr('height', height * mpl.ratio);\n",
" canvas.attr('style', 'width: ' + width + 'px; height: ' + height + 'px;');\n",
"\n",
" rubberband.attr('width', width);\n",
" rubberband.attr('height', height);\n",
" }\n",
"\n",
" // Set the figure to an initial 600x600px, this will subsequently be updated\n",
" // upon first draw.\n",
" this._resize_canvas(600, 600);\n",
"\n",
" // Disable right mouse context menu.\n",
" $(this.rubberband_canvas).bind(\"contextmenu\",function(e){\n",
" return false;\n",
" });\n",
"\n",
" function set_focus () {\n",
" canvas.focus();\n",
" canvas_div.focus();\n",
" }\n",
"\n",
" window.setTimeout(set_focus, 100);\n",
"}\n",
"\n",
"mpl.figure.prototype._init_toolbar = function() {\n",
" var fig = this;\n",
"\n",
" var nav_element = $('')\n",
" nav_element.attr('style', 'width: 100%');\n",
" this.root.append(nav_element);\n",
"\n",
" // Define a callback function for later on.\n",
" function toolbar_event(event) {\n",
" return fig.toolbar_button_onclick(event['data']);\n",
" }\n",
" function toolbar_mouse_event(event) {\n",
" return fig.toolbar_button_onmouseover(event['data']);\n",
" }\n",
"\n",
" for(var toolbar_ind in mpl.toolbar_items) {\n",
" var name = mpl.toolbar_items[toolbar_ind][0];\n",
" var tooltip = mpl.toolbar_items[toolbar_ind][1];\n",
" var image = mpl.toolbar_items[toolbar_ind][2];\n",
" var method_name = mpl.toolbar_items[toolbar_ind][3];\n",
"\n",
" if (!name) {\n",
" // put a spacer in here.\n",
" continue;\n",
" }\n",
" var button = $('');\n",
" button.addClass('ui-button ui-widget ui-state-default ui-corner-all ' +\n",
" 'ui-button-icon-only');\n",
" button.attr('role', 'button');\n",
" button.attr('aria-disabled', 'false');\n",
" button.click(method_name, toolbar_event);\n",
" button.mouseover(tooltip, toolbar_mouse_event);\n",
"\n",
" var icon_img = $('');\n",
" icon_img.addClass('ui-button-icon-primary ui-icon');\n",
" icon_img.addClass(image);\n",
" icon_img.addClass('ui-corner-all');\n",
"\n",
" var tooltip_span = $('');\n",
" tooltip_span.addClass('ui-button-text');\n",
" tooltip_span.html(tooltip);\n",
"\n",
" button.append(icon_img);\n",
" button.append(tooltip_span);\n",
"\n",
" nav_element.append(button);\n",
" }\n",
"\n",
" var fmt_picker_span = $('');\n",
"\n",
" var fmt_picker = $('');\n",
" fmt_picker.addClass('mpl-toolbar-option ui-widget ui-widget-content');\n",
" fmt_picker_span.append(fmt_picker);\n",
" nav_element.append(fmt_picker_span);\n",
" this.format_dropdown = fmt_picker[0];\n",
"\n",
" for (var ind in mpl.extensions) {\n",
" var fmt = mpl.extensions[ind];\n",
" var option = $(\n",
" '', {selected: fmt === mpl.default_extension}).html(fmt);\n",
" fmt_picker.append(option)\n",
" }\n",
"\n",
" // Add hover states to the ui-buttons\n",
" $( \".ui-button\" ).hover(\n",
" function() { $(this).addClass(\"ui-state-hover\");},\n",
" function() { $(this).removeClass(\"ui-state-hover\");}\n",
" );\n",
"\n",
" var status_bar = $('');\n",
" nav_element.append(status_bar);\n",
" this.message = status_bar[0];\n",
"}\n",
"\n",
"mpl.figure.prototype.request_resize = function(x_pixels, y_pixels) {\n",
" // Request matplotlib to resize the figure. Matplotlib will then trigger a resize in the client,\n",
" // which will in turn request a refresh of the image.\n",
" this.send_message('resize', {'width': x_pixels, 'height': y_pixels});\n",
"}\n",
"\n",
"mpl.figure.prototype.send_message = function(type, properties) {\n",
" properties['type'] = type;\n",
" properties['figure_id'] = this.id;\n",
" this.ws.send(JSON.stringify(properties));\n",
"}\n",
"\n",
"mpl.figure.prototype.send_draw_message = function() {\n",
" if (!this.waiting) {\n",
" this.waiting = true;\n",
" this.ws.send(JSON.stringify({type: \"draw\", figure_id: this.id}));\n",
" }\n",
"}\n",
"\n",
"\n",
"mpl.figure.prototype.handle_save = function(fig, msg) {\n",
" var format_dropdown = fig.format_dropdown;\n",
" var format = format_dropdown.options[format_dropdown.selectedIndex].value;\n",
" fig.ondownload(fig, format);\n",
"}\n",
"\n",
"\n",
"mpl.figure.prototype.handle_resize = function(fig, msg) {\n",
" var size = msg['size'];\n",
" if (size[0] != fig.canvas.width || size[1] != fig.canvas.height) {\n",
" fig._resize_canvas(size[0], size[1]);\n",
" fig.send_message(\"refresh\", {});\n",
" };\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_rubberband = function(fig, msg) {\n",
" var x0 = msg['x0'] / mpl.ratio;\n",
" var y0 = (fig.canvas.height - msg['y0']) / mpl.ratio;\n",
" var x1 = msg['x1'] / mpl.ratio;\n",
" var y1 = (fig.canvas.height - msg['y1']) / mpl.ratio;\n",
" x0 = Math.floor(x0) + 0.5;\n",
" y0 = Math.floor(y0) + 0.5;\n",
" x1 = Math.floor(x1) + 0.5;\n",
" y1 = Math.floor(y1) + 0.5;\n",
" var min_x = Math.min(x0, x1);\n",
" var min_y = Math.min(y0, y1);\n",
" var width = Math.abs(x1 - x0);\n",
" var height = Math.abs(y1 - y0);\n",
"\n",
" fig.rubberband_context.clearRect(\n",
" 0, 0, fig.canvas.width, fig.canvas.height);\n",
"\n",
" fig.rubberband_context.strokeRect(min_x, min_y, width, height);\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_figure_label = function(fig, msg) {\n",
" // Updates the figure title.\n",
" fig.header.textContent = msg['label'];\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_cursor = function(fig, msg) {\n",
" var cursor = msg['cursor'];\n",
" switch(cursor)\n",
" {\n",
" case 0:\n",
" cursor = 'pointer';\n",
" break;\n",
" case 1:\n",
" cursor = 'default';\n",
" break;\n",
" case 2:\n",
" cursor = 'crosshair';\n",
" break;\n",
" case 3:\n",
" cursor = 'move';\n",
" break;\n",
" }\n",
" fig.rubberband_canvas.style.cursor = cursor;\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_message = function(fig, msg) {\n",
" fig.message.textContent = msg['message'];\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_draw = function(fig, msg) {\n",
" // Request the server to send over a new figure.\n",
" fig.send_draw_message();\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_image_mode = function(fig, msg) {\n",
" fig.image_mode = msg['mode'];\n",
"}\n",
"\n",
"mpl.figure.prototype.updated_canvas_event = function() {\n",
" // Called whenever the canvas gets updated.\n",
" this.send_message(\"ack\", {});\n",
"}\n",
"\n",
"// A function to construct a web socket function for onmessage handling.\n",
"// Called in the figure constructor.\n",
"mpl.figure.prototype._make_on_message_function = function(fig) {\n",
" return function socket_on_message(evt) {\n",
" if (evt.data instanceof Blob) {\n",
" /* FIXME: We get \"Resource interpreted as Image but\n",
" * transferred with MIME type text/plain:\" errors on\n",
" * Chrome. But how to set the MIME type? It doesn't seem\n",
" * to be part of the websocket stream */\n",
" evt.data.type = \"image/png\";\n",
"\n",
" /* Free the memory for the previous frames */\n",
" if (fig.imageObj.src) {\n",
" (window.URL || window.webkitURL).revokeObjectURL(\n",
" fig.imageObj.src);\n",
" }\n",
"\n",
" fig.imageObj.src = (window.URL || window.webkitURL).createObjectURL(\n",
" evt.data);\n",
" fig.updated_canvas_event();\n",
" fig.waiting = false;\n",
" return;\n",
" }\n",
" else if (typeof evt.data === 'string' && evt.data.slice(0, 21) == \"data:image/png;base64\") {\n",
" fig.imageObj.src = evt.data;\n",
" fig.updated_canvas_event();\n",
" fig.waiting = false;\n",
" return;\n",
" }\n",
"\n",
" var msg = JSON.parse(evt.data);\n",
" var msg_type = msg['type'];\n",
"\n",
" // Call the \"handle_{type}\" callback, which takes\n",
" // the figure and JSON message as its only arguments.\n",
" try {\n",
" var callback = fig[\"handle_\" + msg_type];\n",
" } catch (e) {\n",
" console.log(\"No handler for the '\" + msg_type + \"' message type: \", msg);\n",
" return;\n",
" }\n",
"\n",
" if (callback) {\n",
" try {\n",
" // console.log(\"Handling '\" + msg_type + \"' message: \", msg);\n",
" callback(fig, msg);\n",
" } catch (e) {\n",
" console.log(\"Exception inside the 'handler_\" + msg_type + \"' callback:\", e, e.stack, msg);\n",
" }\n",
" }\n",
" };\n",
"}\n",
"\n",
"// from http://stackoverflow.com/questions/1114465/getting-mouse-location-in-canvas\n",
"mpl.findpos = function(e) {\n",
" //this section is from http://www.quirksmode.org/js/events_properties.html\n",
" var targ;\n",
" if (!e)\n",
" e = window.event;\n",
" if (e.target)\n",
" targ = e.target;\n",
" else if (e.srcElement)\n",
" targ = e.srcElement;\n",
" if (targ.nodeType == 3) // defeat Safari bug\n",
" targ = targ.parentNode;\n",
"\n",
" // jQuery normalizes the pageX and pageY\n",
" // pageX,Y are the mouse positions relative to the document\n",
" // offset() returns the position of the element relative to the document\n",
" var x = e.pageX - $(targ).offset().left;\n",
" var y = e.pageY - $(targ).offset().top;\n",
"\n",
" return {\"x\": x, \"y\": y};\n",
"};\n",
"\n",
"/*\n",
" * return a copy of an object with only non-object keys\n",
" * we need this to avoid circular references\n",
" * http://stackoverflow.com/a/24161582/3208463\n",
" */\n",
"function simpleKeys (original) {\n",
" return Object.keys(original).reduce(function (obj, key) {\n",
" if (typeof original[key] !== 'object')\n",
" obj[key] = original[key]\n",
" return obj;\n",
" }, {});\n",
"}\n",
"\n",
"mpl.figure.prototype.mouse_event = function(event, name) {\n",
" var canvas_pos = mpl.findpos(event)\n",
"\n",
" if (name === 'button_press')\n",
" {\n",
" this.canvas.focus();\n",
" this.canvas_div.focus();\n",
" }\n",
"\n",
" var x = canvas_pos.x * mpl.ratio;\n",
" var y = canvas_pos.y * mpl.ratio;\n",
"\n",
" this.send_message(name, {x: x, y: y, button: event.button,\n",
" step: event.step,\n",
" guiEvent: simpleKeys(event)});\n",
"\n",
" /* This prevents the web browser from automatically changing to\n",
" * the text insertion cursor when the button is pressed. We want\n",
" * to control all of the cursor setting manually through the\n",
" * 'cursor' event from matplotlib */\n",
" event.preventDefault();\n",
" return false;\n",
"}\n",
"\n",
"mpl.figure.prototype._key_event_extra = function(event, name) {\n",
" // Handle any extra behaviour associated with a key event\n",
"}\n",
"\n",
"mpl.figure.prototype.key_event = function(event, name) {\n",
"\n",
" // Prevent repeat events\n",
" if (name == 'key_press')\n",
" {\n",
" if (event.which === this._key)\n",
" return;\n",
" else\n",
" this._key = event.which;\n",
" }\n",
" if (name == 'key_release')\n",
" this._key = null;\n",
"\n",
" var value = '';\n",
" if (event.ctrlKey && event.which != 17)\n",
" value += \"ctrl+\";\n",
" if (event.altKey && event.which != 18)\n",
" value += \"alt+\";\n",
" if (event.shiftKey && event.which != 16)\n",
" value += \"shift+\";\n",
"\n",
" value += 'k';\n",
" value += event.which.toString();\n",
"\n",
" this._key_event_extra(event, name);\n",
"\n",
" this.send_message(name, {key: value,\n",
" guiEvent: simpleKeys(event)});\n",
" return false;\n",
"}\n",
"\n",
"mpl.figure.prototype.toolbar_button_onclick = function(name) {\n",
" if (name == 'download') {\n",
" this.handle_save(this, null);\n",
" } else {\n",
" this.send_message(\"toolbar_button\", {name: name});\n",
" }\n",
"};\n",
"\n",
"mpl.figure.prototype.toolbar_button_onmouseover = function(tooltip) {\n",
" this.message.textContent = tooltip;\n",
"};\n",
"mpl.toolbar_items = [[\"Home\", \"Reset original view\", \"fa fa-home icon-home\", \"home\"], [\"Back\", \"Back to previous view\", \"fa fa-arrow-left icon-arrow-left\", \"back\"], [\"Forward\", \"Forward to next view\", \"fa fa-arrow-right icon-arrow-right\", \"forward\"], [\"\", \"\", \"\", \"\"], [\"Pan\", \"Pan axes with left mouse, zoom with right\", \"fa fa-arrows icon-move\", \"pan\"], [\"Zoom\", \"Zoom to rectangle\", \"fa fa-square-o icon-check-empty\", \"zoom\"], [\"\", \"\", \"\", \"\"], [\"Download\", \"Download plot\", \"fa fa-floppy-o icon-save\", \"download\"]];\n",
"\n",
"mpl.extensions = [\"eps\", \"pdf\", \"png\", \"ps\", \"raw\", \"svg\"];\n",
"\n",
"mpl.default_extension = \"png\";var comm_websocket_adapter = function(comm) {\n",
" // Create a \"websocket\"-like object which calls the given IPython comm\n",
" // object with the appropriate methods. Currently this is a non binary\n",
" // socket, so there is still some room for performance tuning.\n",
" var ws = {};\n",
"\n",
" ws.close = function() {\n",
" comm.close()\n",
" };\n",
" ws.send = function(m) {\n",
" //console.log('sending', m);\n",
" comm.send(m);\n",
" };\n",
" // Register the callback with on_msg.\n",
" comm.on_msg(function(msg) {\n",
" //console.log('receiving', msg['content']['data'], msg);\n",
" // Pass the mpl event to the overriden (by mpl) onmessage function.\n",
" ws.onmessage(msg['content']['data'])\n",
" });\n",
" return ws;\n",
"}\n",
"\n",
"mpl.mpl_figure_comm = function(comm, msg) {\n",
" // This is the function which gets called when the mpl process\n",
" // starts-up an IPython Comm through the \"matplotlib\" channel.\n",
"\n",
" var id = msg.content.data.id;\n",
" // Get hold of the div created by the display call when the Comm\n",
" // socket was opened in Python.\n",
" var element = $(\"#\" + id);\n",
" var ws_proxy = comm_websocket_adapter(comm)\n",
"\n",
" function ondownload(figure, format) {\n",
" window.open(figure.imageObj.src);\n",
" }\n",
"\n",
" var fig = new mpl.figure(id, ws_proxy,\n",
" ondownload,\n",
" element.get(0));\n",
"\n",
" // Call onopen now - mpl needs it, as it is assuming we've passed it a real\n",
" // web socket which is closed, not our websocket->open comm proxy.\n",
" ws_proxy.onopen();\n",
"\n",
" fig.parent_element = element.get(0);\n",
" fig.cell_info = mpl.find_output_cell(\"\");\n",
" if (!fig.cell_info) {\n",
" console.error(\"Failed to find cell for figure\", id, fig);\n",
" return;\n",
" }\n",
"\n",
" var output_index = fig.cell_info[2]\n",
" var cell = fig.cell_info[0];\n",
"\n",
"};\n",
"\n",
"mpl.figure.prototype.handle_close = function(fig, msg) {\n",
" var width = fig.canvas.width/mpl.ratio\n",
" fig.root.unbind('remove')\n",
"\n",
" // Update the output cell to use the data from the current canvas.\n",
" fig.push_to_output();\n",
" var dataURL = fig.canvas.toDataURL();\n",
" // Re-enable the keyboard manager in IPython - without this line, in FF,\n",
" // the notebook keyboard shortcuts fail.\n",
" IPython.keyboard_manager.enable()\n",
" $(fig.parent_element).html('');\n",
" fig.close_ws(fig, msg);\n",
"}\n",
"\n",
"mpl.figure.prototype.close_ws = function(fig, msg){\n",
" fig.send_message('closing', msg);\n",
" // fig.ws.close()\n",
"}\n",
"\n",
"mpl.figure.prototype.push_to_output = function(remove_interactive) {\n",
" // Turn the data on the canvas into data in the output cell.\n",
" var width = this.canvas.width/mpl.ratio\n",
" var dataURL = this.canvas.toDataURL();\n",
" this.cell_info[1]['text/html'] = '';\n",
"}\n",
"\n",
"mpl.figure.prototype.updated_canvas_event = function() {\n",
" // Tell IPython that the notebook contents must change.\n",
" IPython.notebook.set_dirty(true);\n",
" this.send_message(\"ack\", {});\n",
" var fig = this;\n",
" // Wait a second, then push the new image to the DOM so\n",
" // that it is saved nicely (might be nice to debounce this).\n",
" setTimeout(function () { fig.push_to_output() }, 1000);\n",
"}\n",
"\n",
"mpl.figure.prototype._init_toolbar = function() {\n",
" var fig = this;\n",
"\n",
" var nav_element = $('')\n",
" nav_element.attr('style', 'width: 100%');\n",
" this.root.append(nav_element);\n",
"\n",
" // Define a callback function for later on.\n",
" function toolbar_event(event) {\n",
" return fig.toolbar_button_onclick(event['data']);\n",
" }\n",
" function toolbar_mouse_event(event) {\n",
" return fig.toolbar_button_onmouseover(event['data']);\n",
" }\n",
"\n",
" for(var toolbar_ind in mpl.toolbar_items){\n",
" var name = mpl.toolbar_items[toolbar_ind][0];\n",
" var tooltip = mpl.toolbar_items[toolbar_ind][1];\n",
" var image = mpl.toolbar_items[toolbar_ind][2];\n",
" var method_name = mpl.toolbar_items[toolbar_ind][3];\n",
"\n",
" if (!name) { continue; };\n",
"\n",
" var button = $('');\n",
" button.click(method_name, toolbar_event);\n",
" button.mouseover(tooltip, toolbar_mouse_event);\n",
" nav_element.append(button);\n",
" }\n",
"\n",
" // Add the status bar.\n",
" var status_bar = $('');\n",
" nav_element.append(status_bar);\n",
" this.message = status_bar[0];\n",
"\n",
" // Add the close button to the window.\n",
" var buttongrp = $('');\n",
" var button = $('');\n",
" button.click(function (evt) { fig.handle_close(fig, {}); } );\n",
" button.mouseover('Stop Interaction', toolbar_mouse_event);\n",
" buttongrp.append(button);\n",
" var titlebar = this.root.find($('.ui-dialog-titlebar'));\n",
" titlebar.prepend(buttongrp);\n",
"}\n",
"\n",
"mpl.figure.prototype._root_extra_style = function(el){\n",
" var fig = this\n",
" el.on(\"remove\", function(){\n",
"\tfig.close_ws(fig, {});\n",
" });\n",
"}\n",
"\n",
"mpl.figure.prototype._canvas_extra_style = function(el){\n",
" // this is important to make the div 'focusable\n",
" el.attr('tabindex', 0)\n",
" // reach out to IPython and tell the keyboard manager to turn it's self\n",
" // off when our div gets focus\n",
"\n",
" // location in version 3\n",
" if (IPython.notebook.keyboard_manager) {\n",
" IPython.notebook.keyboard_manager.register_events(el);\n",
" }\n",
" else {\n",
" // location in version 2\n",
" IPython.keyboard_manager.register_events(el);\n",
" }\n",
"\n",
"}\n",
"\n",
"mpl.figure.prototype._key_event_extra = function(event, name) {\n",
" var manager = IPython.notebook.keyboard_manager;\n",
" if (!manager)\n",
" manager = IPython.keyboard_manager;\n",
"\n",
" // Check for shift+enter\n",
" if (event.shiftKey && event.which == 13) {\n",
" this.canvas_div.blur();\n",
" // select the cell after this one\n",
" var index = IPython.notebook.find_cell_index(this.cell_info[0]);\n",
" IPython.notebook.select(index + 1);\n",
" }\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_save = function(fig, msg) {\n",
" fig.ondownload(fig, null);\n",
"}\n",
"\n",
"\n",
"mpl.find_output_cell = function(html_output) {\n",
" // Return the cell and output element which can be found *uniquely* in the notebook.\n",
" // Note - this is a bit hacky, but it is done because the \"notebook_saving.Notebook\"\n",
" // IPython event is triggered only after the cells have been serialised, which for\n",
" // our purposes (turning an active figure into a static one), is too late.\n",
" var cells = IPython.notebook.get_cells();\n",
" var ncells = cells.length;\n",
" for (var i=0; i= 3 moved mimebundle to data attribute of output\n",
" data = data.data;\n",
" }\n",
" if (data['text/html'] == html_output) {\n",
" return [cell, data, j];\n",
" }\n",
" }\n",
" }\n",
" }\n",
"}\n",
"\n",
"// Register the function which deals with the matplotlib target/channel.\n",
"// The kernel may be null if the page has been refreshed.\n",
"if (IPython.notebook.kernel != null) {\n",
" IPython.notebook.kernel.comm_manager.register_target('matplotlib', mpl.mpl_figure_comm);\n",
"}\n"
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
""
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/plain": [
""
]
},
"execution_count": 16,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"from mlp.layers import AffineLayer\n",
"from mlp.errors import SumOfSquaredDiffsError\n",
"from mlp.models import SingleLayerModel\n",
"from mlp.initialisers import UniformInit, ConstantInit\n",
"from mlp.learning_rules import GradientDescentLearningRule\n",
"from mlp.optimisers import Optimiser\n",
"import logging\n",
"\n",
"# Seed a random number generator\n",
"seed = 27092016 \n",
"rng = np.random.RandomState(seed)\n",
"\n",
"# Set up a logger object to print info about the training run to stdout\n",
"logger = logging.getLogger()\n",
"logger.setLevel(logging.INFO)\n",
"logger.handlers = [logging.StreamHandler()]\n",
"\n",
"# Create data provider objects for the CCPP training set\n",
"train_data = CCPPDataProvider('train', [0, 1], batch_size=100, rng=rng)\n",
"input_dim, output_dim = 2, 1\n",
"\n",
"# Create a parameter initialiser which will sample random uniform values\n",
"# from [-0.1, 0.1]\n",
"param_init = UniformInit(-0.1, 0.1, rng=rng)\n",
"\n",
"# Create our single layer model\n",
"layer = AffineLayer(input_dim, output_dim, param_init, param_init)\n",
"model = SingleLayerModel(layer)\n",
"\n",
"# Initialise the error object\n",
"error = SumOfSquaredDiffsError()\n",
"\n",
"# Use a basic gradient descent learning rule with a small learning rate\n",
"learning_rule = GradientDescentLearningRule(learning_rate=1e-2)\n",
"\n",
"# Use the created objects to initialise a new Optimiser instance.\n",
"optimiser = Optimiser(model, error, learning_rule, train_data)\n",
"\n",
"# Run the optimiser for 5 epochs (full passes through the training set)\n",
"# printing statistics every epoch.\n",
"stats, keys, _ = optimiser.train(num_epochs=10, stats_interval=1)\n",
"\n",
"# Plot the change in the error over training.\n",
"fig = plt.figure(figsize=(8, 4))\n",
"ax = fig.add_subplot(111)\n",
"ax.plot(np.arange(1, stats.shape[0] + 1), stats[:, keys['error(train)']])\n",
"ax.set_xlabel('Epoch number')\n",
"ax.set_ylabel('Error')"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Using similar code to previously we can now visualise the joint input-output space for the trained model. If you implemented the required methods correctly you should now see a much improved fit between predicted and target outputs when running the cell below."
]
},
{
"cell_type": "code",
"execution_count": 17,
"metadata": {},
"outputs": [
{
"data": {
"application/javascript": [
"/* Put everything inside the global mpl namespace */\n",
"window.mpl = {};\n",
"\n",
"\n",
"mpl.get_websocket_type = function() {\n",
" if (typeof(WebSocket) !== 'undefined') {\n",
" return WebSocket;\n",
" } else if (typeof(MozWebSocket) !== 'undefined') {\n",
" return MozWebSocket;\n",
" } else {\n",
" alert('Your browser does not have WebSocket support.' +\n",
" 'Please try Chrome, Safari or Firefox ≥ 6. ' +\n",
" 'Firefox 4 and 5 are also supported but you ' +\n",
" 'have to enable WebSockets in about:config.');\n",
" };\n",
"}\n",
"\n",
"mpl.figure = function(figure_id, websocket, ondownload, parent_element) {\n",
" this.id = figure_id;\n",
"\n",
" this.ws = websocket;\n",
"\n",
" this.supports_binary = (this.ws.binaryType != undefined);\n",
"\n",
" if (!this.supports_binary) {\n",
" var warnings = document.getElementById(\"mpl-warnings\");\n",
" if (warnings) {\n",
" warnings.style.display = 'block';\n",
" warnings.textContent = (\n",
" \"This browser does not support binary websocket messages. \" +\n",
" \"Performance may be slow.\");\n",
" }\n",
" }\n",
"\n",
" this.imageObj = new Image();\n",
"\n",
" this.context = undefined;\n",
" this.message = undefined;\n",
" this.canvas = undefined;\n",
" this.rubberband_canvas = undefined;\n",
" this.rubberband_context = undefined;\n",
" this.format_dropdown = undefined;\n",
"\n",
" this.image_mode = 'full';\n",
"\n",
" this.root = $('');\n",
" this._root_extra_style(this.root)\n",
" this.root.attr('style', 'display: inline-block');\n",
"\n",
" $(parent_element).append(this.root);\n",
"\n",
" this._init_header(this);\n",
" this._init_canvas(this);\n",
" this._init_toolbar(this);\n",
"\n",
" var fig = this;\n",
"\n",
" this.waiting = false;\n",
"\n",
" this.ws.onopen = function () {\n",
" fig.send_message(\"supports_binary\", {value: fig.supports_binary});\n",
" fig.send_message(\"send_image_mode\", {});\n",
" if (mpl.ratio != 1) {\n",
" fig.send_message(\"set_dpi_ratio\", {'dpi_ratio': mpl.ratio});\n",
" }\n",
" fig.send_message(\"refresh\", {});\n",
" }\n",
"\n",
" this.imageObj.onload = function() {\n",
" if (fig.image_mode == 'full') {\n",
" // Full images could contain transparency (where diff images\n",
" // almost always do), so we need to clear the canvas so that\n",
" // there is no ghosting.\n",
" fig.context.clearRect(0, 0, fig.canvas.width, fig.canvas.height);\n",
" }\n",
" fig.context.drawImage(fig.imageObj, 0, 0);\n",
" };\n",
"\n",
" this.imageObj.onunload = function() {\n",
" this.ws.close();\n",
" }\n",
"\n",
" this.ws.onmessage = this._make_on_message_function(this);\n",
"\n",
" this.ondownload = ondownload;\n",
"}\n",
"\n",
"mpl.figure.prototype._init_header = function() {\n",
" var titlebar = $(\n",
" '');\n",
" var titletext = $(\n",
" '');\n",
" titlebar.append(titletext)\n",
" this.root.append(titlebar);\n",
" this.header = titletext[0];\n",
"}\n",
"\n",
"\n",
"\n",
"mpl.figure.prototype._canvas_extra_style = function(canvas_div) {\n",
"\n",
"}\n",
"\n",
"\n",
"mpl.figure.prototype._root_extra_style = function(canvas_div) {\n",
"\n",
"}\n",
"\n",
"mpl.figure.prototype._init_canvas = function() {\n",
" var fig = this;\n",
"\n",
" var canvas_div = $('');\n",
"\n",
" canvas_div.attr('style', 'position: relative; clear: both; outline: 0');\n",
"\n",
" function canvas_keyboard_event(event) {\n",
" return fig.key_event(event, event['data']);\n",
" }\n",
"\n",
" canvas_div.keydown('key_press', canvas_keyboard_event);\n",
" canvas_div.keyup('key_release', canvas_keyboard_event);\n",
" this.canvas_div = canvas_div\n",
" this._canvas_extra_style(canvas_div)\n",
" this.root.append(canvas_div);\n",
"\n",
" var canvas = $('');\n",
" canvas.addClass('mpl-canvas');\n",
" canvas.attr('style', \"left: 0; top: 0; z-index: 0; outline: 0\")\n",
"\n",
" this.canvas = canvas[0];\n",
" this.context = canvas[0].getContext(\"2d\");\n",
"\n",
" var backingStore = this.context.backingStorePixelRatio ||\n",
"\tthis.context.webkitBackingStorePixelRatio ||\n",
"\tthis.context.mozBackingStorePixelRatio ||\n",
"\tthis.context.msBackingStorePixelRatio ||\n",
"\tthis.context.oBackingStorePixelRatio ||\n",
"\tthis.context.backingStorePixelRatio || 1;\n",
"\n",
" mpl.ratio = (window.devicePixelRatio || 1) / backingStore;\n",
"\n",
" var rubberband = $('');\n",
" rubberband.attr('style', \"position: absolute; left: 0; top: 0; z-index: 1;\")\n",
"\n",
" var pass_mouse_events = true;\n",
"\n",
" canvas_div.resizable({\n",
" start: function(event, ui) {\n",
" pass_mouse_events = false;\n",
" },\n",
" resize: function(event, ui) {\n",
" fig.request_resize(ui.size.width, ui.size.height);\n",
" },\n",
" stop: function(event, ui) {\n",
" pass_mouse_events = true;\n",
" fig.request_resize(ui.size.width, ui.size.height);\n",
" },\n",
" });\n",
"\n",
" function mouse_event_fn(event) {\n",
" if (pass_mouse_events)\n",
" return fig.mouse_event(event, event['data']);\n",
" }\n",
"\n",
" rubberband.mousedown('button_press', mouse_event_fn);\n",
" rubberband.mouseup('button_release', mouse_event_fn);\n",
" // Throttle sequential mouse events to 1 every 20ms.\n",
" rubberband.mousemove('motion_notify', mouse_event_fn);\n",
"\n",
" rubberband.mouseenter('figure_enter', mouse_event_fn);\n",
" rubberband.mouseleave('figure_leave', mouse_event_fn);\n",
"\n",
" canvas_div.on(\"wheel\", function (event) {\n",
" event = event.originalEvent;\n",
" event['data'] = 'scroll'\n",
" if (event.deltaY < 0) {\n",
" event.step = 1;\n",
" } else {\n",
" event.step = -1;\n",
" }\n",
" mouse_event_fn(event);\n",
" });\n",
"\n",
" canvas_div.append(canvas);\n",
" canvas_div.append(rubberband);\n",
"\n",
" this.rubberband = rubberband;\n",
" this.rubberband_canvas = rubberband[0];\n",
" this.rubberband_context = rubberband[0].getContext(\"2d\");\n",
" this.rubberband_context.strokeStyle = \"#000000\";\n",
"\n",
" this._resize_canvas = function(width, height) {\n",
" // Keep the size of the canvas, canvas container, and rubber band\n",
" // canvas in synch.\n",
" canvas_div.css('width', width)\n",
" canvas_div.css('height', height)\n",
"\n",
" canvas.attr('width', width * mpl.ratio);\n",
" canvas.attr('height', height * mpl.ratio);\n",
" canvas.attr('style', 'width: ' + width + 'px; height: ' + height + 'px;');\n",
"\n",
" rubberband.attr('width', width);\n",
" rubberband.attr('height', height);\n",
" }\n",
"\n",
" // Set the figure to an initial 600x600px, this will subsequently be updated\n",
" // upon first draw.\n",
" this._resize_canvas(600, 600);\n",
"\n",
" // Disable right mouse context menu.\n",
" $(this.rubberband_canvas).bind(\"contextmenu\",function(e){\n",
" return false;\n",
" });\n",
"\n",
" function set_focus () {\n",
" canvas.focus();\n",
" canvas_div.focus();\n",
" }\n",
"\n",
" window.setTimeout(set_focus, 100);\n",
"}\n",
"\n",
"mpl.figure.prototype._init_toolbar = function() {\n",
" var fig = this;\n",
"\n",
" var nav_element = $('')\n",
" nav_element.attr('style', 'width: 100%');\n",
" this.root.append(nav_element);\n",
"\n",
" // Define a callback function for later on.\n",
" function toolbar_event(event) {\n",
" return fig.toolbar_button_onclick(event['data']);\n",
" }\n",
" function toolbar_mouse_event(event) {\n",
" return fig.toolbar_button_onmouseover(event['data']);\n",
" }\n",
"\n",
" for(var toolbar_ind in mpl.toolbar_items) {\n",
" var name = mpl.toolbar_items[toolbar_ind][0];\n",
" var tooltip = mpl.toolbar_items[toolbar_ind][1];\n",
" var image = mpl.toolbar_items[toolbar_ind][2];\n",
" var method_name = mpl.toolbar_items[toolbar_ind][3];\n",
"\n",
" if (!name) {\n",
" // put a spacer in here.\n",
" continue;\n",
" }\n",
" var button = $('');\n",
" button.addClass('ui-button ui-widget ui-state-default ui-corner-all ' +\n",
" 'ui-button-icon-only');\n",
" button.attr('role', 'button');\n",
" button.attr('aria-disabled', 'false');\n",
" button.click(method_name, toolbar_event);\n",
" button.mouseover(tooltip, toolbar_mouse_event);\n",
"\n",
" var icon_img = $('');\n",
" icon_img.addClass('ui-button-icon-primary ui-icon');\n",
" icon_img.addClass(image);\n",
" icon_img.addClass('ui-corner-all');\n",
"\n",
" var tooltip_span = $('');\n",
" tooltip_span.addClass('ui-button-text');\n",
" tooltip_span.html(tooltip);\n",
"\n",
" button.append(icon_img);\n",
" button.append(tooltip_span);\n",
"\n",
" nav_element.append(button);\n",
" }\n",
"\n",
" var fmt_picker_span = $('');\n",
"\n",
" var fmt_picker = $('');\n",
" fmt_picker.addClass('mpl-toolbar-option ui-widget ui-widget-content');\n",
" fmt_picker_span.append(fmt_picker);\n",
" nav_element.append(fmt_picker_span);\n",
" this.format_dropdown = fmt_picker[0];\n",
"\n",
" for (var ind in mpl.extensions) {\n",
" var fmt = mpl.extensions[ind];\n",
" var option = $(\n",
" '', {selected: fmt === mpl.default_extension}).html(fmt);\n",
" fmt_picker.append(option)\n",
" }\n",
"\n",
" // Add hover states to the ui-buttons\n",
" $( \".ui-button\" ).hover(\n",
" function() { $(this).addClass(\"ui-state-hover\");},\n",
" function() { $(this).removeClass(\"ui-state-hover\");}\n",
" );\n",
"\n",
" var status_bar = $('');\n",
" nav_element.append(status_bar);\n",
" this.message = status_bar[0];\n",
"}\n",
"\n",
"mpl.figure.prototype.request_resize = function(x_pixels, y_pixels) {\n",
" // Request matplotlib to resize the figure. Matplotlib will then trigger a resize in the client,\n",
" // which will in turn request a refresh of the image.\n",
" this.send_message('resize', {'width': x_pixels, 'height': y_pixels});\n",
"}\n",
"\n",
"mpl.figure.prototype.send_message = function(type, properties) {\n",
" properties['type'] = type;\n",
" properties['figure_id'] = this.id;\n",
" this.ws.send(JSON.stringify(properties));\n",
"}\n",
"\n",
"mpl.figure.prototype.send_draw_message = function() {\n",
" if (!this.waiting) {\n",
" this.waiting = true;\n",
" this.ws.send(JSON.stringify({type: \"draw\", figure_id: this.id}));\n",
" }\n",
"}\n",
"\n",
"\n",
"mpl.figure.prototype.handle_save = function(fig, msg) {\n",
" var format_dropdown = fig.format_dropdown;\n",
" var format = format_dropdown.options[format_dropdown.selectedIndex].value;\n",
" fig.ondownload(fig, format);\n",
"}\n",
"\n",
"\n",
"mpl.figure.prototype.handle_resize = function(fig, msg) {\n",
" var size = msg['size'];\n",
" if (size[0] != fig.canvas.width || size[1] != fig.canvas.height) {\n",
" fig._resize_canvas(size[0], size[1]);\n",
" fig.send_message(\"refresh\", {});\n",
" };\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_rubberband = function(fig, msg) {\n",
" var x0 = msg['x0'] / mpl.ratio;\n",
" var y0 = (fig.canvas.height - msg['y0']) / mpl.ratio;\n",
" var x1 = msg['x1'] / mpl.ratio;\n",
" var y1 = (fig.canvas.height - msg['y1']) / mpl.ratio;\n",
" x0 = Math.floor(x0) + 0.5;\n",
" y0 = Math.floor(y0) + 0.5;\n",
" x1 = Math.floor(x1) + 0.5;\n",
" y1 = Math.floor(y1) + 0.5;\n",
" var min_x = Math.min(x0, x1);\n",
" var min_y = Math.min(y0, y1);\n",
" var width = Math.abs(x1 - x0);\n",
" var height = Math.abs(y1 - y0);\n",
"\n",
" fig.rubberband_context.clearRect(\n",
" 0, 0, fig.canvas.width, fig.canvas.height);\n",
"\n",
" fig.rubberband_context.strokeRect(min_x, min_y, width, height);\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_figure_label = function(fig, msg) {\n",
" // Updates the figure title.\n",
" fig.header.textContent = msg['label'];\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_cursor = function(fig, msg) {\n",
" var cursor = msg['cursor'];\n",
" switch(cursor)\n",
" {\n",
" case 0:\n",
" cursor = 'pointer';\n",
" break;\n",
" case 1:\n",
" cursor = 'default';\n",
" break;\n",
" case 2:\n",
" cursor = 'crosshair';\n",
" break;\n",
" case 3:\n",
" cursor = 'move';\n",
" break;\n",
" }\n",
" fig.rubberband_canvas.style.cursor = cursor;\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_message = function(fig, msg) {\n",
" fig.message.textContent = msg['message'];\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_draw = function(fig, msg) {\n",
" // Request the server to send over a new figure.\n",
" fig.send_draw_message();\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_image_mode = function(fig, msg) {\n",
" fig.image_mode = msg['mode'];\n",
"}\n",
"\n",
"mpl.figure.prototype.updated_canvas_event = function() {\n",
" // Called whenever the canvas gets updated.\n",
" this.send_message(\"ack\", {});\n",
"}\n",
"\n",
"// A function to construct a web socket function for onmessage handling.\n",
"// Called in the figure constructor.\n",
"mpl.figure.prototype._make_on_message_function = function(fig) {\n",
" return function socket_on_message(evt) {\n",
" if (evt.data instanceof Blob) {\n",
" /* FIXME: We get \"Resource interpreted as Image but\n",
" * transferred with MIME type text/plain:\" errors on\n",
" * Chrome. But how to set the MIME type? It doesn't seem\n",
" * to be part of the websocket stream */\n",
" evt.data.type = \"image/png\";\n",
"\n",
" /* Free the memory for the previous frames */\n",
" if (fig.imageObj.src) {\n",
" (window.URL || window.webkitURL).revokeObjectURL(\n",
" fig.imageObj.src);\n",
" }\n",
"\n",
" fig.imageObj.src = (window.URL || window.webkitURL).createObjectURL(\n",
" evt.data);\n",
" fig.updated_canvas_event();\n",
" fig.waiting = false;\n",
" return;\n",
" }\n",
" else if (typeof evt.data === 'string' && evt.data.slice(0, 21) == \"data:image/png;base64\") {\n",
" fig.imageObj.src = evt.data;\n",
" fig.updated_canvas_event();\n",
" fig.waiting = false;\n",
" return;\n",
" }\n",
"\n",
" var msg = JSON.parse(evt.data);\n",
" var msg_type = msg['type'];\n",
"\n",
" // Call the \"handle_{type}\" callback, which takes\n",
" // the figure and JSON message as its only arguments.\n",
" try {\n",
" var callback = fig[\"handle_\" + msg_type];\n",
" } catch (e) {\n",
" console.log(\"No handler for the '\" + msg_type + \"' message type: \", msg);\n",
" return;\n",
" }\n",
"\n",
" if (callback) {\n",
" try {\n",
" // console.log(\"Handling '\" + msg_type + \"' message: \", msg);\n",
" callback(fig, msg);\n",
" } catch (e) {\n",
" console.log(\"Exception inside the 'handler_\" + msg_type + \"' callback:\", e, e.stack, msg);\n",
" }\n",
" }\n",
" };\n",
"}\n",
"\n",
"// from http://stackoverflow.com/questions/1114465/getting-mouse-location-in-canvas\n",
"mpl.findpos = function(e) {\n",
" //this section is from http://www.quirksmode.org/js/events_properties.html\n",
" var targ;\n",
" if (!e)\n",
" e = window.event;\n",
" if (e.target)\n",
" targ = e.target;\n",
" else if (e.srcElement)\n",
" targ = e.srcElement;\n",
" if (targ.nodeType == 3) // defeat Safari bug\n",
" targ = targ.parentNode;\n",
"\n",
" // jQuery normalizes the pageX and pageY\n",
" // pageX,Y are the mouse positions relative to the document\n",
" // offset() returns the position of the element relative to the document\n",
" var x = e.pageX - $(targ).offset().left;\n",
" var y = e.pageY - $(targ).offset().top;\n",
"\n",
" return {\"x\": x, \"y\": y};\n",
"};\n",
"\n",
"/*\n",
" * return a copy of an object with only non-object keys\n",
" * we need this to avoid circular references\n",
" * http://stackoverflow.com/a/24161582/3208463\n",
" */\n",
"function simpleKeys (original) {\n",
" return Object.keys(original).reduce(function (obj, key) {\n",
" if (typeof original[key] !== 'object')\n",
" obj[key] = original[key]\n",
" return obj;\n",
" }, {});\n",
"}\n",
"\n",
"mpl.figure.prototype.mouse_event = function(event, name) {\n",
" var canvas_pos = mpl.findpos(event)\n",
"\n",
" if (name === 'button_press')\n",
" {\n",
" this.canvas.focus();\n",
" this.canvas_div.focus();\n",
" }\n",
"\n",
" var x = canvas_pos.x * mpl.ratio;\n",
" var y = canvas_pos.y * mpl.ratio;\n",
"\n",
" this.send_message(name, {x: x, y: y, button: event.button,\n",
" step: event.step,\n",
" guiEvent: simpleKeys(event)});\n",
"\n",
" /* This prevents the web browser from automatically changing to\n",
" * the text insertion cursor when the button is pressed. We want\n",
" * to control all of the cursor setting manually through the\n",
" * 'cursor' event from matplotlib */\n",
" event.preventDefault();\n",
" return false;\n",
"}\n",
"\n",
"mpl.figure.prototype._key_event_extra = function(event, name) {\n",
" // Handle any extra behaviour associated with a key event\n",
"}\n",
"\n",
"mpl.figure.prototype.key_event = function(event, name) {\n",
"\n",
" // Prevent repeat events\n",
" if (name == 'key_press')\n",
" {\n",
" if (event.which === this._key)\n",
" return;\n",
" else\n",
" this._key = event.which;\n",
" }\n",
" if (name == 'key_release')\n",
" this._key = null;\n",
"\n",
" var value = '';\n",
" if (event.ctrlKey && event.which != 17)\n",
" value += \"ctrl+\";\n",
" if (event.altKey && event.which != 18)\n",
" value += \"alt+\";\n",
" if (event.shiftKey && event.which != 16)\n",
" value += \"shift+\";\n",
"\n",
" value += 'k';\n",
" value += event.which.toString();\n",
"\n",
" this._key_event_extra(event, name);\n",
"\n",
" this.send_message(name, {key: value,\n",
" guiEvent: simpleKeys(event)});\n",
" return false;\n",
"}\n",
"\n",
"mpl.figure.prototype.toolbar_button_onclick = function(name) {\n",
" if (name == 'download') {\n",
" this.handle_save(this, null);\n",
" } else {\n",
" this.send_message(\"toolbar_button\", {name: name});\n",
" }\n",
"};\n",
"\n",
"mpl.figure.prototype.toolbar_button_onmouseover = function(tooltip) {\n",
" this.message.textContent = tooltip;\n",
"};\n",
"mpl.toolbar_items = [[\"Home\", \"Reset original view\", \"fa fa-home icon-home\", \"home\"], [\"Back\", \"Back to previous view\", \"fa fa-arrow-left icon-arrow-left\", \"back\"], [\"Forward\", \"Forward to next view\", \"fa fa-arrow-right icon-arrow-right\", \"forward\"], [\"\", \"\", \"\", \"\"], [\"Pan\", \"Pan axes with left mouse, zoom with right\", \"fa fa-arrows icon-move\", \"pan\"], [\"Zoom\", \"Zoom to rectangle\", \"fa fa-square-o icon-check-empty\", \"zoom\"], [\"\", \"\", \"\", \"\"], [\"Download\", \"Download plot\", \"fa fa-floppy-o icon-save\", \"download\"]];\n",
"\n",
"mpl.extensions = [\"eps\", \"pdf\", \"png\", \"ps\", \"raw\", \"svg\"];\n",
"\n",
"mpl.default_extension = \"png\";var comm_websocket_adapter = function(comm) {\n",
" // Create a \"websocket\"-like object which calls the given IPython comm\n",
" // object with the appropriate methods. Currently this is a non binary\n",
" // socket, so there is still some room for performance tuning.\n",
" var ws = {};\n",
"\n",
" ws.close = function() {\n",
" comm.close()\n",
" };\n",
" ws.send = function(m) {\n",
" //console.log('sending', m);\n",
" comm.send(m);\n",
" };\n",
" // Register the callback with on_msg.\n",
" comm.on_msg(function(msg) {\n",
" //console.log('receiving', msg['content']['data'], msg);\n",
" // Pass the mpl event to the overriden (by mpl) onmessage function.\n",
" ws.onmessage(msg['content']['data'])\n",
" });\n",
" return ws;\n",
"}\n",
"\n",
"mpl.mpl_figure_comm = function(comm, msg) {\n",
" // This is the function which gets called when the mpl process\n",
" // starts-up an IPython Comm through the \"matplotlib\" channel.\n",
"\n",
" var id = msg.content.data.id;\n",
" // Get hold of the div created by the display call when the Comm\n",
" // socket was opened in Python.\n",
" var element = $(\"#\" + id);\n",
" var ws_proxy = comm_websocket_adapter(comm)\n",
"\n",
" function ondownload(figure, format) {\n",
" window.open(figure.imageObj.src);\n",
" }\n",
"\n",
" var fig = new mpl.figure(id, ws_proxy,\n",
" ondownload,\n",
" element.get(0));\n",
"\n",
" // Call onopen now - mpl needs it, as it is assuming we've passed it a real\n",
" // web socket which is closed, not our websocket->open comm proxy.\n",
" ws_proxy.onopen();\n",
"\n",
" fig.parent_element = element.get(0);\n",
" fig.cell_info = mpl.find_output_cell(\"\");\n",
" if (!fig.cell_info) {\n",
" console.error(\"Failed to find cell for figure\", id, fig);\n",
" return;\n",
" }\n",
"\n",
" var output_index = fig.cell_info[2]\n",
" var cell = fig.cell_info[0];\n",
"\n",
"};\n",
"\n",
"mpl.figure.prototype.handle_close = function(fig, msg) {\n",
" var width = fig.canvas.width/mpl.ratio\n",
" fig.root.unbind('remove')\n",
"\n",
" // Update the output cell to use the data from the current canvas.\n",
" fig.push_to_output();\n",
" var dataURL = fig.canvas.toDataURL();\n",
" // Re-enable the keyboard manager in IPython - without this line, in FF,\n",
" // the notebook keyboard shortcuts fail.\n",
" IPython.keyboard_manager.enable()\n",
" $(fig.parent_element).html('');\n",
" fig.close_ws(fig, msg);\n",
"}\n",
"\n",
"mpl.figure.prototype.close_ws = function(fig, msg){\n",
" fig.send_message('closing', msg);\n",
" // fig.ws.close()\n",
"}\n",
"\n",
"mpl.figure.prototype.push_to_output = function(remove_interactive) {\n",
" // Turn the data on the canvas into data in the output cell.\n",
" var width = this.canvas.width/mpl.ratio\n",
" var dataURL = this.canvas.toDataURL();\n",
" this.cell_info[1]['text/html'] = '';\n",
"}\n",
"\n",
"mpl.figure.prototype.updated_canvas_event = function() {\n",
" // Tell IPython that the notebook contents must change.\n",
" IPython.notebook.set_dirty(true);\n",
" this.send_message(\"ack\", {});\n",
" var fig = this;\n",
" // Wait a second, then push the new image to the DOM so\n",
" // that it is saved nicely (might be nice to debounce this).\n",
" setTimeout(function () { fig.push_to_output() }, 1000);\n",
"}\n",
"\n",
"mpl.figure.prototype._init_toolbar = function() {\n",
" var fig = this;\n",
"\n",
" var nav_element = $('')\n",
" nav_element.attr('style', 'width: 100%');\n",
" this.root.append(nav_element);\n",
"\n",
" // Define a callback function for later on.\n",
" function toolbar_event(event) {\n",
" return fig.toolbar_button_onclick(event['data']);\n",
" }\n",
" function toolbar_mouse_event(event) {\n",
" return fig.toolbar_button_onmouseover(event['data']);\n",
" }\n",
"\n",
" for(var toolbar_ind in mpl.toolbar_items){\n",
" var name = mpl.toolbar_items[toolbar_ind][0];\n",
" var tooltip = mpl.toolbar_items[toolbar_ind][1];\n",
" var image = mpl.toolbar_items[toolbar_ind][2];\n",
" var method_name = mpl.toolbar_items[toolbar_ind][3];\n",
"\n",
" if (!name) { continue; };\n",
"\n",
" var button = $('');\n",
" button.click(method_name, toolbar_event);\n",
" button.mouseover(tooltip, toolbar_mouse_event);\n",
" nav_element.append(button);\n",
" }\n",
"\n",
" // Add the status bar.\n",
" var status_bar = $('');\n",
" nav_element.append(status_bar);\n",
" this.message = status_bar[0];\n",
"\n",
" // Add the close button to the window.\n",
" var buttongrp = $('');\n",
" var button = $('');\n",
" button.click(function (evt) { fig.handle_close(fig, {}); } );\n",
" button.mouseover('Stop Interaction', toolbar_mouse_event);\n",
" buttongrp.append(button);\n",
" var titlebar = this.root.find($('.ui-dialog-titlebar'));\n",
" titlebar.prepend(buttongrp);\n",
"}\n",
"\n",
"mpl.figure.prototype._root_extra_style = function(el){\n",
" var fig = this\n",
" el.on(\"remove\", function(){\n",
"\tfig.close_ws(fig, {});\n",
" });\n",
"}\n",
"\n",
"mpl.figure.prototype._canvas_extra_style = function(el){\n",
" // this is important to make the div 'focusable\n",
" el.attr('tabindex', 0)\n",
" // reach out to IPython and tell the keyboard manager to turn it's self\n",
" // off when our div gets focus\n",
"\n",
" // location in version 3\n",
" if (IPython.notebook.keyboard_manager) {\n",
" IPython.notebook.keyboard_manager.register_events(el);\n",
" }\n",
" else {\n",
" // location in version 2\n",
" IPython.keyboard_manager.register_events(el);\n",
" }\n",
"\n",
"}\n",
"\n",
"mpl.figure.prototype._key_event_extra = function(event, name) {\n",
" var manager = IPython.notebook.keyboard_manager;\n",
" if (!manager)\n",
" manager = IPython.keyboard_manager;\n",
"\n",
" // Check for shift+enter\n",
" if (event.shiftKey && event.which == 13) {\n",
" this.canvas_div.blur();\n",
" // select the cell after this one\n",
" var index = IPython.notebook.find_cell_index(this.cell_info[0]);\n",
" IPython.notebook.select(index + 1);\n",
" }\n",
"}\n",
"\n",
"mpl.figure.prototype.handle_save = function(fig, msg) {\n",
" fig.ondownload(fig, null);\n",
"}\n",
"\n",
"\n",
"mpl.find_output_cell = function(html_output) {\n",
" // Return the cell and output element which can be found *uniquely* in the notebook.\n",
" // Note - this is a bit hacky, but it is done because the \"notebook_saving.Notebook\"\n",
" // IPython event is triggered only after the cells have been serialised, which for\n",
" // our purposes (turning an active figure into a static one), is too late.\n",
" var cells = IPython.notebook.get_cells();\n",
" var ncells = cells.length;\n",
" for (var i=0; i= 3 moved mimebundle to data attribute of output\n",
" data = data.data;\n",
" }\n",
" if (data['text/html'] == html_output) {\n",
" return [cell, data, j];\n",
" }\n",
" }\n",
" }\n",
" }\n",
"}\n",
"\n",
"// Register the function which deals with the matplotlib target/channel.\n",
"// The kernel may be null if the page has been refreshed.\n",
"if (IPython.notebook.kernel != null) {\n",
" IPython.notebook.kernel.comm_manager.register_target('matplotlib', mpl.mpl_figure_comm);\n",
"}\n"
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
""
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"data_provider = CCPPDataProvider(\n",
" which_set='train',\n",
" input_dims=[0, 1],\n",
" batch_size=5000, \n",
" max_num_batches=1, \n",
" shuffle_order=False\n",
")\n",
"\n",
"inputs, targets = data_provider.next()\n",
"\n",
"# Calculate predicted model outputs\n",
"outputs = model.fprop(inputs)[-1]\n",
"\n",
"# Plot target and predicted outputs against inputs on same axis\n",
"fig = plt.figure(figsize=(8, 8))\n",
"ax = fig.add_subplot(111, projection='3d')\n",
"ax.plot(inputs[:, 0], inputs[:, 1], targets[:, 0], 'r.', ms=2)\n",
"ax.plot(inputs[:, 0], inputs[:, 1], outputs[:, 0], 'b.', ms=2)\n",
"ax.set_xlabel('Input dim 1')\n",
"ax.set_ylabel('Input dim 2')\n",
"ax.set_zlabel('Output')\n",
"ax.legend(['Targets', 'Predictions'], frameon=False)\n",
"fig.tight_layout()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Exercise 6: visualising training trajectories in parameter space"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Running the cell below will display an interactive widget which plots the trajectories of gradient-based training of the single-layer affine model on the CCPP dataset in the three dimensional parameter space (two weights plus bias) from random initialisations. Also shown on the right is a plot of the evolution of the error function (evaluated on the current batch) over training. By moving the sliders you can alter the training hyperparameters to investigate the effect they have on how training procedes.\n",
"\n",
"Some questions to explore:\n",
"\n",
" * Are there multiple local minima in parameter space here? Why?\n",
" * What happens to learning for very small learning rates? And very large learning rates?\n",
" * How does the batch size affect learning?\n",
" \n",
"**Note:** You don't need to understand how the code below works. The idea of this exercise is to help you understand the role of the various hyperparameters involved in gradient-descent based training methods."
]
},
{
"cell_type": "code",
"execution_count": 18,
"metadata": {
"scrolled": false
},
"outputs": [
{
"data": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAAA3UAAAHFCAYAAABVW9B8AAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAIABJREFUeJzs3XecVOWh//HPMzPbgQVhacuyLCBVKSo2sPcoKnZFLBhN\nvUmUm5hifmquMdF7TaL3+ooxUeyaWFCxYNeooGJBpCkgvUrdPu08vz9mz7CdXdw9077v12tfMGfO\nnOc5swP7fPdpxlqLiIiIiIiIpCZfoisgIiIiIiIi+06hTkREREREJIUp1ImIiIiIiKQwhToRERER\nEZEUplAnIiIiIiKSwhTqREREREREUphCnYiIiIiISApTqBMREREREUlhCnUiIiIiIiIpLNDO822n\n1EJERKRzmURXQEREpLOop05ERERERCSFKdSJiIiIiIikMIU6ERERERGRFKZQJyIiIiIiksIU6kRE\nRERERFKYQp2IiIiIiEgKU6gTERERERFJYQp1IiIiIiIiKUyhTkREREREJIUp1ImIiIiIiKQwhToR\nEREREZEUplAnIiIiIiKSwhTqREREREREUphCnYiIiIiISApTqBMREREREUlhCnUiIiIiIiIpTKFO\nREREREQkhSnUiYiIiIiIpDCFOpE2evTRRzn55JMTXQ3Wrl1Lly5diEajia5K0nj33XcZPnx4h58r\nIiIikgqMtbY957frZEmsQYMGsWXLFvx+PwUFBZx22mn83//9H126dEl01Vp1xRVXMGDAAG655Zak\nvua+WL16NWVlZYTDYQKBQELrkixuuukmVqxYwSOPPJLoqkh6M4mugIiISGdRT12amz17NpWVlXz6\n6ad8/PHH+xRqIpFIJ9Ss8+xLfVPlHlOlni3Zl/pba3EcpxNqIyIiIpIeFOoyRHFxMaeddhqLFi0C\nYObMmYwcOZKuXbsyePBg/va3v8XPffvttxkwYAC33XYbffv25corr2Tnzp2cccYZFBUV0aNHD844\n4wzWr18ff82xxx7LDTfcwJFHHkmXLl2YPHky27dvZ+rUqXTr1o0JEyawevXq+PnLli3jpJNOYr/9\n9mP48OH861//AuDee+/l0Ucf5fbbb49fB2Djxo2ce+65FBUVUVZWxl133RW/1k033cR5553HpZde\nSrdu3XjggQca3HtL1xw0aBC33XYbY8aMoaCggEgkwh//+EeGDBlC165dGTVqFLNmzYpf54EHHmDS\npEl7vQeAmpoaZsyYQWlpKYWFhUyaNImamhqOPvpoALp3706XLl2YN28ejuNwyy23UFpaSu/evbns\nssvYvXs3EOvZM8Zw3333MXDgQI4//vj4MTcg7d69m6uuuop+/fpRXFzMDTfcEB+auWLFCo455hgK\nCwvp1asXF154YYufkeeff57Ro0fTvXt3jj32WJYuXQrAbbfdxnnnndfg3J/+9Kf85Cc/2Wv5Dzzw\nABMnTuTaa6+lZ8+e3HTTTQ2uM2fOHG699Vb++c9/0qVLF8aOHRv/PP3mN79h4sSJ5Ofn8/XXX7fp\nM+saNGgQ//M//8OYMWMoLCzkwgsvpLa2tt3nAtx+++3069eP/v37849//ANjDCtWrGjxfRQRERHx\nnLW2PV+SQkpLS+1rr71mrbV27dq1dtSoUfaGG26w1lr7wgsv2BUrVljHcezbb79t8/Ly7CeffGKt\ntfatt96yfr/f/uIXv7C1tbW2urrabtu2zT711FO2qqrKlpeX2/POO8+eddZZ8bKOOeYYO2TIELti\nxQq7a9cuO3LkSLv//vvb1157zYbDYTtt2jR7xRVXWGutraystAMGDLD333+/DYfD9tNPP7U9e/a0\nixcvttZae/nll9vf/OY38WtHo1F70EEH2ZtvvtkGg0G7cuVKW1ZWZufMmWOttfbGG2+0gUDAzpo1\ny0ajUVtdXd3kvWh8Tff9GTt2rF27dm38Nf/617/shg0bbDQatU888YTNz8+3GzdutNZaO3PmTDtx\n4sQ23cMPf/hDe8wxx9j169fbSCRi33//fVtbW2tXrVplARsOh+P1uO++++yQIUPsypUrbUVFhZ0y\nZYq99NJLrbU2fv60adNsZWWlra6ubnKNs88+215zzTW2srLSbtmyxU6YMMHec8891lprL7roInvL\nLbfYaDRqa2pq7LvvvtvsZ+XLL7+0+fn59tVXX7WhUMjedtttdsiQITYYDNrVq1fbvLw8W15ebq21\nNhKJ2L59+9p58+bttfyZM2dav99v77rrLhsOh5v93tx444126tSpDY4dc8wxtqSkxC5atMiGw2Eb\nCoX2+pktLi5u8L2dMGGC3bBhg92+fbsdMWKE/etf/9ruc19++WXbp08fu2jRIltVVWWnTp1qAbt8\n+fJm30dJau39eacvfelLX/rSV8p8tfcFkkJKS0ttQUGBLSwstAMHDrQ/+MEPmm1UW2vtWWedZf/y\nl79Ya2ON3qysLFtTU9PitT/77DPbvXv3+ONjjjnG3nLLLfHH1113nT311FPjj59//nk7duxYa621\nTzzxhJ00aVKD611zzTX2pptustY2DWAffPCBLSkpaXD+rbfeGg+JN954oz3qqKNafiOauaa1sffn\nvvvua/V1Y8eOtc8++6y1tmGoa+0eotGozc3NtQsWLGhyveZC3fHHH2/vvvvu+ONly5bZQCBgw+Fw\n/PyVK1c2e43Nmzfb7OzsBt/Xxx57zB577LHWWmunTZtmr776artu3bpW7/N3v/udPf/88+OPo9Go\n7d+/v33rrbestdZOnDjRPvjgg9Zaa1999VU7ePBga63da/kzZ85s8r1rrKVQ99vf/rbV1zX+zDYO\nag8//HD88c9//nP7ve99r93nXnnllfaXv/xl/Lnly5cr1KWuhP/A1Ze+9KUvfemrs760UkOae/bZ\nZznxxBObHH/55Ze5+eab+eqrr3Ach+rqag488MD480VFReTm5sYfV1dXc+211zJnzhx27twJQEVF\nBdFoFL/fD0CfPn3i5+fl5TV5XFlZCcCaNWv48MMP6d69e/z5SCTCtGnTmr2HNWvWsHHjxgbnR6NR\njjrqqPjjkpKStr0hjTR+3UMPPcSf/vSn+FDRyspKtm3b1mydWrqHbdu2UVtby5AhQ9pUh40bN1Ja\nWhp/XFpaSiQSYcuWLS3Ws349wuEw/fr1ix9zHCd+/u23385vf/tbDj30UHr06MGMGTOYPn36Xuvg\n8/koKSlhw4YNAFxyySU8/vjjXHbZZTz22GNccsklbSq/tbrvTePX7e0z21jfvn3jf8/Pz2fjxo3t\nPnfjxo0ccsghLdZJREREJBko1GWgYDDIueeey0MPPcRZZ51FVlYWZ599NtbuWdzUmIYLxd1xxx18\n+eWXfPjhh/Tt25cFCxYwfvz4Bq9pq5KSEo455hhee+21Zp9vXHZJSQllZWUsX768xWs2fk1bn69/\nfM2aNVx99dW88cYbHHHEEfj9fsaNG9fsPbZ2D47jkJuby8qVK+NzxFqrR//+/VmzZk388dq1awkE\nAvTp0yc+b7Gl+peUlJCTk8O2bduaXU2zb9++/P3vfwfgvffe48QTT+Too49m6NChTerwxRdfxB9b\na1m3bh3FxcUAnH/++cyYMYP169cza9Ys5s2b16byW6v73p6vf7wtn9nO0K9fvwZzR9etW9ep5YmI\niIjsCy2UkoFCoRDBYJCioiICgQAvv/wyr776aquvqaioIC8vj+7du7Njxw5uvvnmfS7/jDPO4Kuv\nvuLhhx8mHA4TDoeZP39+fGGOPn368PXXX8fPP/TQQ+natSu33XYbNTU1RKNRFi1axPz589tcZuNr\nNqeqqgpjDEVFRUBsMRl3YZn23IPP52P69Olcd911bNy4kWg0yrx58+Lvuc/na1CXiy++mD//+c+s\nWrWKyspKfv3rX3PhhRe2acuDfv36cfLJJzNjxgzKy8txHIeVK1fyzjvvAPDkk0/GQ0mPHj0wxuDz\nNf1nf8EFF/Diiy/yxhtvEA6HueOOO8jJyeHII48EYj23xx57LFdeeSVlZWWMHDmyTeW3RZ8+fVi9\nenWrK1zuy2e2I1xwwQXMnDmTpUuXUl1dzX/91391epkiIiIi7aVQl4G6du3KXXfdxQUXXECPHj14\n7LHHOPPMM1t9zc9+9jNqamro1asXhx9+OKeeeuq3Kv/VV1/liSeeoH///vTt25frr7+eYDAIwFVX\nXcWSJUvo3r07Z599Nn6/nxdeeIEFCxZQVlZGr169+O53vxtfIbItGl+zOaNGjWLGjBkcccQR9OnT\nhy+++IKJEyfu0z38z//8DwceeCATJkxgv/324/rrr8dxHPLz8+OrOnbv3p0PPviA6dOnM23aNI4+\n+mjKysrIzc3lf//3f9t8bw899BChUIhRo0bRo0cPzjvvPDZt2gTA/PnzOeyww+jSpQtnnnkmd955\nJ4MHD25yjeHDh/PII4/wH//xH/Tq1YvZs2cze/ZssrOz4+dccsklvP766/Ghl20pvy3OP/98AHr2\n7MlBBx3U7Dn78pntCKeddho/+clPOO644xg6dCiHH344ADk5OZ1etohIMjHGrDbGNJ3PIZ4zxtxj\njPltR58rqU2bj4u00f33388jjzzCm2++meiqSIIsXbqUAw44gGAwqM3jU482H5e0Y4xZDfQBokAY\nmAt831q717HixphBwCogy1q7101E68r6rrX29X2vseh9lM6injqRNlq8eDFlZWWJroZ4bNasWQSD\nQXbu3Mn111/P5MmTFehEJJlMttZ2AfoBW4C2D/VIAsaYJv+hNndsL9cwxpikatPua53ae+8irqT6\nByCSrM4++2zmzJnDjBkzEl0V8djf/vY3evfuzZAhQ/D7/fz1r39NdJVERJqw1tYCTwGj3GPGmNON\n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\nSUVORK5CYII=\n",
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"from ipywidgets import interact\n",
"%matplotlib inline\n",
"\n",
"def setup_figure():\n",
" # create figure and axes\n",
" fig = plt.figure(figsize=(12, 6))\n",
" ax1 = fig.add_axes([0., 0., 0.5, 1.], projection='3d')\n",
" ax2 = fig.add_axes([0.6, 0.1, 0.4, 0.8])\n",
" # set axes properties\n",
" ax2.spines['right'].set_visible(False)\n",
" ax2.spines['top'].set_visible(False)\n",
" ax2.yaxis.set_ticks_position('left')\n",
" ax2.xaxis.set_ticks_position('bottom')\n",
" ax2.set_yscale('log')\n",
" ax1.set_xlim((-2, 2))\n",
" ax1.set_ylim((-2, 2))\n",
" ax1.set_zlim((-2, 2))\n",
" #set axes labels and title\n",
" ax1.set_title('Parameter trajectories over training')\n",
" ax1.set_xlabel('Weight 1')\n",
" ax1.set_ylabel('Weight 2')\n",
" ax1.set_zlabel('Bias')\n",
" ax2.set_title('Batch errors over training')\n",
" ax2.set_xlabel('Batch update number')\n",
" ax2.set_ylabel('Batch error')\n",
" return fig, ax1, ax2\n",
"\n",
"def visualise_training(n_epochs=1, batch_size=200, log_lr=-1., n_inits=5,\n",
" w_scale=1., b_scale=1., elev=30., azim=0.):\n",
" fig, ax1, ax2 = setup_figure()\n",
" # create seeded random number generator\n",
" rng = np.random.RandomState(1234)\n",
" # create data provider\n",
" data_provider = CCPPDataProvider(\n",
" input_dims=[0, 1],\n",
" batch_size=batch_size, \n",
" shuffle_order=False,\n",
" )\n",
" learning_rate = 10 ** log_lr\n",
" n_batches = data_provider.num_batches\n",
" weights_traj = np.empty((n_inits, n_epochs * n_batches + 1, 1, 2))\n",
" biases_traj = np.empty((n_inits, n_epochs * n_batches + 1, 1))\n",
" errors_traj = np.empty((n_inits, n_epochs * n_batches))\n",
" # randomly initialise parameters\n",
" weights = rng.uniform(-w_scale, w_scale, (n_inits, 1, 2))\n",
" biases = rng.uniform(-b_scale, b_scale, (n_inits, 1))\n",
" # store initial parameters\n",
" weights_traj[:, 0] = weights\n",
" biases_traj[:, 0] = biases\n",
" # iterate across different initialisations\n",
" for i in range(n_inits):\n",
" # iterate across epochs\n",
" for e in range(n_epochs):\n",
" # iterate across batches\n",
" for b, (inputs, targets) in enumerate(data_provider):\n",
" outputs = fprop(inputs, weights[i], biases[i])\n",
" errors_traj[i, e * n_batches + b] = error(outputs, targets)\n",
" grad_wrt_outputs = error_grad(outputs, targets)\n",
" weights_grad, biases_grad = grads_wrt_params(inputs, grad_wrt_outputs)\n",
" weights[i] -= learning_rate * weights_grad\n",
" biases[i] -= learning_rate * biases_grad\n",
" weights_traj[i, e * n_batches + b + 1] = weights[i]\n",
" biases_traj[i, e * n_batches + b + 1] = biases[i]\n",
" # choose a different color for each trajectory\n",
" colors = plt.cm.jet(np.linspace(0, 1, n_inits))\n",
" # plot all trajectories\n",
" for i in range(n_inits):\n",
" lines_1 = ax1.plot(\n",
" weights_traj[i, :, 0, 0], \n",
" weights_traj[i, :, 0, 1], \n",
" biases_traj[i, :, 0], \n",
" '-', c=colors[i], lw=2)\n",
" lines_2 = ax2.plot(\n",
" np.arange(n_batches * n_epochs),\n",
" errors_traj[i],\n",
" c=colors[i]\n",
" )\n",
" ax1.view_init(elev, azim)\n",
" plt.show()\n",
"\n",
"w = interact(\n",
" visualise_training,\n",
" elev=(-90, 90, 2),\n",
" azim=(-180, 180, 2), \n",
" n_epochs=(1, 5), \n",
" batch_size=(100, 1000, 100),\n",
" log_lr=(-3., 1.),\n",
" w_scale=(0., 2.),\n",
" b_scale=(0., 2.),\n",
" n_inits=(1, 10)\n",
")\n",
"\n",
"for child in w.widget.children:\n",
" child.layout.width = '100%'"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": []
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": []
}
],
"metadata": {
"anaconda-cloud": {},
"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.2"
}
},
"nbformat": 4,
"nbformat_minor": 1
}