[DOC] Combine similar two-runs GLM examples

.gitignore

@@ -58,8 +58,8 @@ doc/building_blocks/generated/
 doc/datasets/generated/
 doc/generated/
 doc/modules/generated/
-doc/themes/nilearn/static/jquery.js
 doc/sg_execution_times.rst
+doc/themes/nilearn/static/jquery.js
 
 # examples
 examples/**/*.pdf

.pre-commit-config.yaml

@@ -12,8 +12,6 @@ exclude: |
         | examples/01_plotting/plot_surf_atlas.py
         | examples/01_plotting/plot_surf_stat_map.py
         | examples/01_plotting/plot_surface_projection_strategies.py
-        | examples/04_glm_first_level/plot_fiac_analysis.py
-        | examples/04_glm_first_level/plot_fixed_effects.py
         | examples/04_glm_first_level/plot_localizer_surface_analysis.py
         | examples/07_advanced/plot_surface_bids_analysis.py
         | nilearn/_utils/helpers.py

doc/changes/latest.rst

@@ -51,4 +51,5 @@ Changes
 - :bdg-danger:`Deprecation` :func:`~plotting.plot_surf_roi` will raise a warning if ``roi_map`` contains negative or non-integer values; in version 0.13 this will be a ``ValueError`` (:gh:`4131` by `Michelle Wang`_).
 - :bdg-dark:`Code` Remove leading underscore from non private functions to align with PEP8 (:gh:`4086` by `Rémi Gau`_).
 - :bdg-dark:`Code` Make ``decoding/proximal_operator`` explicitly private to align with PEP8 (:gh:`4153` by `Rémi Gau`_).
+- :bdg-primary:`Doc` Combine GLM examples ``plot_fixed_effect`` and ``plot_fiac_analysis`` into a a single example ``plot_two_runs_model`` (:gh:`3191` by `Taylor Salo`_ and `Rémi Gau`_).
 - :bdg-dark:`Code` Make private functions public when used outside of their module ``nilearn.interface`` to align with PEP8 (:gh:`4168` by `Rémi Gau`_).

doc/glm/first_level_model.rst

@@ -129,7 +129,7 @@ The activation maps from these 3 contrasts is presented below:
      :scale: 60
 
 
-Additional example: :ref:`sphx_glr_auto_examples_04_glm_first_level_plot_fiac_analysis.py`
+Additional example: :ref:`sphx_glr_auto_examples_04_glm_first_level_plot_two_runs_model.py`
 
 
 Extracting predicted time series and residuals

doc/introduction.rst

@@ -221,13 +221,13 @@ For new-comers, we recommend going through the following examples in the suggest
 .. only:: html
 
   .. image:: /auto_examples/04_glm_first_level/images/thumb/sphx_glr_plot_fiac_analysis_thumb.png
-    :alt: Simple example of two-session fMRI model fitting
+    :alt: Simple example of two-runs fMRI model fitting
 
-  :ref:`sphx_glr_auto_examples_04_glm_first_level_plot_fiac_analysis.py`
+  :ref:`sphx_glr_auto_examples_04_glm_first_level_plot_two_runs_model.py`
 
 .. raw:: html
 
-      <div class="sphx-glr-thumbnail-title">Simple example of two-session fMRI model fitting</div>
+      <div class="sphx-glr-thumbnail-title">Simple example of two-runs fMRI model fitting</div>
     </div>
 
 

doc/references.bib

@@ -180,6 +180,17 @@ @article{Craddock2012
 	year = {2012}
 }
 
+@article{dehaene2006functional,
+	title={Functional segregation of cortical language areas by sentence repetition},
+	author={Dehaene-Lambertz, Ghislaine and Dehaene, Stanislas and Anton, Jean-Luc and Campagne, Aurelie and Ciuciu, Philippe and Dehaene, Guillaume P and Denghien, Isabelle and Jobert, Antoinette and LeBihan, Denis and Sigman, Mariano and others},
+	journal={Human brain mapping},
+	volume={27},
+	number={5},
+	pages={360--371},
+	year={2006},
+	publisher={Wiley Online Library}
+}
+
 @article{Dadi2020,
 	title = {Fine-grain atlases of functional modes for fMRI analysis},
 	journal = {NeuroImage},