Braindecode 1.3.2.dev173801889__tar.gz → 1.3.2.dev174123093__tar.gz

{braindecode-1.3.2.dev173801889/braindecode.egg-info → braindecode-1.3.2.dev174123093}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: braindecode
-Version: 1.3.2.dev173801889
+Version: 1.3.2.dev174123093
 Summary: Deep learning software to decode EEG, ECG or MEG signals
 Author-email: Robin Tibor Schirrmeister <robintibor@gmail.com>, Bruno Aristimunha Pinto <b.aristimunha@gmail.com>, Alexandre Gramfort <agramfort@meta.com>
 Maintainer-email: Alexandre Gramfort <agramfort@meta.com>, Bruno Aristimunha Pinto <b.aristimunha@gmail.com>, Robin Tibor Schirrmeister <robintibor@gmail.com>

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/braindecode/datasets/bids/hub.py

@@ -845,16 +845,11 @@ class HubDatasetMixin:
 
                 # Convert to MNE objects and create dataset
                 info = Info.from_json_dict(info_dict)
-                targets = metadata["target"].values
-                if np.issubdtype(targets.dtype, np.integer):
-                    event_ids = targets
-                else:
-                    event_ids = np.ones(len(metadata), dtype=int)
                 events = np.column_stack(
                     [
-                        metadata["i_start_in_trial"].values.astype(int),
+                        metadata["i_start_in_trial"].values,
                         np.zeros(len(metadata), dtype=int),
-                        event_ids,
+                        metadata["target"].values,
                     ]
                 )
                 epochs = mne.EpochsArray(data, info, events=events, metadata=metadata)

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/braindecode/models/__init__.py

@@ -12,7 +12,6 @@ from .contrawr import ContraWR
 from .ctnet import CTNet
 from .deep4 import Deep4Net
 from .deepsleepnet import DeepSleepNet
-from .dgcnn import DGCNN
 from .eegconformer import EEGConformer
 from .eeginception_erp import EEGInceptionERP
 from .eeginception_mi import EEGInceptionMI
