change doc of simulations fn