Add docstrings to simulator

## Description of task

Add docstrings to document all parts of the simulator component. All functions/methods/structs/enums/etc. should be documented to explain what they do and what failure modes are possible.