@@ -88,7 +87,6 @@ __all__ = [
     "EEGSym",
     "EEGSimpleConv",
     "EEGTCNet",
-    "DGCNN",
     "FBCNet",
     "FBLightConvNet",
     "FBMSNet",

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/braindecode/models/base.py

@@ -86,44 +86,38 @@ class EEGModuleMixin(_BaseHubMixin, metaclass=NumpyDocstringInheritanceInitMeta)
     -----
     If some input signal-related parameters are not specified,
     there will be an attempt to infer them from the other parameters.
-    """
 
-    #: Template for model-specific Hub integration notes appended by
-    #: ``__init_subclass__``.  ``{name}`` is replaced with the concrete
-    #: model class name.
-    _HUB_NOTES_TEMPLATE = """
     .. rubric:: Hugging Face Hub integration
 
     When the optional ``huggingface_hub`` package is installed, all models
     automatically gain the ability to be pushed to and loaded from the
     Hugging Face Hub. Install with::
 
-        pip install braindecode[hub]
+        pip install braindecode[hug]
 
     **Pushing a model to the Hub:**
 
-    .. code-block::
+    .. code-block:: python
 
-        from braindecode.models import {name}
+        from braindecode.models import EEGNetv4
 
         # Train your model
-        model = {name}(n_chans=22, n_outputs=4, n_times=1000)
+        model = EEGNetv4(n_chans=22, n_outputs=4, n_times=1000)
         # ... training code ...
 
         # Push to the Hub
         model.push_to_hub(
-            repo_id="username/my-{name_lower}-model",
-            commit_message="Initial model upload",
+            repo_id="username/my-eegnet-model", commit_message="Initial model upload"
         )
 
     **Loading a model from the Hub:**
 
-    .. code-block::
+    .. code-block:: python
 
-        from braindecode.models import {name}
+        from braindecode.models import EEGNetv4
 
         # Load pretrained model
-        model = {name}.from_pretrained("username/my-{name_lower}-model")
+        model = EEGNetv4.from_pretrained("username/my-eegnet-model")
 
     The integration automatically handles EEG-specific parameters (n_chans,
     n_times, sfreq, chs_info, etc.) by saving them in a config file alongside
@@ -132,24 +126,19 @@ class EEGModuleMixin(_BaseHubMixin, metaclass=NumpyDocstringInheritanceInitMeta)
 
     .. important::
         Currently, only EEG-specific parameters (n_outputs, n_chans, n_times,
-        input_window_seconds, sfreq, chs_info) are saved to the Hub.
-        Model-specific parameters (e.g., dropout rates, activation functions,
-        number of filters) are not preserved and will use their default values
-        when loading from the Hub.
+        input_window_seconds, sfreq, chs_info) are saved to the Hub. Model-specific
+        parameters (e.g., dropout rates, activation functions, number of filters)
+        are not preserved and will use their default values when loading from the Hub.
+
+        To use non-default model parameters, specify them explicitly when calling
+        :func:`from_pretrained()`::
+
+            model = EEGNet.from_pretrained("user/model", dropout=0.3, activation='relu')
+
         Full parameter serialization will be addressed in a future update.
     """
 
     def __init_subclass__(cls, **kwargs):
-        # Append model-specific Hub integration notes to the docstring.
-        # This runs after the metaclass, so we concatenate rather than
-        # override any existing Notes section in the subclass.
-        if cls.__doc__ is not None:
-            hub_notes = cls._HUB_NOTES_TEMPLATE.format(
-                name=cls.__name__,
-                name_lower=cls.__name__.lower(),
-            )
-            cls.__doc__ = cls.__doc__.rstrip() + "\n" + hub_notes
-
         if not HAS_HF_HUB:
             super().__init_subclass__(**kwargs)
             return

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/braindecode/models/eegsym.py

@@ -112,7 +112,7 @@ class EEGSym(EEGModuleMixin, nn.Module):
         corresponding to different frequency characteristics.
 
     Notes
-    -----
+    ----------
     * EEGSym achieved competitive accuracies across five large MI datasets [eegsym2022]_.
     * The model maintained high accuracy using a reduced set of electrodes (8 or 16 channels)
       [eegsym2022]_.

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/braindecode/models/sstdpn.py

@@ -133,7 +133,7 @@ class SSTDPN(EEGModuleMixin, nn.Module):
         learning data, according to [Han2025]_.
 
     Notes
-    -----
+    ----------
     * The implementation of the DPL loss functions (:math:`\mathcal{L}_S`, :math:`\mathcal{L}_C`, :math:`\mathcal{L}_{EF}`)
       and the optimization of ICPs are typically handled outside the primary ``forward`` method, within the training strategy
       (see Ref. 52 in [Han2025]_).

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/braindecode/models/summary.csv

@@ -47,4 +47,3 @@ BENDR,General,"Classification,Embedding",250,"n_chans, n_times, n_outputs",15714
 LUNA,General,"Classification,Embedding",128,"n_chans, n_times, sfreq, chs_info",7100731,"LUNA(n_chans=22, n_times=512, sfreq=128)","Convolution,Channel,Foundation Model"
 MEDFormer,General,Classification,250,"n_chans, n_outputs, n_times",5313924,"MEDFormer(n_chans=22, n_outputs=4, n_times=1000)","Foundation Model,Convolution"
 REVE,General,Classification,200,"n_outputs, n_times, n_chans",69481476,"REVE(n_times=1000, n_outputs=4, n_chans=19)","Foundation Model,Attention/Transformer"
-DGCNN,Emotion Recognition,Classification,128,"n_chans, n_outputs, n_times, chs_info",1037385,"DGCNN(n_chans=62, n_outputs=4, n_times=128)","Graph Neural Network,Channel"

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/braindecode/models/util.py

@@ -133,7 +133,6 @@ models_mandatory_parameters: list[
         },
     ),
     ("CBraMod", ["n_outputs"], None),
-    ("DGCNN", ["n_chans", "n_outputs", "n_times", "chs_info"], None),
 ]
 
 ################################################################
@@ -302,7 +301,7 @@ def extract_channel_locations_from_chs_info(
     ----------
     chs_info : list of dict or None
         Channel information, typically from ``mne.Info.chs``. Each dict should
-        contain a 'loc' key with a 12-element array (MNE format) where indices 0:3
+        contain a 'loc' key with a 12-element array (MNE format) where indices 3:6
         represent the 3D cartesian coordinates.
     num_channels : int or None
         If specified, only extract the first ``num_channels`` channel locations.
@@ -316,7 +315,7 @@ def extract_channel_locations_from_chs_info(
 
     Notes
     -----
-    - This function handles both 12-element MNE location format (using indices 0:3)
+    - This function handles both 12-element MNE location format (using indices 3:6)
       and 3-element location format (using directly).
     - Invalid or missing locations cause extraction to stop at that point.
     - Returns None if no valid locations can be extracted.
@@ -348,9 +347,14 @@ def extract_channel_locations_from_chs_info(
         try:
             loc_array = np.asarray(loc, dtype=np.float32)
 
-            # MNE format: 12-element array with electrode position at indices 0:3
-            if loc_array.ndim == 1 and loc_array.size >= 3:
-                coordinates = loc_array[:3]
+            # MNE format: 12-element array with coordinates at indices 3:6
+            if loc_array.ndim == 1 and loc_array.size >= 6:
+                if loc_array.size == 12:
+                    # Standard MNE format
+                    coordinates = loc_array[3:6]
+                else:
+                    # Assume first 3 elements are coordinates
+                    coordinates = loc_array[:3]
             else:
                 break
 
@@ -361,13 +365,7 @@ def extract_channel_locations_from_chs_info(
     if len(locations) == 0:
         return None
 
-    result = np.stack(locations, axis=0)
-
-    # Check positions are not all zero / degenerate
-    if np.allclose(result, 0):
-        return None
-
-    return result
+    return np.stack(locations, axis=0)
 
 
 _summary_table = get_summary_table()

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/braindecode/modules/attention.py

@@ -8,7 +8,6 @@ AttentionBaseNet class.
 
 # Authors: Martin Wimpff <martin.wimpff@iss.uni-stuttgart.de>
 #          Bruno Aristimunha <b.aristimunha@gmail.com>
-#          Sarthak Tayal <sarthaktayal2@gmail.com>
 #
 # License: BSD (3-clause)
 
@@ -61,7 +60,7 @@ class SqueezeAndExcitation(nn.Module):
         )
         self.nonlinearity = nn.ReLU()
         self.fc2 = nn.Conv2d(
-            in_channels=sq_channels,
+            in_channels=reduction_rate,
             out_channels=in_channels,
             kernel_size=1,
             bias=bias,

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/braindecode/preprocessing/mne_preprocess.py

@@ -11,7 +11,6 @@ import mne.io
 import mne.preprocessing
 
 from braindecode.preprocessing.preprocess import Preprocessor
-from braindecode.util import _clean_docstring_sections
 
 
 def _is_standalone_function(func):
@@ -150,7 +149,7 @@ def _generate_mne_pre_processor(function):
     force_copy_false = is_standalone and has_copy_param
     class_attrs = {
         "__init__": _generate_init_method(function, force_copy_false),
-        "__doc__": wrapper_note + _clean_docstring_sections(function.__doc__ or ""),
+        "__doc__": wrapper_note + (function.__doc__ or ""),
         "__repr__": _generate_repr_method(class_name),
         "fn": function if is_standalone else function.__name__,
         "_is_standalone": is_standalone,

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/braindecode/preprocessing/preprocess.py

@@ -5,7 +5,6 @@
 #          Simon Brandt <simonbrandt@protonmail.com>
 #          David Sabbagh <dav.sabbagh@gmail.com>
 #          Bruno Aristimunha <b.aristimunha@gmail.com>
-#          Léo Burgund <leo.burgund@gmail.com>
 #
 # License: BSD (3-clause)
 
@@ -25,11 +24,11 @@ else:
     from collections.abc import Callable
 
 import numpy as np
+import pandas as pd
 from joblib import Parallel, delayed
 from mne import BaseEpochs, create_info
 from mne.io import BaseRaw
 from numpy.typing import NDArray
-from scipy.signal import lfilter
 
 from braindecode.datasets.base import (
     BaseConcatDataset,
@@ -425,17 +424,14 @@ def exponential_moving_standardize(
 ):
     r"""Perform exponential moving standardization.
 
