consolidated functions from ribis package, organized and documented, moved examples to README.md