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=Vollkorn');\n",
       "@import url('http://fonts.googleapis.com/css?family=Arimo');\n",
       "\n",
       "    div.cell{\n",
       "        width: 900px;\n",
       "        margin-left: 0% !important;\n",
       "        margin-right: auto;\n",
       "    }\n",
       "    div.text_cell code {\n",
       "        background: transparent;\n",
       "        color: #000000;\n",
       "        font-weight: 600;\n",
       "        font-size: 11pt;\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",
       "\t\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",
       "    } \n",
       "    h2 {\n",
       "        font-family: 'Open sans',verdana,arial,sans-serif;\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: inline;\n",
       "        white-space: wrap;\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: nowrap;\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",
       "    .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.text_cell_render{\n",
       "        font-family: 'Arimo',verdana,arial,sans-serif;\n",
       "        line-height: 125%;\n",
       "        font-size: 120%;\n",
       "        text-align:justify;\n",
       "        text-justify:inter-word;\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: 70%;\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",
       "       font-weight: bold;\n",
       "       color:#447adb;\n",
       "    }\n",
       "    a:visited{\n",
       "       font-weight: bold;\n",
       "       color: #1d3b84;\n",
       "    }\n",
       "    a:hover{\n",
       "       font-weight: bold;\n",
       "       color: #1d3b84;\n",
       "    }\n",
       "    a:focus{\n",
       "       font-weight: bold;\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",
       "                           },\n",
       "                tex2jax: {\n",
       "                    inlineMath: [ ['$','$'], [\"\\\\(\",\"\\\\)\"] ],\n",
       "                    displayMath: [ ['$$','$$'], [\"\\\\[\",\"\\\\]\"] ]\n",
       "                },\n",
       "                displayAlign: 'center', // Change this to 'center' to center equations.\n",
       "                \"HTML-CSS\": {\n",
       "                    scale:100,\n",
       "                    availableFonts: [\"Neo-Euler\"],\n",
       "                    preferredFont: \"Neo-Euler\",\n",
       "                    webFont: \"Neo-Euler\",\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",
    "import book_format\n",
    "book_format.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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\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x6ee6160>"
      ]
     },
     "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": "iVBORw0KGgoAAAANSUhEUgAAAAsAAAASBAMAAAB/WzlGAAAAMFBMVEX///8AAAAAAAAAAAAAAAAA\nAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAv3aB7AAAAD3RSTlMAdolEMpnNqyK7EO/d\nVGbrAyG9AAAAX0lEQVQIHWNgYGBgBGIgYEKhjCE8ARDFEppeAaQqFyh0NzBwFjAbsBYwyC9gYmA6\nwHAUqI1zAsNHhoUM6y8wJDJcYShlYLBhUGAPAGqLm6sC0s7xAEQy8DWAKag1YEsBkk8P0x6j9zMA\nAAAASUVORK5CYII=\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\nAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAv3aB7AAAAD3RSTlMAzRAiu5mrdu/dZjKJ\nRFRer8KoAAABNklEQVQ4EWNggAMhOAuJYfIJiQNjqoRhE2VgH76irBk/s2C+H3r0fyzgA328YQ+x\nGs2yXDjfNMQbxmYWALLYQTymBIbzF6DCrA+ADB4Qh02BgaMBxAACTRABFuWYwMD2G8QDgjgQcRdE\nMH6CizJNAAkUgAgg4ISmUZ4FDAzcoWLJYEGG+wcgNMjYFIUDFgZg7hSIIEMVAwNLAu8F1gQQn9WB\ngYEX5DigsfUKPAw8QJqBoQyIKwSAzi9gYJgKdBiLA1CAL4DBmFn9L9BSIOc7gzqD/gMgYysDQzED\n0xcGhjVAjjjDa4ZUIM0850wY0KB4A4ZJQN5NhgNsAUCaERh4QFH7AK4DQB53lN9pIAUDbJ84FUBs\n5gUgEga4/zwFM7kMYCJgWkIITIFDDCHxHmQJNMwRoozIWgFe5Vu10Z1KpwAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "   1   \n",
       "───────\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\nAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAv3aB7AAAAD3RSTlMAMmYiu80QdonvRN2Z\nVKvu110NAAACmklEQVQ4EZVUPYgTURCezSabzWaTS2MjB4looWAR5JqrLqhY+ROLeI0cC3qIlVtq\ndauHWHiIYHfNLZZn4aGFiKcscqeNhAiCNodBz0Lw5yotRM6Zebv73mY3wQxk5ptvZr837+3bAIxh\n5sarMbqHti7Cl6G1/yjsDXseQ72Zbi+mqUxGa4X0Msz46Q6rn+aymIITsx8ljDm4QVBroMu0fSH7\nWlafSChR2UE8xbkrWYHOAVRrDPVfHOgIzICh4mjSIrHYj+axl26Knm1zHj5rYnJYNgikn3EA9B2U\n8pgQniG5i12Sucp5qccBZSzPEgPCBabAOPnTQfQIoNQkxvLJK1YkmctM1B0OqwB7tt4JDO+ZQrdA\nxAbAAyZS755lCjzHIe4AF2Bld1fgAZlrAEtUmNz8wUOFTRhYRpzKJrHam7nPsjog89CBo1isnjD1\ne0oTQpbJtYk8Tm7b8aaVlZKbqtfgOfachlXoUrM0lqmsETGHv3zf8u0+ZcKSMni3l3llD25jff4Z\n2VnqZBlth+A6/hYcE0wWJQYGNjXTI5lygNeGRxc95BUZmmYdTMi3qIB2s9N52umcZ8xvCqfBTU24\nhmv8ZTZ2LGPFm/oNl+BKL64OTIPfPR5xwa3UqoHsIcQy4oi3MZ2Ft/BN6UieDb6pO3j31sxETyxj\nBwTxVuDt8hILJWXwZtH1mzzwoUYPSLO//vmEY/rE4FqgvTx1nXBkkUx35UWDb3G5iaUjUTkZpzkt\n+Rj0BuPIRTIinwXIBQj3R+VkvMWp7WHI0WrS7ksIYND3dwx/nsrG2Ggz1O5iwO97qOX6WKK/LTez\nJR9O8B2rqW9XeaJcw2Rg10o52uq8wmXBg1lkmqsEaU5h9JaSjIJbo4pgOyPL4xT/AbQYkt2B1tcR\nAAAAAElFTkSuQmCC\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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\nc844NmVfmwAAAABJRU5ErkJggg==\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. \n",
    "\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\nrkJggg==\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x81e45f8>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "import math\n",
    "from filterpy.kalman import KalmanFilter\n",
    "import numpy as np\n",
    "import book_plots as bp\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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\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x81ac748>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "import ekf_internal\n",
    "ekf_internal.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": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.4.1"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 0
}