**Is your feature request related to a problem? Please describe.** The `Simulator` API is not well documented. **Describe the solution you'd like** Provide documentation and examples for the `Simulator` API. **Describe alternatives you've considered** **Additional context**