Functionality Updates and Examples!

adding much new functionality as described by the read me, and adding
sample usage in examples