documented the program logic/algorithm, top-level.
Merge branch 'master' of https://github.com/rebeccaj/SFMTASimulation