renamed rate2 and rate TS2 as reverseRate

Added backwards compatibility methods, aliasing rate2 and rateTS2 to
reverseRate

Cleaned up some code.

Added docstrings.