Chapter8_Practical_Part2.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {
    "toc": "true"
   },
   "source": [
    "<h1>Table of Contents<span class=\"tocSkip\"></span></h1>\n",
    "<div class=\"toc\"><ul class=\"toc-item\"></ul></div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# 8. Assessed Practical"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 8.1 Introduction"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 8.1.1 Task overview"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "These notes describe the practical work you must submit for assessment in this course.\n",
    "\n",
    "The practical comes in two parts: (1) data preparation (50%); (2) modelling (50%). \n",
    "\n",
    "**It is important that you complete both parts of this exercise.**\n",
    "\n",
    "The submission for Part 1 of the coursework (worth 50% of the marks) is the Monday after Reading week (12:00 Noon). That is Monday $12^{th}$ November 2018. \n",
    "\n",
    "The submission for Part 2 will be $7^{th}$ January 2019 (12:00 Noon). Submission is through the usual Turnitin link on the [course Moodle page](https://moodle-1819.ucl.ac.uk/course/view.php?id=2796#section-4).\n",
    "\n",
    "\n",
    "- **Part 1: Data Preparation**\n",
    "  \n",
    "     The first task you must complete is to produce a dataset of the proportion of HUC catchment 13010001 (Rio Grande headwaters in Colorado, USA) that is covered by snow for **two years** (not necessarily consecutive), along with associated datasets on temperature (in C) and river discharge at the Del Norte monitoring station. You will use these data in the modelling work in Part 2 of the coursework.\n",
    "     \n",
    "     You **may not** use data from the years 2005 or 2006, as this will be given to you in illustrations of the material.\n",
    "\n",
    "    The dataset you produce must have a value for **the mean snow cover, temperature and discharge in the catchment for every day over each year.**\n",
    "\n",
    "    Your write up **must** include fully labelled graph(s) of snow cover, temperature and discharge for the catchment for each year (with units as appropriate), along with some summary statistics (e.g. mean or median, minimum, maximum, and the timing of these). \n",
    "    \n",
    "    You **must** provide evidence of how you got these data (i.e. the code and commands you ran to produce the data).\n",
    "    \n",
    "**Checklist:**\n",
    "    \n",
    "    * provide fully commented/documented code for all operations.\n",
    "    * provide two years of **daily** data (not 2005 or 2006)\n",
    "    * Generate datasets of:\n",
    "        * mean snow cover (0.0 to 1.0) for the catchment for each day of the year\n",
    "        * temperature (C) at the Del Norte monitoring station for each day of the year\n",
    "        * river discharge at the Del Norte monitoring station for each day of the year\n",
    "    * Produce a table of summary statistics for each of the 3 datasets (one for easch year)\n",
    "    * produce graphs of the 3 datasets for each year (as function of day of year)\n",
    "    * produce an `npz` file containing the 3 datasets, one for each year.\n",
    "    * produce images of snow cover spatial data for the catchment for **13 samples** spaced equally through the year, one set of images for each year. You need to do this for the data pre-interpolation and aftyer you have done the interpolation.\n",
    "    \n",
    "    \n",
    "- **Part 2: Modelling**\n",
    "\n",
    "    You will have prepared two years of data in Part 1 of the work. \n",
    "    \n",
    "    If, for some reason, you have failed to generate an appropriate dataset, you may use datasets that will be provided for you for the years 2005 and 2006. There will be no penalty for that in your Part 2 submission: failure to gernerate the datasets will be accounted for in marks allocated for Part 1.\n",
    "    \n",
    "    You will be given a simple hydrological model of snowmelt.\n",
    "    \n",
    "    Use one of these years to calibrate the (snowmelt) hydrological model and one year to test it. \n",
    "    \n",
    "    The model parameter estimate *must* be objective (i.e. you can't just arbitrarily choose a set) and optimal in some way you must define (you *must* state the equation of the cost function you will try to minimise and explain the approach used).\n",
    "    \n",
    "    You **must** state the values of the model parameters that you have estimated and show evidence for how you went about calculating them. Ideally, you should also state the uncertainty in these parameter estimates (not critical to pass this section though).\n",
    "    \n",
    "    You **must** quantify the goodness of fit between your measured flow data and that produced by your model, both for the calibration exercise and the validation.\n",
    "    \n",
    "**Checklist:**\n",
    "    \n",
    "    * Provide a site intoduction and an introduction to the purpose of the exercise ('Introduction')\n",
    "    * Provide an introduction to the modelling and calibration/validation ('Method') \n",
    "    * provide code that reads in the datasets and performs the model calibration and validation ('Code')\n",
    "    * Provide a table of results on model parameter calibration (and ideally, uncertainty) ('Results')\n",
    "    * Provide graphs of the observed and modelled river discharge data for the calibration year ('Results')\n",
    "    * Provide graphs of the observed and modelled river discharge data for the validation year ('Results')\n",
    "    * Assess the accuracy of the calibration and validation ('Results')\n",
    "    * Discuss the results in the light of the introduction ('Discussion')\n",
    "    * Draw conclusions about issues associated with modelling of this sort ('Conclusion')\n",
    "    \n",
    "\n",
    "You **must** work individually on this task. If you do not, it will be treated as plagiarism. By reading these instructions for this exercise, we assume that you are aware of the UCL rules on plagiarism. You can find more information on this matter in your student handbook. If in doubt about what might constitute plagiarism, ask one of the course convenors."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 8.1.2 Purpose of the work\n",
    "\n",
    "The hydrology of the Rio Grande Headwaters in Colorado, USA is snowmelt dominated. It varies considerably from year to year and may very further under a changing climate.\n",
    "\n",
    "We can build a mathemetical ('environmental') model to describe the main physical processes affecting hydrology in the catchment. Such a model could help understand current behaviour and allow some prediction about possible future scenarios.\n",
    "\n",
    "**What you are going to do is to build, calibrate and test a (snowmelt) hydrological model, driven by observations in the Rio Grande Headwaters in Colorado, USA**\n",
    "\n",
    "![](images/calibrate.png)\n",
    "\n",
    "![](https://www.blm.gov/sites/blm.gov/files/hero_backgrounds/NM_Rio_Grande_del_Norte_Sign_640.jpg)\n",
    "\n",
    "The purpose of the model will be to describe the streamflow at the Del Norte measurement station, just on the edge of the catchment. You will use environmental (temperature) data and snow cover observations to drive the model. You will perform calibration and testing by comparing model output with observed streamflow data.\n",
    "\n",
    "### 8.1.2.1 Del Norte\n",
    "\n",
    "The average climate for Del Norte is:\n",
    "\n",
    "![](images/usco0103climatedelnorte.png)\n",
    "\n",
    "Further general information is available from various [websites](http://www.usclimatedata.com/climate.php?location=USCO0103), including [NOAA](http://www.ncdc.noaa.gov).\n",
    "\n",
    "![www.coloradofishing.net](http://www.coloradofishing.net/images/fishtails/ft_riogrande3.jpg)\n",
    "\n",
    "\n",
    "\n",
    "You can visualise the site Del Norte 2E  [here](http://mesonet.agron.iastate.edu/sites/site.php?station=CO2184&network=COCLIMATE).\n",
    "\n",
    "\n",
    "### 8.1.2.2 Previous work\n",
    "\n",
    "In part 1, you should have developed datasets for two years for:\n",
    "\n",
    "    * mean snow cover (0.0 to 1.0) for the catchment for each day of the year\n",
    "    * temperature (C) at the Del Norte monitoring station for each day of the year\n",
    "    * river discharge at the Del Norte monitoring station for each day of the year\n",
    "    \n",
    "You should use these datasets in part 2 of this work.\n",
    "\n",
    "If for some reason, you are unable to do that, you may use the datasets provided here:\n",
    "\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<matplotlib.legend.Legend at 0x10e269be0>"
      ]
     },
     "execution_count": 2,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 720x504 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "# load a pre-cooked version of the data for 2005 (NB -- Dont use this year!!!\n",
    "# except perhaps for testing)\n",
    "\n",
    "# load the data from a pickle file\n",
    "import pickle\n",
    "import pylab as plt\n",
    "import numpy as np\n",
    "%matplotlib inline\n",
    "\n",
    "pkl_file = open('data/data2005.pkl', 'rb')\n",
    "# note encoding='latin1' because pickle generated in python2\n",
    "data = pickle.load(pkl_file, encoding='latin1')\n",
    "pkl_file.close()\n",
    "\n",
    "# set up plot\n",
    "plt.figure(figsize=(10,7))\n",
    "plt.xlim(data['doy'][0],data['doy'][-1]+1)\n",
    "plt.xlabel('day of year 2005')\n",
    "\n",
    "# plot data\n",
    "plt.plot(data['doy'],data['temp'],'r',label='temperature / C')\n",
    "plt.plot(data['doy'],data['snowprop']*100,'b',label='snow cover %')\n",
    "plt.plot(data['doy'],100-data['snowprop']*100,'c',label='snow free cover %')\n",
    "plt.plot(data['doy'],data['flow']/100.,'g',label='river flow / 100')\n",
    "plt.legend(loc='best')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "we have plotted the streamflow (scaled) in green, the snow cover in blue, and the non snow cover in cyan and the temperature in red. It should be apparent that thge hydrology is snow melt dominated, and to describe this (i.e. to build the simplest possible model) we can probably just apply some time lag function to the snow cover."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 8.2 The model\n",
    "\n",
    "What we need is a model that provides an estimate of flow $F$ (`data['flow']`) as a function of time $t$ (days).\n",
    "\n",
    "The information we have to help in this is : snow proportion $p$ (`data['snowprop']`) and temperature $T$ (`data['temp']`) \n",
    "\n",
    "\n",
    "### 8.2.1 Snow water equivalent\n",
    "\n",
    "In a snow-melt dominated catchment, we are assuming that the flow can be related to water released from the snow pack. The purpose of any model then is to model that release. The units of this (flow) will be units of volume per unit time.\n",
    "\n",
    "The water contained in the snow pack is called the Snow Water Equivalent (SWE) and is a measure of water volume. To estimate this, we would need to know the snow equivalent depth $d$ and the snow area. The snow area is the catchment area multipled by $p$, so:\n",
    "\n",
    "$$\n",
    "SWE = A p d\n",
    "$$\n",
    "\n",
    "where $A$ is the catchment area. \n",
    "\n",
    "We have no information on depth, so will assume that it varies in the same way as snow cover. Letting:\n",
    "\n",
    "$$\n",
    "d = \\frac{k}{A} p\n",
    "$$\n",
    "\n",
    "Then:\n",
    "\n",
    "$$\n",
    "SWE = k p^2\n",
    "$$\n",
    "\n",
    "### 8.2.2 Snow water melt\n",
    "\n",
    "From examination of the data plotted above, we can see that the timing of the river discharge corresponds broadly to:\n",
    "\n",
    "* the presence of snow cover ($p > 0$)\n",
    "* temperature above some threshold ($T > T_{thresh}$)\n",
    "\n",
    "where $T_{thresh}$ is the threshold temperature. \n",
    "\n",
    "This is hardly surprising and exactly what we would expect in a snowmelt-dominated catchment. We might reasonably expect $T_{thresh}$ to be $0 C$, but this might not be the case (why?).\n",
    "\n",
    "A simple model of the SWE entering the system then is to make it equal to some proportion $k_p$ of the SWE on days when melting occurs.\n",
    "\n",
    "Then:\n",
    "\n",
    "$$\n",
    "SWE_{melt}(t) = k_p(t) {SWE}(t)\n",
    "$$\n",
    "\n",
    "where $SWE_{melt}$ is the proportion of SWE released per unit time (day).\n",
    "\n",
    "One function we could use for $k_p$ is to make it proportionate to the excess temperature.\n",
    "\n",
    "We can define this as:\n",
    "\n",
    "$$\n",
    "k_p(T) = \\frac{T-T_{thresh}}{T_{max}}\n",
    "$$\n",
    "\n",
    "with negative $k_p$ set to zero, and $T_{max}$ the maximum temperature. So, if $T = T_{thresh} + T_{max}$. $k_p = 1$ and the maximum amount of SWE is available as melt water.\n",
    "\n",
    "### 8.2.3 Base flow\n",
    "\n",
    "Close examination of the data suggests there is a base level flow (i.e. a constant flow throughout the year) of around 200 units. We can simply add this to our model as $F_{base}$.\n",
    "\n",
    "$$\n",
    "F_{non-base}(t) = F(t) - F_{base}\n",
    "$$\n",
    "\n",
    "$F_{base}$ is easily estimated from the January mean value of flow.\n",
    "\n",
    "\n",
    "### 8.2.4 Total amount of water\n",
    "\n",
    "We then have modelled flow ${F}_{model}$ entering the system:\n",
    "\n",
    "$$\n",
    "{F}_{model}(t) =  F_{base} + SWE_{melt}(t)\n",
    "$$\n",
    "\n",
    "\n",
    "$$\n",
    "{F}_{model}(t) =  F_{base} + k MAX \\left(0, \\frac{T-T_{thresh}}{T_{max}} p(t)^2 \\right)\n",
    "$$\n",
    "\n",
    "\n",
    "\n",
    "Further, we can assume that the total amount of flow that we model (minus the base flow) should equal that measured (summed over all days). \n",
    "\n",
    "Then:\n",
    "\n",
    "$$\n",
    "\\Sigma_t{{F}_{model}(t)} = \\Sigma_t{F(t)}\n",
    "$$\n",
    "\n",
    "so\n",
    "\n",
    "$$\n",
    "\\Sigma_t{F(t)} = \\Sigma_t{F_{base}} + k \\Sigma_t{MAX \\left(0, \\frac{T-T_{thresh}}{T_{max}} p(t)^2 \\right)}\n",
    "$$\n",
    "\n",
    "This allows us to infer the value of $k$ from the data:\n",
    "\n",
    "$$\n",
    "k  = \\frac{\\Sigma_t{\\left( F(t) - F_{base} \\right) }}{\\Sigma_t{MAX \\left(0, \\frac{T-T_{thresh}}{T_{max}} p(t)^2 \\right)}}\n",
    "$$\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 35,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "F_base = 203.8709677419355\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "<matplotlib.legend.Legend at 0xb212ef908>"
      ]
     },
     "execution_count": 35,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAlkAAAGtCAYAAAAlE2HVAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDMuMC4xLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvDW2N/gAAIABJREFUeJzs3XmcVNWZN/Dfqaru6oZu9sWGZlFZRGQVXKIYkVFxiYSICRp3E8mokzHJvJ8k74yjZpn4zhg1ixqXoMagxpgYTRTQiQtgVEBBFkFAZelmpxvoprequuf9o+6pPnX73qpbe92u3/fz8dPdt5Z72qTbp5/nOc8RUkoQERERUXb5Cr0AIiIiou6IQRYRERFRDjDIIiIiIsoBBllEREREOcAgi4iIiCgHGGQRERER5QCDLCIiIqIcYJBFRERElAMMsoiIiIhyIFDoBQDAgAED5MiRIwu9DCIiIqKkPvjgg4NSyoHJnlcUQdbIkSOxevXqQi+DiIiIKCkhxA43z2O5kIiIiCgHGGQRERER5QCDLCIiIqIcKIqeLCIiou4sFAqhrq4ObW1thV4KpaCiogK1tbUoKytL6/UMsoiIiHKsrq4O1dXVGDlyJIQQhV4OuSClxKFDh1BXV4fjjz8+rfdguZCIiCjH2tra0L9/fwZYHiKEQP/+/TPKPjLIIiIiygMGWN6T6f9mDLKIiIiIcoBBFhEREVEOMMgiIiIqEXv27MH8+fMxbdo0jBkzBjNnzoRhGOjTp0/sOWvXroUQAlu2bAEANDc3Y+jQoWhubsYjjzyCmpoaTJ48OfbP+vXrs7K2BQsW4J133gEA3HjjjRg0aBBOOeWUuOcsWbIEY8eOxahRo3DPPfckvV5oDLKIiIhKxDXXXIO5c+di9erV2LJlC375y1/C5/NBSgkpJQDgkUcewZAhQ3D06FEAwDPPPIPLLrsMVVVVWLduHX7yk59g7dq1sX8mTJiQlbW9//77OOOMMwAA119/PZYsWRL3eCQSwa233orFixfj448/xrPPPouPP/7Y8XoxYJBFRERUAiKRCN566y188YtfjF1TAVLPnj3R0tKC5uZmLF++HHPnzkVTUxMA4LHHHsO3vvUtAMD69esxefLkrK9t06ZNGDNmDPx+PwDgnHPOQb9+/eKes3LlSowaNQonnHACysvLMX/+fLz00kuO14sBgywiIqIS4Pf78U//9E+YNGlSXGkOAHr16oWmpiY888wz+NrXvoa+ffvi6NGjWLNmDcrKyjBp0iQAwMaNG3HDDTfESoWPPvpo2utpbGyMfb548WLMnj074fPr6+sxbNiw2Ne1tbWor693vF4MOIyUiIgoj27fuhVrm5uz+p6Tq6rwwOjRSZ+3ePFivPPOO3j55Zcxe/ZsPP300/jyl78cC7IWLlyIF198EU8//TSamprwyCOPYMGCBQCAXbt2YdCgQVi3bl1Ga73++uvx5JNP4jvf+Q6efPJJAMDSpUvxxBNPJHydKmfqhBCO14sBgyyiFLVGIvAJgaCPiWAi8hYhBM4++2ycffbZaGxsxLp162JB1htvvIHa2lrU1NSguroae/bswZIlS3D//fcDANatW4eTTjqpy3vu3bsXX/va13DJJZdg48aN+MIXvoDXX38dd911F8aOHYs777wTLS0t6OjowL333ouePXtiyZIl2Lx5M+69917ccsstOHz4MIYMGZJw7bW1tdi1a1fs67q6OgwZMsTxejFgkEWUonkbN2JIMIjHxo4t9FKIyIPcZJxyYenSpZg5cybKy8uxf/9+rFixAgsXLgQQLRfed999ePDBBwEA1dXVeOCBBzB37lxUVlYCiPZj2QVZa9aswVe+8hX867/+K7785S/jm9/8Jvr06YMdO3bg7bffRmtrK/r06YPPPvsMH374IaZOnYoBAwbg6quvxm233YZXXnkFM2fOTLr+6dOnY+vWrfj8888xdOhQPPfcc3jmmWcwduxY2+vFgEEWUYp2d3SgOBLRRETuvfDCC7jllltQVVWFYDCIH//4xzjzzDMBAL1794ZhGJg1axaAaJC1ZcuWuAby9evX4+2338bixYsBRLNiy5cvx9q1azF37lyEQiH0798fPp8PGzZswDe/+U28+OKLePDBBxEMBgEA999/P2bNmoXVq1fH+rwWL16MefPmxa31yiuvxFtvvYWDBw+itrYWd999N2666Sb8+te/xoUXXohIJIIbb7wR48ePBwDH64XGIIsoRVJKdO0AICIqbo899pjjY9Z+qDlz5nTpdVq0aJHta7dt24YxY8Zg3bp1GDduHABg+/btGD58OObMmYPrr78ew4YNw3nnnYeNGzfi29/+NrZv347HH38cAwYMwD/+8Y9YSVJ59tlnbe918cUX4+KLL3Z9vdCEXcNYvk2bNk2uXr260MsgcmXiqlWoDQbx6sSJhV4KEXnEpk2bYgEIeYvd/3ZCiA+klNOSvZadu0QpkuY/REREiTDIIkqRlBJGEWSAiYiouDHIIkqRAWayiIgoOQZZRCliuZCIiNxgkEWUIv0gVSIiIicMsohSxHIhERG5wSCLKEUsFxIRkRsMsohSxGGkRETkBoMsohQZsD8NnojISy6++GIcPnw46++7fPlyjB8/HpMnT8amTZtwyimnZP0eCxYswDvvvBN3bdmyZZg6dSoCgQBeeOGFuMeeeuopjB49GqNHj8ZTTz0Vu/7BBx9gwoQJGDVqFL797W9n/Xc7gyyiFElEAy0iIi+SUsIwDLz66qvo06dPVt5Lt2jRIvzbv/0b1q5dGztcOtvef/99nHHGGXHXhg8fjieffBJXXXVV3PWGhgbcfffdeP/997Fy5UrcfffdaGxsBAD88z//Mx599FFs3boVW7duxZIlS7K6TgZZRCliuZCIvGb79u0YN24cbrnlFkydOhW7du3CyJEjcfDgQXz/+9/HQw89FHvuXXfdhZ///OcAgP/5n//B9OnTMXHiRNx5552O76U8/vjjeP755/GjH/0IX//61+PW0NbWhhtuuAETJkzAlClT8OabbwKIZtTWrVsHAJgyZQp+9KMfAQDuuOMOPP74412+l02bNmHMmDHw+/1x10eOHImJEyfC54sPbZYuXYrzzz8f/fr1Q9++fXH++edjyZIl2LNnD44ePYozzzwTQghce+21+Mtf/pLWv18nPCCaKEUsFxJRJm5fcjvW7l2b1fecfNxkPDD7gYTP+eSTT/DEE0/EBVQAMH/+fNx+++245ZZbAADPP/88lixZgtdeew1bt27FypUrIaXEZZddhmXLlmH48OGO7/WNb3wDK1aswKWXXop58+Zh+/btsccefPBBAMD69euxefNmXHDBBdiyZQvOOeccLF++HCNHjkQgEIiVAVesWIGrr766y/exePFizJ492/W/m/r6egwbNiz2dW1tLerr61FfX4/a2tou17OJmSyiFHF3IRF50YgRI7qU2IBo9mj//v3YvXs3PvroI/Tt2xfDhw/Ha6+9htdeew1TpkzB1KlTsXnzZmzdujXheyWyYsUKXHPNNQCAk046CSNGjMCWLVswY8YMLFu2DCtWrMAll1yC5uZm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\n",
      "text/plain": [
       "<Figure size 720x504 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Guess some values\n",
    "Tthresh = 6\n",
    "\n",
    "# we can estimate the base flow from the \n",
    "# mean January value\n",
    "F_base = data['flow'][:31].mean()\n",
    "print(f'F_base = {F_base}')\n",
    "\n",
    "\n",
    "# \n",
    "p           = data['snowprop']\n",
    "k_p         = (data['temp'] - Tthresh)/data['temp'].max()\n",
    "k_p         = np.max([np.zeros_like(k_p),k_p],axis=0)\n",
    "swe_melt_k  = p * p * k_p\n",
    "\n",
    "# take away the base flow from flow\n",
    "nonbase_flow = data['flow'] - F_base\n",
    "\n",
    "# k\n",
    "k = nonbase_flow.sum() / swe_melt_k.sum()\n",
    "\n",
    "model_flow = swe_melt_k * k + F_base\n",
    "\n",
    "# set up plot\n",
    "plt.figure(figsize=(10,7))\n",
    "plt.xlim(data['doy'][0],data['doy'][-1]+1)\n",
    "plt.xlabel('day of year 2005')\n",
    "\n",
    "# plot data\n",
    "plt.plot(data['doy'],model_flow/100,'c',label='$SWE_{melt}$/100')\n",
    "plt.plot(data['doy'],data['flow']/100.,'g',label='river flow / 100')\n",
    "plt.legend(loc='best')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This already looks quite reasonable, although:\n",
    "\n",
    "* the flow is smoother than the $SWE_{melt}$ data\n",
    "* there seems to be a delay between snowmelt occuring and flow appearing in the measurements\n",
    "\n",
    "The function that describes such delay (and that can cause smoothing) can be called a network response function. It is often modelled as a Laplace function (an exponential). The idea is that for any 'flash' input to the catchment, this network response function will give us what we would measure as a hydrograph at the monitoring station (or elsewhere):\n",
    "\n",
    "$$\n",
    "nrf = e^{-m t}\n",
    "$$"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 36,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Text(0.5, 1.0, 'network response function $m=0.03$')"
      ]
     },
     "execution_count": 36,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAmMAAADUCAYAAADQmCSZAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDMuMC4xLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvDW2N/gAAIABJREFUeJzt3XmcVNWd9/HPr6s3oNlp9t3GBVBQWsJETVwjZlQyUSNOEs3EDFl0kkziJJpEJ3HMRJ+ZZxwdTZ4xaqI+McpjYsQtTOISxSjSCIqImGaTBoRm3+mlfs8f9xaWZTV9G6qruvt+369XverWueee+7t1ofvX5557rrk7IiIiIlIYRYUOQERERCTOlIyJiIiIFJCSMREREZECUjImIiIiUkBKxkREREQKSMmYiIiISAEpGRMREREpICVjIiIiIgWkZEwkxsxstZmdXeg4OhozO8bMFpnZLjP7eh73u9TMTs/X/kSkY1AyJtLBKEHqEL4DPO/uPd399vbaSea5dvcJ7v58e+0vH8ysn5k9amZ7zGyNmf3t4dY1s/9rZhvMbKeZvWNmX2r/IxDJPyVjIjFkZsWF3L4TGAUsLXQQndSdQAMwCPgs8DMzm3CYdX8CjHb3XsCFwE1mNqXdIhcpECVjIu0k7PW4xszeMLMdZvawmZWH64aa2W/MrN7MVqUuhZnZA8BI4HEz221m3zGzvzOzx9ParTWz2Wmf15rZ5HD5ODN73sy2h5e8LsyI57tm9gawJzOhMrNjw1hmHuJ4PrB9S8cR1v+uma0LL/UtN7OzMtq6zszeMrNtZvaLtO+mxWOI8L1m3eeh4sxynM8CZwB3hOfgaDNzM6tKq/NLM7uptXjC9SPM7LfhvreY2R2HONcf6CmLcD5b3G/GMX3JzOaa2c/C7/sdMxtvZt8ws3fNbLOZfbql7yQqM+sBXARc7+673X0eMAf4/OHUdfel7n4g9TF8HXWkcYp0OO6ul156tcMLWA28CgwF+gHLgK8Q/BG0ELgBKAXGAiuBc9O2OzutnbHA9nC7IcAaYF3aum3huhKgFvhe2O6ZwC7gmLR2FwMjgG7p+wJOAt4Fzm/leA5uf6jjAI4B1gJDw21HA0dltPVm2FY/4CXgptaOoZXvNes+W/u+WzjW54EvpX12oCrt8y+Bmw4VT7guAbwO3Ar0AMqBUzOO5exsnyOez6z7zXI8twNbgLPCmH5D8O/oG+F+vgG8lmW7Jwj+7WV7PZGl/onAvoyya4DHD7cu8FNgb3gOXgMqCv1/Wy+9cv1Sz5hI+7rd3de7+1bgcWAycDJQ6e43unuDu68Efg5k7ZEK1+8Kt/04MBdYZ2bHhp9fdPckMA2oAG4O232W4JfpZRnxrHX3fWllpxH0SFzh7k9EOJ7U9oc6jmagDBhvZiXuvtrdV2S0dUfY1lbgx2GcUY6hpe+1pX226fs+TNniAZhKkCz9k7vvcff9HvQARRH1fGbbb6ZJwE/c/Rl3bwbeApa4+23u3kiQGH/o0rO7n+/ufVp4nZ9lPxXAjoyyHUDPw63r7l8Ly04DfgscQKSLUTIm0r7eS1veS/ALaBQwNLz0tN3MthP0fgw6RDt/Ak4HPhYuP0+QiH08/AzBL/21YWKWsgYYlvZ5bZa2vwL82d2fi3A86du3eBzuXgt8E/ghsMnMHjKzoYdoa00Yf5RjgCzf6yH2eTjfd1tlO88Q9Pytcfemw2gzynfR0n4znUCQyKWMz/L57cOIMdNuoFdGWS+CPyYOu667N4dJ7HDgqzmIU6RDUTImkn9rgVUZvQw93f2T4XrPsk0qGTstXP4TH07G1gMjzCz9//VIYF3a52xtfwUYaWa3Rog9fftDHoe7P+jupxIkQw7cktHWiIw410c8hpaDy77P1r7vKPYC3dM+D4643VqC77alGx6ynY+UI/ouUsxsFMFlznfSiicTXHJOOSHjc2rbp8PxbNleT2fZ3TtAsZmNSyubRPabIdpSN6UYjRmTLkjJmEj+vQrsDAebdzOzhJlNNLOTw/UbCcY1pfsTwaDybu5eB7wITAf6A4vCOvOBPcB3zKzEgvmqLgAeaiWeXWFbHzOzm3NxHBbM03WmmZUB+4F9BJcR011lZsPNrB9BT9XDR3AMHGKfrX3fUSwG/jbcdjpBEhzFq8AG4GYz62Fm5WZ2Str6bOc65bC/iwyTCC5JJgHMrBdBsvpGRp3XMzd09/PcvaKF13lZ6u8huJR4Y3i8pwAzgAfaWtfMBprZTDOrCL/3cwku0T7bxuMX6fCUjInkWThm5wKC3olVwGbgbqB3WOUnwA/CS2rXhNu8Q3BZ58Xw806CQegvhe3h7g0Et/+fF7b5U+Byd2/18pO7bwfOAc4zs3/JwXGUATeHZe8BAwkSrnQPAv8THsdKggHxh30MLe0zwvcdxTfCNrYTTMHwuygbpe27iuAGiTrg0rQqHzrXadseyXeRbhIf7gWrdfe9AGHP20Sy9Iwdpq8R3OCxCfg18FV3P9jbFfa2fS9CXSe4JFlHcJPKvwPfdPfHchSnSIdh7ofqJRcRyT0zW01wt+IfCx2LiEihqWdMREREpICUjImIiIgUkC5TioiIiBSQesZERERECkjJmIiIiEgBtTQRYYc0YMAAHz16dKHDEBEREWnVwoULN7t7ZWv1IiVj4SSHtxE8YPZud785Y30ZcD8wheBhtJe6+2ozmwrclaoG/NDdH43SZjajR4+mpqYmSsgiIiIiBWVma6LUa/UypZklgDsJJh4cD1xmZuMzql0JbHP3KuBW3n/syZtAtbtPJpjh+7/NrDhimyIiIiJdXpQxY1MJZmteGc4I/RDBIyvSzQDuC5cfAc4yM3P3vWkPyC3n/eewRWlTREREpMuLkowNI3jYbUpdWJa1Tph87SB4Zh5m9hEzWwosAb4Sro/SpoiIiEiXFyUZsyxlmZOTtVjH3ee7+wTgZOA6MyuP2GbQsNksM6sxs5r6+voI4YqIiIh0HlGSsTpgRNrn4cD6luqYWTHBA3i3pldw92XAHoIH0kZpM7XdXe5e7e7VlZWt3pAgItJm985bxerNewodhojEVJRkbAEwzszGmFkpMBOYk1FnDnBFuHwx8Ky7e7hNMYCZjQKOAVZHbFNEpN0daGrmxife4u55KwsdiojEVKtTW7h7k5ldDcwlmIbiXndfamY3AjXuPge4B3jAzGoJesRmhpufClxrZo1AEviau28GyNZmjo9NRKRVqSfCvbpq66Erioi0k0jzjLn7U8BTGWU3pC3vBy7Jst0DwANR2xQRybdkmI29s3E3W/c00K9HaYEjEpG40eOQRCTWkmm3Di1Yrd4xEck/JWMiEmvu72djC3SpUkQKQMmYiMRaes/Yq+oZE5ECUDImIrGW6hnrVV7Mm+t2sPtAUytbiIjklpIxEYm1VM/Y1DH9STosXLOtsAGJSOwoGRORWEv1jE0Z1ZdEkWncmIjknZIxEYm1VM9YRXkxE4f11nxjIpJ3SsZEJNZSPWNFBh8Z04/Fa7ezv7G5wFGJSJwoGRORWEv1jBWZMXV0Pxqak7y+dnthgxKRWFEyJiKxlpqB34CTR/fDDObrUqWI5JGSMRGJtdQ0Y0Vm9O5ewnGDe/Hyii0FjUlE4kXJmIjEWjK8TmkWfD6lqj8L12xjX4PGjYlIfigZE5FY87QxYwCnVA2goTlJzRpdqhSR/FAyJiKxlhozVhT+NJw6ph8lCWNe7eYCRiUicaJkTERiLTVmzAh6xrqXFnPiyL78uVbjxkQkP5SMiUisHbyb0t4vO7VqAG+u38G2PQ0FikpE4kTJmIjE2vuTvr6fjZ1S1R93eHmlesdEpP1FSsbMbLqZLTezWjO7Nsv6MjN7OFw/38xGh+XnmNlCM1sSvp+Zts3zYZuLw9fAXB2UiEhUyYwB/AAnDO9DRVkxL2ncmIjkQXFrFcwsAdwJnAPUAQvMbI67v5VW7Upgm7tXmdlM4BbgUmAzcIG7rzezicBcYFjadp9195ocHYuISJul7qZMv0xZkijiI2P6KRkTkbyI0jM2Fah195Xu3gA8BMzIqDMDuC9cfgQ4y8zM3Re5+/qwfClQbmZluQhcRCQXkmnPpkx3StUAVm/ZS922vQWISkTiJEoyNgxYm/a5jg/2bn2gjrs3ATuA/hl1LgIWufuBtLJfhJcorzezjB+FATObZWY1ZlZTX18fIVwRkejeH8D/wR9Bp44bAKC7KkWk3UVJxrIlSd6WOmY2geDS5ZfT1n/W3Y8HTgtfn8+2c3e/y92r3b26srIyQrgiItFlTvqaMm5gBZU9y3hRlypFpJ1FScbqgBFpn4cD61uqY2bFQG9ga/h5OPAocLm7r0ht4O7rwvddwIMEl0NFRPKqpcuUZsbHj67khXfqaU5m/v0pIpI7UZKxBcA4MxtjZqXATGBORp05wBXh8sXAs+7uZtYHeBK4zt1fSlU2s2IzGxAulwDnA28e2aGIiLRdtgH8KWccM5Ad+xpZvHZbfoMSkVhpNRkLx4BdTXAn5DJgtrsvNbMbzezCsNo9QH8zqwW+BaSmv7gaqAKuz5jCogyYa2ZvAIuBdcDPc3lgIiJRtDRmDIJxY4ki47m3NV5VRNpPq1NbALj7U8BTGWU3pC3vBy7Jst1NwE0tNDslepgiIu0j2zxjKb27lTBlVF+eW76Ja849Js+RiUhcaAZ+EYk1b2HMWMoZxwxk6fqdbNy5P49RiUicKBkTkVjLfFB4pjOODe7ifn75pjxFJCJxo2RMRGItmTx0z9gxg3oypHe5xo2JSLtRMiYisZY8eDdl9mzMzDj9mIHMq91MQ1Myj5GJSFwoGRORWGttzBjAGcdUsvtAEzVrtuYpKhGJEyVjIhJrB8eMtdAzBsFzKksSxnNva9yYiOSekjERibWWZuBP16OsmGlj+/PMsk0He9JERHJFyZiIxFprY8ZSPjF+ECs376F20+48RCUicaJkTERiLUrPGMA54wcDMHfpe+0dkojEjJIxEYm19wfwHzobG9y7nMkj+jB36cZ8hCUiMaJkTERi7VAPCs907oTBLFm3g3Xb97VvUCISK0rGRCTWDvVsykznThgEwB90qVJEckjJmIjEWmrMWJSesbGVFVQNrNClShHJKSVjIhJrUceMpZw7YRCvrt7Ktj0N7RmWiMSIkjERibW2jBmDYNxYc9L54zL1jolIbigZE5FYa8uYMYDjh/VmaO9yTXEhIjkTKRkzs+lmttzMas3s2izry8zs4XD9fDMbHZafY2YLzWxJ+H5m2jZTwvJaM7vdWptxUUSkHUSdZyzFzJg+cQgvvLOZHfsa2zEyEYmLVpMxM0sAdwLnAeOBy8xsfEa1K4Ft7l4F3ArcEpZvBi5w9+OBK4AH0rb5GTALGBe+ph/BcYiIHJb3B/BH/3vwwslDaWhOqndMRHIiSs/YVKDW3Ve6ewPwEDAjo84M4L5w+RHgLDMzd1/k7uvD8qVAediLNgTo5e4vezB69n7gU0d8NCIihynqZUqAScN7M7Jfdx5/fX3rlUVEWhElGRsGrE37XBeWZa3j7k3ADqB/Rp2LgEXufiCsX9dKmwCY2SwzqzGzmvr6+gjhiohEd7BnrA3bmBkXTBrCn1dsYfPuA+0TmIjERpRkLNvPKG9LHTObQHDp8sttaDModL/L3avdvbqysjJCuCIi0SWTwXtbesYALpg0lOak8/SSDe0QlYjESZRkrA4YkfZ5OJDZN3+wjpkVA72BreHn4cCjwOXuviKt/vBW2hQRaXdtmfQ13bGDe3H0oArm6FKliByhKMnYAmCcmY0xs1JgJjAno84cggH6ABcDz7q7m1kf4EngOnd/KVXZ3TcAu8xsWngX5eXAY0d4LCIibZaaZ6wo6u2UaS6cNJQFq7fpWZUickRaTcbCMWBXA3OBZcBsd19qZjea2YVhtXuA/mZWC3wLSE1/cTVQBVxvZovD18Bw3VeBu4FaYAXwdK4OSkQkKqftY8ZSzj9hKABPvqHeMRE5fMVRKrn7U8BTGWU3pC3vBy7Jst1NwE0ttFkDTGxLsCIiudbWSV/TjR7Qg0nDe/PY4vXM+thROY5MROJCM/CLSKy1ddLXTJ86cRhL1+/k7fd25jAqEYkTJWMiEmvJg8+mPLxsbMbkYZQkjP9XU9d6ZRGRLJSMiUi8HebdlCn9epRy1rGD+N2idTQ2J3MYmIjEhZIxEYm1IxkzlnJJ9XC27Gng2bc35SgqEYkTJWMiEmtHOmYM4ONHV1LZs4xHFupSpYi0nZIxEYm1Ix0zBlCcKOLTJw7jubc36fFIItJmSsZEJNY8Bz1jEFyqbEo6v1u0LgdRiUicKBkTkVjzHPSMAVQN7MnkEX2YXbP2YIInIhKFkjERibVcjBlLufTkEbyzcTcL12w78sZEJDaUjIlIrOXibsqUGZOH0rOsmAdeWXPEbYlIfCgZE5FYSx7hPGPpupcWc9GU4Ty1ZIMG8otIZErGREQAO6xHhX/Y56aNorHZeXjB2py0JyJdn5IxEYm1ZDJ3Y8YAqgZW8NGj+vPg/HdpTmogv4i0TsmYiMRaLseMpXx+2ijWbd+nGflFJBIlYyISa7kcM5Zy9vhBDOpVpoH8IhKJkjERiTUnSMSOdJ6xdCWJIi6bOpIX3qmndtPunLUrIl1TpGTMzKab2XIzqzWza7OsLzOzh8P1881sdFje38yeM7PdZnZHxjbPh20uDl8Dc3FAIiJt4e45Grr/QZ+bNorS4iLumbeyHVoXka6k1WTMzBLAncB5wHjgMjMbn1HtSmCbu1cBtwK3hOX7geuBa1po/rPuPjl8aXCFiORd0j2n48VSBlSUcdFJw/nNa+uo36VpLkSkZVF6xqYCte6+0t0bgIeAGRl1ZgD3hcuPAGeZmbn7HnefR5CUiYh0OEnP7eD9dF86bQyNzUkeeHl1u7QvIl1DlGRsGJA+YU5dWJa1jrs3ATuA/hHa/kV4ifJ6a2HAhpnNMrMaM6upr6+P0KSISHTuuR28n+6oygrOPm4Q97+yhn0Nze2zExHp9KIkY9l+TGVOnhOlTqbPuvvxwGnh6/PZKrn7Xe5e7e7VlZWVrQYrItIW7t5uyRjArI+NZfveRh5ZqElgRSS7KMlYHTAi7fNwYH1LdcysGOgNbD1Uo+6+LnzfBTxIcDlURCSv2mvMWEr1qL5MHtGHu+et0iSwIpJVlGRsATDOzMaYWSkwE5iTUWcOcEW4fDHwrLu3+FPHzIrNbEC4XAKcD7zZ1uBFRI5Ue44Zg2DKjC9/bCxrtuzliTcy/44VEYHi1iq4e5OZXQ3MBRLAve6+1MxuBGrcfQ5wD/CAmdUS9IjNTG1vZquBXkCpmX0K+ASwBpgbJmIJ4I/Az3N6ZCIiESTb+TIlwLkTBnP0oAr+69lazj9hKIlcPXtJRLqEVpMxAHd/Cngqo+yGtOX9wCUtbDu6hWanRAtRRKT9uGcf9JpLRUXGP5w5jn/49SKefnMD558wtJ33KCKdiWbgF5FYc3eK8tBT9cnjh1A1sILbn/nLwYeTi4iAkjERibn2HjOWkigy/uHMKt7ZuJvfL32v3fcnIp2HkjERibXgbsr87Ov8E4YytrKHesdE5AOUjIlIrAUPCs9PNpYoMr5+5jjefm8XTy7ZkJd9ikjHp2RMRGKtvR4U3pILJg3l2ME9+be5y2loSuZxzyLSUSkZE5FYSybzM2YsJVFkfPe8Y3l3614enL8mb/sVkY5LyZiIxFo+x4ylnH50JX81tj+3P1vLrv2N+d25iHQ4SsZEJNbyOWYsxcy47pPHsnVPAz9/YWVe9y0iHY+SMRGJtXzMwJ/NCcP7cP4JQ/j5i6vYuHN//gMQkQ5DyZiIxJrnaZ6xbP7p3GNoTjq3PP12QfYvIh2DkjERibVCjBlLGdW/B7M+NpbfLlrHgtVbCxOEiBSckjERibV8zcDfkq+dcRRDe5dzw2NLadZEsCKxpGRMRGLNCzRmLKV7aTE/OH88yzbs1FQXIjGlZExEYs09/3dTZjpv4mBOqerPv81dzpbdBwoai4jkn5IxEYm1Qo4ZSzEzfnjBBPY2NHPTk8sKG4yI5J2SMRGJtSAZK3A2Bowb1JOvnVHFo4vW8dzbmwodjojkUaRkzMymm9lyM6s1s2uzrC8zs4fD9fPNbHRY3t/MnjOz3WZ2R8Y2U8xsSbjN7Vbo6wQiEksd4TJlylVnHMXRgyr43qNLNDO/SIy0moyZWQK4EzgPGA9cZmbjM6pdCWxz9yrgVuCWsHw/cD1wTZamfwbMAsaFr+mHcwAiIkci6eT1QeGHUlac4JaLTuC9nfu5WXOPicRGlJ6xqUCtu6909wbgIWBGRp0ZwH3h8iPAWWZm7r7H3ecRJGUHmdkQoJe7v+zuDtwPfOpIDkRE5HC4O0UdaMDGiSP78sVTxvCr+e/y8oothQ5HRPIgyo+gYcDatM91YVnWOu7eBOwA+rfSZl0rbQJgZrPMrMbMaurr6yOEKyISXUcZM5bumk8cw+j+3fn27MXs2KfLlSJdXZRkLNtPqcyZCaPUOaz67n6Xu1e7e3VlZeUhmhQRabtCPCi8Nd1KE/znzBPZuOsA3390CcEFBBHpqqIkY3XAiLTPw4H1LdUxs2KgN3CoZ3vUhe0cqk0RkXbXkcaMpZs8og//ePY4nnhjA48uWlfocESkHUVJxhYA48xsjJmVAjOBORl15gBXhMsXA8/6If6Uc/cNwC4zmxbeRXk58FiboxcROULeAeYZa8lXT6/i5NF9ueGxpazdurfQ4YhIO2k1GQvHgF0NzAWWAbPdfamZ3WhmF4bV7gH6m1kt8C3g4PQXZrYa+A/gC2ZWl3Yn5leBu4FaYAXwdG4OSUQkuo44ZiwlUWTceulkzOCqB19jf2NzoUMSkXZQHKWSuz8FPJVRdkPa8n7gkha2Hd1CeQ0wMWqgIiLtIZks7IPCWzO8b3f+9yWTmPXAQn70+FJ+8ukTCh2SiORYB7qhW0Qk/5zCPig8ik9MGMxXTz+KX7+6ltk1a1vfQEQ6FSVjIhJrSafDJ2MA3z7naE6p6s8Pfvcmb67bUehwRCSHlIyJSKx5Bx4zlq44UcTtM0+kf49S/v7+Gjbt3N/6RiLSKSgZE5FYS3rHHjOWrn9FGT+/vJod+xq58r4a9jY0FTokEckBJWMiEmvuHX/MWLqJw3pz+8wTeXP9Dv7x4cUkk5oQVqSzUzImIrEWjBnrRNkYcPb4Qfzgr8czd+lG/vWpZZqhX6STizS1hYhIV9WRJ309lC+eMpp3t+zh7nmr6FdRytdOryp0SCJymJSMiUisdaYxY+nMjH++YALb9zXyv36/nF7lJXxu2qhChyUih0HJmIjEmtM5e8YAioqMf79kErv2N3H9Y2/Ss7yYGZOHFTosEWkjjRkTkVhLJjvfmLF0JYkifvrZk5g6uh/fmv06jy3WQ8VFOhslYyISa0l3Om8qFigvSXDvF06melRf/vHhxTy6qK7QIYlIGygZE5FY8046ZixTj7JifvF3JzNtbH++Nft1Zi/QY5NEOgslYyISa0l3irrIT8LupcXc+4WTObVqAN/5zRv87PkVmvZCpBPoIj+CREQOj9O5x4xlKi9JcPcV1VwwaSi3/P5tfvT4WzRrYliRDk13U4pIrHWFMWOZyooT3HbpZAb2LOOeeavYuHM///GZyXQrTRQ6NBHJQj1jIhJrXWXMWKaiIuP688fzg78+jt8vfY+L/8+fWb99X6HDEpEsIiVjZjbdzJabWa2ZXZtlfZmZPRyun29mo9PWXReWLzezc9PKV5vZEjNbbGY1uTgYEZG2SnbSGfij+tJpY7n78mrWbNnLhXfMY+GarYUOSUQytJqMmVkCuBM4DxgPXGZm4zOqXQlsc/cq4FbglnDb8cBMYAIwHfhp2F7KGe4+2d2rj/hIREQOQ1ftGUt31nGD+N1VH6WirJiZd73C3S+u1MB+kQ4kSs/YVKDW3Ve6ewPwEDAjo84M4L5w+RHgLAtGxM4AHnL3A+6+CqgN2xMR6RCS7nS5QWNZVA3syWNXncoZxwzkpieXceV9NWzd01DosESEaMnYMCB9wpq6sCxrHXdvAnYA/VvZ1oH/MbOFZjarpZ2b2SwzqzGzmvr6+gjhiohEF4eesZTe3Uv4789P4UcXTmDeXzbzydteZP7KLYUOSyT2oiRj2X5KZfZvt1TnUNue4u4nEVz+vMrMPpZt5+5+l7tXu3t1ZWVlhHBFRKLr6mPGMpkZV3x0NL/92kcpLynisp+/wk1PvMW+huZChyYSW1GSsTpgRNrn4cD6luqYWTHQG9h6qG3dPfW+CXgUXb4UkQKIU89YuonDevPE10/jsqkjuXveKqbf9gKvqJdMpCCiJGMLgHFmNsbMSgkG5M/JqDMHuCJcvhh41oPRoXOAmeHdlmOAccCrZtbDzHoCmFkP4BPAm0d+OCIibZN071KTvrZFRVkxP/6b43nw7z+CO8y86xW+/+gSduxrLHRoIrHSajIWjgG7GpgLLANmu/tSM7vRzC4Mq90D9DezWuBbwLXhtkuB2cBbwO+Bq9y9GRgEzDOz14FXgSfd/fe5PTQRkdYlHWKaix300aMG8PtvnsaVp47hwVff5Yx/f54H57+rmftF8sQ60+3N1dXVXlOjKclEJHem/MsfOO/4wdz0qeMLHUqH8Oa6Hdz4+Fu8unorE4b24p8vmMDUMf0KHZZIp2RmC6NM36UZ+EUk1oIB/DHvGkszcVhvHv7yNP7rshPZtqeBz/z3y3zpvhreWr+z0KGJdFlKxkQk1px4DuA/FDPjgklDeebbp3PNJ47m1VVb+OTtL3LVg69Ru2lXocMT6XL0oHARibWkxkW1qFtpgqvPHMfn/2o097y4knvmreLpJRs47/ghfPljYzlheJ9ChyjSJSgZE5FYi+vUFm3Ru1sJ3/rEMXzhlDHc9cJKfvXKGp58YwMfGdOPL398LKcfPZCiOE3WJpJjSsZEJNbiNunrkejXo5RrzzuWq844iocXrOWeeav44i9rGDOgB387dSQXTRlOvx6lhQ5TpNPRmDERiTUH9eq0Uc/yEr502lhe+M4Z3DZzMgMqSvnxU8uY9q/P8M2HFvHnFZt1+VekDdQzJiKxFkz6WugoOqfA7gihAAAKdElEQVSSRBEzJg9jxuRhLH9vFw/OX8NvX1vH7xavZ3Cvci6cPJQLJw1lwtBesZ1YVyQKJWMiEmtJB8v6GF1pi2MG9+RHMyZy7XnH8cdlG3ls8TrunbeKu15YSdXACs4/YQjnjB/E+CFKzEQyKRkTkVhzjRnLqW6lCS6YNJQLJg1l254GnlyygccWr+O2Z/7Cf/7xLwztXc7Z4wdx9nGD+MjYfpQVJwodskjBKRkTkVjT3ZTtp2+PUj43bRSfmzaK+l0HeO7tTfxh2UZm16zl/pfX0L00wdQx/TjlqAF8tKo/xw3upfF7EktKxkQk1nQ3ZX5U9izjMyeP4DMnj2B/YzPz/rKZP71Tz0srNvP88mVAcLfmtLH9OGlkX04a1ZcJQ3up50xiQcmYiMRa0tGTwvOsvCQRXKocPwiADTv28efaLby0YjPzV27lqSXvAVCaKGLisF6cNLIvJ44MkrOR/bqr90y6HCVjIhJb7sH0C/rdXlhDenfjoinDuWjKcAA27tzPone38dq723ltzTbuf2UNd89bBUCP0gTHDunF+CG9GD+0F8cN6UXVwAoqyvTrTDov/esVkdhKTYWlMWMdy6Be5UyfOITpE4cA0NCUZNmGnSzbsJO3wvdHF63jgVfWpG1TxtgBFYyt7MHYygqOquzBUZUVDOldTnFCU2pKx6ZkTERiSz1jnUNpcRGTRvRh0oj3n4WZTDp12/bx1oadrKjfzcr6Payo383jr69n5/6mg/USRcaQ3uUM69ONYX27MTz13rc7w/p0Y3DvcspLNC5NCkvJmIjEVqpnTPNedT5FRcbI/t0Z2b/7B8rdnS17GlhZv4eV9btZu20vddv2sW7bPl5esYX3du7HMx4O0Ku8mMqeZQzsWU5lz7Jwuezg8oCKMvp2L6VP9xIlbtIuIiVjZjYduA1IAHe7+80Z68uA+4EpwBbgUndfHa67DrgSaAa+7u5zo7QpItLekuFvZeViXYeZMaAiSKCmjun3ofUNTUne27Gfuu17WbdtHxt37qd+1wE27TpA/a4DvF63nU07D7CvsTlr+2XFRQcTs97dSt5f7l5Cn26lVJQXU1GWoEdpMRVlxfQIXxVlxVSUF9O9JKEbEORDWk3GzCwB3AmcA9QBC8xsjru/lVbtSmCbu1eZ2UzgFuBSMxsPzAQmAEOBP5rZ0eE2rbUpItKuXGPGYqe0uChrj1o6d2dPQzP1YYK2efcBtu9tZNveBnbsa2T73ga2721k+95GVm7efXC5oTkZKYYepYmDCVp5SYLykqLwPVwuTlCWXl6cXid4LytOUJIwShJFFCeM0kQRxYmig2UliSKKi4zS4uC9pLiIkqJgfaLI1BvcwUTpGZsK1Lr7SgAzewiYAaQnTjOAH4bLjwB3WHCmZwAPufsBYJWZ1YbtEaHNvHt5xRY27NhXyBBEJI8amoJfnuqokHRmFvRklRUzZkCPSNu4O/sam9l9oIk9B5rZc6CJXfub2HOgiT0NTWF5E7vDdXsONLHrQBP7G5rZ39TM/sYkO/Y1cqApyf7G4POBxmBdY3PuH7peGiZxJYkiEkVGkRmJIkiYUVQUJGwHlw+W8eEyC+oGyxxsqyijvMgMLHj0mFnwfy61HOSFFpR9oI6F5yMoO7jeggeYmYXbh3WKwnLC96KM9e/XD94v/6tRdC/tGKO1okQxDFib9rkO+EhLddy9ycx2AP3D8lcyth0WLrfWJgBmNguYBTBy5MgI4R6+e19axR/e2tiu+xCRjqd/j7JChyCdnJnRvbQ4+OXeM7dtNyc9TNCa2R8mawcakzQlkzQ2O43NSRqbkzQ1Ow3he6qsMWO5KbWcdBqbguVmd5qTwU0Rze4H35uTTjJ8b05ycPn9MqcpmeRAk9Ps4fZp65PuJD2I33GSYcehu+ME7bmDE/RSp8rffw+HEhysE7TnpG/3weVkG/LWi6cM71TJWLa/GTMPt6U6LZVnu88461fo7ncBdwFUV1fn/s+DND/+1ER+8NfHtecuRKSDSRQZw/p0K3QYIi1KFNnBsWcSTSpJS6YldgeTuHC5Wwe6GSPKma0DRqR9Hg6sb6FOnZkVA72Bra1s21qbeTewV3mhQxAREZEjlLokWZS1T6jjiTIT3gJgnJmNMbNSggH5czLqzAGuCJcvBp71YAKfOcBMMyszszHAOODViG2KiIiIdHmt9oyFY8CuBuYSTENxr7svNbMbgRp3nwPcAzwQDtDfSpBcEdabTTAwvwm4yt2bAbK1mfvDExEREenYLDUDdWdQXV3tNTU1hQ5DREREpFVmttDdq1urpwd2iYiIiBSQkjERERGRAupUlynNrB5YU+g4OoEBwOZCByFZ6dx0TDovHZfOTcelc9O6Ue5e2VqlTpWMSTRmVhPlGrXkn85Nx6Tz0nHp3HRcOje5o8uUIiIiIgWkZExERESkgJSMdU13FToAaZHOTcek89Jx6dx0XDo3OaIxYyIiIiIFpJ4xERERkQJSMtaJmdm/mdnbZvaGmT1qZn3S1l1nZrVmttzMzk0rnx6W1ZrZtYWJvOszs0vMbKmZJc2sOmOdzk0Hou+9sMzsXjPbZGZvppX1M7M/mNlfwve+YbmZ2e3huXrDzE4qXORdm5mNMLPnzGxZ+LPsG2G5zk07UDLWuf0BmOjuJwDvANcBmNl4gueDTgCmAz81s4SZJYA7gfOA8cBlYV3JvTeBTwMvpBfq3HQs+t47hF8S/F9Idy3wjLuPA54JP0NwnsaFr1nAz/IUYxw1Ad929+OAacBV4f8NnZt2oGSsE3P3/3H3pvDjK8DwcHkG8JC7H3D3VUAtMDV81br7SndvAB4K60qOufsyd1+eZZXOTcei773A3P0FYGtG8QzgvnD5PuBTaeX3e+AVoI+ZDclPpPHi7hvc/bVweRewDBiGzk27UDLWdXwReDpcHgasTVtXF5a1VC75o3PTseh775gGufsGCJICYGBYrvNVAGY2GjgRmI/OTbsoLnQAcmhm9kdgcJZV33f3x8I63yfoUv5VarMs9Z3sybdupz1MUc5Nts2ylOncFE5L50M6Jp2vPDOzCuA3wDfdfadZtlMQVM1SpnMTkZKxDs7dzz7UejO7AjgfOMvfn6ekDhiRVm04sD5cbqlc2qi1c9MCnZuO5VDnQwpno5kNcfcN4aWuTWG5zlcemVkJQSL2K3f/bVisc9MOdJmyEzOz6cB3gQvdfW/aqjnATDMrM7MxBAMqXwUWAOPMbIyZlRIMJJ+T77hjTuemY9H33jHNAa4Il68AHksrvzy8c28asCN1yUxyy4IusHuAZe7+H2mrdG7agXrGOrc7gDLgD2HX8Svu/hV3X2pms4G3CC5fXuXuzQBmdjUwF0gA97r70sKE3rWZ2d8A/wVUAk+a2WJ3P1fnpmNx9yZ974VlZr8GTgcGmFkd8M/AzcBsM7sSeBe4JKz+FPBJghtf9gJ/l/eA4+MU4PPAEjNbHJZ9D52bdqEZ+EVEREQKSJcpRURERApIyZiIiIhIASkZExERESkgJWMiIiIiBaRkTERERKSAlIyJiIiIFJCSMREREZECUjImIiIiUkD/Hxg6Wa3IU9mJAAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<Figure size 720x216 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "# decay parameter\n",
    "# nrf = exp(-m x)\n",
    "m  = 0.03\n",
    "\n",
    "plt.figure(figsize=(10,3))\n",
    "# window size\n",
    "ndays = 15 * int(1/m)\n",
    "nrf_x = np.arange(ndays) - ndays/2\n",
    "# function for nrf\n",
    "nrf = np.exp(-m*nrf_x)\n",
    "nrf[nrf_x<0] = 0\n",
    "\n",
    "# normalise so that sum is 1\n",
    "nrf = nrf/nrf.sum()\n",
    "\n",
    "# plot\n",
    "plt.plot(nrf_x,nrf)\n",
    "plt.title(f'network response function $m={m}$')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 37,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<matplotlib.legend.Legend at 0xb215a4358>"
      ]
     },
     "execution_count": 37,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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FaxatYrt27fzxhtvYFkWl156Ka+88goVFRWDjvWlL32JV199lY997GNcccUVVFVVRZ974IEHANi4cSNbt27l/PPPZ9u2bZx55pmsWbOGyspKXC5XtH336quv8tnPfrbfz7F8+XIuvPDCmH9v9u7dS3l5efRxWVkZe/fuZe/evZSVlfW7bjftgC6S4Lw9oTBVmF5IQ5fumBWZyCZPntyvNQahalB9fT379u3j3XffJScnh4qKClatWsWqVauYP38+CxYsYOvWrWzfvv2IYx3Jq6++yrXXXgvA7NmzmTx5Mtu2bWPx4sW88sorvPrqq1xyySV0dHTQ1dVFVVUVs2bN6jfOypUrhxWmBloHZYwZ9LrdYqpMicj45Q14SU0Kham39r011tMRERiyghQv6enpgz53xRVXsGzZMvbv389VV10FhELIN7/5TW666aY+r62qqjriWIMZbHH3ySefzLp165g6dSrnnXceBw8e5OGHH+akk07q99quri5aWlooKSmJ+XPLysp46aWXoo9ra2v5yEc+QllZGbW1tX2uD2fcWKkyJZLAeoO9+Hv9pLpSKUgroL6z/021L+5+kRU77F9wKSKJ5aqrruL3v/89y5Yt44orrgDgggsu4NFHH6WjowMItcvq60d+c/6ZZ57J7373OwC2bdtGdXU1s2bNIjk5mfLycp588klOPfVUFi9ezL333svixYv7jbF69WrOPvvsYX3uBRdcwKpVq2hubqa5uZlVq1ZxwQUXUFxcjMfj4R//+AeWZfGb3/yGyy67bMQ/32BUmRJJYL6ADyBUmXIU0trdir/XH913CuDfVv8bvoCPC6fHXjIXkWPP8ccfT3t7O6WlpRQXFwNw/vnns2XLFhYtWgRARkYG//u//9tv4XesbrnlFm6++WbmzJmDy+Xisccew+12A7B48WJeeOEF0tLSWLx4MbW1tQOGqeXLl0fD3uHefPNNLr/8cpqbm/nLX/7CXXfdxaZNm8jNzeW73/0uJ598MgD/9m//Rm5uLgD//d//zfXXX4/X6+Wiiy7ioosuGtHPdiTmaJ7ltXDhQmvdunVH7fNEjnUNnQ0U3lvIzy/8OW6Xm5uevYnar9RSmlkafc3Un00FYNftu8ZqmiITwpYtWzjuuOPGehoJb8GCBaxdu5akpKSj+rkD/fczxrxlWdbCod6rNp9IAosccpyWlEZB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\n",
      "text/plain": [
       "<Figure size 720x504 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "import scipy\n",
    "import scipy.ndimage.filters\n",
    "\n",
    "# convolve NRF with data\n",
    "model_flow_nrf = scipy.ndimage.filters.convolve1d(model_flow, nrf)\n",
    "\n",
    "# set up plot\n",
    "plt.figure(figsize=(10,7))\n",
    "plt.xlim(data['doy'][0],data['doy'][-1]+1)\n",
    "plt.xlabel('day of year 2005')\n",
    "\n",
    "# plot data\n",
    "plt.plot(data['doy'],model_flow_nrf/100,'c',label='$SWE_{melt}$/100')\n",
    "plt.plot(data['doy'],data['flow']/100.,'g',label='river flow / 100')\n",
    "plt.legend(loc='best')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "So, we have defined a simple snow melt model. It has two parameters that we3 can vary:\n",
    "\n",
    "* $T_{thresh}$: the lower temperature threshold\n",
    "* $m$: the network response function decay factor\n",
    "\n",
    "The modelled flow is normalised so that the total flow equals the total measured flow. The base flow is estimated from the data (January mean flow value).\n",
    "\n",
    "Note that the values of the additional model parameters, $T_{max}$, $F_{base}$ and the scaling term $k$ should be constant for all years modelled. i.e. ytou work out these values from one year of data, then apply them to the modelling of other years.\n",
    "\n",
    "A quick guess at the parameter values provides a not unreasonable match to the data. As a model that predicts behaviour well for the main spring melt events, this may be quite useful. That said, the model is very simple and might easily be improved.\n",
    "\n",
    "If we accept that this is a sufficient model for the present, we can attempt to improve on the model performance by optimising the (two) parameters.\n",
    "\n",
    "To do this, we can use standard optimisation techniques (that you have already covered in the course) to provide imprtoved parameter estimates. There are only two model parameters to optimise, so this should be quite straightforward. It should also be easy to visualise the error function. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Exercise** \n",
    "\n",
    "Write a Python function that takes the `data` dictionary and the model parameters and returns the modelled flow for given $T_{thresh}$ and $m$. \n",
    "\n",
    "Vary the two parameters a bit and note the impact on the match between modelled and observed flow data."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Exercise"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 8.3 Coursework"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You need to submit you coursework in the usual manner by the usual submission date.\n",
    "\n",
    "You **must** work individually on this task. If you do not, it will be treated as plagiarism. By reading these instructions for this exercise, we assume that you are aware of the UCL rules on plagiarism. You can find more information on this matter in your student handbook. If in doubt about what might constitute plagiarism, ask one of the course convenors.\n",
    "\n",
    "### 8.3.1 Summary of coursework requirements\n",
    "\n",
    "- **Part 2: Modelling**\n",
    "\n",
    "        You will have prepared two years of data in Part 1 of the work. \n",
    "    \n",
    "    If, for some reason, you have failed to generate an appropriate dataset, you may use datasets that will be provided for you for the years 2005 and 2006. There will be no penalty for that in your Part 2 submission: failure to gernerate the datasets will be accounted for in marks allocated for Part 1.\n",
    "    \n",
    "    You have been given a simple (two parameter) hydrological model of snowmelt.\n",
    "    \n",
    "    Use one of these years to calibrate the (snowmelt) hydrological model and one year to test (validate) it. \n",
    "    \n",
    "    The model parameter estimate *must* be objective (i.e. you can't just arbitrarily choose a set) and optimal in some way you must define (you *must* state the equation of the cost function you will try to minimise and explain the approach used). You should state why you have taken any particular approach for the optimisation, and make consideration of what options you might have.\n",
    "    \n",
    "    You **must** state the values of the model parameters that you start with and those youy have estimated. ~TYou must show evidence for how you went about calculating the optimised pareameters. Ideally, you should also state the uncertainty in these parameter estimates (not critical to pass this section though). You should try to at least make some comment on the likely uncertainty.\n",
    "    \n",
    "    You **must** quantify the goodness of fit between your measured flow data and that produced by your model, both for the calibration exercise and the validation.\n",
    "    \n",
    "**Checklist:**\n",
    "    \n",
    "    * Provide a site intoduction and an introduction to the purpose of the exercise ('Introduction')\n",
    "    * Provide an introduction to the modelling and calibration/validation ('Method') \n",
    "    * provide code that reads in the datasets and performs the model calibration and validation ('Code')\n",
    "    * Provide a table of results on model parameter calibration (and ideally, uncertainty) ('Results')\n",
    "    * Provide graphs of the observed and modelled river discharge data for the calibration year ('Results')\n",
    "    * Provide graphs of the observed and modelled river discharge data for the validation year ('Results')\n",
    "    * Assess the accuracy of the calibration and validation ('Results')\n",
    "    * Discuss the results in the light of the introduction ('Discussion')\n",
    "    * Draw conclusions about issues associated with modelling of this sort ('Conclusion')\n",
    "    \n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 8.3.2 Summary of Advice"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The second task revolves around using the model that we have developed above. You should probably put the elements of the model together in a function. You have been through previous examples in Python where you attempt to estimate some model parameters given an initial estimate of the parameters and some cost function to be minimised. Solving the model calibration part of problem should follow those same lines then. Testing (validation) should be easy enough. Don't forget to include the estimated parameters (and other relevant information, e.g. your initial estimate, uncertainties if available) in your write up.\n",
    "\n",
    "There is quite a lot of data presentation here, and you need to provide *evidence* that you have done the task. Make sure you use graphs (e.g. one of the inoputs used for calibration and validation years, and one for modelled and predicted flow, etc.), and tables (e.g. model parameter estimates) throughout, as appropriate."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 8.3.3 Further advice"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "There is plenty of scope here for going beyond the basic requirements (e.g. improving the model), if you get time and are interested (and/or want a higher mark!).\n",
    "\n",
    "You will be given credit for all additional work included in the write up, **once you have achieved the basic requirements**. So, there is no point (i.e. you will not get credit for) going off on all sorts of interesting lines of exploration here *unless* you have first completed the core task.\n",
    "\n",
    "Be aware that if you decide to develop a new model, and this has more parameters than the existing model, the fact that your model fit is better than that for the excisting model *does not* imply that your model is an impriovement. This is because you will have increased the degrees of freedom in the model, so an improved fit is not longer adequate proof of model improvement."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 8|.3.4 Structure of the Report"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The required elements of the report are:\n",
    "\n",
    "    \n",
    "```\n",
    "    1. Provide a site intoduction and an introduction to the purpose of the exercise ('Introduction') [5]\n",
    "    2. Provide a context and introduction to the modelling and calibration/validation and a visualisation of the input data you use ('Method') [10]\n",
    "    3. provide code that reads in the datasets and performs the model calibration and validation ('Code') [10]\n",
    "    4. A Results section with appropriate graphs and tables [10]\n",
    "    5. Discuss the results in the light of the introduction ('Discussion') [10]\n",
    "    6. Draw conclusions about issues associated with modelling of this sort ('Conclusion') [5]\n",
    "```\n",
    "The figures in brackets indicate the percentage of marks that we will award for each section of the report.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 8.3.5 Computer Code"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### General requirements\n",
    "\n",
    "You will obviously need to submit computer codes as part of this assessment. Some flexibility in the style of these codes is to be expected. For example, some might write a class that encompasses the functionality for all tasks. Some poeple might have multiple versions of codes with different functionality. All of these, and other reasonable variations are allowed.\n",
    "\n",
    "All codes needed to demonstrate that you have performed the core tasks are required to be included in the submission. You should include all codes that you make use of in the main body of the text in the main body. Any other codes that you want to refer to (e.g. something you tried out as an enhancement and didn’t quite get there) you can include in appendices.\n",
    "\n",
    "All codes should be well-commented. Part of the marks you get for code will depend on the adequacy of the commenting.\n",
    "\n",
    "#### Degree of original work required and plagiarism\n",
    "\n",
    "If you use a piece of code verbatim that you have taken from the course pages or any other source, **you must acknowledge this** in comments in your text. **Not to do so is plagiarism**. Where you have taken some part (e.g. a few lines) of someone else’s code, **you should also indicate this**. If some of your code is heavily based on code from elsewhere, **you must also indicate that**.\n",
    "\n",
    "Some examples. \n",
    "\n",
    "The first example is guilty of strong plagiarism, it does not seek to acknowledge the source of this code, even though it is just a direct copy, pasted into a method called `model()`:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 32,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2017-11-21T19:49:29.355926Z",
     "start_time": "2017-11-21T19:49:29.345443Z"
    }
   },
   "outputs": [],
   "source": [
    "def model(tempThresh=9.0,K=2000.0,p=0.96):\n",
    "    '''need to comment this further ...\n",
    "\n",
    "    '''\n",
    "    import numpy as np\n",
    "    meltDays = np.where(temperature > tempThresh)[0]\n",
    "    accum = snowProportion*0.\n",
    "    for d in meltDays:\n",
    "        water = K * snowProportion[d]\n",
    "        n = np.arange(len(snowProportion)) - d\n",
    "        m = p ** n\n",
    "        m[np.where(n<0)]=0\n",
    "        accum += m * water\n",
    "    return accum"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This is **not** acceptable.\n",
    "\n",
    "This should probably be something along the lines of:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 33,
   "metadata": {},
   "outputs": [],
   "source": [
    "def model(tempThresh=9.0,K=2000.0,p=0.96):\n",
    "    '''need to comment this further ...\n",
    "\n",
    "    This code is taken directly from\n",
    "    \"Modelling delay in a hydrological network\"\n",
    "    by P. Lewis http://www2.geog.ucl.ac.uk/~plewis/geogg122/DelNorte.html\n",
    "    and wrapped into a method.\n",
    "    '''\n",
    "    # my code: make sure numpy is imported\n",
    "    import numpy as np\n",
    "\n",
    "    # code below verbatim from Lewis\n",
    "    meltDays = np.where(temperature > tempThresh)[0]\n",
    "    accum = snowProportion*0.\n",
    "    for d in meltDays:\n",
    "        water = K * snowProportion[d]\n",
    "        n = np.arange(len(snowProportion)) - d\n",
    "        m = p ** n\n",
    "        m[np.where(n<0)]=0\n",
    "        accum += m * water\n",
    "    # my code: return accumulator\n",
    "    return accum"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now, we acknowledge that this is in essence a direct copy of someone else’s code, and clearly state this. We do also show that we have added some new lines to the code, and that we have wrapped this into a method.\n",
    "\n",
    "In the next example, we have seen that the way m is generated is in fact rather inefficient, and have re-structured the code. It is partially developed from the original code, and acknowledges this:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 34,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2017-11-21T19:49:32.108956Z",
     "start_time": "2017-11-21T19:49:32.097823Z"
    }
   },
   "outputs": [],
   "source": [
    "def model(tempThresh=9.0,K=2000.0,p=0.96):\n",
    "    '''need to comment this further ...\n",
    "\n",
    "    This code after the model developed in\n",
    "    \"Modelling delay in a hydrological network\"\n",
    "    by P. Lewis\n",
    "    http://www2.geog.ucl.ac.uk/~plewis/geogg122/DelNorte.html\n",
    "\n",
    "    My modifications have been to make the filtering more efficient.\n",
    "    '''\n",
    "    # my code: make sure numpy is imported\n",
    "    import numpy as np\n",
    "\n",
    "    # code below verbatim from Lewis unless otherwise indicated\n",
    "    meltDays = np.where(temperature > tempThresh)[0]\n",
    "    accum = snowProportion*0.\n",
    "\n",
    "    # my code: pull the filter block out of the loop\n",
    "    n = np.arange(len(snowProportion))\n",
    "    m = p ** n\n",
    "\n",
    "    for d in meltDays:\n",
    "        water = K * snowProportion[d]\n",
    "\n",
    "        # my code: shift the filter on by one day\n",
    "        # ...do something clever to shift it on by one day\n",
    "\n",
    "        accum += m * water\n",
    "    # my code: return accumulator\n",
    "    return accum"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This example makes it clear that significant modifications have been made to the code structure (and probably to its efficiency) although the basic model and looping comes from an existing piece of code. It clearly highlights what the actual modifications have been. Note that this is not a working example!!\n",
    "\n",
    "Although you are supposed to do this piece of work on your own, there might be some circumstances under which someone has significantly helped you to develop the code (e.g. written the main part of it for you & you’ve just copied that with some minor modifications). You **must** acknowledge in your code comments if this has happened. On the whole though, this should not occur, as you **must** complete this work on your own.\n",
    "\n",
    "If you take a piece of code from somewhere else and all you do is change the variable names and/or other cosmetic changes, you **must** acknowledge the source of the original code (with a URL if available).\n",
    "\n",
    "Plagiarism in coding is a tricky issue. One reason for that is that often the best way to learn something like this is to find an example that someone else has written and adapt that to your purposes. Equally, if someone has written some tool/library to do what you want to do, it would generally not be worthwhile for you to write your own but to concentrate on using that to achieve something new. Even in general code writing (i.e. when not submitting it as part of your assessment) you and anyone else who ever has to read your code would find it of value to make reference to where you found the material to base what you did on. The key issue to bear in mind in this work, as it is submitted ‘as your own work’ is that, to avoid being accused of plagiarism and to allow a fair assessment of what you have done, you must clearly acknowledge which parts of it are your own, and the degree to which you could claim them to be your own.\n",
    "\n",
    "For example, based on ... is absolutely fine, and you would certainly be given credit for what you have done. In many circumstances ‘taken verbatim from ...’ would also be fine (provided it is acknowledged) but then you would be given credit for what you had done with the code that you had taken from elsewhere (e.g. you find some elegant way of doing the graphs that someone has written and you make use of it for presenting your results).\n",
    "\n",
    "The difference between what you submit here and the code you might write if this were not a piece submitted for assessment is that you the vast majority of the credit you will gain for the code will be based on the degree to which you demonstrate that you can write code to achieve the required tasks. There would obviously be some credit for taking codes from the coursenotes and bolting them together into something that achieves the overall aim: provided that worked, and you had commented it adequately and acknowledge what the extent of your efforts had been, you should be able to achieve a pass in that component of the work. If there was no original input other than vbolting pieces of existing code together though, you be unlikely to achieve more than a pass. If you get less than a pass in another component of the coursework, that then puts you in danger of an overall fail.\n",
    "\n",
    "Provided you achieve the core tasks, the more original work that you do/show (that is of good quality), the higher the mark you will get. Once you have achieved the core tasks, even if you try something and don’t quite achieve it, is is probably worth including, as you may get marks for what you have done (or that fact that it was a good or interesting thing to try to do)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Documentation\n",
    "\n",
    "Note: All methods/functions and classes must be documented for the code to be adequate. Generally, this will contain:\n",
    "\n",
    "   - some text on the purpose of the method (/function/class)\n",
    "\n",
    "   - some text describing the inputs and outputs, including reference to any relevant details such as datatype, shape etc where such things are of relevance to understanding the code.\n",
    "\n",
    "   - some text on keywords, e.g.:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 31,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2017-11-21T19:49:34.566235Z",
     "start_time": "2017-11-21T19:49:34.557952Z"
    }
   },
   "outputs": [],
   "source": [
    "def complex(real=0.0, imag=0.0):\n",
    "    \"\"\"Form a complex number.\n",
    "\n",
    "    Keyword arguments:\n",
    "    real -- the real part (default 0.0)\n",
    "    imag -- the imaginary part (default 0.0)\n",
    "\n",
    "    Example taken verbatim from:\n",
    "    http://www.python.org/dev/peps/pep-0257/\n",
    "    \"\"\"\n",
    "    if imag == 0.0 and real == 0.0: return complex_zero\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You should look at the [document on good docstring conventions](http://www.python.org/dev/peps/pep-0257/) when considering how to document methods, classes etc.\n",
    "\n",
    "To demonstrate your documentation, you **must** include the help text generated by your code after you include the code. e.g.:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 35,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2017-11-21T19:49:36.343661Z",
     "start_time": "2017-11-21T19:49:36.337210Z"
    }
   },
   "outputs": [],
   "source": [
    "def print_something(this,stderr=False):\n",
    "    '''This does something.\n",
    "\n",
    "    Keyword arguments:\n",
    "    stderr -- set to True to print to stderr (default False)\n",
    "    '''\n",
    "\n",
    "    if stderr:\n",
    "        # import sys.stderr\n",
    "        from sys import stderr\n",
    "\n",
    "        # print to stderr channel, converting this to str\n",
    "        print >> stderr,str(this)\n",
    "\n",
    "        # job done, return\n",
    "        return\n",
    "\n",
    "    # print to stdout, converting this to str\n",
    "    print (str(this))\n",
    "\n",
    "    return\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Then the help text would be:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 36,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2017-11-21T19:49:37.654141Z",
     "start_time": "2017-11-21T19:49:37.649675Z"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Help on function print_something in module __main__:\n",
      "\n",
      "print_something(this, stderr=False)\n",
      "    This does something.\n",
      "    \n",
      "    Keyword arguments:\n",
      "    stderr -- set to True to print to stderr (default False)\n",
      "\n"
     ]
    }
   ],
   "source": [
    "help(print_something)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The above example represents a ‘good’ level of commenting as the code broadly adheres to the style suggestions and most of the major features are covered. It is not quite ‘very good/excellent’ as the description of the purpose of the method (rather important) is trivial and it fails to describe the input this in any way. An excellent piece would do all of these things, and might well tell us about any dependencies (e.g. requires sys if stderr set to True).\n",
    "\n",
    "An inadequate example would be:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 38,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2017-11-21T19:49:39.641877Z",
     "start_time": "2017-11-21T19:49:39.635030Z"
    }
   },
   "outputs": [],
   "source": [
    "def print_something(this,stderr=False):\n",
    "    '''This prints something'''\n",
    "    if stderr:\n",
    "        from sys import stderr\n",
    "        print >> stderr,str(this)\n",
    "        return\n",
    "    print (str(this))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "It is inadequate because it still only has a trivial description of the purpose of the method, it tells us nothing about inputs/outputs and there is no commenting inside the method."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Word limit\n",
    "\n",
    "There is no word limit per se on the computer codes, though as with all writing, you should try to be succint rather than overly verbose.\n",
    "\n",
    "#### Code style\n",
    "\n",
    "A good to excellent piece of code would take into account issues raised in the [style guide](http://www.python.org/dev/peps/pep-0008/). The ‘degree of excellence’ would depend on how well you take those points on board."
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.6.6"
  },
  "latex_envs": {
   "LaTeX_envs_menu_present": true,
   "autocomplete": true,
   "bibliofile": "biblio.bib",
   "cite_by": "apalike",
   "current_citInitial": 1,
   "eqLabelWithNumbers": true,
   "eqNumInitial": 0,
   "hotkeys": {
    "equation": "Ctrl-E",
    "itemize": "Ctrl-I"
   },
   "labels_anchors": false,
   "latex_user_defs": false,
   "report_style_numbering": false,
   "user_envs_cfg": false
  },
  "toc": {
   "base_numbering": 1,
   "nav_menu": {},
   "number_sections": false,
   "sideBar": true,
   "skip_h1_title": false,
   "title_cell": "Table of Contents",
   "title_sidebar": "Contents",
   "toc_cell": true,
   "toc_position": {
    "height": "calc(100% - 180px)",
    "left": "10px",
    "top": "150px",
    "width": "362.1875px"
   },
   "toc_section_display": "block",
   "toc_window_display": true
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}