updated overview (file doc strings):
    added example of algorithms performance, and outputs.
    fixed usage example
    small bug fixes