-    Compute the exponential moving mean :math:`m_t` at time `t` as
-    a weighted average:
-    :math:`m_t = \frac{\sum_{i=0}^t (1-\alpha)^i x_{t-i}}{\sum_{i=0}^t (1-\alpha)^i}`
-    where :math:`\alpha` is ``factor_new``.
+    Compute the exponental moving mean :math:`m_t` at time `t` as
+    :math:`m_t=\mathrm{factornew} \cdot mean(x_t) + (1 - \mathrm{factornew}) \cdot m_{t-1}`.
 
     Then, compute exponential moving variance :math:`v_t` at time `t` as
-    a weighted average of the squared demeaned signal:
-    :math:`v_t = \frac{\sum_{i=0}^t (1-\alpha)^i (x_{t-i} - m_{t-i})^2}{\sum_{i=0}^t (1-\alpha)^i}`.
+    :math:`v_t=\mathrm{factornew} \cdot (m_t - x_t)^2 + (1 - \mathrm{factornew}) \cdot v_{t-1}`.
 
     Finally, standardize the data point :math:`x_t` at time `t` as:
-    :math:`x'_t=(x_t - m_t) / max(\sqrt{v_t}, eps)`.
+    :math:`x'_t=(x_t - m_t) / max(\sqrt{->v_t}, eps)`.
 
 
     Parameters
