updated the sample code to be more comprehensible
updated the readme to include aims and limitations of the repository