finished implimentation and testing and doccing
updated sample