update docstrings; add doctest
updates to examples and doctests
fixes bug related to dropping the output table
add interface to settings
update docs on settings