fixed up some of the inconsisten error handling
added sample run info to the readme file