return sample metadata info with results
update docstrings for new change
pep8 fixes