doc/training/2_Quick_Tour.ipynb

{
 "cells": [
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Session 2: Quick tour of Veneer\n",
    "\n",
    "- Main features of Veneer (and veneer-py)\n",
    "    - Starting a new notebook\n",
    "    - Querying models\n",
    "    - Running models and Retrieving results\n",
    "    - Manipulating model setup and the ‘Allow Scripts’ option\n",
    "    - PEST and Parallel processing\n",
    "    - GUI and Command Line\n",
    "    - Local and Remote connections\n",
    "    - Getting help\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Start Source and Veneer\n",
    "\n",
    "If you haven't already started Source, do so now, following the instructions in [0Setup_and_Hello_World.ipynb](0Setup_and_Hello_World.ipynb) to load and start Veneer using the `Tools|Web Server Monitoring` option.\n",
    "\n",
    "## Which Model?\n",
    "\n",
    "**Note:** This session uses `ExampleProject/RiverModel1.rsproj`. You are welcome to work with your own model instead, however you will need to change the notebook text at certain points to reflect the names of nodes, links and functions in your model file."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "collapsed": true
   },
   "source": [
    "## Starting a new Notebook\n",
    "\n",
    "You can edit your local copy of this notebook. Alternatively, start a new notebook and enter the relevant code there. From an existing notebook, use the `File|New Notebook|Python 3` menu to start a new notebook using Python 3 syntax.\n",
    "\n",
    "You can also create a new notebook from the main Jupyter dashboard, using the New button.\n",
    "\n",
    "It's probably worth using a Markdown cell at the top of the notebook to describe the purpose of the notebook (if only to remind yourself later...)\n",
    "\n",
    "Then, in the first code block, you should `import` relevant Python packages and generally initialise your Python environment with anything needed for the notebook:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "import veneer\n",
    "import numpy as np\n",
    "import pandas as pd\n",
    "import matplotlib.pyplot as plt\n",
    "%matplotlib inline"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "collapsed": true
   },
   "source": [
    "### import\n",
    "\n",
    "The Python `import` statement makes other packages available to your current session.\n",
    "\n",
    "There are a few forms of `import`, two of which are illustrated here:\n",
    "\n",
    "* `import veneer` makes the main veneer-py package available. You can access parts of the package using `veneer.<member>`\n",
    "* `import pandas as pd` imports the pandas package, but aliases it as `pd` for convenience. For common packages (such as numpy adn pandas) there is often a well-used abbreviation, such as `np` and `pd`.\n",
    "* `from os import mkdir, makedirs` imports one or more specific members of the os package and makes them available without any prefix\n",
    "* `from os import *` imports all the members of the os package and makes them available without any prefix (eg `makedirs('test')`).\n",
    "\n",
    "### %matplotlib\n",
    "\n",
    "`%matplotlib` enables plotting by configuring a rendering engine for the matplotlib package. Anything starting with `%` is a special ('magic') command to Jupyter/IPython - it isn't standard Python.\n",
    "\n",
    "The `%matplotlib` magic command accepts an optional parameter indicating which rendering backend to use for the current session. I've used `inline`, which renders charts directly within the notebook as HTML `<img>` tags. I find this best for creating self-sufficient notebooks that can be circulated and read without running. The downside is that the charts aren't interactive.\n",
    "\n",
    "Other options worth noting:\n",
    "\n",
    "* `%matplotlib` - (ie without specifying a rendering backend). This gives you the default for your current system. On my Windows machine, this uses the Qt4 windowing toolkit and charts appear in their own window, with basic zoom, pan, export and layout controls.\n",
    "* `%matplotlib notebook` - Renders within the notebook with some basic interactive chart controls."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[<matplotlib.lines.Line2D at 0x8fb7898>]"
      ]
     },
     "execution_count": 2,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\nf8y56VCHfgAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x5776198>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "%matplotlib inline\n",
    "plt.plot(range(10))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "%matplotlib notebook"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "application/javascript": [
       "/* Put everything inside the global mpl namespace */\n",
       "window.mpl = {};\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",
       "            fig.send_message(\"refresh\", {});\n",
       "        }\n",
       "\n",
       "    this.imageObj.onload = function() {\n",
       "            if (fig.image_mode == 'full') {\n",
       "                // Full images could contain transparency (where diff images\n",
       "                // almost always do), so we need to clear the canvas so that\n",
       "                // there is no ghosting.\n",
       "                fig.context.clearRect(0, 0, fig.canvas.width, fig.canvas.height);\n",
       "            }\n",
       "            fig.context.drawImage(fig.imageObj, 0, 0);\n",
       "        };\n",
       "\n",
       "    this.imageObj.onunload = function() {\n",
       "        this.ws.close();\n",
       "    }\n",
       "\n",
       "    this.ws.onmessage = this._make_on_message_function(this);\n",
       "\n",
       "    this.ondownload = ondownload;\n",
       "}\n",
       "\n",
       "mpl.figure.prototype._init_header = function() {\n",
       "    var titlebar = $(\n",
       "        '<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 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);\n",
       "        canvas.attr('height', height);\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'];\n",
       "    var y0 = fig.canvas.height - msg['y0'];\n",
       "    var x1 = msg['x1'];\n",
       "    var y1 = fig.canvas.height - msg['y1'];\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;\n",
       "    var y = canvas_pos.y;\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\", \"jpeg\", \"pdf\", \"png\", \"ps\", \"raw\", \"svg\", \"tif\"];\n",
       "\n",
       "mpl.default_extension = \"png\";var comm_websocket_adapter = function(comm) {\n",
       "    // Create a \"websocket\"-like object which calls the given IPython comm\n",
       "    // object with the appropriate methods. Currently this is a non binary\n",
       "    // socket, so there is still some room for performance tuning.\n",
       "    var ws = {};\n",
       "\n",
       "    ws.close = function() {\n",
       "        comm.close()\n",
       "    };\n",
       "    ws.send = function(m) {\n",
       "        //console.log('sending', m);\n",
       "        comm.send(m);\n",
       "    };\n",
       "    // Register the callback with on_msg.\n",
       "    comm.on_msg(function(msg) {\n",
       "        //console.log('receiving', msg['content']['data'], msg);\n",
       "        // Pass the mpl event to the overriden (by mpl) onmessage function.\n",
       "        ws.onmessage(msg['content']['data'])\n",
       "    });\n",
       "    return ws;\n",
       "}\n",
       "\n",
       "mpl.mpl_figure_comm = function(comm, msg) {\n",
       "    // This is the function which gets called when the mpl process\n",
       "    // starts-up an IPython Comm through the \"matplotlib\" channel.\n",
       "\n",
       "    var id = msg.content.data.id;\n",
       "    // Get hold of the div created by the display call when the Comm\n",
       "    // socket was opened in Python.\n",
       "    var element = $(\"#\" + id);\n",
       "    var ws_proxy = comm_websocket_adapter(comm)\n",
       "\n",
       "    function ondownload(figure, format) {\n",
       "        window.open(figure.imageObj.src);\n",
       "    }\n",
       "\n",
       "    var fig = new mpl.figure(id, ws_proxy,\n",
       "                           ondownload,\n",
       "                           element.get(0));\n",
       "\n",
       "    // Call onopen now - mpl needs it, as it is assuming we've passed it a real\n",
       "    // web socket which is closed, not our websocket->open comm proxy.\n",
       "    ws_proxy.onopen();\n",
       "\n",
       "    fig.parent_element = element.get(0);\n",
       "    fig.cell_info = mpl.find_output_cell(\"<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",
       "    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 + '\">');\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 dataURL = this.canvas.toDataURL();\n",
       "    this.cell_info[1]['text/html'] = '<img src=\"' + dataURL + '\">';\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,iVBORw0KGgoAAAANSUhEUgAAAeAAAAFACAYAAABkyK97AAAM60lEQVR4Xu3VwQkAAAjEMN1/abewn7jAQRC64wgQIECAAIF3gX1fNEiAAAECBAiMAHsCAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECAiwHyBAgAABAoGAAAfoJgkQIECAgAD7AQIECBAgEAgIcIBukgABAgQICLAfIECAAAECgYAAB+gmCRAgQICAAPsBAgQIECAQCAhwgG6SAAECBAgIsB8gQIAAAQKBgAAH6CYJECBAgIAA+wECBAgQIBAICHCAbpIAAQIECBwypQFB5c7dcQAAAABJRU5ErkJggg==\">"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "text/plain": [
       "[<matplotlib.lines.Line2D at 0x9822c88>]"
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x97b1e80>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.plot(range(10))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "%matplotlib inline"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Aside:** the `range` function is a generator. In this case, its generating a consecutive integers, starting from 0 and going up to, but not including, 10.\n",
    "\n",
    "Try:\n",
    "\n",
    "`print(range(10))`\n",
    "\n",
    "and\n",
    "\n",
    "`print(list(range(10))`"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Initialising a Veneer client\n",
    "\n",
    "veneer-py provides functions for accessing a running copy of Source/Veneer. Most of these functions are provided through an instance of the `Veneer` client class, within the `veneer` package. You can have as many clients as you need - for example, to point to different copies of Source that are running concurrently.\n",
    "\n",
    "By default, the client will attempt to connect to a copy of Source/Veneer running on the local machine and hosted on port 9876"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "v = veneer.Veneer()\n",
    "# Equiavelent to\n",
    "# v = veneer.Veneer(host='localhost',port=9876)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The rest of this tutorial uses `v` to refer to current Veneer client"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Querying models\n",
    "\n",
    "veneer-py provides two groups of functions:\n",
    "\n",
    "1. Functions for accessing the various URLs defined by Veneer (eg `v.network()` accesses the `/network` URL), and\n",
    "2. Functions for accessing the catch-all, IronPython endpoint (eg `v.model.catchments.runoff.get_param_values('SMSC')` uses IronPython to query the SMSC parameter in the rainfall runoff models)\n",
    "\n",
    "The functions in group 1 should work on all Source models, whereas the functions in group 2 tend to be more model specific.\n",
    "\n",
    "This section deals with group 1 - functions related to specific URLs."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Network queries\n",
    "\n",
    "You can retrieve the current node link network (including catchment polygons if present) using `v.network()`. The result includes a list of `features`, which you can search and filter for particular nodes/links/catchments."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "the_network = v.network()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "6"
      ]
     },
     "execution_count": 8,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "all_nodes = the_network['features'].find_by_feature_type('node')\n",
    "len(all_nodes)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "['Ungauged Inflow', 'Storage', 'SP', 'MFR', 'Water User', 'End Of System']"
      ]
     },
     "execution_count": 9,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "all_nodes._all_values('name')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You can also perform some basic topological queries on the network, such as finding all network outlets, or finding upstream/downstream links for a given node"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[{'geometry': {'coordinates': [323, 718], 'type': 'Point'}, 'properties': {'icon': '/resources/GaugeNodeModel', 'name': 'End Of System', 'feature_type': 'node', 'schematic_location': [323, 718]}, 'type': 'Feature', 'id': '/network/nodes/12'}]"
      ]
     },
     "execution_count": 10,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "outlets = the_network.outlet_nodes()\n",
    "outlets"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[{'geometry': {'coordinates': [[317, 560], [323, 718]], 'type': 'LineString'}, 'properties': {'to_node': '/network/nodes/12', 'name': 'SR3', 'feature_type': 'link', 'from_node': '/network/nodes/6'}, 'type': 'Feature', 'id': '/network/link/3'}]"
      ]
     },
     "execution_count": 11,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "the_network.upstream_links(outlets[0])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If you have GeoPandas installed, you can convert network to a GeoDataFrame, which is useful for visualisation, reporting and advanced filtering."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>feature_type</th>\n",
       "      <th>from_node</th>\n",
       "      <th>geometry</th>\n",
       "      <th>icon</th>\n",
       "      <th>name</th>\n",
       "      <th>schematic_location</th>\n",
       "      <th>to_node</th>\n",
       "      <th>id</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>node</td>\n",
       "      <td>NaN</td>\n",
       "      <td>POINT (317 286)</td>\n",
       "      <td>/resources/InjectedFlow</td>\n",
       "      <td>Ungauged Inflow</td>\n",
       "      <td>[317, 286]</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/1</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>node</td>\n",
       "      <td>NaN</td>\n",
       "      <td>POINT (317 393)</td>\n",
       "      <td>/resources/StorageNodeModel</td>\n",
       "      <td>Storage</td>\n",
       "      <td>[317, 393]</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/3</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>node</td>\n",
       "      <td>NaN</td>\n",
       "      <td>POINT (317 560)</td>\n",
       "      <td>/resources/ExtractionNodeModel</td>\n",
       "      <td>SP</td>\n",
       "      <td>[317, 560]</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/6</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>node</td>\n",
       "      <td>NaN</td>\n",
       "      <td>POINT (317 478)</td>\n",
       "      <td>/resources/MinimumFlowConstraintModel</td>\n",
       "      <td>MFR</td>\n",
       "      <td>[317, 478]</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/10</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>node</td>\n",
       "      <td>NaN</td>\n",
       "      <td>POINT (200 619)</td>\n",
       "      <td>/resources/WaterUserNodeModel</td>\n",
       "      <td>Water User</td>\n",
       "      <td>[200, 619]</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>5</th>\n",
       "      <td>node</td>\n",
       "      <td>NaN</td>\n",
       "      <td>POINT (323 718)</td>\n",
       "      <td>/resources/GaugeNodeModel</td>\n",
       "      <td>End Of System</td>\n",
       "      <td>[323, 718]</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>6</th>\n",
       "      <td>link</td>\n",
       "      <td>/network/nodes/3</td>\n",
       "      <td>LINESTRING (317 393, 317 478)</td>\n",
       "      <td>NaN</td>\n",
       "      <td>Default Link #4</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/10</td>\n",
       "      <td>/network/link/0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>7</th>\n",
       "      <td>link</td>\n",
       "      <td>/network/nodes/10</td>\n",
       "      <td>LINESTRING (317 478, 317 560)</td>\n",
       "      <td>NaN</td>\n",
       "      <td>SR2</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/6</td>\n",
       "      <td>/network/link/1</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>8</th>\n",
       "      <td>link</td>\n",
       "      <td>/network/nodes/6</td>\n",
       "      <td>LINESTRING (317 560, 200 619)</td>\n",
       "      <td>NaN</td>\n",
       "      <td>Default Link #6</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/11</td>\n",
       "      <td>/network/link/2</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>9</th>\n",
       "      <td>link</td>\n",
       "      <td>/network/nodes/6</td>\n",
       "      <td>LINESTRING (317 560, 323 718)</td>\n",
       "      <td>NaN</td>\n",
       "      <td>SR3</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/12</td>\n",
       "      <td>/network/link/3</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>10</th>\n",
       "      <td>link</td>\n",
       "      <td>/network/nodes/1</td>\n",
       "      <td>LINESTRING (317 286, 317 393)</td>\n",
       "      <td>NaN</td>\n",
       "      <td>Default Link #5</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/3</td>\n",
       "      <td>/network/link/4</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   feature_type          from_node                       geometry  \\\n",
       "0          node                NaN                POINT (317 286)   \n",
       "1          node                NaN                POINT (317 393)   \n",
       "2          node                NaN                POINT (317 560)   \n",
       "3          node                NaN                POINT (317 478)   \n",
       "4          node                NaN                POINT (200 619)   \n",
       "5          node                NaN                POINT (323 718)   \n",
       "6          link   /network/nodes/3  LINESTRING (317 393, 317 478)   \n",
       "7          link  /network/nodes/10  LINESTRING (317 478, 317 560)   \n",
       "8          link   /network/nodes/6  LINESTRING (317 560, 200 619)   \n",
       "9          link   /network/nodes/6  LINESTRING (317 560, 323 718)   \n",
       "10         link   /network/nodes/1  LINESTRING (317 286, 317 393)   \n",
       "\n",
       "                                     icon             name schematic_location  \\\n",
       "0                 /resources/InjectedFlow  Ungauged Inflow         [317, 286]   \n",
       "1             /resources/StorageNodeModel          Storage         [317, 393]   \n",
       "2          /resources/ExtractionNodeModel               SP         [317, 560]   \n",
       "3   /resources/MinimumFlowConstraintModel              MFR         [317, 478]   \n",
       "4           /resources/WaterUserNodeModel       Water User         [200, 619]   \n",
       "5               /resources/GaugeNodeModel    End Of System         [323, 718]   \n",
       "6                                     NaN  Default Link #4                NaN   \n",
       "7                                     NaN              SR2                NaN   \n",
       "8                                     NaN  Default Link #6                NaN   \n",
       "9                                     NaN              SR3                NaN   \n",
       "10                                    NaN  Default Link #5                NaN   \n",
       "\n",
       "              to_node                 id  \n",
       "0                 NaN   /network/nodes/1  \n",
       "1                 NaN   /network/nodes/3  \n",
       "2                 NaN   /network/nodes/6  \n",
       "3                 NaN  /network/nodes/10  \n",
       "4                 NaN  /network/nodes/11  \n",
       "5                 NaN  /network/nodes/12  \n",
       "6   /network/nodes/10    /network/link/0  \n",
       "7    /network/nodes/6    /network/link/1  \n",
       "8   /network/nodes/11    /network/link/2  \n",
       "9   /network/nodes/12    /network/link/3  \n",
       "10   /network/nodes/3    /network/link/4  "
      ]
     },
     "execution_count": 12,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "network_df = the_network.as_dataframe()\n",
    "network_df"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "With a GeoDataFrame, you can filter against any column"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>feature_type</th>\n",
       "      <th>from_node</th>\n",
       "      <th>geometry</th>\n",
       "      <th>icon</th>\n",
       "      <th>name</th>\n",
       "      <th>schematic_location</th>\n",
       "      <th>to_node</th>\n",
       "      <th>id</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>node</td>\n",
       "      <td>NaN</td>\n",
       "      <td>POINT (317 286)</td>\n",
       "      <td>/resources/InjectedFlow</td>\n",
       "      <td>Ungauged Inflow</td>\n",
       "      <td>[317, 286]</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/1</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>node</td>\n",
       "      <td>NaN</td>\n",
       "      <td>POINT (317 393)</td>\n",
       "      <td>/resources/StorageNodeModel</td>\n",
       "      <td>Storage</td>\n",
       "      <td>[317, 393]</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/3</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>node</td>\n",
       "      <td>NaN</td>\n",
       "      <td>POINT (317 560)</td>\n",
       "      <td>/resources/ExtractionNodeModel</td>\n",
       "      <td>SP</td>\n",
       "      <td>[317, 560]</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/6</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>node</td>\n",
       "      <td>NaN</td>\n",
       "      <td>POINT (317 478)</td>\n",
       "      <td>/resources/MinimumFlowConstraintModel</td>\n",
       "      <td>MFR</td>\n",
       "      <td>[317, 478]</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/10</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>node</td>\n",
       "      <td>NaN</td>\n",
       "      <td>POINT (200 619)</td>\n",
       "      <td>/resources/WaterUserNodeModel</td>\n",
       "      <td>Water User</td>\n",
       "      <td>[200, 619]</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>5</th>\n",
       "      <td>node</td>\n",
       "      <td>NaN</td>\n",
       "      <td>POINT (323 718)</td>\n",
       "      <td>/resources/GaugeNodeModel</td>\n",
       "      <td>End Of System</td>\n",
       "      <td>[323, 718]</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/12</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "  feature_type from_node         geometry  \\\n",
       "0         node       NaN  POINT (317 286)   \n",
       "1         node       NaN  POINT (317 393)   \n",
       "2         node       NaN  POINT (317 560)   \n",
       "3         node       NaN  POINT (317 478)   \n",
       "4         node       NaN  POINT (200 619)   \n",
       "5         node       NaN  POINT (323 718)   \n",
       "\n",
       "                                    icon             name schematic_location  \\\n",
       "0                /resources/InjectedFlow  Ungauged Inflow         [317, 286]   \n",
       "1            /resources/StorageNodeModel          Storage         [317, 393]   \n",
       "2         /resources/ExtractionNodeModel               SP         [317, 560]   \n",
       "3  /resources/MinimumFlowConstraintModel              MFR         [317, 478]   \n",
       "4          /resources/WaterUserNodeModel       Water User         [200, 619]   \n",
       "5              /resources/GaugeNodeModel    End Of System         [323, 718]   \n",
       "\n",
       "  to_node                 id  \n",
       "0     NaN   /network/nodes/1  \n",
       "1     NaN   /network/nodes/3  \n",
       "2     NaN   /network/nodes/6  \n",
       "3     NaN  /network/nodes/10  \n",
       "4     NaN  /network/nodes/11  \n",
       "5     NaN  /network/nodes/12  "
      ]
     },
     "execution_count": 13,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "network_df[network_df.feature_type=='node']"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>feature_type</th>\n",
       "      <th>from_node</th>\n",
       "      <th>geometry</th>\n",
       "      <th>icon</th>\n",
       "      <th>name</th>\n",
       "      <th>schematic_location</th>\n",
       "      <th>to_node</th>\n",
       "      <th>id</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>node</td>\n",
       "      <td>NaN</td>\n",
       "      <td>POINT (317 393)</td>\n",
       "      <td>/resources/StorageNodeModel</td>\n",
       "      <td>Storage</td>\n",
       "      <td>[317, 393]</td>\n",
       "      <td>NaN</td>\n",
       "      <td>/network/nodes/3</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "  feature_type from_node         geometry                         icon  \\\n",
       "1         node       NaN  POINT (317 393)  /resources/StorageNodeModel   \n",
       "\n",
       "      name schematic_location to_node                id  \n",
       "1  Storage         [317, 393]     NaN  /network/nodes/3  "
      ]
     },
     "execution_count": 14,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "network_df[network_df.icon=='/resources/StorageNodeModel']"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Querying Functions and Variables\n",
    "\n",
    "You can query all functions using `v.functions()`, and all variables with `v.variables()`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[{'Name': '$InflowCalc', 'Expression': '/* Scaling factor 3.5 */\\r\\n3.5*$Runoff\\r\\n'}, {'Name': '$FlowRequirement', 'Expression': 'lookup($MFR_Piecewise,$InflowCalc)\\r\\n'}]"
      ]
     },
     "execution_count": 15,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "model_functions = v.functions()\n",
    "model_functions"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[{'FullName': '$Now.Day', 'TimeSeries': None, 'ID': 1, 'Name': '$Day', 'VeneerDebugInfo': None, 'VariableType': 'NowVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$Start.Day', 'TimeSeries': None, 'ID': 2, 'Name': '$Day', 'VeneerDebugInfo': None, 'VariableType': 'FixedDateVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$End.Day', 'TimeSeries': None, 'ID': 3, 'Name': '$Day', 'VeneerDebugInfo': None, 'VariableType': 'FixedDateVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$Now.Month', 'TimeSeries': None, 'ID': 4, 'Name': '$Month', 'VeneerDebugInfo': None, 'VariableType': 'NowVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$Start.Month', 'TimeSeries': None, 'ID': 5, 'Name': '$Month', 'VeneerDebugInfo': None, 'VariableType': 'FixedDateVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$End.Month', 'TimeSeries': None, 'ID': 6, 'Name': '$Month', 'VeneerDebugInfo': None, 'VariableType': 'FixedDateVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$Now.Year', 'TimeSeries': None, 'ID': 7, 'Name': '$Year', 'VeneerDebugInfo': None, 'VariableType': 'NowVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$Start.Year', 'TimeSeries': None, 'ID': 8, 'Name': '$Year', 'VeneerDebugInfo': None, 'VariableType': 'FixedDateVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$End.Year', 'TimeSeries': None, 'ID': 9, 'Name': '$Year', 'VeneerDebugInfo': None, 'VariableType': 'FixedDateVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$Now.Hour', 'TimeSeries': None, 'ID': 10, 'Name': '$Hour', 'VeneerDebugInfo': None, 'VariableType': 'NowVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$Start.Hour', 'TimeSeries': None, 'ID': 11, 'Name': '$Hour', 'VeneerDebugInfo': None, 'VariableType': 'FixedDateVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$End.Hour', 'TimeSeries': None, 'ID': 12, 'Name': '$Hour', 'VeneerDebugInfo': None, 'VariableType': 'FixedDateVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$Now.DayOfYear', 'TimeSeries': None, 'ID': 13, 'Name': '$DayOfYear', 'VeneerDebugInfo': None, 'VariableType': 'NowVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$Start.DayOfYear', 'TimeSeries': None, 'ID': 14, 'Name': '$DayOfYear', 'VeneerDebugInfo': None, 'VariableType': 'FixedDateVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$End.DayOfYear', 'TimeSeries': None, 'ID': 15, 'Name': '$DayOfYear', 'VeneerDebugInfo': None, 'VariableType': 'FixedDateVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$Now.DaysInMonth', 'TimeSeries': None, 'ID': 16, 'Name': '$DaysInMonth', 'VeneerDebugInfo': None, 'VariableType': 'NowVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$Start.DaysInMonth', 'TimeSeries': None, 'ID': 17, 'Name': '$DaysInMonth', 'VeneerDebugInfo': None, 'VariableType': 'FixedDateVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$End.DaysInMonth', 'TimeSeries': None, 'ID': 18, 'Name': '$DaysInMonth', 'VeneerDebugInfo': None, 'VariableType': 'FixedDateVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$ActiveInputSet', 'TimeSeries': None, 'ID': 19, 'Name': '$ActiveInputSet', 'VeneerDebugInfo': None, 'VariableType': 'ActiveInputSetVariable', 'VeneerSupported': False, 'PiecewiseFunction': None}, {'FullName': '$MFR_Piecewise', 'TimeSeries': None, 'ID': 21, 'Name': '$MFR_Piecewise', 'VeneerDebugInfo': None, 'VariableType': 'LinearVariable', 'VeneerSupported': True, 'PiecewiseFunction': '/variables/MFR_Piecewise/Piecewise'}, {'FullName': '$Runoff', 'TimeSeries': '/variables/Runoff/TimeSeries', 'ID': 20, 'Name': '$Runoff', 'VeneerDebugInfo': 'DisplayName=$Runoff;ResultUnit=no unit selected (None);', 'VariableType': 'TimeSeriesVariable', 'VeneerSupported': True, 'PiecewiseFunction': None}]"
      ]
     },
     "execution_count": 16,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "model_variables = v.variables()\n",
    "model_variables"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Both `v.functions()` and `v.variables()` return a searchable list:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[{'FullName': '$Runoff', 'TimeSeries': '/variables/Runoff/TimeSeries', 'ID': 20, 'Name': '$Runoff', 'VeneerDebugInfo': 'DisplayName=$Runoff;ResultUnit=no unit selected (None);', 'VariableType': 'TimeSeriesVariable', 'VeneerSupported': True, 'PiecewiseFunction': None}]"
      ]
     },
     "execution_count": 17,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "model_variables.find_by_Name('$Runoff')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Note:** When you get a searchable list, you can also convert it to a Pandas Data Frame if that is more convenient"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>FullName</th>\n",
       "      <th>ID</th>\n",
       "      <th>Name</th>\n",
       "      <th>PiecewiseFunction</th>\n",
       "      <th>TimeSeries</th>\n",
       "      <th>VariableType</th>\n",
       "      <th>VeneerDebugInfo</th>\n",
       "      <th>VeneerSupported</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>$Now.Day</td>\n",
       "      <td>1</td>\n",
       "      <td>$Day</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>NowVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>$Start.Day</td>\n",
       "      <td>2</td>\n",
       "      <td>$Day</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>FixedDateVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>$End.Day</td>\n",
       "      <td>3</td>\n",
       "      <td>$Day</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>FixedDateVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>$Now.Month</td>\n",
       "      <td>4</td>\n",
       "      <td>$Month</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>NowVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>$Start.Month</td>\n",
       "      <td>5</td>\n",
       "      <td>$Month</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>FixedDateVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>5</th>\n",
       "      <td>$End.Month</td>\n",
       "      <td>6</td>\n",
       "      <td>$Month</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>FixedDateVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>6</th>\n",
       "      <td>$Now.Year</td>\n",
       "      <td>7</td>\n",
       "      <td>$Year</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>NowVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>7</th>\n",
       "      <td>$Start.Year</td>\n",
       "      <td>8</td>\n",
       "      <td>$Year</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>FixedDateVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>8</th>\n",
       "      <td>$End.Year</td>\n",
       "      <td>9</td>\n",
       "      <td>$Year</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>FixedDateVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>9</th>\n",
       "      <td>$Now.Hour</td>\n",
       "      <td>10</td>\n",
       "      <td>$Hour</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>NowVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>10</th>\n",
       "      <td>$Start.Hour</td>\n",
       "      <td>11</td>\n",
       "      <td>$Hour</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>FixedDateVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>11</th>\n",
       "      <td>$End.Hour</td>\n",
       "      <td>12</td>\n",
       "      <td>$Hour</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>FixedDateVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>12</th>\n",
       "      <td>$Now.DayOfYear</td>\n",
       "      <td>13</td>\n",
       "      <td>$DayOfYear</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>NowVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>13</th>\n",
       "      <td>$Start.DayOfYear</td>\n",
       "      <td>14</td>\n",
       "      <td>$DayOfYear</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>FixedDateVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>14</th>\n",
       "      <td>$End.DayOfYear</td>\n",
       "      <td>15</td>\n",
       "      <td>$DayOfYear</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>FixedDateVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>15</th>\n",
       "      <td>$Now.DaysInMonth</td>\n",
       "      <td>16</td>\n",
       "      <td>$DaysInMonth</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>NowVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>16</th>\n",
       "      <td>$Start.DaysInMonth</td>\n",
       "      <td>17</td>\n",
       "      <td>$DaysInMonth</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>FixedDateVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>17</th>\n",
       "      <td>$End.DaysInMonth</td>\n",
       "      <td>18</td>\n",
       "      <td>$DaysInMonth</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>FixedDateVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>18</th>\n",
       "      <td>$ActiveInputSet</td>\n",
       "      <td>19</td>\n",
       "      <td>$ActiveInputSet</td>\n",
       "      <td>None</td>\n",
       "      <td>None</td>\n",
       "      <td>ActiveInputSetVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>False</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>19</th>\n",
       "      <td>$MFR_Piecewise</td>\n",
       "      <td>21</td>\n",
       "      <td>$MFR_Piecewise</td>\n",
       "      <td>/variables/MFR_Piecewise/Piecewise</td>\n",
       "      <td>None</td>\n",
       "      <td>LinearVariable</td>\n",
       "      <td>None</td>\n",
       "      <td>True</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>20</th>\n",
       "      <td>$Runoff</td>\n",
       "      <td>20</td>\n",
       "      <td>$Runoff</td>\n",
       "      <td>None</td>\n",
       "      <td>/variables/Runoff/TimeSeries</td>\n",
       "      <td>TimeSeriesVariable</td>\n",
       "      <td>DisplayName=$Runoff;ResultUnit=no unit selecte...</td>\n",
       "      <td>True</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "              FullName  ID             Name  \\\n",
       "0             $Now.Day   1             $Day   \n",
       "1           $Start.Day   2             $Day   \n",
       "2             $End.Day   3             $Day   \n",
       "3           $Now.Month   4           $Month   \n",
       "4         $Start.Month   5           $Month   \n",
       "5           $End.Month   6           $Month   \n",
       "6            $Now.Year   7            $Year   \n",
       "7          $Start.Year   8            $Year   \n",
       "8            $End.Year   9            $Year   \n",
       "9            $Now.Hour  10            $Hour   \n",
       "10         $Start.Hour  11            $Hour   \n",
       "11           $End.Hour  12            $Hour   \n",
       "12      $Now.DayOfYear  13       $DayOfYear   \n",
       "13    $Start.DayOfYear  14       $DayOfYear   \n",
       "14      $End.DayOfYear  15       $DayOfYear   \n",
       "15    $Now.DaysInMonth  16     $DaysInMonth   \n",
       "16  $Start.DaysInMonth  17     $DaysInMonth   \n",
       "17    $End.DaysInMonth  18     $DaysInMonth   \n",
       "18     $ActiveInputSet  19  $ActiveInputSet   \n",
       "19      $MFR_Piecewise  21   $MFR_Piecewise   \n",
       "20             $Runoff  20          $Runoff   \n",
       "\n",
       "                     PiecewiseFunction                    TimeSeries  \\\n",
       "0                                 None                          None   \n",
       "1                                 None                          None   \n",
       "2                                 None                          None   \n",
       "3                                 None                          None   \n",
       "4                                 None                          None   \n",
       "5                                 None                          None   \n",
       "6                                 None                          None   \n",
       "7                                 None                          None   \n",
       "8                                 None                          None   \n",
       "9                                 None                          None   \n",
       "10                                None                          None   \n",
       "11                                None                          None   \n",
       "12                                None                          None   \n",
       "13                                None                          None   \n",
       "14                                None                          None   \n",
       "15                                None                          None   \n",
       "16                                None                          None   \n",
       "17                                None                          None   \n",
       "18                                None                          None   \n",
       "19  /variables/MFR_Piecewise/Piecewise                          None   \n",
       "20                                None  /variables/Runoff/TimeSeries   \n",
       "\n",
       "              VariableType                                    VeneerDebugInfo  \\\n",
       "0              NowVariable                                               None   \n",
       "1        FixedDateVariable                                               None   \n",
       "2        FixedDateVariable                                               None   \n",
       "3              NowVariable                                               None   \n",
       "4        FixedDateVariable                                               None   \n",
       "5        FixedDateVariable                                               None   \n",
       "6              NowVariable                                               None   \n",
       "7        FixedDateVariable                                               None   \n",
       "8        FixedDateVariable                                               None   \n",
       "9              NowVariable                                               None   \n",
       "10       FixedDateVariable                                               None   \n",
       "11       FixedDateVariable                                               None   \n",
       "12             NowVariable                                               None   \n",
       "13       FixedDateVariable                                               None   \n",
       "14       FixedDateVariable                                               None   \n",
       "15             NowVariable                                               None   \n",
       "16       FixedDateVariable                                               None   \n",
       "17       FixedDateVariable                                               None   \n",
       "18  ActiveInputSetVariable                                               None   \n",
       "19          LinearVariable                                               None   \n",
       "20      TimeSeriesVariable  DisplayName=$Runoff;ResultUnit=no unit selecte...   \n",
       "\n",
       "   VeneerSupported  \n",
       "0            False  \n",
       "1            False  \n",
       "2            False  \n",
       "3            False  \n",
       "4            False  \n",
       "5            False  \n",
       "6            False  \n",
       "7            False  \n",
       "8            False  \n",
       "9            False  \n",
       "10           False  \n",
       "11           False  \n",
       "12           False  \n",
       "13           False  \n",
       "14           False  \n",
       "15           False  \n",
       "16           False  \n",
       "17           False  \n",
       "18           False  \n",
       "19            True  \n",
       "20            True  "
      ]
     },
     "execution_count": 18,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "model_variables.as_dataframe()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "`v.variables()` only returns summary information about the variable. If you want to get at the actual time series (or the piecewise linear function or similar), use `v.variable_time_series(name)` (or `v.variable_piecewise(name)`):"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<matplotlib.axes._subplots.AxesSubplot at 0x9a765c0>"
      ]
     },
     "execution_count": 19,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAW0AAAEPCAYAAACJPZVzAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAIABJREFUeJztnXfYFcXZ/783CrEjxBZFAWPABAsW1GgMRBJRo+hrxYJo\nfleixpaoryUWQI2+NoglBGNFURAQBXt9HjsoAqKIgAUQUFR6USnP/P7Ys+yc8+ycndmZ2Z09z3yu\n61xnzp7ZmXtnZ+7p9xBjDB6Px+MpBs3yFsDj8Xg88nil7fF4PAXCK22Px+MpEF5pezweT4HwStvj\n8XgKhFfaHo/HUyASlTYR3UdEC4hoSsx/FxNRAxG1tiOex+PxeHhkWtoPAOhReZGI2gD4A4DZpoXy\neDweTzyJSpsx9iaAxTF/DQTwv8Yl8ng8Ho+QVGPaRNQTwJeMsQ8Ny+PxeDyeKmyoegMRbQzgHwiG\nRtZfNiaRx+PxeIQoK20APwfQDsAHREQA2gB4n4j2Y4x9U+mZiLxxE4/H40kBY6xRg1h2eIRKHzDG\nPmKMbccY25kx1h7AXAB7xSlsLmLpT9++fZX8m7g3jzgZY+jatWsu8fp0cvden04+ncKPCJklf48C\neBtAByKaQ0RnVupkGBwe6datW+b35hEnALRr1y6XeH06uXuvTyf7cRYxncpIW2so1BbME0/fvn3z\nFqEQ+HSSw6eTHEVJp5LubKRT/Y7IHDFW89Y4Pp3k8OkkR9HTiViVsRMjERAx23F4PB5PrUFEYDET\nkWlWj3g8Hk8j2rVrh9mz/QZpVdq2bYtZs2ZJ+/ctbY/HY4RSyzBvMQqHKN1ELW0/pu3xeDwFwitt\nj8fjKRBeaXs8Hk+B8Erb4/F4qjB79mw0a9YMDQ0NeYsCwCttj8fTBDj88MPRr1+/RtfHjBmDn/3s\nZ4kKOTCz5AZeaXuM8913wIwZeUvh8UT06dMHQ4cObXR96NCh6N27N5o1K44qLI6kHie44ALg5JOr\n+znpJKBjx2zk8XhkOOaYY7Bw4UK8+eab668tWbIETz/9NHr37o1nn30We++9N1q2bIm2bduif//+\nwrDat2+PV199df3v/v37o3fv3ut/jxs3DgcddBBatWqFvfbaC6+99prRZ/FK2wAHHAD06pW3FNkw\nZAgwfHh1PytWZCOLxyPLRhtthBNOOAEPPfTQ+muPPfYYfvnLX2L33XfHpptuiocffhhLly7FM888\ng8GDB2Ps2LHS4YfDJ/PmzcORRx6Ja665BosXL8att96K4447DgsXLjT2LF5pG2D8eOCVV8yGSQRM\nmmQ2TI8eQ4cCChvXcuGttwAFXZM5RGY+aejTpw9GjhyJ1atXAwAefvhh9OnTBwDQtWtXdOrUCQCw\n2267oVevXqlayI888gj++Mc/okeP4Fjd7t27Y99998Wzzz6bTugYvNJ2mI8+kvd75ZXAvHn2ZInj\njTcAwz0/p+ndG7jxxrylqE6vXsDRR+cthRjGzHzScNBBB2HrrbfGk08+ic8//xzvvfceTjnlFADA\n+PHjccghh2CbbbbBlltuibvvvhvfffedchyzZ8/GiBEj0Lp1a7Ru3RqtWrXCW2+9ha+++iqd0DE0\nOaW9di2wYEHeUsTTv3/6FvsNNwCjR5uVJ4lu3YJPLXP++cCqVXlLEeF6S991evfujSFDhmDo0KHo\n0aMHtt56awDAqaeeimOOOQbz5s3DkiVLcNZZZwm35G+66aZYxWWKr7/+er17xx13xOmnn45FixZh\n0aJFWLx4MZYvX45LL73U2DM0OaV9883AdtvlLUU8/foF8rmMatf0+++D1SRF5a67gOnT85YiYMIE\noH37vKUoNqeffjpefvll3HvvveuHRgBgxYoVaNWqFZo3b453330Xjz76aNl9vALv3Lkzhg8fjrVr\n12LChAkYNWrU+v9OO+00PPXUU3jxxRfR0NCAH374Aa+99hrmz59v7BmanNI22Espo8iKySZ/+hNQ\naswUFldsIK1cmbcE5RxwADB5ct5SqNG2bVsceOCBWLVqFXr27Ln++qBBg3D11VejZcuWuP7663HS\nSSeV3cev077uuuvw6aefonXr1ujfvz9OPfXU9f+1adMGY8aMwQ033ICtt94abdu2xa233mp0Y443\nzVoAPv0U2GWXZH9xymXZMmCLLcT3nHgisNlmwP33p5evEr41PmeOuXA9bjF+PFBXB3TunLckatTV\n1TW6duyxx+LYY4+N9d+2bVusW7du/e/27dtj3LhxwvC7dOmC+vp6bTlFNLmWdhH5xS+CrnEaWrYE\nuPzWiJEjgWHD0oXdVHClpW2D3/0ueQmnxy280i4I33+ftwSNKYoye/VVYMoUM2E5tJs5FtV3Ul8P\nPPGEFVE8lvBK2zFcV4RLl+YtgTrduwPHHZf+/qR3cv75wJdfBu5LLwUcsSvkKSgffww895z4f6+0\n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\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x9a9c0f0>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "runoff_ts = v.variable_time_series('$Runoff')\n",
    "runoff_ts.plot()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>Lookup</th>\n",
       "      <th>Result</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>0</td>\n",
       "      <td>0.0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>100</td>\n",
       "      <td>1.0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>101</td>\n",
       "      <td>1.1</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>1000</td>\n",
       "      <td>100.0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>10000</td>\n",
       "      <td>2000.0</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   Lookup  Result\n",
       "0       0     0.0\n",
       "1     100     1.0\n",
       "2     101     1.1\n",
       "3    1000   100.0\n",
       "4   10000  2000.0"
      ]
     },
     "execution_count": 20,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "mfr_piecewise = v.variable_piecewise('MFR_Piecewise')\n",
    "mfr_piecewise"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Note:** At this stage, only Time Series and Piecewise Linear variables are supported through this mechanism"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Data Sources\n",
    "\n",
    "You can get a list of all Data Sources in the model with `v.data_sources()`"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[{'FullName': '/ForcingData_csv', 'Path': '/', 'Name': 'ForcingData_csv', 'Items': [{'Details': [{'TimeSeries': {'Name': 'Inflow', 'StartDate': '01/01/1901 00:00:00', 'Max': 13.09, 'Min': 0, 'EndDate': '12/31/2013 00:00:00', 'TimeStep': 'Daily', 'Mean': 1.518634390521643, 'Units': 'mm/d', 'Sum': 62678.59719999978, 'NoDataValue': -9999}, 'Name': 'Inflow'}, {'TimeSeries': {'Name': 'Rainfall', 'StartDate': '01/01/1901 00:00:00', 'Max': 210.9999, 'Min': 0, 'EndDate': '12/31/2013 00:00:00', 'TimeStep': 'Daily', 'Mean': 3.9211440845104604, 'Units': 'mm/d', 'Sum': 161837.37980000023, 'NoDataValue': -9999}, 'Name': 'Rainfall'}, {'TimeSeries': {'Name': 'PET', 'StartDate': '01/01/1901 00:00:00', 'Max': 8.502, 'Min': 2.0902, 'EndDate': '12/31/2013 00:00:00', 'TimeStep': 'Daily', 'Mean': 4.522002851743327, 'Units': 'mm/d', 'Sum': 186636.62370000235, 'NoDataValue': -9999}, 'Name': 'PET'}], 'Name': 'Default Input Set', 'InputSets': ['Default Input Set'], 'DetailsAsCSV': None, 'UnitsForNewTS': None}], 'id': '/dataSources/ForcingData_csv'}]"
      ]
     },
     "execution_count": 21,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "data_sources = v.data_sources()\n",
    "data_sources"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Using `.as_dataframe()` can help to interpret the information:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>FullName</th>\n",
       "      <th>Items</th>\n",
       "      <th>Name</th>\n",
       "      <th>Path</th>\n",
       "      <th>id</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>/ForcingData_csv</td>\n",
       "      <td>[{'Details': [{'TimeSeries': {'Name': 'Inflow'...</td>\n",
       "      <td>ForcingData_csv</td>\n",
       "      <td>/</td>\n",
       "      <td>/dataSources/ForcingData_csv</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "           FullName                                              Items  \\\n",
       "0  /ForcingData_csv  [{'Details': [{'TimeSeries': {'Name': 'Inflow'...   \n",
       "\n",
       "              Name Path                            id  \n",
       "0  ForcingData_csv    /  /dataSources/ForcingData_csv  "
      ]
     },
     "execution_count": 22,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "data_sources.as_dataframe()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This highlights that the `Items` column has nested information:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[{'Details': [{'Name': 'Inflow',\n",
       "    'TimeSeries': {'EndDate': '12/31/2013 00:00:00',\n",
       "     'Max': 13.09,\n",
       "     'Mean': 1.518634390521643,\n",
       "     'Min': 0,\n",
       "     'Name': 'Inflow',\n",
       "     'NoDataValue': -9999,\n",
       "     'StartDate': '01/01/1901 00:00:00',\n",
       "     'Sum': 62678.59719999978,\n",
       "     'TimeStep': 'Daily',\n",
       "     'Units': 'mm/d'}},\n",
       "   {'Name': 'Rainfall',\n",
       "    'TimeSeries': {'EndDate': '12/31/2013 00:00:00',\n",
       "     'Max': 210.9999,\n",
       "     'Mean': 3.9211440845104604,\n",
       "     'Min': 0,\n",
       "     'Name': 'Rainfall',\n",
       "     'NoDataValue': -9999,\n",
       "     'StartDate': '01/01/1901 00:00:00',\n",
       "     'Sum': 161837.37980000023,\n",
       "     'TimeStep': 'Daily',\n",
       "     'Units': 'mm/d'}},\n",
       "   {'Name': 'PET',\n",
       "    'TimeSeries': {'EndDate': '12/31/2013 00:00:00',\n",
       "     'Max': 8.502,\n",
       "     'Mean': 4.522002851743327,\n",
       "     'Min': 2.0902,\n",
       "     'Name': 'PET',\n",
       "     'NoDataValue': -9999,\n",
       "     'StartDate': '01/01/1901 00:00:00',\n",
       "     'Sum': 186636.62370000235,\n",
       "     'TimeStep': 'Daily',\n",
       "     'Units': 'mm/d'}}],\n",
       "  'DetailsAsCSV': None,\n",
       "  'InputSets': ['Default Input Set'],\n",
       "  'Name': 'Default Input Set',\n",
       "  'UnitsForNewTS': None}]"
      ]
     },
     "execution_count": 23,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "data_sources[0]['Items']"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "So, `v.data_sources()` returns information about all data sources. Specifically, it returns the list of data sources, and, for each one, information about the different time series. However, `v.data_sources` _does not_ return the entire time series. (This is mainly for speed - on big models, this can be HUGE)\n",
    "\n",
    "To get to the time series, either use `v.data_source(name)` to retrieve a single data source (and all the time series within it) OR `v.data_source_item(source,name)` to retrieve a particular time series.\n",
    "\n",
    "**Note:** With `v.data_source_item` you can retrieve the time series for an item that is associated with a particular input set."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 24,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'FullName': '/ForcingData_csv',\n",
       " 'Items': [{'Details':             Inflow     PET  Rainfall\n",
       " Date                                \n",
       " 1901-01-01  0.1469  3.2992    0.0000\n",
       " 1901-01-02  0.1381  3.2992    3.3983\n",
       " 1901-01-03  0.5186  3.2992    6.8529\n",
       " 1901-01-04  0.8163  3.2992    1.0206\n",
       " 1901-01-05  0.7895  3.2992    4.2553\n",
       " 1901-01-06  3.2796  3.2992   34.5720\n",
       " 1901-01-07  2.3858  3.2992    0.0000\n",
       " 1901-01-08  1.5464  3.2992    0.0000\n",
       " 1901-01-09  1.0746  3.2992    0.0000\n",
       " 1901-01-10  0.8072  3.2992    0.0000\n",
       " 1901-01-11  0.6536  3.2992    0.0000\n",
       " 1901-01-12  0.5633  3.2992    0.0000\n",
       " 1901-01-13  0.5083  3.2992    0.0000\n",
       " 1901-01-14  0.4730  3.2992    0.0000\n",
       " 1901-01-15  0.4489  3.2992    0.0000\n",
       " 1901-01-16  0.4310  3.2992    0.1968\n",
       " 1901-01-17  0.4167  3.2992    0.0038\n",
       " 1901-01-18  2.2677  3.2992   23.7419\n",
       " 1901-01-19  1.6556  3.2992    0.6581\n",
       " 1901-01-20  1.1583  3.2992    0.0000\n",
       " 1901-01-21  0.8762  3.2992    0.0000\n",
       " 1901-01-22  0.7139  3.2992    0.0000\n",
       " 1901-01-23  0.6182  3.2992    0.0000\n",
       " 1901-01-24  0.5598  3.2992    0.0000\n",
       " 1901-01-25  0.5221  3.2992    0.0000\n",
       " 1901-01-26  0.4961  3.2992    0.0000\n",
       " 1901-01-27  0.4767  3.2992    0.0000\n",
       " 1901-01-28  0.4611  3.2992    0.0000\n",
       " 1901-01-29  0.4477  3.2992    0.0000\n",
       " 1901-01-30  0.4357  3.2992    0.0000\n",
       " ...            ...     ...       ...\n",
       " 2013-12-02  0.4249  3.1944    0.0000\n",
       " 2013-12-03  0.4147  3.1944    0.0000\n",
       " 2013-12-04  0.4048  3.1944    0.0000\n",
       " 2013-12-05  0.3950  3.1944    0.0000\n",
       " 2013-12-06  0.3855  3.1944    0.0000\n",
       " 2013-12-07  0.3763  3.1944    0.0000\n",
       " 2013-12-08  0.3672  3.1944    0.0000\n",
       " 2013-12-09  0.3584  3.1944    0.0000\n",
       " 2013-12-10  0.3498  3.1944    0.0000\n",
       " 2013-12-11  0.3414  3.1944    0.0000\n",
       " 2013-12-12  0.3332  3.1944    0.0000\n",
       " 2013-12-13  0.3251  3.1944    0.0000\n",
       " 2013-12-14  0.3173  3.1944    0.0000\n",
       " 2013-12-15  0.3097  3.1944    0.0000\n",
       " 2013-12-16  0.3022  3.1944    0.0000\n",
       " 2013-12-17  0.2949  3.1944    0.0000\n",
       " 2013-12-18  0.2878  3.1944    0.0000\n",
       " 2013-12-19  0.2809  3.1944    0.0000\n",
       " 2013-12-20  0.2741  3.1944    0.0000\n",
       " 2013-12-21  0.2675  3.1944    0.0000\n",
       " 2013-12-22  0.2610  3.1944    0.0000\n",
       " 2013-12-23  0.2547  3.1944    0.0000\n",
       " 2013-12-24  0.2486  3.1944    0.0000\n",
       " 2013-12-25  0.2426  3.1944    0.0000\n",
       " 2013-12-26  0.2367  3.1944    0.0000\n",
       " 2013-12-27  0.2310  3.1944    0.0000\n",
       " 2013-12-28  0.2254  3.1944    0.0000\n",
       " 2013-12-29  0.2199  3.1944    0.0000\n",
       " 2013-12-30  0.2146  3.1944    0.0000\n",
       " 2013-12-31  0.2094  3.1944    0.0000\n",
       " \n",
       " [41273 rows x 3 columns], 'Name': 'Default Input Set', 'InputSets': ['Default Input Set'], 'DetailsAsCSV': None, 'UnitsForNewTS': None}],\n",
       " 'Name': 'ForcingData_csv',\n",
       " 'Path': '/',\n",
       " 'id': '/dataSources/ForcingData_csv'}"
      ]
     },
     "execution_count": 24,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "forcing = v.data_source('ForcingData_csv')\n",
    "forcing"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You can see that the time series are included, but they are still nested within the returned data. Essentially, Veneer has returned the data for each input set, with each being a separate Pandas DataFrame.\n",
    "\n",
    "You can get to an individual DataFrame back with `find_one_by_Name`"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 25,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>Inflow</th>\n",
       "      <th>PET</th>\n",
       "      <th>Rainfall</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Date</th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>1901-01-01</th>\n",
       "      <td>0.1469</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-02</th>\n",
       "      <td>0.1381</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>3.3983</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-03</th>\n",
       "      <td>0.5186</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>6.8529</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-04</th>\n",
       "      <td>0.8163</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>1.0206</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-05</th>\n",
       "      <td>0.7895</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>4.2553</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-06</th>\n",
       "      <td>3.2796</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>34.5720</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-07</th>\n",
       "      <td>2.3858</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-08</th>\n",
       "      <td>1.5464</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-09</th>\n",
       "      <td>1.0746</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-10</th>\n",
       "      <td>0.8072</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-11</th>\n",
       "      <td>0.6536</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-12</th>\n",
       "      <td>0.5633</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-13</th>\n",
       "      <td>0.5083</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-14</th>\n",
       "      <td>0.4730</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-15</th>\n",
       "      <td>0.4489</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-16</th>\n",
       "      <td>0.4310</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.1968</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-17</th>\n",
       "      <td>0.4167</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0038</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-18</th>\n",
       "      <td>2.2677</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>23.7419</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-19</th>\n",
       "      <td>1.6556</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.6581</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-20</th>\n",
       "      <td>1.1583</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-21</th>\n",
       "      <td>0.8762</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-22</th>\n",
       "      <td>0.7139</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-23</th>\n",
       "      <td>0.6182</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-24</th>\n",
       "      <td>0.5598</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-25</th>\n",
       "      <td>0.5221</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-26</th>\n",
       "      <td>0.4961</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-27</th>\n",
       "      <td>0.4767</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-28</th>\n",
       "      <td>0.4611</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-29</th>\n",
       "      <td>0.4477</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-30</th>\n",
       "      <td>0.4357</td>\n",
       "      <td>3.2992</td>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "            Inflow     PET  Rainfall\n",
       "Date                                \n",
       "1901-01-01  0.1469  3.2992    0.0000\n",
       "1901-01-02  0.1381  3.2992    3.3983\n",
       "1901-01-03  0.5186  3.2992    6.8529\n",
       "1901-01-04  0.8163  3.2992    1.0206\n",
       "1901-01-05  0.7895  3.2992    4.2553\n",
       "1901-01-06  3.2796  3.2992   34.5720\n",
       "1901-01-07  2.3858  3.2992    0.0000\n",
       "1901-01-08  1.5464  3.2992    0.0000\n",
       "1901-01-09  1.0746  3.2992    0.0000\n",
       "1901-01-10  0.8072  3.2992    0.0000\n",
       "1901-01-11  0.6536  3.2992    0.0000\n",
       "1901-01-12  0.5633  3.2992    0.0000\n",
       "1901-01-13  0.5083  3.2992    0.0000\n",
       "1901-01-14  0.4730  3.2992    0.0000\n",
       "1901-01-15  0.4489  3.2992    0.0000\n",
       "1901-01-16  0.4310  3.2992    0.1968\n",
       "1901-01-17  0.4167  3.2992    0.0038\n",
       "1901-01-18  2.2677  3.2992   23.7419\n",
       "1901-01-19  1.6556  3.2992    0.6581\n",
       "1901-01-20  1.1583  3.2992    0.0000\n",
       "1901-01-21  0.8762  3.2992    0.0000\n",
       "1901-01-22  0.7139  3.2992    0.0000\n",
       "1901-01-23  0.6182  3.2992    0.0000\n",
       "1901-01-24  0.5598  3.2992    0.0000\n",
       "1901-01-25  0.5221  3.2992    0.0000\n",
       "1901-01-26  0.4961  3.2992    0.0000\n",
       "1901-01-27  0.4767  3.2992    0.0000\n",
       "1901-01-28  0.4611  3.2992    0.0000\n",
       "1901-01-29  0.4477  3.2992    0.0000\n",
       "1901-01-30  0.4357  3.2992    0.0000"
      ]
     },
     "execution_count": 25,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "forcing_as_df = forcing['Items'].find_one_by_Name('Default Input Set')['Details']\n",
    "forcing_as_df[0:30] # Look at the first 30 time steps"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You can jump to a particular data source item (typically a column from an original file) with `v.data_source_item(source,name)`"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "metadata": {
    "collapsed": false,
    "scrolled": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>Rainfall</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Date</th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>1901-01-01</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-02</th>\n",
       "      <td>3.3983</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-03</th>\n",
       "      <td>6.8529</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-04</th>\n",
       "      <td>1.0206</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-05</th>\n",
       "      <td>4.2553</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-06</th>\n",
       "      <td>34.5720</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-07</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-08</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-09</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-10</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-11</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-12</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-13</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-14</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-15</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-16</th>\n",
       "      <td>0.1968</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-17</th>\n",
       "      <td>0.0038</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-18</th>\n",
       "      <td>23.7419</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-19</th>\n",
       "      <td>0.6581</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-20</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-21</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-22</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-23</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-24</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-25</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-26</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-27</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-28</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-29</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-30</th>\n",
       "      <td>0.0000</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "            Rainfall\n",
       "Date                \n",
       "1901-01-01    0.0000\n",
       "1901-01-02    3.3983\n",
       "1901-01-03    6.8529\n",
       "1901-01-04    1.0206\n",
       "1901-01-05    4.2553\n",
       "1901-01-06   34.5720\n",
       "1901-01-07    0.0000\n",
       "1901-01-08    0.0000\n",
       "1901-01-09    0.0000\n",
       "1901-01-10    0.0000\n",
       "1901-01-11    0.0000\n",
       "1901-01-12    0.0000\n",
       "1901-01-13    0.0000\n",
       "1901-01-14    0.0000\n",
       "1901-01-15    0.0000\n",
       "1901-01-16    0.1968\n",
       "1901-01-17    0.0038\n",
       "1901-01-18   23.7419\n",
       "1901-01-19    0.6581\n",
       "1901-01-20    0.0000\n",
       "1901-01-21    0.0000\n",
       "1901-01-22    0.0000\n",
       "1901-01-23    0.0000\n",
       "1901-01-24    0.0000\n",
       "1901-01-25    0.0000\n",
       "1901-01-26    0.0000\n",
       "1901-01-27    0.0000\n",
       "1901-01-28    0.0000\n",
       "1901-01-29    0.0000\n",
       "1901-01-30    0.0000"
      ]
     },
     "execution_count": 26,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "rainfall = v.data_source_item('ForcingData_csv','Rainfall')\n",
    "rainfall[0:30]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Input Sets\n",
    "\n",
    "Veneer provides access to the scenario input sets - primarily the commands for changing individual model parameters - through `v.input_sets()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[{'Filename': None, 'ReloadOnRun': False, 'Configuration': ['Nodes.Ungauged Inflow.Elevation = 50 m', 'Nodes.Storage.Elevation = 15 m', 'Nodes.MFR.Elevation = 5 m'], 'Name': 'Default Input Set', 'URL': '/inputSets/Default Input Set'}]"
      ]
     },
     "execution_count": 27,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "input_sets = v.input_sets()\n",
    "input_sets"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Within a given input set, the individual commands are available in the `Configuration` property"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "['Nodes.Ungauged Inflow.Elevation = 50 m',\n",
       " 'Nodes.Storage.Elevation = 15 m',\n",
       " 'Nodes.MFR.Elevation = 5 m']"
      ]
     },
     "execution_count": 28,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "input_sets.find_one_by_Name('Default Input Set')['Configuration']"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Input sets are a lot more interesting when you are changing them and applying them from Python..."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Running Models\n",
    "\n",
    "You can run the current scenario, with its current settings (start/end date, input set, run configuration, etc) using `v.run_model()`"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 29,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "(302, 'runs/1')"
      ]
     },
     "execution_count": 29,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "response,run_url = v.run_model()\n",
    "response,run_url"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "After a successful run, veneer-py returns the URL of the new run - this can be used to retrieve an index of all the available results and, from there, the actual time series results"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 30,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'runs/1'"
      ]
     },
     "execution_count": 30,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "run_url"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 31,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'DateRun': '08/01/2017 17:00:31',\n",
       " 'Name': 'Scenario 1 (1)',\n",
       " 'Number': 1,\n",
       " 'Results': [{'RecordingElement': 'Upstream Flow', 'TimeSeriesUrl': '/runs/1/location/Default Link 4/element/Upstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Default Link #4', 'TimeSeriesName': 'Straight-Through Routing: Default Link #4: Upstream Flow'}, {'RecordingElement': 'Catchment Inflow', 'TimeSeriesUrl': '/runs/1/location/Default Link 4/element/Catchment Inflow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Default Link #4', 'TimeSeriesName': 'Straight-Through Routing: Default Link #4: Catchment Inflow'}, {'RecordingElement': 'Downstream Flow', 'TimeSeriesUrl': '/runs/1/location/Default Link 4/element/Downstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Default Link #4', 'TimeSeriesName': 'Straight-Through Routing: Default Link #4: Downstream Flow'}, {'RecordingElement': 'Storage Volume', 'TimeSeriesUrl': '/runs/1/location/Default Link 4/element/Storage Volume/variable/Storage Volume', 'RunNumber': 1, 'RecordingVariable': 'Storage Volume', 'NetworkElement': 'Default Link #4', 'TimeSeriesName': 'Straight-Through Routing: Default Link #4: Storage Volume'}, {'RecordingElement': 'Lateral Flow', 'TimeSeriesUrl': '/runs/1/location/Default Link 4/element/Lateral Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Default Link #4', 'TimeSeriesName': 'Straight-Through Routing: Default Link #4: Lateral Flow'}, {'RecordingElement': 'Upstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/Default Link 4/element/Upstream Flow Volume/variable/Upstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Upstream Flow Volume', 'NetworkElement': 'Default Link #4', 'TimeSeriesName': 'Straight-Through Routing: Default Link #4: Upstream Flow Volume'}, {'RecordingElement': 'Downstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/Default Link 4/element/Downstream Flow Volume/variable/Downstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Downstream Flow Volume', 'NetworkElement': 'Default Link #4', 'TimeSeriesName': 'Straight-Through Routing: Default Link #4: Downstream Flow Volume'}, {'RecordingElement': 'Mass Balance', 'TimeSeriesUrl': '/runs/1/location/Default Link 4/element/Mass Balance/variable/Mass Balance', 'RunNumber': 1, 'RecordingVariable': 'Mass Balance', 'NetworkElement': 'Default Link #4', 'TimeSeriesName': 'Default Link #4: Mass Balance'}, {'RecordingElement': 'Upstream Flow', 'TimeSeriesUrl': '/runs/1/location/SR2/element/Upstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SR2', 'TimeSeriesName': 'Storage Routing: SR2: Upstream Flow'}, {'RecordingElement': 'Catchment Inflow', 'TimeSeriesUrl': '/runs/1/location/SR2/element/Catchment Inflow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SR2', 'TimeSeriesName': 'Storage Routing: SR2: Catchment Inflow'}, {'RecordingElement': 'Downstream Flow', 'TimeSeriesUrl': '/runs/1/location/SR2/element/Downstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SR2', 'TimeSeriesName': 'Storage Routing: SR2: Downstream Flow'}, {'RecordingElement': 'Storage Volume', 'TimeSeriesUrl': '/runs/1/location/SR2/element/Storage Volume/variable/Storage Volume', 'RunNumber': 1, 'RecordingVariable': 'Storage Volume', 'NetworkElement': 'SR2', 'TimeSeriesName': 'Storage Routing: SR2: Storage Volume'}, {'RecordingElement': 'Live Storage Volume', 'TimeSeriesUrl': '/runs/1/location/SR2/element/Live Storage Volume/variable/Live Storage Volume', 'RunNumber': 1, 'RecordingVariable': 'Live Storage Volume', 'NetworkElement': 'SR2', 'TimeSeriesName': 'Storage Routing: SR2: Live Storage Volume'}, {'RecordingElement': 'Time Series Flux', 'TimeSeriesUrl': '/runs/1/location/SR2/element/Time Series Flux/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SR2', 'TimeSeriesName': 'Storage Routing: SR2: Time Series Flux'}, {'RecordingElement': 'Loss / Gain Flux', 'TimeSeriesUrl': '/runs/1/location/SR2/element/Loss %2F Gain Flux/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SR2', 'TimeSeriesName': 'Storage Routing: SR2: Loss / Gain Flux'}, {'RecordingElement': 'Lateral Flow', 'TimeSeriesUrl': '/runs/1/location/SR2/element/Lateral Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SR2', 'TimeSeriesName': 'Storage Routing: SR2: Lateral Flow'}, {'RecordingElement': 'Upstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/SR2/element/Upstream Flow Volume/variable/Upstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Upstream Flow Volume', 'NetworkElement': 'SR2', 'TimeSeriesName': 'Storage Routing: SR2: Upstream Flow Volume'}, {'RecordingElement': 'Downstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/SR2/element/Downstream Flow Volume/variable/Downstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Downstream Flow Volume', 'NetworkElement': 'SR2', 'TimeSeriesName': 'Storage Routing: SR2: Downstream Flow Volume'}, {'RecordingElement': 'Mass Balance', 'TimeSeriesUrl': '/runs/1/location/SR2/element/Mass Balance/variable/Mass Balance', 'RunNumber': 1, 'RecordingVariable': 'Mass Balance', 'NetworkElement': 'SR2', 'TimeSeriesName': 'SR2: Mass Balance'}, {'RecordingElement': 'Upstream Flow', 'TimeSeriesUrl': '/runs/1/location/SR3/element/Upstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SR3', 'TimeSeriesName': 'Storage Routing: SR3: Upstream Flow'}, {'RecordingElement': 'Catchment Inflow', 'TimeSeriesUrl': '/runs/1/location/SR3/element/Catchment Inflow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SR3', 'TimeSeriesName': 'Storage Routing: SR3: Catchment Inflow'}, {'RecordingElement': 'Downstream Flow', 'TimeSeriesUrl': '/runs/1/location/SR3/element/Downstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SR3', 'TimeSeriesName': 'Storage Routing: SR3: Downstream Flow'}, {'RecordingElement': 'Storage Volume', 'TimeSeriesUrl': '/runs/1/location/SR3/element/Storage Volume/variable/Storage Volume', 'RunNumber': 1, 'RecordingVariable': 'Storage Volume', 'NetworkElement': 'SR3', 'TimeSeriesName': 'Storage Routing: SR3: Storage Volume'}, {'RecordingElement': 'Live Storage Volume', 'TimeSeriesUrl': '/runs/1/location/SR3/element/Live Storage Volume/variable/Live Storage Volume', 'RunNumber': 1, 'RecordingVariable': 'Live Storage Volume', 'NetworkElement': 'SR3', 'TimeSeriesName': 'Storage Routing: SR3: Live Storage Volume'}, {'RecordingElement': 'Time Series Flux', 'TimeSeriesUrl': '/runs/1/location/SR3/element/Time Series Flux/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SR3', 'TimeSeriesName': 'Storage Routing: SR3: Time Series Flux'}, {'RecordingElement': 'Loss / Gain Flux', 'TimeSeriesUrl': '/runs/1/location/SR3/element/Loss %2F Gain Flux/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SR3', 'TimeSeriesName': 'Storage Routing: SR3: Loss / Gain Flux'}, {'RecordingElement': 'Lateral Flow', 'TimeSeriesUrl': '/runs/1/location/SR3/element/Lateral Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SR3', 'TimeSeriesName': 'Storage Routing: SR3: Lateral Flow'}, {'RecordingElement': 'Upstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/SR3/element/Upstream Flow Volume/variable/Upstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Upstream Flow Volume', 'NetworkElement': 'SR3', 'TimeSeriesName': 'Storage Routing: SR3: Upstream Flow Volume'}, {'RecordingElement': 'Downstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/SR3/element/Downstream Flow Volume/variable/Downstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Downstream Flow Volume', 'NetworkElement': 'SR3', 'TimeSeriesName': 'Storage Routing: SR3: Downstream Flow Volume'}, {'RecordingElement': 'Mass Balance', 'TimeSeriesUrl': '/runs/1/location/SR3/element/Mass Balance/variable/Mass Balance', 'RunNumber': 1, 'RecordingVariable': 'Mass Balance', 'NetworkElement': 'SR3', 'TimeSeriesName': 'SR3: Mass Balance'}, {'RecordingElement': 'Upstream Flow', 'TimeSeriesUrl': '/runs/1/location/Default Link 5/element/Upstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Default Link #5', 'TimeSeriesName': 'Straight-Through Routing: Default Link #5: Upstream Flow'}, {'RecordingElement': 'Catchment Inflow', 'TimeSeriesUrl': '/runs/1/location/Default Link 5/element/Catchment Inflow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Default Link #5', 'TimeSeriesName': 'Straight-Through Routing: Default Link #5: Catchment Inflow'}, {'RecordingElement': 'Downstream Flow', 'TimeSeriesUrl': '/runs/1/location/Default Link 5/element/Downstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Default Link #5', 'TimeSeriesName': 'Straight-Through Routing: Default Link #5: Downstream Flow'}, {'RecordingElement': 'Storage Volume', 'TimeSeriesUrl': '/runs/1/location/Default Link 5/element/Storage Volume/variable/Storage Volume', 'RunNumber': 1, 'RecordingVariable': 'Storage Volume', 'NetworkElement': 'Default Link #5', 'TimeSeriesName': 'Straight-Through Routing: Default Link #5: Storage Volume'}, {'RecordingElement': 'Lateral Flow', 'TimeSeriesUrl': '/runs/1/location/Default Link 5/element/Lateral Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Default Link #5', 'TimeSeriesName': 'Straight-Through Routing: Default Link #5: Lateral Flow'}, {'RecordingElement': 'Upstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/Default Link 5/element/Upstream Flow Volume/variable/Upstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Upstream Flow Volume', 'NetworkElement': 'Default Link #5', 'TimeSeriesName': 'Straight-Through Routing: Default Link #5: Upstream Flow Volume'}, {'RecordingElement': 'Downstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/Default Link 5/element/Downstream Flow Volume/variable/Downstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Downstream Flow Volume', 'NetworkElement': 'Default Link #5', 'TimeSeriesName': 'Straight-Through Routing: Default Link #5: Downstream Flow Volume'}, {'RecordingElement': 'Mass Balance', 'TimeSeriesUrl': '/runs/1/location/Default Link 5/element/Mass Balance/variable/Mass Balance', 'RunNumber': 1, 'RecordingVariable': 'Mass Balance', 'NetworkElement': 'Default Link #5', 'TimeSeriesName': 'Default Link #5: Mass Balance'}, {'RecordingElement': 'Upstream Flow', 'TimeSeriesUrl': '/runs/1/location/Ungauged Inflow/element/Upstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Ungauged Inflow', 'TimeSeriesName': 'Inflow: Ungauged Inflow: Upstream Flow'}, {'RecordingElement': 'Downstream Flow', 'TimeSeriesUrl': '/runs/1/location/Ungauged Inflow/element/Downstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Ungauged Inflow', 'TimeSeriesName': 'Inflow: Ungauged Inflow: Downstream Flow'}, {'RecordingElement': 'Storage Volume', 'TimeSeriesUrl': '/runs/1/location/Ungauged Inflow/element/Storage Volume/variable/Storage Volume', 'RunNumber': 1, 'RecordingVariable': 'Storage Volume', 'NetworkElement': 'Ungauged Inflow', 'TimeSeriesName': 'Inflow: Ungauged Inflow: Storage Volume'}, {'RecordingElement': 'Upstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/Ungauged Inflow/element/Upstream Flow Volume/variable/Upstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Upstream Flow Volume', 'NetworkElement': 'Ungauged Inflow', 'TimeSeriesName': 'Inflow: Ungauged Inflow: Upstream Flow Volume'}, {'RecordingElement': 'Downstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/Ungauged Inflow/element/Downstream Flow Volume/variable/Downstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Downstream Flow Volume', 'NetworkElement': 'Ungauged Inflow', 'TimeSeriesName': 'Inflow: Ungauged Inflow: Downstream Flow Volume'}, {'RecordingElement': 'Forecast Volume', 'TimeSeriesUrl': '/runs/1/location/Ungauged Inflow/element/Forecast Volume/variable/0', 'RunNumber': 1, 'RecordingVariable': '0', 'NetworkElement': 'Ungauged Inflow', 'TimeSeriesName': 'Inflow: Ungauged Inflow: Forecast Volume: Current time step + 1'}, {'RecordingElement': 'Inflow Volume', 'TimeSeriesUrl': '/runs/1/location/Ungauged Inflow/element/Inflow Volume/variable/Inflow Volume', 'RunNumber': 1, 'RecordingVariable': 'Inflow Volume', 'NetworkElement': 'Ungauged Inflow', 'TimeSeriesName': 'Inflow: Ungauged Inflow: Inflow Volume'}, {'RecordingElement': 'Mass Balance', 'TimeSeriesUrl': '/runs/1/location/Ungauged Inflow/element/Mass Balance/variable/Mass Balance', 'RunNumber': 1, 'RecordingVariable': 'Mass Balance', 'NetworkElement': 'Ungauged Inflow', 'TimeSeriesName': 'Ungauged Inflow: Mass Balance'}, {'RecordingElement': 'Upstream Flow', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Upstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Storage: Upstream Flow'}, {'RecordingElement': 'Downstream Flow', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Downstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Storage: Downstream Flow'}, {'RecordingElement': 'Storage Volume', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Storage Volume/variable/Storage Volume', 'RunNumber': 1, 'RecordingVariable': 'Storage Volume', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Storage: Storage Volume'}, {'RecordingElement': 'Upstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Upstream Flow Volume/variable/Upstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Upstream Flow Volume', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Storage: Upstream Flow Volume'}, {'RecordingElement': 'Downstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Downstream Flow Volume/variable/Downstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Downstream Flow Volume', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Storage: Downstream Flow Volume'}, {'RecordingElement': 'Hydropower', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Hydropower/variable/Hydropower', 'RunNumber': 1, 'RecordingVariable': 'Hydropower', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Total'}, {'RecordingElement': 'Storage Surface Area', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Storage Surface Area/variable/Storage Surface Area', 'RunNumber': 1, 'RecordingVariable': 'Storage Surface Area', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Storage: Storage Surface Area'}, {'RecordingElement': 'Rainfall Volume', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Rainfall Volume/variable/Rainfall Volume', 'RunNumber': 1, 'RecordingVariable': 'Rainfall Volume', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Storage: Rainfall Volume'}, {'RecordingElement': 'Evaporation Volume', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Evaporation Volume/variable/Evaporation Volume', 'RunNumber': 1, 'RecordingVariable': 'Evaporation Volume', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Storage: Evaporation Volume'}, {'RecordingElement': 'Infiltration Volume', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Infiltration Volume/variable/Infiltration Volume', 'RunNumber': 1, 'RecordingVariable': 'Infiltration Volume', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Storage: Infiltration Volume'}, {'RecordingElement': 'Ceded Volume', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Ceded Volume/variable/Ceded Volume', 'RunNumber': 1, 'RecordingVariable': 'Ceded Volume', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Storage: Ceded Volume'}, {'RecordingElement': 'Internal Spill Volume', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Internal Spill Volume/variable/Internal Spill Volume', 'RunNumber': 1, 'RecordingVariable': 'Internal Spill Volume', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Storage: Internal Spill Volume'}, {'RecordingElement': 'External Spill Volume', 'TimeSeriesUrl': '/runs/1/location/Storage/element/External Spill Volume/variable/External Spill Volume', 'RunNumber': 1, 'RecordingVariable': 'External Spill Volume', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Storage: External Spill Volume'}, {'RecordingElement': 'Regulated Release Volume', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Regulated Release Volume/variable/Regulated Release Volume', 'RunNumber': 1, 'RecordingVariable': 'Regulated Release Volume', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Storage: Regulated Release Volume'}, {'RecordingElement': 'Mass Balance', 'TimeSeriesUrl': '/runs/1/location/Storage/element/Mass Balance/variable/Mass Balance', 'RunNumber': 1, 'RecordingVariable': 'Mass Balance', 'NetworkElement': 'Storage', 'TimeSeriesName': 'Storage: Mass Balance'}, {'RecordingElement': 'Upstream Flow', 'TimeSeriesUrl': '/runs/1/location/SP/element/Upstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SP', 'TimeSeriesName': 'Supply Point: SP: Upstream Flow'}, {'RecordingElement': 'Downstream Flow', 'TimeSeriesUrl': '/runs/1/location/SP/element/Downstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'SP', 'TimeSeriesName': 'Supply Point: SP: Downstream Flow'}, {'RecordingElement': 'Storage Volume', 'TimeSeriesUrl': '/runs/1/location/SP/element/Storage Volume/variable/Storage Volume', 'RunNumber': 1, 'RecordingVariable': 'Storage Volume', 'NetworkElement': 'SP', 'TimeSeriesName': 'Supply Point: SP: Storage Volume'}, {'RecordingElement': 'Upstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/SP/element/Upstream Flow Volume/variable/Upstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Upstream Flow Volume', 'NetworkElement': 'SP', 'TimeSeriesName': 'Supply Point: SP: Upstream Flow Volume'}, {'RecordingElement': 'Downstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/SP/element/Downstream Flow Volume/variable/Downstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Downstream Flow Volume', 'NetworkElement': 'SP', 'TimeSeriesName': 'Supply Point: SP: Downstream Flow Volume'}, {'RecordingElement': 'Mass Balance', 'TimeSeriesUrl': '/runs/1/location/SP/element/Mass Balance/variable/Mass Balance', 'RunNumber': 1, 'RecordingVariable': 'Mass Balance', 'NetworkElement': 'SP', 'TimeSeriesName': 'SP: Mass Balance'}, {'RecordingElement': 'Upstream Flow', 'TimeSeriesUrl': '/runs/1/location/MFR/element/Upstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'MFR', 'TimeSeriesName': 'Minimum Flow Requirement: MFR: Upstream Flow'}, {'RecordingElement': 'Downstream Flow', 'TimeSeriesUrl': '/runs/1/location/MFR/element/Downstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'MFR', 'TimeSeriesName': 'Minimum Flow Requirement: MFR: Downstream Flow'}, {'RecordingElement': 'Storage Volume', 'TimeSeriesUrl': '/runs/1/location/MFR/element/Storage Volume/variable/Storage Volume', 'RunNumber': 1, 'RecordingVariable': 'Storage Volume', 'NetworkElement': 'MFR', 'TimeSeriesName': 'Minimum Flow Requirement: MFR: Storage Volume'}, {'RecordingElement': 'Upstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/MFR/element/Upstream Flow Volume/variable/Upstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Upstream Flow Volume', 'NetworkElement': 'MFR', 'TimeSeriesName': 'Minimum Flow Requirement: MFR: Upstream Flow Volume'}, {'RecordingElement': 'Downstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/MFR/element/Downstream Flow Volume/variable/Downstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Downstream Flow Volume', 'NetworkElement': 'MFR', 'TimeSeriesName': 'Minimum Flow Requirement: MFR: Downstream Flow Volume'}, {'RecordingElement': 'Mass Balance', 'TimeSeriesUrl': '/runs/1/location/MFR/element/Mass Balance/variable/Mass Balance', 'RunNumber': 1, 'RecordingVariable': 'Mass Balance', 'NetworkElement': 'MFR', 'TimeSeriesName': 'MFR: Mass Balance'}, {'RecordingElement': 'Upstream Flow', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Upstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User: Water User: Upstream Flow'}, {'RecordingElement': 'Downstream Flow', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Downstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User: Water User: Downstream Flow'}, {'RecordingElement': 'Storage Volume', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Storage Volume/variable/Storage Volume', 'RunNumber': 1, 'RecordingVariable': 'Storage Volume', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User: Water User: Storage Volume'}, {'RecordingElement': 'Upstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Upstream Flow Volume/variable/Upstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Upstream Flow Volume', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User: Water User: Upstream Flow Volume'}, {'RecordingElement': 'Downstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Downstream Flow Volume/variable/Downstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Downstream Flow Volume', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User: Water User: Downstream Flow Volume'}, {'RecordingElement': 'Demand & Storage Interface', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Demand & Storage Interface/variable/Demand & Storage Interface@Demand Model@Regulated Requirements', 'RunNumber': 1, 'RecordingVariable': 'Demand & Storage Interface@Demand Model@Regulated Requirements', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User > Water User > Demand Model > Regulated Requirements: 0'}, {'RecordingElement': 'Demand & Storage Interface', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Demand & Storage Interface/variable/Demand & Storage Interface@Demand Model@Regulated Water Supplied', 'RunNumber': 1, 'RecordingVariable': 'Demand & Storage Interface@Demand Model@Regulated Water Supplied', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User > Water User > Demand Model > Regulated Water Supplied'}, {'RecordingElement': 'Demand Model', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Demand Model/variable/Demand Model@Crops@Crop Type 0@Area', 'RunNumber': 1, 'RecordingVariable': 'Demand Model@Crops@Crop Type #0@Area', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User > Water User > Crops > Crop Type #0 > Area'}, {'RecordingElement': 'Demand Model', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Demand Model/variable/Demand Model@Crops@Crop Type 0@Crop Production', 'RunNumber': 1, 'RecordingVariable': 'Demand Model@Crops@Crop Type #0@Crop Production', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User > Water User > Crops > Crop Type #0 > Crop Production'}, {'RecordingElement': 'Demand Model', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Demand Model/variable/Demand Model@Crops@Crop Type 0@Crop Yield', 'RunNumber': 1, 'RecordingVariable': 'Demand Model@Crops@Crop Type #0@Crop Yield', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User > Water User > Crops > Crop Type #0 > Crop Yield'}, {'RecordingElement': 'Demand Model', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Demand Model/variable/Demand Model@Crops@Crop Type 0@Evapo-Transpiration', 'RunNumber': 1, 'RecordingVariable': 'Demand Model@Crops@Crop Type #0@Evapo-Transpiration', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User > Water User > Crops > Crop Type #0 > Evapo-Transpiration'}, {'RecordingElement': 'Demand Model', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Demand Model/variable/Demand Model@Crops@Crop Type 0@Requirement', 'RunNumber': 1, 'RecordingVariable': 'Demand Model@Crops@Crop Type #0@Requirement', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User > Water User > Crops > Crop Type #0 > Requirement'}, {'RecordingElement': 'Demand Model', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Demand Model/variable/Demand Model@Crops@Crop Type 0@Soil Depletion', 'RunNumber': 1, 'RecordingVariable': 'Demand Model@Crops@Crop Type #0@Soil Depletion', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User > Water User > Crops > Crop Type #0 > Soil Depletion'}, {'RecordingElement': 'Demand Model', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Demand Model/variable/Demand Model@Crops@Crop Type 0@Water Supplied', 'RunNumber': 1, 'RecordingVariable': 'Demand Model@Crops@Crop Type #0@Water Supplied', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User > Water User > Crops > Crop Type #0 > Water Supplied'}, {'RecordingElement': 'Mass Balance', 'TimeSeriesUrl': '/runs/1/location/Water User/element/Mass Balance/variable/Mass Balance', 'RunNumber': 1, 'RecordingVariable': 'Mass Balance', 'NetworkElement': 'Water User', 'TimeSeriesName': 'Water User: Mass Balance'}, {'RecordingElement': 'Upstream Flow', 'TimeSeriesUrl': '/runs/1/location/End Of System/element/Upstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'End Of System', 'TimeSeriesName': 'Gauge: End Of System: Upstream Flow'}, {'RecordingElement': 'Downstream Flow', 'TimeSeriesUrl': '/runs/1/location/End Of System/element/Downstream Flow/variable/Flow', 'RunNumber': 1, 'RecordingVariable': 'Flow', 'NetworkElement': 'End Of System', 'TimeSeriesName': 'Gauge: End Of System: Downstream Flow'}, {'RecordingElement': 'Storage Volume', 'TimeSeriesUrl': '/runs/1/location/End Of System/element/Storage Volume/variable/Storage Volume', 'RunNumber': 1, 'RecordingVariable': 'Storage Volume', 'NetworkElement': 'End Of System', 'TimeSeriesName': 'Gauge: End Of System: Storage Volume'}, {'RecordingElement': 'Upstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/End Of System/element/Upstream Flow Volume/variable/Upstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Upstream Flow Volume', 'NetworkElement': 'End Of System', 'TimeSeriesName': 'Gauge: End Of System: Upstream Flow Volume'}, {'RecordingElement': 'Downstream Flow Volume', 'TimeSeriesUrl': '/runs/1/location/End Of System/element/Downstream Flow Volume/variable/Downstream Flow Volume', 'RunNumber': 1, 'RecordingVariable': 'Downstream Flow Volume', 'NetworkElement': 'End Of System', 'TimeSeriesName': 'Gauge: End Of System: Downstream Flow Volume'}, {'RecordingElement': 'Mass Balance', 'TimeSeriesUrl': '/runs/1/location/End Of System/element/Mass Balance/variable/Mass Balance', 'RunNumber': 1, 'RecordingVariable': 'Mass Balance', 'NetworkElement': 'End Of System', 'TimeSeriesName': 'End Of System: Mass Balance'}, {'RecordingElement': 'Scenario Mass Balance', 'TimeSeriesUrl': '/runs/1/location/Scenario Mass Balance/element/Scenario Mass Balance/variable/Scenario Mass Balance', 'RunNumber': 1, 'RecordingVariable': 'Scenario Mass Balance', 'NetworkElement': 'Scenario Mass Balance', 'TimeSeriesName': 'Scenario Mass Balance Total'}],\n",
       " 'Scenario': 'Scenario 1',\n",
       " 'Status': 'LogWarning'}"
      ]
     },
     "execution_count": 31,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "index = v.retrieve_run(run_url)\n",
    "index"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This index lists all of the time series (under `['Results']`) and can be used to retrieve individual time series, or collections of time series"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 32,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>NetworkElement</th>\n",
       "      <th>RecordingElement</th>\n",
       "      <th>RecordingVariable</th>\n",
       "      <th>RunNumber</th>\n",
       "      <th>TimeSeriesName</th>\n",
       "      <th>TimeSeriesUrl</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>Default Link #4</td>\n",
       "      <td>Upstream Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Straight-Through Routing: Default Link #4: Ups...</td>\n",
       "      <td>/runs/1/location/Default Link 4/element/Upstre...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>Default Link #4</td>\n",
       "      <td>Catchment Inflow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Straight-Through Routing: Default Link #4: Cat...</td>\n",
       "      <td>/runs/1/location/Default Link 4/element/Catchm...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>Default Link #4</td>\n",
       "      <td>Downstream Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Straight-Through Routing: Default Link #4: Dow...</td>\n",
       "      <td>/runs/1/location/Default Link 4/element/Downst...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>Default Link #4</td>\n",
       "      <td>Storage Volume</td>\n",
       "      <td>Storage Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Straight-Through Routing: Default Link #4: Sto...</td>\n",
       "      <td>/runs/1/location/Default Link 4/element/Storag...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>Default Link #4</td>\n",
       "      <td>Lateral Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Straight-Through Routing: Default Link #4: Lat...</td>\n",
       "      <td>/runs/1/location/Default Link 4/element/Latera...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>5</th>\n",
       "      <td>Default Link #4</td>\n",
       "      <td>Upstream Flow Volume</td>\n",
       "      <td>Upstream Flow Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Straight-Through Routing: Default Link #4: Ups...</td>\n",
       "      <td>/runs/1/location/Default Link 4/element/Upstre...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>6</th>\n",
       "      <td>Default Link #4</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Straight-Through Routing: Default Link #4: Dow...</td>\n",
       "      <td>/runs/1/location/Default Link 4/element/Downst...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>7</th>\n",
       "      <td>Default Link #4</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>1</td>\n",
       "      <td>Default Link #4: Mass Balance</td>\n",
       "      <td>/runs/1/location/Default Link 4/element/Mass B...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>8</th>\n",
       "      <td>SR2</td>\n",
       "      <td>Upstream Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR2: Upstream Flow</td>\n",
       "      <td>/runs/1/location/SR2/element/Upstream Flow/var...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>9</th>\n",
       "      <td>SR2</td>\n",
       "      <td>Catchment Inflow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR2: Catchment Inflow</td>\n",
       "      <td>/runs/1/location/SR2/element/Catchment Inflow/...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>10</th>\n",
       "      <td>SR2</td>\n",
       "      <td>Downstream Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR2: Downstream Flow</td>\n",
       "      <td>/runs/1/location/SR2/element/Downstream Flow/v...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>11</th>\n",
       "      <td>SR2</td>\n",
       "      <td>Storage Volume</td>\n",
       "      <td>Storage Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR2: Storage Volume</td>\n",
       "      <td>/runs/1/location/SR2/element/Storage Volume/va...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>12</th>\n",
       "      <td>SR2</td>\n",
       "      <td>Live Storage Volume</td>\n",
       "      <td>Live Storage Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR2: Live Storage Volume</td>\n",
       "      <td>/runs/1/location/SR2/element/Live Storage Volu...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>13</th>\n",
       "      <td>SR2</td>\n",
       "      <td>Time Series Flux</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR2: Time Series Flux</td>\n",
       "      <td>/runs/1/location/SR2/element/Time Series Flux/...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>14</th>\n",
       "      <td>SR2</td>\n",
       "      <td>Loss / Gain Flux</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR2: Loss / Gain Flux</td>\n",
       "      <td>/runs/1/location/SR2/element/Loss %2F Gain Flu...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>15</th>\n",
       "      <td>SR2</td>\n",
       "      <td>Lateral Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR2: Lateral Flow</td>\n",
       "      <td>/runs/1/location/SR2/element/Lateral Flow/vari...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>16</th>\n",
       "      <td>SR2</td>\n",
       "      <td>Upstream Flow Volume</td>\n",
       "      <td>Upstream Flow Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR2: Upstream Flow Volume</td>\n",
       "      <td>/runs/1/location/SR2/element/Upstream Flow Vol...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>17</th>\n",
       "      <td>SR2</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR2: Downstream Flow Volume</td>\n",
       "      <td>/runs/1/location/SR2/element/Downstream Flow V...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>18</th>\n",
       "      <td>SR2</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>1</td>\n",
       "      <td>SR2: Mass Balance</td>\n",
       "      <td>/runs/1/location/SR2/element/Mass Balance/vari...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>19</th>\n",
       "      <td>SR3</td>\n",
       "      <td>Upstream Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR3: Upstream Flow</td>\n",
       "      <td>/runs/1/location/SR3/element/Upstream Flow/var...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>20</th>\n",
       "      <td>SR3</td>\n",
       "      <td>Catchment Inflow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR3: Catchment Inflow</td>\n",
       "      <td>/runs/1/location/SR3/element/Catchment Inflow/...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>21</th>\n",
       "      <td>SR3</td>\n",
       "      <td>Downstream Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR3: Downstream Flow</td>\n",
       "      <td>/runs/1/location/SR3/element/Downstream Flow/v...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>22</th>\n",
       "      <td>SR3</td>\n",
       "      <td>Storage Volume</td>\n",
       "      <td>Storage Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR3: Storage Volume</td>\n",
       "      <td>/runs/1/location/SR3/element/Storage Volume/va...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>23</th>\n",
       "      <td>SR3</td>\n",
       "      <td>Live Storage Volume</td>\n",
       "      <td>Live Storage Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR3: Live Storage Volume</td>\n",
       "      <td>/runs/1/location/SR3/element/Live Storage Volu...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>24</th>\n",
       "      <td>SR3</td>\n",
       "      <td>Time Series Flux</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR3: Time Series Flux</td>\n",
       "      <td>/runs/1/location/SR3/element/Time Series Flux/...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>25</th>\n",
       "      <td>SR3</td>\n",
       "      <td>Loss / Gain Flux</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR3: Loss / Gain Flux</td>\n",
       "      <td>/runs/1/location/SR3/element/Loss %2F Gain Flu...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>26</th>\n",
       "      <td>SR3</td>\n",
       "      <td>Lateral Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR3: Lateral Flow</td>\n",
       "      <td>/runs/1/location/SR3/element/Lateral Flow/vari...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>27</th>\n",
       "      <td>SR3</td>\n",
       "      <td>Upstream Flow Volume</td>\n",
       "      <td>Upstream Flow Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR3: Upstream Flow Volume</td>\n",
       "      <td>/runs/1/location/SR3/element/Upstream Flow Vol...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>28</th>\n",
       "      <td>SR3</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Storage Routing: SR3: Downstream Flow Volume</td>\n",
       "      <td>/runs/1/location/SR3/element/Downstream Flow V...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>29</th>\n",
       "      <td>SR3</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>1</td>\n",
       "      <td>SR3: Mass Balance</td>\n",
       "      <td>/runs/1/location/SR3/element/Mass Balance/vari...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>...</th>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>65</th>\n",
       "      <td>SP</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Supply Point: SP: Downstream Flow Volume</td>\n",
       "      <td>/runs/1/location/SP/element/Downstream Flow Vo...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>66</th>\n",
       "      <td>SP</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>1</td>\n",
       "      <td>SP: Mass Balance</td>\n",
       "      <td>/runs/1/location/SP/element/Mass Balance/varia...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>67</th>\n",
       "      <td>MFR</td>\n",
       "      <td>Upstream Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Minimum Flow Requirement: MFR: Upstream Flow</td>\n",
       "      <td>/runs/1/location/MFR/element/Upstream Flow/var...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>68</th>\n",
       "      <td>MFR</td>\n",
       "      <td>Downstream Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Minimum Flow Requirement: MFR: Downstream Flow</td>\n",
       "      <td>/runs/1/location/MFR/element/Downstream Flow/v...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>69</th>\n",
       "      <td>MFR</td>\n",
       "      <td>Storage Volume</td>\n",
       "      <td>Storage Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Minimum Flow Requirement: MFR: Storage Volume</td>\n",
       "      <td>/runs/1/location/MFR/element/Storage Volume/va...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>70</th>\n",
       "      <td>MFR</td>\n",
       "      <td>Upstream Flow Volume</td>\n",
       "      <td>Upstream Flow Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Minimum Flow Requirement: MFR: Upstream Flow V...</td>\n",
       "      <td>/runs/1/location/MFR/element/Upstream Flow Vol...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>71</th>\n",
       "      <td>MFR</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Minimum Flow Requirement: MFR: Downstream Flow...</td>\n",
       "      <td>/runs/1/location/MFR/element/Downstream Flow V...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>72</th>\n",
       "      <td>MFR</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>1</td>\n",
       "      <td>MFR: Mass Balance</td>\n",
       "      <td>/runs/1/location/MFR/element/Mass Balance/vari...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>73</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Upstream Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User: Water User: Upstream Flow</td>\n",
       "      <td>/runs/1/location/Water User/element/Upstream F...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>74</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Downstream Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User: Water User: Downstream Flow</td>\n",
       "      <td>/runs/1/location/Water User/element/Downstream...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>75</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Storage Volume</td>\n",
       "      <td>Storage Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User: Water User: Storage Volume</td>\n",
       "      <td>/runs/1/location/Water User/element/Storage Vo...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>76</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Upstream Flow Volume</td>\n",
       "      <td>Upstream Flow Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User: Water User: Upstream Flow Volume</td>\n",
       "      <td>/runs/1/location/Water User/element/Upstream F...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>77</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User: Water User: Downstream Flow Volume</td>\n",
       "      <td>/runs/1/location/Water User/element/Downstream...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>78</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Demand &amp; Storage Interface</td>\n",
       "      <td>Demand &amp; Storage Interface@Demand Model@Regula...</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User &gt; Water User &gt; Demand Model &gt; Regul...</td>\n",
       "      <td>/runs/1/location/Water User/element/Demand &amp; S...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>79</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Demand &amp; Storage Interface</td>\n",
       "      <td>Demand &amp; Storage Interface@Demand Model@Regula...</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User &gt; Water User &gt; Demand Model &gt; Regul...</td>\n",
       "      <td>/runs/1/location/Water User/element/Demand &amp; S...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>80</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Demand Model</td>\n",
       "      <td>Demand Model@Crops@Crop Type #0@Area</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User &gt; Water User &gt; Crops &gt; Crop Type #0...</td>\n",
       "      <td>/runs/1/location/Water User/element/Demand Mod...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>81</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Demand Model</td>\n",
       "      <td>Demand Model@Crops@Crop Type #0@Crop Production</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User &gt; Water User &gt; Crops &gt; Crop Type #0...</td>\n",
       "      <td>/runs/1/location/Water User/element/Demand Mod...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>82</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Demand Model</td>\n",
       "      <td>Demand Model@Crops@Crop Type #0@Crop Yield</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User &gt; Water User &gt; Crops &gt; Crop Type #0...</td>\n",
       "      <td>/runs/1/location/Water User/element/Demand Mod...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>83</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Demand Model</td>\n",
       "      <td>Demand Model@Crops@Crop Type #0@Evapo-Transpir...</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User &gt; Water User &gt; Crops &gt; Crop Type #0...</td>\n",
       "      <td>/runs/1/location/Water User/element/Demand Mod...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>84</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Demand Model</td>\n",
       "      <td>Demand Model@Crops@Crop Type #0@Requirement</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User &gt; Water User &gt; Crops &gt; Crop Type #0...</td>\n",
       "      <td>/runs/1/location/Water User/element/Demand Mod...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>85</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Demand Model</td>\n",
       "      <td>Demand Model@Crops@Crop Type #0@Soil Depletion</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User &gt; Water User &gt; Crops &gt; Crop Type #0...</td>\n",
       "      <td>/runs/1/location/Water User/element/Demand Mod...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>86</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Demand Model</td>\n",
       "      <td>Demand Model@Crops@Crop Type #0@Water Supplied</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User &gt; Water User &gt; Crops &gt; Crop Type #0...</td>\n",
       "      <td>/runs/1/location/Water User/element/Demand Mod...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>87</th>\n",
       "      <td>Water User</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>1</td>\n",
       "      <td>Water User: Mass Balance</td>\n",
       "      <td>/runs/1/location/Water User/element/Mass Balan...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>88</th>\n",
       "      <td>End Of System</td>\n",
       "      <td>Upstream Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Gauge: End Of System: Upstream Flow</td>\n",
       "      <td>/runs/1/location/End Of System/element/Upstrea...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>89</th>\n",
       "      <td>End Of System</td>\n",
       "      <td>Downstream Flow</td>\n",
       "      <td>Flow</td>\n",
       "      <td>1</td>\n",
       "      <td>Gauge: End Of System: Downstream Flow</td>\n",
       "      <td>/runs/1/location/End Of System/element/Downstr...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>90</th>\n",
       "      <td>End Of System</td>\n",
       "      <td>Storage Volume</td>\n",
       "      <td>Storage Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Gauge: End Of System: Storage Volume</td>\n",
       "      <td>/runs/1/location/End Of System/element/Storage...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>91</th>\n",
       "      <td>End Of System</td>\n",
       "      <td>Upstream Flow Volume</td>\n",
       "      <td>Upstream Flow Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Gauge: End Of System: Upstream Flow Volume</td>\n",
       "      <td>/runs/1/location/End Of System/element/Upstrea...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>92</th>\n",
       "      <td>End Of System</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>Downstream Flow Volume</td>\n",
       "      <td>1</td>\n",
       "      <td>Gauge: End Of System: Downstream Flow Volume</td>\n",
       "      <td>/runs/1/location/End Of System/element/Downstr...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>93</th>\n",
       "      <td>End Of System</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>Mass Balance</td>\n",
       "      <td>1</td>\n",
       "      <td>End Of System: Mass Balance</td>\n",
       "      <td>/runs/1/location/End Of System/element/Mass Ba...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>94</th>\n",
       "      <td>Scenario Mass Balance</td>\n",
       "      <td>Scenario Mass Balance</td>\n",
       "      <td>Scenario Mass Balance</td>\n",
       "      <td>1</td>\n",
       "      <td>Scenario Mass Balance Total</td>\n",
       "      <td>/runs/1/location/Scenario Mass Balance/element...</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "<p>95 rows × 6 columns</p>\n",
       "</div>"
      ],
      "text/plain": [
       "           NetworkElement            RecordingElement  \\\n",
       "0         Default Link #4               Upstream Flow   \n",
       "1         Default Link #4            Catchment Inflow   \n",
       "2         Default Link #4             Downstream Flow   \n",
       "3         Default Link #4              Storage Volume   \n",
       "4         Default Link #4                Lateral Flow   \n",
       "5         Default Link #4        Upstream Flow Volume   \n",
       "6         Default Link #4      Downstream Flow Volume   \n",
       "7         Default Link #4                Mass Balance   \n",
       "8                     SR2               Upstream Flow   \n",
       "9                     SR2            Catchment Inflow   \n",
       "10                    SR2             Downstream Flow   \n",
       "11                    SR2              Storage Volume   \n",
       "12                    SR2         Live Storage Volume   \n",
       "13                    SR2            Time Series Flux   \n",
       "14                    SR2            Loss / Gain Flux   \n",
       "15                    SR2                Lateral Flow   \n",
       "16                    SR2        Upstream Flow Volume   \n",
       "17                    SR2      Downstream Flow Volume   \n",
       "18                    SR2                Mass Balance   \n",
       "19                    SR3               Upstream Flow   \n",
       "20                    SR3            Catchment Inflow   \n",
       "21                    SR3             Downstream Flow   \n",
       "22                    SR3              Storage Volume   \n",
       "23                    SR3         Live Storage Volume   \n",
       "24                    SR3            Time Series Flux   \n",
       "25                    SR3            Loss / Gain Flux   \n",
       "26                    SR3                Lateral Flow   \n",
       "27                    SR3        Upstream Flow Volume   \n",
       "28                    SR3      Downstream Flow Volume   \n",
       "29                    SR3                Mass Balance   \n",
       "..                    ...                         ...   \n",
       "65                     SP      Downstream Flow Volume   \n",
       "66                     SP                Mass Balance   \n",
       "67                    MFR               Upstream Flow   \n",
       "68                    MFR             Downstream Flow   \n",
       "69                    MFR              Storage Volume   \n",
       "70                    MFR        Upstream Flow Volume   \n",
       "71                    MFR      Downstream Flow Volume   \n",
       "72                    MFR                Mass Balance   \n",
       "73             Water User               Upstream Flow   \n",
       "74             Water User             Downstream Flow   \n",
       "75             Water User              Storage Volume   \n",
       "76             Water User        Upstream Flow Volume   \n",
       "77             Water User      Downstream Flow Volume   \n",
       "78             Water User  Demand & Storage Interface   \n",
       "79             Water User  Demand & Storage Interface   \n",
       "80             Water User                Demand Model   \n",
       "81             Water User                Demand Model   \n",
       "82             Water User                Demand Model   \n",
       "83             Water User                Demand Model   \n",
       "84             Water User                Demand Model   \n",
       "85             Water User                Demand Model   \n",
       "86             Water User                Demand Model   \n",
       "87             Water User                Mass Balance   \n",
       "88          End Of System               Upstream Flow   \n",
       "89          End Of System             Downstream Flow   \n",
       "90          End Of System              Storage Volume   \n",
       "91          End Of System        Upstream Flow Volume   \n",
       "92          End Of System      Downstream Flow Volume   \n",
       "93          End Of System                Mass Balance   \n",
       "94  Scenario Mass Balance       Scenario Mass Balance   \n",
       "\n",
       "                                    RecordingVariable  RunNumber  \\\n",
       "0                                                Flow          1   \n",
       "1                                                Flow          1   \n",
       "2                                                Flow          1   \n",
       "3                                      Storage Volume          1   \n",
       "4                                                Flow          1   \n",
       "5                                Upstream Flow Volume          1   \n",
       "6                              Downstream Flow Volume          1   \n",
       "7                                        Mass Balance          1   \n",
       "8                                                Flow          1   \n",
       "9                                                Flow          1   \n",
       "10                                               Flow          1   \n",
       "11                                     Storage Volume          1   \n",
       "12                                Live Storage Volume          1   \n",
       "13                                               Flow          1   \n",
       "14                                               Flow          1   \n",
       "15                                               Flow          1   \n",
       "16                               Upstream Flow Volume          1   \n",
       "17                             Downstream Flow Volume          1   \n",
       "18                                       Mass Balance          1   \n",
       "19                                               Flow          1   \n",
       "20                                               Flow          1   \n",
       "21                                               Flow          1   \n",
       "22                                     Storage Volume          1   \n",
       "23                                Live Storage Volume          1   \n",
       "24                                               Flow          1   \n",
       "25                                               Flow          1   \n",
       "26                                               Flow          1   \n",
       "27                               Upstream Flow Volume          1   \n",
       "28                             Downstream Flow Volume          1   \n",
       "29                                       Mass Balance          1   \n",
       "..                                                ...        ...   \n",
       "65                             Downstream Flow Volume          1   \n",
       "66                                       Mass Balance          1   \n",
       "67                                               Flow          1   \n",
       "68                                               Flow          1   \n",
       "69                                     Storage Volume          1   \n",
       "70                               Upstream Flow Volume          1   \n",
       "71                             Downstream Flow Volume          1   \n",
       "72                                       Mass Balance          1   \n",
       "73                                               Flow          1   \n",
       "74                                               Flow          1   \n",
       "75                                     Storage Volume          1   \n",
       "76                               Upstream Flow Volume          1   \n",
       "77                             Downstream Flow Volume          1   \n",
       "78  Demand & Storage Interface@Demand Model@Regula...          1   \n",
       "79  Demand & Storage Interface@Demand Model@Regula...          1   \n",
       "80               Demand Model@Crops@Crop Type #0@Area          1   \n",
       "81    Demand Model@Crops@Crop Type #0@Crop Production          1   \n",
       "82         Demand Model@Crops@Crop Type #0@Crop Yield          1   \n",
       "83  Demand Model@Crops@Crop Type #0@Evapo-Transpir...          1   \n",
       "84        Demand Model@Crops@Crop Type #0@Requirement          1   \n",
       "85     Demand Model@Crops@Crop Type #0@Soil Depletion          1   \n",
       "86     Demand Model@Crops@Crop Type #0@Water Supplied          1   \n",
       "87                                       Mass Balance          1   \n",
       "88                                               Flow          1   \n",
       "89                                               Flow          1   \n",
       "90                                     Storage Volume          1   \n",
       "91                               Upstream Flow Volume          1   \n",
       "92                             Downstream Flow Volume          1   \n",
       "93                                       Mass Balance          1   \n",
       "94                              Scenario Mass Balance          1   \n",
       "\n",
       "                                       TimeSeriesName  \\\n",
       "0   Straight-Through Routing: Default Link #4: Ups...   \n",
       "1   Straight-Through Routing: Default Link #4: Cat...   \n",
       "2   Straight-Through Routing: Default Link #4: Dow...   \n",
       "3   Straight-Through Routing: Default Link #4: Sto...   \n",
       "4   Straight-Through Routing: Default Link #4: Lat...   \n",
       "5   Straight-Through Routing: Default Link #4: Ups...   \n",
       "6   Straight-Through Routing: Default Link #4: Dow...   \n",
       "7                       Default Link #4: Mass Balance   \n",
       "8                 Storage Routing: SR2: Upstream Flow   \n",
       "9              Storage Routing: SR2: Catchment Inflow   \n",
       "10              Storage Routing: SR2: Downstream Flow   \n",
       "11               Storage Routing: SR2: Storage Volume   \n",
       "12          Storage Routing: SR2: Live Storage Volume   \n",
       "13             Storage Routing: SR2: Time Series Flux   \n",
       "14             Storage Routing: SR2: Loss / Gain Flux   \n",
       "15                 Storage Routing: SR2: Lateral Flow   \n",
       "16         Storage Routing: SR2: Upstream Flow Volume   \n",
       "17       Storage Routing: SR2: Downstream Flow Volume   \n",
       "18                                  SR2: Mass Balance   \n",
       "19                Storage Routing: SR3: Upstream Flow   \n",
       "20             Storage Routing: SR3: Catchment Inflow   \n",
       "21              Storage Routing: SR3: Downstream Flow   \n",
       "22               Storage Routing: SR3: Storage Volume   \n",
       "23          Storage Routing: SR3: Live Storage Volume   \n",
       "24             Storage Routing: SR3: Time Series Flux   \n",
       "25             Storage Routing: SR3: Loss / Gain Flux   \n",
       "26                 Storage Routing: SR3: Lateral Flow   \n",
       "27         Storage Routing: SR3: Upstream Flow Volume   \n",
       "28       Storage Routing: SR3: Downstream Flow Volume   \n",
       "29                                  SR3: Mass Balance   \n",
       "..                                                ...   \n",
       "65           Supply Point: SP: Downstream Flow Volume   \n",
       "66                                   SP: Mass Balance   \n",
       "67       Minimum Flow Requirement: MFR: Upstream Flow   \n",
       "68     Minimum Flow Requirement: MFR: Downstream Flow   \n",
       "69      Minimum Flow Requirement: MFR: Storage Volume   \n",
       "70  Minimum Flow Requirement: MFR: Upstream Flow V...   \n",
       "71  Minimum Flow Requirement: MFR: Downstream Flow...   \n",
       "72                                  MFR: Mass Balance   \n",
       "73              Water User: Water User: Upstream Flow   \n",
       "74            Water User: Water User: Downstream Flow   \n",
       "75             Water User: Water User: Storage Volume   \n",
       "76       Water User: Water User: Upstream Flow Volume   \n",
       "77     Water User: Water User: Downstream Flow Volume   \n",
       "78  Water User > Water User > Demand Model > Regul...   \n",
       "79  Water User > Water User > Demand Model > Regul...   \n",
       "80  Water User > Water User > Crops > Crop Type #0...   \n",
       "81  Water User > Water User > Crops > Crop Type #0...   \n",
       "82  Water User > Water User > Crops > Crop Type #0...   \n",
       "83  Water User > Water User > Crops > Crop Type #0...   \n",
       "84  Water User > Water User > Crops > Crop Type #0...   \n",
       "85  Water User > Water User > Crops > Crop Type #0...   \n",
       "86  Water User > Water User > Crops > Crop Type #0...   \n",
       "87                           Water User: Mass Balance   \n",
       "88                Gauge: End Of System: Upstream Flow   \n",
       "89              Gauge: End Of System: Downstream Flow   \n",
       "90               Gauge: End Of System: Storage Volume   \n",
       "91         Gauge: End Of System: Upstream Flow Volume   \n",
       "92       Gauge: End Of System: Downstream Flow Volume   \n",
       "93                        End Of System: Mass Balance   \n",
       "94                        Scenario Mass Balance Total   \n",
       "\n",
       "                                        TimeSeriesUrl  \n",
       "0   /runs/1/location/Default Link 4/element/Upstre...  \n",
       "1   /runs/1/location/Default Link 4/element/Catchm...  \n",
       "2   /runs/1/location/Default Link 4/element/Downst...  \n",
       "3   /runs/1/location/Default Link 4/element/Storag...  \n",
       "4   /runs/1/location/Default Link 4/element/Latera...  \n",
       "5   /runs/1/location/Default Link 4/element/Upstre...  \n",
       "6   /runs/1/location/Default Link 4/element/Downst...  \n",
       "7   /runs/1/location/Default Link 4/element/Mass B...  \n",
       "8   /runs/1/location/SR2/element/Upstream Flow/var...  \n",
       "9   /runs/1/location/SR2/element/Catchment Inflow/...  \n",
       "10  /runs/1/location/SR2/element/Downstream Flow/v...  \n",
       "11  /runs/1/location/SR2/element/Storage Volume/va...  \n",
       "12  /runs/1/location/SR2/element/Live Storage Volu...  \n",
       "13  /runs/1/location/SR2/element/Time Series Flux/...  \n",
       "14  /runs/1/location/SR2/element/Loss %2F Gain Flu...  \n",
       "15  /runs/1/location/SR2/element/Lateral Flow/vari...  \n",
       "16  /runs/1/location/SR2/element/Upstream Flow Vol...  \n",
       "17  /runs/1/location/SR2/element/Downstream Flow V...  \n",
       "18  /runs/1/location/SR2/element/Mass Balance/vari...  \n",
       "19  /runs/1/location/SR3/element/Upstream Flow/var...  \n",
       "20  /runs/1/location/SR3/element/Catchment Inflow/...  \n",
       "21  /runs/1/location/SR3/element/Downstream Flow/v...  \n",
       "22  /runs/1/location/SR3/element/Storage Volume/va...  \n",
       "23  /runs/1/location/SR3/element/Live Storage Volu...  \n",
       "24  /runs/1/location/SR3/element/Time Series Flux/...  \n",
       "25  /runs/1/location/SR3/element/Loss %2F Gain Flu...  \n",
       "26  /runs/1/location/SR3/element/Lateral Flow/vari...  \n",
       "27  /runs/1/location/SR3/element/Upstream Flow Vol...  \n",
       "28  /runs/1/location/SR3/element/Downstream Flow V...  \n",
       "29  /runs/1/location/SR3/element/Mass Balance/vari...  \n",
       "..                                                ...  \n",
       "65  /runs/1/location/SP/element/Downstream Flow Vo...  \n",
       "66  /runs/1/location/SP/element/Mass Balance/varia...  \n",
       "67  /runs/1/location/MFR/element/Upstream Flow/var...  \n",
       "68  /runs/1/location/MFR/element/Downstream Flow/v...  \n",
       "69  /runs/1/location/MFR/element/Storage Volume/va...  \n",
       "70  /runs/1/location/MFR/element/Upstream Flow Vol...  \n",
       "71  /runs/1/location/MFR/element/Downstream Flow V...  \n",
       "72  /runs/1/location/MFR/element/Mass Balance/vari...  \n",
       "73  /runs/1/location/Water User/element/Upstream F...  \n",
       "74  /runs/1/location/Water User/element/Downstream...  \n",
       "75  /runs/1/location/Water User/element/Storage Vo...  \n",
       "76  /runs/1/location/Water User/element/Upstream F...  \n",
       "77  /runs/1/location/Water User/element/Downstream...  \n",
       "78  /runs/1/location/Water User/element/Demand & S...  \n",
       "79  /runs/1/location/Water User/element/Demand & S...  \n",
       "80  /runs/1/location/Water User/element/Demand Mod...  \n",
       "81  /runs/1/location/Water User/element/Demand Mod...  \n",
       "82  /runs/1/location/Water User/element/Demand Mod...  \n",
       "83  /runs/1/location/Water User/element/Demand Mod...  \n",
       "84  /runs/1/location/Water User/element/Demand Mod...  \n",
       "85  /runs/1/location/Water User/element/Demand Mod...  \n",
       "86  /runs/1/location/Water User/element/Demand Mod...  \n",
       "87  /runs/1/location/Water User/element/Mass Balan...  \n",
       "88  /runs/1/location/End Of System/element/Upstrea...  \n",
       "89  /runs/1/location/End Of System/element/Downstr...  \n",
       "90  /runs/1/location/End Of System/element/Storage...  \n",
       "91  /runs/1/location/End Of System/element/Upstrea...  \n",
       "92  /runs/1/location/End Of System/element/Downstr...  \n",
       "93  /runs/1/location/End Of System/element/Mass Ba...  \n",
       "94  /runs/1/location/Scenario Mass Balance/element...  \n",
       "\n",
       "[95 rows x 6 columns]"
      ]
     },
     "execution_count": 32,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "index['Results'].as_dataframe()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The easiest way to retrieve time series results is with `v.retrieve_multiple_time_series`, which takes a set of run results, some search criteria by which it identifies wanted time series. There are also options for retrieve aggregated data and the ability to rename time series as they are retrieved.\n",
    "\n",
    "The help text for `retrieve_multiple_time_series` describes the options"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 33,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Help on method retrieve_multiple_time_series in module veneer.general:\n",
      "\n",
      "retrieve_multiple_time_series(run='latest', run_data=None, criteria={}, timestep='daily', name_fn=<function name_element_variable at 0x0000000008596A60>) method of veneer.general.Veneer instance\n",
      "    Retrieve multiple time series from a run according to some criteria.\n",
      "    \n",
      "    Return all time series in a single Pandas DataFrame with date time index.\n",
      "    \n",
      "    you can an index of run results via run_data. If you don't the method will first retrieve an\n",
      "    index based on the value of the run parameter (default='latest')\n",
      "    \n",
      "    criteria should be regexps for the fields in a Veneer time series record:\n",
      "      * NetworkElement\n",
      "      * RecordingElement\n",
      "      * RecordingVariable\n",
      "      * TimeSeriesName\n",
      "      * TimeSeriesUrl\n",
      "    \n",
      "    These criteria are used to identify which time series to retrieve.\n",
      "    \n",
      "    timestep should be one of 'daily' (default), 'monthly', 'annual'\n",
      "    \n",
      "    All retrieved time series are returned in a single Data Frame.\n",
      "    \n",
      "    You can specify a function for naming the columns of the Data Frame using name_fn. This function should take\n",
      "    the results summary (from the index) and return a string. Example functions include:\n",
      "      * veneer.name_time_series (uses the full name of the time series, as provided by Source)\n",
      "      * veneer.name_element_variable (DEFAULT: users the name of the network element and the name of the variable)\n",
      "      * veneer.name_for_location (just use the name of the network element)\n",
      "      * veneer.name_for_variable (just use the name of the variable)\n",
      "\n"
     ]
    }
   ],
   "source": [
    "help(v.retrieve_multiple_time_series)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The following examples retrieve data from the latest run, using the `index` index we saved, earlier:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 34,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>Default Link #4</th>\n",
       "      <th>Default Link #5</th>\n",
       "      <th>End Of System</th>\n",
       "      <th>MFR</th>\n",
       "      <th>SP</th>\n",
       "      <th>SR2</th>\n",
       "      <th>SR3</th>\n",
       "      <th>Storage</th>\n",
       "      <th>Ungauged Inflow</th>\n",
       "      <th>Water User</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>1901-01-01</th>\n",
       "      <td>0.000000</td>\n",
       "      <td>514.15</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>514.15</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-02</th>\n",
       "      <td>0.000000</td>\n",
       "      <td>483.35</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>483.35</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-03</th>\n",
       "      <td>6349.027111</td>\n",
       "      <td>1815.10</td>\n",
       "      <td>6349.027111</td>\n",
       "      <td>6349.027111</td>\n",
       "      <td>6349.027111</td>\n",
       "      <td>6349.027111</td>\n",
       "      <td>6349.027111</td>\n",
       "      <td>6349.027111</td>\n",
       "      <td>1815.10</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-04</th>\n",
       "      <td>0.000000</td>\n",
       "      <td>2857.05</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>2857.05</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-05</th>\n",
       "      <td>0.000000</td>\n",
       "      <td>2763.25</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>2763.25</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-06</th>\n",
       "      <td>316601.314118</td>\n",
       "      <td>11478.60</td>\n",
       "      <td>316601.314118</td>\n",
       "      <td>316601.314118</td>\n",
       "      <td>316601.314118</td>\n",
       "      <td>316601.314118</td>\n",
       "      <td>316601.314118</td>\n",
       "      <td>316601.314118</td>\n",
       "      <td>11478.60</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-07</th>\n",
       "      <td>0.000000</td>\n",
       "      <td>8350.30</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>8350.30</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-08</th>\n",
       "      <td>0.000000</td>\n",
       "      <td>5412.40</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>5412.40</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-09</th>\n",
       "      <td>0.000000</td>\n",
       "      <td>3761.10</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>3761.10</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-10</th>\n",
       "      <td>0.000000</td>\n",
       "      <td>2825.20</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>0.000000</td>\n",
       "      <td>2825.20</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "            Default Link #4  Default Link #5  End Of System            MFR  \\\n",
       "1901-01-01         0.000000           514.15       0.000000       0.000000   \n",
       "1901-01-02         0.000000           483.35       0.000000       0.000000   \n",
       "1901-01-03      6349.027111          1815.10    6349.027111    6349.027111   \n",
       "1901-01-04         0.000000          2857.05       0.000000       0.000000   \n",
       "1901-01-05         0.000000          2763.25       0.000000       0.000000   \n",
       "1901-01-06    316601.314118         11478.60  316601.314118  316601.314118   \n",
       "1901-01-07         0.000000          8350.30       0.000000       0.000000   \n",
       "1901-01-08         0.000000          5412.40       0.000000       0.000000   \n",
       "1901-01-09         0.000000          3761.10       0.000000       0.000000   \n",
       "1901-01-10         0.000000          2825.20       0.000000       0.000000   \n",
       "\n",
       "                       SP            SR2            SR3        Storage  \\\n",
       "1901-01-01       0.000000       0.000000       0.000000       0.000000   \n",
       "1901-01-02       0.000000       0.000000       0.000000       0.000000   \n",
       "1901-01-03    6349.027111    6349.027111    6349.027111    6349.027111   \n",
       "1901-01-04       0.000000       0.000000       0.000000       0.000000   \n",
       "1901-01-05       0.000000       0.000000       0.000000       0.000000   \n",
       "1901-01-06  316601.314118  316601.314118  316601.314118  316601.314118   \n",
       "1901-01-07       0.000000       0.000000       0.000000       0.000000   \n",
       "1901-01-08       0.000000       0.000000       0.000000       0.000000   \n",
       "1901-01-09       0.000000       0.000000       0.000000       0.000000   \n",
       "1901-01-10       0.000000       0.000000       0.000000       0.000000   \n",
       "\n",
       "            Ungauged Inflow  Water User  \n",
       "1901-01-01           514.15           0  \n",
       "1901-01-02           483.35           0  \n",
       "1901-01-03          1815.10           0  \n",
       "1901-01-04          2857.05           0  \n",
       "1901-01-05          2763.25           0  \n",
       "1901-01-06         11478.60           0  \n",
       "1901-01-07          8350.30           0  \n",
       "1901-01-08          5412.40           0  \n",
       "1901-01-09          3761.10           0  \n",
       "1901-01-10          2825.20           0  "
      ]
     },
     "execution_count": 34,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Retrieve Downstream Flow Volume, anywhere it is recorded.\n",
    "# Name the columns for the network location\n",
    "ds_flow = v.retrieve_multiple_time_series(run_data=index,criteria={'RecordingVariable':'Downstream Flow Volume'},\n",
    "                                          name_fn=veneer.name_for_location)\n",
    "ds_flow[0:10]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 35,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>Demand &amp; Storage Interface@Demand Model@Regulated Requirements</th>\n",
       "      <th>Demand &amp; Storage Interface@Demand Model@Regulated Water Supplied</th>\n",
       "      <th>Demand Model@Crops@Crop Type #0@Area</th>\n",
       "      <th>Demand Model@Crops@Crop Type #0@Crop Production</th>\n",
       "      <th>Demand Model@Crops@Crop Type #0@Crop Yield</th>\n",
       "      <th>Demand Model@Crops@Crop Type #0@Evapo-Transpiration</th>\n",
       "      <th>Demand Model@Crops@Crop Type #0@Requirement</th>\n",
       "      <th>Demand Model@Crops@Crop Type #0@Soil Depletion</th>\n",
       "      <th>Demand Model@Crops@Crop Type #0@Water Supplied</th>\n",
       "      <th>Downstream Flow Volume</th>\n",
       "      <th>Flow</th>\n",
       "      <th>Flow 1</th>\n",
       "      <th>Mass Balance</th>\n",
       "      <th>Storage Volume</th>\n",
       "      <th>Upstream Flow Volume</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>1901-01-01</th>\n",
       "      <td>9897.6</td>\n",
       "      <td>0</td>\n",
       "      <td>10000000</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0.00099</td>\n",
       "      <td>9897.6</td>\n",
       "      <td>9.897600e-04</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-02</th>\n",
       "      <td>0.0</td>\n",
       "      <td>0</td>\n",
       "      <td>10000000</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0.00099</td>\n",
       "      <td>0.0</td>\n",
       "      <td>0.000000e+00</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-03</th>\n",
       "      <td>0.0</td>\n",
       "      <td>0</td>\n",
       "      <td>10000000</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0.00099</td>\n",
       "      <td>0.0</td>\n",
       "      <td>-2.168404e-19</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-04</th>\n",
       "      <td>6290.0</td>\n",
       "      <td>0</td>\n",
       "      <td>10000000</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0.00099</td>\n",
       "      <td>6290.0</td>\n",
       "      <td>6.290000e-04</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-05</th>\n",
       "      <td>0.0</td>\n",
       "      <td>0</td>\n",
       "      <td>10000000</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0.00099</td>\n",
       "      <td>0.0</td>\n",
       "      <td>-2.168404e-19</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-06</th>\n",
       "      <td>0.0</td>\n",
       "      <td>0</td>\n",
       "      <td>10000000</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0.00099</td>\n",
       "      <td>0.0</td>\n",
       "      <td>4.336809e-19</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-07</th>\n",
       "      <td>9897.6</td>\n",
       "      <td>0</td>\n",
       "      <td>10000000</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0.00099</td>\n",
       "      <td>9897.6</td>\n",
       "      <td>9.897600e-04</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-08</th>\n",
       "      <td>19795.2</td>\n",
       "      <td>0</td>\n",
       "      <td>10000000</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0.00099</td>\n",
       "      <td>19795.2</td>\n",
       "      <td>1.979520e-03</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-09</th>\n",
       "      <td>29692.8</td>\n",
       "      <td>0</td>\n",
       "      <td>10000000</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0.00099</td>\n",
       "      <td>29692.8</td>\n",
       "      <td>2.969280e-03</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1901-01-10</th>\n",
       "      <td>39590.4</td>\n",
       "      <td>0</td>\n",
       "      <td>10000000</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0.00099</td>\n",
       "      <td>39590.4</td>\n",
       "      <td>3.959040e-03</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "            Demand & Storage Interface@Demand Model@Regulated Requirements  \\\n",
       "1901-01-01                                             9897.6                \n",
       "1901-01-02                                                0.0                \n",
       "1901-01-03                                                0.0                \n",
       "1901-01-04                                             6290.0                \n",
       "1901-01-05                                                0.0                \n",
       "1901-01-06                                                0.0                \n",
       "1901-01-07                                             9897.6                \n",
       "1901-01-08                                            19795.2                \n",
       "1901-01-09                                            29692.8                \n",
       "1901-01-10                                            39590.4                \n",
       "\n",
       "            Demand & Storage Interface@Demand Model@Regulated Water Supplied  \\\n",
       "1901-01-01                                                  0                  \n",
       "1901-01-02                                                  0                  \n",
       "1901-01-03                                                  0                  \n",
       "1901-01-04                                                  0                  \n",
       "1901-01-05                                                  0                  \n",
       "1901-01-06                                                  0                  \n",
       "1901-01-07                                                  0                  \n",
       "1901-01-08                                                  0                  \n",
       "1901-01-09                                                  0                  \n",
       "1901-01-10                                                  0                  \n",
       "\n",
       "            Demand Model@Crops@Crop Type #0@Area  \\\n",
       "1901-01-01                              10000000   \n",
       "1901-01-02                              10000000   \n",
       "1901-01-03                              10000000   \n",
       "1901-01-04                              10000000   \n",
       "1901-01-05                              10000000   \n",
       "1901-01-06                              10000000   \n",
       "1901-01-07                              10000000   \n",
       "1901-01-08                              10000000   \n",
       "1901-01-09                              10000000   \n",
       "1901-01-10                              10000000   \n",
       "\n",
       "            Demand Model@Crops@Crop Type #0@Crop Production  \\\n",
       "1901-01-01                                                0   \n",
       "1901-01-02                                                0   \n",
       "1901-01-03                                                0   \n",
       "1901-01-04                                                0   \n",
       "1901-01-05                                                0   \n",
       "1901-01-06                                                0   \n",
       "1901-01-07                                                0   \n",
       "1901-01-08                                                0   \n",
       "1901-01-09                                                0   \n",
       "1901-01-10                                                0   \n",
       "\n",
       "            Demand Model@Crops@Crop Type #0@Crop Yield  \\\n",
       "1901-01-01                                           0   \n",
       "1901-01-02                                           0   \n",
       "1901-01-03                                           0   \n",
       "1901-01-04                                           0   \n",
       "1901-01-05                                           0   \n",
       "1901-01-06                                           0   \n",
       "1901-01-07                                           0   \n",
       "1901-01-08                                           0   \n",
       "1901-01-09                                           0   \n",
       "1901-01-10                                           0   \n",
       "\n",
       "            Demand Model@Crops@Crop Type #0@Evapo-Transpiration  \\\n",
       "1901-01-01                                            0.00099     \n",
       "1901-01-02                                            0.00099     \n",
       "1901-01-03                                            0.00099     \n",
       "1901-01-04                                            0.00099     \n",
       "1901-01-05                                            0.00099     \n",
       "1901-01-06                                            0.00099     \n",
       "1901-01-07                                            0.00099     \n",
       "1901-01-08                                            0.00099     \n",
       "1901-01-09                                            0.00099     \n",
       "1901-01-10                                            0.00099     \n",
       "\n",
       "            Demand Model@Crops@Crop Type #0@Requirement  \\\n",
       "1901-01-01                                       9897.6   \n",
       "1901-01-02                                          0.0   \n",
       "1901-01-03                                          0.0   \n",
       "1901-01-04                                       6290.0   \n",
       "1901-01-05                                          0.0   \n",
       "1901-01-06                                          0.0   \n",
       "1901-01-07                                       9897.6   \n",
       "1901-01-08                                      19795.2   \n",
       "1901-01-09                                      29692.8   \n",
       "1901-01-10                                      39590.4   \n",
       "\n",
       "            Demand Model@Crops@Crop Type #0@Soil Depletion  \\\n",
       "1901-01-01                                    9.897600e-04   \n",
       "1901-01-02                                    0.000000e+00   \n",
       "1901-01-03                                   -2.168404e-19   \n",
       "1901-01-04                                    6.290000e-04   \n",
       "1901-01-05                                   -2.168404e-19   \n",
       "1901-01-06                                    4.336809e-19   \n",
       "1901-01-07                                    9.897600e-04   \n",
       "1901-01-08                                    1.979520e-03   \n",
       "1901-01-09                                    2.969280e-03   \n",
       "1901-01-10                                    3.959040e-03   \n",
       "\n",
       "            Demand Model@Crops@Crop Type #0@Water Supplied  \\\n",
       "1901-01-01                                               0   \n",
       "1901-01-02                                               0   \n",
       "1901-01-03                                               0   \n",
       "1901-01-04                                               0   \n",
       "1901-01-05                                               0   \n",
       "1901-01-06                                               0   \n",
       "1901-01-07                                               0   \n",
       "1901-01-08                                               0   \n",
       "1901-01-09                                               0   \n",
       "1901-01-10                                               0   \n",
       "\n",
       "            Downstream Flow Volume  Flow  Flow 1  Mass Balance  \\\n",
       "1901-01-01                       0     0       0             0   \n",
       "1901-01-02                       0     0       0             0   \n",
       "1901-01-03                       0     0       0             0   \n",
       "1901-01-04                       0     0       0             0   \n",
       "1901-01-05                       0     0       0             0   \n",
       "1901-01-06                       0     0       0             0   \n",
       "1901-01-07                       0     0       0             0   \n",
       "1901-01-08                       0     0       0             0   \n",
       "1901-01-09                       0     0       0             0   \n",
       "1901-01-10                       0     0       0             0   \n",
       "\n",
       "            Storage Volume  Upstream Flow Volume  \n",
       "1901-01-01               0                     0  \n",
       "1901-01-02               0                     0  \n",
       "1901-01-03               0                     0  \n",
       "1901-01-04               0                     0  \n",
       "1901-01-05               0                     0  \n",
       "1901-01-06               0                     0  \n",
       "1901-01-07               0                     0  \n",
       "1901-01-08               0                     0  \n",
       "1901-01-09               0                     0  \n",
       "1901-01-10               0                     0  "
      ]
     },
     "execution_count": 35,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Retrieve everything available from the Water User node\n",
    "# Name the columns for the variable\n",
    "water_user = v.retrieve_multiple_time_series(run_data=index,criteria={'NetworkElement':'Water User'},\n",
    "                                          name_fn=veneer.name_for_variable)\n",
    "water_user[0:10]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Other run related actions\n",
    "\n",
    "There are numerous functions and options that are closely related to running simulations:\n",
    "\n",
    "* You can call `v.run_model()` with alternate `start` and `end` dates, along with other options related to the simulation, such as specifying an input set\n",
    "* You can call `v.apply_input_set()` to run the commands in a particular input set. This doesn't trigger a run, so its useful in situations where you want to run multiple input sets before a single simulation\n",
    "* `v.configure_recording()` can switch time series recorders on and off\n",
    "* You can drop a run from memory (`v.drop_run`) or drop _all_ runs (`v.drop_all_runs()`)\n",
    "\n",
    "These actions will all be covered in subsequent tutorials. For now, a simple example of enabling recording of `Storage Surface Area` and rerunning:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 36,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "(302, 'runs/1')"
      ]
     },
     "execution_count": 36,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "v.drop_all_runs()\n",
    "v.configure_recording(enable=[{'RecordingVariable':'Storage Surface Area'}])\n",
    "v.run_model()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 37,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<matplotlib.axes._subplots.AxesSubplot at 0x23ca8588>"
      ]
     },
     "execution_count": 37,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAXcAAAEGCAYAAACevtWaAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAIABJREFUeJzsnXd4HNXV/79XWvViyXLFFQM2toPBFAcwRZSAIbQQCC20\nhIQ3MS+BkB8kEIIhkIQQAgmQxLwvYPxCYkIxJcS0YEEMAYwxxcbGxg3buEi26q7q6v7+ODq+Z2Zn\ndkfSStqV7ud59MxodmZ2dsp3zj333HOU1hoWi8Vi6V9k9PUBWCwWiyX5WHG3WCyWfogVd4vFYumH\nWHG3WCyWfogVd4vFYumHWHG3WCyWfkhKibtS6iGl1A6l1McB1v29Umq5UuoDpdRnSqndvXGMFovF\nkg6oVIpzV0odBaABwHyt9bRObHcVgIO01lf02MFZLBZLGpFSlrvWegmAarlMKTVBKbVIKbVUKfWG\nUmqix6YXAPhbrxykxWKxpAGhvj6AADwI4Eqt9Tql1AwAfwZwAn+olBoLYDyA1/vm8CwWiyX1SGlx\nV0oVADgSwJNKKdWxOMu12vkAntKp5F+yWCyWPialxR3kNqrWWh8cZ53zAfywl47HYrFY0oKEPvcg\nESxKqT8qpdYqpT5USk0XyzcqpT7qiGp5L+AxqY4/aK3rAWxQSp0j9jlNzO8PoERr/U7AfVssFsuA\nIEiH6iMATvb7UCl1CoB9tNb7AbgS5BNn2gGUa62na61nJPoipdRfAbwNYKJS6gul1OUALgLw3Y4X\nxwoAZ4hNzgOwIMBvsFgslgFFoFBIpdQ4AC94hScqpf4CYLHW+omO/1eBBH2HUmoDgEO11ruSfNwW\ni8ViiUMyQiFHAdgs/t/asQwANIBXO8IYv5eE77JYLBZLAHq6Q3Wm1nqbUmooSORXdcSyWywWi6UH\nSYa4bwUwRvw/umMZtNbbOqaVSqmFAGYA8BR3pZQNZbRYLJZOorVWXsuDumX2RLB48DyASwBAKXU4\ngJoOf3u+UqqwY3kBgJMArEhwkIH+brnllsDr9odtjz322LQ63nQ7T935XnueUvu3ptt56uy28Uho\nuXdEsJQDKFNKfQHgFgDZpMX6Qa31P5VSpyqlPgcQBnB5x6bDASzssMhDAB7XWr+S6PuCUF5ePqC2\nHT9+fK9/Zzpu29Xz1J3vteepZ7fry2374jx1d1sHXX27JPuPDsXixS233NLXh5AW2PMUDHuegpEO\n56lDNz01NaUSh1m8SdqbvJ9jz1Mw7HkKRrqfp5RJ+auU0qlyLBaLxZIOKKWgu9mharFYLJY0woq7\nxWKx9EOsuFssFks/xIq7xWKx9EOsuFssFks/xIq7xWKx9EOsuFssFks/xIq7xWKx9EOsuFssFks/\nxIq7xWKx9EOsuFssFks/xIq7xWKx9EOsuFssFks/xIq7xWKx9EOsuFssFks/xIq7xWKx9EOsuFss\nFks/JKG4K6UeUkrtUEp9HGedPyql1iqlPlRKHSSWz1JKrVZKrVFK3ZCsg7ZYLBZLfIJY7o8AONnv\nQ6XUKQD20VrvB+BKAH/pWJ4B4P6ObacCuEAptX+3j9hisVgsCUko7lrrJQCq46xyJoD5Heu+C2CQ\nUmo4gBkA1mqtN2mtWwEs6FjXYrFYLD1MMnzuowBsFv9v6Vjmt9xisVgsPUxPdKh6VuIOtKECXn45\n8Tr19Z3fd1sbbas1/SkFVFZ27TgtyUEp+gs6b7FYghNKwj62Ahgj/h/dsSwbwFiP5XGYg69/Hfj5\nz4Hc3HLccEO554NdWwsUFXXuINvaaNrSAoTDNP/FF8DQoZ3bj8VisfQVFRUVqKioCLay1jrhH4Dx\nAD7x+exUAC92zB8O4J2O+UwAnwMYBxL6DwFMjvMdmu1qrWl6zz00/8ADWs+bp3V7Oy1ft053mvp6\n2nbXLq2ff57mlyzp/H4s3aOlRevPPqP50lJzvQ84gOajUa1POcV5H/C8xWJxQhLuralBQiH/CuBt\nABOVUl8opS5XSl2plPp+x8vhnwA2KKU+BzAXwA87lkcBXAXgFQArASzQWq9K9H3nnGPmP+4Ivpw9\nG/j+94H2dvp/+fJEe4klGqVpOAwMH27mLb3L/fcDkybR/KBBZjkvi0SAo482y7OzacotL4vFEoyE\nbhmt9YUB1rnKZ/lLACZ15oCGDTPzI0fSVClyp7S20v833QR885ve2zc0ADNmAJ9+6lzO4hAOm/00\nNHTmyCxdZfVqYPJkssEbG83y4mIzzy/ucBjI6DA5WluBzEyar6sDBg/uneO1WPoDKTdCNRIhEQBI\nEAAgL4+mQay3qipglUf7wEvcg1run33m/zKx+MOCXS0CaXNyzLwUd9mykvOlpTRvX8QWS+dISXGX\nVhwvA4wof/e7/tuzePA+GBaMSAR47TWaDyoYL78MPPNMsHUtxO9/b6zuxYvN8pBoK/K1am4216uh\nIVboS0utuFssnSXlxD0cjhV3Rka8JIJfEk884dw2HDbLglru7Pe1BOejj8z8TTfR9OOPvftLamud\ngi6vVVsb+eYbGoDNm4EFC3r2uC2W/kLKiXt9vXnQ3dZaEHeKFInt24HzzyeRl8vPOCPxfgDToZuV\nFfz4LcSBB5r5iRNp+vzzwLHH0nxbm3G/1dU5LXcWd7biS0po/hvfAC64oHeO32JJd1Ja3P0s93hN\ndK+OuZoapzW4ZEni/VRXG4Gy4t55+BoCwN5703TnTnMd3n3XfM6ttexsb8u9pITui8MO651jt1j6\nAykt7m7x7ay48/qRCDX9efnpp5NgxLPc6+poGo0acWdL05KYxx8387Nm0XTnTtP6+uADcz7ZQi8u\ndl43tuLZLRNKxpA7i2WAkBbiXlhI0yBuGS9xb2gA/vQnmq+ooHWKi+O/JO69l6aNjUaEmpvjH/s7\n78T/fCBx8cU0bW0Frr2W5rdvN9dw2jQ6r6EQXQd5TdwdquyWseJusQQnpcS9qIjE3d2hylEVbstd\nWn+Mn7h//es0//e/O61EPwoKvPfjx/btwBFHxP99Awkp0EceSfN7723EnUNeCwspDYSX5c7zoRCt\nwy9ci8WSmJQS95ISspTdYsri7h58dMghwCuvOPfhJ+4clnf22bROUVF8cecY+z/8Adi2zezTj88/\np6kdSUlIcT/mGCA3Fxg9OvYa1tSY0cdS3DMy6EWvNfDQQ8CvftU3v8NiSVdSStyVIiFnEfWz3KXI\nuhOL+Yn7++/TfHa2sRJZYN54I/ZY8vNpumKFGUQVT9y//JKmHJM/0JGutdZWoKyM+j34mrBwM/zC\nlX72ujp6KV94ISV4u/RSs67FYolPSnkx29rIHcKdmRzVIi137lxj3DHv/OBHIk5xv+MOM8/ivmMH\nCUx5OYkN+/b5WPi7/aJ3JBzuFw47R14OVKS4t7WRuNfVUeuMl0txd7tlBg0iqz4Uog7waNTZQS6v\nlcViiSWlLPdolCxmjmxxw8PRpbhzJ+dddzlHOrot99tvB6ZONWF37s47mfMEMNuecop5gcQTdyk8\nlli/OVvu7JbxstxZ3KNR0/8SCtE9EYmYa/3kk737WyyWdCTlxT0apcRTAC0vKQG2bjWFNpqaaHr9\n9cDDD3uPdOSXwYgRRtAHDaJ1WLj9wi7lOlbcg+O23AcPJsudxf3nP6cp94VIV1lbmxH3zEwj7lVV\ntO53vkMpIa6+und/U7JobAT226+vj8LS30kpcWe3TG0tsH9HKW2Z06WuzqSJ3bCBpizuAPDoo/6W\nu2z2t7fT90Qi9KLgdZ56yvjwuyruNo0w4X7JDh7stNwBstzZTeN2yxQXx1ruskbBX/4C3Hdfr/2c\npNLQQB3wtvPd0pOknLjn55OI88Ch7dtJGEpKSBy4o3P7dppKMX33XSPuy5YZ373bWo9GyWfb2EgZ\nH3mdBx6gefnghcPGHRBPuGWIn8W7Q1Va7gCJO4ecNjaaCCY/y728nEap/vrX6Rnzzi1Qdkf5uR8t\nlmSQUuIu3TL88E6dajpSpejzAyIFd9YsI+4vvQSsX2/WkSMd29vpe1paTM74hgbgootofuVK65bp\nLm6fe24usHZtrLifdZZZz8stIy33lpb0HtA0eTLw3HPmxWfFved44w077iTlxJ3dMllZ1JnZ2GjE\nnUX/jDOcVjkL/YwZzjC5CRPMOm7LPTOTBIf3I3OHc8heZqax3AsLjV/eq7C2dcs4YQFbuJDOzT77\n0P+trcAvf2lequedR30hLO6yQ7WujsYYsLi3ttI1CoeN/z0VOeooEnEJ35cffmjFvTd49VU7Yjyl\nxF26ZaTFJsU9K4uyC15yCW0jI17YKgeAmTNjfe4FBaaiU2Ymxa/zAyazEW7f7nwZNDeTaygcBt5+\nm6pF8aAlpr6eptZyJ/iarFlD5zUvj855YyOdV07JrBR9JsV9yxaaX7OG9iHvA84JxDn5d+/um98X\nj7feAq64wrmMz0d+Pt1DgBX3nkQWhRmopJS4s7uELfSCAop1VsppuUvcZfPa20ksWNBzcsw877Ou\njkZA5uXR/nlb3k8oZNw4LO5sMXLIpNsqmDePplbciWgUmD6dWl+cQiA3lyzx4mIj7tyCam01bplP\nPiHLNysL+MpXnG4Zvg7HHEPfk6otJXfLgg2HceOAZ5+leSvuXWfqVGNQecEDDwcygcRdKTVLKbVa\nKbVGKXWDx+clSqlnlFIfKaXeUUpNEZ9t7Fi+XCn1XqLvkm6Z/HzKJFhQ4Oxo/fGPTaZBKcos7twx\n5w6vy8wk9wqPfMzLA+bONdvyAzh0qFPcn3iCRD0cpn0DztJxgCnDl6pi09twwq/6ero+LO7//jeJ\ndzRKL01+yQLOlBCzZtF2WVn0gm5pocgottxHjaL10uVlKluRPNLWinvX+fRTEzHnhRX3AOKulMoA\ncD+AkwFMBXCBUmp/12o3AliutT4QwKUA/ig+awdQrrWerrWekej73Jb7zp0kyCz6oRAloOJc7e7i\nDu4BStyJyn52t+XOaQncLwkp7qEQiYkU7p07ncfNFn26iE1Pw/lhFixwWu6TJwNf+xpdB46G4Qcx\nL4+uX0kJ5QACKF2EUua+YMvdLy10qnDeec7/5b31xRc0b8W9e/zP//h/lpvbe8eRqgSx3GcAWKu1\n3qS1bgWwAMCZrnWmAHgdALTWnwEYr5Qa2vGZCvg9mDLFPMRsuVdV0YWSlnt+PvDPf9I2L75ohNYd\nzy7TxbJbprCQfLlak5iwxe1+SUhxP/ZYGnQiY+e5I5ax4u4kGjUl9dra6Lrl5tL5yciga+gWd3bR\n8GA1wJQ4zM8nFxqLe5BMnX2JuzSjPF6+R6y4d4944wT4/A/ksQRBRHcUgM3i/y0dyyQfATgbAJRS\nMwCMBTC64zMN4FWl1FKl1PfifdHSpd4+95wc53KOdWd++lOaut0yMvyR3TIFBdQJ99vfmmiZgoL4\nlrt8YfA6nEvm009pGokY4bHQOeNUv9Jy5wpZUtzZyuLWlNbG/cUJ2XJzzcs6HDaD21JV3GXIJ+AU\n9xEjaN6Ke/eYOdP/s1Rv2fUGyYoW/g2APyilPgDwCYDlALjQ2kyt9bYOS/5VpdQqrfUSr5389rdz\n8P77ZInv3l2O/Pxy1NQYa91P3Pkh4Vzw2dm0TUODt1sGAL79bYqFbWjwtgazsrzFXYY8trdTxw5H\n4JSWksjPn08vkGuuSdLZTUOiUeDkk4H//If87KtXG8udByY1N3tb7oC5TuvW0ZSjH/ha8UjlVH14\n3Qnt3K5Dnrd0nSDjTurrTSuwP1BRUYEKOVQ7DkHEfSvIEmdGdyzbg9a6HsB3+H+l1AYA6zs+29Yx\nrVRKLQS5eTzFfc6cOXj0URqANGqUsdy5QzUcNkIPAMcdByxebLIH8oOTkWE6Ttn/zp2ovO0RRwDv\nvUcvEnbdyKyTRUVG3Hk4vPsFIGPteZ1IhPLc7Nhhxb2gwKSHOOIIeulJtwzgFPeMDCPubp8p/8+W\n+3770b5TVSDjWe5sVcaL9rD4464JwDQ1AaeeCrz+ulPc+xPl5eUoLy/f8/+tt97qu24Qt8xSAPsq\npcYppbIBnA/gebmCUmqQUiqrY/57AN7QWjcopfKVUoUdywsAnARgRbwv4+Y3W+g1NWSJsxiwuwYw\nqXWrq41As7jLqBvAdIyyBRgKkajU1ZlMk21tznlpubPoy1J/f/kLzTc00HGyZWpjbOn8FRbSA7f3\n3nT9pPuFr6eMlpHznFCM4W3Zcm9tpbEHqSbuHEXlLsnottw5d72l83AQhLvfq7qajL3m5u6Je3u7\n6dNLZxKKu9Y6CuAqAK8AWAlggdZ6lVLqSqXU9ztWmwxghVJqFSiq5kcdy4cDWKKUWg7gHQAvaK1d\ntZOc8MOdlUUCXV3ttNblPDe3duwwoiwtd3bjjBxpqjGxSLDFuH69EXm3jz43l/bV2OhtuXOFpoYG\nCql85x1ax92ZNhDhMQYACXFGBvCvf9H/bstdXhM5L+F9yWye7vTPAFltfTkykV/+fimkZae/Ffeu\nwRpRV0ejxTnZnxz52x1x/+wzU5YznQnkc9davwRgkmvZXDH/jvvzjuUbABzUmQPiC8eWdWMjiSVb\n69L6/utfadrURJ9rTfPSch882Axq8hJ3gEr1TZlCL4ZBg0yRbm4l1NbGdqiGw8ALL9B8fT2Vimtp\nAVatspY74EzxEIk4K2ZJ95jbLcMvRl6fRyKz2Gdl0XXhFld9PY1YPuccOv8nnEDruWvrbtpE13fv\nvZP/W71wR01JV4JsCVo6D98LdXUmUo7TlADOfo2uiHt/CaNMqRGqEinibsud38rC9YSsLJOPRPrc\nWTw4CRVfOH55MJGIsagWLzYDbzguXoo7j3r9yU9o24YGEhYeVm8tdzofHP7Y2EjX5LTT6DN++QKx\nHarsRmNOP91sw3CLrqyMzv2ZZ8b6uN189asmv01P4i7uzrjdMizuWlMeFEtwuMXMzzdgnkGe706/\nBo+Cd3eKpxspJ+47dtCUhQEwoZAAnfhJHW2ECRPIMuf12RUjLXcWj3iW+9VXG3HnKIzdu53inptL\n/3OkRjhsUriyL547+/xi3e+8M/7Ai1SBHww/2trIsmbreNGiWEu5vd28TBsbaf1996XP4nWoul+M\nQ4aYzxjOxc/iHoSmpthj7Aniibscc8FumU8/BU46qeePqz/BhkFtrXF/yf4wbnnzcoBSPgSNeef7\nJN1bVikn7tItw5a7W9zZumtrA/73f+mh4QFKLO7S555I3M85x+Q64U7aqioj7pxorKCARhe2tdH+\nWKjr60062kjE5Ih389Ofkvsm1QmFqPXiB6dSZsvz1FPJ7SHhpGCyE5WvZ7wOVWm519WZ1pn0wfPD\nHa9D1W3J91Zrqr3dWeSdkeIu3X/uvgVLYpqa6L5qaDDi7q6q5nbLfOMbps8nEf0lVDXlxH2vvWgq\nxSA72ykADHd6cly6dMW4LXeOr/bqvGN3ChfxAEzOcOnrLyiguGse9HTVVWZdKe7xBlekC+++6/8Z\nC6VsCstUy/y/DG10C72X5S5f3IAZyMTbMLwtW+7f8xga5xbXzoq7UqYUYGdob6d7yEvci4vJpSB9\n7nYkZedpajLXnkNtg7hl3NE1flhx7yEOP5ym7NsG6IH3CpFrbSXBaGujNKss7l4+d8Df556fT/9H\nIsbNwz56Fnt+YYRCFLMdDtM63KnHMfLhcLAO1aoqYwGnIpz/xAsO85NNYVnuECCLXoq7nPfrUA2F\n/EU4w+NOZctd9p2wceB+MLtiud9xR+e34RKOLS10DEpRKUcOswXoHuE8Onze7GjV4DQ3G3HftYuW\nubPDsrjfcYe/q8wPK+49BEdJtLQ4hdgrRI4td4AeEinuXrlLdu70dstwNE59PX3+1a8acZcdfwUF\nJMpDhhhLgQWmpYU+z8jw9+1y8RCAXEG90cHXWfjY+SXrhaxMJf2cAPCLX1BT2W25+7llZCeqUrEd\nqowMLeScNcXFprMWoAeaW03uB7MrEUyHHNL5bTiNsSz0/l//ZYwVNgA4QynHbLuzjFr8YRdXOAw8\n+SQtk5Y7j1Rn+N7k9N6JsOLewzQ2mgfSHVHBsOUOABdfTKGJTz5pXC6cT4a3HTXKX9zduU7cbhmO\nu//8c3NjyYE0ra1mP9yh6u5td0fnpBJf+xpFbbB7IF7no7Tc5TxAVZaWL++cW0ZeUz8LW464ZneN\nzPMO0Lx82CVdsdzZ0u4MchAdi0pjY2x+HRZ3TjltLffgyMyvJ59My7zcMocdRv8vXUpTrruciP6S\nlyZlxf2RR5yjSaUwMNJyl7GpeXne7pelS4OJO1cGkuLO1v3atcBDD9ED29REovXggyb0Lz/fWGHu\nm0OKe6qFS772GvDUU7GWuITzZ8uHiIuUyN/KeXfcgi7n+eWRkUGZPRm/8yLP3Ykn0jQ/n66DVwHz\nZIh7Vx5uL3HftctkxuR7i8X9a1+LPXZLfNj11dTk7FB1R8tMnEi5nxYupOVBr6e13HuYb387seVe\nVOQt7rm53iJ+7rneoi/dMm7fsFvcAeC22+jY6uspPw373PklweLufmB7Wtw//bR7fvzNm+OL+4QJ\nFCIqrXV2o8kHobra23KX15MfoFCIcgQxfm4Z6cLidbij3N16cM8DXXPLdEVwpbhzB96sWcZyZ3Hn\n1gv73K24J6a4GHj0URNmm59vyixKyz0cpsiYNWto/vjjafno0d77dWPFvYfJyjJCzhcTMBbf+vXA\nn//sFHd+gP3EvbQ0vuXO4ZKyg4+/LzvbbDt6tElZIAc8sOuGfXu9Le5Tp3bPj//OO0bc/SILrr/e\n2XE1dSrNy9jiaDR+h6q03DMzjSUOxJZR9FrO8+yWYR98OExjIA480MSQs09bnu877zR1TOPhzg8T\nBBZ3rj8AGBehOyy3uZk6W4H0F5LeoL6exlTIFyiLuzsUUmZ7ldsHob+Ie7JS/iaV++6jAhlMNOrs\naAXMMHIWlLw8qjr/r3/FiruXe0eGQrI75YsvnCIUCgF3323Wefxxmmehr62lzte33nJa7hwX7+eW\n0Tr13DIAnfNEOTlOP93ECzc0mHzrDQ3A7Nk0X1dnHkA+99Jyz8hwdniNGGHE/t57/Y+NIyM47QSn\np1i50hyDzA901FHUitDaWPta03iD8vL4sfxA98RdWu6ck8id037lSuexWxLDnaUcEVddbZ41LssY\nDlNrcPx4YMkS079VX0+5aNrbgeHD/b8jXcSdq5X5kZKW+1VXAQccYP6XMcDuTkoW4rw84A9/oPmc\nHKdA/+//mnnpGmAXhlLeZd9CIdN6kJYj+07r6igFQShkLHfedvDgWMudX1BNTT2Xf2bYsK5vO2aM\nv1uGreOGBip0wvNctKShwYSR7toVK+5uy33GDO8cHkcc4X1s995rwjN5YBNfn2nTzEMtq2/JTkp+\nYNkN4k7s5UVXhp97+dyluEvLXZLqQpIqvPNObHJAvt4ymRyPK+Dax5mZVFfgxBNJ9AFqNf3f/8V+\nR7qIO/cl+JGS4u7mzTfNvHvkIYtHY6OJwHBb7myBuePcOckUYDpU5YjJUIiKZQPOxFdffEHrVFXR\nDZSdbSx3bknIYs+M7IXvKcudrdtvfxv4/e+DbcM3cyTib7mz5dvQAFxxhZmXLppjjjHz3KEqLXcp\n7ocd5i2wF12U+Hjli5H91mVlsdW3ZOvA7ZcPYpV313Lnc8jnye1zl1ifezB276bniMW9psY7U2hb\nm2lh795NRs+HHwIff2xe8H/4g0lMJ0kXcU9EWog7N12BWGuKH5Jly4wou8V9wQKzLlvrmZkkCOwO\nyM935kMBaF6mC+D9t7aa+ZUrSaQqK0kA+UW0cydFoEikuPeU5c7f8fjjwJ/+FGwbFuja2ljLfcsW\nmvJ5jkSco3hlbLE7K5/bcpetJj+mTUt8vHfcYUII8/LoAeeQVGm5S2RnG0APeiKS7ZZxR8sw3N9j\nCYY8xyzuctyJbCkVFJDB49WidafMkPsH0v+apIW4S/yy/33jG8Zyl26Z118ndwPDlrhbYGTuGmm5\n33KL8fE+8ABNv/51s86JJ9JD29jojA1vaADuucf5HV7xsy0ttNw9fL+rcFI1IJjrATAiJkMhw2Gy\nePjcSeFmv7iM729ooEgGXs4dqtJyd49i9eLooxMn+DrkEPPS5egk+VB7pdPldApBHlj+/q6kBJDC\nIxPLSZ+72y0TiXRtNOxAZORIM1DMbblzqUvZUsrPJ3Hn515y9NHe38HPaboX7EgLcT/rLDPv98Dt\n3u1tuZ9wgsn0CFDR5rvuinWLeNXxDIXoQb3gAvqfH/rhw836I0eaea8b6LPPTIrSl1+mqezZD4fJ\nRSF/Y3eQ1iZ3diZCtobkcbEYc41YgCz0Cy4w+XXYWuLkaYC/5c6ClsxkWdyBnchyZ4K4P7hDvKWl\n8y9dKe6LFpnvlD73ykpyDzz4YOf2baFoMBmRxDVS3SPGuaVUUEAizfcmZxkFnNFrkjvvpCm7ONOV\nlBf3xkbg7383/3/lK97rLV9u/MJPP+2suVlWZkanhUImD7vEL9eJRP4vK0ZJq59HzDH772/ynTBu\nX/Xy5abwR3eRQh206ABvM2GCsX7CYf8BIiNHkvXMv4PXP+00+q1e4g6YjJteL8Gu4u7AluX9GH4p\njxsXzHJvaqKXBMfRdwYpPIceSsvc4g5QmGZ/KQrRm/AAOe6g5xTcXh2q7JaprDTuUtkqZFdjczPt\nh/vVuOP+q1/tvd/VE6S8uOfmOsPYzjkndp0pU5zFqI85xml9A/FDnwD/5GKS6dONWElxlx2F7I/2\nqvhz6KEkjHV1Tis3mUhxLysLvk12dmynVLxc2aWl9DtkHnuZ7ZA7VPnFnJ1NMfGbNyfvtwKxGSJl\nYW6+LnxOolFzvvk6ecG/u6AgeEfnqadS9IXbHzxmjFNs+L654QYzf+GFwX/vQEWm8JXi3txMwQtc\niYkNDSnupaUmuID3o7W5p88+21zzaNS8lIO4EVOZlBf3IKxcSaF1zN57O2PYgyDdMjzvbrYdcIC5\n4HL/0sXz5z9TmoOFC80AH6atjVw03/xmbAV3GY3THaRbhgfIJEI2Z+UDwlarW9zb2ig2vbLSvAy8\nxD0zk0bQ/qDXAAAgAElEQVTwyt8XdJRgUFjcpeXO4t7UZDorS0vpegSJlmlvp9/XGXFftIji/6W4\nV1c7C3r7jbMYM8aE51m8kf1V7tHPxcUmx1BREa0biRhxj0RMhypf/0jE3NMVFc4UFjt2mDBKyVtv\nAQ8/3KM/M6kEEnel1Cyl1Gql1Bql1A0en5copZ5RSn2klHpHKTUl6LY9gbTa/EY8upGWOL/d/Xxy\nvB4Qm8lw6FB68xcUxN4csjOYrclt25wjYbuLtNy9Wiv//d/USSxpbiYR4geE89tLcW9pIUFiy539\n7PEs94wMZ4uqJ2C/tvS5Fxaac8+iz8fJD3e8snzS6utMiKJMu8Di7o7e8DIiuEPQ4g/3tUm3DLei\npbjn5DgL9WRn0/3NqUOkkcLz48c7Q2UPPRQ44wzSkV/9ilplAHDjjcB3v9srPzcpJBR3pVQGgPsB\nnAxgKoALlFL7u1a7EcByrfWBAC4F8MdObJtU3niDLGMp1kFgCzA72whkPHGXLw2vmHWZHZKRncF8\nY919d3LDIhMNvLn/ftNhxGzfbgp719fT78nOjs2VXVZmLPeiIvNA+VnuGRkUBcKhqD2JbI4XFNDv\nYTeZu0XC18vvhcpCzNsGRaY65qRmbh+wl/vPintiolFT4Yrj3KU7tLHRmQKExf3ZZ2kdtw7U1wPX\nXkvz55wD/OhHNO927T35pDEgZGdsKpCotR/Ecp8BYK3WepPWuhXAAgBnutaZAuB1ANBafwZgvFJq\naMBtk8oxx8T3m/vBDzynEJDLvAgi7o2N5GNnPvsMOO886hRuaSEXhUyQlgy0Nk1Yv0gPt0uCO5hl\n9arCQnK7AEYc2VqPRp1+TrflLv2i+fn0m3uaQYOoD0ApmlZWOq1vGSbH+PlUu2q519TECg/n+G9o\nMMIDON0yfC57o8ZrutLWRs8JF9WR53jzZiPu2dkmRNI9qvzKK83/9fVG8GtrgX/8g+Zl66+pyTke\n4plnevY3+vHXv3qHNXOAgh9BxH0UANkNtqVjmeQjAGcDgFJqBoCxAEYH3LZH4Asb1JfNA46yspwu\nl0T7B+Jb7twjzw/uV75CUSktLZRfPhJJjrhz/h1Z4i1RoWvm9tsp9WxhIUUVvPiiiTIAYsWdI1Ka\nm+kB4PKCPOSbLWiv6kk9RXY2XcPMTPO9/JLiXDfcquBYeD/h7qq4t7fTQyhTTkux4VKQQGxW0pyc\n4OMSBiLRqLkmS5bQvcnnuLyczl9dXXxxZ6MNoPt49mx6HuvqzJgUeX+nSofqRRd5x9wnSjWSrMRh\nvwHwB6XUBwA+AbAcQEBpMcyZM2fPfHl5Oco5iUgXYGEOKnAce52dHSwOO5G4Z2XRd7M4RCLUrBs/\nngR0506K8gmHkxMSx0mTpCAlitF+5hkK1eSwPy4jOHp0rLjn5JC4v/02Dc456SSTXycvz0Tb8JDv\nhobeFfeNG2kaCpkiG/yy4yZ6URGNSuRiD+Gwd1M7qLgrBXznO5TfH6B1m5udg+iys8n3/uWXNJ7B\ny3Ln1NLhsFOALAYuvMOG0MiRsWUb5QuU49wZHtAEkFHFPveyMtPiA4zlnpcXv1+mt+E8SRUVFajo\nqFzDz6cfQcR9K8gSZ0Z3LNuD1roewHf4f6XUBgDrAeQn2lYixT1ZBBV3OdiGk2HFQ74AvPz6Spkb\nrqiIbiCtjbvmiy9oQEbQmqt+7NxJQiUHbSQSd7Yev/lNmj71lBGY7GzKf716tRl8xULNorl0qbE8\n+YHi4faDBhmXTjIHK/kRjdI54OucmWlC2dj/Xl1tHnp2O/EgLC86Y7k//LARd47AkOGx/OL/17/I\ntysLrkv/O0d1WLxhyz0vj87v0KHmuXnuOfOsyboL0gDbvdsZNusWd3f9VU4yGI2az775TRpD0xd8\n97tkSEijd948oKbmVt9tgthWSwHsq5Qap5TKBnA+gOflCkqpQUqprI757wF4Q2vdEGTbniboEPKr\nrqJpOAxMnpzY/5nIcgfMAz58eKy4T5hAlnt388wMH25qdLJI8FveL9zP3dzkm1m6DwoKSPQB45aR\nLQxZJ5QfKOmvB3rHcs/IoLDFESPMcbEV1toa6xLh5rp0X7mRHarhsMmv48V//ZeZr6gggfYSd4CW\nL1tmjlP2C3XWBTTQ4L4MDm2VPvdJk5z3onR9MRMnOhMLsvtl8GBnTiV3qghpvbOxkip9I4kM14SP\nn9Y6CuAqAK8AWAlggdZ6lVLqSqUUp9WaDGCFUmoVKDLmR/G27dpP6RpBsy9OmEBuioMPDrZ+EHFn\nZCcjh0hGo8Y1wDdNV5uB69ZRbdfaWrqBq6roe1pb6Xtqa51JktwvPG7ySiu3oIDOBeeNWbGCvkP+\nftkUZsudRRHoXbeM+8HjgiDu38Ti7iWm//kPdV7JF2U4THHon33m/b0ye+bGjZRSwE/cQyEaxcvH\ny5b79u0mN73Fm2jUWQJTivuZZ3pb7tLQKC424j52rBHxwYO9LXf58mX4uekLX/y558Yu67a4A4DW\n+iWt9SSt9X5a6990LJurtX6wY/6djs8na63P0VrXxtu2t1i50lnCLRHf+Ebw6Jog4s5CU1wca7lz\nZIkc2t/V0aqNjcZaLyggcc/Lo+8Kh6nDkwfJePn35YNTV+cUay5EPH8+FbdgV4603N3hZ30h7gyL\nLbvK3K0R6ZZxi/uVV1LnlXTL8DXhIeluCgqc7i/+Llle8OKLzTGN6ggnkLUF3n2X1n/lFVMSzuKE\nB8XxPS1TSOfkmARysqZCVpYppl5UZJ7TKVOc4zWkuPNy6d9nvMo59hZerfukiHu6MmVK8kZ+uuGK\n6oB/LD3XUi0qMpa7FHe23Lsr7jU15J6ZOpXEZudOY727Bcwt7ocf7rRUOESMo0z4GK+6iqJq5CAc\nt1tm8WLgZz/rW3Fn+OUrLXfOReIXw/7JJzTlkDp5/tgffs455ONlmpudD5nbLfO3vzlzD/H8Bx+Y\ne3PoUFr/V79KXB1qoCLdMmy583PH4t7eTh3Xsi+DwwWLi8355ufR7ZaR0VQynFop2ne8+sJdZenS\nYM+9V3/MgBb3nuSWW0y2yURuGRYJt+XOVnFLC91MXb1p1q0zlg27HsaPjy/ubG3m5DjrnbK4cw1Q\nvuHdw+e93DIAFT/oS3FnS01a7l7iHs/HLSOP+MHjpvjTTzuHoDc3O91cjY1OcZ892wh6VpY5J4cd\nZrb51rdIkHgAWrLSP/cnZOuSfe6rOhy8fD0B8q1LA+Sb33Ra+ADdE3J0dWOjc8CZ23LPzTVx9EBy\nLfcZM4Cbb068nte9asW9h5g+3RTCTtShylaiW9w5lnb9enPTdoVJk2ITVuXnewsY37CyyAa7j9zi\n3tRkXkCy2ARgHrT2dmPlhkIUItmX4s43vJdbJieHfoufuHMWQGm5s7tLvnhff92cM84gybC4y8Ik\nLDwyAR737fzud9TCzM01GU9TJb46lWDBlR2q/CLnMF6Arpt0y9xxh+nL4OVr1lDfCN/T7e0U4jts\nGO2b+8H4GsqBcEDy3TLcwo+HFfc+ws9PL0cp8pB8ttBaW80QZ4BurK5a7mvXxoq7OywSoO/kjlV+\nMXFfAPswWfxk3hN3mTj+zdIiLSgwHbP80KWCuLvdMo2Nsf50hn8PW+78YgCc14ZfdoAz5QH/n5Vl\nOnijUbNfr/Nx3XVmbIC7WpTFwC3TvDzjovnWtyi7ZlGRf4iphJcfcgj1ffALAwDef5/Gd9TX04jX\npiYTJcXGWUsLGTvJdMsAwUJglyyJDYSw4t4L+J1kabmzW4Z925GIM7nY5Mldtwj23dfc8PHEXUZj\n7N5NU7e4uwt9J7LcAWeEgkx73Btx7m74WrBlXVhIOXJycpzWtFcopBR3/k1sVbkfaGnFRSLOfck+\nmNZWs98nn/Q/bm4FAVbcvZA+d4Dms7OB33SEaHiJu7svjJePGmWeGXmPjh5tMoiOHm3GebgL0yTb\ncmdxP+ss4Ikn/NfbuRP4wQ9MOG2i6Dor7kngppucnWyM9PHJHOd5eSSWMkUBh0sGYfNmSkvKNDXF\n+ty9xJ3Fo6DA3Lhc51NGH8imLYu7n88dcA7tlm6IvrTc+fcVFtKLTI4alW6ZVavMw8W/WYZOeon7\nEUc4xf2NN5zH4Cfu8c5Hbq75LivusUi3DBB7LqW4yw5sCV9f7pTlfX7967R81CinIcNZVdkQkMnz\nkgnff889Z0pVetHQAPzlL5TkrL098RgeK+5JYPhwShHqRvrs2OfO4g6Ym4wtyaA3zfjxzvqPMguj\nl7jz93GnUTgMnH46LWttpU7BeOLuLvAMOB80uX68B7A3YIuda78WFpqMgl7iPmUKvZwB8/mPfxxr\nubsTjvGD1dBAvvL99gN+8Quzf0aKuzvVssSKe3ykWwaIvbf43Ml71C3uJSU05dHAHBWzdi0tl+Ie\nChkDiu8VWcgmmUi3TLz+Fl7vrbdMmot4WHHvQbzcMhkZ5uYrKDAdmByeFYT2dmOZAs5UsyzuMpSv\nuZlEuqbGNEMbG8kVFI2Sv9Gd64SPsajIWWzCyy0jH6iMDHNsPRWGGgT3oKacHGNRy1TAADV3AdOy\naW42naIstPLaNDU5Lff2djp3Xu6AlhZnC8ePvDzzYHu1Agc6breM+976059oGs/nvu++NBjNbbmv\nWUOfjxzpbKUyMm10T7hl5Ms8nv9dulUbGxN3vFtx70G8OlSl5V5QYHzcmZkU83rFFTSYKhEytQBH\n33hZ7rW19L2DB5N1Iy0ejvKZNy+4uHu5ZbhDkLd9661On6qkw4nEuJMyJ8cIgnSJAeahkc1cFndp\noTNsuXPxD/dL2+2WkSMm/ZDjD9atC/wzBwwyFBKIFe7f/c4sl30rbiZONJa72+c+YoTTLTNzJi2X\nlvuKFcAf/pDc3yYF3avVxvetFPfVqxPvN1lZIS0euH3ubreM9BPedReJcNACEWw5cnERmUJAjjKt\nqqL1Nm4EHnvM3Mz77+8UISnuUqhyc+mYOcSPt/ez3EMhE3+cCnA8uXyI29qcw/15KjuoOA0v42W5\nFxdT/0drq3M4vFvceXBUEHEvLjaJzywGt8/dLe777WeWJyrQ47bcb7uNXGpDhpDRxIbMEUeQoSJD\nIQ8/3JnKIxkkEndu2fN9eu655B7ad19nShA31nLvQaS4S7cM33zyBuX5IMLuvnkzMsyoPfnCYMud\nfY1//jPdzDfdBIwb54zP97Pc+YXBqQW8QiHdPvceSO7ZZfg3ygpVnNKVHxZ+uNyWuzw/PLgFMH0Q\n7Pqqr49vufP3xEttwdtykjmLE5l+APCPhJH1GPzga88iLvPPcKssK4sicSIRZyjktGnJrwOcSNzb\n24GjjjKf8QsoXqU4wIp7j8LiIGOqlYrtDIpGaVh7Z/cLmCIUdXVOcXdHzjAsQpw24IQTKALALe6y\nU1Tux8/nLt01P/qRiQ/vTU47jYqYA87h4oBT3INY7lz5BzDlB7kAiRxVzGkaZIvM7XO/8UaaD2K5\nRyLAL3/Zud89EGC3o59bhjtUQ6HE+aF4gBIHM7DbIyfHjEEJhcw9Lt0yXF84mcj9cf+PpL2dLHce\nUMetiEQvMeuW6UF+8ANgr71MJAzfRO6HvKaGcrJ89BElO0uE7OjjBGS1td6WO2dBPPJI8ruvXGnE\nvaiIBnS8956/W0bmkJE+d7cVJdfn0M7e5tlnTQeqUs6HXPZRuC136XOfMgX49FPq/2Bxl3VQc3Pp\nO9j1xdfWy3K/7TYKs8vIIPcNW4he8Hnd6lvtYGDjdsu4hY3dE9ISj4dMIsfPpVImC6q7Q7W62uSf\nSXb2zkQhjSzubDAFFXdrufcgp54KzJ1r/OB+4g6QMAQtucfraE1/nHXSz3IPhaiMXlGRiThgy52H\nc/u5ZXifnP2RLQs/t0zQrJo9QWam//dz3wNgmrRelvvUqTR/6qnmOm3fbix3HoFbXe203GUkBz90\nN99s0gwkasrz+eOWh8WJ2y3z7rvOz2fMoGlmJl1D9+duWCyluAPOFBwMt7y5dnAyLXe3Fuyzj/N/\nNlZkKgyO3LHingKwz85P3Dk9b2Ojv9Xx5Zdk/QFG3Dn6his9yQFE0ufOljU3Q6VbJi/POXKWj8/P\n584PF6dSAGLdMqmIbBH5uWXa2kzqBPc1kvHPRUVk2S9f7nTLBAl59IPP3803k5vM4sTtltl3X+fn\nJ54IvPQSXQeljNj7wR2U7g5YHm/gttzlCzyZlrv7XnG/OPgZZ0MNsJZ7SiELdACxwsFCGYkYf7o7\nhvWoo4C996Z5XoebqvLmc1vutbXGH8wWOkcLuEeWylKDbssdoPU5KmHQIGfImXwZpCKcRx3w71Dl\nCBjA+XCfc47ptGZxZytqyRIqsyfPWbw0A36wuI8ebYt2eOF2y3i1hE4+Ofj+5Ev88stNqmW+p+Xz\nxy1vFvdkWu5ugXY/9zx+hbO0AtZyTykSWbM8ipFjbwEjHozMPigtdx6Qw01MdxqAbdsobpqTgrlz\nwsj1/Sx3GX42YQJZ+qWllJMccHYmbt/euXPTW8gO1fp605IB6NzxcG4Wd/dLipvxLO6AGZW8bp3T\nLXPRRZ0/Pj5/nII2VUq5pQruOPfDD+/e/t5+m6Y8AK2jLOmeoiyyjjIbT/z9yXz5cogt+93dpTHl\nGAqOfOMOfSvuaUB7u0k9GolQx6c72oSFAzDiLi333btJrFmUuKQfQM38vDzjS5TiLkVcirssVOBO\nWctwTg7ArD95ctfOQU/jrhQvBygB5PJascIIt/uFzJ1qLO6VlbSPE08kIZDi3hW3Cp+//Hz6Dvky\nssSmH0hWC9Ev9Fj64WW4azIs9zFjTAQVYPz8gMkTxbgt90GD6AXAo6jjYcW9lxg82MxLq4xFhH22\nDQ1UmcdtuUtx51DKpiYj7tXVzhBJGQd74IHOEnqyI1Ra5TK3DN/c4bB3NXmAalHK4f0AWfSpTlFR\n7PD1SMSEwQGxv9VtuVdV0fk6/niypqTPPWjdXom7ZFyyw+3SHa+skN3hhz+k6fTpzuVe147dMsmy\n3LdsAV591Yj4oEEmZQinpWZY3N39ZNyXFo9Ap0gpNUsptVoptUYpdYPH58VKqeeVUh8qpT5RSl0m\nPtuolPpIKbVcKfVekO/rj0ifr5e4A0aMhw6Ntdx5lCNgBIj9gNJyZ9w5TXJzjbh7jSyVibVkp+6c\nOcEiYfi70sGd4BaGMWPonI4ZQyN3AadlWF9PVv0bbzgtd84nw5k9u2NVyuuQl0duA/lCH+jI6khu\nw6cr+BWU8brHZZ9Wbm5yiqm8/77xm3P0FYfWytaE23LndXj9eCQUd6VUBoD7AZwMYCqAC5RS+7tW\nmw1gpdb6IADHAbhbKcWnqR1AudZ6utY6QR92/0WGOMpml7xReJ0RI+IPApLiLt0y8mJzRAhgRFxW\nWQKclvsrr5jvlyPffvObYFEggweTvz0VLfc1a5zRMu4HeMwYU+PWq5Xy8ss0veceE/5YVWVeiDw6\nWIaodhZpueflAQsX2o5VCbtlANMv0h38EpB5ibuX5Z4MI0bWDeBBgn7iLq11mRwwHkEC12YAWKu1\n3gQASqkFAM4EIFPXaAAd3koUAdiltWaPpoJ1/zjE/d57nZY4w+L51FMkHt/6lve+glju0i3jttb5\nhSLF/YQTzI3N++EbWNaqjAfnv041OMKHkS2TQYPMQCTO7QM4re/DDwfeeYfmOQWDbAWxuLNQdKUG\nqlvc+2IQWCrDbplk4dcq8hpQVFhIgp6fT/dFZqYR5u7AnaIcEMGGg8xj5Lbcx48PbrkHEfdRADaL\n/7eABF9yP4DnlVJfAigEcJ74TAN4VSkVBfCg1vp/Anxnv0OK+9SpZrCMhC/WNdfECuWQIWYgDo+U\nk5a71rF5xGWookxqJTtIWfRHjPA+VqB78dupxiefmE5TwIzU5aydfv0LDMf6S3GPRJwWYFcsS3d0\nEneocrK5gY47g2N38RN3r74OvidkreGmpu6LuyznyGLN9yKnupCZZPllkJVFLwPOGeVHsoacnAxg\nudb6eKXUPiAxn6a1bgAwU2u9TSk1tGP5Kq31Eq+dzBEZp8rLy1HO8Un9gHg3gnvYutcQ57IyEnet\n6aYoLTUpB7x8vZWVRhQ4rpu/g0fBeQ28WbyYCm57HV+qDlDqDFyEWsK59KW487lcsYLO9fz5wPPP\nG3dXNGrEnUNMARJ9+fIICkdLAcaFBtADHWTUcn+nt8TdC3522dfPrpmuuof23hvYsCG+W2biRBrb\n8rvfORP2hcMVaGioQGVl4qisII/rVgBjxf+jO5ZJLgfwawDQWq9TSm0AsD+A97XW2zqWVyqlFoKs\n/oTi3t/ws3o//dTctLKosyyjBzgjZNrayMfNlrsMYWTeE13X7tGkjPTL8w3s9T7tT5a7F9It4xZ3\nbmENGmQih/w6pIGuCTvDL+O8PFO6r6HBijvg9LknAz9xD4X8c73wOJPcXOoTOfjgxCNhvWDXn7Tc\nN22iGPvDDqNrvmED/d15p3Nk+NCh5dhnn3Js20bi/+67t/p+TxAv1lIA+yqlximlsgGcD+B51zqb\nAJwIAEqp4QAmAlivlMpXShV2LC8AcBKAFYHPQj/C78acPNkMmGDL2F37FDA3FouQzATpJe4TJph5\nv1zj7e3BqwTJ4+tPyKpM7e3+naLsZ/fLY9/dJrokP98UG0l21Z90Y/16mkYiyQ0P9Xth+j0H8vrm\n5VFSwK9+tWvfzQYAu1kKCoD77qNl7g5VTnkhn0Eu/9jtaBmtdRTAVQBeAbASwAKt9Sql1JVKqe93\nrHY7gCOVUh8DeBXA9Vrr3QCGA1iilFoO4B0AL2itXwlyAvobQYRRWu5+4l5bS/OcLMzLcl+71gyn\nZrwE+plnzLaybJ8bL6u/v3DKKfT7mptN5xUQW1k+L4+aztyxBjhz6iTTus7LA4YNo/lkF2NOJ7Qm\nF2JjI1ULe/zx5O07iIhL5PWVVbO6ArcO2S1TWGhCpf3EXd5zyexQhdb6JQCTXMvmivltIL+7e7sN\nAA4K8h39HRbneMSz3NvayMfGQ+VlJkhOE8vi7k6q5JdrfNo0I2bxLE+/6jfpzs6d1AK6915g1y5n\nRIZ7hGh+Pp37Zct63nLnFwkwsC13vgYrVlDk2KmnJm/fhx3mvT+/6yhHkXb3mvM9xqGNhYUUMDF9\nemLLXYZC2nzuKQJXWI9HIst9yBAKeWTLnfNRe7llJIsXO4tDM8cea+bjDXePV5MynRk6lKYc/ZDI\ncgeo9JqXuCeqitMZODICGNjiziG7kQjNJ7N1NGwY8OKLscv9vsPLcnffI0Hh7aqqjFhzegN3KCSn\nmZZCXlhoc8ukFOPHJ15nRUdvBIv7zp2U6hcwRTnCYafPXfqA/ULmqqudkTMA7WP2bLOOTJTkpj+6\nYyRe4u5luQPUKuLzzYVPgOSKu+zss+JO929TU/fdIUE46igqQelGfjdf664OZOJ7a8EC45bhYj7u\n1BPRqLPF3NZmOmStuKcIQTqDOLkVi/vMmcYXx+LOHX/SLXPUUbSOO6McANx+u4m8AEwkgHwRaA0c\nfbT/cfELpr/C4i7TqLoHzHjVjn3iCbM8makC2CfLJf0WL3aOQ+gvjBxpsjN6wYPn6uvp3u6NqKHH\nHvNuZSfT5y7FnUeMy2peXIweMG4ZprXVP5GfGyvuvQTXeIzHuefStKCAXgaysrkUd3eHKg/59xL3\nm24CjjnG/L9mTeePvatRAelCTo7Jtx8KURWfSy91riP7HVjQr7++Zyx3jqbg8n7LlsWGxvYHtm83\nqR0kixaRAfP66/R/XV3vWe5uFwgjxb2711q2Ctm119TkFHd23XBBEaa+3lruKUdFReL6qHxBuZiG\nxMty50FMjJe4u0lUfsyL0aPTIyFYV+HOslDIVPFxd5Z5FQY/6STzgL2SxBgwzik+eDBd7+7Ezqc6\nXknATj2VnpXjj6f/6+ro3u4NcfeDaxcAscfR2upd2NoPLrR92GEmEyTgzCED0DqcoI556y1ruacc\nxcVUfDke8+YBr70W63drb49vuTNBxP2KK7p0+P0azpgZZBSxO+aY3Vsyt313WbiQpmy5s1usqx14\nqYxfgrzmZtM/xJZ7qgzmclvu99/fubxKn34KHHecqeMgq55xVFZBgTP7qMRa7mlIcTEl8GJx55BG\nrpnIlpzb584Eefj7W8RLMvAqiuxGumW8Bn4lM//Ln/9M08GD6bhuu43+3707ed+RKsQTd+4fqq8n\nazeZ4aadhVNBA7FiGyQF8EknAT/7mfl/3DiTn0gWxpF5273E/aSTjOWe6HxYcU9BeFANZwbkm7u0\nlOa1NgV+pVgHiaXnEX8WQxBxl9aVVy6frmSC9IMHMJWWOt1z/XFAUzxxl9lP29r6NmrroIPM9ZYG\nVXs7WeKJePVV4JFHaD4Uos5kjnN3u2VqaqiV4iXue+9txD2Rm9eKewrCb3DuhK2pIUGXKQfYDytv\ntCDiPmtW8o833Qki7nyeZfSC7IcIcu6Dwi+Pqio6rjPPpP+5QHJ/wi3ufE45hxJgxL0vB9HNm2da\nTv/3f2Z5OEwRNkHYsYN+X1ubKbIu3Xws7hs3UmezW9y/9S0KumC3TKL7wYp7ipKfT6MmCwtpys00\n7kTlC8w3fF4ecOih8fdZV0fphC1Ogog7I11fso+jJ8T9qKPIDTd6NP3v7mTvD3z0kfN/Pr/hMIlg\naakR9750KebkmCyQclxJfT1wQ0dtukRBB6NGOYvacx1UabnLkFpZqxeg0NsTTjCW+3nnIS5W3FOU\n/HwS8tJSshiam505Jdw95pEIcPXV8fdZVJTcggf9hdzcYCP+AGcYW2ddYkFh8TjgANOBDgyMAU18\nfqW419cnpzhGsuDrM3w4vXh4pHOiouZbt8amE5DRV9Lld+SRzlq9En72E3Uw20c9ReE3+KBBJndM\nPHG3dB2vjJl+cJN8wwYT/VRQABxySPKPZ9iw/i/u7nPO/QoyiKCuru87VCXPPUfT4cNNllYg2PVx\nJ/STQqwAACAASURBVAKThemluMtC7G4Rt+Ke5vBNf+CBdHPvtZcR9+zs1LnR+wOdEfcjj6SpTCfR\n0JDcvgx+wGXoK39Pf8PtyuDfyJZ7WVnqifu++9Lx8IuHXUldEXeZG0om+AuFyA0k3TIMtxgTuYGs\nuKcoLDRFRcbn7lUIO0hsuyU+/HAFGSTD/u+ehN1EnCEwGvUe2JaO8O+ROY6kSHEnIYt7KlruAD2D\nHI4cRNwHD6ZpPMtdintmJj374bD/fZnIFWjFPUVxizunBuWBD0yQbJOW+LBoBBkkk0zfejxkPU05\ngC3dKSqifEdcjCQ721lSctMmmrK4FxeTAdPYmFriDpjyjBzV474+c+YYfzyLuZflzmMkWlpMgER7\nu4mI87ovFy6kPpl4WHFPUfgiFxeTtc61FgHnTc7+eEvX4YcryECk3hJ3wGm5Fxf3D3EHKPspj8Bm\ngWT++U+ass89K4t+/86dqSfubLnzM+i+Pu+/b4rac1JAL8udkR2yq1YZcfdKbXDWWYmjh6y4pyhv\nvUVT6Zbhm1s2Y/tjtsBUJlFR4mSSnU0WXGMjVbrvL+LOwv6Vr8SKO9fwbWhwDlziUZupBB87D05y\nXx+ZpoDdp+FwbLSMex2AUk6wMTd9eteOz4p7isM95llZxrLsqfjqgU4in/bmzcDdd/fOsQB0vQsL\naaBPf3HLAHSe332XLPiiIrJ+lSIXI9f1ZbeMtGxTTdzZcr/4YvrfPYJYiju7Z3bv9rfc5XN98slm\nLEtXc+pYcU9ROBFRYaEZycbIm8B2qCYPmfnPi9Gjk5vaNwh8/blQy6OPmoc+Xamvp+H3RUX0xyM/\nJ040vuZ0EHe23FtaTP+IRN4rubkU6sji7lXTWLpl2tuN5d7VwVuBxF0pNUsptVoptUYpdYPH58VK\nqeeVUh8qpT5RSl0WdFuLNzwarqAgfvbH/lbXtC857LC+PoJYpLg3NAAff5z+UTMNDSR0PFCHXZCA\nU9xbW+n+ZkMn1cR90ybggQfoeSwriy/u0ShFzOzaRb/Jy8X62mtmXop7V5/xhJsppTIA3A/gBABf\nAliqlHpOa71arDYbwEqt9RlKqSEAPlNKPQagPcC2Fg84CoarMnnlbT/hBKoOb0kOnKgtlSgspAFT\nxcVUvCXdrXaARJA7S90hnu3t9BvZcs/ONoVKUk3cZ84EPvssuLg3N1OyL5kq2i+TK58HoOuWe5B3\nwgwAa7XWmwBAKbUAwJkApEBrAFxSoAjALq11m1Lq8ADbWjxYsYIq8HhdYBZ3+aa3dJ9UPJ+cW6i1\nlcSDrbl0Rop7UZEzeRhnPN2+ncQ9P58yMn74Yeq1UgsLKcEZF693izvHp2tN69TXA3feCRx8sFnH\nL2XB4sXdt9yDuGVGAdgs/t/SsUxyP4ApSqkvAXwE4Eed2NbiwdSpwCWXOOtpAjbdQE8Sr45sX8Hh\ncNEoWbMVFX16OElBZnmUPnfA2+fOqR2SmTM/GXCoanOzt7jzM8svAEY+wyzuJ58cm8Kiuz73ZL0L\nTwawXGt9vFJqHwCvKqWmdXYnc+bM2TNfXl6Oco6LGsC4xb2gwD8HtqXrbNtmatGmEtxy+/rXgRde\noBKAixb1fQrc7sKWO/cpMF4+9wkT+u4448FFdT7+mNJRNDRQXd2aGuDBB53FRqS4uwteA8A//mGW\n/eUvVMzDS9wrKipQEfANH+T22ApgrPh/dMcyyeUAfg0AWut1SqkNAPYPuO0epLhbCPcF5jJcluSS\nquMFOGSOS+6x2NfW9m7MfbJga1f63GtrScwyMrwt9+uvB77znb4+8li4P2zcOMoB9dZbwMMPkxtN\nijtXT2O8ImTksiuvdH7PRx+ZerJuo/fWW2/1Pb4gbpmlAPZVSo1TSmUDOB/A8651NgE4EQCUUsMB\nTASwPuC2ljjww8yWu8z3bOn/uMX9//0/+t+rsHQ6wJ2MX3xhspvu2kURMbW1ZOGyrzoSoXVCodR8\n+bLl3tREx9fQQL+Fee89mrLl/vDD9Pv9wh/9mDSpa8eX0HLXWkeVUlcBeAX0MnhIa71KKXUlfawf\nBHA7gHlKqY87Nrtea70bALy27dqhDkw4QoDf/P2hQ80SHBbDwkLqmMvLoxGr6SruLNw8MI+L0kyd\nSuMMmpponYKC2PEdqQZb7qGQd7QMd9BzConBg+nayd/08ceIy8qVwOTJXTu+QKdOa/0SgEmuZXPF\n/DaQ3z3QtpbgcCcSJ1d6+GHKO2EZGLC4c1bQU08F/vrX9HXNcWdiTQ2JHYv4Cy/Q8qefBr72tfQQ\nd7bc8/O900OMGEFRP2y589gV/k2ZmYmrKXHNgK5gR6imCVxh/eCDgYsu6ttjsfQe7JbhxHFssaer\n5c4diOxycbsZ33vPWO41Nakt7pwSJBJxijsXOD/iCJrK5G+A+U1tbdSf0FNYcU8TZFpUy8CBLXd3\nZEm6Wu6trcD++xvhZjfjT39q1snJMS+yVA/9zc8nkZbizonRZA1YILbucU9jxT1N4BvGMrDgPhd2\ny9TUOC34rvL2211PSNUdWltJ8Fi4ZcuEycuj3/j556bFmqrwy6mkxCQOk+JeUkLXLDPTO1lYT2LF\nPU1I9Zvc0jOwG4MzCdbXk6+6u5b7J58Ei9RINi0tJO5suUtx/81vaJ4tdwBYt673j7EzcAcxW/CA\nCX5gy722lsS9uyNOO4sV9zTBumUGJmxdK2XEvays+5Z7X+Vp4aLXbrdMVpYZRMY+d8DUrE1V5PWR\nuWS0dop7RoYVd4sP1i0zMJFCIMW9u5b77bd3b/uuEs9yZ5+0FPeuDr3vLdzuJICOmQdhSbeMVybI\nnsSKe5rQF01oS98jxT0vjyxfttznzQNuuaVr++XY6d4SGv6u9nbKvhmNmkFMgOkwBpxumVQXd5nv\nhl9Ugweb2qolJcYt41Vspyex4p4msD/PMrBwW+6Asdx/9Svgttvib9/W5p1s7NNPadqbfTnt7eSe\nkFEj7lBPgDKipou4y/PHLpqSEoqQ+c9/6GXMljtjxd2yh1TLY23pPQ480IQDSnFftSpYbveKCuC4\n42KXc2m43izdF43Gijvf2xUVZvmZZ6aPuEuh5usk68Lm5hrL3WubnsSKexqQ6rG+lp5jyhTjkuPI\nDICyWAYRdxbJSIQqB/GQeLY43XU/e5L2dv+okZdectYu6O3Ox64ij4/ni4vpvJaUAKed1neWe4qf\nOgsAPPWU7VC1AL/9LU3335+EQ+YZ0hp49VXgpJOc27BlXFdHaWl5XRaYvrbcmVtuMcuVSh/LXRpe\nfKxsuctoGflifv313jk2K+5pwKxZfX0EllSCO+ykuG/dSgUf3B2knEfcHTrZl5a7W9y5wlRVFf2f\nTuIuX1B8rouKTEESTl8s0yy4i3L0FNYtY7GkCX/6E01zcvxHl7qjqngQVF0dcNRRZnlfWu5sxboz\nnaa75V5dTVN2y7C4Nzc7fwfXhO1prOVusaQJHL64cqUREMDpZuE4eIajrNyuAbl+b8GWO79w3JE6\n/MKKRtNT3LdsoanbcpfrTZ8OXH557xybFXeLJU1goTjvPODqqymdLEAiyWJdV+ct7nV1zhGULS3k\nKohnud99N1na117rv86bb1Kn75AhiY/fbbm7+5E4DryyMn3E3ev4uOi3HJXK4v7BB713bNYtY7Gk\nCWzZuoW0ttbfEpeWO+dM15rypkci8S33n/wE+PGP4x/TscfGF38JW+7sHvJKqfHll1SoXI72TGX+\n+ldKwiYpLiYXTShkXmR9EfVjLXeLJU1gi5wjTtjqrqlxWu4S6XMvK6OqR5EIcNBB9Fk8y7201PiR\n4xHUb8+Wu1IUxXP44bHrjBxJ03QR97Fj6U9SVATs3k3HzuUxZYHs3sKKu8WSJowcaaJhzjoLeOwx\nmg9quR9wAA0Wqq4m67+1Nb7lHlTcg4bp8ghVIHGsd7qIu+TZZ+mcam0sd2bjxt4/HuuWsVjSEA6t\nGzQovuUufe7cgVlTY3K8JLLcvVi2zBlamUjca2roOKLR4GLN4s4tj3TgzDOBc85xumWYvhinEkjc\nlVKzlFKrlVJrlFI3eHz+E6XUcqXUB0qpT5RSbUqpko7PNiqlPur4/L1k/wCLZSDCHXVcLPuee+h/\ntyXO4sjWfW4uiS2XfUtkuXtx6KE0iIpJJFylpcAVV9CxbN4cf12GfdVBRuGmGkVFseLeFyQUd6VU\nBoD7QQWwpwK4QCm1v1xHa/07rfV0rfXBAH4GoEJrzUlJ2wGUd3w+I7mHb7EMTNhy5+HtL71E/9fV\nAe+/D1x4If3f1kYiU1dH4jp0KAlPEMudo3MS+YvDYZpu2mTcRm+/bQYlAcCiRcD69Z3/feyDTyfS\nRtwBzACwVmu9SWvdCmABgDPjrH8BgL+J/1XA77FYLAFhd8tee5G4H3oo/V9fDxx2GPC3v5n1OEVw\naysVb5Zumfp6YPZs4MknY79j4UKaul09blj8x4+n0EgAmDkTuOYas87OncDw4eT3D0J+ft90QiYD\nL7dMXxBEdEcBkI2pLR3LYlBK5QGYBeBpsVgDeFUptVQp9b2uHqjFYjF88glNhw4lgT7oIGDiRG+f\n++DBtLylxSnuxcVkuf/pT8Dvfx/7HWy5e1V9GjbM+7gqK818fb2x5IuLO+dzB0zna7rB541/69at\n3a+c1RWS/W45HcAS4ZIBgJla621KqaEgkV+ltV7itfGcOXP2zJeXl6O8vDzJh2ex9A9Gj6bpoEHk\n7vjsM4qAqa8HrruOBiABprjH7t1Ot0w0aix3gCxrN/vuCyxfTsJ0113UIuBHkl0xgNPClrHrjY3G\n53/SSZ0X93SFxZ2Ttu21V/L2XVFRgQqvBP0eBBH3rQBkJOfojmVenA+nSwZa620d00ql1EKQmyeh\nuFssFn9kBsK6OuDf/ybBHzPG6admt8zGjUbcvaJltno80VqTe6S2Frj+erMMcKYOcAu6nGf3UWXl\nwBF3Ho3aE24lt9F76623+q4bpOGzFMC+SqlxSqlskIA/715JKTUIwLEAnhPL8pVShR3zBQBOArAi\n0K+wWCy+sBhzxMsRR1ABDpktsr3dpJ2VHao7dzp97kDsQByAhJzLxEkyM53CJa14GTnT2GjWG0ji\nzvR1GGdCy11rHVVKXQXgFdDL4CGt9Sql1JX0sX6wY9WzALystZaDiocDWKiU0h3f9bjW+pXk/gSL\nZeDx+OPkd6+vJ+Fubibhlj73hgYS90GDSHRzcykU8fHHqcKTtNy9avRqTeuwuO/fESPntkiluPtZ\n7p9+OvDEva/rHgfyuWutXwIwybVsruv/RwE86lq2AcBB3TxGi8XiorCQrPV33jEDlLhzVeZwj0TI\nTaA1zZ92Gr0UqqtpHzz4yUuI2tupM5Y7Sd2dteyiCYWMqLvFPRqlfezeTcc2kMS9tyou+WHTD1gs\naQz73FtbqUO1rs4p7m+/TSKdn29Kv4XDxoouKKDlXi4EjrThFARffknTnBwSrnCY9jF4MOWsAWKt\n+GiUxH/kSFpnIIm7V2K03iRNg40sFgtAPnfOHc4VmqS4H3ggRarwiM/iYhJgHtzE/nm23H/+c+D2\n22k+GqXO2JqO2LeDDyZrvaWFXiSVldQqKC010TbSut++3XzPtm3A0qUDS9zd+ep7GyvuFksawx2q\n0ajpOJXizhY6h+UVFBhxz8oyI0HZhXDHHcDNN9M8u1RY3CMRsvAzM0ncd+ygfaxaBbz4ovlOprDQ\n6We///6BI+6pUNTeirvFksZw6t/WVhLu9nbgiy/os9pak0OdxaaggESaLWq3uEvc4l5TQ1Z7Tg5Z\n9Nu2mf3+4hfmO5nmZvoeKegDRdxl1au+wvrcLZY0JjPTxKKHQmTJP9oR1sCWe0ZGrOWek+MUdyA2\nCoZdPVxViJOPZWdTRaEXXjD7Zdgtk5FBL5zWVvqec8+lWPu+HpLfW+Tl9W4JQy+s5W6xpDlFRdR5\nl5lpRkcCTrcMW9i5uWR9NzfHirtbjHgUa10dtRC4uEdODn3fI4/Euh9k/ve8PPo/M5Pqv4bDA0fc\nuS+jL7HibrGkOcXFNGUrfuhQYMYMEmV2y7CoKkXr1NU5O1Q5uZiE0wLv2kVCXVJCfvbsbErhW15O\n4v4//0PrFxaSla81fW9Zmel0LSqiWPenn8aAQNar7SusuFssaQ6LeyhEotLSQqGHXm4ZgAS9tdXZ\noTp0qFPcW1vNAKhdu8jiLy0lcc/JAaZNMy2CadNo2fDhJld8RoZJfcviDgCzZvXOOelrZIuor7Di\nbrGkOSwkmZkk7lwv1cstAxhrPRQyy3n9adPo/6oq45ZpbDTivn07CfmgQbQOC3dzMy3T2sS/cy3R\n7GxTdGPChN45J32NtdwtFku3YZdLXh79ae1M85uR4SzKwS+DUMik1eU0A83NJMycC4ZbBdJyz86m\n9dnlwsKdk0PrVFXRPgoLSdyl5Z4KUSS9wSOPAC+/3LfHMEC6NyyW/ovspGThLisjcX/+ecq9PmiQ\nWUda7rwti3tTE2WXrKwkt4xb3N94gyJlWNzHjjXinpVFfvmqKtqvtNxZ3Ps630pvsc8+9NeXWMvd\nYklzPv7YzLM7gC33004Djj2WUgIzOTk0zciIFfe6OhLsykryu0t//uDBZM0rReu3ttK+WNzffJNE\nvLLS6ZaR1n1fD8kfSFjL3WJJc6Srg8WdC3c0Nsb6f2Xnqlvcq6vpRdDSYiJtAOO7X7GCOkW5JZCT\n4/Tnv/8+8K1v0XcWFVEhEWm5T3KkH7T0JNZyt1jSHNlJyUI+YgRZ4f/6F3VwXnedWUeKO4u3TO07\nYQK1BrKyyEoHyEVz333Gz84WPbcCJI2N9NLw8rl7rW/pGay4Wyxpjhy45BZ3gCzwO+4ANmyg//0s\n9927yVXzy18CJ5zgtMjb2ijFMG/Dlrvc16WXAuefT4nK2C2za5fTcrfi3ntYcbdY0hwp7rJDtaWF\nRP6ww0hUx4+nz/zEfccOcvGsXQv84x9OcY9Ggdtuo/msLPOZHJQ0bhxw5JG0D7fPnTtx3ekKLD2H\nFXeLJc2ZMsXMs+Wen0+uk9paE+7IyOgaKe47d9JL4NRTaZlb3GWUjRctLbSOjG2vqaH9sPuHKzNZ\neh4r7hZLmnP99SanCws5+7k554xE/n/11cDcuU7LfdQosw+mrc2Iu1862/32I0GvqqL9cItCWut9\nXVd0IBFI3JVSs5RSq5VSa5RSN3h8/hOl1HKl1AdKqU+UUm1KqZIg21oslu6RkUHx5YDTqmYr3m25\nS3Hfay/g+9834p6T44xtZxJZ7m1twOWX0zqcroDFXb4MuKiHpedJKO5KqQwA9wM4GcBUABcopfaX\n62itf6e1nq61PhjAzwBUaK1rgmxrsViSh5e4x7PcGVlEm0WcO2ABEnc5WAkApk8HjjvO7FMpWq+y\nkl4S7P+XljuX6rP0PEHi3GcAWKu13gQASqkFAM4EsNpn/QsA/K2L21oslm7gNVo1nuXOyLh1Dn+U\neFnu774bu15VldmP242zbp3p1LX0PEHEfRSAzeL/LSDRjkEplQdgFoDZnd3WYrF0H+kC8bPcvfDy\njzO33UZZJmWCMvd3MWVlNA2HYyNkBkrSsFQh2SNUTwewRGtdk6wdjh8/Hps2bUrW7iyWAYG0vtkf\nH28dZulSWp6TMw65uRsBmJqqTLyIl4MPpun27Yk7YC09SxBx3wpgrPh/dMcyL86Hccl0dlvMmTNn\nz3x5eTnKy8uxadMmaK0DHKbFYkkWSqkYdw7jVW+VGTOGplu2ePvcLd2joqICFRUVgdZViYRTKZUJ\n4DMAJwDYBuA9ABdorVe51hsEYD2A0Vrrxs5s27Gu9joWpZQVd4ullyFx1zF1VZWikajz5sXblqbs\nmvn974Frr+2xQx3QdOijRxssgOWutY4qpa4C8AoouuYhrfUqpdSV9LF+sGPVswC8zMIeb9tu/h6L\nxdILtLd7L49nuUs64/O3JJ9APnet9UsAJrmWzXX9/yiAR4Nsa7FY0peg4i6Tjll6HztC1WKxdIqF\nC+N//thjzhzzdlRq32DF3WJJwJo1azB9+nQMGjQI999/f18fTq/hVzWJwx39uOgi4IADEu/H0rNY\nce8GS5YswcyZM1FSUoIhQ4bg6KOPxrJlywAAjz76KI4++ug+PsLg9Kff8txzz2H69OkoKSnBsGHD\ncOKJJ3YrnPa3v/0tjj/+eNTW1uKqq65K4pEmpqKiAhkZGbjrrrt69XsB7xDGN94AVq7s3H6s5d43\nWHHvIvX19Tj99NPxox/9CNXV1di6dStuueUW5HQkrNZaQ3kFEgck6g5T6EH6029Zt24dLr30Utxz\nzz2oqanBhg0bMHv2bGR2oVePj3vTpk2YOnVqsg81EPPnz0dZWRnmz58fd73eOsfHHAMMH965bay4\n9xFa65T4o0OJxW95X/P+++/r0tJSz89WrVqlc3NzdSgU0oWFhXvWq62t1RdffLEeOnSoHj9+vL79\n9tv3bDNv3jw9c+ZMfe211+qysjJ9880363Xr1unjjz9el5WV6aFDh+qLLrpI19bW7tlm2bJlevr0\n6bq4uFife+65+rzzztM333zzns9feOEFfdBBB+mSkhI9c+ZM/fHHH/f73/LUU0/p6dOne36mtdaX\nXXaZY78VFRV69OjRe/4fP368vvPOO/W0adN0bm6uPuGEE3RmZqbOzc3VRUVFeu3atfrFF1/cc6xj\nx47Vc+bMcXzHv//9b33kkUfqkpISPXbsWP3oo49qrbVubm7W1113nR47dqweMWKE/sEPfqCbmpp8\njzUcDuuioiL9xBNP6JycHL1s2bI9n23cuFErpfRDDz2kx44dq4899littdb/+c9/9nz3QQcdpCsq\nKvZs88gjj+jJkyfroqIivc8+++i5c+f6fneynjtA6+uuS8quLB50XCdvTfX7oLf/0k3c6+rq9JAh\nQ/Sll16qFy1apKurqx2fz5s3Tx999NGOZRdffLE+66yzdDgc1hs3btQTJ07UDz/88J71Q6GQfuCB\nB3Q0GtVNTU36888/16+99ppubW3VVVVV+thjj9XXXnut1lrrlpYWPW7cOH3ffffptrY2/cwzz+js\n7Ow9wvXBBx/oYcOG6aVLl+r29nY9f/58PX78eN3S0qK11vqHP/yhnj17dr/4LZL169frvLw8fe21\n1+rFixfrhoYGx+de4j5mzJg9/48fP15Pnz5db926dY/wlpeX64ceemjPOm+88YZesWKF1lrrTz75\nRI8YMUI/99xzWmsSXRbktrY2vXv3bv3RRx9prbW+5ppr9Jlnnqlramp0Q0ODPuOMM/SNN94Y8xuY\n+fPn67322ku3t7fr008/XV999dV7PmNxv/TSS3UkEtFNTU1669atuqysTL/00ktaa61fe+01XVZW\npquqqrTWWv/zn//UGzZs0Fpr/eabb+r8/Hy9fPlyz+9O1nP39NNab9uWlF1ZPOjX4g4k568rrF69\nWl9++eV6zJgxOisrS59xxhl6586dWutYQYxGozo7O1uvXr16z7K5c+fq4447bs/648aNi/t9zz77\nrD744IO11iQw0uLUWuujjjpqj3D94Ac/0L/4xS8cn0+aNEm/+eab/f63vPvuu/q8887Tw4YN03l5\nefqyyy7T4XBYax1M3OfNm+fYn1vc3VxzzTX6xz/+sdZa61//+tf67LPP9lyvoKBAr1+/fs//b7/9\n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\nJaNm5QAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x23ca82b0>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "surface_area = v.retrieve_multiple_time_series(criteria={'RecordingVariable':'Storage Surface Area'})\n",
    "surface_area.plot()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Note:** We again drop all runs before moving on..."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 38,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "v.drop_all_runs()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Manipulating model setup and the ‘Allow Scripts’ option\n",
    "\n",
    "There are various ways to use veneer-py to change the configuration of the currently loaded model in Source\n",
    "\n",
    "1. Methods to update input sets with new parameters (`v.update_input_set`)\n",
    "2. Applying a particular input set (`v.apply_input_set`)\n",
    "3. Use functionality under `v.model.` to directly change model parameters and structure\n",
    "\n",
    "It is also possible to modify files on disk where Source is configured to 'Reload-On-Run', such as changing time series files or input set command files. This option isn't specific to Veneer/veneer-py and isn't covered in these tutorials.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can update the input set commands for the default input set.\n",
    "\n",
    "(Making a single change like this can be a bit fiddly!)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 39,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'Configuration': ['Nodes.Ungauged Inflow.Elevation = 50 m',\n",
       "  'Nodes.Storage.Elevation = 15 m',\n",
       "  'Nodes.MFR.Elevation = 5 m'],\n",
       " 'Filename': None,\n",
       " 'Name': 'Default Input Set',\n",
       " 'ReloadOnRun': False,\n",
       " 'URL': '/inputSets/Default Input Set'}"
      ]
     },
     "execution_count": 39,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "default_input_set = v.input_sets()[0]\n",
    "default_input_set"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 40,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'Nodes.Ungauged Inflow.Elevation = 50 m'"
      ]
     },
     "execution_count": 40,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "command_of_interest = default_input_set['Configuration'][0]\n",
    "command_of_interest"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 41,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "default_input_set['Configuration'][0] = command_of_interest.replace('25 m','50 m')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 42,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'Configuration': ['Nodes.Ungauged Inflow.Elevation = 50 m',\n",
       "  'Nodes.Storage.Elevation = 15 m',\n",
       "  'Nodes.MFR.Elevation = 5 m'],\n",
       " 'Filename': None,\n",
       " 'Name': 'Default Input Set',\n",
       " 'ReloadOnRun': False,\n",
       " 'URL': '/inputSets/Default Input Set'}"
      ]
     },
     "execution_count": 42,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "default_input_set"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 43,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "(200, None)"
      ]
     },
     "execution_count": 43,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "v.update_input_set('Default Input Set',default_input_set)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**At this point, you can check in the Source user interface (Edit|Scenario Input Sets) to see that the input set has been updated. Alternatively, you can query the input set again**"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 44,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[{'Filename': None, 'ReloadOnRun': False, 'Configuration': ['Nodes.Ungauged Inflow.Elevation = 50 m', 'Nodes.Storage.Elevation = 15 m', 'Nodes.MFR.Elevation = 5 m'], 'Name': 'Default Input Set', 'URL': '/inputSets/Default Input Set'}]"
      ]
     },
     "execution_count": 44,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "v.input_sets()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The Default Input Set would be applied when we next run, but if we want those parameters set on the model immediately, we can do so, with `v.apply_input_set('Default Input Set')`"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 45,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "(200, None)"
      ]
     },
     "execution_count": 45,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "v.apply_input_set('Default Input Set')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### `v.model` and the Allow Scripts option\n",
    "\n",
    "The `v.model` namespace contains a lot of functionality for modifying the structure of the Source model. This part of veneer-py works by generating IronPython scripts, which run directly within Source and manipulate the .NET objects that Source is built upon.\n",
    "\n",
    "This capability (to accept IronPython scripts) is disabled, by default, in Veneer. To enable it, click the 'Allow Scripts' checkbox in the Web Server Monitoring window. **If you don't enable the 'Allow Scripts' option, then the following instructions will give an error.**"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "As an example of what can be done, the following command queries the routing model used for each link"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 46,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "['RiverSystem.Flow.StraightThroughRouting',\n",
       " 'RiverSystem.Flow.StorageRouting',\n",
       " 'RiverSystem.Flow.StraightThroughRouting',\n",
       " 'RiverSystem.Flow.StorageRouting',\n",
       " 'RiverSystem.Flow.StraightThroughRouting']"
      ]
     },
     "execution_count": 46,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "v.model.link.routing.get_models()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This shows that, for the example model, there are three Straight Through Routing links and two Storage Routing links.\n",
    "\n",
    "`get_models()` has returned a list - and this is common within the `v.model` namespace. It's also common for functions to accept a list when changing the Source model (eg by changing assigned models, or changing parameters).\n",
    "\n",
    "The list isn't directly useful though, because it doesn't tell you which link is which. That can be checked by asking for the results coded by name"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 47,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'Default Link #4': 'RiverSystem.Flow.StraightThroughRouting',\n",
       " 'Default Link #5': 'RiverSystem.Flow.StraightThroughRouting',\n",
       " 'Default Link #6': 'RiverSystem.Flow.StraightThroughRouting',\n",
       " 'SR2': 'RiverSystem.Flow.StorageRouting',\n",
       " 'SR3': 'RiverSystem.Flow.StorageRouting'}"
      ]
     },
     "execution_count": 47,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "v.model.link.routing.get_models(by_name=True)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## PEST and Parallel processing\n",
    "\n",
    "[PEST](http://www.pesthomepage.org/) is a powerful, model independent Parameter ESTimation tool. veneer-py has some initial functionality for configuring and running PEST jobs over Source models using Veneer.\n",
    "\n",
    "This functionality is currently the best demonstration of parallel processing using Veneer and veneer-py. This is explored in Tutorial 8.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## GUI and Command Line\n",
    "\n",
    "Veneer is distributed with a command line program, `FlowMatters.Source.VeneerCmd.exe`, which is an alternative to the eWater supplied `RiverSystem.CommandLine.exe`. The Veneer command line uses the same protocols as the plugin version of Veneer, making them interchangeable for most applications.\n",
    "\n",
    "**Note:** To use the Veneer command line, it needs access to all of the DLLs distributed with Source. Currently, this means that the Veneer command line, and the various DLLs related to Veneer, need to be in the same directory as these eWater supplied files. You can copy all of the eWater files into the Veneer directory, or copy all the Veneer files into the Source installation directory (typically under `C:\\Program Files\\eWater\\Source X.Y.ZZ.WWWW`). Importantly, if copying the Veneer files to the Source directory, the Veneer files must be in the same directory as the *main* Source files (eg `RiverSystem.Forms.exe`), **not** in the plugins directory"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Starting the Veneer Command Line from Python\n",
    "\n",
    "veneer-py includes a function, `start` (under `veneer.manage`) for starting one or more copies of the Veneer command line using a given project file."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 48,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "from veneer.manage import start"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 49,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Help on function start in module veneer.manage:\n",
      "\n",
      "start(project_fn, n_instances=1, ports=9876, debug=False, remote=True, script=True, veneer_exe=None)\n",
      "    Start one or more copies of the Veneer command line progeram with a given project file\n",
      "    \n",
      "    Parameters:\n",
      "    \n",
      "    - project_fn - Path to a Source project file (.rsproj)\n",
      "    \n",
      "    - n_instances - Number of copies of the Veneer command line to start (default: 1)\n",
      "    \n",
      "    - ports - A single port number, indicating the port number of the first copy of the Veneer command line,\n",
      "              OR a list of ports, in which case len(ports)==n_instances  (default: 9876)\n",
      "    \n",
      "    - debug - Set to True to echo all output from Veneer Command Line during startup\n",
      "    \n",
      "    - remote - Allow remote connections (requires registration)\n",
      "    \n",
      "    - script - Allow IronPython scripts\n",
      "    \n",
      "    - veneer_exe - Optional (but often required) path to the Veneer Command Line. If not provided,\n",
      "                   veneer-py will attempt to identify the version of Veneer Command Line to invoke.\n",
      "                   If there is a source_version.txt file in the same directory as the project file,\n",
      "                   this text file will be consulted to identify the version of Source.\n",
      "    \n",
      "    returns processes, ports\n",
      "       processes - list of process objects that can be used to terminate the servers\n",
      "       ports - the port numbers used for each copy of the server\n",
      "\n"
     ]
    }
   ],
   "source": [
    "help(start)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Each copy of the Veneer command line is a copy of the Source engine with a Veneer server.\n",
    "\n",
    "Each running process will run until terminated, either by the user or by the end of the Python session."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Local and Remote connections\n",
    "\n",
    "Veneer communicates via network ports, but by default, these connections are restricted to local machine - ie you cannot connect to Veneer on machine A from a Python notebook running on machine B.\n",
    "\n",
    "If you want to allow remote connections, you need to enable the checkbox in the Web Server Monitoring window. However, in order to do so, you will first need to register the Veneer URL with Windows. Instructions are at [https://github.com/flowmatters/veneer](https://github.com/flowmatters/veneer)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Getting help\n",
    "\n",
    "Many of the functions in veneer-py have built in documentation, which can be accessed in Jupyter/IPython using the `?` command, such as:\n",
    "\n",
    "```\n",
    "v.network?\n",
    "```\n",
    "\n",
    "Alternatively, you can use the `help()` function, as in:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 50,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Help on method network in module veneer.general:\n",
      "\n",
      "network() method of veneer.general.Veneer instance\n",
      "    Retrieve the network from Veneer.\n",
      "    \n",
      "    The result will be a Python dictionary in GeoJSON conventions.\n",
      "    \n",
      "    The 'features' key of the returned dictionary will be a SearchableList, suitable for querying for\n",
      "    different properties - eg to filter out just nodes, or links, or catchments.\n",
      "    \n",
      "    Example: Find all the node names in the current Source model\n",
      "    \n",
      "    v = Veneer()\n",
      "    network = v.network()\n",
      "    nodes = network['features'].find_by_feature_type('node')\n",
      "    node_names = nodes._unique_values('name')\n",
      "\n"
     ]
    }
   ],
   "source": [
    "help(v.network)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "`<tab>` completion is one of the nice features of Jupyter.\n",
    "\n",
    "In this way, you can navigate veneer-py (and other Python packages) to discover relevant functions:\n",
    "\n",
    "```\n",
    "v.model.<press tab>\n",
    "```"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.4.4"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 0
}