Some re-organization of PoldiAutoCorrelationCore

Added documentation, doxygen for the class interface, as well as some
comments in the code explaining the calculation steps. Furthermore, some
variable renaming for clarity and removal of unused method.