Closes #17, closes #24. Final example_study demonstrating all the basic functionality of public_api is done. Documentation of public_api is updated with example code.