initial commit of working code
initial update of README
additional variable name cleanup