architecture and simulations README