Document kalman_algo and kalman_tol

Closes #324
Merge pull request #402 from JohannesPfeifer/Kalman_documentation

Document kalman_algo and kalman_tol