updated comments in python files so that it is clear what the code is doing