Braindecode 1.2.0.dev182094932__tar.gz → 1.2.0.dev184328194__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (122) hide show
  1. {braindecode-1.2.0.dev182094932/braindecode.egg-info → braindecode-1.2.0.dev184328194}/PKG-INFO +1 -1
  2. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/eegnet.py +4 -54
  3. braindecode-1.2.0.dev184328194/braindecode/version.py +1 -0
  4. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194/braindecode.egg-info}/PKG-INFO +1 -1
  5. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/conf.py +0 -3
  6. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/whats_new.rst +0 -5
  7. braindecode-1.2.0.dev182094932/braindecode/version.py +0 -1
  8. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/LICENSE.txt +0 -0
  9. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/MANIFEST.in +0 -0
  10. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/NOTICE.txt +0 -0
  11. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/README.rst +0 -0
  12. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/__init__.py +0 -0
  13. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/augmentation/__init__.py +0 -0
  14. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/augmentation/base.py +0 -0
  15. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/augmentation/functional.py +0 -0
  16. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/augmentation/transforms.py +0 -0
  17. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/classifier.py +0 -0
  18. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datasets/__init__.py +0 -0
  19. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datasets/base.py +0 -0
  20. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datasets/bbci.py +0 -0
  21. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datasets/bcicomp.py +0 -0
  22. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datasets/bids.py +0 -0
  23. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datasets/mne.py +0 -0
  24. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datasets/moabb.py +0 -0
  25. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datasets/nmt.py +0 -0
  26. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datasets/sleep_physio_challe_18.py +0 -0
  27. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datasets/sleep_physionet.py +0 -0
  28. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datasets/tuh.py +0 -0
  29. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datasets/xy.py +0 -0
  30. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datautil/__init__.py +0 -0
  31. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datautil/serialization.py +0 -0
  32. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/datautil/util.py +0 -0
  33. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/eegneuralnet.py +0 -0
  34. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/functional/__init__.py +0 -0
  35. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/functional/functions.py +0 -0
  36. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/functional/initialization.py +0 -0
  37. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/__init__.py +0 -0
  38. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/atcnet.py +0 -0
  39. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/attentionbasenet.py +0 -0
  40. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/base.py +0 -0
  41. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/biot.py +0 -0
  42. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/contrawr.py +0 -0
  43. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/ctnet.py +0 -0
  44. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/deep4.py +0 -0
  45. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/deepsleepnet.py +0 -0
  46. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/eegconformer.py +0 -0
  47. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/eeginception_erp.py +0 -0
  48. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/eeginception_mi.py +0 -0
  49. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/eegitnet.py +0 -0
  50. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/eegminer.py +0 -0
  51. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/eegnex.py +0 -0
  52. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/eegresnet.py +0 -0
  53. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/eegsimpleconv.py +0 -0
  54. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/eegtcnet.py +0 -0
  55. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/fbcnet.py +0 -0
  56. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/fblightconvnet.py +0 -0
  57. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/fbmsnet.py +0 -0
  58. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/hybrid.py +0 -0
  59. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/ifnet.py +0 -0
  60. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/labram.py +0 -0
  61. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/msvtnet.py +0 -0
  62. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/sccnet.py +0 -0
  63. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/shallow_fbcsp.py +0 -0
  64. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/signal_jepa.py +0 -0
  65. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/sinc_shallow.py +0 -0
  66. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/sleep_stager_blanco_2020.py +0 -0
  67. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/sleep_stager_chambon_2018.py +0 -0
  68. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/sleep_stager_eldele_2021.py +0 -0
  69. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/sparcnet.py +0 -0
  70. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/summary.csv +0 -0
  71. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/syncnet.py +0 -0
  72. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/tcn.py +0 -0
  73. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/tidnet.py +0 -0
  74. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/tsinception.py +0 -0
  75. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/usleep.py +0 -0
  76. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/models/util.py +0 -0
  77. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/modules/__init__.py +0 -0
  78. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/modules/activation.py +0 -0
  79. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/modules/attention.py +0 -0
  80. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/modules/blocks.py +0 -0
  81. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/modules/convolution.py +0 -0
  82. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/modules/filter.py +0 -0
  83. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/modules/layers.py +0 -0
  84. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/modules/linear.py +0 -0
  85. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/modules/parametrization.py +0 -0
  86. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/modules/stats.py +0 -0
  87. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/modules/util.py +0 -0
  88. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/modules/wrapper.py +0 -0
  89. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/preprocessing/__init__.py +0 -0
  90. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/preprocessing/mne_preprocess.py +0 -0
  91. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/preprocessing/preprocess.py +0 -0
  92. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/preprocessing/windowers.py +0 -0
  93. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/regressor.py +0 -0
  94. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/samplers/__init__.py +0 -0
  95. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/samplers/base.py +0 -0
  96. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/samplers/ssl.py +0 -0
  97. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/training/__init__.py +0 -0
  98. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/training/callbacks.py +0 -0
  99. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/training/losses.py +0 -0
  100. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/training/scoring.py +0 -0
  101. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/util.py +0 -0
  102. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/visualization/__init__.py +0 -0
  103. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/visualization/confusion_matrices.py +0 -0
  104. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode/visualization/gradients.py +0 -0
  105. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode.egg-info/SOURCES.txt +0 -0
  106. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode.egg-info/dependency_links.txt +0 -0
  107. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode.egg-info/requires.txt +0 -0
  108. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/braindecode.egg-info/top_level.txt +0 -0
  109. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/Makefile +0 -0
  110. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/_templates/autosummary/class.rst +0 -0
  111. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/_templates/autosummary/function.rst +0 -0
  112. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/api.rst +0 -0
  113. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/cite.rst +0 -0
  114. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/help.rst +0 -0
  115. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/index.rst +0 -0
  116. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/install/install.rst +0 -0
  117. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/install/install_pip.rst +0 -0
  118. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/install/install_source.rst +0 -0
  119. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/models_summary.rst +0 -0
  120. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/docs/sg_execution_times.rst +0 -0
  121. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/pyproject.toml +0 -0
  122. {braindecode-1.2.0.dev182094932 → braindecode-1.2.0.dev184328194}/setup.cfg +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: braindecode
