fix jsdoc comment
add some functions for handling the input data