simulation readme updates