BACKPORT: Fix bug with somato dataset paths (#13630)

doc/changes/dev/13630.bugfix.rst

@@ -0,0 +1 @@
+Fix bug with :func:`mne.datasets.somato.data_path` where the archive couldn't be extracted due to an absolute path issue, by `Eric Larson`_.

doc/sphinxext/gh_substitutions.py

@@ -2,8 +2,24 @@
 # License: BSD-3-Clause
 # Copyright the MNE-Python contributors.
 
+import docutils
 from docutils.nodes import reference
-from docutils.parsers.rst.roles import set_classes
+
+# Adapted from sphinx
+if docutils.__version_info__[:2] < (0, 22):
+    from docutils.parsers.rst import roles
+
+    def _normalize_options(options):
+        if options is None:
+            return {}
+        n_options = options.copy()
+        roles.set_classes(n_options)
+        return n_options
+
+else:
+    from docutils.parsers.rst.roles import (
+        normalize_options as _normalize_options,
+    )
 
 
 def gh_role(name, rawtext, text, lineno, inliner, options={}, content=[]):  # noqa: B006
@@ -22,7 +38,7 @@ def gh_role(name, rawtext, text, lineno, inliner, options={}, content=[]):  # no
         slug = "issues/" + text
     text = "#" + text
     ref = "https://github.com/mne-tools/mne-python/" + slug
-    set_classes(options)
+    options = _normalize_options(options)
     node = reference(rawtext, text, refuri=ref, **options)
     return [node], []
 

doc/sphinxext/mne_doc_utils.py

@@ -72,10 +72,22 @@ def reset_warnings(gallery_conf, fname):
         r"open_text is deprecated\. Use files",
         # dipy etc.
         "The `disp` and `iprint` options of the L-BFGS-B solver",
+        # statsmodels<->pandas
+        "is deprecated and will be removed",
     ):
         warnings.filterwarnings(  # deal with other modules having bad imports
             "ignore", message=f".*{key}.*", category=DeprecationWarning
         )
+    # ignore (PendingDeprecationWarning)
+    for key in (
+        # sphinx
+        "The mapping interface for autodoc options",
+        # sphinxcontrib-bibtex
+        "sphinx.environment.BuildEnvironment.app' is deprecated",
+    ):
+        warnings.filterwarnings(  # deal with other modules having bad imports
+            "ignore", message=f".*{key}.*", category=PendingDeprecationWarning
+        )
     # ignore (UserWarning)
     for message in (
         # Matplotlib

doc/sphinxext/related_software.txt

@@ -13,6 +13,7 @@ meegkit
 meggie
 mne-ari
 mne-bids-pipeline
+mne-denoise
 mne-faster
 mne-features
 mne-icalabel

doc/sphinxext/related_software_nodeps.txt

@@ -2,3 +2,4 @@
 cross-domain-saliency-maps
 fsleyes
 mne-kit-gui
+mne-videobrowser

examples/inverse/dics_epochs.py

@@ -5,11 +5,10 @@
 Compute source level time-frequency timecourses using a DICS beamformer
 =======================================================================
 
-In this example, a Dynamic Imaging of Coherent Sources (DICS)
-:footcite:`GrossEtAl2001` beamformer is used to transform sensor-level
-time-frequency objects to the source level. We will look at the event-related
-synchronization (ERS) of beta band activity in the :ref:`somato dataset
-<somato-dataset>`.
+In this example, a Dynamic Imaging of Coherent Sources (DICS) :footcite:`GrossEtAl2001`
+beamformer is used to transform sensor-level time-frequency objects to the source level.
+We will look at the event-related synchronization (ERS) of beta band activity in the
+:ref:`somato dataset <somato-dataset>`.
 """
 # Authors: Marijn van Vliet <w.m.vanvliet@gmail.com>
 #          Alex Rockhill <aprockhill@mailbox.org>

mne/datasets/_fetch.py

@@ -26,6 +26,7 @@
     _downloader_params,
     _get_path,
     _log_time_size,
+    _pl,
 )
 
 _FAKE_VERSION = None  # used for monkeypatching while testing versioning
@@ -253,6 +254,9 @@ def fetch_dataset(
     # use our logger level for pooch's logger too
     pooch.get_logger().setLevel(logger.getEffectiveLevel())
     sz = 0
+    logger.info(
+        "Fetching %s file%s for the %s dataset ...", len(names), _pl(names), name
+    )
 
     for idx in range(len(names)):
         # fetch and unpack the data

mne/datasets/config.py

@@ -211,8 +211,8 @@
 
 MNE_DATASETS["somato"] = dict(
     archive_name="MNE-somato-data.tar.gz",
-    hash="md5:32fd2f6c8c7eb0784a1de6435273c48b",
-    url="https://osf.io/download/tp4sg?version=7",
+    hash="md5:9a191907b326b9402341ee7a0d1240d8",
+    url="https://osf.io/download/tp4sg?version=8",
     folder_name="MNE-somato-data",
     config_key="MNE_DATASETS_SOMATO_PATH",
 )