completes calculations and report. adds a proper Readme