@@ -452,52 +448,34 @@ def exponential_moving_standardize(
     standardized: np.ndarray (n_channels, n_times)
         Standardized data.
     """
-    if not (0 < factor_new <= 1):
-        raise ValueError(f"factor_new must be between 0 and 1, got {factor_new}")
-
-    # We use a ratio of two linear filters:
-    # y_t = N_t / D_t
-    # N_t = x_t + (1-alpha) * N_{t-1}, N_0 = x_0
-    # D_t = 1 + (1-alpha) * D_{t-1}, D_0 = 1
-    alpha = factor_new
-    _, n_times = data.shape
-    inv_alpha = 1.0 - alpha
-
-    # Filter a sequence of ones: [1, 1+(1-a), 1+(1-a)+(1-a)^2, ...]
-    d = lfilter([1.0], [1.0, -inv_alpha], np.ones(n_times))
-
-    n = lfilter([1.0], [1.0, -inv_alpha], data, axis=1)
-    meaned = n / d
-    demeaned = data - meaned
-
+    data = data.T
+    df = pd.DataFrame(data)
+    meaned = df.ewm(alpha=factor_new).mean()
+    demeaned = df - meaned
     squared = demeaned * demeaned
-    n_sq = lfilter([1.0], [1.0, -inv_alpha], squared, axis=1)
-    square_ewmed = n_sq / d
-
-    standardized = demeaned / np.maximum(eps, np.sqrt(square_ewmed))
-
+    square_ewmed = squared.ewm(alpha=factor_new).mean()
+    standardized = demeaned / np.maximum(eps, np.sqrt(np.array(square_ewmed)))
+    standardized = np.array(standardized)
     if init_block_size is not None:
-        init_mean = np.mean(data[:, :init_block_size], axis=1, keepdims=True)
-        init_std = np.std(data[:, :init_block_size], axis=1, keepdims=True)
-        init_block_standardized = (data[:, :init_block_size] - init_mean) / np.maximum(
+        i_time_axis = 0
+        init_mean = np.mean(data[0:init_block_size], axis=i_time_axis, keepdims=True)
+        init_std = np.std(data[0:init_block_size], axis=i_time_axis, keepdims=True)
+        init_block_standardized = (data[0:init_block_size] - init_mean) / np.maximum(
             eps, init_std
         )
-        standardized[:, :init_block_size] = init_block_standardized
-
-    return standardized
+        standardized[0:init_block_size] = init_block_standardized
+    return standardized.T
 
 
 def exponential_moving_demean(
     data: NDArray, factor_new: float = 0.001, init_block_size: int | None = None
 ):
-    r"""Perform exponential moving demeaning.
+    r"""Perform exponential moving demeanining.
 
-    Compute the exponential moving mean :math:`m_t` at time `t` as
-    a weighted average:
-    :math:`m_t = \frac{\sum_{i=0}^t (1-\alpha)^i x_{t-i}}{\sum_{i=0}^t (1-\alpha)^i}`
-    where :math:`\alpha` is ``factor_new``.
+    Compute the exponental moving mean :math:`m_t` at time `t` as
+    :math:`m_t=\mathrm{factornew} \cdot mean(x_t) + (1 - \mathrm{factornew}) \cdot m_{t-1}`.
 
-    Demean the data point :math:`x_t` at time `t` as:
+    Deman the data point :math:`x_t` at time `t` as:
     :math:`x'_t=(x_t - m_t)`.
 
     Parameters
@@ -512,24 +490,16 @@ def exponential_moving_demean(
     demeaned: np.ndarray (n_channels, n_times)
         Demeaned data.
     """
-    if not (0 < factor_new <= 1):
-        raise ValueError(f"factor_new must be between 0 and 1, got {factor_new}")
-
-    alpha = factor_new
-    _, n_times = data.shape
-    inv_alpha = 1.0 - alpha
-
-    d = lfilter([1.0], [1.0, -inv_alpha], np.ones(n_times))
-
-    n = lfilter([1.0], [1.0, -inv_alpha], data, axis=1)
-    meaned = n / d
-    demeaned = data - meaned
-
+    data = data.T
+    df = pd.DataFrame(data)
+    meaned = df.ewm(alpha=factor_new).mean()
+    demeaned = df - meaned
+    demeaned = np.array(demeaned)
     if init_block_size is not None:
-        init_mean = np.mean(data[:, :init_block_size], axis=1, keepdims=True)
-        demeaned[:, :init_block_size] = data[:, :init_block_size] - init_mean
-
-    return demeaned
+        i_time_axis = 0
+        init_mean = np.mean(data[0:init_block_size], axis=i_time_axis, keepdims=True)
+        demeaned[0:init_block_size] = data[0:init_block_size] - init_mean
+    return demeaned.T
 
 
 def filterbank(

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/braindecode/util.py

@@ -384,42 +384,12 @@ def update_estimator_docstring(base_class, docstring):
     return out_docstring
 
 
-def _clean_docstring_sections(doc, remove_sections=("References",)):
-    """Remove numpydoc-style sections that cause Sphinx build errors.
-
-    Numpydoc renders section headers as ``.. rubric::`` directives.
-    When the section body contains indented RST directives (e.g.
-    ``.. footbibliography::`` or ``.. [citation]``), Sphinx errors
-    because rubric does not accept body content.  Stripping these
-    sections from the *raw* docstring prevents numpydoc from
-    generating the problematic output.
-    """
-    if not doc:
-        return doc or ""
-
-    for section in remove_sections:
-        # Match the section header + underline + body lines that follow.
-        # The body stops at the next numpydoc section (an optionally-indented
-        # word line followed by a dashes-only underline) or at end-of-string.
-        doc = re.sub(
-            rf"(\n[ \t]*){re.escape(section)}\n[ \t]*-+\n"
-            r"(?:(?![ \t]*\w[^\n]*\n[ \t]*-+)(?:[ \t]+[^\n]*\n|[ \t]*\n))*",
-            r"\1",
-            doc,
-        )
-    return doc
-
-
 def _update_moabb_docstring(base_class, docstring):
     base_doc = base_class.__doc__
-    if base_doc is None:
-        return docstring
-    base_doc = _clean_docstring_sections(
-        base_doc, remove_sections=("References", "Notes")
-    )
-    # Strip dangling citation references (e.g. ``[1]_``) whose definitions
-    # were in the removed References section.
-    base_doc = re.sub(r"\s*\[\d+\]_", "", base_doc)
+    # Clean up malformed rubrics from moabb docstrings
+    # Remove lines that have ".. rubric::" followed by content on same line or improper formatting
+
+    base_doc = re.sub(r"\.\. rubric:: (.+?)\n\s+\.\. note::", r".. note::", base_doc)
     out_docstring = base_doc + f"\n\n{docstring}"
     return out_docstring
 

braindecode-1.3.2.dev174123093/braindecode/version.py

@@ -0,0 +1 @@
+__version__ = "1.3.2.dev174123093"

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093/braindecode.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: braindecode
-Version: 1.3.2.dev173801889
+Version: 1.3.2.dev174123093
 Summary: Deep learning software to decode EEG, ECG or MEG signals
 Author-email: Robin Tibor Schirrmeister <robintibor@gmail.com>, Bruno Aristimunha Pinto <b.aristimunha@gmail.com>, Alexandre Gramfort <agramfort@meta.com>
 Maintainer-email: Alexandre Gramfort <agramfort@meta.com>, Bruno Aristimunha Pinto <b.aristimunha@gmail.com>, Robin Tibor Schirrmeister <robintibor@gmail.com>

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/braindecode.egg-info/SOURCES.txt

@@ -64,7 +64,6 @@ braindecode/models/contrawr.py
 braindecode/models/ctnet.py
 braindecode/models/deep4.py
 braindecode/models/deepsleepnet.py
-braindecode/models/dgcnn.py
 braindecode/models/eegconformer.py
 braindecode/models/eeginception_erp.py
 braindecode/models/eeginception_mi.py

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/docs/api.rst

@@ -15,7 +15,7 @@
 ********
 
 Model zoo availables in braindecode. The models are implemented as ``PyTorch``
-:py:class:`torch.nn.Module` and can be used for various EEG decoding ways tasks.
+:py:class:`torch.nn.Modules` and can be used for various EEG decoding ways tasks.
 
 All the models have the convention of having the signal related parameters named the
 same way, following the braindecode's standards:
@@ -27,24 +27,23 @@ same way, following the braindecode's standards:
 - (:fa:`clock`/ :fa:`wifi`\) ``input_window_seconds``: Length of the input window in
   seconds.
 - :fa:`info-circle` ``chs_info``: Information about each individual EEG channel. Refer
-  to :class:`mne.Info` (see its ``"chs"`` field for details).
+  to :class:`mne.Info["chs"]`.
 
 All the models assume that the input data is a 3D tensor of shape ``(batch_size,
 n_chans, n_times)``, and some models also accept a 4D tensor of shape ``(batch_size,
 n_chans, n_times, n_epochs)``, in case of cropped model.
 
-All the models are implemented as subclasses of
-:py:class:`~braindecode.models.EEGModuleMixin`, which is a base class for all EEG models
-in Braindecode. The :class:`~braindecode.models.EEGModuleMixin` class provides a common
-interface for all EEG models and can derive variable names when needed.
+All the models are implemented as subclasses of :py:class:`EEGModuleMixin`, which is a
+base class for all EEG models in Braindecode. The :class:`EEGModuleMixin` class provides
+a common interface for all EEG models and derivate variables names if necessary.
 
 .. important::
 
     **Hugging Face Hub Integration**
 
     All models in braindecode naturally possess the capability to push and pull from the
-    Hugging Face Hub through inheritance from
-    :class:`~huggingface_hub.PyTorchModelHubMixin`. This allows you to:
+    Hugging Face Hub through inheritance from :class:`PyTorchModelHubMixin`. This allows
+    you to:
 
     - **Load pre-trained models** from the Hub using
       ``Model.from_pretrained("repo_id")``
@@ -101,8 +100,8 @@ interface for all EEG models and can derive variable names when needed.
             repo_id="username/my-eegnex-model", commit_message="Initial model upload"
         )
 
-    For more details, see the :class:`~braindecode.models.EEGModuleMixin` documentation
-    and the :ref:`hub-integration` tutorial.
+    For more details, see the :class:`EEGModuleMixin` documentation and the
+    :ref:`hub-integration` tutorial.
 
 :note: Auto-generated Pydantic configs are available when the optional
     ``braindecode[pydantic]`` extra (which installs ``pydantic`` and ``numpydantic``) is
@@ -136,7 +135,6 @@ interface for all EEG models and can derive variable names when needed.
      CBraMod
      ContraWR
      CTNet
-     DGCNN
      Deep4Net
      DeepSleepNet
      EEGConformer

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/docs/conf.py

@@ -25,11 +25,6 @@ import os.path as op
 import sys
 import warnings
 
-# Enable docstring inheritance before any braindecode imports so that
-# NumpyDocstringInheritanceInitMeta merges parent parameters into child
-# class docstrings (e.g. EEGModuleMixin params into every model).
-os.environ["DOCSTRING_INHERITANCE_ENABLE"] = "1"
-
 import matplotlib
 
 matplotlib.use("agg")
@@ -72,8 +67,7 @@ except Exception as e:
 needs_sphinx = "2.0"
 
 curdir = os.path.dirname(__file__)
-# Ensure the local braindecode package is found before any editable install
-sys.path.insert(0, os.path.abspath(os.path.join(curdir, "..")))
+sys.path.append(os.path.abspath(os.path.join(curdir, "..", "braindecode")))
 sys.path.append(os.path.abspath(os.path.join(curdir, "sphinxext")))
 
 import sphinx_design
@@ -265,19 +259,13 @@ todo_include_todos = True
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {
     "python": ("https://docs.python.org/{.major}".format(sys.version_info), None),
-    "numpy": ("https://numpy.org/doc/stable/", None),
-    "scipy": ("https://docs.scipy.org/doc/scipy/", None),
-    "matplotlib": ("https://matplotlib.org/stable/", None),
-    "sklearn": ("https://scikit-learn.org/stable/", None),
-    "mne": ("https://mne.tools/stable/", None),
+    "numpy": ("https://docs.scipy.org/doc/numpy/", None),
+    "scipy": ("https://docs.scipy.org/doc/scipy/reference", None),
+    "matplotlib": ("https://matplotlib.org/", None),
+    "sklearn": ("http://scikit-learn.org/stable", None),
+    "mne": ("http://mne.tools/stable", None),
     "skorch": ("https://skorch.readthedocs.io/en/stable/", None),
     "torch": ("https://pytorch.org/docs/stable/", None),
-    "huggingface_hub": (
-        "https://huggingface.co/docs/huggingface_hub/main/en/",
-        None,
-    ),
-    "mne_bids": ("https://mne.tools/mne-bids/stable/", None),
-    "spd_learn": ("https://spdlearn.org/", None),
 }
 
 sphinx_gallery_conf = {

{braindecode-1.3.2.dev173801889 → braindecode-1.3.2.dev174123093}/docs/models/categorization/gnn.rst

@@ -15,15 +15,7 @@
 
 :bdg-light:`Graph Neural Network`
 
-This category contains graph-based models that treat EEG electrodes as graph nodes and
-learn inter-channel relationships dynamically.
-
-.. rubric:: Available Models
-
-- :class:`DGCNN` — Dynamic Graph Convolutional Neural Network. Treats electrodes as
-  graph nodes and learns the adjacency matrix jointly with all other parameters via
-  back-propagation. Uses Chebyshev spectral graph convolution to extract spatial
-  features from the learned graph Laplacian. Based on Song et al. (2018).
+I doesn't know much about GNNs for EEG yet. No LitMap available.
 
 .. include:: ../../links.inc
 

braindecode-1.3.2.dev174123093/docs/models/categorization/spd.rst

@@ -0,0 +1,35 @@
+:html_theme.sidebar_secondary.remove: true
+
+.. currentmodule:: braindecode.models
+
+.. _models_spd:
+
+########################################
+ |spd-icon| Symmetric Positive-Definite
+########################################
+
+.. |spd-icon| image:: ../../_static/model_cat/spd.png
+    :alt: Symmetric Positive-Definite icon
+    :height: 56px
+    :class: heading-icon no-scaled-link
+
+:bdg-success:`Symmetric Positive-Definite (SPD)`
+
+.. figure:: ../../_static/model_connection/litmap_spd_learn.png
+    :width: 100%
+    :align: center
+
+    Figure: `LitMap
+    <https://app.litmaps.com/shared/bcd44ea5-9d52-46ed-9948-4b34714d4f05>`__ **with
+    symmetric positive-definite layers, last updated 26/08/2025.** Each node is a paper;
+    rightward means more recently published, upward more cited, and links show amount of
+    citation with logaritm scale.
+
+.. include:: ../../links.inc
+
+.. raw:: html
+
+    <style>
+      /* nudge the icon so it sits nicely on the baseline */
+      img.heading-icon { vertical-align: -0.2em; margin-right: .45rem; }
+    </style>