refactor module to allow reading matrix file from Python
add details to README concerning matrix file directory