adding example and test files
updated README to include reference to examples and test code
merging branch; resolving conflicts