fist pass at report for Michael explaining the simulation framework