Appendix-G-Designing-Nonlinear-Kalman-Filters.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "[Table of Contents](http://nbviewer.ipython.org/github/rlabbe/Kalman-and-Bayesian-Filters-in-Python/blob/master/table_of_contents.ipynb)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Designing Nonlinear Kalman Filters"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<style>\n",
       "@import url('http://fonts.googleapis.com/css?family=Source+Code+Pro');\n",
       "@import url('http://fonts.googleapis.com/css?family=Lora');\n",
       "\n",
       "//@import url('http://fonts.googleapis.com/css?family=Open+Sans');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Vollkorn');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Karla');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Poppins');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Arimo');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Roboto');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Lato');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Domine');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Chivo');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Cardo');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Arvo');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Crimson+Text');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Ubuntu');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Fontin');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Raleway');\n",
       "//@import url('http://fonts.googleapis.com/css?family=Merriweather');\n",
       "\n",
       "\n",
       ".CodeMirror pre {\n",
       "    font-family: 'Source Code Pro', Consolas, monocco, monospace;\n",
       "}\n",
       "    div.cell{\n",
       "        //width: 950px;\n",
       "        margin-left: 0% !important;\n",
       "        margin-right: auto;\n",
       "    }\n",
       "    div.text_cell_render{\n",
       "        font-family: 'Lora';\n",
       "        //font-family: 'Open Sans';\n",
       "        //font-family: 'Karla',verdana,arial,sans-serif;\n",
       "        //font-family: 'Roboto',verdana,arial,sans-serif;\n",
       "        //font-family: 'Lato',verdana,arial,sans-serif;\n",
       "        //font-family: 'Domine',verdana,arial,sans-serif;\n",
       "        //font-family: 'Chivo',verdana,arial,sans-serif;\n",
       "        //font-family: 'Cardo',verdana,arial,sans-serif;\n",
       "        //font-family: 'Arvo',verdana,arial,sans-serif;\n",
       "        //font-family: 'Poppins',verdana,arial,sans-serif;\n",
       "        //font-family: 'Ubuntu',verdana,arial,sans-serif;\n",
       "        //font-family: 'Fontin',verdana,arial,sans-serif;\n",
       "        //font-family: 'Raleway',verdana,arial,sans-serif;\n",
       "        //font-family: 'Merriweather',verdana,arial,sans-serif;\n",
       "        //font-family: 'Crimson Text', verdana,arial,sans-serif;\n",
       "        //font-family: verdana,arial,sans-serif;\n",
       "        //font-family: arial,sans-serif;\n",
       "        line-height: 125%;\n",
       "        font-size: 130%;\n",
       "        text-align: justify;\n",
       "        text-justify:inter-word;\n",
       "    }\n",
       "    div.text_cell code {\n",
       "        background: transparent;\n",
       "        color: #000000;\n",
       "        font-weight: 400;\n",
       "        font-size: 12pt;\n",
       "        //font-style: bold;\n",
       "        font-family:  'Source Code Pro', Consolas, monocco, monospace;\n",
       "   }\n",
       "    h1 {\n",
       "        font-family: 'Open sans',verdana,arial,sans-serif;\n",
       "\t}\n",
       "\n",
       "    div.input_area {\n",
       "        background: #F6F6F9;\n",
       "        border: 1px solid #586e75;\n",
       "    }\n",
       "\n",
       "    .text_cell_render h1 {\n",
       "        font-weight: 200;\n",
       "        font-size: 30pt;\n",
       "        line-height: 100%;\n",
       "        color:#c76c0c;\n",
       "        margin-bottom: 0.5em;\n",
       "        margin-top: 1em;\n",
       "        display: block;\n",
       "        white-space: wrap;\n",
       "        text-align: left;\n",
       "    }\n",
       "    h2 {\n",
       "        font-family: 'Open sans',verdana,arial,sans-serif;\n",
       "        text-align: left;\n",
       "    }\n",
       "    .text_cell_render h2 {\n",
       "        font-weight: 200;\n",
       "        font-size: 16pt;\n",
       "        font-style: italic;\n",
       "        line-height: 100%;\n",
       "        color:#c76c0c;\n",
       "        margin-bottom: 0.5em;\n",
       "        margin-top: 1.5em;\n",
       "        display: block;\n",
       "        white-space: wrap;\n",
       "        text-align: left;\n",
       "    }\n",
       "    h3 {\n",
       "        font-family: 'Open sans',verdana,arial,sans-serif;\n",
       "    }\n",
       "    .text_cell_render h3 {\n",
       "        font-weight: 200;\n",
       "        font-size: 14pt;\n",
       "        line-height: 100%;\n",
       "        color:#d77c0c;\n",
       "        margin-bottom: 0.5em;\n",
       "        margin-top: 2em;\n",
       "        display: block;\n",
       "        white-space: wrap;\n",
       "        text-align: left;\n",
       "    }\n",
       "    h4 {\n",
       "        font-family: 'Open sans',verdana,arial,sans-serif;\n",
       "    }\n",
       "    .text_cell_render h4 {\n",
       "        font-weight: 100;\n",
       "        font-size: 14pt;\n",
       "        color:#d77c0c;\n",
       "        margin-bottom: 0.5em;\n",
       "        margin-top: 0.5em;\n",
       "        display: block;\n",
       "        white-space: nowrap;\n",
       "    }\n",
       "    h5 {\n",
       "        font-family: 'Open sans',verdana,arial,sans-serif;\n",
       "    }\n",
       "\n",
       "    .text_cell_render h5 {\n",
       "        font-weight: 200;\n",
       "        font-style: normal;\n",
       "        color: #1d3b84;\n",
       "        font-size: 16pt;\n",
       "        margin-bottom: 0em;\n",
       "        margin-top: 0.5em;\n",
       "        display: block;\n",
       "        white-space: nowrap;\n",
       "    }\n",
       "    div.output_subarea.output_text.output_pyout {\n",
       "        overflow-x: auto;\n",
       "        overflow-y: scroll;\n",
       "        max-height: 50000px;\n",
       "    }\n",
       "    div.output_subarea.output_stream.output_stdout.output_text {\n",
       "        overflow-x: auto;\n",
       "        overflow-y: scroll;\n",
       "        max-height: 50000px;\n",
       "    }\n",
       "    div.output_wrapper{\n",
       "        margin-top:0.2em;\n",
       "        margin-bottom:0.2em;\n",
       "}\n",
       "\n",
       "    code{\n",
       "        font-size: 6pt;\n",
       "\n",
       "    }\n",
       "    .rendered_html code{\n",
       "    background-color: transparent;\n",
       "    }\n",
       "    ul{\n",
       "        margin: 2em;\n",
       "    }\n",
       "    ul li{\n",
       "        padding-left: 0.5em;\n",
       "        margin-bottom: 0.5em;\n",
       "        margin-top: 0.5em;\n",
       "    }\n",
       "    ul li li{\n",
       "        padding-left: 0.2em;\n",
       "        margin-bottom: 0.2em;\n",
       "        margin-top: 0.2em;\n",
       "    }\n",
       "    ol{\n",
       "        margin: 2em;\n",
       "    }\n",
       "    ol li{\n",
       "        padding-left: 0.5em;\n",
       "        margin-bottom: 0.5em;\n",
       "        margin-top: 0.5em;\n",
       "    }\n",
       "    ul li{\n",
       "        padding-left: 0.5em;\n",
       "        margin-bottom: 0.5em;\n",
       "        margin-top: 0.2em;\n",
       "    }\n",
       "    a:link{\n",
       "       color:#447adb;\n",
       "    }\n",
       "    a:visited{\n",
       "       color: #1d3b84;\n",
       "    }\n",
       "    a:hover{\n",
       "       color: #1d3b84;\n",
       "    }\n",
       "    a:focus{\n",
       "       color:#447adb;\n",
       "    }\n",
       "    a:active{\n",
       "       font-weight: bold;\n",
       "       color:#447adb;\n",
       "    }\n",
       "    .rendered_html :link {\n",
       "       text-decoration: underline;\n",
       "    }\n",
       "    .rendered_html :hover {\n",
       "       text-decoration: none;\n",
       "    }\n",
       "    .rendered_html :visited {\n",
       "      text-decoration: none;\n",
       "    }\n",
       "    .rendered_html :focus {\n",
       "      text-decoration: none;\n",
       "    }\n",
       "    .rendered_html :active {\n",
       "      text-decoration: none;\n",
       "    }\n",
       "    .warning{\n",
       "        color: rgb( 240, 20, 20 )\n",
       "    }\n",
       "    hr {\n",
       "      color: #f3f3f3;\n",
       "      background-color: #f3f3f3;\n",
       "      height: 1px;\n",
       "    }\n",
       "    blockquote{\n",
       "      display:block;\n",
       "      background: #fcfcfc;\n",
       "      border-left: 5px solid #c76c0c;\n",
       "      font-family: 'Open sans',verdana,arial,sans-serif;\n",
       "      width:680px;\n",
       "      padding: 10px 10px 10px 10px;\n",
       "      text-align:justify;\n",
       "      text-justify:inter-word;\n",
       "      }\n",
       "      blockquote p {\n",
       "        margin-bottom: 0;\n",
       "        line-height: 125%;\n",
       "        font-size: 100%;\n",
       "      }\n",
       "</style>\n",
       "<script>\n",
       "    MathJax.Hub.Config({\n",
       "                        TeX: {\n",
       "                           extensions: [\"AMSmath.js\"],\n",
       "                           equationNumbers: { autoNumber: \"AMS\", useLabelIds: true}\n",
       "                           },\n",
       "                tex2jax: {\n",
       "                    inlineMath: [ ['$','$'], [\"\\\\(\",\"\\\\)\"] ],\n",
       "                    displayMath: [ ['$$','$$'], [\"\\\\[\",\"\\\\]\"] ]\n",
       "                },\n",
       "                displayAlign: 'center', // Change this to 'center' to center equations.\n",
       "                \"HTML-CSS\": {\n",
       "                    scale:95,\n",
       "                        availableFonts: [],\n",
       "                        preferredFont:null,\n",
       "                        webFont: \"TeX\",\n",
       "                    styles: {'.MathJax_Display': {\"margin\": 4}}\n",
       "                }\n",
       "        });\n",
       "</script>\n"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "execution_count": 1,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "#format the book\n",
    "%matplotlib inline\n",
    "from __future__ import division, print_function\n",
    "from book_format import load_style\n",
    "load_style()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Introduction"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "** Author's note: I was initially planning to have a design nonlinear chapter that compares various approaches. This may or may not happen, but for now this chapter has no useful content and I suggest not reading it. **"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We see that the Kalman filter reasonably tracks the ball. However, as already explained, this is a silly example; we can predict trajectories in a vacuum with arbitrary precision; using a Kalman filter in this example is a needless complication."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Kalman Filter with Air Drag"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "I will dispense with the step 1, step 2, type approach and proceed in a more natural style that you would use in a non-toy engineering problem. We have already developed a Kalman filter that does excellently at tracking a ball in a vacuum, but that does not incorporate the effects of air drag into the model. We know that the process model is implemented with $\\textbf{F}$, so we will turn our attention to that immediately.\n",
    "\n",
    "Notionally, the computation that $\\textbf{F}$ computes is\n",
    "\n",
    "$$x' = Fx$$\n",
    "\n",
    "With no air drag, we had\n",
    "\n",
    "$$\n",
    "\\mathbf{F} = \\begin{bmatrix}\n",
    "1 & \\Delta t & 0 & 0 & 0 \\\\\n",
    "0 & 1 & 0 & 0 & 0 \\\\\n",
    "0 & 0 & 1 & \\Delta t & \\frac{1}{2}{\\Delta t}^2 \\\\\n",
    "0 & 0 & 0 & 1 & \\Delta t \\\\\n",
    "0 & 0 & 0 & 0 & 1\n",
    "\\end{bmatrix}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "which corresponds to the equations\n",
    "\n",
    "$$ \n",
    "\\begin{aligned}\n",
    "x &= x + v_x \\Delta t \\\\\n",
    "v_x &= v_x \\\\\n",
    "\\\\\n",
    "y &= y + v_y \\Delta t + \\frac{a_y}{2} {\\Delta t}^2 \\\\\n",
    "v_y &= v_y + a_y \\Delta t \\\\\n",
    "a_y &= a_y\n",
    "\\end{aligned}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "From the section above we know that our new Euler equations must be\n",
    "\n",
    "$$ \n",
    "\\begin{aligned}\n",
    "x &= x + v_x \\Delta t \\\\\n",
    "v_x &= v_x \\\\\n",
    "\\\\\n",
    "y &= y + v_y \\Delta t + \\frac{a_y}{2} {\\Delta t}^2 \\\\\n",
    "v_y &= v_y + a_y \\Delta t \\\\\n",
    "a_y &= a_y\n",
    "\\end{aligned}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Realistic 2D Position Sensors"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The position sensor in the last example are not very realistic. In general there is no 'raw' sensor that provides (x,y) coordinates. We have GPS, but GPS already uses a Kalman filter to create a filtered output; we should not be able to improve the signal by passing it through another Kalman filter unless we incorporate additional sensors to provide additional information. We will tackle that problem later. \n",
    "\n",
    "Consider the following set up. In an open field we put two transmitters at a known location, each transmitting a signal that we can detect. We process the signal and determine  how far we are from that signal, with some noise. First, let's look at a visual depiction of that."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\nIYQQwtH/ABc10jj5d5bTAAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x1d4f4a8ee10>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "import matplotlib.pyplot as plt\n",
    "\n",
    "circle1=plt.Circle((-4, 0), 5, color='#004080', \n",
    "                   fill=False, linewidth=20, alpha=.7)\n",
    "circle2=plt.Circle((4, 0), 5, color='#E24A33', \n",
    "                   fill=False, linewidth=5, alpha=.7)\n",
    "\n",
    "fig = plt.gcf()\n",
    "ax = fig.gca()\n",
    "\n",
    "plt.axis('equal')\n",
    "plt.xlim((-10, 10))\n",
    "plt.ylim((-10, 10))\n",
    "\n",
    "plt.plot ([-4, 0], [0, 3], c='#004080')\n",
    "plt.plot ([4, 0], [0, 3], c='#E24A33')\n",
    "plt.text(-4, -.5, \"A\", fontsize=16, horizontalalignment='center')\n",
    "plt.text(4, -.5, \"B\", fontsize=16, horizontalalignment='center')\n",
    "\n",
    "ax.add_artist(circle1)\n",
    "ax.add_artist(circle2)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here I have attempted to show transmitter A, drawn in red, at (-4,0) and a second one B, drawn in blue, at (4,0). The red and blue circles show the range from the transmitters to the robot, with the width illustrating the effect of the $1\\sigma$ angular error for each transmitter. Here I have given the blue transmitter more error than the red one. The most probable position for the robot is where the two circles intersect, which I have depicted with the red and blue lines. You will object that we have two intersections, not one, but we will see how we deal with that when we design the measurement function.\n",
    "\n",
    "This is a very common sensor set up. Aircraft still use this system to navigate, where it is called DME (Distance Measuring Equipment). Today GPS is a much more common navigation system, but I have worked on an aircraft where we integrated sensors like this into our filter along with the GPS, INS, altimeters, etc. We will tackle what is called *multi-sensor fusion* later; for now we will just address this simple configuration.\n",
    "\n",
    "The first step is to design our state variables. We will assume that the robot is traveling in a straight direction with constant velocity. This is unlikely to be true for a long period of time, but is acceptable for short periods of time. This does not differ from the previous problem - we will want to track the values for the robot's position and velocity. Hence,\n",
    "\n",
    "$$\\mathbf{x} = \n",
    "\\begin{bmatrix}x\\\\v_x\\\\y\\\\v_y\\end{bmatrix}$$\n",
    "\n",
    "The next step is to design the state transition function. This also will be the same as the previous problem, so without further ado,\n",
    "\n",
    "$$\n",
    "\\mathbf{x}' = \\begin{bmatrix}1& \\Delta t& 0& 0\\\\0& 1& 0& 0\\\\0& 0& 1& \\Delta t\\\\ 0& 0& 0& 1\\end{bmatrix}\\mathbf{x}$$\n",
    "\n",
    "The next step is to design the control inputs. We have none, so we set ${\\mathbf{B}}=0$.\n",
    "\n",
    "The next step is to design the measurement function $\\mathbf{z} = \\mathbf{Hx}$. We can model the measurement using the Pythagorean theorem.\n",
    "\n",
    "$$\n",
    "z_a = \\sqrt{(x-x_A)^2 + (y-y_A)^2} + v_a\\\\[1em]\n",
    "z_b = \\sqrt{(x-x_B])^2 + (y-y_B)^2} + v_b\n",
    "$$\n",
    "\n",
    "where $v_a$ and $v_b$ are white noise.\n",
    "\n",
    "We see an immediate problem. The Kalman filter is designed for linear equations, and this is obviously nonlinear. In the next chapters we will look at several ways to handle nonlinear problems in a robust way, but for now we will do something simpler. If we know the approximate position of the robot than we can linearize these equations around that point. I could develop the generalized mathematics for this technique now, but instead let me just present the worked example to give context to that development."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Instead of computing $\\mathbf{H}$ we will compute the partial derivative of $\\mathbf{H}$ with respect to the robot's position $\\mathbf{x}$. You are probably familiar with the concept of partial derivative, but if not, it just means how $\\mathbf{H}$ changes with respect to the robot's position. It is computed as the partial derivative of $\\mathbf{H}$ as follows:\n",
    "\n",
    "$$\\frac{\\partial \\mathbf{h}}{\\partial \\mathbf{x}} = \n",
    "\\begin{bmatrix}\n",
    "\\frac{\\partial h_1}{\\partial x_1} & \\frac{\\partial h_1}{\\partial x_2} &\\dots \\\\\n",
    "\\frac{\\partial h_2}{\\partial x_1} & \\frac{\\partial h_2}{\\partial x_2} &\\dots \\\\\n",
    "\\vdots & \\vdots\n",
    "\\end{bmatrix}\n",
    "$$\n",
    "\n",
    "Let's work the first partial derivative. We want to find\n",
    "\n",
    "$$\\frac{\\partial }{\\partial x} \\sqrt{(x-x_A)^2 + (y-y_A)^2}\n",
    "$$\n",
    "\n",
    "Which we compute as\n",
    "\n",
    "$$\n",
    "\\begin{aligned}\n",
    "\\frac{\\partial h_1}{\\partial x} &= ((x-x_A)^2 + (y-y_A)^2))^\\frac{1}{2} \\\\\n",
    "&= \\frac{1}{2}\\times 2(x-x_a)\\times ((x-x_A)^2 + (y-y_A)^2))^{-\\frac{1}{2}} \\\\\n",
    "&= \\frac{x_r - x_A}{\\sqrt{(x_r-x_A)^2 + (y_r-y_A)^2}} \n",
    "\\end{aligned}\n",
    "$$\n",
    "\n",
    "We continue this computation for the partial derivatives of the two distance equations with respect to $x$, $y$, $dx$ and $dy$, yielding\n",
    "\n",
    "$$\\frac{\\partial\\mathbf{h}}{\\partial\\mathbf{x}}=\n",
    "\\begin{bmatrix}\n",
    "\\frac{x_r - x_A}{\\sqrt{(x_r-x_A)^2 + (y_r-y_A)^2}} & 0 & \n",
    "\\frac{y_r - y_A}{\\sqrt{(x_r-x_A)^2 + (y_r-y_A)^2}} & 0 \\\\\n",
    "\\frac{x_r - x_B}{\\sqrt{(x_r-x_B)^2 + (y_r-y_B)^2}} & 0 &\n",
    "\\frac{y_r - y_B}{\\sqrt{(x_r-x_B)^2 + (y_r-y_B)^2}} & 0 \\\\\n",
    "\\end{bmatrix}\n",
    "$$\n",
    "\n",
    "That is pretty painful, and these are very simple equations. Computing the Jacobian can be extremely difficult or even impossible for more complicated systems. However, there is an easy way to get Python to do the work for you by using the SymPy module [1]. SymPy is a Python library for symbolic mathematics. The full scope of its abilities are beyond this book, but it can perform algebra, integrate and differentiate equations, find solutions to differential equations, and much more. We will use it to compute our Jacobian!\n",
    "\n",
    "First, a simple example. We will import SymPy, initialize its pretty print functionality (which will print equations using LaTeX). We will then declare a symbol for NumPy to use."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAAsAAAATBAMAAAC0B+rjAAAAMFBMVEX///8AAAAAAAAAAAAAAAAA\nAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAv3aB7AAAAD3RSTlMAIokQdkQymVRmzbur\n3e+SS/cOAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAYElEQVQIHWNgYGBgBGIgYEKhTCC8MAilAKLY\nAgsbgVQF4wQuAQbuCZwCTAcY5gK1sV9g2A6kuA4wvGSQZJBvYFjCMBEowhDLoMBdANRWuaUMpJ1x\nAohk4BQAU1DbOEEcAFCSDm4gARWbAAAAAElFTkSuQmCC\n",
      "text/plain": [
       "\\phi"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "import sympy\n",
    "from sympy import init_printing\n",
    "init_printing(use_latex='png')\n",
    "\n",
    "phi, x = sympy.symbols('\\phi, x')\n",
    "phi"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Notice how we use a latex expression for the symbol `phi`. This is not necessary, but if you do it will render as LaTeX when output. Now let's do some math. What is the derivative of $\\sqrt{\\phi}$?"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAACkAAAAwBAMAAAB+l06WAAAAMFBMVEX///8AAAAAAAAAAAAAAAAA\nAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAv3aB7AAAAD3RSTlMAVO8Qq5l2zWYiuzKJ\nRN0MreaOAAAACXBIWXMAAA7EAAAOxAGVKw4bAAABN0lEQVQ4EWNgwA8YlbHIm4R8xiLKwDZ8RVmd\nvntg8/LQEPuPBXygj9PnQ6xGs8wXyOcEi02NWg2T4ywAsnhAPGYHhvMXoMKsAjBRFgMGJgWoqB2I\nNgMRTA8YWH6DGEAQCCJugwj2z3BR5gcggQMgAgj4oGmUp4GBgftmpCRYkOH+AQgNMjaQs4F9Apj7\nBCLIkMHAwNXAMYHHAcRnDWBg4AU57gEDQx/QuaxAmoEhFYiTChgY2BIYGJYCRdkdgAKMAQwzOc3+\nAi0FcjQYZjDMFwAytjIwZDIw/2Jg6AFyyhg6geqBgfHmTMgDBob4CQyPgbx7DAe4gNYwsAMDDyg6\nP4DjAJDHHbEsGkjBAMtnPgMQm7MBJgKiuf+IgrkcE5BFGYqKwVxw6CIk5EGWMDBwIERALKjvIYIA\nUQJebishGGcAAAAASUVORK5CYII=\n",
      "text/plain": [
       " 1  \n",
       "────\n",
       "2⋅√φ"
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "sympy.diff('sqrt(phi)')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can factor equations."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAIsAAAAcBAMAAACjVFE3AAAAMFBMVEX///8AAAAAAAAAAAAAAAAA\nAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAv3aB7AAAAD3RSTlMAIma7zZnddlTvRIkQ\nMqvFy5UvAAAACXBIWXMAAA7EAAAOxAGVKw4bAAACkklEQVQ4EZ1UPYgTQRT+dpO9/GwiIaLY3R6i\nIDbnyWEbIXCVR/RELfSIgr/VNVdYGbHwp1EsRbjYXCeuotjJCgdiIym0uSbBH9DKKywshPO9N5Od\nnexe8Hwwb775vpdv3+zOBNhG+Atnt1G9ZelzfN1S+wdhXdecR7+WLi+kqUymOq3pa5jspivKgzSX\nxeSjmL1vYMzhBUMnoISMZjHFAsVpyQ7nywJH0kRExE4hQ8l22qG8nT9C+5T9ll2hVgVmjwoetSk+\nBioNkfRv2WafEMl0N6L9bACuPKCylNSAD4vcwmshSx2Z3gHlsNwTjNtqqnz7GRG6AEzUmBnKjCUK\nbPNeYD+S6Snw8c4thYc2wA0mFoDdUsMdWyE2+S5zB5QQAiubmwqP2FwHlllY37VHmtJFNImN12Li\nJKfqk+M3edahN6W7eRZhhgSvU9dvelimbNwGrw9zOuME+cSTbJt+D1eoZoaOyBsuNiHdFNtMzNPI\nBW7NH/BKhW1DZ/sRfaw2Qpwife0SxzGuFJvqBsOLNPbDh9fmFcXLZvNqs8nuelOTHbbJtchGsSJx\nStiwMks2+QELKlLd0KZKgRM4v4cVahabcpsXbPMQddAz47Bt6N7TK84vuTXqyAqxcRvMfaExR29v\nlhc6bBv6Uq/o7LV9q4ZLxcYLGdKpwCpC60G2DZ2sVSr6tHe5xz8w4f349ZnaFJaeheqJI+eMivj4\nLa7MB3KK5TLUkyUGqxNe6hLjBJRMxN0INaev5pQpSCJ1NWVrbi0p4G1yVeH7d4iGvIOkIrjSkKn6\ngKbUpRNJJXdAM/9tBTTSkdMdfCfJTcsxM9Ej6ASUMmO41bVM1ZAHDRyHiq1xKpzpsbIR7xmYgbwo\ng/w/6i9+jIWXI72KpwAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "        ⎛ 2    ⎞\n",
       "(φ - 1)⋅⎝φ  + 1⎠"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "sympy.factor('phi**3 -phi**2 + phi - 1')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "SymPy has a remarkable list of features, and as much as I enjoy exercising its features we cannot cover them all here. Instead, let's compute our Jacobian."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "⎡           x - xₐ                           y - yₐ              ⎤\n",
       "⎢ ──────────────────────────   0   ──────────────────────────   0⎥\n",
       "⎢    _______________________          _______________________    ⎥\n",
       "⎢   ╱         2           2          ╱         2           2     ⎥\n",
       "⎢ ╲╱  (x - xₐ)  + (y - yₐ)         ╲╱  (x - xₐ)  + (y - yₐ)      ⎥\n",
       "⎢                                                                ⎥\n",
       "⎢          x - x_b                          y - y_b              ⎥\n",
       "⎢────────────────────────────  0  ────────────────────────────  0⎥\n",
       "⎢   _________________________        _________________________   ⎥\n",
       "⎢  ╱          2            2        ╱          2            2    ⎥\n",
       "⎣╲╱  (x - x_b)  + (y - y_b)       ╲╱  (x - x_b)  + (y - y_b)     ⎦"
      ]
     },
     "execution_count": 6,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sympy import symbols, Matrix\n",
    "phi = symbols('\\phi')\n",
    "phi\n",
    "\n",
    "x, y, xa, xb, ya, yb, dx, dy = symbols('x y x_a x_b y_a y_b dx dy')\n",
    "\n",
    "H = Matrix([[sympy.sqrt((x-xa)**2 + (y-ya)**2)], \n",
    "            [sympy.sqrt((x-xb)**2 + (y-yb)**2)]])\n",
    "\n",
    "state = Matrix([x, dx, y, dy])\n",
    "H.jacobian(state)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In a nutshell, the entry (0,0) contains the difference between the x coordinate of the robot and transmitter A's x coordinate divided by the distance between the robot and A. (2,0) contains the same, except for the y coordinates of the robot and transmitters. The bottom row contains the same computations, except for transmitter B. The 0 entries account for the velocity components of the state variables; naturally the range does not provide us with velocity.\n",
    "\n",
    "The values in this matrix change as the robot's position changes, so this is no longer a constant; we will have to recompute it for every time step of the filter.\n",
    "\n",
    "If you look at this you may realize that this is just a computation of x/dist and y/dist, so we can switch this to a trigonometic form with no loss of generality:\n",
    "\n",
    "$$\\frac{\\partial\\mathbf{h}}{\\partial\\mathbf{x}}=\n",
    "\\begin{bmatrix}\n",
    "-\\cos{\\theta_A} & 0 & -\\sin{\\theta_A} & 0 \\\\\n",
    "-\\cos{\\theta_B} & 0 & -\\sin{\\theta_B} & 0\n",
    "\\end{bmatrix}\n",
    "$$\n",
    "\n",
    "However, this raises a huge problem. We are no longer computing $\\mathbf{H}$, but $\\Delta\\mathbf{H}$, the change of $\\mathbf{H}$. If we passed this into our Kalman filter without altering the rest of the design the output would be nonsense. Recall, for example, that we multiply $\\mathbf{Hx}$ to generate the measurements that would result from the given estimate of $\\mathbf{x}$ But now that $\\mathbf{H}$ is linearized around our position it contains the *change* in the measurement function. \n",
    "\n",
    "We are forced, therefore, to use the *change* in $\\mathbf{x}$ for our state variables. So we have to go back and redesign our state variables. \n",
    "\n",
    ">Please note this is a completely normal occurrence in designing Kalman filters. The textbooks present examples like this as *fait accompli*, as if it is trivially obvious that the state variables needed to be velocities, not positions. Perhaps once you do enough of these problems it would be trivially obvious, but at that point why are you reading a textbook? I find myself reading through a presentation multiple times, trying to figure out why they made a choice, finally to realize that it is because of the consequences of something on the next page. My presentation is longer, but it reflects what actually happens when you design a filter. You make what seem reasonable design choices, and as you move forward you discover properties that require you to recast your earlier steps. As a result, I am going to somewhat abandon my **step 1**, **step 2**, etc.,  approach, since so many real problems are not quite that straightforward."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If our state variables contain the velocities of the robot and not the position then how do we track where the robot is? We can't. Kalman filters that are linearized in this fashion use what is called a *nominal trajectory* - i.e. you assume a position and track direction, and then apply the changes in velocity and acceleration to compute the changes in that trajectory. How could it be otherwise? Recall the graphic showing the intersection of the two range circles - there are two areas of intersection. Think of what this would look like if the two transmitters were very close to each other - the intersections would be two very long crescent shapes. This Kalman filter, as designed, has no way of knowing your true position from only distance measurements to the transmitters. Perhaps your mind is already leaping to ways of working around this problem. If so, stay engaged, as later sections and chapters will provide you with these techniques. Presenting the full solution all at once leads to more confusion than insight, in my opinion. \n",
    "\n",
    "So let's redesign our *state transition function*. We are assuming constant velocity and no acceleration, giving state equations of\n",
    "$$\n",
    "\\dot{x}' = \\dot{x} \\\\\n",
    "\\ddot{x}' = 0 \\\\\n",
    "\\dot{y}' = \\dot{y} \\\\\n",
    "\\dot{y}' = 0$$\n",
    "\n",
    "This gives us the the *state transition function* of\n",
    "\n",
    "$$\n",
    "\\mathbf{F} = \\begin{bmatrix}0 &1 & 0& 0\\\\0& 0& 0& 0\\\\0& 0& 0& 1\\\\ 0& 0& 0& 0\\end{bmatrix}$$\n",
    "\n",
    "A final complication comes from the measurements that we pass in. $\\mathbf{Hx}$ is now computing the *change* in the measurement from our nominal position, so the measurement that we pass in needs to be not the range to A and B, but the *change* in range from our measured range to our nominal position. \n",
    "\n",
    "There is a lot here to take in, so let's work through the code bit by bit. First we will define a function to compute $\\frac{\\partial\\mathbf{h}}{\\partial\\mathbf{x}}$ for each time step."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "from math import sin, cos, atan2\n",
    "\n",
    "def H_of(pos, pos_A, pos_B):\n",
    "    \"\"\" Given the position of our object at 'pos' in 2D, and two \n",
    "    transmitters A and B at positions 'pos_A' and 'pos_B', return \n",
    "    the partial derivative of H\n",
    "    \"\"\"\n",
    "\n",
    "    theta_a = atan2(pos_a[1] - pos[1], pos_a[0] - pos[0])\n",
    "    theta_b = atan2(pos_b[1] - pos[1], pos_b[0] - pos[0])\n",
    "\n",
    "    return np.array([[0, -cos(theta_a), 0, -sin(theta_a)],\n",
    "                     [0, -cos(theta_b), 0, -sin(theta_b)]])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now we need to create our simulated sensor. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "from numpy.random import randn\n",
    "\n",
    "class DMESensor(object):\n",
    "    def __init__(self, pos_a, pos_b, noise_factor=1.0):\n",
    "        self.A = pos_a\n",
    "        self.B = pos_b\n",
    "        self.noise_factor = noise_factor\n",
    "        \n",
    "    def range_of(self, pos):\n",
    "        \"\"\" returns tuple containing noisy range data to A and B\n",
    "        given a position 'pos'\n",
    "        \"\"\"\n",
    "        \n",
    "        ra = math.sqrt((self.A[0] - pos[0])**2 + (self.A[1] - pos[1])**2)\n",
    "        rb = math.sqrt((self.B[0] - pos[0])**2 + (self.B[1] - pos[1])**2)\n",
    "        \n",
    "        return (ra + randn()*self.noise_factor, \n",
    "                rb + randn()*self.noise_factor)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Finally, we are ready for the Kalman filter code. I will position the transmitters at x=-100 and 100, both with y=-20. This gives me enough space to get good triangulation from both as the robot moves. I will start the robot at (0,0) and move by (1,1) each time step. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\nBak0JIOboQAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x1d4f31578d0>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "import code.book_plots as bp\n",
    "from filterpy.kalman import KalmanFilter\n",
    "import math\n",
    "import numpy as np\n",
    "\n",
    "pos_a = (100, -20)\n",
    "pos_b = (-100, -20)\n",
    "\n",
    "f1 = KalmanFilter(dim_x=4, dim_z=2)\n",
    "\n",
    "f1.F = np.array ([[0, 1, 0, 0],\n",
    "                  [0, 0, 0, 0],\n",
    "                  [0, 0, 0, 1],\n",
    "                  [0, 0, 0, 0]], dtype=float)\n",
    "\n",
    "f1.R *= 1.\n",
    "f1.Q *= .1\n",
    "\n",
    "f1.x = np.array([[1, 0, 1, 0]], dtype=float).T\n",
    "f1.P = np.eye(4) * 5.\n",
    "\n",
    "# initialize storage and other variables for the run\n",
    "count = 30\n",
    "xs, ys = [], []\n",
    "pxs, pys = [], []\n",
    "\n",
    "# create the simulated sensor\n",
    "d = DMESensor(pos_a, pos_b, noise_factor=3.)\n",
    "\n",
    "# pos will contain our nominal position since the filter does not\n",
    "# maintain position.\n",
    "pos = [0, 0]\n",
    "\n",
    "for i in range(count):\n",
    "    # move (1,1) each step, so just use i\n",
    "    pos = [i, i]\n",
    "    \n",
    "    # compute the difference in range between the nominal track\n",
    "    # and measured ranges\n",
    "    ra,rb = d.range_of(pos)\n",
    "    rx,ry = d.range_of((pos[0] + f1.x[0, 0], pos[1] + f1.x[2, 0]))\n",
    "    z = np.array([[ra - rx], [rb - ry]])\n",
    "\n",
    "    # compute linearized H for this time step\n",
    "    f1.H = H_of (pos, pos_a, pos_b)\n",
    "\n",
    "    # store stuff so we can plot it later\n",
    "    xs.append(f1.x[0, 0]+i)\n",
    "    ys.append(f1.x[2, 0]+i)\n",
    "    pxs.append(pos[0])\n",
    "    pys.append(pos[1])\n",
    "    \n",
    "    # perform the Kalman filter steps\n",
    "    f1.predict()\n",
    "    f1.update(z)\n",
    "\n",
    "bp.plot_filter(xs, ys)\n",
    "bp.plot_track(pxs, pys)\n",
    "plt.legend(loc=2)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Linearizing the Kalman Filter"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now that we have seen an example of linearizing the Kalman filter we are in a position to better understand the math. \n",
    "\n",
    "We start by assuming some function $\\mathbf f$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Example: A falling Ball"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**author's note: ignore this section for now. **\n",
    "\n",
    "In the **Designing Kalman Filters** chapter I first considered tracking a ball in a vacuum, and then in the atmosphere. The Kalman filter performed very well for vacuum, but diverged from the ball's path in the atmosphere. Let us look at the output; to avoid littering this chapter with code from that chapter I have placed it all in the file `ekf_internal.py'."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\nkiTRs2fPfG3WKsuO/y3kNCcsayAya9YspkyZwqBBg5g5cyY+Pj6oVCpmzZrlsFcsP2U+SWazmZCQ\nED799FOHdShbtqzN1zkFOqVKlco1yKxZsyYtW1rOl+3YsSNpaWkMHjyYxo0b2wTCOp0uz0n6mTLj\nhpIlS+Ls7Mz169ft8mSmZW9Hfmi1Wnx8fGyC/kyZbS1VqlSBy33cChyg1ahRg9jYWO7fv090dDT9\n+/cnJrfNKfMpr9Uvz6Pi2OZMou1PD+eLF6k4bx6eR444vK4vW5bzQwaysMJlZMNFVAkZZH7WNEsS\nJq0LnYJ6cfTeSS7rLqP665NuVjIyzTyboUnWcDn1MhnmDJxkJyqWsEyij/8t3iZ/CCHUcK+BwWxA\nI2uQM2S7PM+SvP7OAwICHqpn4FlTp04dfvzxR1q3bk14eDj79++ndOnSgKX3bNeuXcyYMYPJkydb\n79Hr9U+kVyo6OpqwsDBWrlxpkz516tTH/uyCyKmnJzAwkF9//TXfqy9zEhwcbNeDmJvZs2cTHR3N\nzJkzWbJkiTV93rx5BZ6DJkkSL7zwgsOflyNHjlCxYsWHmsj/4MED7ty547B38cKFC0iSlOdGuykp\nKcTFxeV4vVq1agWuV14KHKCp1Wprd2/dunU5evQoCxYsYNKkSSiKws2bNylfvrw1/82bN60/gIIg\nPD3k1FTKrFyJf1QUsoPd+jM8Pflz8CAONanM0Wv70egsc9EUwKRxxqTVYtZoMClmjt47ScsyLfnq\n3FfWrSUymcwmZEmmbbm2uKhdMCvmvwOvXHq/ZElGq8p51Z7wbAoNDWXjxo107tyZ1q1bExMTg7e3\nt7VHKntP2ccff/xEjjpSqVR2PU+HDh3i8OHDBAQEPPbn55erq6vDgLVnz5789NNPLF26lLfeesvm\nmsFgwGAwOFzFmF1oaCjvv/8+er0+Xys5AwIC6N69O6tWrWLatGnW3rCHmYMGlrl9EydO5NixY9at\nNn7//Xd2795tt4Aks2czMybR6/VkZGTYtTNzIUi7du3snnfixAlq1Kjx1K3ghELYqNZsNqPX66lc\nuTKlS5dmx44d1smC6enp7N+/n/nz5+dZTm6rRp43mZ8OilObM4m2PwVtVxTLWZn//jdcvWp32aSS\nie/dipuD+7Dnf3tJvrIbANnZGWcfH5y9vJGdbOeRZZgzCG0USr169eyGJ53uO9GyTEua/qPgv6yf\n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\nkiX07t0bPz8/Dh48yCuvvIK3tze//fYbGo3GXlMJIYQQQrgsuxZop0+fZujQoRw8eJDs7GxCQ0Pp\n06cPU6dOxdfX117TCCGEEEK4NLsWaEIIIYQQ4vY5pBfn5cuXGTNmDFFRUXh5edGoUSNGjx7NpUuX\nVNtlZmbyzDPP4Ovri6+vL8OGDXOJGwvmz59PkyZN8PT0JDo6mu3btzs6JLuaNWsWHTt2xMfHh4CA\nAB599FEOHjxYaru33nqLhg0b4uXlRY8ePTh06JADoq06s2bNQqvVMmbMGNW4K+dtNBoZPnw4AQEB\neHp60rJlS7Zt26baxtXyN5vNTJkyxfrfdJMmTZgyZQpms1m1nSvkvW3bNvr160dISAharZbFixeX\n2qa8PAsKCnjppZfw9/enVq1a9OvXjzNnztypFCrtVrkXFRXx6quv0qZNG2rVqkWDBg0YMmQIp06d\nUu2jOuZekde82KhRo9BqtfzjH/9QjVfHvKFiuaekpNC/f3/q1q2Lt7c30dHRHDlyxPr87eTukALt\n7NmznD17lg8++IADBw6wZMkStm7dWqpn56BBg0hMTGTDhg38+uuv7N27l2HDhjkiZLtZvnw548aN\n48033yQxMZFOnToRExPD6dOnHR2a3WzdupUXX3yRnTt3Ehsbi16v58EHHyQzM9O6zezZs/noo4+Y\nN28eCQkJBAQE0KtXL3JychwYuf3s2rWLL774gjZt2qjGXTnvrKwsOnfujEajYd26dRw+fJhPP/2U\ngIAA6zaumP97773HggUL+Oyzzzhy5Ahz585l/vz5zJo1y7qNq+SdnZ1Nq1atmDt3Ll5eXqWer0ie\nY8eO5YcffmD58uVs376dK1eu0KdPH5z9ZM6tcs/NzSUxMZEpU6bw+++/85///IdTp04RExOjKtSr\nY+7lvebFvv/+e3bv3k3Dhg1LPVcd84byc09NTaVLly40bdqUuLg4Dh48yIwZM6hVq5Z1m9vKXXES\na9euVXQ6nXL16lVFURQlOTlZ0Wg0ys6dO63bbN++XdFoNEpKSoqjwrxt99xzjzJq1CjVWEREhPL6\n6687KKKql52dreh0OuWXX36xjgUHByuzZs2yPr527ZpSu3ZtZeHChY4I0a4yMzOVpk2bKnFxcUr3\n7t2Vl156yfqcK+c9efJkpUuXLrfcxhXz79OnjzJ8+HDV2LPPPqv07dvX+tgV865Vq5ayaNEi1Vh5\neWZlZSkGg0FZtmyZdZtTp04pWq1W2bBhw50J3A7Kyv1Ghw4dUjQajXLgwAFFUVwj95vlnZqaqoSE\nhCiHDx9WGjdurHz44YfW51whb0UpO/fBgwcrQ4cOvenv3G7uDjmCVpasrCzc3d2tVerOnTupXbs2\n9957r3Wbzp074+3tTXx8vKPCvC2FhYXs2bOHXr16qcYfeuihaptTRVy5cgWz2UzdunUBOHHiBEaj\nUfV38PDwoGvXri7xdxg5ciQDBgygW7duqnFXz/unn37innvuYeDAgQQGBtKuXTvmzZtnfd5V8+/S\npQuxsbHW0xqHDh1i8+bNPPLII4Dr5n2jiuSZkJBAUVGRapuQkBCioqJc6m8Bls80jUZjfd/bs2eP\nS+ZuMpkYPHgwU6ZMoVmzZqWed9W8FUXh559/pnnz5sTExBAQEEDHjh1ZsWKFdZvbzd0pCrTMzEym\nTp3KyJEj0WotIRmNxjIbrgcEBGA0Gu90iHaRkZGByWQiMDBQNR4YGFhtc6qIsWPH0r59e+677z7A\n8tpqNBqX/Dt88cUXHD9+nBkzZpR6zpXzBssyO/Pnz6dp06Zs2LCBcePG8dprrzF//nzAdfN/9dVX\nGTp0KM2bN8dgMNCqVSuGDx/OqFGjANfN+0YVyTM9PR2dTkf9+vVvuo0rKCws5OWXX+bRRx+lQYMG\ngOXv44q5T506lYCAAEaOHFnm866a9/nz58nOzubdd9/l4YcfZtOmTQwaNIghQ4awbt064PZzt2sv\nzsq0hMrJyaFv376EhoYye/Zse4YjnMCECROIj49nx44dLr8OXkpKCm+88QY7duywftGoScxmMx07\ndrS+B7Rp04aUlBTmzZvH6NGjHRxd1fnuu+/45ptv+O6772jevDmJiYmMGTOG8PBwRowY4ejwxB1m\nMpkYMmQIV65c4ZdffnF0OFUqLi6ORYsWkZSU5OhQ7rjiawsfe+wxxo4dC0Dr1q1JSEjgs88+IyYm\n5rbnsOunyPjx4zl8+PBNf5KTk+nYsaN1+5ycHGJiYtDpdPz8888YDAbrc0FBQVy4cKHUHOfPnyco\nKMieYd8xfn5+6HQ60tPTVePp6enVNqdbGT9+PMuXLyc2NpawsDDreFBQEIqiuNzfYefOnVy8eJHm\nzZvj5uaGm5sbW7ZsYd68eRgMBurXr++SeRcLDg4mKipKNRYVFUVaWhrguq/7pEmTmDhxIk899RQt\nWrRgyJAhTJgwwXqTgKvmfaOK5BkUFITJZOLixYs33aY6M5lMDBw4kAMHDrB582br6U1wzdy3bNmC\n0WgkKCjI+p538uRJJk2aRKNGjQDXzBssn+d6vb7c97zbyd2uBVq9evWIjIy85U9xv87s7Gwefvhh\nANauXVvqDon77ruP7Oxsdu3aZR2Lj48nNzeXTp062TPsO8bNzY0OHTqwceNG1fjGjRvp3Lmzg6Kq\nGmPHjrUWZxEREarnwsPDCQoKUv0d8vLy2LZtW7X+Ozz++OPs37+fpKQk6090dDSDBg0iKSmJyMhI\nl8y7WOfOnVW3lwMcOXLEWpy76uuem5tb6oipVqu1fsN21bxvVJE8O3TogF6vV21z+vRpkpOTq/3f\noqioiAEDBnDgwAHi4uJKXaLjirm/8MIL7Nu3T/We16BBAyZMmMB///tfwDXzBsvn+V/+8pdS73kp\nKSnW97zbzr0ydzPcrqtXryr33nuv0rJlS+XYsWOK0Wi0/hQUFFi3i4mJUVq3bq3s3LlTiY+PV1q1\naqX069fPESHbzfLlyxV3d3flyy+/VJKTk5UxY8YotWvXVtLS0hwdmt2MHj1aqVOnjhIbG6t6bbOz\ns63bzJ49W/H19VVWr16t7N+/X3n66aeVhg0bqrZxBTfexenKee/evVsxGAzKzJkzlWPHjikrVqxQ\nfHx8lAULFli3ccX8hw8froSGhipr1qxRUlNTldWrVyv+/v7KxIkTrdu4St7Z2dlKYmKi8vvvvyte\nXl7K9OnTlcTEROv7V0Xy/Pvf/66EhoYqmzZtUvbu3av06NFDad++vWI2mx2VVoXcKveioiKlX79+\nSkhIiPL777+r3veuXbtm3Ud1zL281/xGN97FqSjVM29FKT/3H3/8UXF3d1cWLlyoHDt2TFm4cKFi\nMBiUdevWWfdxO7k7pECLi4tTtFqt6kej0SharVbZsmWLdbvMzEzlmWeeUXx8fBQfHx9l2LBhSlZW\nliNCtqsFCxYo4eHhioeHhxIdHa1s377d0SHZVfFreePP22+/rdru7bffVho0aKB4enoq3bt3Vw4e\nPOigiKtOjx49VAWaorh23mvXrlXatGmjeHp6Ks2aNVM+++yzUtu4Wv7Z2dnK+PHjlcaNGyteXl5K\n06ZNlTfffFPJz89XbecKecfFxZX53/eIESOs25SXZ0FBgTJmzBjFz89P8fb2Vvr166ecPn36Tqdi\ns1vlnpqaetP3vZJLM1TH3CvympcUHh5eqkCrjnkrSsVyX7RokRIZGal4eXkpbdq0UZYvX67ax+3k\nLq2ehBBCCCGcTM271UwIIYQQwslJgSaEEEII4WSkQBNCCCGEcDJSoAkhhBBCOBkp0IQQQgghnIwU\naEIIIYQQTkYKNCGEEEIIJyMFmhBCCCGEk5ECTQghhBDCyfw/LlmqQgBqJR8AAAAASUVORK5CYII=\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x1d4f3151780>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "import code.ekf_internal as ekf\n",
    "ekf.plot_ball()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can artificially force the Kalman filter to track the ball by making $Q$ large. That would cause the filter to mistrust its prediction, and scale the kalman gain $K$ to strongly favor the measurments. However, this is not a valid approach. If the Kalman filter is correctly predicting the process we should not 'lie' to the filter by telling it there are process errors that do not exist. We may get away with that for some problems, in some conditions, but in general the Kalman filter's performance will be substandard.\n",
    "\n",
    "Recall from the **Designing Kalman Filters** chapter that the acceleration is\n",
    "\n",
    "$$a_x = (0.0039 + \\frac{0.0058}{1+\\exp{[(v-35)/5]}})*v*v_x \\\\\n",
    "a_y = (0.0039 + \\frac{0.0058}{1+\\exp{[(v-35)/5]}})*v*v_y- g\n",
    "$$\n",
    "\n",
    "These equations will be *very* unpleasant to work with while we develop this subject, so for now I will retreat to a simpler one dimensional problem using this simplified equation for acceleration that does not take the nonlinearity of the drag coefficient into account:\n",
    "\n",
    "\n",
    "$$\\begin{aligned}\n",
    "\\ddot{y} &= \\frac{0.0034ge^{-y/20000}\\dot{y}^2}{2\\beta} - g \\\\\n",
    "\\ddot{x} &= \\frac{0.0034ge^{-x/20000}\\dot{x}^2}{2\\beta}\n",
    "\\end{aligned}$$\n",
    "\n",
    "Here $\\beta$ is the ballistic coefficient, where a high number indicates a low drag."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This is still nonlinear, so we need to linearize this equation at the current state point. If our state is position and velocity, we need an equation for some arbitrarily small change in $\\mathbf{x}$, like so:\n",
    "\n",
    "$$ \\begin{bmatrix}\\Delta \\dot{x} \\\\ \\Delta \\ddot{x} \\\\ \\Delta \\dot{y} \\\\ \\Delta \\ddot{y}\\end{bmatrix} = \n",
    "\\large\\begin{bmatrix}\n",
    "\\frac{\\partial \\dot{x}}{\\partial x} & \n",
    "\\frac{\\partial \\dot{x}}{\\partial \\dot{x}} & \n",
    "\\frac{\\partial \\dot{x}}{\\partial y} & \n",
    "\\frac{\\partial \\dot{x}}{\\partial \\dot{y}} \\\\ \n",
    "\\frac{\\partial \\ddot{x}}{\\partial x} & \n",
    "\\frac{\\partial \\ddot{x}}{\\partial \\dot{x}}& \n",
    "\\frac{\\partial \\ddot{x}}{\\partial y}& \n",
    "\\frac{\\partial \\dot{x}}{\\partial \\dot{y}}\\\\\n",
    "\\frac{\\partial \\dot{y}}{\\partial x} & \n",
    "\\frac{\\partial \\dot{y}}{\\partial \\dot{x}} & \n",
    "\\frac{\\partial \\dot{y}}{\\partial y} & \n",
    "\\frac{\\partial \\dot{y}}{\\partial \\dot{y}} \\\\ \n",
    "\\frac{\\partial \\ddot{y}}{\\partial x} & \n",
    "\\frac{\\partial \\ddot{y}}{\\partial \\dot{x}}& \n",
    "\\frac{\\partial \\ddot{y}}{\\partial y}& \n",
    "\\frac{\\partial \\dot{y}}{\\partial \\dot{y}}\n",
    "\\end{bmatrix}\\normalsize\n",
    "\\begin{bmatrix}\\Delta x \\\\ \\Delta \\dot{x} \\\\ \\Delta \\dot{y} \\\\ \\Delta \\ddot{y}\\end{bmatrix}$$\n",
    "\n",
    "The equations do not contain both an x and a y, so any partial derivative with both in it must be equal to zero. We also know that $\\large\\frac{\\partial \\dot{x}}{\\partial x}\\normalsize = 0$ and that  $\\large\\frac{\\partial \\dot{x}}{\\partial \\dot{x}}\\normalsize = 1$, so our matrix ends up being\n",
    "\n",
    "$$\\mathbf{F} = \\begin{bmatrix}0&1&0&0 \\\\\n",
    "\\frac{0.0034e^{-x/22000}\\dot{x}^2g}{44000\\beta}&0&0&0\n",
    "\\end{bmatrix}$$\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\\begin{aligned}\\ddot{x} &= -\\frac{1}{2}C_d\\rho A \\dot{x}\\\\\n",
    "\\ddot{y} &= -\\frac{1}{2}C_d\\rho A \\dot{y}-g\\end{aligned}$$"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "from sympy.abc import *\n",
    "from sympy import *\n",
    "\n",
    "init_printing(pretty_print=True, use_latex='mathjax')\n",
    "\n",
    "x1 = (0.0034*g*exp(-x/22000)*((x)**2))/(2*b) - g\n",
    "\n",
    "x2 = (a*g*exp(-x/c)*(Derivative(x)**2))/(2*b) - g\n",
    "\n",
    "#pprint(x1)\n",
    "#pprint(Derivative(x)*Derivative(x,n=2))\n",
    "#pprint(diff(x2, x))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "** orphan text\n",
    "This approach has many issues. First, of course, is the fact that the linearization does not produce an exact answer. More importantly, we are not linearizing the actual path, but our filter's estimation of the path. We linearize the estimation because it is statistically likely to be correct; but of course it is not required to be. So if the filter's output is bad that will cause us to linearize an incorrect estimate, which will almost certainly lead to an even worse estimate. In these cases the filter will quickly diverge. This is where the 'black art' of Kalman filter comes in. We are trying to linearize an estimate, and there is no guarantee that the filter will be stable. A vast amount of the literature on Kalman filters is devoted to this problem. Another issue is that we need to linearize the system using analytic methods. It may be difficult or impossible to find an analytic solution to some problems. In other cases we may be able to find the linearization, but the computation is very expensive. **\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## References"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "[1] http://sympy.org\n"
   ]
  }
 ],
 "metadata": {
  "anaconda-cloud": {},
  "kernelspec": {
   "display_name": "Python [default]",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.5.1"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 0
}