3
- Version: 1.2.0.dev182094932
3
+ Version: 1.2.0.dev184328194
4
4
  Summary: Deep learning software to decode EEG, ECG or MEG signals
5
5
  Author-email: Robin Tibor Schirrmeister <robintibor@gmail.com>
6
6
  Maintainer-email: Alexandre Gramfort <agramfort@meta.com>, Bruno Aristimunha Pinto <b.aristimunha@gmail.com>, Robin Tibor Schirrmeister <robintibor@gmail.com>
@@ -20,60 +20,13 @@ from braindecode.modules import (
20
20
 
21
21
 
22
22
  class EEGNetv4(EEGModuleMixin, nn.Sequential):
23
- """EEGNet v4 model from Lawhern et al. (2018) [Lawhern2018]_.
24
-
25
- :bdg-success:`Convolution` :bdg-secondary:`Depthwise–Separable`
23
+ """EEGNet v4 model from Lawhern et al. (2018) [EEGNet4]_.
26
24
 
27
25
  .. figure:: https://content.cld.iop.org/journals/1741-2552/15/5/056013/revision2/jneaace8cf01_hr.jpg
28
26
  :align: center
29
- :alt: EEGNetv4 Architecture
30
- :width: 600px
31
-
32
- .. rubric:: Architectural Overview
33
-
34
- EEGNetv4 is a compact convolutional network designed for EEG decoding with a
35
- pipeline that mirrors classical EEG processing:
36
- - (i) learn temporal frequency-selective filters,
37
- - (ii) learn spatial filters for those frequencies, and
38
- - (iii) condense features with depthwise–separable convolutions before a lightweight classifier.
39
-
40
- The architecture is deliberately small (temporal convolutional and spatial patterns) [Lawhern2018]_.
41
-
42
- .. rubric:: Macro Components
43
-
44
- - **Temporal convolution**
45
- Temporal convolution applied per channel; learns ``F1`` kernels that act as data-driven band-pass filters.
46
- - **Depthwise Spatial Filtering.**
47
- Depthwise convolution spanning the channel dimension with ``groups = F1``,
48
- yielding ``D`` spatial filters for each temporal filter (no cross-filter mixing).
49
- - **Norm–Nonlinearity–Pooling (+ dropout).**
50
- Batch normalization → ELU → temporal pooling, with dropout.
51
- - **Depthwise–Separable Convolution Block.**
52
- (a) depthwise temporal conv to refine temporal structure;
53
- (b) pointwise 1x1 conv to mix feature maps into ``F2`` combinations.
54
- - **Classifier Head.**
55
- Lightweight 1x1 conv or dense layer (often with max-norm constraint).
27
+ :alt: EEGNet4 Architecture
56
28
 
57
- .. rubric:: Convolutional Details
58
-
59
- **Temporal.** The initial temporal convs serve as a *learned filter bank*:
60
- long 1-D kernels (implemented as 2-D with singleton spatial extent) emphasize oscillatory bands and transients.
61
- Because this stage is linear prior to BN/ELU, kernels can be analyzed as FIR filters to reveal each feature’s spectrum [Lawhern2018]_.
62
-
63
- **Spatial.** The depthwise spatial conv spans the full channel axis (kernel height = #electrodes; temporal size = 1).
64
- With ``groups = F1``, each temporal filter learns its own set of ``D`` spatial projections—akin to CSP, learned end-to-end and
65
- typically regularized with max-norm.
66
-
67
- **Spectral.** No explicit Fourier/wavelet transform is used. Frequency structure
68
- is captured implicitly by the temporal filter bank; later depthwise temporal kernels act as short-time integrators/refiners.
69
-
70
- .. rubric:: Additional Comments
71
-
72
- - **Filter-bank structure:** Parallel temporal kernels (``F1``) emulate classical filter banks; pairing them with frequency-specific spatial filters
73
- yields features mappable to rhythms and topographies.
74
- - **Depthwise & separable convs:** Parameter-efficient decomposition (depthwise + pointwise) retains power while limiting overfitting
75
- [Chollet2017]_ and keeps temporal vs. mixing steps interpretable.
76
- - **Regularization:** Batch norm, dropout, pooling, and optional max-norm on spatial kernels aid stability on small EEG datasets.
29
+ See details in [EEGNet4]_.
77
30
 
78
31
  Parameters
79
32
  ----------
@@ -115,13 +68,10 @@ class EEGNetv4(EEGModuleMixin, nn.Sequential):
115
68
 
116
69
  References
117
70
  ----------
118
- .. [Lawhern2018] Lawhern, V. J., Solon, A. J., Waytowich, N. R., Gordon, S. M.,
71
+ .. [EEGNet4] Lawhern, V. J., Solon, A. J., Waytowich, N. R., Gordon, S. M.,
119
72
  Hung, C. P., & Lance, B. J. (2018). EEGNet: a compact convolutional
120
73
  neural network for EEG-based brain–computer interfaces. Journal of
121
74
  neural engineering, 15(5), 056013.
122
- .. [Chollet2017] Chollet, F., *Xception: Deep Learning with Depthwise Separable
123
- Convolutions*, CVPR, 2017.
124
-
125
75
  """
126
76
 
127
77
  def __init__(
@@ -0,0 +1 @@
1
+ __version__ = "1.2.0.dev184328194"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: braindecode
3
- Version: 1.2.0.dev182094932
3
+ Version: 1.2.0.dev184328194
4
4
  Summary: Deep learning software to decode EEG, ECG or MEG signals
5
5
  Author-email: Robin Tibor Schirrmeister <robintibor@gmail.com>
6
6
  Maintainer-email: Alexandre Gramfort <agramfort@meta.com>, Bruno Aristimunha Pinto <b.aristimunha@gmail.com>, Robin Tibor Schirrmeister <robintibor@gmail.com>
@@ -166,9 +166,6 @@ templates_path = ["_templates"]
166
166
  # source_suffix = ['.rst', '.md']
167
167
  source_suffix = ".rst"
168
168
 
169
- rst_prolog = """
170
- .. role:: tag(bdg-success)
171
- """
172
169
  # The master toctree document.
173
170
  master_doc = "index"
174
171
 
@@ -22,11 +22,6 @@ Current 1.2 (dev)
22
22
 
23
23
  Enhancements
24
24
  ~~~~~~~~~~~~
25
- - Improving the docstring for :class:`braindecode.models.EEGNetv4` (:gh:`768` by `Bruno Aristimunha`_)
26
-
27
-
28
- API changes
29
- ~~~~~~~~~~~
30
25
 
31
26
  Bugs
32
27
  ~~~~
@@ -1 +0,0 @@
1
- __version__ = "1.2.0.dev182094932"