doc/source/examples/03xComposedPulses.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Combining Pulse Templates\n",
    "\n",
    "So far we have seen how to define simple pulses using the `TablePulseTemplate` ([Modelling a Simple TablePulseTemplate](00SimpleTablePulse.ipynb)), `FunctionPulseTemplate` ([Modelling Pulses Using Functions And Expressions](02FunctionPulse.ipynb)) and `PointPulseTemplate` ([The PointPulseTemplate](03PointPulse.ipynb)) classes. These are the elementary building blocks to create pulses and we call them *atomic* pulse templates.\n",
    "\n",
    "We will now have a look at how to compose more complex pulse structures.\n",
    "\n",
    "## SequencePulseTemplate: Putting Pulses in a Sequence\n",
    "\n",
    "As the name suggests `SequencePulseTemplate` allows us to define a pulse as a sequence of already existing pulse templates which are run one after another. In the following example we have two templates created using `PointPulseTemplate` and want to define a higher-level pulse template that puts them in sequence."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "sequence parameters: {'t_2', 'v_1', 'v_0', 't'}\n",
      "sequence measurements: {'M'}\n"
     ]
    }
   ],
   "source": [
    "from qupulse.pulses import PointPT, SequencePT\n",
    "# create our atomic \"low-level\" PointPTs\n",
    "first_point_pt = PointPT([(0,   'v_0'),\n",
    "                          (1,   'v_1', 'linear'),\n",
    "                          ('t', 'v_0+v_1', 'jump')],\n",
    "                         channel_names={'A'},\n",
    "                         measurements={('M', 1, 't-1')})\n",
    "second_point_pt = PointPT([(0, 'v_0+v_1'),\n",
    "                           ('t_2', 'v_0', 'linear')],\n",
    "                          channel_names={'A'},\n",
    "                          measurements={('M', 0, 1)})\n",
    "\n",
    "# define the SequencePT\n",
    "sequence_pt = SequencePT(first_point_pt, second_point_pt)\n",
    "\n",
    "print(\"sequence parameters: {}\".format(sequence_pt.parameter_names))\n",
    "print(\"sequence measurements: {}\".format(sequence_pt.measurement_names))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "It is important to note that all of the pulse templates used to create a `SequencePT` (we call those *subtemplates*) are defined on the same channels, in this case the channel `A` (otherwise we would encounter an exception). The `SequencePT` will also be defined on the same channel.\n",
    "\n",
    "The `SequencePT` will further have the union of all parameters defined in its subtemplates as its own parameter set. If two subtemplates defined parameters with the same name, they will be treated as the same parameters in the `SequencePT`.\n",
    "\n",
    "Finally, `SequencePT` will also expose all measurements defined in subtemplates. It is also possible to define additional measurements in the constructor of `SequencePT`. See [Definition of Measurements](08Measurements.ipynb) for me info about measurements.\n",
    "\n",
    "There are several cases where the above constraints represent a problem: Subtemplates might not all be defined on the same channel, subtemplates might define parameters with the same name which should still be treated as different parameters in the sequence or names of measurements defined by different subtemplates might collide. To deal with these, we can wrap a subtemplate with the `MappingPulseTemplate` class which allows us to rename parameters, channels and measurements or even derive parameter values from other parameters using mathematical expressions. You can learn how to do all this in [Mapping with the MappingPulseTemplate](05MappingTemplate.ipynb).\n",
    "\n",
    "In our example above, however, we were taking care not to encounter these problems yet. Let's plot all of them with some parameters to see the results."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "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 = $('<div/>');\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",
       "        fig.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",
       "        '<div class=\"ui-dialog-titlebar ui-widget-header ui-corner-all ' +\n",
       "        'ui-helper-clearfix\"/>');\n",
       "    var titletext = $(\n",
       "        '<div class=\"ui-dialog-title\" style=\"width: 100%; ' +\n",
       "        'text-align: center; padding: 3px;\"/>');\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 = $('<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 = $('<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 = $('<canvas/>');\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 = $('<div/>')\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 = $('<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 = $('<span/>');\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 = $('<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 = $('<span/>');\n",
       "\n",
       "    var fmt_picker = $('<select/>');\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",
       "            '<option/>', {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 = $('<span class=\"mpl-message\"/>');\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 overridden (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(\"<div id='\" + id + \"'></div>\");\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('<img src=\"' + dataURL + '\" width=\"' + width + '\">');\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'] = '<img src=\"' + dataURL + '\" width=\"' + width + '\">';\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 = $('<div/>')\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 = $('<button class=\"btn btn-default\" href=\"#\" title=\"' + name + '\"><i class=\"fa ' + image + ' fa-lg\"></i></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 = $('<span class=\"mpl-message\" style=\"text-align:right; float: right;\"/>');\n",
       "    nav_element.append(status_bar);\n",
       "    this.message = status_bar[0];\n",
       "\n",
       "    // Add the close button to the window.\n",
       "    var buttongrp = $('<div class=\"btn-group inline pull-right\"></div>');\n",
       "    var button = $('<button class=\"btn btn-mini btn-primary\" href=\"#\" title=\"Stop Interaction\"><i class=\"fa fa-power-off icon-remove icon-large\"></i></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",
       "        event.shiftKey = false;\n",
       "        // Send a \"J\" for go to next cell\n",
       "        event.which = 74;\n",
       "        event.keyCode = 74;\n",
       "        manager.command_mode();\n",
       "        manager.handle_keydown(event);\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<ncells; i++) {\n",
       "        var cell = cells[i];\n",
       "        if (cell.cell_type === 'code'){\n",
       "            for (var j=0; j<cell.output_area.outputs.length; j++) {\n",
       "                var data = cell.output_area.outputs[j];\n",
       "                if (data.data) {\n",
       "                    // IPython >= 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": [
       "<IPython.core.display.Javascript object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "text/html": [
       "<img src=\"data:image/png;base64,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qtv16EqG3qNFdy3QLan0d5K2KN7f6fQ7Cve3PqerY5YaPjXxuvesava1116T0047LZK1Vg377XcUau33d4EejwH0SU3/2i+5EfRDDz1UuBG0bripSypvv/22eft33bp1cskll5iXP3TA0RvxzDPPNG8B6wAb1qazf/fdd595pkvfDtS3ehMPumu/dCAs+hfkCy+8YEzf6tWrCzeCdmVQLFoDP/3Wt551U92vvvrK7Omo5kmfJy367GRY61s0r1QbHOvbglpjfeFDda3HJZrOXmv/ExtB66ygaxtB++233g/6x5CaYTVLagTVHKd6oD6MtdcZ3mRtypQpps7aonh/p9PvKNzf+hz2m2++aX6P6++oo48+WvReVfMX1Vprv/z2Owq1Tuf3DQYwHWrEQAACEIAABCAAAYcJYAAdLh6pQwACEIAABCAAgXQIYADToUYMBCAAAQhAAAIQcJgABtDh4pE6BCAAAQhAAAIQSIcABjAdasRAAAIQgAAEIAABhwlgAB0uHqlDAAIQgAAEIACBdAhgANOhRgwEIAABCEAAAhBwmAAG0OHikToEIAABCEAAAhBIhwAGMB1qxEAAAhCAAAQgAAGHCWAAHS4eqUMg7gQSX955//335Zhjjsk6jk8//VQ6deokn3/+udSoUcP6+vpVoTfeeENeeukl63NxAghAAAKlEcAAog8IQCCUBFJ9viuRrH6q7m9/+5ts3rzZfGf7gAMOyHo/zjvvPPntb38rt99+e0auvWvXLvOZxWnTpkmHDh0yck5OAgEIQCAZAQwguoAABEJJQL+xnGjPPfecjBgxQnTGLdH0e7z6fdOg2vr166VZs2bm+9eNGjXKWBo33nij6Lm1zzQIQAAC5UUAA1heZDkvBCCQMQL5+fly/fXXyw8//FDsnCWXgOfMmSNdunSR1157Tf70pz/JihUr5KSTTpJnn31WlixZIkOGDJENGzbImWeeaWYPDzzwQHO+goICGTdunEyePFk2bdokLVu2NLN6OsOXqo0fP16eeeYZee+99woPSeSp5k3zXbdunZnJmzJlitSvX98cpznecsst8sknn0ilSpWkdevW8vTTT8uhhx5qfj537lz5/e9/b/qqJpcGAQhAoDwIYADLgyrnhAAEMkrArwE88cQT5f777zcGr3fv3tKwYUP51a9+JWPGjJHt27fLOeecIzfffLPceuutJs/bbrtNpk+fLg888IC0aNFC5s2bJ4MGDZLXX3/dPOOXrPXs2dOYukceeaSYAbziiitMzL333isVKlSQSy65RNq0aSNPPfWU7NmzxyxXX3755eb8u3fvlnfffdeY1saNG5vz/PTTT+Z5wrfffjvltTMKl5NBAAKxJIABjGXZ6TQE3CLg1wD++9//lt/97nemk2r6hg4dKqtWrTJLttrUfOnsoc4UquFSU/bWW2+Z2cJEGzhwoOzYscPMziVr+tJJr169ij3/p3n2799fVq5cKc2bNzdhDz/8sNxxxx2iS9rff/+9HHTQQWYWMJWx1Jg6derIhAkTRJ9zpEEAAhAoDwIYwPKgyjkhAIGMEvBrAL/55hupW7euyUGXX6+99lpj9BJt5MiR8vLLL8t///tfs4R7/PHHS7Vq1YrlrLNzOnP3zjvvJO3L4YcfLmoSdSYx0TTPa665pti1ZsyYYYzivn37zGFqEHXp+LTTTpOuXbuaGcrE8nDiPDpjOXz4cLnqqqsyypGTQQACEEgQwACiBQhAIPQE/BrALVu2SK1atUy/ksWOGjVKZs6cKUuXLjUGT5eMdVZOjVfRpsvGeXl5SfmcfPLJZhbvnnvuKWYASz6rqNfRJWd9zjDRdNsanX1UE/rRRx/Jv/71L5NDoumzf08++WSpzyCGvmgkCAEIhJoABjDU5SE5CEAglYnT/57qJRA/BnDbtm1mtvDxxx+XSy+91DNwnVXUt3XV4CVaMrOZzAAWvYguO7dr104mTpxo/rMuVR922GHFlpE9J8WBEIAABDwSwAB6BMVhEIBAcATKcwZQe6XLrfoG8J///Gfz1u6PP/4oixYtkurVq6d8Dk9n73QJeOPGjVKxYkUDpywDuGbNGnnssceke/fu0qBBA7OtzYUXXih33XVX4XKvnuPOO+80RpAGAQhAoLwIYADLiyznhQAEMkagvA2gLs9OmjTJvLCh+/rp8nHbtm1l2LBh0rFjx6T92Lt3r9m6RbeTOf300z0ZwK+//tq8gKLLzt9995159k9f9NBnEvWNYW16Ln0rWLexoUEAAhAoLwIYwPIiy3khAIHIE1DDOGvWLLNdTCbaxx9/bN5e/uyzzwLd5DoTfeEcEIBAuAlgAMNdH7KDAARCTED39Rs7dqxcd911GfkWsH4HWGcjEzOKIe46qUEAAo4TwAA6XkDShwAEIAABCEAAAn4JYAD9EuN4CEAAAhCAAAQg4DgBDKDjBSR9CEAAAhCAAAQg4JcABtAvMY6HAAQgAAEIQAACjhPAADpeQNKHAAQgAAEIQAACfglgAP0S43gIQAACEIAABCDgOAEMoOMFJH0IQAACEIAABCDglwAG0C8xjocABCAAAQhAAAKOE8AAOl5A0ocABCAAAQhAAAJ+CWAA/RLjeAhAAAIQgAAEIOA4gf8L3th6mmEvQcsAAAAASUVORK5CYII=\" width=\"640\">"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "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 = $('<div/>');\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",
       "        fig.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",
       "        '<div class=\"ui-dialog-titlebar ui-widget-header ui-corner-all ' +\n",
       "        'ui-helper-clearfix\"/>');\n",
       "    var titletext = $(\n",
       "        '<div class=\"ui-dialog-title\" style=\"width: 100%; ' +\n",
       "        'text-align: center; padding: 3px;\"/>');\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 = $('<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 = $('<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 = $('<canvas/>');\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 = $('<div/>')\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 = $('<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 = $('<span/>');\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 = $('<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 = $('<span/>');\n",
       "\n",
       "    var fmt_picker = $('<select/>');\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",
       "            '<option/>', {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 = $('<span class=\"mpl-message\"/>');\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 overridden (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(\"<div id='\" + id + \"'></div>\");\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('<img src=\"' + dataURL + '\" width=\"' + width + '\">');\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'] = '<img src=\"' + dataURL + '\" width=\"' + width + '\">';\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 = $('<div/>')\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 = $('<button class=\"btn btn-default\" href=\"#\" title=\"' + name + '\"><i class=\"fa ' + image + ' fa-lg\"></i></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 = $('<span class=\"mpl-message\" style=\"text-align:right; float: right;\"/>');\n",
       "    nav_element.append(status_bar);\n",
       "    this.message = status_bar[0];\n",
       "\n",
       "    // Add the close button to the window.\n",
       "    var buttongrp = $('<div class=\"btn-group inline pull-right\"></div>');\n",
       "    var button = $('<button class=\"btn btn-mini btn-primary\" href=\"#\" title=\"Stop Interaction\"><i class=\"fa fa-power-off icon-remove icon-large\"></i></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",
       "        event.shiftKey = false;\n",
       "        // Send a \"J\" for go to next cell\n",
       "        event.which = 74;\n",
       "        event.keyCode = 74;\n",
       "        manager.command_mode();\n",
       "        manager.handle_keydown(event);\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<ncells; i++) {\n",
       "        var cell = cells[i];\n",
       "        if (cell.cell_type === 'code'){\n",
       "            for (var j=0; j<cell.output_area.outputs.length; j++) {\n",
       "                var data = cell.output_area.outputs[j];\n",
       "                if (data.data) {\n",
       "                    // IPython >= 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": [
       "<IPython.core.display.Javascript object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "text/html": [
       "<img src=\"data:image/png;base64,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SUFBgfkcT3hbuXKlMYf33XefMX2anMeOHSvLli2Ts88+O8pR88/h0XLUH7X/9//+n3z66aclIJx00kn+gRLjnSxcuFCWL18ubdu2lb59+5ZrADdt2iSnnXaaXH/99fKb3/zGxN50003ywgsvmPigtmg5hgygajIrK6sYW926daVChQpBxSjdu3eXK664Qtq3by+HDx+WUaNGyccff2x+IzMzMyNy4XcyslxiYRnE30oMYBQ/N/ov1FatWsk//vGPYhOi/7tjx47mX22l/UtNDeCZZ55pZryC2tS0aaJ97LHHihGceuqpZsZF/7UW3nSGVIueanIJNX2o9dvLmnCD2qLlqD9qt912m+h3q2mlE0hLSyvXAN5zzz1m5l9/B0JNZ/8++ugj0URME3HCMWQAg/wNVida2bFjh9SrV8+sHnXu3DliCL+TTkiKOGEZxN9KDKAz/Zijnn76abP8E55M9UPSU6ZMibjUpnFqAHXJ6OjRo/KTn/xEdBZx3LhxUq1atSiunrqHHjp0SKpWrSqzZ88usYSrM1OrV68+bnlc71RnBW+//XbzJ9SUsZroL774InVhWPQ8Fo76ozZkyBBp2LChHDlyxPxDRGdV27RpY9ET/4U6MS6ahJXbI488UgxAZ6b79esn+/fvl0qVKvkPTJR35IRjyADqyskPP/xg/lE9evToiMvCUV7eV4evX79eWrRoYWYBdeY5UuN30tmQO2EZxN9KDKAz/Zijfv/734uK5LPPPisRpcu7+p6VfhEkUnvyySclJydHdNntk08+McedfPLJ8te//jWKq6fuodu3bzcGRJfM9L2WUFOef/7zn49bntS/z8jIMKyvuuqq4uOff/55w1mr4QexxcJRZ6j1x+/00083M6pqXt58800za6XJhfZfAk6Miz7nAwcOlJEjRxZjW7FihXmlQcemfv36gcfphKMu/ep7gz//+c/Ns/zMM8/IjBkzRI1haTNdQQOrkwW9e/cWnSVdunRpqbfP72T5ynDKMoi/lRhAERk/frzk5eWVqaQPPvhA3n777YiGRRPp4MGD5be//W35ahQxL523a9fO/F9dFvV7CxkXTZa6XB5quqlDf/x1+Ty86Q+bmsMrr7yy+K+ee+45w1lnDYLYYuEYzqmoqMhoThPt1KlTg4gx4j07MS6R/qGn/6jJzc01m0h4r9KZkY40ABdffLEx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\" width=\"640\">"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "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 = $('<div/>');\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",
       "        fig.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",
       "        '<div class=\"ui-dialog-titlebar ui-widget-header ui-corner-all ' +\n",
       "        'ui-helper-clearfix\"/>');\n",
       "    var titletext = $(\n",
       "        '<div class=\"ui-dialog-title\" style=\"width: 100%; ' +\n",
       "        'text-align: center; padding: 3px;\"/>');\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 = $('<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 = $('<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 = $('<canvas/>');\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 = $('<div/>')\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 = $('<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 = $('<span/>');\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 = $('<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 = $('<span/>');\n",
       "\n",
       "    var fmt_picker = $('<select/>');\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",
       "            '<option/>', {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 = $('<span class=\"mpl-message\"/>');\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 overridden (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(\"<div id='\" + id + \"'></div>\");\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('<img src=\"' + dataURL + '\" width=\"' + width + '\">');\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'] = '<img src=\"' + dataURL + '\" width=\"' + width + '\">';\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 = $('<div/>')\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 = $('<button class=\"btn btn-default\" href=\"#\" title=\"' + name + '\"><i class=\"fa ' + image + ' fa-lg\"></i></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 = $('<span class=\"mpl-message\" style=\"text-align:right; float: right;\"/>');\n",
       "    nav_element.append(status_bar);\n",
       "    this.message = status_bar[0];\n",
       "\n",
       "    // Add the close button to the window.\n",
       "    var buttongrp = $('<div class=\"btn-group inline pull-right\"></div>');\n",
       "    var button = $('<button class=\"btn btn-mini btn-primary\" href=\"#\" title=\"Stop Interaction\"><i class=\"fa fa-power-off icon-remove icon-large\"></i></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",
       "        event.shiftKey = false;\n",
       "        // Send a \"J\" for go to next cell\n",
       "        event.which = 74;\n",
       "        event.keyCode = 74;\n",
       "        manager.command_mode();\n",
       "        manager.handle_keydown(event);\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<ncells; i++) {\n",
       "        var cell = cells[i];\n",
       "        if (cell.cell_type === 'code'){\n",
       "            for (var j=0; j<cell.output_area.outputs.length; j++) {\n",
       "                var data = cell.output_area.outputs[j];\n",
       "                if (data.data) {\n",
       "                    // IPython >= 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": [
       "<IPython.core.display.Javascript object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "text/html": [
       "<img src=\"data:image/png;base64,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YhaPTJ8+Xfr06VOpPJ544gm555575OOPP5Z69epJr1695N5775VGjRp5khUC8oQpEidhACNRRm4i4gSYCo54gX28PfrvkBrAW2+9VTZs2CCPP/6453LPnj1bFi5cKB07dpS+fftWaQAXLFgg3bp1k4kTJ8o555wj69evl6uuukratGljYr0cCMgLpWicgwGMRh25i+gTYHPo6NfYjzuk/w6pAbQtrn5erqoRQB3pe+SRR+STTz4pudyDDz5oRgR19NHLgYC8UIrGORjAaNSRu4g+ATaHjn6N/bhD+u8YG8BFixZJ9+7djVE888wz5YsvvhDdluaoo46SSZMmlauvXbt2if4pPlRAeXl5snXrVsnNzfVDk7QRUgIYwJAWhrQgUA4BNodGFlURwACGwADqVO9f//pX+fTTT83n30ofOhqXyuFlBFDbfe6552TQoEHy3XffyZ49e+Tcc881/+2ggw4q97KjRo2SgoKCA/4OA5hKldyKwQC6VS+yjTcBNoeOd/293D0GMGAD+Oabb5r371q0aGGmYnX0bc2aNaIG7phjjhFd2JHK4cUAFhUVSY8ePeTGG2+Unj17moUjN998s3Tq1En++Mc/MgKYCvgIx2AAI1xcbi1yBFgRHLmS+n5DGMCADaB+71dN2F133SV169aVf/3rX3LIIYfIJZdcYozhlVdemVLRvRhA3YRaR/6mTp1acg1dGHLKKaeYBShNmzat8toIqEpEkTkBAxiZUnIjMSHAiuCYFDrF26T/DtgAqul799135YgjjpAGDRqIGrD27dvL0qVL5bzzzpNVq1alVFovBlBXClevXl2eeeaZkmssXrxYOnfubFYEN2vWrMprI6AqEUXmBAxgZErJjcSIAJtDx6jYSd4q/XfABvDQQw8VnQbWqd927drJ2LFjzXt4//73v40R2759u+eS6rkrVqww53fo0EEmTJhgFnk0bNhQWrZsKcOGDTPGbsqUKeacwsJCueKKK+SBBx4omQK+4YYbRD9H99Zbb3m6LgLyhCkSJ2EAI1FGbiJmBJgKjlnBk7hd+u+ADWDv3r3NVO/ll18uN910k7z44oty2WWXyfPPPy916tSRN954w3M558yZYwxf4jFgwABj9gYOHCirV68WPa/40G1fdMWvjjTWr1/ffIN43Lhx0rx5c0/XRUCeMEXiJAxgJMrITcSQAFPBMSy6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\" width=\"640\">"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "%matplotlib notebook\n",
    "from qupulse.pulses.plotting import plot\n",
    "\n",
    "parameters = dict(t=3,\n",
    "                  t_2=2,\n",
    "                  v_0=1,\n",
    "                  v_1=1.4)\n",
    "\n",
    "_ = plot(first_point_pt, parameters, sample_rate=100)\n",
    "_ = plot(second_point_pt, parameters, sample_rate=100)\n",
    "_ = plot(sequence_pt, parameters, sample_rate=100)\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## RepetitionPulseTemplate: Repeating a Pulse\n",
    "\n",
    "If we simply want to repeat some pulse template a fixed number of times, we can make use of the `RepetitionPulseTemplate`. In the following, we will reuse one of our `PointPT`s, `first_point_pt` and use it to create a new pulse template that repeats it `n_rep` times, where `n_rep` will be a parameter."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "repetition parameters: {'v_1', 'n_rep', 'v_0', 't'}\n",
      "repetition measurements: {'M'}\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 = $('<div/>');\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",
       "        fig.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",
       "        '<div class=\"ui-dialog-titlebar ui-widget-header ui-corner-all ' +\n",
       "        'ui-helper-clearfix\"/>');\n",
       "    var titletext = $(\n",
       "        '<div class=\"ui-dialog-title\" style=\"width: 100%; ' +\n",
       "        'text-align: center; padding: 3px;\"/>');\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 = $('<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 = $('<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 = $('<canvas/>');\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 = $('<div/>')\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 = $('<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 = $('<span/>');\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 = $('<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 = $('<span/>');\n",
       "\n",
       "    var fmt_picker = $('<select/>');\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",
       "            '<option/>', {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 = $('<span class=\"mpl-message\"/>');\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 overridden (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(\"<div id='\" + id + \"'></div>\");\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('<img src=\"' + dataURL + '\" width=\"' + width + '\">');\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'] = '<img src=\"' + dataURL + '\" width=\"' + width + '\">';\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 = $('<div/>')\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 = $('<button class=\"btn btn-default\" href=\"#\" title=\"' + name + '\"><i class=\"fa ' + image + ' fa-lg\"></i></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 = $('<span class=\"mpl-message\" style=\"text-align:right; float: right;\"/>');\n",
       "    nav_element.append(status_bar);\n",
       "    this.message = status_bar[0];\n",
       "\n",
       "    // Add the close button to the window.\n",
       "    var buttongrp = $('<div class=\"btn-group inline pull-right\"></div>');\n",
       "    var button = $('<button class=\"btn btn-mini btn-primary\" href=\"#\" title=\"Stop Interaction\"><i class=\"fa fa-power-off icon-remove icon-large\"></i></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",
       "        event.shiftKey = false;\n",
       "        // Send a \"J\" for go to next cell\n",
       "        event.which = 74;\n",
       "        event.keyCode = 74;\n",
       "        manager.command_mode();\n",
       "        manager.handle_keydown(event);\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<ncells; i++) {\n",
       "        var cell = cells[i];\n",
       "        if (cell.cell_type === 'code'){\n",
       "            for (var j=0; j<cell.output_area.outputs.length; j++) {\n",
       "                var data = cell.output_area.outputs[j];\n",
       "                if (data.data) {\n",
       "                    // IPython >= 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": [
       "<IPython.core.display.Javascript object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "text/html": [
       "<img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAoAAAAHgCAYAAAA10dzkAAAgAElEQVR4Xu2dB7QW1fX2N6AoIlXBAhcpAkGxgGJBpRhULBGUBFuk2Gv+dqWooCggBGusUQh2UYpGUWOUIqBGIjZEBcTQVKJwAwpIud86J99LLtd7eWdmn5lnzjvPrMVK4ez9zPOb/Z6zmVqppKSkRLiRAAmQAAmQAAmQAAlkhkAlNoCZOdY0SgIkQAIkQAIkQAKWABtAFgIJkAAJkAAJkAAJZIwAG8CMHXDaJQESIAESIAESIAE2gKwBEiABEiABEiABEsgYATaAGTvgtEsCJEACJEACJEACbABZAyRAAiRAAiRAAiSQMQJsADN2wGmXBEiABEiABEiABNgAsgZIgARIgARIgARIIGME2ABm7IDTLgmQAAmQAAmQAAmwAWQNkAAJkAAJkAAJkEDGCLABzNgBp10SIAESIAESIAESYAPIGiABEiABEiABEiCBjBFgA5ixA067JEACJEACJEACJMAGkDVAAiRAAiRAAiRAAhkjwAYwYwecdkmABEiABEiABEiADSBrgARIgARIgARIgAQyRoANYMYOOO2SAAmQAAmQAAmQABtA1gAJkAAJkAAJkAAJZIwAG8CMHXDaJQESIAESIAESIAE2gKwBEiABEiABEiABEsgYATaAGTvgtEsCJEACJEACJEACbABZAyRAAiRAAiRAAiSQMQJsADN2wGmXBEiABEiABEiABNgAsgZIgARIgARIgARIIGME2ABm7IDTLgmQAAmQAAmQAAmwAWQNkAAJkAAJkAAJkEDGCLABzNgBp10SIAESIAESIAESYAPIGiABEiABEiABEiCBjBFgA5ixA067JEACJEACJEACJMAGkDVAAiRAAiRAAiRAAhkjwAYwYwecdkmABEiABEiABEiADSBrgARIgARIgARIgAQyRoANYMYOOO2SAAmQAAmQAAmQABtA1gAJkAAJkAAJkAAJZIwAG8CMHXDaJQESIAESIAESIAE2gKwBEiABEiABEiABEsgYATaAGTvgtEsCJEACJEACJEACbABZAyRAAiRAAiRAAiSQMQJsADN2wGmXBEiABEiABEiABNgAsgZIgARIgARIgARIIGME2ABm7IDTLgmQAAmQAAmQAAmwAWQNkAAJkAAJkAAJkEDGCLABzNgBp10SIAESIAESIAES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1bmYgARIgAS2RYANIOuDBEgglQQq+nxgbmfNZ8ceffRRWbFihey6666y3XbbJe7jt7/9rRxwwAH2828utvXr14v5juq4cePkyCOPdJGSOUiABEigXAJsAFkYJEACqSTwzTffbNmvZ5991n5P15xxy23VqlWTWrVqwfZ9yZIl0rRpU1m4cKE0bNjQ2X5cffXVYnIbz9xIgARIIC4CbADjIsu8JEACzgiMGTNGrrjiClm1atVWOcteAs59tP7VV1+VG264QebNmyeHH364PPPMMzJ79my56qqrZOnSpXLiiSfas4c77bSTzVdSUiIjRoyQBx98UJYvXy4tWrSwZ/XMGb6KtlGjRsnTTz8t//jHP7YMye2nad7M/i5evNieyRs9erTssccedpzZx+uuu04+/fRT2X777WXfffeVp556Svbaay/791OnTpVjjz3WejVNLjcSIAESiIMAG8A4qDInCZCAUwJhG8DDDjtMRo4caRu8nj17SoMGDWSHHXaQYcOGyZo1a+SUU06Ra6+9Vq6//nq7nwMGDJDx48fLXXfdJc2bN5dp06bJRRddJK+99pq9x6+8rXv37rape+CBB7ZqAC+44AIbM3ToUKlcubL8/ve/lzZt2siTTz4pGzdutJerzz//fJv/559/lvfee086d+4sjRo1snl+/PFHez/hW2+9VaG2U7hMRgIkkEkCbAAzedhpmgT8IhC2AXzjjTfk17/+tTVpmr5+/frJggUL7CVbs5nmy5w9NGcKTcNlmrI333zTni3Mbeedd5789NNP9uxceZt56KRHjx5b3f9n9rNv374yf/58adasmQ27//775ZZbbhFzSfuHH36QXXbZxZ4FrKixNDF169aVO++8U8x9jtxIgARIIA4CbADjoMqcJEACTgmEbQC/++47qVevnt0Hc/n1sssus41ebrv55pvlpZdekn/+85/2Eu4hhxwi1atX32qfzdk5c+bu3XffLddLy5YtxTSJ5kxibjP7eemll26lNWHCBNsobt682Q4zDaK5dHzMMcdIly5d7BnK3OXhXB5zxnLgwIFy8cUXO+XIZCRAAiSQI8AGkLVAAiSQegJhG8CVK1dK7dq1ra/yYgcNGiQTJ06UOXPm2AbPXDI2Z+VM41V6M5eNi4qKyuVzxBFH2LN4t99++1YNYNl7FY2OueRs7jPMbea1Nebso2lCP/74Y/nb3/5m9yG3mXv/Hn/88W3eg5j6g8YdJAESSDUBNoCpPjzcORIggYqaOPP/V/QQSJgGcPXq1fZs4SOPPCJnn312YODmrKJ5Wtc0eLmtvGazvAawtIi57NyuXTu555577P9tLlXvvffeW11GDrxTHEgCJEACAQmwAQwIisNIgARwBOI8A2hcmcut5gngP/7xj/ap3f/85z8yc+ZM2XnnnSu8D8+cvTOXgJctWyZVqlSxcPI1gF999ZU8/PDDcvLJJ8uee+5pX2tzxhlnyJAhQ7Zc7jU5br31VtsIciMBEiCBuAiwAYyLLPOSAAk4IxB3A2guz9577732gQ3zXj9z+bht27bSv39/6dChQ7k+Nm3aZF/dYl4nc9xxxwVqAL/99lv7AIq57Pz999/be//Mgx7mnkTzxLDZTC7zVLB5jQ03EiABEoiLABvAuMgyLwmQQMETMA3jpEmT7OtiXGyffPKJfXr5iy++gL7k2oUX5iABEkg3ATaA6T4+3DsSIIEUEzDv9Rs+fLj84Q9/cPItYPMdYHM2MndGMcXWuWskQAKeE2AD6PkB5O6TAAmQAAmQAAmQQFgCbADDEuN4EiABEiABEiABEvCcABtAzw8gd58ESIAESIAESIAEwhJgAxiWGMeTAAmQAAmQAAmQgOcE2AB6fgC5+yRAAiRAAiRAAiQQlgAbwLDEOJ4ESIAESIAESIAEPCfABtDzA8jdJwESIAESIAESIIGwBNgAhiXG8SRAAiRAAiRAAiTgOQE2gJ4fQO4+CZAACZAACZAACYQlwAYwLDGOJwESIAESIAESIAHPCfw/vzpLprN84MwAAAAASUVORK5CYII=\" width=\"640\">"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "from qupulse.pulses import RepetitionPT\n",
    "\n",
    "repetition_pt = RepetitionPT(first_point_pt, 'n_rep')\n",
    "\n",
    "print(\"repetition parameters: {}\".format(repetition_pt.parameter_names))\n",
    "print(\"repetition measurements: {}\".format(repetition_pt.measurement_names))\n",
    "\n",
    "# let's plot to see the results\n",
    "parameters['n_rep'] = 5 # add a value for our n_rep parameter\n",
    "_ = plot(repetition_pt, parameters, sample_rate=100)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The same remarks that were made about `SequencePT` also hold for `RepetitionPT`: it will expose all parameters and measurements defined by its subtemplate and will be defined on the same channels.\n",
    "\n",
    "## ForLoopPulseTemplate: Repeat a Pulse with a Varying Loop Parameter\n",
    "\n",
    "The `RepetitionPT` simple repeats the exact same subtemplate a given number of times. Sometimes, however, it is rather required to vary the parameters of a subtemplate in a loop, for example when trying to determine the best value for a parameter of a given pulse. This is what the `ForLoopPulseTemplate` is intended for. As the name suggests, its behavior mimics that for `for-loop` constructs in programming languages by repeating its content - the subtemplate - for a number of times while at the same time supplying a loop parameter that iterates over a range of values.\n",
    "\n",
    "In the following we make use of this to vary the value of parameter `t` in `first_point_pt` over several iterations. More specifically, we will have all a `first_point_pt` pulse for all even values of `t` between `t_start` and `t_end` which are new parameters. For the plot we will set them to `t_start = 4` and `t_end = 13`, i.e., `t = 4, 6, 8, 10, 12`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "for loop parameters: {'t_start', 'v_1', 'v_0', 't_end'}\n",
      "for loop measurements: {'M'}\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 = $('<div/>');\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",
       "        fig.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",
       "        '<div class=\"ui-dialog-titlebar ui-widget-header ui-corner-all ' +\n",
       "        'ui-helper-clearfix\"/>');\n",
       "    var titletext = $(\n",
       "        '<div class=\"ui-dialog-title\" style=\"width: 100%; ' +\n",
       "        'text-align: center; padding: 3px;\"/>');\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 = $('<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 = $('<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 = $('<canvas/>');\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 = $('<div/>')\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 = $('<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 = $('<span/>');\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 = $('<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 = $('<span/>');\n",
       "\n",
       "    var fmt_picker = $('<select/>');\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",
       "            '<option/>', {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 = $('<span class=\"mpl-message\"/>');\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 overridden (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(\"<div id='\" + id + \"'></div>\");\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('<img src=\"' + dataURL + '\" width=\"' + width + '\">');\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'] = '<img src=\"' + dataURL + '\" width=\"' + width + '\">';\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 = $('<div/>')\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 = $('<button class=\"btn btn-default\" href=\"#\" title=\"' + name + '\"><i class=\"fa ' + image + ' fa-lg\"></i></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 = $('<span class=\"mpl-message\" style=\"text-align:right; float: right;\"/>');\n",
       "    nav_element.append(status_bar);\n",
       "    this.message = status_bar[0];\n",
       "\n",
       "    // Add the close button to the window.\n",
       "    var buttongrp = $('<div class=\"btn-group inline pull-right\"></div>');\n",
       "    var button = $('<button class=\"btn btn-mini btn-primary\" href=\"#\" title=\"Stop Interaction\"><i class=\"fa fa-power-off icon-remove icon-large\"></i></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",
       "        event.shiftKey = false;\n",
       "        // Send a \"J\" for go to next cell\n",
       "        event.which = 74;\n",
       "        event.keyCode = 74;\n",
       "        manager.command_mode();\n",
       "        manager.handle_keydown(event);\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<ncells; i++) {\n",
       "        var cell = cells[i];\n",
       "        if (cell.cell_type === 'code'){\n",
       "            for (var j=0; j<cell.output_area.outputs.length; j++) {\n",
       "                var data = cell.output_area.outputs[j];\n",
       "                if (data.data) {\n",
       "                    // IPython >= 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": [
       "<IPython.core.display.Javascript object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "text/html": [
       "<img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAoAAAAHgCAYAAAA10dzkAAAgAElEQVR4XuydB5QVRdqGXzIjOSMwRAdJIjlKlDCgAsIvYCKJrolVFFGCOARFhAVBTGtCDIgSdQUByUlQlCQgGUkCSpAc5z/V7GVnLjNz+96q7uq6/fY5nA10VX31fN9Qz3SoTpeYmJgIHiRAAiRAAiRAAiRAAr4hkI4C6Jtcc6IkQAIkQAIkQAIkYBGgALIQSIAESIAESIAESMBnBCiAPks4p0sCJEACJEACJEACFEDWAAmQAAmQAAmQAAn4jAAF0GcJ53RJgARIgARIgARIgALIGiABEiABEiABEiABnxGgAPos4ZwuCZAACZAACZAACVAAWQMkQAIkQAIkQAIk4DMCFECfJZzTJQESIAESIAESIAEKIGuABEiABEiABEiABHxGgALos4RzuiRAAiRAAiRAAiRAAWQNkAAJkAAJkAAJkIDPCFAAfZZwTpcESIAESIAESIAEKICsARIgARIgARIgARLwGQEKoM8SzumSAAmQAAmQAAmQAAWQNUACJEACJEACJEACPiNAAfRZwjldEiABEiABEiABEqAAsgZIgARIgARIgARIwGcEKIA+SzinSwIkQAIkQAIkQAIUQNYACZAACZAACZAACfiMAAXQZwnndEmABEiABEiABEiAAsgaIAESIAESIAESIAGfEaAA+izhnC4JkAAJkAAJkAAJUABZAyRAAiRAAiRAAiTgMwIUQJ8lnNMlARIgARIgARIgAQoga4AESIAESIAESIAEfEaAAuizhHO6JEACJEACJEACJEABZA2QAAmQAAmQAAmQgM8IUAB9lnBOlwRIgARIgARIgAQogKwBEiABEiABEiABEvAZAQqgzxLO6ZIACZAACZAACZAABZA1QAIkQAIkQAIkQAI+I0AB9FnCOV0SIAESIAESIAESoACyBkiABEiABEiABEjAZwQogD5LOKdLAiRAAiRAAiRAAhRA1gAJkAAJkAAJkAAJ+IwABdBnCed0SYAESIAESIAESIACyBogARIgARIgARIgAZ8RoAD6LOGcLgmQAAmQAAmQAAlQAFkDJEACJEACJEACJOAzAhRAnyWc0yUBEiABEiABEiABCiBrgARIgARIgARIgAR8RoAC6LOEc7okQAIkQAIkQAIkQAFkDZAACZAACZAACZCAzwhQ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\" width=\"640\">"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "from qupulse.pulses import ForLoopPT\n",
    "\n",
    "for_loop_pt = ForLoopPT(first_point_pt, 't', ('t_start', 't_end', 2))\n",
    "\n",
    "print(\"for loop parameters: {}\".format(for_loop_pt.parameter_names))\n",
    "print(\"for loop measurements: {}\".format(for_loop_pt.measurement_names))\n",
    "\n",
    "# plot it\n",
    "parameters['t_start'] = 4\n",
    "parameters['t_end'] = 13\n",
    "_ = plot(for_loop_pt, parameters, sample_rate=100)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The second argument to `ForLoopPT`'s constructor is the name of the loop parameter. This has to be a parameter that is defined by the subtemplate. The third argument defined the range of the loop. The syntax of the range is similar to that of the `range()` command in Python, i.e., a tuple `(start_value, end_value, step)`. As seen above, inserting parameter values or even expressions is okay. As in `range()`, the `end_value` is exclusive.\n",
    "\n",
    "As for `SequencePT` and `RepetitionPT`, `ForLoopPT` exposes all parameters defined by the subtemplate except for the loop parameter, `t` in the above example. If expressions are used in the range definition and they make use of additional parameters, these are also exposed by `ForLoopPT`. \n",
    "\n",
    "`ForLoopPT` also exposes measurements defined by subtemplates.\n",
    "\n",
    "## AtomicMultiChannelPulseTemplate: Run Pulses in Parallel on Different Channels\n",
    "\n",
    "So far we have only looked at pulses that affect the time-domain aspect of combining pulses. Another way to combine pulses is to parallelise them by executing them on different channels at the same time. This is of course already supported by simply creating atomic pulse templates (`TablePT`, `PointPT`, `FunctionPT`) on multiple channels. However, sometimes it is necessary to put already existing pulses in parallel. Instead of having to define a new atomic pulse template for this, we can make use of the `AtomicMuliChannelPulseTemplate` class. To learn more about how this works, see [Multi-Channel Pulses](07MultiChannelTemplates.ipynb).\n",
    "\n",
    "## Combining Combined Pulses\n",
    "\n",
    "Our examples above have build combined higher-level pulses (`SequencePT`, `RepetitionPT`, `ForLoopPT`) on atomic subtemplates only. However, this is not a requirement. We can use `SequencePT`, `RepetitionPT` and `ForLoopPT` using any `PulseTemplate` objects as subtemplates allowing us to build arbitrarily complex pulses out of only a handful of primitives."
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python [default]",
   "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.7.0"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}