some updates

cleaned up code
added README
output formatting
updates

returning code optimized