j1-template 2022.2.2 → 2022.3.1

data/lib/starter_web/pages/public/jupyter/notebooks/j1/.ipynb_checkpoints/j1_odes_in_python-checkpoint.ipynb

@@ -9,7 +9,7 @@
     }
    },
    "source": [
-    "### Initial Configuration"
+    "## Library Settings"
    ]
   },
   {
@@ -26,12 +26,12 @@
     "import warnings\n",
     "warnings.filterwarnings(\"ignore\")\n",
     "\n",
-    "### General Purpose\n",
+    "# General Purpose\n",
     "import numpy as np\n",
     "from matplotlib import pyplot as plt\n",
     "from scipy.integrate import odeint\n",
     "\n",
-    "### Jupyter Specifics\n",
+    "# Jupyter Specifics\n",
     "from IPython.display import HTML\n",
     "from ipywidgets.widgets import interact, IntSlider, FloatSlider, Layout\n",
     "\n",
@@ -45,7 +45,66 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Familiar Economy"
+    "## Economy of a Home\n",
+    "\n",
+    "A home economy, a family, has a fixed income at the beginning of some periodic interval; usually a month. There are two kind of spendings:\n",
+    "\n",
+    "* Fixed costs \n",
+    "* Extraordinary expenses\n",
+    "\n",
+    "which are proportional to the money at the moment. Additionally, the family decides to set apart some proportion of the income just for fixed costs. This way, when the capital of the family is **below** this amount, the extraordinary **expenses are 0**.\n",
+    "\n",
+    "The model has the following variables:\n",
+    "\n",
+    "* *initial_salary*, the amount of money for the income\n",
+    "* *savings_ratio*, Proportion of the income that will be the keep just for fixed costs\n",
+    "* *fixed_costs*, The amount of money of fixed costs distributed per day\n",
+    "* *extraordinary_expenses*, Proportion of money that will be spend in extraordinary expenses.\n",
+    "* *days*, The time interval until the next income\n",
+    "\n",
+    "Notation for the equation:\n",
+    "\n",
+    "* $x(t)$:  Capital over time\n",
+    "* $x(0)$ = *initial_salary*\n",
+    "* s= savings_ratio * initial_salary\n",
+    "* a = *fixed_costs*\n",
+    "* b = *extraordinary_expenses*\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "With the previously defined notation, the ordinary differential equation is as follows:\n",
+    "\n",
+    "$$\n",
+    "\\frac{\\mathrm{d} x}{\\mathrm{d} t} = \\left\\{\\begin{matrix} - a & x \\leq  s \\\\ - b (x - s) & x > s  \\end{matrix}\\right.\n",
+    "$$\n",
+    "\n",
+    "First, we defined a function called main for easier use of interact which will produce the interactive widget. After that, all the constants are calculated, in this case saving_limit which is analogous to s in the equation.\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "A nested function is defined, this function is the differential equation, it should take two parameters and return the value of $\\frac{\\mathrm{d} x}{\\mathrm{d} t}$. The first parameter can be used as the current value of x for a given t. For the numerical integration _scipy.integrate.odeint_ is used and that's why this format is required. Using a nested function has the advantage that its name doesn't conflict with the outer scope of the function containing it and that it has access to all the parameters the outer function has, avoiding unnecessary indirection due to reference.\n",
+    "\n",
+    "Then the time variable is defined and initialized, this will be the t steps. We have basically two options here:\n",
+    "\n",
+    "* Define the **start**, the **end** and the **number of steps**\n",
+    "* Define the **start**, the **end** and the **step**\n",
+    "\n",
+    "**Note**: It is important to note that this will determined how smooth the resulting function will be. Although at first it might seem that the integration step (usually denoted with h) is implicitly defined here, that's not the case since, as you can see in the docs of scipy.integrate.odeint, h is determined by the solver in each iteration.\n",
+    "\n",
+    "Then the _scipy.integrate.odeint_ function is called with the function defined as a first parameter, the initial conditions as the second and the window time as the third. This function returns the solution array which will be later used for the plotting."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Equation (Home Economy)"
    ]
   },
   {
@@ -57,24 +116,11 @@
      "start_time": "2017-08-15T00:19:29.885794Z"
     }
    },
