added README
moved code to standard directory
separated interactive testing and functions
moved some interactive testing out of functions
cleaned up some files leftover from python and javascript branches
updated function documentation