{
"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": [
"# Kalman Filter Math"
]
},
{
"cell_type": "code",
"execution_count": 37,
"metadata": {
"collapsed": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"The autoreload extension is already loaded. To reload it, use:\n",
" %reload_ext autoreload\n"
]
},
{
"data": {
"text/html": [
"\n",
"\n"
],
"text/plain": [
""
]
},
"execution_count": 37,
"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 matplotlib.pyplot as plt\n",
"import book_format\n",
"book_format.load_style()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"** author's note:** *the ordering of material in this chapter is questionable. I delve into solving ODEs before discussing the basic Kalman equations. If you are reading this while it is being worked on (so long as this notice exists), you may find it easier to skip around a bit until I organize it better.*\n",
"\n",
"\n",
"If you've gotten this far I hope that you are thinking that the Kalman filter's fearsome reputation is somewhat undeserved. Sure, I hand waved some equations away, but I hope implementation has been fairly straightforward for you. The underlying concept is quite straightforward - take two measurements, or a measurement and a prediction, and choose the output to be somewhere between the two. If you believe the measurement more your guess will be closer to the measurement, and if you believe the prediction is more accurate your guess will lie closer it it. That's not rocket science (little joke - it is exactly this math that got Apollo to the moon and back!). \n",
"\n",
"Well, to be honest I have been choosing my problems carefully. For any arbitrary problem finding some of the matrices that we need to feed into the Kalman filter equations can be quite difficult. I haven't been *too tricky*, though. Equations like Newton's equations of motion can be trivially computed for Kalman filter applications, and they make up the bulk of the kind of problems that we want to solve. If you are a hobbyist, you can safely pass by this chapter for now, and perhaps forever. Some of the later chapters will assume the material in this chapter, but much of the work will still be accessible to you. \n",
"\n",
"But, I urge everyone to at least read the first section, and to skim the rest. It is not much harder than what you have done - the difficulty comes in finding closed form expressions for specific problems, not understanding the math in this chapter. "
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Bayesian Probability"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The title of this book is *Kalman and Bayesian Filters in Python* but to date I have not touched on the Bayesian aspect much. There was enough going on in the earlier chapters that adding this form of reasoning about filters could be a distraction rather than a help. I now wish to take some time to explain what Bayesian probability is and how a Kalman filter is in fact a Bayesian filter. This is not a diversion. First of all, a lot of the Kalman filter literature uses this formulation when talking about filters, so you will need to understand what they are talking about. Second, this math plays a strong role in filtering design once we move past the Kalman filter. \n",
"\n",
"To do so we will go back to our first tracking problem - tracking a dog in a hallway. Recall the update step - we believed with some degree of precision that the dog was at position 7 (for example), and then receive a measurement that the dog is at position 7.5. We want to incorporate that measurement into our belief. In the *Discrete Bayes* chapter we used histograms to denote our estimates at each hallway position, and in the *One Dimensional Kalman Filters* we used Gaussians. Both are method of using *Bayesian* probability.\n",
"\n",
"Briefly, *Bayesian* probability is a branch of math that lets us evaluate a hypothesis or new data point given some uncertain information about the past. For example, suppose you are driving down your neighborhood street and see one of your neighbors at their door, using a key to let themselves in. Three doors down you see two people in masks breaking a window of another house. What might you conclude?\n",
"\n",
"It is likely that you would reason that in the first case your neighbors were getting home and unlocking their door to get inside. In the second case you at least strongly suspect a robbery is in progress. In the first case you would proceed on, and in the second case you'd probably call the police.\n",
"\n",
"Of course, things are not always what they appear. Perhaps unbeknownst to you your neighbor sold their house that morning, and they were now breaking in to steal the new owner's belongings. In the second case, perhaps the owners of the house were at a costume event at the next house, they had a medical emergency with their child, realized they lost their keys, and were breaking into their own house to get the much needed medication. Those are both *unlikely* events, but possible. Adding a few additional pieces of information would allow you to determine the true state of affairs in all but the most complicated situations.\n",
"\n",
"These are instances of *Bayesian* reasoning. We take knowledge from the past and integrate in new information. You know that your neighbor owned their house yesterday, so it is still highly likely that they still own it today. You know that owners of houses normally have keys to the front door, and that the normal mode of entrance into your own house is not breaking windows, so the second case is *likely* to be a breaking and entering. The reasoning is not ironclad as shown by the alternative explanations, but it is likely."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Bayes' theorem"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"*Bayes' theorem* mathematically formalizes the above reasoning. It is written as\n",
"\n",
"$$P(A|B) = \\frac{P(B | A)\\, P(A)}{P(B)}\\cdot$$\n",
"\n",
"\n",
"Before we do some computations, let's review what the terms mean. P(A) is called the *prior probability* of the event A, and is often shortened to the *prior*. What is the prior? It is the probability of A being true *before* we incorporate new evidence. In our dog tracking problem above, the prior is the probability we assign to our belief that the dog is positioned at 7 before we make the measurement of 7.5. It is important to master this terminology if you expect to read a lot of the literature.\n",
"\n",
"$P(A|B)$ is the *conditional probability* that A is true given that B is true. For example, if it is true that your neighbor still owns their house, then it will be very likely that they are not breaking into their house. In Bayesian probability this is called the *posterior*, and it denotes our new belief after incorporating the measurement/knowledge of B. For our dog tracking problem the posterior is the probability given to the estimated position after incorporating the measurement 7.5. For the neighbor problem the posterior would be the probability of a break in after you find out that your neighbor sold their home last week.\n",
"\n",
"What math did we use for the dog tracking problem? Recall that we used this equation to compute the new mean and probability distribution\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"N(estimate) * N(measurement) &= \\\\\n",
"N(\\mu_1, \\sigma_1^2)*N(\\mu_2, \\sigma_2^2) &= N(\\frac{\\sigma_1^2 \\mu_2 + \\sigma_2^2 \\mu_1}{\\sigma_1^2 + \\sigma_2^2},\\frac{1}{\\frac{1}{\\sigma_1^2} + \\frac{1}{\\sigma_2^2}}) \\cdot\n",
"\\end{aligned}\n",
"$$ \n",
"\n",
"\n",
"Here $N(\\mu_1, \\sigma_1^2)$ is the old estimated position, so $\\sigma_1$ is an indication of our *prior* probability. $N(\\mu_2, \\sigma_2^2)$ is the mean and variance of our measurement, and so the result can be thought of as the new position and probability distribution after incorporating the new measurement. In other words, our *posterior distribution* is \n",
"\n",
"$$\\frac{1}{{\\sigma_{estimate}}^2} + \\frac{1}{{\\sigma_{measurement}}^2}$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"This is still a little hard to compare to Bayes' equation because we are dealing with probability distributions rather than probabilities. So let's cast our minds back to the discrete Bayes chapter where we computed the probability that our dog was at any given position in the hallway. It looked like this:\n",
"\n",
" def update(pos_belief, measure, p_hit, p_miss):\n",
" for i in range(len(hallway)):\n",
" if hallway[i] == measure:\n",
" pos_belief[i] *= p_hit\n",
" else:\n",
" pos_belief[i] *= p_miss\n",
"\n",
" pos_belief /= sum(pos_belief)\n",
"\n",
"Let's rewrite this using our newly learned terminology.\n",
"\n",
" def update(prior_probability, measure, prob_hit, prob_miss):\n",
" posterior_probability = np.zeros(len(prior_probability))\n",
" for i in range(len(hallway)):\n",
" if hallway[i] == measure:\n",
" posterior_probability[i] = prior_probability[i] * p_hit\n",
" else:\n",
" posterior_probability[i] = prior_probability[i] * p_miss\n",
"\n",
" return posterior_probability / sum(posterior_probability)\n",
"\n",
" \n",
"So what is this doing? It's multiplying the old belief that the dog is at position *i* (prior probability) with the probability that the measurement is correct for that position, and then dividing by the total probability for that new event.\n",
"\n",
"Now let's look at Bayes' equation again.\n",
"\n",
"$$P(A|B) = \\frac{P(B | A)\\, P(A)}{P(B)}\\cdot$$\n",
"\n",
"It's the same thing being calculated by the code. Multiply the prior ($P(A)$) by the probability of the measurement at each position ($P(B|A)$) and divide by the total probability for the event ($P(B)$).\n",
"\n",
"In other words the first half of the Discrete Bayes chapter developed Bayes' equation from a thought experiment. I could have presented Bayes' equation and then given you the Python routine above to implement it, but chances are you would not have understood *why* Bayes' equation works. Presenting the equation first is the normal approach of Kalman filtering texts, and I always found it extremely nonintuitive. "
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Computing Means and Covariances\n",
"\n",
"You will not need to do this by hand for the rest of the book, but it is important to understand the computations behind these values. It only takes a few minutes to learn."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Computing the Mean\n",
"\n",
"So let's start with 3 variables: $a, b, c$. Let's say we have two values for each: $a = [1, 3]$, $b = [8, 7]$, and $c = [3,7]$. Another, equivalent way of writing this is that you will sometimes see is\n",
"\n",
"$$\\mathbf{x} = \\begin{bmatrix}a\\\\b\\\\c\\end{bmatrix} = \\begin{bmatrix}1 & 3\\\\8&7\\\\3&7\\end{bmatrix}$$\n",
"\n",
"You will not see that often in the Kalman filter literature, so I will adopt the alternative notation of using a subscript to indicate the $i^{th}$ value for $\\mathbf{x}$\n",
"\n",
"$$\\mathbf{x}_0 = \\begin{bmatrix}1 \\\\8\\\\3\\end{bmatrix},\\ \\ \\mathbf{x}_1 = \\begin{bmatrix}3\\\\7\\\\7\\end{bmatrix}$$\n",
"\n",
"We compute the mean as for the univariate case - sum the values and divide by the number of values. Formally\n",
"\n",
"$$ \\mu_x = \\frac{1}{n}\\sum^n_{i=1} x_i$$\n",
"\n",
"Therefore we can write:\n",
"\n",
"$$\\begin{aligned}\n",
"\\mu_a &= \\frac{1+3}{2} = 2 \\\\\n",
"\\mu_b &= \\frac{8+7}{2} = 7.5 \\\\\n",
"\\mu_c &= \\frac{3+7}{2} = 5 \n",
"\\end{aligned}$$\n",
"\n",
"Which I can express in our shorthand matrix notation as\n",
"\n",
"$$\\mu_x = \\begin{bmatrix}2\\\\7.5\\\\5\\end{bmatrix}$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Expected Value\n",
"\n",
"I could just give you the formula for the covariance but it will make more sense if you see how it is derived. To do that we first need to talk about **expected value** of a random variable. The expected value is the value we expect, on average, for the variable. \n",
"\n",
"The expected value of a random variable is the average value it would have if we took an infinite number of samples of it and then averaged those samples together. Let's say we have $x=[1,3,5]$ and each value is equally probable. What would we *expect* $x$ to have, on average?\n",
"\n",
"It would be the average of 1, 3, and 5, of course, which is 3. That should make sense; we would expect equal numbers of 1, 3, and 5 to occur, so $(1+3+5)/3=3$ is clearly the average of that infinite series of samples.\n",
"\n",
"Now suppose that each value has a different probability of happening. Say 1 has an 80% chance of occurring, 3 has an 15% chance, and 5 has only a 5% chance. In this case we compute the expected value by multiplying each value of $x$ by the percent chance of it occurring, and summing the result. So for this case we could compute\n",
"\n",
"$$E[x] = (1)(0.8) + (3)(0.15) + (5)(0.05) = 1.5$$\n",
"\n",
"Here I have introduced the standard notation $E[x]$ for the expected value of $x$.\n",
"\n",
"We can formalize this by letting $x_i$ be the $i^{th}$ value of $x$, and $p_i$ be the probability of its occurrence. This gives us\n",
"\n",
"$$E[X] = \\sum_{i=1}^n p_ix_i$$\n",
"\n",
"The value 1.5 for $x$ makes intuitive sense because x is far more like to be 1 than 3 or 5, and 3 is more likely than 5 as well.\n",
"\n",
"It is probably worth me pointing out now that if $x$ is continuous we substitute the sum for an integral, like so\n",
"\n",
"$$E[X] = \\int_{-\\infty}^\\infty xf(x)$$\n",
"\n",
"where $f(x)$ is the probability distribution function of $x$. We won't be using this equation yet, but we will be using it in the next chapter."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Computing the Covariance\n",
"\n",
"\n",
"Now we are prepared to compute the covariance matrix. The **covariance** measures how much two random variables move in the same direction, and is defined as\n",
"\n",
"$$ COV(x,y) = \\frac{1}{N}\\sum_{i=1}^N (x_i - \\mu_x)(y_i - \\mu_y)$$\n",
"\n",
"If we compare this to the formula for the variance of a single variable we can see where this definition came from.\n",
"\n",
"$$\\sigma^2 = \\frac{1}{N}\\sum_{i=1}^N(x_i - \\mu)^2$$\n",
"\n",
"And indeed, the covariance of a variable with itself is the variance of the variable, which we can trivially prove with\n",
"\n",
"$$\\begin{aligned}\n",
"COV(x,x) &= \\frac{1}{N}\\sum_{i=1}^N (x_i - \\mu_x)(x_i - \\mu_x) \\\\\n",
"&= \\frac{1}{N}\\sum_{i=1}^N (x_i - \\mu_x)^2 \\\\\n",
"&= VAR(x)\n",
"\\end{aligned}$$\n",
"\n",
"\n",
"Let's build some familiarity with this by calculating the covariance for the $\\mathbf{x}$ from the beginning of this section.\n",
"\n",
"$$\\mathbf{x}_0 = \\begin{bmatrix}1 \\\\8\\\\3\\end{bmatrix},\\ \\ \\mathbf{x}_1 = \\begin{bmatrix}3\\\\7\\\\7\\end{bmatrix}$$\n",
"\n",
"We already know the mean is\n",
"\n",
"$$\\mu_x = \\begin{bmatrix}2\\\\7.5\\\\5\\end{bmatrix}$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Recall that we named the three variables as $a, b, c$. Let's start by computing the variance of $a$.\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"VAR(a) &= \\frac{1}{2}[(1-2)^2 + (3-2)^2] \\\\\n",
"&= \\frac{1}{2}[1+1] \\\\\n",
"&= 1\\end{aligned}$$\n",
"\n",
"\n",
"Using similar math we can compute that $VAR(a) = 0.25$ and $VAR(c)=4$. This allows us to fill in the covariance matrix with\n",
"\n",
"$$\\Sigma = \\begin{bmatrix}1 & & \\\\ & 0.25 & \\\\ &&4\\end{bmatrix}$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Now we can compute the covariance of a and b.\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"COV(a,b) &= \\frac{1}{2}[(1-2)(8-7.5) + (3-2)(7-7.5)] \\\\\n",
"&= \\frac{1}{2}[(-1)(.5)+ (1)(-.5)] \\\\\n",
"&= -0.5\\end{aligned}$$\n",
"\n",
"We can fill in the $a^{th}$ row and $b^{th}$ column in the covariance matrix with this value:\n",
"\n",
"$$\\Sigma = \\begin{bmatrix}1 & & \\\\ -0.5 & 0.25 & \\\\ &&4\\end{bmatrix}$$\n",
"\n",
"We already talked about the symmetry of the covariance matrix; $\\sigma_{ab}=\\sigma_{ba}$. We see now why this is true from the equation for the covariance.\n",
"\n",
"$$\\begin{aligned} COV(x,y) &= \\frac{1}{N}\\sum_{i=1}^N (x_i - \\mu_x)(y_i - \\mu_y) \\\\\n",
"&= \\frac{1}{N}\\sum_{i=1}^N (y_i - \\mu_y)(x_i - \\mu_x) \\\\\n",
"&= COV(y,x)\\end{aligned}$$\n",
"\n",
"This gives the covariance matrix\n",
"\n",
"$$\\Sigma = \\begin{bmatrix}1 &-0.5 & \\\\ -0.5 & 0.25 & \\\\ &&4\\end{bmatrix}$$.\n",
"\n",
"The arithmetic is a bit tedious, so let's use NumPy's `cov()` function to compute the entire covariance matrix. To compute the covariance in accordance with the equations above you will need to set the parameter `bias=1`. The meaning of that parameter is not important to this book. If you are interested, wikipedia has a good article on it here http://en.wikipedia.org/wiki/Bias_of_an_estimator."
]
},
{
"cell_type": "code",
"execution_count": 38,
"metadata": {
"collapsed": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[[ 1. -0.5 2. ]\n",
" [-0.5 0.25 -1. ]\n",
" [ 2. -1. 4. ]]\n"
]
}
],
"source": [
"import numpy as np\n",
"\n",
"x = [[1, 3], [8, 7], [3, 7]]\n",
"print(np.cov(x, bias=1))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We said above that \"the *covariance* measures how much two random variables move in the same direction\", so let's see what that means in practice. If we start with the value $x_0 = (1, 2)$ we can create subsequent values that vary in the same direction with $x_1 = (2, 4)$, $x_2=(3,6)$, and $x_3=(4,8)$."
]
},
{
"cell_type": "code",
"execution_count": 39,
"metadata": {
"collapsed": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[[ 1.25 2.5 ]\n",
" [ 2.5 5. ]]\n"
]
},
{
"data": {
"image/png": "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\n",
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"from filterpy.stats import plot_covariance_ellipse\n",
"\n",
"x = [[1, 2, 3, 4], [2, 4, 6, 8]]\n",
"cov = np.cov(x, bias=1)\n",
"plot_covariance_ellipse([0, 0], cov)\n",
"print(cov)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The values for $x$ are perfectly correlated, and the result is a covariance ellipse with zero width. We can see this by making the values not slightly uncorrelated."
]
},
{
"cell_type": "code",
"execution_count": 40,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"image/png": "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\nAC76/6J/ufuQYyGBAAAAAElFTkSuQmCC\n",
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"x = [[1, 2, 3, 4], [2, 4, 6, 8.4]]\n",
"plot_covariance_ellipse([0, 0], np.cov(x, bias=1))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Now lets make the second value go away from the first."
]
},
{
"cell_type": "code",
"execution_count": 41,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"x = [[1, 2, 3, 4], [-2, -4, -6, -8.4]]\n",
"plot_covariance_ellipse([0, 0], np.cov(x, bias=1))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"As we would hope, the covariance matrix is tilted in the opposite direction, indicating that the variables are inversely correlated. That is, as one gets larger, the other becomes smaller."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Modeling a Dynamic System that Has Noise"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We need to start by understanding the underlying equations and assumptions that the Kalman filter uses. We are trying to model real world phenomena, so what do we have to consider?\n",
"\n",
"First, each physical system has a process. For example, a car traveling at a certain velocity goes so far in a fixed amount of time, and its velocity varies as a function of its acceleration. We describe that behavior with the well known Newtonian equations we learned in high school.\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"v&=at\\\\\n",
"x &= \\frac{1}{2}at^2 + v_0t + d_0\n",
"\\end{aligned}\n",
"$$\n",
"\n",
"And once we learned calculus we saw them in this form:\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
" \\mathbf{v} &= \\frac{d \\mathbf{x}}{d t}\\\\ \n",
" \\quad \\mathbf{a} &= \\frac{d \\mathbf{v}}{d t}\\\\\n",
" &= \\frac{d^2 \\mathbf{x}}{d t^2} \\,\\!\n",
"\\end{aligned}\n",
" $$\n",
" \n",
"A typical problem would have you compute the distance traveled given a constant velocity or acceleration. But, of course we know this is not all that is happening. First, we do not have perfect measures of things like the velocity and acceleration - there is always noise in the measurements, and we have to model that. Second, no car travels on a perfect road. There are bumps that cause the car to slow down, there is wind drag, there are hills that raise and lower the speed. If we do not have explicit knowledge of these factors we lump them all together under the term \"process noise\".\n",
"\n",
"Trying to model all of those factors explicitly and exactly is impossible for anything but the most trivial problem. I could try to include equations for things like bumps in the road, the behavior of the car's suspension system, even the effects of hitting bugs with the windshield, but the job would never be done - there would always be more effects to add and limits to our knowledge (how many bugs do we hit in an hour, for example). What is worse, each of those models would in themselves be a simplification - do I assume the wind is constant, that the drag of the car is the same for all angles of the wind, that the suspension act as perfect springs, that the suspension for each wheel acts identically, and so on.\n",
"\n",
"So control theory makes a mathematically correct simplification. We acknowledge that there are many factors that influence the system that we either do not know or that we don't want to have to model. At any time $t$ we say that the actual value (say, the position of our car) is the predicted value plus some unknown process noise:\n",
"\n",
"$$\n",
"x(t) = x_{pred}(t) + noise(t)\n",
"$$\n",
"\n",
"This is not meant to imply that $noise(t)$ is a function that we can derive analytically or that it is well behaved. If there is a bump in the road at $t=10$ then the noise factor will incorporate that effect. Again, this is not implying that we model, compute, or even know the value of *noise(t)*, it is merely a statement of fact - we can *always* describe the actual value as the predicted value from our idealized model plus some other value. \n",
"\n",
"Let's express this with linear algebra. Using the same notation from previous chapters, we can say that our model of the system (without noise) is:\n",
"\n",
"$$ f(\\mathbf{x}) = \\mathbf{Fx}$$\n",
"\n",
"That is, we have a set of linear equations that describe our system. For our car, \n",
"$\\mathbf{F}$ will be the coefficients for Newton's equations of motion. \n",
"\n",
"Now we need to model the noise. We will call that *w*, and add it to the equation.\n",
"\n",
"$$ f(\\mathbf{x}) = \\mathbf{Fx} + \\mathbf{w}$$\n",
"\n",
"Finally, we need to consider inputs into the system. We are dealing with linear problems here, so we will assume that there is some input $u$ into the system, and that we have some linear model that defines how that input changes the system. For example, if you press down on the accelerator in your car the car will accelerate. We will need a matrix $\\mathbf{B}$ to convert $u$ into the effect on the system. We add that into our equation:\n",
"\n",
"$$ f(\\mathbf{x}) = \\mathbf{Fx} + \\mathbf{Bu} + \\mathbf{w}$$\n",
"\n",
"And that's it. That is one of the equations that Kalman set out to solve, and he found a way to compute an optimal solution if we assume certain properties of $w$.\n",
"\n",
"However, we took advantage of something I left mostly unstated in the last chapter. We were able to provide a definition for $\\mathbf{F}$ because we were able to take advantage of the exact solution that Newtonian equations provide us. However, if you have an engineering background you will realize what a small class of problems that covers. If you don't, I will explain it next, and provide you with several ways to compute $\\mathbf{F}$ for arbitrary systems."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Converting the Multivariate Equations to the Univariate Case\n",
"\n",
"\n",
"As it turns out the Kalman filter equations are quite easy to deal with in one dimension, so let's do the mathematical proof. \n",
"\n",
"> **Note:** This section will provide you with a strong intuition into what the Kalman filter equations are actually doing. While this section is not strictly required, I recommend reading this section carefully as it should make the rest of the material easier to understand. It is not merely a proof of correctness that you would normally want to skip past! The equations look complicated, but they are actually doing something quite simple.\n",
"\n",
"Let's start with the predict step, which is slightly easier. Here are the multivariate equations.\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"\\mathbf{x} &= \\mathbf{F x} + \\mathbf{B u} \\\\\n",
"\\mathbf{P} &= \\mathbf{FPF}^\\mathsf{T} + \\mathbf{Q}\n",
"\\end{aligned}\n",
"$$\n",
"\n",
"The state $\\mathbf{x}$ only has one variable, so it is a $1\\times 1$ matrix. Our motion $\\mathbf{u}$ is also be a $1\\times 1$ matrix. Therefore, $\\mathbf{F}$ and $\\mathbf{B}$ must also be $1\\times 1$ matrices. That means that they are all scalars, and we can write\n",
"\n",
"$$x = Fx + Bu$$\n",
"\n",
"Here the variables are not bold, denoting that they are not matrices or vectors. \n",
"\n",
"Our state transition is simple - the next state is the same as this state, so $F=1$. The same holds for the motion transition, so, $B=1$. Thus we have\n",
"\n",
"$$x = x + u$$\n",
"\n",
"which is equivalent to the Gaussian equation from the last chapter\n",
"\n",
"$$ \\mu = \\mu_1+\\mu_2$$\n",
"\n",
"Hopefully the general process is clear, so now I will go a bit faster on the rest. Our other equation for the predict step is\n",
"\n",
"$$\\mathbf{P} = \\mathbf{FPF}^\\mathsf{T} + \\mathbf{Q}$$\n",
"\n",
"Again, since our state only has one variable $\\mathbf{P}$ and $\\mathbf{Q}$ must also be $1\\times 1$ matrix, which we can treat as scalars, yielding \n",
"\n",
"$$P = FPF^\\mathsf{T} + Q$$\n",
"\n",
"We already know $F=1$. The transpose of a scalar is the scalar, so $F^\\mathsf{T} = 1$. This yields\n",
"\n",
"$$P = P + Q$$\n",
"\n",
"which is equivalent to the Gaussian equation of \n",
"\n",
"$$\\sigma^2 = \\sigma_1^2 + \\sigma_2^2$$\n",
"\n",
"This proves that the multivariate equations are performing the same math as the univariate equations for the case of the dimension being 1."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Here our our multivariate Kalman filter equations for the update step.\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"\\textbf{y} &= \\mathbf{z} - \\mathbf{H x}\\\\\n",
"\\mathbf{K}&= \\mathbf{PH}^\\mathsf{T} (\\mathbf{HPH}^\\mathsf{T} + \\mathbf{R})^{-1} \\\\\n",
"\\mathbf{x}&=\\mathbf{x} +\\mathbf{K\\textbf{y}} \\\\\n",
"\\mathbf{P}&= (\\mathbf{I}-\\mathbf{KH})\\mathbf{P}\n",
"\\end{aligned}\n",
"$$\n",
"\n",
"As above, all of the matrices become scalars. $H$ defines how we convert from a position to a measurement. Both are positions, so there is no conversion, and thus $H=1$. Let's substitute in our known values and convert to scalar in one step. One final thing you need to know - division is scalar's analogous operation for matrix inversion, so we will convert the matrix inversion to division.\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"y &= z - x\\\\\n",
"K &=P / (P + R) \\\\\n",
"x &=x +Ky \\\\\n",
"P &= (1-K)P\n",
"\\end{aligned}\n",
"$$\n",
"\n",
"Before we continue with the proof, I want you to look at those equations to recognize what a simple concept these equations implement. The residual $y$ is nothing more than the measurement minus the previous state. The gain $K$ is scaled based on how certain we are about the last prediction vs how certain we are about the measurement. We choose a new state $x$ based on the old value of $x$ plus the scaled value of the residual. Finally, we update the uncertainty based on how certain we are about the measurement. Algorithmically this should sound exactly like what we did in the last chapter.\n",
"\n",
"So let's finish off the algebra to prove this. It's straightforward, and not at all necessary for you to learn unless you are interested. Feel free to skim ahead to the last paragraph in this section if you prefer skipping the algebra.\n",
"\n",
"Recall that the univariate equations for the update step are:\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"\\mu &=\\frac{\\sigma_1^2 \\mu_2 + \\sigma_2^2 \\mu_1} {\\sigma_1^2 + \\sigma_2^2}, \\\\\n",
"\\sigma^2 &= \\frac{1}{\\frac{1}{\\sigma_1^2} + \\frac{1}{\\sigma_2^2}}\n",
"\\end{aligned}\n",
"$$\n",
"\n",
"Here we will say that $\\mu_1$ is the state $x$, and $\\mu_2$ is the measurement $z$. That is entirely arbitrary, we could have chosen the opposite assignment. Thus it follows that that $\\sigma_1^2$ is the state uncertainty $P$, and $\\sigma_2^2$ is the measurement noise $R$. Let's substitute those in.\n",
"\n",
"$$ \\mu = \\frac{Pz + Rx}{P+R} \\\\\n",
"\\sigma^2 = \\frac{1}{\\frac{1}{P} + \\frac{1}{R}}\n",
"$$\n",
"\n",
"I will handle $\\mu$ first. The corresponding equation in the multivariate case is\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"x &= x + Ky \\\\\n",
"&= x + \\frac{P}{P+R}(z-x) \\\\\n",
"&= \\frac{P+R}{P+R}x + \\frac{Pz - Px}{P+R} \\\\\n",
"&= \\frac{Px + Rx + Pz - Px}{P+R} \\\\\n",
"&= \\frac{Pz + Rx}{P+R}\n",
"\\end{aligned}\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Now let's look at $\\sigma^2$. The corresponding equation in the multivariate case is\n",
"\n",
"$$ \n",
"\\begin{aligned}\n",
"P &= (1-K)P \\\\\n",
"&= (1-\\frac{P}{P+R})P \\\\\n",
"&= (\\frac{P+R}{P+R}-\\frac{P}{P+R})P \\\\\n",
"&= (\\frac{P+R-P}{P+R})P \\\\\n",
"&= \\frac{RP}{P+R}\\\\\n",
"&= \\frac{1}{\\frac{P+R}{RP}}\\\\\n",
"&= \\frac{1}{\\frac{R}{RP} + \\frac{P}{RP}} \\\\\n",
"&= \\frac{1}{\\frac{1}{P} + \\frac{1}{R}}\n",
"\\quad\\blacksquare\n",
"\\end{aligned}\n",
"$$\n",
"\n",
"So we have proven that the multivariate equations are equivalent to the univariate equations when we only have one state variable. I'll close this section by recognizing one quibble - I hand waved my assertion that $H=1$ and $F=1$. In general we know this is not true. For example, a digital thermometer may provide measurement in volts, and we need to convert that to temperature, and we use $H$ to do that conversion. I left that issue out to keep the explanation as simple and streamlined as possible. It is very straightforward to add that generalization to the equations above, redo the algebra, and still have the same results."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Converting Kalman Filter to a g-h Filter\n",
"\n",
"I've stated that the Kalman filter is a form of the g-h filter. It just takes some algebra to prove it. It's more straightforward to do with the one dimensional case, so I will do that. Recall \n",
"\n",
"$$\n",
"\\mu_{x}=\\frac{\\sigma_1^2 \\mu_2 + \\sigma_2^2 \\mu_1} {\\sigma_1^2 + \\sigma_2^2}\n",
"$$\n",
"\n",
"which I will make more friendly for our eyes as:\n",
"\n",
"$$\n",
"\\mu_{x}=\\frac{ya + xb} {a+b}\n",
"$$\n",
"\n",
"We can easily put this into the g-h form with the following algebra\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"\\mu_{x}&=(x-x) + \\frac{ya + xb} {a+b} \\\\\n",
"\\mu_{x}&=x-\\frac{a+b}{a+b}x + \\frac{ya + xb} {a+b} \\\\ \n",
"\\mu_{x}&=x +\\frac{-x(a+b) + xb+ya}{a+b} \\\\\n",
"\\mu_{x}&=x+ \\frac{-xa+ya}{a+b} \\\\\n",
"\\mu_{x}&=x+ \\frac{a}{a+b}(y-x)\\\\\n",
"\\end{aligned}\n",
"$$\n",
"\n",
"We are almost done, but recall that the variance of estimate is given by \n",
"\n",
"$${\\sigma_{x}^2} = \\frac{1}{ \\frac{1}{\\sigma_1^2} + \\frac{1}{\\sigma_2^2}}\\\\\n",
"= \\frac{1}{ \\frac{1}{a} + \\frac{1}{b}}\n",
"$$\n",
"\n",
"We can incorporate that term into our equation above by observing that\n",
"\n",
"$$ \n",
"\\begin{aligned}\n",
"\\frac{a}{a+b} &= \\frac{a/a}{(a+b)/a} = \\frac{1}{(a+b)/a} \\\\\n",
" &= \\frac{1}{1 + \\frac{b}{a}} = \\frac{1}{\\frac{b}{b} + \\frac{b}{a}} \\\\\n",
" &= \\frac{1}{b}\\frac{1}{\\frac{1}{b} + \\frac{1}{a}} \\\\\n",
" &= \\frac{\\sigma^2_{x'}}{b}\n",
" \\end{aligned}\n",
"$$\n",
"\n",
"We can tie all of this together with\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"\\mu_{x}&=x+ \\frac{a}{a+b}(y-x) \\\\\n",
"&= x + \\frac{\\sigma^2_{x'}}{b}(y-x) \\\\\n",
"&= x + g_n(y-x)\n",
"\\end{aligned}\n",
"$$\n",
"\n",
"where\n",
"\n",
"$$g_n = \\frac{\\sigma^2_{x}}{\\sigma^2_{y}}$$\n",
"\n",
"The end result is multiplying the residual of the two measurements by a constant and adding to our previous value, which is the *g* equation for the g-h filter. *g* is the variance of the new estimate divided by the variance of the measurement. Of course in this case g is not a constant as it varies with each time step as the variance changes. We can also derive the formula for *h* in the same way but I don't find this a particularly interesting derivation. The end result is\n",
"\n",
"$$h_n = \\frac{COV (x,\\dot{x})}{\\sigma^2_{y}}$$\n",
"\n",
"The takeaway point is that *g* and *h* are specified fully by the variance and covariances of the measurement and predictions at time *n*. In other words, we are picking a point between the measurement and prediction by a scale factor determined by the quality of each of those two inputs. That is all the Kalman filter is. "
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Compare Performance to Univariate Kalman Filter"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Let's implement a simple 1-D kalman filter using the Kalman filter from this chapter, and compare its output to the kalman filter from the previous chapter by plotting it. We will use a simple model of tracking an object that starts at x=0 and moves by 1 at each step. We will assume the arbitrary value 5 for the measurement noise and .02 for the process noise.\n",
"\n",
"First, let's implement the filter from the *Univariate Filter* chapter."
]
},
{
"cell_type": "code",
"execution_count": 43,
"metadata": {
"collapsed": true
},
"outputs": [],
"source": [
"from __future__ import division\n",
"import numpy as np\n",
"from numpy.random import randn\n",
"from filterpy.kalman import KalmanFilter\n",
"\n",
"# 1-D Kalman filter equations\n",
"def predict(pos, variance, movement, movement_variance):\n",
" return (pos + movement, variance + movement_variance)\n",
"\n",
"\n",
"def update (mu1, var1, mu2, var2):\n",
" mean = (var1*mu2 + var2*mu1) / (var1+var2)\n",
" variance = 1 / (1/var1 + 1/var2)\n",
" return (mean, variance)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Now, let's implement the same thing using the Kalman filter. I will implement it as a function that returns a KalmanFilter object so that you can run the analysis code several times with the KalmanFilter initialized to the same starting conditions each time."
]
},
{
"cell_type": "code",
"execution_count": 44,
"metadata": {
"collapsed": true
},
"outputs": [],
"source": [
"from filterpy.kalman import KalmanFilter\n",
"\n",
"def mkf_filter(R, Q):\n",
" f = KalmanFilter(dim_x=1, dim_z=1, dim_u=1)\n",
" f.P = 500.\n",
" f.H = np.array([[1.]])\n",
" f.F = np.array([[1.]])\n",
" f.B = np.array([[1.]])\n",
" f.Q = Q\n",
" f.R = R\n",
" \n",
" return f"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Finally, let's compare the two. I will plot the data from the 1-D Kalman filter as a blue line, and the output of the filter from this chapter as red dots. I wrote it as a function so you can easily modify the parameters and regenerate the plots."
]
},
{
"cell_type": "code",
"execution_count": 45,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"image/png": "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\ncmSj/SYmJjrVg//ud79jxIgRhIaG4uXlRb9+/fjLX/7S4Lr4+HgmTJjAp59+ypAhQ/Dy8uL5558H\nGq8xb0m/8fHxpKamsnHjRsxmM2az2elzVFVV8dRTT5GYmIjVaiUmJoZHH33U8YXgSrl2voKIiIiI\niMNzzz2Hm5sb8+bNo7i4mOeee44777yTL774wqnduSUwM2bMYP78+WRlZREdHe04/tVXX3HkyBF+\n+ctfOo4tXbqUyZMnM336dEwmE++88w733XcftbW1PPDAA079Hz58mKlTp3L//fdz3333ERcX1+j9\nW9rvSy+9xM9//nP8/Pz41a9+BYCvry8AhmEwZcoUNm3axP3330/v3r1JTU3llVdeYd++fXz00UeX\n+qO9aArmIiIiItegqqoqtm/f7igVCQoKYu7cuezbt4+kpCRHu3NrzKdPn85vfvMb3nrrLR5++GHH\n8TVr1uDu7s4Pf/hDx7FDhw5htVodv58zZw7f+973WLJkiVMwNwyDI0eO8N577zFp0qQLjrsl/X7/\n+9/nV7/6FWFhYcycOdPp+tWrV/PRRx+xYcMGbrzxRsfxQYMGcdddd/Hxxx8zbty4C46jLSiYi4iI\niDThgy9W8+GXa9qs/1uGTOPWoTParP/m3H333U712yNGjADg2LFjTsH8XF27diU5OZk1a9Y4BfM3\n33yTm2++meDgYMexM+G5pqaGsrIy7HY7o0eP5uOPP6asrAw/Pz9H29jY2BaF8tb225g333yT7t27\n07t3b/Lz8x3HR44ciclkYv369QrmIiIiItJ2zi8JObdcBOpnzAGKioqa7Wf69On88pe/JD09nc6d\nO/P555+TkZHBwoULndq9++67/Pa3v+Wbb76hrq7OaRwlJSVOAbpLly4t/hyt6bcxBw8eJC0tjdDQ\n0AbnTCYTeXl5LR6LqymYi4iIiHRwZ2aRm3p5saKiwqn8A8BisTTa9kLLI06bNo158+axZs0ax/9a\nrVamTJniaLNlyxamTJnCyJEjefXVV4mKisLDw4P333+fF198Ebvd7tSnl5fXBT/jxfTbGLvdTlJS\nEi+99FKj56Oiolo0lragYC4iIiLShFuHzrhipSat0blzZwAOHDjg+PUZdXV1HD58mNGjR7vkXjEx\nMQwbNow1a9bwy1/+krfeeotbbrnFaab6H//4B97e3qxbtw4PDw/H8U8//fSS7t2afptat71bt258\n9dVX3HTTTZc0lrag5RJFREREOrixY8fi4eHBsmXLGswav/766xQXFzNx4sSL6ruxgDt9+nR2797N\nX/7yF06ePMn06dOdzp+ZjT+31KSoqIi//vWvl7STaGv69fHxobCwsEEf06ZNIzc3l2XLljU4V1VV\nxenTpy96fJdKwVxERESkgwsNDWX+/Pm89957jBgxgsWLF/PKK68wa9YsZs+ezZAhQy56B8zGSlum\nTp2KxWLh0UcfxcfHh8mTJzudv+2226ioqGDcuHH86U9/YtGiRSQnJxMZGdnqnUTPbd+afq+//nq+\n/fZbFi5cyOrVq/nXv/4FwF133cXkyZOZM2cO06dP5w9/+AO///3vmTNnDrGxsezatatV43Mllwbz\nBQsWOBZxP/Pf+XU6CxYsIDo6Gm9vb8aMGUNqaqorhyAiIiJyTXryySdZtWoVZrOZZ555hkcffZQv\nvviCxx9/nE8//dRpBZaWzlqbTKZG24aFhTF69GjKy8uZPHlygxrxUaNGsXLlSgoLC3nkkUdYsWIF\nDz30EA899FCD/poby/n3b02/8+fPZ/LkybzwwgvceeedzJ0719Hn2rVref7550lNTWXevHksWLCA\n7du3M2fOHPr27duin01bMBmt/drSjAULFvDmm2+yYcMGxzGLxUJISAgAixcv5plnnmHlypV0796d\nhQsXsmXLFtLS0hyLvgOUlJQ4fh0QEOCq4clVZufOnUD9uqMiTdFzIi2h5+TaYbPZGrwEKdIazT1D\nl5phXV7KYrFYCAsLc/x3JpQbhsHSpUt54oknmDJlCklJSaxcuZKysjJWrVrl6mGIiIiIiHQoLg/m\nR48eJTo6mi5dujBjxgyOHTsG1C9Wn5uby/jx4x1trVYrI0eOZNu2ba4ehoiIiIhIh+LSYD506FBW\nrlzJRx99xPLly8nJyWHYsGEUFhaSk5MDQHh4uNM1YWFhjnMiIiIiItcql65jfssttzh+3adPH264\n4QYSEhJYuXIlQ4YMafK65or+z9T9iTRFz4i0hJ4TaQk9J1e/zp07q8ZcLklZWRl79+5t9FxiYuIl\n9d2myyV6e3uTlJTE4cOHiYyMBCA3N9epTW5uLhEREW05DBERERGRdq9Nd/602Wzs37+fm266iYSE\nBCIiIli3bh3JycmO81u2bGHJkiVN9qE35KUpWkVBWkLPibSEnpNrh81mu9JDkA7Oz8+vyT8rzl2V\n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\n",
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"image/png": "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\nPp8vWLBATz31lP74xz9q8+bNio+P13XXXafS0tIgVYzWtnbtWs2YMUMbN27U6tWrZbPZdO211+rU\nqVPefegnSElJ0ZNPPqmtW7fq008/1bhx4zRx4kRlZ2dLoo+gvo8//liLFi3S4MGDff7bQ1+BJPXr\n10/5+fnenx07dng/87uPmC00YsQIc/r06T7b0tPTzZ///OctPTTCQMeOHc0lS5Z433s8HjMxMdF8\n4oknvNvKy8vNTp06mS+88EIwSkQbUFpaalqtVvMf//iHaZr0EzSsW7du5osvvkgfQT1FRUVmnz59\nzMzMTHPs2LHm/fffb5omf56gxuzZs82BAwde8LOW9JEWjUjz+HA014EDB3Ts2DGfPhMZGanRo0fT\nZ9qx06dPy+PxqGvXrpLoJ6jP7XZr+fLlqqio0OjRo+kjqGf69Om69dZbNWbMGJl1bv+ir6BWTk6O\nunfvrt69e2vKlCk6cOCApJb1kRY92ZDHh6O5avvFhfrM0aNHg1ES2oAHH3xQw4YN08iRIyXRT3DO\njh07NHLkSFVWVioqKkpvvPGGLr/8cu9/3OgjkKRFixYpJydHS5culSSfaR38eQJJuvrqq7VkyRL1\n69dPx44d07x58zRq1Cjt3LmzRX0kII8IB/xx/lxqtA8PPfSQNmzYoKysrCb1AfpJ+9KvXz9t375d\nxcXFevPNNzV58mStWbPmom3oI+3LF198occee0xZWVmyWq2SJNM0fUalG0JfaT+++c1vel8PHDhQ\nI0eOVK9evbRkyRJdddVVDbZrrI+0aGoHjw9HcyUmJkrSBftM7WdoP2bOnKkVK1Zo9erVSktL826n\nn6CW3W5X7969NWzYMD3xxBO6+uqrtXDhQu9/Y+gj2LhxowoLCzVgwADZ7XbZ7XatW7dOzz33nBwO\nh2JjYyXRV+ArOjpaAwYM0L59+1r050mLgjSPD0dz9erVS4mJiT59pqKiQllZWfSZdubBBx/0hui+\nffv6fEY/QUPcbrc8Hg99BF633HKLPv/8c2VnZys7O1vbtm1TRkaGpkyZom3btik9PZ2+gnoqKiq0\ne/duJSUltejPE+ucOXPmtKSQzp07a/bs2UpOTlZUVJTmzZunrKwsLV68mMeGt1NlZWXatWuX8vPz\n9dJLL2nQoEFyOp2qrq6W0+mU2+3Wb37zG11++eVyu9166KGHdOzYMb344otyOBzBLh+t4L777tOr\nr76qN998Uz169FBpaalKS0tlGIYcDocMw6CfQLNmzVJkZKQ8Ho8OHz6s3//+91q6dKmefPJJ9enT\nhz4CSTU3hcXFxXl/4uPj9frrr6tnz56aOnUqf55AkvTTn/7U++fJnj17NGPGDOXk5OiFF15oWTa5\nFEuKPPfcc2ZaWpoZERFhZmRkmOvXr78Uh0WIWrNmjWkYhmkYhmmxWLyvp02b5t1nzpw5ZlJSkhkZ\nGWmOHTvW3LlzZxArRms7v2/U/jz++OM++9FP2re77rrL7NmzpxkREWHGx8eb1113nfnBBx/47EMf\nwYXUXf6uFn2lfZs8ebKZnJxsOhwOs3v37ub3vvc9c/fu3T77+NNHeEQ4AAAA4IdL8ohwAAAAoL0h\nSAMAAAB+IEgDAAAAfiBIAwAAAH4gSAMAAAB+IEgDAAAAfiBIAwAAAH4gSAMAAAB+IEgDAAAAfvh/\nXjlj+pIx5RgAAAAASUVORK5CYII=\n",
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"import matplotlib.pyplot as plt\n",
"\n",
"def plot_kf_compare(x0, p0, R, Q, move):\n",
" # storage for filter output\n",
" x_uni, x_kf = [], []\n",
" p1, p2 = [], []\n",
"\n",
" # initialize the filters\n",
" f = mkf_filter(R, Q)\n",
" f.x[0] = 0.\n",
" f.P[0, 0] = p0\n",
" pos = (x0, p0)\n",
" for i in range(50):\n",
" z = i*move + randn()\n",
" pos = update(pos[0], pos[1], z, R)\n",
" f.update(z)\n",
"\n",
" x_uni.append(pos[0])\n",
" x_kf.append(f.x[0])\n",
"\n",
" p1.append(pos[1])\n",
" p2.append(f.P[0, 0])\n",
"\n",
" u = move + randn()\n",
" pos = predict(pos[0], pos[1], u, Q)\n",
" f.predict(u=u)\n",
"\n",
" plt.scatter(range(len(x_kf)), x_kf, c='r', s=80, label='Kalman')\n",
" plt.title('State')\n",
" plt.plot(x_uni, label='Univariate')\n",
" plt.xlim([0, 50])\n",
" plt.legend()\n",
"\n",
" plt.figure()\n",
" plt.plot(p1)\n",
" plt.scatter(range(len(x_kf)), p2, c='r', s=80)\n",
" plt.title('Variance')\n",
" plt.xlim([0, 50])\n",
" plt.show()\n",
" \n",
"plot_kf_compare(x0=0., p0=500., R=5., Q=.2, move=1.)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"As you can see, both filters produce the same results. Feel free to vary the initial guess, the measurement noise, and the process noise; so long as you make the same changes to both filters the output should be the same. This is a solid demonstration, albeit not a rigorous proof, that both filters in fact implement the same math for the 1-D case. "
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Modeling Dynamic Systems"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Modeling dynamic systems is properly the topic of at least one undergraduate course in mathematics. To an extent there is no substitute for a few semesters of ordinary and partial differential equations. If you are a hobbyist, or trying to solve one very specific filtering problem at work you probably do not have the time and/or inclination to devote a year or more to that education.\n",
"\n",
"However, I can present enough of the theory to allow us to create the system equations for many different Kalman filters, and give you enough background to at least follow the mathematics in the literature. My goal is to get you to the stage where you can read a Kalman filtering book or paper and understand it well enough to implement the algorithms. The background math is deep, but we end up using a few simple techniques over and over again in practice.\n",
"\n",
"I struggle a bit with the proper way to present this material. If you have not encountered this math before I fear reading this section will not be very profitable for you. In the **Extended Kalman Filter** chapter I take a more ad-hoc way of presenting this information where I expose a problem that the KF needs to solve, then provide the math without a lot of supporting theory. This gives you the motivation behind the mathematics at the cost of not knowing why the math I give you is correct. On the other hand, the following section gives you the math, but somewhat divorced from the specifics of the problem we are trying to solve. Only you know what kind of learner your are. If you like the presentation of the book so far (practical first, then the math) you may want to wait until you read the **Extended Kalman Filter** before \n",
"In particular, if your intent is to work with Extended Kalman filters (a very prelevant form of nonlinear Kalman filtering) you will need to understand this math at least at the level I present it. If that is not your intent this section may still prove to be beneficial if you need to simulate a nonlinear system in order to test your filter.\n",
"\n",
"Let's lay out the problem and discuss what the solution will be. We model *dynamic systems* with a set of first order *differential equations*. This should not be a surprise as calculus is the math of things that vary. For example, we say that velocity is the derivative of distance with respect to time\n",
"\n",
"$$\\mathbf{v}= \\frac{d \\mathbf{x}}{d t} = \\dot{\\mathbf{x}}$$\n",
"\n",
"where $\\dot{\\mathbf{x}}$ is the notation for the derivative of $\\mathbf{x}$ with respect to t.\n",
"\n",
"We need to use these equations for the predict step of the Kalman filter. Given the state of the system at time $t$ we want to predict its state at time $t + \\Delta t$. The Kalman filter matrices do not accept differential equations, so we need a mathematical technique that will find the solution to those equations at each time step. In general it is extremely difficult to find analytic solutions to systems of differential equations, so we will normally use *numerical* techniques to find accurate approximations for these equations."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Why This is Hard\n",
"\n",
"We model dynamic systems with a set of first order differential equations. For example, we already presented the Newtonian equation\n",
"\n",
"$$\\mathbf{v}=\\dot{\\mathbf{x}}$$\n",
"\n",
"where $\\dot{\\mathbf{x}}$ is the notation for the derivative of $\\mathbf{x}$ with respect to t, or $\\frac{d \\mathbf{x}}{d t}$.\n",
"\n",
"In general terms we can then say that a dynamic system consists of equations of the form\n",
"\n",
"$$ g(t) = \\dot{x}$$\n",
"\n",
"if the behavior of the system depends on time. However, if the system is *time invariant* the equations are of the form\n",
"\n",
"$$ f(x) = \\dot{x}$$\n",
"\n",
"What does *time invariant* mean? Consider a home stereo. If you input a signal $x$ into it at time $t$, it will output some signal $f(x)$. If you instead make the input at a later time $t + \\Delta t$ the output signal will still be exactly the same except shifted in time. This is different from, say, an aircraft. If you make a control input to the aircraft at a later time it's behavior will be different because it will have burned additional fuel (and thus lost weight), drag may be different due to being at a different altitude, and so on.\n",
"\n",
"We can solve these equations by integrating each side. The time variant equation is very straightforward. We essentially solved this problem with the Newtonian equations above, but let's be explicit and write it out. Starting with $$\\dot{\\mathbf{x}}=\\mathbf{v}$$ we get the expected\n",
"\n",
"$$ \\int \\dot{\\mathbf{x}}\\mathrm{d}t = \\int \\mathbf{v} \\mathrm{d}t\\\\\n",
"x = vt + x_0$$\n",
"\n",
"However, integrating the time invariant equation is not so straightforward. \n",
"\n",
"$$ \\dot{x} = f(x) \\\\\n",
"\\frac{dx}{dt} = f(x)\n",
"$$ \n",
"\n",
"Using the *separation of variables* techniques, we divide by $f(x)$ and move the $dx$ term to the right so we can integrate each side:\n",
"\n",
"$$\n",
"\\int^x_{x_0} \\frac{1}{f(x)} dx = \\int^t_{t_0} dt\\\\\n",
"$$\n",
"\n",
"If we let the solution to the left hand side by named $F(x)$, we get\n",
"\n",
"$$F(x) - f(x_0) = t-t_0$$\n",
"\n",
"We then solve for x with\n",
"\n",
"$$F(x) = t - t_0 + F(x_0) \\\\\n",
"x = F^{-1}[t-t_0 + F(x_0)]$$\n",
"\n",
"In other words, we need to find the inverse of $F$. This is not at all trivial, and a significant amount of course work in a STEM education is devoted to finding tricky, analytic solutions to this problem, backed by several centuries of research. \n",
"\n",
"In the end, however, they are tricks, and many simple forms of $f(x)$ either have no closed form solution, or pose extreme difficulties. Instead, the practicing engineer turns to numerical methods to find a solution to her problems. I would suggest that students would be better served by learning fewer analytic mathematical tricks and instead focusing on learning numerical methods, but that is the topic for another book."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Finding the Fundamental Matrix for Time Invariant Systems"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
" If you already have the mathematical training in solving partial differential equations you may be able to put it to use; I am not assuming that sort of background. So let me skip over quite a bit of mathematics and present the typical numerical techniques used in Kalman filter design. \n",
"\n",
"First, we express the system equations in state-space form (i.e. using linear algebra equations) with\n",
"\n",
"$$ \\dot{\\mathbf{x}} = \\mathbf{Fx}$$\n",
"\n",
"Now we can assert that we want to find the fundamental matrix $\\Phi$ that propagates the state with the equation\n",
"\n",
"$$x(t) = \\Phi(t-t_0)x(t_0)$$\n",
"\n",
"which we can equivalently write as\n",
"\n",
"$$x(t_k) = \\Phi(\\Delta t)x(t_{k-1})$$\n",
"\n",
"In other words, we want to compute the value of $x$ at time $t$ by multiplying its previous value by some matrix $\\Phi$. This is not trivial to do because the original equations do not include time."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Taylor Series Expansion\n",
"\n",
"Broadly speaking there are three ways to find $\\Phi$ that are used in Kalman filters. The technique most often used with Kalman filters is to use a Taylor-series expansion. The Taylor series represents a function as an infinite sum of terms. The terms are linear, even for a nonlinear function, so we can express any arbitrary nonlinear function using linear algebra. The cost of this choice is that unless we use an infinite number of terms (and who has time for that these days) the value we compute will be approximate rather than exact.\n",
"\n",
"For the Kalman filter we will be using a form of the series that uses a matrix. But before we do that, let's work through a couple of examples with real functions since real functions are easier to plot and reason about. The Taylor series for either are nearly identical, so this is a good first step.\n",
"For a real (or complex) function the Taylor series of a function $f(x)$ evaluated at $a$ is defined as \n",
"\n",
"$$ \\Phi(t) = e^{\\mathbf{F}t} = \\mathbf{I} + \\mathbf{F}t + \\frac{(\\mathbf{F}t)^2}{2!} + \\frac{(\\mathbf{F}t)^3}{3!} + ... $$\n",
"\n",
"This is easy to compute, and thus is the typical approach used in Kalman filter design when the filter is reasonably small. If you are wondering where $e$ came from, I point you to the Wikipedia article on the matrix exponential [1]. Here the important point is to recognize the very simple and regular form this equation takes. \n",
"\n",
"Before applying it to a Kalman filter, lets do the Taylor expansion of a math function since this is much easier to visualize than a matrix. I choose sin(x). The Taylor series for a real or complex function f(x) about x=a is\n",
"\n",
"$$f(x) = \\sum_{n=0}^\\infty\\frac{f^{(n)}(a)}{x!}(x-a)^n$$\n",
"\n",
"where $f^{n}$ is the nth derivative of f. To compute the Taylor series for $f(x)=sin(x)$ at $x=0$ Let's first work out the terms for f.\n",
"\n",
"$$\\begin{aligned}\n",
"f^{0}(x) &= sin(x) ,\\ \\ &f^{0}(0) &= 0 \\\\\n",
"f^{1}(x) &= cos(x),\\ \\ &f^{1}(0) &= 1 \\\\\n",
"f^{2}(x) &= -sin(x),\\ \\ &f^{2}(0) &= 0 \\\\\n",
"f^{3}(x) &= -cos(x),\\ \\ &f^{3}(0) &= -1 \\\\\n",
"f^{4}(x) &= sin(x),\\ \\ &f^{4}(0) &= 0 \\\\\n",
"f^{5}(x) &= cos(x),\\ \\ &f^{5}(0) &= 1\n",
"\\end{aligned}\n",
"$$\n",
"\n",
"Now we can substitute these values into the equation.\n",
"\n",
"$$f(x) = \\frac{0}{0!}(x)^0 + \\frac{1}{1!}(x)^1 + \\frac{0}{2!}(x)^2 + \\frac{-1}{3!}(x)^3 + \\frac{0}{4!}(x)^4 + \\frac{-1}{5!}(x)^5 + ... $$\n",
"\n",
"And let's test this with some code:"
]
},
{
"cell_type": "code",
"execution_count": 46,
"metadata": {
"collapsed": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"estimate of sin(.3) is 0.30452025\n",
"exact value of sin(.3) is 0.295520206661\n"
]
}
],
"source": [
"x = .3\n",
"estimate = x + x**3/6 + x**5/120\n",
"exact = np.sin(.3)\n",
"\n",
"print('estimate of sin(.3) is', estimate)\n",
"print('exact value of sin(.3) is', exact)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"This is not bad for only three terms. If you are curious, go ahead and implement this as a Python function to compute the series for an arbitrary number of terms. But I will forge ahead to the matrix form of the equation. \n",
"\n",
"Let's consider tracking an object moving in a vacuum. In one dimesion the differential equation for motion with zero acceleration is\n",
"\n",
"$$ v = \\dot{x}\\\\a=\\ddot{x} =0,$$\n",
"\n",
"which we can put in state space matrix form as\n",
"\n",
"$$\\begin{bmatrix}\\dot{x} \\\\ \\ddot{x}\\end{bmatrix} =\\begin{bmatrix}0&1\\\\0&0\\end{bmatrix} \\begin{bmatrix}x \\\\ \\dot{x}\\end{bmatrix}$$\n",
"\n",
"This is a first order differential equation, so we can set $\\mathbf{F}=\\begin{bmatrix}0&1\\\\0&0\\end{bmatrix}$ and solve the following equation.\n",
"\n",
"$$\\Phi(t) = e^{\\mathbf{F}t} = \\mathbf{I} + \\mathbf{F}t + \\frac{(\\mathbf{F}t)^2}{2!} + \\frac{(\\mathbf{F}t)^3}{3!} + ... $$\n",
"\n",
"If you perform the multiplication you will find that $\\mathbf{F}^2=\\begin{bmatrix}0&0\\\\0&0\\end{bmatrix}$, which means that all higher powers of $\\mathbf{F}$ are also $\\mathbf{0}$. This makes the computation very easy.\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"\\Phi(t) &=\\mathbf{I} + \\mathbf{F}t + \\mathbf{0} \\\\\n",
"&= \\begin{bmatrix}1&0\\\\0&1\\end{bmatrix} + \\begin{bmatrix}0&1\\\\0&0\\end{bmatrix}t\\\\\n",
"&= \\begin{bmatrix}1&t\\\\0&1\\end{bmatrix}\n",
"\\end{aligned}$$\n",
"\n",
"We plug this into $x(t_k) = \\Phi(\\Delta t)x(t_{k-1})$ to get\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"x(t_k) &= \\Phi(\\Delta t)x(t_{k-1}) \\\\\n",
"x^- &= \\Phi(\\Delta t)x \\\\\n",
"x^- &=\\begin{bmatrix}1&\\Delta t\\\\0&1\\end{bmatrix}x \\\\\n",
"\\begin{bmatrix}x \\\\ \\dot{x}\\end{bmatrix}^- &=\\begin{bmatrix}1&\\Delta t\\\\0&1\\end{bmatrix}\\begin{bmatrix}x \\\\ \\dot{x}\\end{bmatrix}\n",
"\\end{aligned}$$\n",
"\n",
"This should look very familiar to you! This is the equation we used in the **Multivariate Kalman Filter** chapter to track a moving object.\n",
"\n",
"$$\n",
"{\\begin{bmatrix}x\\\\\\dot{x}\\end{bmatrix}}^- =\\begin{bmatrix}1&t \\\\ 0&1\\end{bmatrix} \\begin{bmatrix}x \\\\ \\dot{x}\\end{bmatrix}\n",
"$$\n",
"\n",
"We derived this equation in that chapter by using techniques that are much easier to understand. The advantage of the Taylor series expansion is that we can use it for any arbitrary set of differential equations which are time invariant. \n",
"\n",
"Time invariant? This means equations that do not depend on time. For example, $f(x) = sin(t)t$ is not time invariant; the value will be different at different times due to the multiplication by t. On the other hand $f(x) = sin(t)*3$ is time invariant. $x(t)$ is dependent on time, but that is allowed. This is because to be time invariant it must be true that if $f(t) = x(t)$ then $f(t+\\Delta t) = x(t+\\Delta t)$. This will be true for the second equation, but not the first.\n",
"\n",
"However, we often use a Taylor expansion even when the equations are not time invariant. The answer will still be reasonably accurate so long as the time step is short and the system is nearly constant over that time step."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Linear Time Invariant Theory\n",
"\n",
"*Linear Time Invariant Theory*, also known as LTI System Theory, gives us a way to find $\\Phi$ using the inverse Laplace transform. You are either nodding your head now, or completely lost. Don't worry, I will not be using the Laplace transform in this book except in this paragraph, as the computation is quite difficult to perform in practice. LTI system theory tells us that \n",
"\n",
"$$ \\Phi(t) = \\mathcal{L}^{-1}[(s\\mathbf{I} - \\mathbf{F})^{-1}]$$\n",
"\n",
"I have no intention of going into this other than to say that the inverse Laplace transform converts a signal into the frequency (time) domain, but finding a solution to the equation above is non-trivial. If you are interested, the Wikipedia article on LTI system theory provides an introduction [2]."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Numerical Solutions\n",
"Finally, there are numerical techniques to find $\\Phi$. As filters get larger finding analytical solutions becomes very tedious (though packages like SymPy make it easier). C. F. van Loan [3] has developed a technique that finds both $\\Phi$ and $Q$ numerically.\n",
"\n",
"I have implemented van Loan's method in `FilterPy`. You may use it as follows:\n",
"\n",
" from filterpy.common import van_loan_discretization\n",
" \n",
" F = np.array([[0,1],[-1,0]], dtype=float)\n",
" G = np.array([[0.],[2.]]) # white noise scaling\n",
" phi, Q = van_loan_discretization(F, G, dt=0.1)\n",
" \n",
"See the docstring documentation for van_loan_discretization for more information, which I have embedded below."
]
},
{
"cell_type": "code",
"execution_count": 47,
"metadata": {
"collapsed": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Help on function van_loan_discretization in module filterpy.common.discretization:\n",
"\n",
"van_loan_discretization(F, G, dt)\n",
" Discretizes a linear differential equation which includes white noise\n",
" according to the method of C. F. van Loan [1]. Given the continuous\n",
" model\n",
" \n",
" x' = Fx + Gu\n",
" \n",
" where u is the unity white noise, we compute and return the sigma and Q_k\n",
" that discretizes that equation.\n",
" \n",
" \n",
" **Example**::\n",
" \n",
" Given y'' + y = 2u(t), we create the continuous state model of\n",
" \n",
" x' = | 0 1| * x + |0|*u(t)\n",
" |-1 0| |2|\n",
" \n",
" and a time step of 0.1:\n",
" \n",
" \n",
" >>> F = np.array([[0,1],[-1,0]], dtype=float)\n",
" >>> G = np.array([[0.],[2.]])\n",
" >>> phi, Q = van_loan_discretization(F, G, 0.1)\n",
" \n",
" >>> phi\n",
" array([[ 0.99500417, 0.09983342],\n",
" [-0.09983342, 0.99500417]])\n",
" \n",
" >>> Q\n",
" array([[ 0.00133067, 0.01993342],\n",
" [ 0.01993342, 0.39866933]])\n",
" \n",
" (example taken from Brown[2])\n",
" \n",
" \n",
" **References**\n",
" \n",
" [1] C. F. van Loan. \"Computing Integrals Involving the Matrix Exponential.\"\n",
" IEEE Trans. Automomatic Control, AC-23 (3): 395-404 (June 1978)\n",
" \n",
" [2] Robert Grover Brown. \"Introduction to Random Signals and Applied\n",
" Kalman Filtering.\" Forth edition. John Wiley & Sons. p. 126-7. (2012)\n",
"\n"
]
}
],
"source": [
"from filterpy.common import van_loan_discretization\n",
"help(van_loan_discretization)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Forming First Order Equations from Higher Order Equations"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"In the sections above I spoke of *first order* differential equations; these are equations with only first derivatives. However, physical systems often require second or higher order equations. Any higher order system of equations can be converted to a first order set of equations by defining extra variables for the first order terms and then solving. Let's do an example. \n",
"\n",
"Given the system $\\ddot{x} - 6\\dot{x} + 9x = t$ find the first order equations.\n",
"\n",
"The first step is to isolate the highest order term onto one side of the equation .\n",
"\n",
"$$\\ddot{x} = 6\\dot{x} - 9x + t$$\n",
"\n",
"We define two new variables:\n",
"\n",
"$$ x_1(t) = x \\\\\n",
"x_2(t) = \\dot{x}\n",
"$$\n",
"\n",
"Now we will substitute these into the original equation and solve, giving us a set of first order equations in terms of these new variables.\n",
"\n",
"First, we know that $\\dot{x}_1 = x_2$ and that $\\dot{x}_2 = \\ddot{x}$. Therefore\n",
"\n",
"$$\\begin{aligned}\n",
"\\dot{x}_2 &= \\ddot{x} \\\\\n",
" &= 6\\dot{x} - 9x + t\\\\\n",
" &= 6x_2-9x_1 + t\n",
"\\end{aligned}$$\n",
"\n",
"Therefore our first order system of equations is\n",
"\n",
"$$\\begin{aligned}\\dot{x}_1 &= x_2 \\\\\n",
"\\dot{x}_2 &= 6x_2-9x_1 + t\\end{aligned}$$\n",
"\n",
"If you practice this a bit you will become adept at it. Isolate the highest term, define a new variable and its derivatives, and then substitute."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"**ORPHAN TEXT**\n",
"\n",
"I'll address the computation of $\\mathbf{Q}$ in the next paragraph. For now you can see that as time passes our uncertainty in velocity is growing slowly. It is a bit harder to see, but if you compare this graph to the previous one the uncertainty in position also increased.\n",
"\n",
"We have not given the math for computing the elements of $\\mathbf{Q}$ yet, but if you suspect the math is sometimes difficult you would be correct. One of the problems is that we are usually modeling a *continuous* system - the behavior of the system is changing at every instant, but the Kalman filter is *discrete*. That means that we have to somehow convert the continuous noise of the system into a discrete value, which usually involves calculus. There are other difficulties I will not mention now.\n",
"\n",
"However, for the class of problems we are solving in this chapter (*discretized continuous-time kinematic filters*) we can directly compute the state equations for moving objects by using Newton's equations.\n",
"\n",
"For these kinds of problems we can rely on precomputed forms for $\\mathbf{Q}$. We will learn how to derive these matrices in the next chapter. For now I present them without proof. If we assume that for each time period the acceleration due to process noise is constant and uncorrelated, we get the following.\n",
"\n",
"For constant velocity the form is\n",
"\n",
"$$\\begin{bmatrix}\n",
"\\frac{1}{4}{\\Delta t}^4 & \\frac{1}{2}{\\Delta t}^3 \\\\\n",
"\\frac{1}{2}{\\Delta t}^3 & \\Delta t^2\n",
"\\end{bmatrix}\\sigma^2\n",
"$$\n",
"\n",
"and for constant acceleration we have\n",
"\n",
"$$\\begin{bmatrix}\n",
"\\frac{1}{4}{\\Delta t}^4 & \\frac{1}{2}{\\Delta t}^3 & \\frac{1}{2}{\\Delta t}^2 \\\\\n",
"\\frac{1}{2}{\\Delta t}^3 & {\\Delta t}^2 & \\Delta t \\\\\n",
"\\frac{1}{2}{\\Delta t}^2 & \\Delta t & 1\n",
"\\end{bmatrix} \\sigma^2\n",
"$$\n",
"\n",
"It general it is not true that acceleration will be constant and uncorrelated, but this is still a useful approximation for moderate time period, and will suffice for this chapter. Fortunately you can get a long way with approximations and simulation. Let's think about what these matrices are implying. We are trying to model the effects of *process noise*, such as the wind buffeting the flight of a thrown ball. Variations in wind will cause changes in acceleration, and so the effect on the acceleration is large. However, the effects on velocity and position are proportionally smaller. In the matrices, the acceleration term is in the lower right, and this is the largest value. **A good rule of thumb is to set $\\sigma$ somewhere from $\\frac{1}{2}\\Delta a$ to $\\Delta a$, where $\\Delta a$ is the maximum amount that the acceleration will change between sample periods**. In practice we pick a number, run simulations on data, and choose a value that works well. \n",
"\n",
"The filtered result will not be optimal, but in my opinion the promise of optimal results from Kalman filters is mostly wishful thinking. Consider, for example, tracking a car. In that problem the process noise would include things like potholes, wind gusts, changing drag due to turning, rolling down windows, and many more factors. We cannot realistically model that analytically, and so in practice we work out a simplified model, compute $\\mathbf{Q}$ based on that simplified model, and then add *a bit more* to $\\small\\mathbf{Q}$ in hopes of taking the incalculable factors into account. Then we use a lot of simulations and trial runs to see if the filter behaves well; if it doesn't we adjust $\\small\\mathbf{Q}$ until the filter performs well. In this chapter we will focus on forming an intuitive understanding on how adjusting $\\small\\mathbf{Q}$ affects the output of the filter. In the Kalman Filter Math chapter we will discuss the analytic computation of $\\small\\mathbf{Q}$, and also provide code that will compute it for you.\n",
"\n",
"For now we will import the code from the `FilterPy` module, where it is already implemented. I will import it and call help on it so you can see the documentation for it."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Design of the Process Noise Matrix"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"**Author's note: this section contains some of the more challenging math in this book. Please bear with it, as few books cover this well, and an accurate design is imperative for good filter performance. At the end I present Python functions from FilterPy which will compute the math for you for common scenarios.**\n",
"\n",
"In general the design of the $\\mathbf{Q}$ matrix is among the most difficult aspects of Kalman filter design. This is due to several factors. First, the math itself is somewhat difficult and requires a good foundation in signal theory. Second, we are trying to model the noise in something for which we have little information. For example, consider trying to model the process noise for a baseball. We can model it as a sphere moving through the air, but that leave many unknown factors - the wind, ball rotation and spin decay, the coefficient of friction of a scuffed ball with stitches, the effects of wind and air density, and so on. I will develop the equations for an exact mathematical solution for a given process model, but since the process model is incomplete the result for $\\mathbf{Q}$ will also be incomplete. This has a lot of ramifications for the behavior of the Kalman filter. If $\\mathbf{Q}$ is too small than the filter will be overconfident in it's prediction model and will diverge from the actual solution. If $\\mathbf{Q}$ is too large than the filter will be unduly influenced by the noise in the measurements and perform sub-optimally. In practice we spend a lot of time running simulations and evaluating collected data to try to select an appropriate value for $\\mathbf{Q}$. But let's start by looking at the math.\n",
"\n",
"\n",
"Let's assume a kinematic system - some system that can be modeled using Newton's equations of motion. We can make a few different assumptions about this process. \n",
"\n",
"We have been using a process model of\n",
"\n",
"$$ f(\\mathbf{x}) = \\mathbf{Fx} + \\mathbf{w}$$\n",
"\n",
"where $\\mathbf{w}$ is the process noise. Kinematic systems are *continuous* - their inputs and outputs can vary at any arbitrary point in time. However, our Kalman filters are *discrete*. We sample the system at regular intervals. Therefore we must find the discrete representation for the noise term in the equation above. However, this depends on what assumptions we make about the behavior of the noise. We will consider two different models for the noise."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Continuous White Noise Model"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We model kinematic systems using Newton's equations. So far in this book we have either used position and velocity, or position,velocity, and acceleration as the models for our systems. There is nothing stopping us from going further - we can model jerk, jounce, snap, and so on. We don't do that normally because adding terms beyond the dynamics of the real system actually degrades the solution. \n",
"\n",
"Let's say that we need to model the position, velocity, and acceleration. We can then assume that acceleration is constant. Of course, there is process noise in the system and so the acceleration is not actually constant. In this section we will assume that the acceleration changes by a continuous time zero-mean white noise $w(t)$. In other words, we are assuming that velocity is acceleration changing by small amounts that over time average to 0 (zero-mean). \n",
"\n",
"Since the noise is changing continuously we will need to integrate to get the discrete noise for the discretization interval that we have chosen. We will not prove it here, but the equation for the discretization of the noise is\n",
"\n",
"$$\\mathbf{Q} = \\int_0^{\\Delta t} \\Phi(t)\\mathbf{Q_c}\\Phi^\\mathsf{T}(t) dt$$\n",
"\n",
"where $\\mathbf{Q_c}$ is the continuous noise. This gives us\n",
"\n",
"$$\\Phi = \\begin{bmatrix}1 & \\Delta t & {\\Delta t}^2/2 \\\\ 0 & 1 & \\Delta t\\\\ 0& 0& 1\\end{bmatrix}$$\n",
"\n",
"for the fundamental matrix, and\n",
"\n",
"$$\\mathbf{Q_c} = \\begin{bmatrix}0&0&0\\\\0&0&0\\\\0&0&1\\end{bmatrix} \\Phi_s$$\n",
"\n",
"for the continuous process noise matrix, where $\\Phi_s$ is the spectral density of the white noise.\n",
"\n",
"We could carry out these computations ourselves, but I prefer using SymPy to solve the equation.\n",
"\n",
"$$\\mathbf{Q_c} = \\begin{bmatrix}0&0&0\\\\0&0&0\\\\0&0&1\\end{bmatrix} \\Phi_s$$\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 51,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"text/latex": [
"$$\\left[\\begin{matrix}\\frac{\\Delta{t}^{5}}{20} & \\frac{\\Delta{t}^{4}}{8} & \\frac{\\Delta{t}^{3}}{6}\\\\\\frac{\\Delta{t}^{4}}{8} & \\frac{\\Delta{t}^{3}}{3} & \\frac{\\Delta{t}^{2}}{2}\\\\\\frac{\\Delta{t}^{3}}{6} & \\frac{\\Delta{t}^{2}}{2} & \\Delta{t}\\end{matrix}\\right] \\Phi_{s}$$"
],
"text/plain": [
"⎡ 5 4 3⎤ \n",
"⎢\\Delta{t} \\Delta{t} \\Delta{t} ⎥ \n",
"⎢────────── ────────── ──────────⎥⋅\\Phi_s\n",
"⎢ 20 8 6 ⎥ \n",
"⎢ ⎥ \n",
"⎢ 4 3 2⎥ \n",
"⎢\\Delta{t} \\Delta{t} \\Delta{t} ⎥ \n",
"⎢────────── ────────── ──────────⎥ \n",
"⎢ 8 3 2 ⎥ \n",
"⎢ ⎥ \n",
"⎢ 3 2 ⎥ \n",
"⎢\\Delta{t} \\Delta{t} ⎥ \n",
"⎢────────── ────────── \\Delta{t} ⎥ \n",
"⎣ 6 2 ⎦ "
]
},
"execution_count": 51,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"import sympy\n",
"from sympy import init_printing, Matrix,MatMul, integrate, symbols\n",
"\n",
"init_printing(use_latex='mathjax')\n",
"dt, phi = symbols('\\Delta{t} \\Phi_s')\n",
"F_k = Matrix([[1, dt, dt**2/2],\n",
" [0, 1, dt],\n",
" [0, 0, 1]])\n",
"Q_c = Matrix([[0, 0, 0],\n",
" [0, 0, 0],\n",
" [0, 0, 1]])*phi\n",
"\n",
"Q=sympy.integrate(F_k * Q_c * F_k.T, (dt, 0, dt))\n",
"\n",
"# factor phi out of the matrix to make it more readable\n",
"Q = Q / phi\n",
"sympy.MatMul(Q, phi)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"For completeness, let us compute the equations for the 0th order and 1st order equations."
]
},
{
"cell_type": "code",
"execution_count": 52,
"metadata": {
"collapsed": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"0th order discrete process noise\n"
]
},
{
"data": {
"text/latex": [
"$$\\left[\\begin{matrix}\\Delta{t} \\Phi_{s}\\end{matrix}\\right]$$"
],
"text/plain": [
"[\\Delta{t}â‹…\\Phi_s]"
]
},
"execution_count": 52,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"F_k = sympy.Matrix([[1]])\n",
"Q_c = sympy.Matrix([[phi]])\n",
"\n",
"print('0th order discrete process noise')\n",
"sympy.integrate(F_k*Q_c*F_k.T,(dt, 0, dt))"
]
},
{
"cell_type": "code",
"execution_count": 53,
"metadata": {
"collapsed": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"1st order discrete process noise\n"
]
},
{
"data": {
"text/latex": [
"$$\\left[\\begin{matrix}\\frac{\\Delta{t}^{3}}{3} & \\frac{\\Delta{t}^{2}}{2}\\\\\\frac{\\Delta{t}^{2}}{2} & \\Delta{t}\\end{matrix}\\right] \\Phi_{s}$$"
],
"text/plain": [
"⎡ 3 2⎤ \n",
"⎢\\Delta{t} \\Delta{t} ⎥ \n",
"⎢────────── ──────────⎥⋅\\Phi_s\n",
"⎢ 3 2 ⎥ \n",
"⎢ ⎥ \n",
"⎢ 2 ⎥ \n",
"⎢\\Delta{t} ⎥ \n",
"⎢────────── \\Delta{t} ⎥ \n",
"⎣ 2 ⎦ "
]
},
"execution_count": 53,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"F_k = sympy.Matrix([[1, dt],\n",
" [0, 1]])\n",
"Q_c = sympy.Matrix([[0, 0],\n",
" [0, 1]])*phi\n",
"\n",
"Q = sympy.integrate(F_k * Q_c * F_k.T, (dt, 0, dt))\n",
"\n",
"print('1st order discrete process noise')\n",
"# factor phi out of the matrix to make it more readable\n",
"Q = Q / phi\n",
"sympy.MatMul(Q, phi)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Piecewise White Noise Model\n",
"\n",
"Another model for the noise assumes that the that highest order term (say, acceleration) is constant for each time period, but differs for each time period, and each of these is uncorrelated between time periods. This is subtly different than the model above, where we assumed that the last term had a continuously varying noisy signal applied to it. \n",
"\n",
"We will model this as\n",
"\n",
"$$f(x)=Fx+\\Gamma w$$\n",
"\n",
"where $\\Gamma$ is the *noise gain* of the system, and $w$ is the constant piecewise acceleration (or velocity, or jerk, etc). \n",
"\n",
"Lets start with by looking a first order system. In this case we have the state transition function\n",
"\n",
"$$\\mathbf{F} = \\begin{bmatrix}1&\\Delta t \\\\ 0& 1\\end{bmatrix}$$\n",
"\n",
"In one time period, the change in velocity will be $w(t)\\Delta t$, and the change in position will be $w(t)\\Delta t^2/2$, giving us\n",
"\n",
"$$\\Gamma = \\begin{bmatrix}\\frac{1}{2}\\Delta t^2 \\\\ \\Delta t\\end{bmatrix}$$\n",
"\n",
"The covariance of the process noise is then\n",
"\n",
"$$Q = E[\\Gamma w(t) w(t) \\Gamma^\\mathsf{T}] = \\Gamma\\sigma^2_v\\Gamma^\\mathsf{T}$$.\n",
"\n",
"We can compute that with SymPy as follows"
]
},
{
"cell_type": "code",
"execution_count": 54,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"text/latex": [
"$$\\left[\\begin{matrix}\\frac{\\Delta{t}^{4}}{4} & \\frac{\\Delta{t}^{3}}{2}\\\\\\frac{\\Delta{t}^{3}}{2} & \\Delta{t}^{2}\\end{matrix}\\right] \\sigma^{2}_{v}$$"
],
"text/plain": [
"⎡ 4 3⎤ \n",
"⎢\\Delta{t} \\Delta{t} ⎥ \n",
"⎢────────── ──────────⎥⋅σ²ᵥ\n",
"⎢ 4 2 ⎥ \n",
"⎢ ⎥ \n",
"⎢ 3 ⎥ \n",
"⎢\\Delta{t} 2⎥ \n",
"⎢────────── \\Delta{t} ⎥ \n",
"⎣ 2 ⎦ "
]
},
"execution_count": 54,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"var=symbols('sigma^2_v')\n",
"v = Matrix([[dt**2 / 2], [dt]])\n",
"\n",
"Q = v * var * v.T\n",
"\n",
"# factor variance out of the matrix to make it more readable\n",
"Q = Q / var\n",
"sympy.MatMul(Q, var)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The second order system proceeds with the same math.\n",
"\n",
"\n",
"$$\\mathbf{F} = \\begin{bmatrix}1 & \\Delta t & {\\Delta t}^2/2 \\\\ 0 & 1 & \\Delta t\\\\ 0& 0& 1\\end{bmatrix}$$\n",
"\n",
"Here we will assume that the white noise is a discrete time Wiener process. This gives us\n",
"\n",
"$$\\Gamma = \\begin{bmatrix}\\frac{1}{2}\\Delta t^2 \\\\ \\Delta t\\\\ 1\\end{bmatrix}$$\n",
"\n",
"There is no 'truth' to this model, it is just convenient and provides good results. For example, we could assume that the noise is applied to the jerk at the cost of a more complicated equation. \n",
"\n",
"The covariance of the process noise is then\n",
"\n",
"$$Q = E[\\Gamma w(t) w(t) \\Gamma^\\mathsf{T}] = \\Gamma\\sigma^2_v\\Gamma^\\mathsf{T}$$.\n",
"\n",
"We can compute that with SymPy as follows"
]
},
{
"cell_type": "code",
"execution_count": 55,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"text/latex": [
"$$\\left[\\begin{matrix}\\frac{\\Delta{t}^{4}}{4} & \\frac{\\Delta{t}^{3}}{2} & \\frac{\\Delta{t}^{2}}{2}\\\\\\frac{\\Delta{t}^{3}}{2} & \\Delta{t}^{2} & \\Delta{t}\\\\\\frac{\\Delta{t}^{2}}{2} & \\Delta{t} & 1\\end{matrix}\\right] \\sigma^{2}_{v}$$"
],
"text/plain": [
"⎡ 4 3 2⎤ \n",
"⎢\\Delta{t} \\Delta{t} \\Delta{t} ⎥ \n",
"⎢────────── ────────── ──────────⎥⋅σ²ᵥ\n",
"⎢ 4 2 2 ⎥ \n",
"⎢ ⎥ \n",
"⎢ 3 ⎥ \n",
"⎢\\Delta{t} 2 ⎥ \n",
"⎢────────── \\Delta{t} \\Delta{t} ⎥ \n",
"⎢ 2 ⎥ \n",
"⎢ ⎥ \n",
"⎢ 2 ⎥ \n",
"⎢\\Delta{t} ⎥ \n",
"⎢────────── \\Delta{t} 1 ⎥ \n",
"⎣ 2 ⎦ "
]
},
"execution_count": 55,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"var=symbols('sigma^2_v')\n",
"v = Matrix([[dt**2 / 2], [dt], [1]])\n",
"\n",
"Q = v * var * v.T\n",
"\n",
"# factor variance out of the matrix to make it more readable\n",
"Q = Q / var\n",
"sympy.MatMul(Q, var)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We cannot say that this model is more or less correct than the continuous model - both are approximations to what is happening to the actual object. Only experience and experiments can guide you to the appropriate model. In practice you will usually find that either model provides reasonable results, but typically one will perform better than the other.\n",
"\n",
"The advantage of the second model is that we can model the noise in terms of $\\sigma^2$ which we can describe in terms of the motion and the amount of error we expect. The first model requires us to specify the spectral density, which is not very intuitive, but it handles varying time samples much more easily since the noise is integrated across the time period. However, these are not fixed rules - use whichever model (or a model of your own devising) based on testing how the filter performs and/or your knowledge of the behavior of the physical model."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Using FilterPy to Compute Q\n",
"\n",
"FilterPy offers several routines to compute the $\\mathbf{Q}$ matrix. The function `Q_continuous_white_noise()` computes $\\mathbf{Q}$ for a given value for $\\Delta t$ and the spectral density."
]
},
{
"cell_type": "code",
"execution_count": 56,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"text/plain": [
"array([[ 0.33333333, 0.5 ],\n",
" [ 0.5 , 1. ]])"
]
},
"execution_count": 56,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"import filterpy.common as common\n",
"\n",
"common.Q_continuous_white_noise(dim=2, dt=1, spectral_density=1)"
]
},
{
"cell_type": "code",
"execution_count": 57,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"text/plain": [
"array([[ 0.05 , 0.125 , 0.16666667],\n",
" [ 0.125 , 0.33333333, 0.5 ],\n",
" [ 0.16666667, 0.5 , 1. ]])"
]
},
"execution_count": 57,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"common.Q_continuous_white_noise(dim=3, dt=1, spectral_density=1)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The function `Q_discrete_white_noise()` computes $\\mathbf{Q}$ assuming a piecewise model for the noise."
]
},
{
"cell_type": "code",
"execution_count": 58,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"text/plain": [
"array([[ 0.25, 0.5 ],\n",
" [ 0.5 , 1. ]])"
]
},
"execution_count": 58,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"common.Q_discrete_white_noise(2, var=1.)"
]
},
{
"cell_type": "code",
"execution_count": 59,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"text/plain": [
"array([[ 0.25, 0.5 , 0.5 ],\n",
" [ 0.5 , 1. , 1. ],\n",
" [ 0.5 , 1. , 1. ]])"
]
},
"execution_count": 59,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"common.Q_discrete_white_noise(3, var=1.)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Simplification of Q\n",
"\n",
"Through the early parts of this book I used a much simpler form for $\\mathbf{Q}$, often only putting a noise term in the lower rightmost element. Is this justified? Well, consider the value of $\\mathbf{Q}$ for a small $\\Delta t$"
]
},
{
"cell_type": "code",
"execution_count": 60,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"text/plain": [
"array([[ 0.00000002, 0.00000078, 0.00002083],\n",
" [ 0.00000078, 0.00004167, 0.00125 ],\n",
" [ 0.00002083, 0.00125 , 0.05 ]])"
]
},
"execution_count": 60,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"common.Q_continuous_white_noise(dim=3, dt=0.05, spectral_density=1)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We can see that most of the terms are very small. Recall that the only Kalman filter using this matrix is\n",
"\n",
"$$ \\mathbf{P}=\\mathbf{FPF}^\\mathsf{T} + \\mathbf{Q}$$\n",
"\n",
"If the values for $\\mathbf{Q}$ are small relative to $\\mathbf{P}$\n",
"than it will be contributing almost nothing to the computation of $\\mathbf{P}$. Setting $\\mathbf{Q}$ to \n",
"\n",
"$$\\mathbf{Q}=\\begin{bmatrix}0&0&0\\\\0&0&0\\\\0&0&\\sigma^2\\end{bmatrix}$$\n",
"\n",
"while not correct, is often a useful approximation. If you do this you will have to perform quite a few studies to guarantee that your filter works in a variety of situations. Given the availability of functions to compute the correct values of $\\mathbf{Q}$ for you I would strongly recommend not using approximations. Perhaps it is justified for quick-and-dirty filters, or on embedded devices where you need to wring out every last bit of performance, and seek to minimize the number of matrix operations required. "
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Numeric Integration of Differential Equations"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"** author's note: this is just notes to a section. If you need to know this in depth, \n",
"*Computational Physics in Python * by Dr. Eric Ayars is excellent, and available here.\n",
"http://phys.csuchico.edu/ayars/312/Handouts/comp-phys-python.pdf **\n",
"\n",
"So far in this book we have been working with systems that can be expressed with simple linear differential equations such as\n",
"\n",
"$$v = \\dot{x} = \\frac{dx}{dt}$$\n",
"\n",
"which we can integrate into a closed form solution, in this case $x(t) =vt + x_0$. This equation is then put into the system matrix $\\mathbf{F}$, which allows the Kalman filter equations to predict the system state in the future. For example, our constant velocity filters use\n",
"\n",
"$$\\mathbf{F} = \\begin{bmatrix}\n",
"1 & \\Delta t \\\\ 0 & 1\\end{bmatrix}$$.\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The Kalman filter predict equation is $\\mathbf{x}^- = \\mathbf{Fx} + \\mathbf{Bu}$. Hence the prediction is\n",
"\n",
"$$\\mathbf{x}^- = \\begin{bmatrix}\n",
"1 & \\Delta t \\\\ 0 & 1\\end{bmatrix}\\begin{bmatrix}\n",
"x\\\\ \\dot{x}\\end{bmatrix}\n",
"$$\n",
"\n",
"which multiplies out to \n",
"\n",
"$$\\begin{aligned}x^- &= x + v\\Delta t \\\\\n",
"\\dot{x}^- &= \\dot{x}\\end{aligned}$$.\n",
"\n",
"This works for linear ordinary differential equations (ODEs), but does not work (well) for nonlinear equations. For example, consider trying to predict the position of a rapidly turning car. Cars turn by pivoting the front wheels, which cause the car to pivot around the rear axle. Therefore the path will be continuously varying and a linear prediction will necessarily produce an incorrect value. If the change in the system is small enough relative to $\\Delta t$ this can often produce adequate results, but that will rarely be the case with the nonlinear Kalman filters we will be studying in subsequent chapters. Another problem is that even trivial systems produce differential equations for which finding closed form solutions is difficult or impossible. \n",
"\n",
"For these reasons we need to know how to numerically integrate differential equations. This can be a vast topic, and SciPy provides integration routines such as `scipy.integrate.ode`. These routines are robust, but "
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Euler's Method\n",
"\n",
"Let's say we have the initial condition problem of \n",
"\n",
"$$ y' = y, \\\\ y(0) = 1$$\n",
"\n",
"I happen to know the exact answer is $y=e^t$, but of course in general we will not know the exact solution. In general all we know is the derivative of the equation, which is equal to the slope. We also know the initial value: at $t=0$, $y=1$. If we know these two pieces of information we can predict that value for y(1): it is the slope of the function at $t=0$. I've plotted this below"
]
},
{
"cell_type": "code",
"execution_count": 61,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"image/png": "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\nExERERFZGEM4EREREZGFMYQTEREREVkYQzgRERERkYUxhBMRERERWRhDOBERERGRhTGEExERERFZ\nGEM4EREREZGFMYQTEREREVkYQzgRERERkYUxhBMRERERWRhDOBERERGRhTGEExERERFZGEM4ERER\nEZGFMYQTEREREVkYQzgRERERkYXNKIQfPnwYYWFhcHR0RFJSEi5cuDDt8cXFxdiyZQucnJwQFBSE\nN954wyzFEhEREREtBSZD+EcffYQXX3wR+/fvR2FhIVJTU7Fz507U1dVNerxarcb27dvh7++PvLw8\nvPvuu3jrrbfwzjvvmL14IiIiIiJbZDKEv/POO9i7dy9++tOfIjIyEn/84x/h7++PI0eOTHr8sWPH\nMDAwgKysLMTExODRRx/FK6+8whBORERERDRi2hA+ODiI/Px87Nixw2j7jh07kJOTM+k5ly5dwqZN\nmyCTyYyOb2xsRG1trRlKJiIiIiKybdOG8NbWVmi1Wvj6+hpt9/HxgVKpnPQcpVI54fjRn6c6h4iI\niIhoObEz9wVFItGczuvq6jJzJUTmFRERAYDPKtkGPq9kS/i80nI07Ui4l5cXJBIJVCqV0XaVSgV/\nf/9Jz/Hz85sw4j16vp+f33xqJSIiIiJaEqYN4VKpFImJifjmm2+MtmdnZyM1NXXSc1JSUnD+/Hlo\nNBqj4wMDAxESEmKGkomIiIiIbJtIEARhugM+/vhjPPPMMzh8+DBSU1Pxpz/9CZmZmSgpKUFwcDD2\n7duH3NxcnDp1CoB+isLIyEikp6dj//79qKiowN69e3HgwAFkZGRY5EMRERERES1mJnvCH3/8cbS1\nteHgwYNoampCbGwsvvrqKwQHBwPQv2xZVVVlON7V1RXZ2dl47rnnkJSUBA8PD7z88ssM4ERERERE\nI0yOhBMRERERkXnNaNl6c/mv//ov3HPPPXBzc4NYLMbt27dndN6nn36KmJgYODg4YM2aNfj8888X\nuFIiQKPR4Be/+AW8vb3h4uKChx9+GA0NDdOe8/7770MsFhv9kkgkGBwctFDVtJwcPnwYYWFhcHR0\nRFJSEi5cuDDt8cXFxdiyZQucnJwQFBSEN954w0KVEs3uea2pqZnwXSoWiye8o0a0EM6dO4eHHnoI\nQUFBEIvFyMrKMnnOXL5fLRrC+/v7cd999+H111+f8TmXLl3Ck08+iWeeeQbXrl3D008/jcceewzf\n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\n",
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"import numpy as np\n",
"t = np.linspace(-1, 1, 10)\n",
"plt.plot(t, np.exp(t))\n",
"t = np.linspace(0, 1, 2)\n",
"plt.plot(t,t+1);"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"If the curve is relatively straight than the line formed by the slope will not be very far from the curve. Here the step size of 1 is rather large; you can see that the slope is very close to the line at, say, 0.1. But let's continue with a step size of 1 for a moment. We can see that at $t=1$ the estimated value of $y$ is 2. Now we can compute the value at $t=2$ by taking the slope of the curve at $t=1$ and adding it to our initial estimate. The slope is computed with $y'=y$, so the slope is 2."
]
},
{
"cell_type": "code",
"execution_count": 62,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"t = np.linspace(-1, 2, 20)\n",
"plt.plot(t, np.exp(t))\n",
"t = np.linspace(0, 1, 2)\n",
"plt.plot([1,2, 4])\n",
"book_plots.set_labels(x='x', y='y');"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Here we see the next estimate for y is 4. The errors are quickly getting large, and you might be unimpressed. But 1 is a very large step size. Let's put this algorithm in code, and verify that it works by trying to generate the result above."
]
},
{
"cell_type": "code",
"execution_count": 63,
"metadata": {
"collapsed": true
},
"outputs": [],
"source": [
"def euler(t, tmax, y, dx, step=1.):\n",
" ys = []\n",
" while t < tmax:\n",
" y = y + step*dx(t, y)\n",
" ys.append(y)\n",
" t +=step \n",
" return ys"
]
},
{
"cell_type": "code",
"execution_count": 64,
"metadata": {
"collapsed": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"2.0\n",
"4.0\n"
]
}
],
"source": [
"def dx(t, y): return y\n",
"\n",
"print(euler(0, 1, 1, dx, step=1.)[-1])\n",
"print(euler(0, 2, 1, dx, step=1.)[-1])"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"This looks correct. So now lets plot the result of a much smaller step size."
]
},
{
"cell_type": "code",
"execution_count": 65,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"image/png": "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\nik2iAAAAAElFTkSuQmCC\n",
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"ys = euler(0, 4, 1, dx, step=0.00001)\n",
"plt.subplot(1,2,1)\n",
"plt.title('Computed')\n",
"plt.plot(np.linspace(0, 4, len(ys)),ys)\n",
"plt.subplot(1,2,2)\n",
"t = np.linspace(0, 4, 20)\n",
"plt.title('Exact')\n",
"plt.plot(t, np.exp(t));"
]
},
{
"cell_type": "code",
"execution_count": 66,
"metadata": {
"collapsed": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"exact answer= 54.5981500331\n",
"euler answer= 54.59705808834125\n",
"difference = 0.00109194480299\n",
"iterations = 400000\n"
]
}
],
"source": [
"print('exact answer=', np.exp(4))\n",
"print('euler answer=', ys[-1])\n",
"print('difference =', np.exp(4) - ys[-1])\n",
"print('iterations =', len(ys))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Here we see that the error is reasonably small, but it took a very large number of iterations to get three digits of precision. In practice Euler's method is too slow for most problems, and we use higher level methods.\n",
"\n",
"Before we go on, let's formally derive Euler's method, as it is the basis for the more advanced Runge Kutta methods used in the next section. In fact, Euler's method is the simplest form of Runge Kutta.\n",
"\n",
"\n",
"Here are the first 3 terms of the Euler expansion of $y$. An infinite expansion would give an exact answer, so $O(h^4)$ denotes the error due to the finite expansion.\n",
"\n",
"$$y(t_0 + h) = y(t_0) + h y'(t_0) + \\frac{1}{2!}h^2 y''(t_0) + \\frac{1}{3!}h^3 y'''(t_0) + O(h^4).$$\n",
"\n",
"Here we can see that Euler's method is using the first two terms of the Taylor expansion. Each subsequent term is smaller than the previous terms, so we are assured that the estimate will not be too far off from the correct value. "
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Runge Kutta Methods"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"\n",
"Runge Kutta integration is the workhorse of numerical integration. As mentioned earlier there are a vast number of methods in the literature. In practice, using the Runge Kutta algorithm that I present here will solve most any problem you will face. It offers a very good balance of speed, precision, and stability, and it is the 'go to' numerical integration method unless you have a very good reason to choose something different. If you have the knowledge to make that decision you have no need to be reading this section!\n",
"\n",
"Let's dive in. We start with some differential equation\n",
"\n",
"$$\\ddot{y} = \\frac{d}{dt}\\dot{y}$$.\n",
"\n",
"We can substitute the derivative of y with a function f, like so\n",
"\n",
"$$\\ddot{y} = \\frac{d}{dt}f(y,t)$$."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Deriving these equations is outside the scope of this book, but the Runge Kutta RK4 method is defined with these equations.\n",
"\n",
"$$y(t+\\Delta t) = y(t) + \\frac{1}{6}(k_1 + 2k_2 + 2k_3 + k_4) + O(\\Delta t^4)$$\n",
"\n",
"$$\\begin{aligned}\n",
"k_1 &= f(y,t)\\Delta t \\\\\n",
"k_2 &= f(y+\\frac{1}{2}k_1, t+\\frac{1}{2}\\Delta t)\\Delta t \\\\\n",
"k_3 &= f(y+\\frac{1}{2}k_2, t+\\frac{1}{2}\\Delta t)\\Delta t \\\\\n",
"k_4 &= f(y+k_3, t+\\Delta t)\\Delta t\n",
"\\end{aligned}\n",
"$$\n"
]
},
{
"cell_type": "code",
"execution_count": 67,
"metadata": {
"collapsed": false
},
"outputs": [],
"source": [
"def runge_kutta4(y, x, dx, f):\n",
" \"\"\"computes 4th order Runge-Kutta for dy/dx.\n",
" y is the initial value for y\n",
" x is the initial value for x\n",
" dx is the difference in x (e.g. the time step)\n",
" f is a callable function (y, x) that you supply to compute dy/dx for\n",
" the specified values.\n",
" \"\"\"\n",
" \n",
" k1 = dx * f(y, x)\n",
" k2 = dx * f(y + 0.5*k1, x + 0.5*dx)\n",
" k3 = dx * f(y + 0.5*k2, x + 0.5*dx)\n",
" k4 = dx * f(y + k3, x + dx)\n",
" \n",
" return y + (k1 + 2*k2 + 2*k3 + k4) / 6."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Let's use this for a simple example. Let\n",
"\n",
"$$\\dot{y} = t\\sqrt{y(t)}$$\n",
"\n",
"with the initial values\n",
"\n",
"$$\\begin{aligned}t_0 &= 0\\\\y_0 &= y(t_0) = 1\\end{aligned}$$"
]
},
{
"cell_type": "code",
"execution_count": 68,
"metadata": {
"collapsed": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"max error 5.206970035942504e-05\n"
]
},
{
"data": {
"image/png": "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\nu918Y+VwgUAAXq+3rAM9Pz/j/PycHciBXl9fMTw8jGw2i1Qq9aWTqyriyTjwPtIwNjaG3t5eGIaB\njeyQVlMAAAGeSURBVI0N3N/fcxbOYaamprC9vY39/X2oqlqahfN4PGhoaJCcjr5KVVWoqlq2Vl9f\nj6ampr89ZaXKFo/HYRgGEokEIpEITNNEMpnkcXgONDAwgJWVFQQCAYRCIZimidXVVYyPj8uORp8o\nFAq4ubkB8D46ls/nYVkWmpub0dbWhunpaSQSCQSDQXR0dGBxcREejwcjIyOSk9NffXQv/X4/hoaG\ncHl5iYODAwghSj2osbERiqL884/+ewe8/Nz6+rrQNE3U1taKcDgs0um07Ej0m1wul3C73cLlcpV9\nFhYWZEejH+LRhs51dHQkuru7haIooqurSySTSdmR6Buenp7EzMyM0DRN1NXVifb2djE7OyteXl5k\nR6NPpFKp0n745z1yYmKidM38/Lzw+XxCURTR398vcrmcxMT0Kx/dy9vb21/2oI+OQHQJwfdbRERE\nREQyVMTMOBERERHR/xHLOBERERGRJCzjRERERESSsIwTEREREUnCMk5EREREJAnLOBERERGRJCzj\nRERERESSsIwTEREREUnCMk5EREREJMkf3R5gQTjPFqAAAAAASUVORK5CYII=\n",
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"import math\n",
"import numpy as np\n",
"t = 0.\n",
"y = 1.\n",
"dt = .1\n",
"\n",
"ys, ts = [], []\n",
"\n",
"def func(y,t):\n",
" return t*math.sqrt(y)\n",
"\n",
"while t <= 10:\n",
" y = runge_kutta4(y, t, dt, func)\n",
" t += dt\n",
"\n",
" ys.append(y)\n",
" ts.append(t)\n",
"\n",
"exact = [(t**2 + 4)**2 / 16. for t in ts]\n",
"plt.plot(ts, ys)\n",
"plt.plot(ts, exact)\n",
"\n",
"error = np.array(exact) - np.array(ys)\n",
"print(\"max error {}\".format(max(error)))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Iterative Least Squares for Sensor Fusion"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"A broad category of use for the Kalman filter is *sensor fusion*. For example, we might have a position sensor and a velocity sensor, and we want to combine the data from both to find an optimal estimate of state. In this section we will discuss a different case, where we have multiple sensors providing the same type of measurement. \n",
"\n",
" The Global Positioning System (GPS) is designed so that at least 6 satellites are in view at any time at any point on the globe. The GPS receiver knows the location of the satellites in the sky relative to the Earth. At each epoch (instant in time) the receiver gets a signal from each satellite from which it can derive the *pseudorange* to the satellite. In more detail, the GPS receiver gets a signal identifying the satellite along with the time stamp of when the signal was transmitted. The GPS satellite has an atomic clock on board so this time stamp is extremely accurate. The signal travels at the speed of light, which is constant in a vacuum, so in theory the GPS should be able to produce an extremely accurate distance measurement to the measurement by measuring how long the signal took to reach the receiver. There are several problems with that. First, the signal is not traveling through a vacuum, but through the atmosphere. The atmosphere causes the signal to bend, so it is not traveling in a straight line. This causes the signal to take longer to reach the receiver than theory suggests. Second, the on board clock on the GPS *receiver* is not very accurate, so deriving an exact time duration is nontrivial. Third, in many environments the signal can bounce off of buildings, trees, and other objects, causing either a longer path or *multipaths*, in which case the receive receives both the original signal from space and the reflected signals. \n",
"\n",
"Let's look at this graphically. I will do this in 2D to make it easier to graph and see, but of course this will generalize to three dimensions. We know the position of each satellite and the range to each (the range is called the *pseudorange*; we will discuss why later). We cannot measure the range exactly, so there is noise associated with the measurement, which I have depicted with the thickness of the lines. Here is an example of four pseudorange readings from four satellites. I positioned them in a configuration which is unlikely for the actual GPS constellation merely to make the intersections easy to visualize. Also, the amount of error shown is not to scale with the distances, again to make it easier to see."
]
},
{
"cell_type": "code",
"execution_count": 69,
"metadata": {
"collapsed": false
},
"outputs": [
{
"data": {
"image/png": "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\nhBDiM/8/3QDBZRpvieYAAAAASUVORK5CYII=\n",
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"import ukf_internal\n",
"with book_format.figsize(10, 6):\n",
" ukf_internal.show_four_gps()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"In 2D two measurements are typically enough to determine a unique solution. There are two intersections of the range circles, but usually the second intersection is not physically realizable (it is in space, or under ground). However, with GPS we also need to solve for time, so we would need a third measurement to get a 2D position.\n",
"\n",
"However, since GPS is a 3D system we need to solve for the 3 dimensions of space, and 1 dimension of time. That is 4 unknowns, so in theory with 4 satellites we have all the information we need. However, we normally have at least 6 satellites in view, and often more than 6. This means the system is *overdetermined*. Finally, because of the noise in the measurements none of pseudoranges intersect exactly.\n",
"\n",
"If you are well versed in linear algebra you know that this an extremely common problem in scientific computing, and that there are various techniques for solving overdetermined systems. Probably the most common approach used by GPS receivers to find the position is the *iterative least squares* algorithm, commonly abbreviated ILS. As you know, if the errors are Gaussian then the least squares algorithm finds the optimal solution. In other words, we want to minimize the square of the residuals for an overdetermined system.\n",
"\n",
"Let's start with some definitions which should be familiar to you. First, we define the innovation as \n",
"\n",
"$$\\delta \\mathbf{z}^-= \\mathbf{z} - h(\\mathbf{x}^-)$$\n",
"\n",
"where $\\mathbf{z}$ is the measurement, $h(\\bullet)$ is the measurement function, and $\\delta \\mathbf{z}^-$ is the innovation, which we abbreviate as $y$ in FilterPy. I don't use the $\\mathbf{x}^-$ symbology often, but it is the prediction for the state variable. In other words, this is the equation $\\mathbf{y} = \\mathbf{z} - \\mathbf{Hx}$ in the linear Kalman filter's update step.\n",
"\n",
"Next, the *measurement residual* is\n",
"\n",
"$$\\delta \\mathbf{z}^+ = \\mathbf{z} - h(\\mathbf{x}^+)$$\n",
"\n",
"I don't use the plus superscript much because I find it quickly makes the equations unreadable, but $\\mathbf{x}^+$ it is the *a posteriori* state estimate, which is the predicted or unknown future state. In other words, the predict step of the linear Kalman filter computes this value. Here it is stands for the value of x which the ILS algorithm will compute on each iteration.\n",
"\n",
"These equations give us the following linear algebra equation:\n",
"\n",
"$$\\delta \\mathbf{z}^- = \\mathbf{H}\\delta \\mathbf{x} + \\delta \\mathbf{z}^+$$\n",
"\n",
"$\\mathbf{H}$ is our measurement function, defined as\n",
"\n",
"$$\\mathbf{H} = \\frac{d\\mathbf{h}}{d\\mathbf{x}} = \\frac{d\\mathbf{z}}{d\\mathbf{x}}$$\n",
"\n",
"We find the minimum of an equation by taking the derivative and setting it to zero. In this case we want to minimize the square of the residuals, so our equation is"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$ \\frac{\\partial}{\\partial \\mathbf{x}}({\\delta \\mathbf{z}^+}^\\mathsf{T}\\delta \\mathbf{z}^+) = 0,$$\n",
"\n",
"where\n",
"\n",
"$$\\delta \\mathbf{z}^+=\\delta \\mathbf{z}^- - \\mathbf{H}\\delta \\mathbf{x}.$$\n",
"\n",
"Here I have switched to using the matrix $\\mathbf{H}$ as the measurement function. We want to use linear algebra to peform the ILS, so for each step we will have to compute the matrix $\\mathbf{H}$ which corresponds to $h(\\mathbf{x^-})$ during each iteration. $h(\\bullet)$ is usually nonlinear for these types of problems so you will have to linearize it at each step (more about this soon).\n",
"\n",
"For various reasons you may want to weigh some measurement more than others. For example, the geometry of the problem might favor orthogonal measurements, or some measurements may be more noisy than others. We can do that with the equation\n",
"\n",
"$$ \\frac{\\partial}{\\partial \\mathbf{x}}({\\delta \\mathbf{z}^+}^\\mathsf{T}\\mathbf{W}\\delta \\mathbf{z}^+) = 0$$\n",
"\n",
"If we solve the first equation for ${\\delta \\mathbf{x}}$ (the derivation is shown in the next section) we get\n",
"\n",
"$${\\delta \\mathbf{x}} = {{(\\mathbf{H}^\\mathsf{T}\\mathbf{H})^{-1}}\\mathbf{H}^\\mathsf{T} \\delta \\mathbf{z}^-}\n",
"$$\n",
"\n",
"And the second equation yields\n",
"\n",
"$${\\delta \\mathbf{x}} = {{(\\mathbf{H}^\\mathsf{T}\\mathbf{WH})^{-1}}\\mathbf{H}^\\mathsf{T}\\mathbf{W} \\delta \\mathbf{z}^-}\n",
"$$\n",
"\n",
"Since the equations are overdetermined we cannot solve these equations exactly so we use an iterative approach. An initial guess for the position is made, and this guess is used to compute for $\\delta \\mathbf{x}$ via the equation above. $\\delta \\mathbf{x}$ is added to the intial guess, and this new state is fed back into the equation to produce another $\\delta \\mathbf{x}$. We iterate in this manner until the difference in the measurement residuals is suitably small."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Derivation of ILS Equations (Optional)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"I will implement the ILS in code, but first let's derive the equation for $\\delta \\mathbf{x}$. You can skip the derivation if you want, but it is somewhat instructive and not too hard if you know basic linear algebra and partial differential equations.\n",
"\n",
"Substituting $\\delta \\mathbf{z}^+=\\delta \\mathbf{z}^- - \\mathbf{H}\\delta \\mathbf{x}$ into the partial differential equation we get\n",
"\n",
"$$ \\frac{\\partial}{\\partial \\mathbf{x}}(\\delta \\mathbf{z}^- -\\mathbf{H} \\delta \\mathbf{x})^\\mathsf{T}(\\delta \\mathbf{z}^- - \\mathbf{H} \\delta \\mathbf{x})=0$$\n",
"\n",
"which expands to\n",
"\n",
"$$ \\frac{\\partial}{\\partial \\mathbf{x}}({\\delta \\mathbf{x}}^\\mathsf{T}\\mathbf{H}^\\mathsf{T}\\mathbf{H}\\delta \\mathbf{x} - \n",
"{\\delta \\mathbf{x}}^\\mathsf{T}\\mathbf{H}^\\mathsf{T}\\delta \\mathbf{z}^- - \n",
"{\\delta \\mathbf{z}^-}^\\mathsf{T}\\mathbf{H}\\delta \\mathbf{x} +\n",
"{\\delta \\mathbf{z}^-}^\\mathsf{T}\\delta \\mathbf{z}^-)=0$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We know that \n",
"\n",
"$$\\frac{\\partial \\mathbf{A}^\\mathsf{T}\\mathbf{B}}{\\partial \\mathbf{B}} = \\frac{\\partial \\mathbf{B}^\\mathsf{T}\\mathbf{A}}{\\partial \\mathbf{B}} = \\mathbf{A}^\\mathsf{T}$$\n",
"\n",
"Therefore the third term can be computed as\n",
"\n",
"$$\\frac{\\partial}{\\partial \\mathbf{x}}{\\delta \\mathbf{z}^-}^\\mathsf{T}\\mathbf{H}\\delta \\mathbf{x} = {\\delta \\mathbf{z}^-}^\\mathsf{T}\\mathbf{H}$$\n",
"\n",
"and the second term as\n",
"\n",
"$$\\frac{\\partial}{\\partial \\mathbf{x}}{\\delta \\mathbf{x}}^\\mathsf{T}\\mathbf{H}^\\mathsf{T}\\delta \\mathbf{z}^-={\\delta \\mathbf{z}^-}^\\mathsf{T}\\mathbf{H}$$\n",
"\n",
"We also know that\n",
"$$\\frac{\\partial \\mathbf{B}^\\mathsf{T}\\mathbf{AB}}{\\partial \\mathbf{B}} = \\mathbf{B}^\\mathsf{T}(\\mathbf{A} + \\mathbf{A}^\\mathsf{T})$$\n",
"\n",
"Therefore the first term becomes\n",
"\n",
"$$\n",
"\\begin{aligned}\n",
"\\frac{\\partial}{\\partial \\mathbf{x}}{\\delta \\mathbf{x}}^\\mathsf{T}\\mathbf{H}^\\mathsf{T}\\mathbf{H}\\delta \\mathbf{x} &= {\\delta \\mathbf{x}}^\\mathsf{T}(\\mathbf{H}^\\mathsf{T}\\mathbf{H} + {\\mathbf{H}^\\mathsf{T}\\mathbf{H}}^\\mathsf{T})\\\\\n",
"&= {\\delta \\mathbf{x}}^\\mathsf{T}(\\mathbf{H}^\\mathsf{T}\\mathbf{H} + \\mathbf{H}^\\mathsf{T}\\mathbf{H}) \\\\\n",
"&= 2{\\delta \\mathbf{x}}^\\mathsf{T}\\mathbf{H}^\\mathsf{T}\\mathbf{H}\n",
"\\end{aligned}$$\n",
"\n",
"Finally, the fourth term is\n",
"\n",
"$$ \\frac{\\partial}{\\partial \\mathbf{x}}\n",
"{\\delta \\mathbf{z}^-}^\\mathsf{T}\\delta \\mathbf{z}^-=0$$\n",
"\n",
"Replacing the terms in the expanded partial differential equation gives us\n",
"\n",
"$$\n",
" 2{\\delta \\mathbf{x}}^\\mathsf{T}\\mathbf{H}^\\mathsf{T}\\mathbf{H} -\n",
" {\\delta \\mathbf{z}^-}^\\mathsf{T}\\mathbf{H} - {\\delta \\mathbf{z}^-}^\\mathsf{T}\\mathbf{H}\n",
" =0\n",
"$$\n",
"\n",
"$${\\delta \\mathbf{x}}^\\mathsf{T}\\mathbf{H}^\\mathsf{T}\\mathbf{H} -\n",
" {\\delta \\mathbf{z}^-}^\\mathsf{T}\\mathbf{H} = 0$$\n",
" \n",
"$${\\delta \\mathbf{x}}^\\mathsf{T}\\mathbf{H}^\\mathsf{T}\\mathbf{H} =\n",
" {\\delta \\mathbf{z}^-}^\\mathsf{T}\\mathbf{H}$$\n",
"\n",
"Multiplying each side by $(\\mathbf{H}^\\mathsf{T}\\mathbf{H})^{-1}$ yields\n",
"\n",
"$${\\delta \\mathbf{x}}^\\mathsf{T} =\n",
"{\\delta \\mathbf{z}^-}^\\mathsf{T}\\mathbf{H}(\\mathbf{H}^\\mathsf{T}\\mathbf{H})^{-1}$$\n",
"\n",
"Taking the transpose of each side gives\n",
"\n",
"$${\\delta \\mathbf{x}} = ({{\\delta \\mathbf{z}^-}^\\mathsf{T}\\mathbf{H}(\\mathbf{H}^\\mathsf{T}\\mathbf{H})^{-1}})^\\mathsf{T} \\\\\n",
"={{(\\mathbf{H}^\\mathsf{T}\\mathbf{H})^{-1}}^T\\mathbf{H}^\\mathsf{T} \\delta \\mathbf{z}^-} \\\\\n",
"={{(\\mathbf{H}^\\mathsf{T}\\mathbf{H})^{-1}}\\mathbf{H}^\\mathsf{T} \\delta \\mathbf{z}^-}\n",
"$$\n",
"\n",
"For various reasons you may want to weigh some measurement more than others. We can do that with the equation\n",
"\n",
"$$ \\frac{\\partial}{\\partial \\mathbf{x}}({\\delta \\mathbf{z}}^\\mathsf{T}\\mathbf{W}\\delta \\mathbf{z}) = 0$$\n",
"\n",
"Replicating the math above with the added $\\mathbf{W}$ term results in\n",
"\n",
"$${\\delta \\mathbf{x}} = {{(\\mathbf{H}^\\mathsf{T}\\mathbf{WH})^{-1}}\\mathbf{H}^\\mathsf{T}\\mathbf{W} \\delta \\mathbf{z}^-}\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Implementing Iterative Least Squares"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Our goal is to implement an iterative solution to \n",
"$${\\delta \\mathbf{x}} = {{(\\mathbf{H}^\\mathsf{T}\\mathbf{H})^{-1}}\\mathbf{H}^\\mathsf{T} \\delta \\mathbf{z}^-}\n",
"$$\n",
"\n",
"First, we have to compute $\\mathbf{H}$, where $\\mathbf{H} = d\\mathbf{z}/d\\mathbf{x}$. To keep the example small so the results are easier to interpret we will do this in 2D. Therefore for $n$ satellites $\\mathbf{H}$ expands to\n",
"\n",
"$$\\mathbf{H} = \\begin{bmatrix}\n",
"\\frac{\\partial p_1}{\\partial x_1} & \\frac{\\partial p_1}{\\partial y_1} \\\\\n",
"\\frac{\\partial p_2}{\\partial x_2} & \\frac{\\partial p_2}{\\partial y_2} \\\\\n",
"\\vdots & \\vdots \\\\\n",
"\\frac{\\partial p_n}{\\partial x_n} & \\frac{\\partial p_n}{\\partial y_n}\n",
"\\end{bmatrix}$$\n",
"\n",
"We will linearize $\\mathbf{H}$ by computing the partial for $x$ as\n",
"\n",
"$$ \\frac{estimated\\_x\\_position - satellite\\_x\\_position}{estimated\\_range\\_to\\_satellite}$$\n",
"\n",
"The equation for $y$ just substitutes $y$ for $x$.\n",
"\n",
"Then the algorithm is as follows.\n",
"\n",
" def ILS:\n",
" guess position\n",
" while not converged:\n",
" compute range to satellites for current estimated position\n",
" compute H linearized at estimated position\n",
" compute new estimate delta from (H^T H)'H^T dz\n",
" new estimate = current estimate + estimate delta\n",
" check for convergence\n",
" "
]
},
{
"cell_type": "code",
"execution_count": 70,
"metadata": {
"collapsed": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"iteration: 0\n",
"innovation [-148.512 28.6789 -148.5361]\n",
"pos [ 805.4175 205.2868]\n",
"\n",
"\n",
"iteration: 1\n",
"innovation [-0.1177 -7.4049 -0.1599]\n",
"pos [ 800.04 199.9746]\n",
"\n",
"\n",
"iteration: 2\n",
"innovation [-0.0463 -0.001 -0.0463]\n",
"pos [ 800. 200.]\n",
"\n",
"\n",
"iteration: 3\n",
"innovation [-0. -0. -0.]\n",
"pos [ 800. 200.]\n",
"\n",
"\n",
"Iterated solution: [ 800. 200.]\n"
]
}
],
"source": [
"import numpy as np\n",
"from numpy.linalg import norm, inv\n",
"from numpy.random import randn\n",
"from numpy import dot\n",
"\n",
"\n",
"np.random.seed(1234)\n",
"user_pos = np.array([800, 200])\n",
"\n",
"\n",
"sat_pos = np.asarray(\n",
" [[0, 1000],\n",
" [0, -1000],\n",
" [500, 500]], dtype=float)\n",
"\n",
"def satellite_range(pos, sat_pos):\n",
" \"\"\" Compute distance between position 'pos' and the list of positions\n",
" in sat_pos\"\"\"\n",
"\n",
" N = len(sat_pos)\n",
" rng = np.zeros(N)\n",
"\n",
" diff = np.asarray(pos) - sat_pos\n",
"\n",
" for i in range(N):\n",
" rng[i] = norm(diff[i])\n",
"\n",
" return norm(diff, axis=1)\n",
"\n",
"\n",
"def hx_ils(pos, sat_pos, range_est):\n",
" \"\"\" compute measurement function where\n",
" pos : array_like \n",
" 2D current estimated position. e.g. (23, 45)\n",
" \n",
" sat_pos : array_like of 2D positions\n",
" position of each satellite e.g. [(0,100), (100,0)]\n",
" \n",
" range_est : array_like of floats\n",
" range to each satellite\n",
" \"\"\"\n",
" \n",
" N = len(sat_pos)\n",
" H = np.zeros((N, 2))\n",
" for j in range(N):\n",
" H[j, 0] = (pos[0] - sat_pos[j, 0]) / range_est[j]\n",
" H[j, 1] = (pos[1] - sat_pos[j, 1]) / range_est[j]\n",
" return H\n",
"\n",
"\n",
"def lop_ils(zs, sat_pos, pos_est, hx, eps=1.e-6):\n",
" \"\"\" iteratively estimates the solution to a set of measurement, given\n",
" known transmitter locations\"\"\"\n",
" pos = np.array(pos_est)\n",
"\n",
" with book_format.numpy_precision(precision=4):\n",
" converged = False\n",
" for i in range(20):\n",
" r_est = satellite_range(pos, sat_pos)\n",
" print('iteration:', i)\n",
"\n",
" H = hx(pos, sat_pos, r_est) \n",
" Hinv = inv(dot(H.T, H)).dot(H.T)\n",
"\n",
" # update position estimate\n",
" y = zs - r_est\n",
" print('innovation', y)\n",
"\n",
" Hy = np.dot(Hinv, y)\n",
" pos = pos + Hy\n",
" print('pos {}\\n\\n'.format(pos))\n",
"\n",
" if max(abs(Hy)) < eps:\n",
" converged = True\n",
" break\n",
"\n",
" return pos, converged\n",
"\n",
"# compute measurement of where you are with respect to each sensor\n",
"rz = satellite_range(user_pos, sat_pos)\n",
"\n",
"pos, converted = lop_ils(rz, sat_pos, (900, 90), hx=hx_ils)\n",
"print('Iterated solution: ', pos)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"So let's think about this. The first iteration is essentially performing the computation that the linear Kalman filter computes during the update step:\n",
"\n",
"$$\\mathbf{y} = \\mathbf{z} - \\mathbf{Hx}\\\\\n",
"\\mathbf{x} = \\mathbf{x} + \\mathbf{Ky}$$\n",
"\n",
"where the Kalman gain equals one. You can see that despite the very inaccurate initial guess (900, 90) the computed value for $\\mathbf{x}$, (805.4, 205.3), was very close to the actual value of (800, 200). However, it was not perfect. But after three iterations the ILS algorithm was able to find the exact answer. So hopefully it is clear why we use ILS instead of doing the sensor fusion with the Kalman filter - it gives a better result. Of course, we started with a very inaccurate guess; what if the guess was better?"
]
},
{
"cell_type": "code",
"execution_count": 71,
"metadata": {
"collapsed": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"iteration: 0\n",
"innovation [-0.0009 -1.3868 -0.0024]\n",
"pos [ 800.0014 199.9991]\n",
"\n",
"\n",
"iteration: 1\n",
"innovation [-0.0016 -0. -0.0016]\n",
"pos [ 800. 200.]\n",
"\n",
"\n",
"iteration: 2\n",
"innovation [-0. -0. -0.]\n",
"pos [ 800. 200.]\n",
"\n",
"\n",
"Iterated solution: [ 800. 200.]\n"
]
}
],
"source": [
"pos, converted = lop_ils(rz, sat_pos, (801, 201), hx=hx_ils)\n",
"print('Iterated solution: ', pos)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The first iteration produced a better estimate, but it still could be improved upon by iterating.\n",
"\n",
"I injected no noise in the measurement to test and display the theoretical performance of the filter. Now let's see how it performs when we inject noise."
]
},
{
"cell_type": "code",
"execution_count": 72,
"metadata": {
"collapsed": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"iteration: 0\n",
"innovation [ 129.8823 100.461 107.5398]\n",
"pos [ 831.4474 186.1222]\n",
"\n",
"\n",
"iteration: 1\n",
"innovation [-31.6446 -7.4837 -30.7861]\n",
"pos [ 800.3284 198.8076]\n",
"\n",
"\n",
"iteration: 2\n",
"innovation [-0.6041 -0.3813 0.3569]\n",
"pos [ 799.948 198.6026]\n",
"\n",
"\n",
"iteration: 3\n",
"innovation [-0.4803 0.0004 0.4802]\n",
"pos [ 799.9476 198.6025]\n",
"\n",
"\n",
"iteration: 4\n",
"innovation [-0.4802 0.0007 0.4803]\n",
"pos [ 799.9476 198.6025]\n",
"\n",
"\n",
"Iterated solution: [ 799.9475854 198.60245871]\n"
]
}
],
"source": [
"# add some noise\n",
"nrz = []\n",
"for z in rz:\n",
" nrz.append(z + randn())\n",
"pos, converted = lop_ils(nrz, sat_pos, (601,198.3), hx=hx_ils)\n",
"print('Iterated solution: ', pos)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Here we can see that the noise means that we no longer find the exact solution but we are still able to quickly converge onto a more accurate solution than the first iteration provides.\n",
"\n",
"This is far from a complete coverage of the iterated least squares algorithm, let alone methods used in GNSS to compute positions from GPS pseudoranges. You will find a number of approaches in the literature, including QR decomposition, SVD, and other techniques to solve the overdetermined system. For a nontrivial task you will have to survey the literature and perhaps design your algorithm depending on your specific sensor configuration, the amounts of noise, your accuracy requirements, and the amount of computation you can afford to do."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## References"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
" * [1] *Matrix Exponential* http://en.wikipedia.org/wiki/Matrix_exponential \n",
"\n",
" * [2] *LTI System Theory* http://en.wikipedia.org/wiki/LTI_system_theory\n",
" \n",
" * [3] C.F. van Loan, \"Computing Integrals Involving the Matrix Exponential,\" IEEE Transactions Automatic Control, June 1978."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"\n",
"**ORPHAN TEXT**\n",
"\n",
"I admit this may be a 'magical' equation to you. If you have some experience with linear algebra and statistics, this may help. The covariance due to the prediction can be modeled as the expected value of the error in the prediction step, given by this equation. \n",
"\n",
"$$\\begin{aligned}\n",
"\\mathbf{P}^- &= E[(\\mathbf{Fx})(\\mathbf{Fx})^\\mathsf{T}]\\\\\n",
" &= E[\\mathbf{Fxx}^\\mathsf{T}\\mathbf{F}^\\mathsf{T}] \\\\\n",
" &= \\mathbf{F}\\, E[\\mathbf{xx}^\\mathsf{T}]\\, \\mathbf{F}^\\mathsf{T}\n",
"\\end{aligned}$$\n",
"\n",
"Of course, $E[\\mathbf{xx}^\\mathsf{T}]$ is just $\\mathbf{P}$, giving us\n",
"\n",
"$$\\mathbf{P}^- = \\mathbf{FPF}^\\mathsf{T}$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": []
}
],
"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.3"
}
},
"nbformat": 4,
"nbformat_minor": 0
}