--- a
+++ b/doc/api/simulation.rst
@@ -0,0 +1,45 @@
+
+Simulation
+==========
+
+:py:mod:`mne.simulation`:
+
+.. automodule:: mne.simulation
+   :no-members:
+   :no-inherited-members:
+
+.. currentmodule:: mne.simulation
+
+.. autosummary::
+   :toctree: ../generated/
+
+   add_chpi
+   add_ecg
+   add_eog
+   add_noise
+   simulate_evoked
+   simulate_raw
+   simulate_stc
+   simulate_sparse_stc
+   select_source_in_label
+   SourceSimulator
+
+:py:mod:`mne.simulation.metrics`:
+
+.. automodule:: mne.simulation.metrics
+   :no-members:
+   :no-inherited-members:
+
+.. currentmodule:: mne.simulation.metrics
+
+.. autosummary::
+   :toctree: ../generated/
+
+   cosine_score
+   region_localization_error
+   f1_score
+   precision_score
+   recall_score
+   roc_auc_score
+   spatial_deviation_error
+   peak_position_error