numerical: added description in simulation
numerical: complete the readme
get this TODO list right