Appendix-E-Ensemble-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": [
    "# Ensemble 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",
       "@import url('http://fonts.googleapis.com/css?family=Fira_sans');\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: 'Fira sans', verdana,arial,sans-serif;\n",
       "        line-height: 150%;\n",
       "        font-size: 110%;\n",
       "        font-weight: 400;\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\", \"autobold.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",
    "from __future__ import division, print_function\n",
    "from book_format import load_style\n",
    "load_style()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "> I am not well versed with Ensemble filters. I have implemented one for this book, and made it work, but I have not used one in real life. Different sources use slightly different forms of these equations. If I implement the equations given in the sources the filter does not work. It is possible that I am doing something wrong. However, in various places on the web I have seen comments by people stating that they do the kinds of things I have done in my filter to make it work. In short, I do not understand this topic well, but choose to present my lack of knowledge rather than to gloss over the subject. I hope to master this topic in the future and to author a more definitive chapter. At the end of the chapter I document my current confusion and questions. In any case if I got confused by the sources perhaps you also will, so documenting my confusion can help you avoid the same.\n",
    "\n",
    "\n",
    "The ensemble Kalman filter (EnKF) is very similar to the unscented Kalman filter (UKF) of the last chapter. If you recall, the UKF uses a set of deterministically chosen weighted sigma points passed through nonlinear state and measurement functions. After the sigma points are passed through the function, we find the mean and covariance of the points and use this as the filter's new mean and covariance. It is only an approximation of the true value, and thus suboptimal, but in practice the filter is highly accurate. It has the advantage of often producing more accurate estimates than the EKF does, and also does not require you to analytically derive the linearization of the state and measurement equations. \n",
    "\n",
    "The ensemble Kalman filter works in a similar way, except it uses a *Monte Carlo* method to choose a large numbers of sigma points. It came about from the geophysical sciences as an answer for the very large states and systems needed to model things such as the ocean and atmosphere. There is an interesting article on it's development in weather modeling in *SIAM News* [1]. The filter starts by randomly generating a large number of points distributed about the filter's initial state. This distribution is proportional to the filter's covariance $\\mathbf{P}$. In other words 68% of the points will be within one standard deviation of the mean, 95% percent within two standard deviations, and so on. Let's look at this in two dimensions. We will use `numpy.random.multivariate_normal()` function to randomly create points from a multivariate normal distribution drawn from the mean (5, 3) with the covariance\n",
    "\n",
    "$$\\begin{bmatrix}\n",
    "32 & 15 \\\\ 15 & 40\n",
    "\\end{bmatrix}$$\n",
    "\n",
    "I've drawn the covariance ellipse representing two standard deviations to illustrate how the points are distributed."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n8CCu65KRkdHndv3/Xi41s2bN4qmnnmLSpEk0NTXx8MMPU1ZWxsaNGyM/C/39nOzbt+98LFdkQAre\nck48+OCDp/2n8FWrVjFv3jzuvvvuyG1TpkwhLy+PkpISampqKCoqOtdLFRGRIWzRokWRr6dOncrs\n2bPJycnhqaeeorS09JSPsywrGssT+VAUvOWceOCBB1i6dOmAx2RlZfV7+4wZM3Ach23btlFUVERm\nZiYHDhzoc4zv++zfv5/MzMxBW7PIUDJq1Cgcx6GpqanP7U1NTYwePfo8rUrk/EtISGDKlCls376d\nW265BTA/F+PGjYsc09TUpN8PMiSpxlvOidTUVAoLCwf8Lz4+vt/Hrl+/Htd1I+Fi9uzZtLa29qnn\nrqys5NixY5SVlUXl9YhEW0xMDMXFxbz66qt9bn/ttdf0/3u5pLW3t7N582ZGjx5NTk4OmZmZfX5O\n2tvbWb16tX5OZEhyHnrooYfO9yLk0rVz504ee+wxkpKS6OzspKKigmXLlpGdnc13vvMdLMsiLS2N\nqqoqli9fzvTp09m7dy/33HMPs2bN4r777jvfL0HknElOTubb3/42Y8aMIT4+nocffpjVq1fzi1/8\nguHDh5/v5YlExde+9jXi4uLwPI/a2lq++MUvsnPnTp544gmGDx+O67p873vfY+LEibiuy1e/+lWa\nmpp48skniYmJOd/LF+lDpSZyXsXExPDnP/+Zn/zkJ7S2tpKVlcWNN97It7/97T71ecuXL+f+++9n\n4cKFANx88808/vjj52vZIlHxmc98hg8++ICHH36Y999/n2nTpvHyyy+fskxL5GLU0NDAHXfcwcGD\nB0lLS2P27Nm89dZbkZ+Db3zjG7S1tXHffffR3NzMrFmzePXVV0lMTDzPKxc5mfp4i4iIiIhEgWq8\nRURERESiQMFbRERERCQKFLxFRERERKJAwVtEREREJAoUvEVEREREokDBW0REREQkChS8RURERESi\nQMFbRERERCQKFLxFRERERKLg/wf8OZaidFvEWQAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7248f98>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "import matplotlib.pyplot as plt\n",
    "import numpy as np\n",
    "from numpy.random import multivariate_normal\n",
    "from filterpy.stats import (covariance_ellipse, \n",
    "                            plot_covariance_ellipse)\n",
    "\n",
    "mean = (5, 3)\n",
    "P = np.array([[32, 15],\n",
    "              [15., 40.]])\n",
    "\n",
    "x,y = multivariate_normal(mean=mean, cov=P, size=2500).T\n",
    "plt.scatter(x, y, alpha=0.3, marker='.')\n",
    "plt.axis('equal')\n",
    "\n",
    "plot_covariance_ellipse(mean=mean, cov=P,\n",
    "                        variance=2.**2,\n",
    "                        facecolor='none')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## The Algorithm"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "As I already stated, when the filter is initialized a large number of sigma points are drawn from the initial state ($\\mathbf{x}$) and covariance ($\\mathbf{P}$). From there the algorithm proceeds very similarly to the UKF. During the prediction step the sigma points are passed through the state transition function, and then perturbed by adding a bit of noise to account for the process noise. During the update step the sigma points are translated into measurement space by passing them through the measurement function, they are perturbed by a small amount to account for the measurement noise. The Kalman gain is computed from the \n",
    "\n",
    "We already mentioned the main difference between the UKF and EnKF - the UKF choses the sigma points deterministically. There is another difference, implied by the algorithm above. With the UKF we generate new sigma points during each predict step, and after passing the points through the nonlinear function we reconstitute them into a mean and covariance by using the *unscented transform*. The EnKF keeps propagating the originally created sigma points; we only need to compute a mean and covariance as outputs for the filter! \n",
    "\n",
    "Let's look at the equations for the filter. As usual, I will leave out the typical subscripts and superscripts; I am expressing an algorithm, not mathematical functions. Here $N$ is the number of sigma points, $\\chi$ is the set of sigma points."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Initialize Step"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\\boldsymbol\\chi \\sim \\mathcal{N}(\\mathbf{x}_0, \\mathbf{P}_0)$$\n",
    "\n",
    "This says to select the sigma points from the filter's initial mean and covariance. In code this might look like\n",
    "\n",
    "```python\n",
    "N = 1000\n",
    "sigmas = multivariate_normal(mean=x, cov=P, size=N)\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Predict Step"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\begin{aligned}\n",
    "\\boldsymbol\\chi &= f(\\boldsymbol\\chi, \\mathbf{u}) + v_Q \\\\\n",
    "\\mathbf{x} &= \\frac{1}{N} \\sum_1^N \\boldsymbol\\chi\n",
    "\\end{aligned}\n",
    "$$\n",
    "\n",
    "That is short and sweet, but perhaps not entirely clear. The first line passes all of the sigma points through a use supplied state transition function and then adds some noise distributed according to the $\\mathbf{Q}$ matrix. In Python we might write\n",
    "\n",
    "```python\n",
    "for i, s in enumerate(sigmas):\n",
    "    sigmas[i] = fx(x=s, dt=0.1, u=0.)\n",
    "\n",
    "sigmas += multivariate_normal(x, Q, N)\n",
    "```\n",
    "\n",
    "The second line computes the mean from the sigmas. In Python we will take advantage of `numpy.mean` to do this very concisely and quickly.\n",
    "\n",
    "```python\n",
    "x = np.mean(sigmas, axis=0)\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can now optionally compute the covariance of the mean. The algorithm does not need to compute this value, but it is often useful for analysis. The equation is\n",
    "\n",
    "$$\\mathbf{P} = \\frac{1}{N-1}\\sum_1^N[\\boldsymbol\\chi-\\mathbf{x}^-][\\boldsymbol\\chi-\\mathbf{x}^-]^\\mathsf{T}$$\n",
    "\n",
    "$\\boldsymbol\\chi-\\mathbf{x}^-$ is a one dimensional vector, so we will use `numpy.outer` to compute the $[\\boldsymbol\\chi-\\mathbf{x}^-][\\boldsymbol\\chi-\\mathbf{x}^-]^\\mathsf{T}$ term. In Python we might write\n",
    "\n",
    "```python\n",
    "    P = 0\n",
    "    for s in sigmas:\n",
    "        P += outer(s-x, s-x)\n",
    "    P = P / (N-1)\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Update Step"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In the update step we pass the sigma points through the measurement function, compute the mean and covariance of the sigma points, compute the Kalman gain from the covariance, and then update the Kalman state by scaling the residual by the Kalman gain. The equations are\n",
    "\n",
    "$$\n",
    "\\begin{aligned}\n",
    "\\boldsymbol\\chi_h &= h(\\boldsymbol\\chi, u)\\\\\n",
    "\\mathbf{z}_{mean} &= \\frac{1}{N}\\sum_1^N \\boldsymbol\\chi_h \\\\ \\\\\n",
    "\\mathbf{P}_{zz} &= \\frac{1}{N-1}\\sum_1^N [\\boldsymbol\\chi_h - \\mathbf{z}_{mean}][\\boldsymbol\\chi_h - \\mathbf{z}_{mean}]^\\mathsf{T} + \\mathbf{R} \\\\\n",
    "\\mathbf{P}_{xz} &= \\frac{1}{N-1}\\sum_1^N [\\boldsymbol\\chi - \\mathbf{x}^-][\\boldsymbol\\chi_h - \\mathbf{z}_{mean}]^\\mathsf{T} \\\\\n",
    "\\\\\n",
    "\\mathbf{K} &= \\mathbf{P}_{xz} \\mathbf{P}_{zz}^{-1}\\\\ \n",
    "\\boldsymbol\\chi & = \\boldsymbol\\chi + \\mathbf{K}[\\mathbf{z} -\\boldsymbol\\chi_h + \\mathbf{v}_R] \\\\ \\\\\n",
    "\\mathbf{x} &= \\frac{1}{N} \\sum_1^N \\boldsymbol\\chi \\\\\n",
    "\\mathbf{P} &= \\mathbf{P} - \\mathbf{KP}_{zz}\\mathbf{K}^\\mathsf{T}\n",
    "\\end{aligned}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This is very similar to the linear KF and the UKF. Let's just go line by line.\n",
    "\n",
    "The first line,\n",
    "\n",
    "$$\\boldsymbol\\chi_h = h(\\boldsymbol\\chi, u),$$\n",
    "\n",
    "just passes the sigma points through the measurement function $h$. We name the resulting points $\\chi_h$ to distinguish them from the sigma points. In Python we could write this as\n",
    "\n",
    "```python\n",
    "sigmas_h = h(sigmas, u)\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The next line computes the mean of the measurement sigmas.\n",
    "\n",
    "$$\\mathbf{z}_{mean} = \\frac{1}{N}\\sum_1^N \\boldsymbol\\chi_h$$\n",
    "\n",
    "In Python we write\n",
    "\n",
    "```python\n",
    "z_mean = np.mean(sigmas_h, axis=0)\n",
    "```\n",
    "    \n",
    "Now that we have the mean of the measurement sigmas we can compute the covariance for every measurement sigma point, and the *cross variance* for the measurement sigma points vs the sigma points. That is expressed by these two equations\n",
    "\n",
    "$$\n",
    "\\begin{aligned}\n",
    "\\mathbf{P}_{zz} &= \\frac{1}{N-1}\\sum_1^N [\\boldsymbol\\chi_h - \\mathbf{z}_{mean}][\\boldsymbol\\chi_h - \\mathbf{z}_{mean}]^\\mathsf{T} + \\mathbf{R} \\\\\n",
    "\\mathbf{P}_{xz} &= \\frac{1}{N-1}\\sum_1^N [\\boldsymbol\\chi - \\mathbf{x}^-][\\boldsymbol\\chi_h - \\mathbf{z}_{mean}]^\\mathsf{T}\n",
    "\\end{aligned}$$\n",
    "\n",
    "We can express this in Python with\n",
    "\n",
    "```python\n",
    "P_zz = 0\n",
    "for sigma in sigmas_h:\n",
    "    s = sigma - z_mean\n",
    "    P_zz += outer(s, s)\n",
    "P_zz = P_zz / (N-1) + R\n",
    "\n",
    "P_xz = 0\n",
    "for i in range(N):\n",
    "    P_xz += outer(self.sigmas[i] - self.x, sigmas_h[i] - z_mean)\n",
    "P_xz /= N-1\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Computation of the Kalman gain is straightforward $\\mathbf{K} = \\mathbf{P}_{xz} \\mathbf{P}_{zz}^{-1}$.\n",
    "\n",
    "In Python this is\n",
    "\n",
    "```python\n",
    "K = np.dot(P_xz, inv(P_zz))```\n",
    "\n",
    "Next, we update the sigma points with\n",
    "\n",
    "$$\\boldsymbol\\chi  = \\boldsymbol\\chi + \\mathbf{K}[\\mathbf{z} -\\boldsymbol\\chi_h + \\mathbf{v}_R]$$ \n",
    "\n",
    "Here $\\mathbf{v}_R$ is the perturbation that we add to the sigmas. In Python we can implement this with\n",
    "\n",
    "```python\n",
    "v_r = multivariate_normal([0]*dim_z, R, N)\n",
    "for i in range(N):\n",
    "    sigmas[i] += dot(K, z + v_r[i] - sigmas_h[i])\n",
    "```\n",
    "\n",
    "\n",
    "Our final step is recompute the filter's mean and covariance.\n",
    "\n",
    "```python\n",
    "    x = np.mean(sigmas, axis=0)\n",
    "    P = self.P - dot3(K, P_zz, K.T)\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Implementation and Example"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "I have implemented an EnKF in the `FilterPy` library. It is in many ways a toy. Filtering with a large number of sigma points gives us very slow performance. Furthermore, there are many minor variations on the algorithm in the literature. I wrote this mostly because I was interested in learning a bit about the filter. I have not used it for a real world problem, and I can give no advice on using the filter for the large problems for which it is suited. Therefore I will refine my comments to implementing a very simple filter. I will use it to track an object in one dimension, and compare the output to a linear Kalman filter. This is a filter we have designed many times already in this book, so I will design it with little comment. Our state vector will be\n",
    "\n",
    "$$\\mathbf{x} = \\begin{bmatrix}x\\\\ \\dot{x}\\end{bmatrix}$$\n",
    "\n",
    "The state transition function is\n",
    "\n",
    "$$\\mathbf{F} = \\begin{bmatrix}1&1\\\\0&1\\end{bmatrix}$$\n",
    "\n",
    "and the measurement function is\n",
    "\n",
    "$$\\mathbf{H} = \\begin{bmatrix}1&0\\end{bmatrix}$$\n",
    "\n",
    "The EnKF is designed for nonlinear problems, so instead of using matrices to implement the state transition and measurement functions you will need to supply Python functions. For this problem they can be written as:\n",
    "\n",
    "```python\n",
    "def hx(x):\n",
    "    return np.array([x[0]])\n",
    "\n",
    "def fx(x, dt):\n",
    "    return np.dot(F, x)\n",
    "```\n",
    "\n",
    "One final thing: the EnKF code, like the UKF code, uses a single dimension for $\\mathbf{x}$, not a two dimensional column matrix as used by the linear kalman filter code.\n",
    "\n",
    "Without further ado, here is the code."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "collapsed": false,
    "scrolled": true
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\nIiIiIsqAzz3yawaipvFoAAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7efa470>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "from numpy.random import randn\n",
    "from filterpy.kalman import EnsembleKalmanFilter as EnKF\n",
    "from filterpy.kalman import KalmanFilter\n",
    "from filterpy.common import Q_discrete_white_noise\n",
    "import book_plots as bp\n",
    "\n",
    "np.random.seed(1234)\n",
    "\n",
    "def hx(x):\n",
    "    return np.array([x[0]])\n",
    "\n",
    "def fx(x, dt):\n",
    "    return np.dot(F, x)\n",
    "    \n",
    "F = np.array([[1., 1.],[0., 1.]])\n",
    "\n",
    "x = np.array([0., 1.])\n",
    "P = np.eye(2) * 100.\n",
    "enf = EnKF(x=x, P=P, dim_z=1, dt=1., N=20, hx=hx, fx=fx)\n",
    "\n",
    "std_noise = 10.\n",
    "enf.R *= std_noise**2\n",
    "enf.Q = Q_discrete_white_noise(2, 1., .001)\n",
    "\n",
    "kf = KalmanFilter(dim_x=2, dim_z=1)\n",
    "kf.x = np.array([x]).T\n",
    "kf.F = F.copy()\n",
    "kf.P = P.copy()\n",
    "kf.R = enf.R.copy()\n",
    "kf.Q = enf.Q.copy()\n",
    "kf.H = np.array([[1., 0.]])\n",
    "\n",
    "measurements = []\n",
    "results = []\n",
    "ps = []\n",
    "kf_results = []\n",
    "\n",
    "zs = []\n",
    "for t in range (0,100):\n",
    "    # create measurement = t plus white noise\n",
    "    z = t + randn()*std_noise\n",
    "    zs.append(z)\n",
    "\n",
    "    enf.predict()\n",
    "    enf.update(np.asarray([z]))\n",
    "    \n",
    "    kf.predict()\n",
    "    kf.update(np.asarray([[z]]))\n",
    "\n",
    "    # save data\n",
    "    results.append (enf.x[0])\n",
    "    kf_results.append (kf.x[0,0])\n",
    "    measurements.append(z)\n",
    "    ps.append(3*(enf.P[0,0]**.5))\n",
    "\n",
    "results = np.asarray(results)\n",
    "ps = np.asarray(ps)\n",
    "\n",
    "plt.plot(results, label='EnKF')\n",
    "plt.plot(kf_results, label='KF', c='b', lw=2)\n",
    "bp.plot_measurements(measurements)\n",
    "plt.plot (results - ps, c='k',linestyle=':', lw=1, label='1$\\sigma$')\n",
    "plt.plot(results + ps, c='k', linestyle=':', lw=1)\n",
    "plt.fill_between(range(100), results - ps, results + ps, facecolor='y', alpha=.3)\n",
    "plt.legend(loc='best');"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "It can be a bit difficult to see, but the KF and EnKF start off slightly different, but soon converge to producing nearly the same values. The EnKF is a suboptimal filter, so it will not produce the optimal solution that the KF produces. However, I deliberately chose $N$ to be quite small (20) to guarantee that the EnKF output is quite suboptimal. If I chose a more reasonable number such as 2000 you would be unable to see the difference between the two filter outputs on this graph."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Outstanding Questions"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "All of this should be considered as *my* questions, not lingering questions in the literature. However, I am copying equations directly from well known sources in the field, and they do not address the discrepancies.\n",
    "\n",
    "First, in Brown [2] we have all sums multiplied by $\\frac{1}{N}$, as in \n",
    "\n",
    "$$ \\hat{x} = \\frac{1}{N}\\sum_{i=1}^N\\chi_k^{(i)}$$\n",
    "\n",
    "The same equation in Crassidis [3] reads (I'll use the same notation as in Brown, although Crassidis' is different)\n",
    "\n",
    "$$ \\hat{x} = \\frac{1}{N-1}\\sum_{i=1}^N\\chi_k^{(i)}$$\n",
    "\n",
    "The same is true in both sources for the sums in the computation for the covariances. Crassidis, in the context of talking about the filter's covariance, states that $N-1$ is used to ensure an unbiased estimate. Given the following standard equations for the mean and standard deviation (p.2 of Crassidis), this makes sense for the covariance.\n",
    "\n",
    "$$\n",
    "\\begin{aligned}\n",
    "\\mu &= \\frac{1}{N}\\sum_{i=1}^N[\\tilde{z}(t_i) - \\hat{z}(t_i)] \\\\\n",
    " \\sigma^2 &= \\frac{1}{N-1}\\sum_{i=1}^N\\{[\\tilde{z}(t_i) - \\hat{z}(t_i)] - \\mu\\}^2\n",
    "\\end{aligned}\n",
    "$$\n",
    "\n",
    "However, I see no justification or reason to use $N-1$ to compute the mean. If I use $N-1$ in the filter for the mean the filter does not converge and the state essentially follows the measurements without any filtering. However, I do see a reason to use it for the covariance as in Crassidis, in contrast to Brown. Again, I support my decision empirically - $N-1$ works in the implementation of the filter, $N$ does not.\n",
    "\n",
    "My second question relates to the use of the $\\mathbf{R}$ matrix. In Brown $\\mathbf{R}$ is added to $\\mathbf{P}_{zz}$ whereas it isn't in Crassidis and other sources. I have read on the web notes by other implementers that adding R helps the filter, and it certainly seems reasonable and necessary to me, so this is what I do. \n",
    "\n",
    "My third question relates to the computation of the covariance $\\mathbf{P}$. Again, we have different equations in Crassidis and Brown. I have chosen the implementation given in Brown as it seems to give me the  behavior that I expect (convergence of $\\mathbf{P}$ over time) and it closely compares to the form in the linear KF. In contrast I find the equations in Crassidis do not seem to converge much.\n",
    "\n",
    "My fourth question relates to the state estimate update. In Brown we have \n",
    "\n",
    "$$\\boldsymbol\\chi  = \\boldsymbol\\chi + \\mathbf{K}[\\mathbf{z} -\\mathbf{z}_{mean} + \\mathbf{v}_R]$$ \n",
    "\n",
    "whereas in Crassidis we have\n",
    "\n",
    "$$\\boldsymbol\\chi  = \\boldsymbol\\chi + \\mathbf{K}[\\mathbf{z} -\\boldsymbol\\chi_h + \\mathbf{v}_R]$$ \n",
    "\n",
    "To me the Crassidis equation seems logical, and it produces a filter that performs like the linear KF for linear problems, so that is the formulation that I have chosen. \n",
    "\n",
    "I am not comfortable saying either book is wrong; it is quite possible that I missed some point that makes each set of equations work. I can say that when I implemented them as written I did not get a filter that worked. I define \"work\" as performs essentially the same as the linear KF for linear problems. Between reading implementation notes on the web and reasoning about various issues I have chosen the implementation in this chapter, which does in fact seem to work correctly. I have yet to explore the significant amount of original literature that will likely definitively explain the discrepancies. I would like to leave this here in some form even if I do find an explanation that reconciles the various differences, as if I got confused by these books than probably others will as well."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## References"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "- [1] Mackenzie, Dana. *Ensemble Kalman Filters Bring Weather Models Up to Date* Siam News,  Volume 36, Number 8, October 2003. http://www.siam.org/pdf/news/362.pdf\n",
    "\n",
    "- [2]  Brown, Robert Grover, and Patrick Y.C. Hwang. *Introduction to Random Signals and Applied Kalman Filtering, With MATLAB® excercises and solutions.* Wiley, 2012.\n",
    "\n",
    "- [3] Crassidis, John L., and John L. Junkins. *Optimal estimation of dynamic systems*. CRC press, 2011."
   ]
  }
 ],
 "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.5.0"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 0
}