added docstring simulation to utilities