add parameter comments
split timestamps into components, issue #26
move TEST_SAMPLE_FILE to constants.py