better command line outputs
code cleaning and commenting
readme updates