added notes, made input/output files compatible with test.py