update module documentation
add docstrings describing algorithm classes
add example script with musk1 dataset
add "How to Use" section to README