-   "outputs": [
-    {
-     "data": {
-      "application/vnd.jupyter.widget-view+json": {
-       "model_id": "f7e311e060664e82aa549a076e782cc7",
-       "version_major": 2,
-       "version_minor": 0
-      },
-      "text/plain": [
-       "interactive(children=(IntSlider(value=15000, description='Initial Salary', layout=Layout(width='99%'), max=250…"
-      ]
-     },
-     "metadata": {},
-     "output_type": "display_data"
-    }
-   ],
+   "outputs": [],
    "source": [
-    "def main(initial_salary, savings_ration, extraordinary_expenses, fixed_costs, days):\n",
+    "def main(initial_salary, savings_ration, \n",
+    "         extraordinary_expenses, fixed_costs, days):\n",
+    "\n",
     "    saving_limit = savings_ration * initial_salary\n",
     "    \n",
     "    def function(capital, time):\n",
@@ -104,7 +150,7 @@
     "        step = 10\n",
     "        rotation = \"vertical\"\n",
     "    \n",
-    "    ax.set_xticklabels(np.arange(0, days + 1, step, dtype=int), rotation=rotation)\n",
+    "    ax.set_xticklabels(np.arange(0, days + 1, step, dtype=np.int), rotation=rotation)\n",
     "    ax.set_xticks(np.arange(0, days + 1, step))\n",
     "    \n",
     "    ax.set_yticks(np.arange(0, initial_salary * 1.1, initial_salary / 20))\n",
@@ -116,48 +162,125 @@
     "    ax.legend(loc='best')\n",
     "    ax.grid()\n",
     "    \n",
-    "    plt.show()\n",
+    "    plt.show()\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Next, the graphics part, here matplotlib is used and this snipped is specific to this library but I will explain it in order to be self-contained.\n",
+    "\n",
+    "**Note**: I know there are plenty of plotting libraries, and many even more elegant and powerful than matplotlib but for this use case, where the complexity lies in the differential equation and not in the graphic itself, I believe it is more than enough. For complex graphics such as statistics or big data, I would recommend another library such as bqplot.\n",
+    "\n",
+    "First we define a *figure* and an *axes* object, explicitly initializing the figure size through *figsize*. Then a horizontal line with the label *Saving Limit* is plot at the heigh of the *saving_limit* and after that the solution is plot with the label *Capital(t)*.\n",
     "\n",
-    "interact(main, initial_salary=IntSlider(min=0, max=25000, step=500, value=15000, description='Initial Salary', style=style, layout=slider_layout),\n",
-    "               savings_ration=FloatSlider(min=0, max=1, step=0.01, value=0.2, description='Savings Ratio', style=style, layout=slider_layout),\n",
-    "               extraordinary_expenses=FloatSlider(min=0, max=1, step=0.005, description='Extraordinary Expenses', style=style, value=0.3, layout=slider_layout),\n",
-    "               fixed_costs=IntSlider(min=1, max=1000, step=1, value=100, description='Fixed Costs', style=style, layout=slider_layout),\n",
-    "               days=IntSlider(min=1, max=600, step=5, value=30, description='Total Number of Days', style=style, layout=slider_layout)\n",
-    "        );"
+    "The if-elif-else structure defines how many sticks there will be in the x-axis and if they should be place horizontal or vertically. Then the said sticks are plotted, the same occurs with the yticks. Then the limits for each axis and the labels for each axis are set and finally, the legend position is defined and the grid is added.\n",
+    "\n",
+    "Then when *plt.show()* is called the figure is generated and showed in the screen.\n"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### House and Air Conditionings"
+    "### Evaluation  (Home Economy)\n",
+    "\n",
+    "Finally, the code for the interaction, here the *interact* function from *ipywidgets* is used. A separate slider is used for each parameter with the default parameters set for a nice default visualization, with a description and the style and layout is used from the initialization cells.\n"
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 3,
-   "metadata": {
-    "ExecuteTime": {
-     "end_time": "2017-08-15T00:19:31.822512Z",
-     "start_time": "2017-08-15T00:19:30.842869Z"
-    }
-   },
+   "metadata": {},
    "outputs": [
     {
      "data": {
       "application/vnd.jupyter.widget-view+json": {
-       "model_id": "ea26e30b2de14065ab410b106377b62a",
+       "model_id": "398bded40362405f887c34e1e5a286c2",
        "version_major": 2,
        "version_minor": 0
       },
       "text/plain": [
-       "interactive(children=(IntSlider(value=0, description='Initial sold Houses', layout=Layout(width='99%'), max=20…"
+       "interactive(children=(IntSlider(value=15000, description='Initial Salary', layout=Layout(width='99%'), max=250…"
       ]
      },
      "metadata": {},
      "output_type": "display_data"
     }
    ],
+   "source": [
+    "interact(main,\n",
+    "    initial_salary=IntSlider(min=0, max=25000, step=500, value=15000,\n",
+    "        description='Initial Salary', style=style, layout=slider_layout),\n",
+    "    savings_ration=FloatSlider(min=0, max=1, step=0.01, value=0.2,\n",
+    "        description='Savings Ratio', style=style, layout=slider_layout),\n",
+    "    extraordinary_expenses=FloatSlider(min=0, max=1, step=0.005,\n",
+    "        description='Extraordinary Expenses', style=style, value=0.3, layout=slider_layout),\n",
+    "    fixed_costs=IntSlider(min=1, max=1000, step=1, value=100,\n",
+    "        description='Fixed Costs', style=style, layout=slider_layout),\n",
+    "    days=IntSlider(min=1, max=60, step=1, value=30,\n",
+    "        description='Total Number of Days', style=style, layout=slider_layout)\n",
+    ");"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Sales of Houses and Air Conditionings\n",
+    "\n",
+    "In a city there are houses and air conditionings (AC) for sale and it's known that these are complementary goods, which means that if the sales of one increase the sales of the other will also increase. The number of houses sales is proportional to the number of houses that weren't sold yet and the number of AC sales is proportional to the houses sold that doesn't yet have an AC.\n",
+    "\n",
+    "The model has the following variables:\n",
+    "\n",
+    "* _initial_houses_: Number of Houses initially sold, could be 0\n",
+    "* _initial_ac_: Number of air conditionings sold, could be 0 and\n",
+    "  should be less than initial_houses\n",
+    "* _avg_time_house_: Average number of days to sell a **house**\n",
+    "* _avg_time_ac_: Average number of days to sell an **AC**\n",
+    "* _total_houses_: Total number of **Houses for sale**\n",
+    "* _days_: The time interval until the **next income**\n",
+    "\n",
+    "Notation for the equation:\n",
+    "\n",
+    "* $x(t)$: Number of sold Houses\n",
+    "* $y(t)$: Number of sold Air Conditionings\n",
+    "* $x(0)$= _initial_houses_\n",
+    "* $y(0)$= _initial_ac_\n",
+    "* h = _total_houses_\n",
+    "* a = _avg_time_house_\n",
+    "* b = _avg_time_ac_\n",
+    "\n",
+    "With the previously defined notation, the ordinary differential equation is as follows:\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "$$\n",
+    "\\left\\{\\begin{matrix} \\frac{\\mathrm{d} x}{\\mathrm{d} t} =\\frac{1}{a} (h - x) \\\\\\\\ \\frac{\\mathrm{d} y}{\\mathrm{d} t} =\\frac{1}{b} (x - y)  \\end{matrix}\\right.\n",
+    "$$"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Equation (Homes and ACs)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2017-08-15T00:19:31.822512Z",
+     "start_time": "2017-08-15T00:19:30.842869Z"
+    }
+   },
+   "outputs": [],
    "source": [
     "def main(initial_houses, initial_ac, avg_time_house, avg_time_ac, total_houses, days):\n",
     "\n",
@@ -190,7 +313,7 @@
     "        step = 10\n",
     "        rotation = \"vertical\"\n",
     "    \n",
-    "    ax.set_xticklabels(np.arange(0, days + 1, step, dtype=int), rotation=rotation)\n",
+    "    ax.set_xticklabels(np.arange(0, days + 1, step, dtype=np.int), rotation=rotation)\n",
     "    ax.set_xticks(np.arange(0, days + 1, step))\n",
     "    \n",
     "    ax.set_yticks(np.arange(0, total_houses * 1.1, total_houses / 20))\n",
@@ -202,43 +325,41 @@
     "    ax.legend(loc='best')\n",
     "    ax.grid()\n",
     "    \n",
-    "    plt.show()\n",
+    "    plt.show()\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "In this scenario and the followings the code will be explain where it differs from the first example to avoid unnecesary repetition.\n",
+    "\n",
+    "In this case the constants *avg_time_house* and *avg_time_ac* are used directly inside the function since it is much clearer this way. To define a system of ODEs, first the initial condition should be a list, each element of the list represents the initial condition for each of the variables. The nested function also changes a bit, in order to work, the first parameter would also be a list so it is necessary to unpack it into the variables and then a variable *dydt* is used to represent the system where each element is the left side of each equation in canonical form.\n",
     "\n",
-    "interact(main, initial_houses=IntSlider(min=0, max=2000, step=10, value=0, description='Initial sold Houses', style=style, layout=slider_layout),\n",
-    "               initial_ac=IntSlider(min=0, max=2000, step=10, value=0, description='Initial sold AC', style=style, layout=slider_layout),\n",
-    "               total_houses=IntSlider(min=1, max=2000, step=100, value=1000, description='Total Houses', style=style, layout=slider_layout),\n",
-    "               avg_time_house=FloatSlider(min=0.1, max=24, step=0.1, value=2, description='Time for House', style=style, layout=slider_layout),\n",
-    "               avg_time_ac=FloatSlider(min=0.1, max=24, step=0.1, value=4, description='Time for AC', style=style, layout=slider_layout),\n",
-    "               days=IntSlider(min=1, max=360, step=10, value=30, description='Total Number of Days', style=style, layout=slider_layout),\n",
-    "        );"
+    "Finally the *dydt* variable is returned. The definition of *time* is the same as previously seen and the solution variable is now a nested array containing the solution for both variables. This is specially useful when plotting."
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Stock Control"
+    "### Evaluation (Homes and ACs)"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 4,
-   "metadata": {
-    "ExecuteTime": {
-     "end_time": "2017-08-15T00:19:31.822512Z",
-     "start_time": "2017-08-15T00:19:30.842869Z"
-    }
-   },
+   "execution_count": 5,
+   "metadata": {},
    "outputs": [
     {
      "data": {
       "application/vnd.jupyter.widget-view+json": {
-       "model_id": "35a5060ce6014c46ab98d7a55666f9e4",
+       "model_id": "7b2efc55994c46df96bc20ef70695541",
        "version_major": 2,
        "version_minor": 0
       },
       "text/plain": [
-       "interactive(children=(IntSlider(value=4, description='Desired Stock', layout=Layout(width='99%'), min=1, style…"
+       "interactive(children=(IntSlider(value=0, description='Initial sold Houses', layout=Layout(width='99%'), max=20…"
       ]
      },
      "metadata": {},
@@ -246,13 +367,98 @@
     }
    ],
    "source": [
-    "def main(desired_stock, initial_stock, initial_request, stock_control, market_demand, provider_delay, days):\n",
+    "interact(main,\n",
+    "    initial_houses=IntSlider(min=0, max=2000, step=10, value=0,\n",
+    "        description='Initial sold Houses', style=style, layout=slider_layout),\n",
+    "    initial_ac=IntSlider(min=0, max=2000, step=10, value=0,\n",
+    "        description='Initial sold AC', style=style, layout=slider_layout),\n",
+    "    total_houses=IntSlider(min=1, max=2000, step=100, value=1000,\n",
+    "        description='Total Houses', style=style, layout=slider_layout),\n",
+    "    avg_time_house=FloatSlider(min=0.1, max=24, step=0.1, value=2,\n",
+    "        description='Time for House', style=style, layout=slider_layout),\n",
+    "    avg_time_ac=FloatSlider(min=0.1, max=24, step=0.1, value=4,\n",
+    "        description='Time for AC', style=style, layout=slider_layout),\n",
+    "    days=IntSlider(min=1, max=360, step=10, value=30,\n",
+    "        description='Total Number of Days', style=style, layout=slider_layout),\n",
+    ");"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Stock Control\n",
+    "\n",
+    "A company wants a desired stock, they started with an initial stock and they work with a provider which sends deliveries goods through sales orders. The company asks the provider each day a sales order proportional to the missing or surplus quantity to the desired stock and the market demand. \n",
+    "\n",
+    "The provider deliver the goods according to the sales order with a constant delay. Finally, the market demand is consider constant. The company wants to know how their stock and their request to the provider will behave and they will try to avoid alternating behavior, a oscillation in stock.\n",
+    "\n",
+    "The model has the following variables:\n",
+    "\n",
+    "* _desired_stock_: Amount of stock the company wants to have.\n",
+    "* _initial_stock_: The initial amount of stock of the company.\n",
+    "* _initial_orders_: initial amount of goods asked in sales orders.\n",
+    "* _stock_control_: Proportion of the missing/surplus stock to ask to the provider.\n",
+    "* _market_demand_: The daily demand of the market\n",
+    "* _provider_delay_: The number of days of the provider delay.\n",
+    "* _days_: The total number of days the model will analyse.\n",
+    "\n",
+    "Notation for the equation:\n",
+    "\n",
+    "* $x(t)$: Number of goods in stock\n",
+    "* $y(t)$: Number of pending sales order sent to the provider\n",
+    "* $x(0)$ = _initial_stock_\n",
+    "* $y(0)$ = _initial_orders_\n",
+    "* s = _desired_stock_\n",
+    "* d = _market_demand_\n",
+    "* k = _stock_control_\n",
+    "* p = _provider_delay_\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "With the previously defined notation, the ordinary differential equation is as follows:\n",
+    "\n",
+    "$$\n",
+    "\\left\\{\\begin{matrix} \\frac{\\mathrm{d} x}{\\mathrm{d} t} =&   \\frac{1}{p} y - d \\\\\\\\ \\frac{\\mathrm{d} y}{\\mathrm{d} t} =& - \\frac{1}{p} y + d + k ( s - x ) \\end{matrix}\\right.\n",
+    "$$\n",
+    "\n",
+    "This time the code is only changed in the variables names and the equations but it is very similar to the previous example, the particularity of this model doesn't lie in the code but rather in the behavior, since it can show the differences between an **oscillation** behavior and a damped one. Going through all kinds of possibilities such as underdamped, overdamped, critically damped and undamped. I encourage you to experiment with the parameters in the widget.\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Equation (Stock Control)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2017-08-15T00:19:31.822512Z",
+     "start_time": "2017-08-15T00:19:30.842869Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "def main(desired_stock, initial_stock,\n",
+    "         initial_request, stock_control, market_demand, \n",
+    "         provider_delay, days):\n",
     "    \n",
     "    def function(v0, time):\n",
     "        x, y = v0\n",
+    "\n",
+    "        # dx/dt -> Change in Stock\n",
+    "        # dy/dt -> Change in Requests\n",
+    "        #\n",
     "        dydt = [\n",
-    "            (1 / provider_delay) * y - market_demand, # dx/dt -> Change in Stock\n",
-    "          - (1 / provider_delay) * y + market_demand + stock_control * (desired_stock - x) # dy/dt -> Change in Requests\n",
+    "            (1 / provider_delay) * y - market_demand,\n",
+    "          - (1 / provider_delay) * y + market_demand + stock_control * (desired_stock - x)\n",
     "        ]\n",
     "        return dydt\n",
     "    \n",
@@ -260,7 +466,8 @@
     "    initial_conditions = [initial_stock, initial_request]\n",
     "    solution = odeint(function, initial_conditions, time)\n",
     "\n",
-    "    #Graphic details\n",
+    "    # Graphic details\n",
+    "    #\n",
     "    fig, ax = plt.subplots(figsize=(15, 10))\n",
     " \n",
     "    ax.plot(time, solution[:, 0], label='Stock(t)')\n",
@@ -277,7 +484,7 @@
     "        step = 10\n",
     "        rotation = \"vertical\"\n",
     "    \n",
-    "    ax.set_xticklabels(np.arange(0, days + 1, step, dtype=int), rotation=rotation)\n",
+    "    ax.set_xticklabels(np.arange(0, days + 1, step, dtype=np.int), rotation=rotation)\n",
     "    ax.set_xticks(np.arange(0, days + 1, step))\n",
     "    \n",
     "    ax.set_xlim([0, days])\n",
@@ -288,51 +495,109 @@
     "    ax.grid()\n",
     "    \n",
     "    plt.show()\n",
-    "    \n",
-    "\n",
-    "interact(main,\n",
-    "        desired_stock=IntSlider(min=1, max=100, step=1, value=4, description='Desired Stock', style=style, layout=slider_layout),\n",
-    "        initial_stock=IntSlider(min=1, max=100, step=1, value=8, description='Initial Stock', style=style, layout=slider_layout),\n",
-    "        initial_request=IntSlider(min=1, max=100, step=1, value=14, description='Initial Requests', style=style, layout=slider_layout),\n",
-    "        stock_control=FloatSlider(min=0, max=2, step=0.001, value=1.5, description='Stock Control', style=style, layout=slider_layout),\n",
-    "        market_demand=FloatSlider(min=0, max=24, step=0.01, value=3, description='Market Demand', style=style, layout=slider_layout),\n",
-    "        provider_delay=FloatSlider(min=0, max=10, step=0.1, value=4, description='Provider Delay', style=style, layout=slider_layout),\n",
-    "        days=IntSlider(min=1, max=360, step=10, value=50, description='Total Number of Days', style=style, layout=slider_layout),\n",
-    "        );"
+    "    "
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Useful life"
+    "### Evaluation  (Stock Control)"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
-   "metadata": {
-    "ExecuteTime": {
-     "end_time": "2017-08-15T00:19:35.290946Z",
-     "start_time": "2017-08-15T00:19:31.830523Z"
-    }
-   },
+   "execution_count": 7,
+   "metadata": {},
    "outputs": [
     {
      "data": {
       "application/vnd.jupyter.widget-view+json": {
-       "model_id": "51fca84599804ca3b25512d15c1ef2db",
+       "model_id": "10e1c36ac5624de29d44457eb99567a0",
        "version_major": 2,
        "version_minor": 0
       },
       "text/plain": [
-       "interactive(children=(FloatSlider(value=3.8, description='Useful Life (hs)', layout=Layout(width='99%'), max=2…"
+       "interactive(children=(IntSlider(value=4, description='Desired Stock', layout=Layout(width='99%'), min=1, style…"
       ]
      },
      "metadata": {},
      "output_type": "display_data"
     }
    ],
+   "source": [
+    "interact(main,\n",
+    "    desired_stock=IntSlider(min=1, max=100, step=1, value=4,\n",
+    "        description='Desired Stock', style=style, layout=slider_layout),\n",
+    "    initial_stock=IntSlider(min=1, max=100, step=1, value=8,\n",
+    "        description='Initial Stock', style=style, layout=slider_layout),\n",
+    "    initial_request=IntSlider(min=1, max=100, step=1, value=14,\n",
+    "        description='Initial Requests', style=style, layout=slider_layout),\n",
+    "    stock_control=FloatSlider(min=0, max=2, step=0.001, value=1.5,\n",
+    "        description='Stock Control', style=style, layout=slider_layout),\n",
+    "    market_demand=FloatSlider(min=0, max=24, step=0.01, value=3,\n",
+    "        description='Market Demand', style=style, layout=slider_layout),\n",
+    "    provider_delay=FloatSlider(min=0, max=10, step=0.1, value=4,\n",
+    "        description='Provider Delay', style=style, layout=slider_layout),\n",
+    "    days=IntSlider(min=1, max=360, step=10, value=50,\n",
+    "        description='Total Number of Days', style=style, layout=slider_layout),\n",
+    ");"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Useful life\n",
+    "\n",
+    "A patient takes a certain drug with a recipe, the recipe says how many milligrams the patient should have per intake, how often the intakes should be and how many. Additionally the drug itself provides information about its useful life which helps to determine the optimal interval between intakes. It's also known that the useful life of the drug follows a natural decay.\n",
+    "\n",
+    "The model has the following variables:\n",
+    "\n",
+    "* _useful_life_: Duration of the useful life of the drug in hours\n",
+    "* _intake_mg_: Amount of milligrams per intake.\n",
+    "* _intake_interval_: Time interval in hours between intakes.\n",
+    "* _intake_number_: Number of intakes.\n",
+    "* _hours_: The total number of hours the model will analyse.\n",
+    "\n",
+    "Notation for the equation:\n",
+    "\n",
+    "* $x(t)$: Milligrams of drug in the body\n",
+    "* $x(0)$: _intake_mg_\n",
+    "* a = _useful_life_\n",
+    "\n",
+    "With the previously defined notation, the ordinary differential equation is as follows:\n",
+    "\n",
+    "$$\n",
+    "\\frac{\\mathrm{d} x}{\\mathrm{d} t} = - \\frac{1}{a} ln(2) y\n",
+    "$$\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "**Note**: the expression $ln(2)$ is part of the **natural decay formula**.\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Equation (Useful life)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2017-08-15T00:19:35.290946Z",
+     "start_time": "2017-08-15T00:19:31.830523Z"
+    }
+   },
+   "outputs": [],
    "source": [
     "def main(useful_life, intake_mg, intake_interval, intake_number, hours):\n",
     "    \n",
@@ -375,7 +640,7 @@
     "        step = 10\n",
     "        rotation = \"vertical\"\n",
     "    \n",
-    "    ax.set_xticklabels(np.arange(0, hours + 1, step, dtype=int), rotation=rotation)\n",
+    "    ax.set_xticklabels(np.arange(0, hours + 1, step, dtype=np.int), rotation=rotation)\n",
     "    ax.set_xticks(np.arange(0, hours + 1, step))\n",
     "    \n",
     "    ax.set_xlim([0, hours])\n",
@@ -385,27 +650,152 @@
     "    ax.legend(loc='best')\n",
     "    ax.grid()\n",
     "    \n",
-    "    plt.show()\n",
+    "    plt.show()\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "This model doesn't introduces complexity in the ODE but rather in the way one can model the successive intakes. It is usually helpful to keep this 'iteration logic' independent from the ODE itself, that's why no particular changes are needed in the equations.\n",
+    "\n",
+    "There are many ways for achieving this but the one I used is the following:\n",
     "\n",
+    "1. Create a list with all the intake hours\n",
+    "2. Create an empty list, times, for the times\n",
+    "3. Create an empty list, solutions for the solutions\n",
+    "4. Iterate through that list\n",
+    "  * Create a time array starting in the time iterated and ended in the time\n",
+    "    iterated + the intake_interval\n",
+    "  * Solve the ODE with the initial_condition and the previously created time\n",
+    "  * Update the value of the initial_conditions with the final solution\n",
+    "  * Append the solution list to the end of the solutions list\n",
+    "  * Append the time list to the end of the times list\n",
+    "5. Create a time array starting from the last the last time of intakes\n",
+    "   to 10 times the intake_interval\n",
+    "6. Solve the ODE again with a longer interval to see how it behaves\n",
+    "   after the iterations\n",
+    "7. Append the solution list to the end of the solutions list\n",
+    "8. Append the time list to the end of the times list\n",
+    "9. Proceed to Plotting\n",
+    "\n",
+    "This approach consist in solving several ODEs, each of which receives the final solution of the previous as its initial conditions."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Evaluation (Useful life)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {
+    "scrolled": true
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "b99aec4c67464c42a75af50162cb6433",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "interactive(children=(FloatSlider(value=3.8, description='Useful Life', layout=Layout(width='99%'), max=24.0, …"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
     "interact(main,        \n",
-    "        useful_life=FloatSlider(min=0, max=24, step=0.01, value=3.8, description='Useful Life (hs)', style=style, layout=slider_layout),\n",
-    "        intake_mg=FloatSlider(min=0, max=1, step=0.001, value=0.01, description='Miligrams per Intake', style=style, layout=slider_layout),\n",
-    "        intake_interval=FloatSlider(min=0, max=24, step=0.1, value=6, description='Hours between Intakes', style=style, layout=slider_layout),\n",
-    "        intake_number=IntSlider(min=1, max=20, step=1, value=4, description='Number of Intakes', style=style, layout=slider_layout),\n",
-    "        hours=FloatSlider(min=1, max=240, step=0.5, value=40, description='Total number of Hours', style=style, layout=slider_layout),\n",
-    "        );"
+    "    useful_life=FloatSlider(min=0, max=24, step=0.01, value=3.8,\n",
+    "        description='Useful Life', style=style, layout=slider_layout),\n",
+    "    intake_mg=FloatSlider(min=0, max=1, step=0.001, value=0.01,\n",
+    "        description='Miligrams per Intake', style=style, layout=slider_layout),\n",
+    "    intake_interval=FloatSlider(min=0, max=24, step=0.1, value=6,\n",
+    "        description='Hours between Intakes', style=style, layout=slider_layout),\n",
+    "    intake_number=IntSlider(min=1, max=20, step=1, value=4,\n",
+    "        description='Number of Intakes', style=style, layout=slider_layout),\n",
+    "    hours=FloatSlider(min=1, max=240, step=0.5, value=40,\n",
+    "        description='Total number of Hours', style=style, layout=slider_layout),\n",
+    ");"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Foxes and Rabbits"
+    "## Foxes and Rabbits\n",
+    "\n",
+    "This is the model known as *predator–prey* or *Lotka–Volterra* equations. There are two species, a predator and a prey, like foxes and rabbits. Each has a certain birthrate and a deathrate. The birthrate of the prey is proportional to its current population and the birthrate of the predator is proportional to both its population and the prey population. The deathrate of the prey is proportional to both its population and the predator population and the deathrate of the predator is proportional to its population.\n",
+    "\n",
+    "The model has the following variables:\n",
+    "\n",
+    "* *rabbits_birthrate*: Rabbits birthrate\n",
+    "* *rabbits_deathrate*: Rabbits deathrate\n",
+    "* *foxes_birthrate*: Foxes birthrate\n",
+    "* *initial_rabbits*: Initial rabbits\n",
+    "* *initial_foxes*: Initial foxes\n",
+    "* *days*: The total number of days the model will analyse\n",
+    "\n",
+    "Notation for the equation:\n",
+    "\n",
+    "* $x(t)$:  Population of Rabbits over time\n",
+    "* $y(t)$:  Population of Foxes over time\n",
+    "* $x(0)$ = *initial_rabbits*\n",
+    "* $y(0)$ = *initial_foxes*\n",
+    "* a = *rabbits_birthrate*\n",
+    "* b = *rabbits_deathrate*\n",
+    "* c = *foxes_birthrate*\n",
+    "* d = *foxes_deathrate*\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "With the previously defined notation, the ordinary differential equation is as follows:\n",
+    "\n",
+    "$$\n",
+    "\\left\\{\\begin{matrix} \\frac{\\mathrm{d} x}{\\mathrm{d} t} =& a x &-& bxy\\\\\\\\ \\frac{\\mathrm{d} y}{\\mathrm{d} t} =& cxy &-& dy \\end{matrix}\\right.\n",
+    "$$\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Or more concisely:\n",
+    "\n",
+    "$$\n",
+    "\\left\\{\\begin{matrix} \\frac{\\mathrm{d} x}{\\mathrm{d} t} =& x (a - by)\\\\\\\\ \\frac{\\mathrm{d} y}{\\mathrm{d} t} =& y (cx - d) \\end{matrix}\\right.\n",
+    "$$\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "**Note**: The *Lotka-Volterra equations* are a pair of first-order nonlinear differential\n",
+    "equations, frequently used to describe the dynamics of biological systems in which\n",
+    "two species interact, one as a predator and the other as prey.\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Equation (Foxes and Rabbits)"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 6,
+   "execution_count": 10,
    "metadata": {
     "ExecuteTime": {
      "end_time": "2017-08-15T00:19:36.846923Z",
@@ -415,7 +805,9 @@
    },
    "outputs": [],
    "source": [
-    "def main(rabbits_birthrate, rabbits_deathrate, foxes_birthrate, foxes_deathrate, initial_rabbits, foxes_inicial, days):\n",
+    "def main(rabbits_birthrate, rabbits_deathrate,\n",
+    "         foxes_birthrate, foxes_deathrate, \n",
+    "         initial_rabbits, initial_foxes, days):\n",
     "\n",
     "    def function(s, t):\n",
     "        x, y = s\n",
@@ -427,10 +819,11 @@
     "        return dydt\n",
     "    \n",
     "    time = np.arange(0, days, 0.01)\n",
-    "    initial_conditions = [initial_rabbits, foxes_inicial]\n",
+    "    initial_conditions = [initial_rabbits, initial_foxes]\n",
     "    solution = odeint(function, initial_conditions, time)\n",
     "\n",
-    "    #Graphic details\n",
+    "    # Graphic details\n",
+    "    #\n",
     "    fig, axes = plt.subplots(1, 2, figsize=(15, 10))\n",
     "    \n",
     "    ax = axes[0]\n",
@@ -448,7 +841,7 @@
     "        step = 10\n",
     "        rotation = \"vertical\"\n",
     "    \n",
-    "    ax.set_xticklabels(np.arange(0, days + 1, step, dtype=int), rotation=rotation)\n",
+    "    ax.set_xticklabels(np.arange(0, days + 1, step, dtype=np.int), rotation=rotation)\n",
     "    ax.set_xticks(np.arange(0, days + 1, step))\n",
     "        \n",
     "    ax.set_xlim([0, days])\n",
@@ -457,8 +850,7 @@
     "    ax.set_ylabel('Population')\n",
     "    ax.legend(loc='best')\n",
     "    ax.grid()\n",
-    "    \n",
-    "    \n",
+    "        \n",
     "    ax = axes[1]\n",
     "    \n",
     "    ax.plot(solution[:, 0], solution[:, 1], label='Foxes vs Rabbits')\n",
@@ -471,18 +863,27 @@
     "    ax.grid()\n",
     "    \n",
     "    plt.tight_layout()\n",
-    "    plt.show()"
+    "    plt.show()\n"
    ]
   },
   {
-   "cell_type": "code",
-   "execution_count": 7,
+   "cell_type": "markdown",
    "metadata": {},
+   "source": [
+    "### Evaluation (Foxes and Rabbits)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {
+    "scrolled": true
+   },
    "outputs": [
     {
      "data": {
       "application/vnd.jupyter.widget-view+json": {
-       "model_id": "56c139c989b14702be053bc986334ae5",
+       "model_id": "8432a49d585548b1841907d05dda3222",
        "version_major": 2,
        "version_minor": 0
       },
@@ -495,14 +896,22 @@
     }
    ],
    "source": [
-    "interact(main, rabbits_birthrate=FloatSlider(min=0, max=25, step=1, value=1, description='Birth Rate of Rabbits', style=style, layout=slider_layout),\n",
-    "               rabbits_deathrate=FloatSlider(min=0, max=25, step=1, value=1, description='Death Rate of Rabbits', style=style, layout=slider_layout),\n",
-    "               foxes_birthrate=FloatSlider(min=0, max=25, step=1, value=1, description='Birth Rate of Foxes', style=style, layout=slider_layout),\n",
-    "               foxes_deathrate=FloatSlider(min=0, max=25, step=1, value=1, description='Death Rate of Foxes', style=style, layout=slider_layout),\n",
-    "               initial_rabbits=FloatSlider(min=0 , max=100, step=1, value=2, description='Initial Rabbits', style=style, layout=slider_layout),\n",
-    "               foxes_inicial=FloatSlider(min=0 , max=100, step=1, value=1, description='Initial Foxes', style=style, layout=slider_layout),\n",
-    "               days=FloatSlider(min=0 ,max=365 , step=10, value=15, description='Total number of Days', style=style, layout=slider_layout),\n",
-    "        );"
+    "interact(main,\n",
+    "    rabbits_birthrate=FloatSlider(min=0, max=24, step=0.01, value=1,\n",
+    "        description='Birth Rate of Rabbits', style=style, layout=slider_layout),\n",
+    "    rabbits_deathrate=FloatSlider(min=0, max=24, step=0.01, value=1,\n",
+    "        description='Death Rate of Rabbits', style=style, layout=slider_layout),\n",
+    "    foxes_birthrate=FloatSlider(min=0, max=24, step=0.01, value=1,\n",
+    "        description='Birth Rate of Foxes', style=style, layout=slider_layout),\n",
+    "    foxes_deathrate=FloatSlider(min=0, max=24, step=0.01, value=1,\n",
+    "        description='Death Rate of Foxes', style=style, layout=slider_layout),\n",
+    "    initial_rabbits=FloatSlider(min=0 , max=100, step=1, value=2,\n",
+    "        description='Initial Rabbits', style=style, layout=slider_layout),\n",
+    "    initial_foxes=FloatSlider(min=0 , max=100, step=1, value=1,\n",
+    "        description='Initial Foxes', style=style, layout=slider_layout),\n",
+    "    days=FloatSlider(min=0 ,max=365 , step=10, value=15,\n",
+    "        description='Total number of Days', style=style, layout=slider_layout),\n",
+    ");"
    ]
   }
  ],