more docstrings for the sim module