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",
       "        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",
       "    .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: [],\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",
    "%load_ext autoreload\n",
    "%autoreload 2  \n",
    "from __future__ import division, print_function\n",
    "import sys\n",
    "sys.path.insert(0,'./code')\n",
    "from book_format import load_style, set_figsize, figsize\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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\nSUVORK5CYII=\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x6b75fd0>"
      ]
     },
     "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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\nvZLgzUlwNL8ny2b87FzQFhERERHxDp8I26WlpWRnZ7u2U1NT+etf/0p1dTUA3bt3Z/fmOWxZZDH8\nLovgIIVsEREREfE+t4XtnJwc4uPjCQ4OplevXhQUFNT7WsYY8vPznculA61ateJPf/oThw4dAiAi\nIoJ9+/Zhs9lcrwlvqYAtIiIiIk2LW8L2ypUreeaZZ3jhhRcoLCwkPT2dgQMHusLx9aitraWmpsa1\n/Zvf/IYtW7YAEBQUxNKlSwkJCXEdb9WqlTtKFxERERHxGLeE7RkzZpCZmckTTzxBYmIis2bNIioq\nirlz5173NR5//HHWrFkDOBeXycrK4uTJk67jAwcOpE2bNu4oV0RERESkUTQ4bFdXV/P111/Tv3//\nOvv79+/PZ599dsXXvffeeyxdutS1nZGRwYcffujafuqppxg4cGBDyxMRERER8ZoGh+0TJ05QU1ND\nu3bt6uyPiIigpKTkiq+z2+3MmjXLtf3YY4+xcOHChpYjIiIiItJkeGWe7bKyMlJTU9mwYQNlZWXe\nKEEaICEhAUBj1wxoLJsHjWPzobFsPjSWcl6Dv9lu27Yt/v7+lJaW1tlfWlpKVFRUQy8vIiIiIuKz\nGhy2bTYbPXv2ZP369XX2b9iwgfT09IZeXkRERETEZ7nlNpLx48fz2GOPkZqaSnp6OvPmzaOkpISn\nn37adU5YWJg73kpERERExGe4JWw//PDDfPvtt0yZMoWjR4+SkpLCunXriI2NdcflRURERER8kmXO\nL9MoIiIiIiJu5bbl2q/GnUu5i/dkZ2fj5+dX5xEdHe3tsuQaNm7cyODBg2nfvj1+fn7k5ub+0znZ\n2dnExMQQEhLCHXfcwa5du7xQqVzLtcZy+PDh/9Sj+u1M0zNt2jR69+5NWFgYERERDB48mKKion86\nT33Z9F3PWKovfcOcOXPo3r07YWFhhIWFkZ6ezrp16+qcU9+e9HjYdsdS7tJ0JCUlUVJS4nrs3LnT\n2yXJNZSXl9OtWzdmzpxJcHAwlmXVOf7yyy8zY8YMZs+ezZdffklERAT9+vXD4XB4qWK5kmuNpWVZ\n9OvXr06PXvqXhXjfJ598wpgxY/j888/Jy8sjICCAO++8k++++851jvrSN1zPWKovfUNsbCzTp09n\n27ZtbN26lYyMDO677z62b98ONLAnjYelpqaaUaNG1dmXkJBgnn/+eU+/tbjZ5MmTTdeuXb1dhjRA\nixYtTG5urmu7trbWREZGmqlTp7r2VVZWmtDQUDN//nxvlCjX6dKxNMaYYcOGmbvvvttLFUl9ORwO\n4+/vb9auXWuMUV/6skvH0hj1pS9r3bq1WbBgQYN70qPfbNd3KXdpuvbv309MTAydOnVi6NChHDhw\nwNslSQMcOHCA0tLSOj1qt9vp27evetQHWZZFQUEB7dq1IzExkVGjRnH8+HFvlyXXcPr0aWprawkP\nDwfUl77s0rEE9aUvqqmpYcWKFVRVVdG3b98G96RHw3Z9l3KXpqlPnz7k5uby0UcfsXDhQkpKSkhP\nT+fkyZPeLk3q6XwfqkebhwEDBvDnP/+ZvLw8XnvtNbZs2UJGRgbV1dXeLk2uYty4cfTo0YO0tDRA\nfenLLh1LUF/6kp07d9KiRQvsdjujRo1i1apVJCYmNrgnvbJcu/imAQMGuJ537dqVtLQ04uPjyc3N\nJSsry4uViSdcej+wNH2PPPKI63lycjI9e/YkLi6O999/n/vvv9+LlcmVjB8/ns8++4yCgoLr6jn1\nZdN1pbFUX/qOpKQkduzYQVlZGatXr2bIkCHk5+df9TXX05Me/WZbS7k3byEhISQnJ7N3715vlyL1\nFBkZCXDZHj1/THxXVFQU7du3V482UVlZWaxcuZK8vDw6duzo2q++9D1XGsvLUV82XYGBgXTq1Ike\nPXowdepU+vTpw5w5c1yZtb496dGwraXcm7eqqiqKi4v1DycfFh8fT2RkZJ0eraqqoqCgQD3aDBw/\nfpwjR46oR5ugcePGucJZly5d6hxTX/qWq43l5agvfUdNTQ21tbUN7kn/7OzsbA/WScuWLZk8eTLR\n0dEEBwczZcoUCgoKWLx4sZZw9zETJkzAbrdTW1vL7t27GTNmDPv372f+/PkayyasvLycXbt2UVJS\nwqJFi0hJSSEsLIwffviBsLAwampq+OMf/0hiYiI1NTWMHz+e0tJSFixYgM1m83b5cpGrjWVAQACT\nJk2iZcuWnD17lsLCQp588klqa2uZPXu2xrIJGT16NEuWLGH16tW0b98eh8OBw+HAsixsNhuWZakv\nfcS1xrK8vFx96SMmTpzoyjiHDh3i9ddfZ9myZUyfPp3OnTs3rCc9OWXKeTk5OaZjx44mKCjI9OrV\ny2zatKkx3lbcbMiQISY6OtrYbDYTExNjHnzwQVNcXOztsuQa8vPzjWVZxrIs4+fn53qemZnpOic7\nO9tERUUZu91ufvGLX5iioiIvVixXcrWxrKysNL/85S9NRESEsdlsJi4uzmRmZprDhw97u2y5xKXj\nd/7x0ksv1TlPfdn0XWss1Ze+Y/jw4SYuLs4EBQWZiIgI069fP7N+/fo659S3J7Vcu4iIiIiIhzTK\ncu0iIiIiIjcihW0REREREQ9R2BYRERER8RCFbRERERERD1HYFhERERHxEIVtEREREREPUdgWERER\nEfEQhW0REREREQ9R2BYRERER8ZD/B78e0ZyQOgUCAAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7e90748>"
      ]
     },
     "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+vTp5Np4oLsoPz8/+vTpw65du2jTpg2Ojo40bdqUnTt3AvD999/TtGlTdDodrVu35vBhy2dPjh8/\nztixY6lXrx46nQ5vb29GjBjB5cuXLeoVpNfs3r2badOm4e3tjbOzM4MGDeLWrVsltnHMmDG0aWP6\npG/s2LEoFAq6d+8OlJ7nfvHiRXx8TDPsREREmNNCxo4da65z/fp1xo8fT7Vq1dBqtQQGBvLZZ59Z\nHGfXrl0oFApWr17NrFmzqFOnDo6OjuYR5w0bNtC2bVurm4TidO7cGcCqn+5U9erVUalKT8rYuHEj\n+fn5TJw40aJ84sSJXL9+nT179liU9+jRg6ysLLZu3Vou7awoIh1FEIRSnUo4RXLGLbpuO82jX+xE\nl5FjVSdLp+bos/1p/O4iOrpXM5eLGU+EfyNb84sXvP//DTIzM+nXrx979+4tdgR8xYoV6HQ6pk6d\nipubG3v37mX+/PlcvnyZNWvWlHh8SZI4f/48I0eO5LnnnmPUqFHMnTuXgQMH8sknnxAeHs7kyZOR\nJInIyEiGDh3K2bNnzYHvjh07OHPmDGPGjKFGjRqcO3eOzz77jAMHDhAXF2eVm/zSSy/h5eVFREQE\nFy5cYMGCBUyePJlvvvmm2DY+//zz1K9fn5kzZ/Lcc88RHBxM1apVLa6hOD4+PixevJiJEycyaNAg\nc//Vq1cPMI2wd+jQAVmWmTx5Mj4+PuzYsYMXXniBxMRE3nzzTYvjRUZGolQqefnll5FlGWdnZ/R6\nPbGxsUyYMKHEvi7s4sWLAFSrVs2iPDU1Fb1eX+rr1Wo1bm5ln6LzyJEjaLVamjRpYlHetm1bAI4e\nPWqRshMYGIhOpyMmJoYhQ4aU+XyVRrZTZGSk3KZNG9nV1VX29vaWH3vsMTkuLs6izujRo2VJkiy2\njh07WtRJSUkxb4J9YmNj5djY2HvdjAeG6K+yK63Pflw9S74SUEOWwea2v4Of/MX68Mpr8D0m3mNl\nJ/pMlv+I/0N+Zesr8qnrp8r2wmJ+7splK2fLly+XJUmSfX19ZbVaLX///ffF1s3KyrIqi4yMlBUK\nhXz58mVzWXh4uCxJkkU9X19fWZIkec+ePeaybdu2yZIkyVqtVr548aK5fOnSpbIkSfKOHTtKPHdM\nTIwsSZK8atUqq+sJDQ21qDtt2jRZpVLJaWlpxV6fLJve95IkyStXrrQot3VNXbt2lUNCQsxfJyQk\n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\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7e45240>"
      ]
     },
     "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
}