braindecode 1.8.0.dev183527593__tar.gz → 1.8.1.dev167853130__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 (213) hide show
  1. braindecode-1.8.1.dev167853130/NOTICE.txt +98 -0
  2. {braindecode-1.8.0.dev183527593/braindecode.egg-info → braindecode-1.8.1.dev167853130}/PKG-INFO +16 -8
  3. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/README.rst +6 -3
  4. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/augmentation/__init__.py +2 -0
  5. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/augmentation/functional.py +7 -3
  6. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/augmentation/transforms.py +189 -2
  7. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/classifier.py +9 -7
  8. braindecode-1.8.1.dev167853130/braindecode/datasets/_notebook_viewer.py +255 -0
  9. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/base.py +186 -8
  10. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/tuh.py +23 -10
  11. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datautil/serialization.py +14 -7
  12. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/eegneuralnet.py +1 -1
  13. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/functional/__init__.py +8 -0
  14. braindecode-1.8.1.dev167853130/braindecode/functional/_real_dft.py +193 -0
  15. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/functional/functions.py +206 -16
  16. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/__init__.py +51 -14
  17. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/atcnet.py +2 -2
  18. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/attn_sleep.py +9 -19
  19. braindecode-1.8.1.dev167853130/braindecode/models/axon.py +523 -0
  20. braindecode-1.8.1.dev167853130/braindecode/models/barista.py +703 -0
  21. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/base.py +187 -23
  22. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/bendr.py +75 -63
  23. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/biot.py +58 -70
  24. braindecode-1.8.1.dev167853130/braindecode/models/brainbert.py +447 -0
  25. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/brainmodule.py +7 -12
  26. braindecode-1.8.1.dev167853130/braindecode/models/brainomni.py +962 -0
  27. braindecode-1.8.1.dev167853130/braindecode/models/brant.py +480 -0
  28. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/cbramod.py +67 -26
  29. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/codebrain.py +121 -78
  30. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/config.py +1 -2
  31. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/contrawr.py +26 -4
  32. braindecode-1.8.1.dev167853130/braindecode/models/csbrain.py +767 -0
  33. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/ctnet.py +10 -7
  34. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/dance.py +3 -11
  35. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/deep4.py +38 -13
  36. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/dgcnn.py +14 -2
  37. braindecode-1.8.1.dev167853130/braindecode/models/diver1.py +940 -0
  38. braindecode-1.8.1.dev167853130/braindecode/models/eeg_clip.py +307 -0
  39. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/eegconformer.py +6 -3
  40. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/eegdino.py +34 -16
  41. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/eeginception_mi.py +48 -17
  42. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/eegminer.py +2 -1
  43. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/eegnex.py +16 -1
  44. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/eegpt.py +83 -112
  45. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/eegsimpleconv.py +9 -7
  46. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/eegsym.py +34 -8
  47. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/emg2qwerty.py +28 -135
  48. braindecode-1.8.1.dev167853130/braindecode/models/guetschel2026.py +775 -0
  49. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/ifnet.py +10 -6
  50. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/labram.py +411 -251
  51. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/luna.py +111 -42
  52. braindecode-1.8.1.dev167853130/braindecode/models/mapa.py +905 -0
  53. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/medformer.py +69 -34
  54. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/meta_neuromotor.py +104 -56
  55. braindecode-1.8.1.dev167853130/braindecode/models/mirepnet.py +389 -0
  56. braindecode-1.8.1.dev167853130/braindecode/models/mscformer.py +502 -0
  57. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/msvtnet.py +12 -8
  58. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/mvpformer.py +183 -190
  59. braindecode-1.8.1.dev167853130/braindecode/models/neuropose.py +440 -0
  60. braindecode-1.8.1.dev167853130/braindecode/models/neurorvq.py +625 -0
  61. braindecode-1.8.1.dev167853130/braindecode/models/neurorvq_tokenizer.py +627 -0
  62. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/patchedtransformer.py +3 -8
  63. braindecode-1.8.1.dev167853130/braindecode/models/popt.py +324 -0
  64. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/reve.py +83 -129
  65. braindecode-1.8.1.dev167853130/braindecode/models/seizure_transformer.py +407 -0
  66. braindecode-1.8.1.dev167853130/braindecode/models/sensingdynamics.py +466 -0
  67. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/shallow_fbcsp.py +15 -8
  68. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/signal_jepa.py +102 -47
  69. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/sleep_stager_blanco_2020.py +16 -13
  70. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/sleep_stager_chambon_2018.py +1 -7
  71. braindecode-1.8.1.dev167853130/braindecode/models/sleepfm.py +776 -0
  72. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/sparcnet.py +2 -2
  73. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/sstdpn.py +14 -11
  74. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/steegformer.py +76 -23
  75. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/summary.csv +25 -6
  76. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/syncnet.py +2 -2
  77. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/tcformer.py +31 -53
  78. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/tcn.py +5 -0
  79. braindecode-1.8.1.dev167853130/braindecode/models/tfm_tokenizer.py +409 -0
  80. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/tidnet.py +19 -8
  81. braindecode-1.8.1.dev167853130/braindecode/models/tmsanet.py +233 -0
  82. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/usleep.py +6 -9
  83. braindecode-1.8.1.dev167853130/braindecode/models/util.py +1326 -0
  84. braindecode-1.8.1.dev167853130/braindecode/models/vemg2pose.py +655 -0
  85. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/zuna.py +86 -68
  86. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/modules/__init__.py +22 -4
  87. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/modules/activation.py +14 -0
  88. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/modules/attention.py +64 -11
  89. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/modules/blocks.py +287 -10
  90. braindecode-1.8.1.dev167853130/braindecode/modules/channels.py +459 -0
  91. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/modules/convolution.py +29 -16
  92. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/modules/dance_modules.py +48 -27
  93. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/modules/filter.py +120 -67
  94. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/modules/layers.py +57 -25
  95. braindecode-1.8.1.dev167853130/braindecode/modules/linear_attention.py +128 -0
  96. braindecode-1.8.1.dev167853130/braindecode/modules/parametrization.py +91 -0
  97. braindecode-1.8.1.dev167853130/braindecode/modules/popt_modules.py +187 -0
  98. braindecode-1.8.1.dev167853130/braindecode/modules/quantization.py +422 -0
  99. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/modules/stats.py +6 -1
  100. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/preprocessing/preprocess.py +11 -0
  101. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/preprocessing/windowers.py +62 -14
  102. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/regressor.py +41 -8
  103. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/training/losses.py +7 -2
  104. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/training/scoring.py +18 -9
  105. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/util.py +44 -0
  106. braindecode-1.8.1.dev167853130/braindecode/version.py +1 -0
  107. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/visualization/__init__.py +6 -0
  108. braindecode-1.8.1.dev167853130/braindecode/visualization/activations.py +77 -0
  109. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/visualization/topology.py +1 -1
  110. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130/braindecode.egg-info}/PKG-INFO +16 -8
  111. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode.egg-info/SOURCES.txt +32 -3
  112. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode.egg-info/requires.txt +10 -4
  113. braindecode-1.8.1.dev167853130/docs/agent_docs.rst +60 -0
  114. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/api.rst +72 -7
  115. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/conf.py +13 -1
  116. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/index.rst +1 -0
  117. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/install/install.rst +4 -1
  118. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/models/models_categorization.rst +10 -3
  119. braindecode-1.8.1.dev167853130/docs/user_guide/channel_strategies.rst +59 -0
  120. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/whats_new.rst +747 -3
  121. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/pyproject.toml +11 -5
  122. braindecode-1.8.0.dev183527593/NOTICE.txt +0 -25
  123. braindecode-1.8.0.dev183527593/braindecode/models/interpolated.py +0 -182
  124. braindecode-1.8.0.dev183527593/braindecode/models/util.py +0 -797
  125. braindecode-1.8.0.dev183527593/braindecode/modules/interpolation.py +0 -201
  126. braindecode-1.8.0.dev183527593/braindecode/modules/parametrization.py +0 -38
  127. braindecode-1.8.0.dev183527593/braindecode/version.py +0 -1
  128. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/LICENSE.txt +0 -0
  129. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/MANIFEST.in +0 -0
  130. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/__init__.py +0 -0
  131. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/augmentation/base.py +0 -0
  132. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/__init__.py +0 -0
  133. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/bbci.py +0 -0
  134. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/bcicomp.py +0 -0
  135. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/bids/__init__.py +0 -0
  136. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/bids/datasets.py +0 -0
  137. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/bids/format.py +0 -0
  138. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/bids/hub.py +0 -0
  139. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/bids/hub_format.py +0 -0
  140. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/bids/hub_io.py +0 -0
  141. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/bids/hub_validation.py +0 -0
  142. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/bids/iterable.py +0 -0
  143. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/chb_mit.py +0 -0
  144. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/collate.py +0 -0
  145. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/mne.py +0 -0
  146. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/moabb.py +0 -0
  147. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/nmt.py +0 -0
  148. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/registry.py +0 -0
  149. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/siena.py +0 -0
  150. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/sleep_physio_challe_18.py +0 -0
  151. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/sleep_physionet.py +0 -0
  152. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/utils.py +0 -0
  153. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datasets/xy.py +0 -0
  154. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datautil/__init__.py +0 -0
  155. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datautil/channel_utils.py +0 -0
  156. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datautil/hub_formats.py +0 -0
  157. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/datautil/util.py +0 -0
  158. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/functional/initialization.py +0 -0
  159. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/attentionbasenet.py +0 -0
  160. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/deepsleepnet.py +0 -0
  161. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/eeginception_erp.py +0 -0
  162. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/eegitnet.py +0 -0
  163. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/eegnet.py +0 -0
  164. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/eegtcnet.py +0 -0
  165. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/fbcnet.py +0 -0
  166. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/fblightconvnet.py +0 -0
  167. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/fbmsnet.py +0 -0
  168. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/hybrid.py +0 -0
  169. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/sccnet.py +0 -0
  170. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/sinc_shallow.py +0 -0
  171. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/models/tsinception.py +0 -0
  172. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/modules/linear.py +0 -0
  173. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/modules/util.py +0 -0
  174. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/modules/wrapper.py +0 -0
  175. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/preprocessing/__init__.py +0 -0
  176. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/preprocessing/eegprep_preprocess.py +0 -0
  177. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/preprocessing/mne_preprocess.py +0 -0
  178. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/preprocessing/util.py +0 -0
  179. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/samplers/__init__.py +0 -0
  180. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/samplers/base.py +0 -0
  181. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/samplers/ssl.py +0 -0
  182. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/training/__init__.py +0 -0
  183. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/training/callbacks.py +0 -0
  184. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/visualization/attribution.py +0 -0
  185. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/visualization/confusion_matrices.py +0 -0
  186. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/visualization/frequency.py +0 -0
  187. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/visualization/metrics.py +0 -0
  188. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode/visualization/sanity.py +0 -0
  189. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode.egg-info/dependency_links.txt +0 -0
  190. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/braindecode.egg-info/top_level.txt +0 -0
  191. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/Makefile +0 -0
  192. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/_templates/autosummary/class.rst +0 -0
  193. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/_templates/autosummary/class_in_subdir.rst +0 -0
  194. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/_templates/autosummary/function.rst +0 -0
  195. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/_templates/autosummary/function_in_subdir.rst +0 -0
  196. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/cite.rst +0 -0
  197. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/help.rst +0 -0
  198. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/install/install_pip.rst +0 -0
  199. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/install/install_source.rst +0 -0
  200. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/models/categorization/attention.rst +0 -0
  201. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/models/categorization/channel.rst +0 -0
  202. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/models/categorization/convolution.rst +0 -0
  203. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/models/categorization/filterbank.rst +0 -0
  204. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/models/categorization/gnn.rst +0 -0
  205. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/models/categorization/interpretable.rst +0 -0
  206. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/models/categorization/lbm.rst +0 -0
  207. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/models/categorization/recurrent.rst +0 -0
  208. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/models/categorization/spd.rst +0 -0
  209. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/models/models.rst +0 -0
  210. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/models/models_table.rst +0 -0
  211. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/models/models_visualization.rst +0 -0
  212. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/docs/sg_execution_times.rst +0 -0
  213. {braindecode-1.8.0.dev183527593 → braindecode-1.8.1.dev167853130}/setup.cfg +0 -0
@@ -0,0 +1,98 @@
1
+ # BRAINDECODE Notice
2
+
3
+ ## Licensed Components
4
+
5
+ ### BSD-3-Clause Licensed Files
6
+
7
+ All files within the `braindecode/` package are licensed under the BSD-3-Clause
8
+ License, except for those listed in the sections below.
9
+
10
+ ### CC BY-NC 4.0 Licensed Files
11
+
12
+ The following components are licensed under the Creative Commons Attribution-NonCommercial 4.0 International License:
13
+
14
+ - `braindecode/models/eegminer.py`
15
+ - `braindecode/models/meta_neuromotor.py`
16
+ - `braindecode/models/sleepfm.py`
17
+ - `braindecode/models/brainmodule.py`
18
+ - `braindecode/models/neurorvq.py`
19
+ - `braindecode/models/neurorvq_tokenizer.py`
20
+
21
+ The `meta_neuromotor.py` file is a derivative of
22
+ `facebookresearch/generic-neuromotor-interface`, released by Meta Platforms,
23
+ Inc. under CC BY-NC 4.0, and inherits the same noncommercial terms.
24
+
25
+ ### CC BY-NC-SA 4.0 Licensed Files
26
+
27
+ The following components are licensed under the Creative Commons
28
+ Attribution-NonCommercial-ShareAlike 4.0 International License:
29
+
30
+ - `braindecode/models/emg2qwerty.py`
31
+ - `braindecode/models/vemg2pose.py`
32
+
33
+ The `emg2qwerty.py` file is a derivative of `facebookresearch/emg2qwerty`,
34
+ released by Meta Platforms, Inc. under CC BY-NC-SA 4.0, and inherits the
35
+ same noncommercial ShareAlike terms.
36
+
37
+ ### MIT Licensed Files
38
+
39
+ The following components are licensed under the MIT License:
40
+
41
+ - `braindecode/models/ctnet.py`
42
+ - `braindecode/models/dance.py`
43
+ - `braindecode/models/medformer.py`
44
+ - `braindecode/models/tcformer.py`
45
+ - `braindecode/models/ifnet.py`
46
+ - `braindecode/models/mirepnet.py`
47
+ - `braindecode/models/popt.py`
48
+ - `braindecode/models/tfm_tokenizer.py`
49
+ - `braindecode/modules/popt_modules.py`
50
+ - `braindecode/models/brainomni.py`
51
+ - `braindecode/modules/quantization.py`
52
+ - `braindecode/modules/linear_attention.py`
53
+ - `braindecode/models/seizure_transformer.py`
54
+ - `docs/_static/model/seizure_transformer_arch.png`
55
+ - `braindecode/models/guetschel2026.py`
56
+ - `braindecode/models/tmsanet.py`
57
+
58
+ The `brainomni.py` file is a derivative of `OpenTSLab/BrainOmni` (MIT), whose
59
+ SEANet codec derives from Meta's `facebookresearch/encodec` (MIT). The
60
+ `quantization.py` module holds the residual vector quantization derived from
61
+ `lucidrains/vector-quantize-pytorch` (MIT) and the BrainOmni port.
62
+ The `linear_attention.py` module is the part of
63
+ `lucidrains/linear-attention-transformer` (MIT) that BIOT and TFMTokenizer run.
64
+
65
+ ### Apache-2.0 Licensed Files
66
+
67
+ The following components are licensed under the Apache License 2.0:
68
+
69
+ - `braindecode/models/axon.py`
70
+ - `braindecode/models/mvpformer.py`
71
+ - `braindecode/models/zuna.py`
72
+ - `braindecode/models/luna.py`
73
+ - `braindecode/models/mapa.py`
74
+ - `braindecode/models/brant.py`
75
+ - `braindecode/models/diver1.py`
76
+ - `braindecode/models/mscformer.py`
77
+
78
+ ### USC Academic License Files
79
+
80
+ [License](https://github.com/ShanechiLab/BaRISTA/blob/master/LICENSE.md)
81
+
82
+ - `braindecode/models/barista.py`
83
+ - `docs/_static/model/barista.jpeg`
84
+
85
+ ## License Links
86
+
87
+ - [BSD-3-Clause License](https://opensource.org/licenses/BSD-3-Clause)
88
+ - [CC BY-NC 4.0 License](https://creativecommons.org/licenses/by-nc/4.0/)
89
+ - [CC BY-NC-SA 4.0 License](https://creativecommons.org/licenses/by-nc-sa/4.0/)
90
+ - [MIT License](https://opensource.org/licenses/MIT)
91
+ - [Apache-2.0 License](https://www.apache.org/licenses/LICENSE-2.0)
92
+ - [USC Academic License](https://github.com/ShanechiLab/BaRISTA/blob/master/LICENSE.md)
93
+
94
+ ## Note
95
+
96
+ This list covers files whose own headers declare a license other than
97
+ BSD-3-Clause. Per-file provenance review of the remaining models is
98
+ tracked separately.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: braindecode
3
- Version: 1.8.0.dev183527593
3
+ Version: 1.8.1.dev167853130
4
4
  Summary: Deep learning software to decode EEG, ECG or MEG signals
5
5
  Author-email: Robin Tibor Schirrmeister <robintibor@gmail.com>, Bruno Aristimunha Pinto <b.aristimunha@gmail.com>, Alexandre Gramfort <agramfort@meta.com>
6
6
  Maintainer-email: Alexandre Gramfort <agramfort@meta.com>, Bruno Aristimunha Pinto <b.aristimunha@gmail.com>, Robin Tibor Schirrmeister <robintibor@gmail.com>
@@ -22,8 +22,8 @@ Requires-Python: >=3.11
22
22
  Description-Content-Type: text/x-rst
23
23
  License-File: LICENSE.txt
24
24
  License-File: NOTICE.txt
25
- Requires-Dist: torch>=2.0
26
- Requires-Dist: torchaudio>=2.0
25
+ Requires-Dist: torch>=2.4
26
+ Requires-Dist: torchaudio>=2.4
27
27
  Requires-Dist: mne>=1.11.0
28
28
  Requires-Dist: mne_bids>=0.18
29
29
  Requires-Dist: h5py
@@ -34,7 +34,6 @@ Requires-Dist: pandas
34
34
  Requires-Dist: wfdb>=4.3.1
35
35
  Requires-Dist: linear_attention_transformer
36
36
  Requires-Dist: docstring_inheritance
37
- Requires-Dist: rotary_embedding_torch
38
37
  Requires-Dist: pydantic>=2.0
39
38
  Provides-Extra: moabb
40
39
  Requires-Dist: moabb>=1.4.3; extra == "moabb"
@@ -45,19 +44,25 @@ Requires-Dist: huggingface_hub[torch]>=0.20.0; extra == "hub"
45
44
  Requires-Dist: zarr>=3.0; extra == "hub"
46
45
  Provides-Extra: viz
47
46
  Requires-Dist: captum>=0.7.0; extra == "viz"
47
+ Provides-Extra: sae
48
+ Requires-Dist: sae-lens==6.51.3; extra == "sae"
48
49
  Provides-Extra: tests
49
50
  Requires-Dist: pytest<9.1; extra == "tests"
50
51
  Requires-Dist: pytest-cov; extra == "tests"
52
+ Requires-Dist: pytest-xdist>=3.8.0; extra == "tests"
51
53
  Requires-Dist: codecov; extra == "tests"
52
54
  Requires-Dist: pytest_cases; extra == "tests"
53
55
  Requires-Dist: mypy; extra == "tests"
56
+ Requires-Dist: ipython; extra == "tests"
54
57
  Requires-Dist: transformers>=4.57.0; extra == "tests"
55
58
  Requires-Dist: bids_validator; extra == "tests"
56
59
  Provides-Extra: typing
57
60
  Requires-Dist: exca>=0.5.10; extra == "typing"
58
61
  Requires-Dist: numpydantic>=1.7; extra == "typing"
59
62
  Provides-Extra: docs
60
- Requires-Dist: sphinx_gallery; extra == "docs"
63
+ Requires-Dist: pytest<9.1; extra == "docs"
64
+ Requires-Dist: sphinx-markdown-builder==0.6.11; extra == "docs"
65
+ Requires-Dist: sphinx_gallery>=0.17; extra == "docs"
61
66
  Requires-Dist: sphinx_rtd_theme; extra == "docs"
62
67
  Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
63
68
  Requires-Dist: sphinx-autobuild; extra == "docs"
@@ -260,7 +265,10 @@ This project is primarily licensed under the BSD-3-Clause License.
260
265
  Additional Components
261
266
  =====================
262
267
 
263
- Some components within this repository are licensed under the Creative Commons
264
- Attribution-NonCommercial 4.0 International License.
268
+ Some components within this repository are licensed under other licenses, including
269
+ Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0), Creative
270
+ Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0), MIT
271
+ and Apache-2.0.
265
272
 
266
- Please refer to the ``LICENSE`` and ``NOTICE`` files for more detailed information.
273
+ Please refer to the ``LICENSE`` and ``NOTICE`` files for the per-file list and more
274
+ detailed information.
@@ -170,7 +170,10 @@ This project is primarily licensed under the BSD-3-Clause License.
170
170
  Additional Components
171
171
  =====================
172
172
 
173
- Some components within this repository are licensed under the Creative Commons
174
- Attribution-NonCommercial 4.0 International License.
173
+ Some components within this repository are licensed under other licenses, including
174
+ Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0), Creative
175
+ Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0), MIT
176
+ and Apache-2.0.
175
177
 
176
- Please refer to the ``LICENSE`` and ``NOTICE`` files for more detailed information.
178
+ Please refer to the ``LICENSE`` and ``NOTICE`` files for the per-file list and more
179
+ detailed information.
@@ -23,6 +23,7 @@ from .transforms import (
23
23
  SignFlip,
24
24
  SmoothTimeMask,
25
25
  TimeReverse,
26
+ TrivialAugment,
26
27
  )
27
28
 
28
29
  __all__ = [
@@ -30,6 +31,7 @@ __all__ = [
30
31
  "IdentityTransform",
31
32
  "Compose",
32
33
  "AugmentedDataLoader",
34
+ "TrivialAugment",
33
35
  "TimeReverse",
34
36
  "SignFlip",
35
37
  "FTSurrogate",
@@ -3,6 +3,7 @@
3
3
  # Gustavo Rodrigues <gustavenrique01@gmail.com>
4
4
  # Bruna Lopes <brunajaflopes@gmail.com>
5
5
  # Sarthak Tayal <sarthaktayal2@gmail.com>
6
+ # Anton Soloviev <anton@praviel.com>
6
7
  #
7
8
  # License: BSD (3-clause)
8
9
 
@@ -931,7 +932,7 @@ def _rotate_signals(
931
932
  transformed_X = X.clone()
932
933
  sensors_positions = list(sensors_positions_matrix)
933
934
  for s, rot_sensors_matrix in enumerate(rot_sensors_matrices):
934
- rot_sensors_positions = list(rot_sensors_matrix.T)
935
+ rot_sensors_positions = list(rot_sensors_matrix)
935
936
  for time in range(X.shape[-1]):
936
937
  interpolator_t = Rbf(*sensors_positions, X[s, :, time])
937
938
  transformed_X[s, :, time] = torch.from_numpy(
@@ -1002,7 +1003,7 @@ def sensors_rotation(
1002
1003
  ``mne`` through::
1003
1004
 
1004
1005
  >>> ten_twenty_montage = mne.channels.make_standard_montage(
1005
- ... 'standard_1020'
1006
+ ... 'standard_1020' # 'colin27_1020' on MNE >= 1.13
1006
1007
  ... ).get_positions()['ch_pos']
1007
1008
  axis : 'x' | 'y' | 'z'
1008
1009
  Axis around which to rotate.
@@ -1093,7 +1094,8 @@ def segmentation_reconstruction(
1093
1094
  y : torch.Tensor
1094
1095
  EEG labels for the example or batch.
1095
1096
  n_segments : int
1096
- Number of segments to use in the batch.
1097
+ Number of segments to use in the batch. Any remaining samples are
1098
+ included in the last segment.
1097
1099
  data_classes : list[tuple[int, torch.Tensor]]
1098
1100
  List of tuples. Each tuple contains the class index and the corresponding EEG data.
1099
1101
  rand_indices : array-like
@@ -1133,6 +1135,8 @@ def segmentation_reconstruction(
1133
1135
  for idx_segment in range(n_segments):
1134
1136
  start = idx_segment * segment_size
1135
1137
  end = (idx_segment + 1) * segment_size
1138
+ if idx_segment == n_segments - 1:
1139
+ end = window_size
1136
1140
 
1137
1141
  # Perform the data augmentation
1138
1142
  X_aug[np.arange(n_trials), :, start:end] = X_class[
@@ -13,6 +13,8 @@ import numpy as np
13
13
  import torch
14
14
  from mne.channels import make_standard_montage
15
15
 
16
+ from braindecode.util import resolve_montage_name
17
+
16
18
  from .base import Transform
17
19
  from .functional import (
18
20
  amplitude_scale,
@@ -703,7 +705,7 @@ def _get_standard_10_20_positions(raw_or_epoch=None, ordered_ch_names=None):
703
705
  )
704
706
  if ordered_ch_names is None:
705
707
  ordered_ch_names = raw_or_epoch.info["ch_names"]
706
- ten_twenty_montage = make_standard_montage("standard_1020")
708
+ ten_twenty_montage = make_standard_montage(resolve_montage_name("standard_1020"))
707
709
  positions_dict = ten_twenty_montage.get_positions()["ch_pos"]
708
710
  positions_subdict = {
709
711
  k: positions_dict[k] for k in ordered_ch_names if k in positions_dict
@@ -729,7 +731,7 @@ class SensorsRotation(Transform):
729
731
  `mne` through::
730
732
 
731
733
  >>> ten_twenty_montage = mne.channels.make_standard_montage(
732
- ... 'standard_1020'
734
+ ... 'standard_1020' # 'colin27_1020' on MNE >= 1.13
733
735
  ... ).get_positions()['ch_pos']
734
736
 
735
737
  axis : 'x' | 'y' | 'z', optional
@@ -1455,3 +1457,188 @@ class BandRotation(Transform):
1455
1457
  "circular_jitter": self.circular_jitter,
1456
1458
  "random_state": self.rng,
1457
1459
  }
1460
+
1461
+
1462
+ class TrivialAugment(Transform):
1463
+ """Apply one randomly sampled label-preserving augmentation per example.
1464
+
1465
+ For every example, independently samples one transform from the pool
1466
+ below and one of ``num_bins`` strengths evenly spaced between that
1467
+ transform's bounds, as in TrivialAugment [1]_. Examples that draw the
1468
+ same transform and strength are transformed in one call; each pooled
1469
+ transform still draws its own randomness per example.
1470
+
1471
+ Default pool (no assumption on the signal's unit, sampling frequency or
1472
+ montage):
1473
+
1474
+ * :class:`TimeReverse` — no strength parameter.
1475
+ * :class:`SignFlip` — no strength parameter.
1476
+ * :class:`FTSurrogate` — phase noise magnitude, 0.2 to 1.
1477
+ * :class:`ChannelsDropout` — channel drop probability, 0.05 to 0.4.
1478
+ * :class:`ChannelsShuffle` — shuffle probability, 0.1 to 0.75.
1479
+ * :class:`SmoothTimeMask` — mask length as a fraction of the window
1480
+ length, 0.05 to 0.25.
1481
+ * :class:`GaussianNoise` — noise standard deviation as a fraction of the
1482
+ sub-batch standard deviation (volts or microvolts alike), 0.02 to 0.3.
1483
+ * :class:`AmplitudeScale` — scale interval ``(1/s, s)``, ``s`` from 1.25
1484
+ to 2.5.
1485
+
1486
+ ``sfreq`` adds :class:`BandstopFilter` (bandwidth 0.5 to 4 Hz, capped
1487
+ 2.5 Hz below Nyquist) and :class:`FrequencyShift` (maximum shift 0.5 to
1488
+ 2 Hz); ``sensors_positions_matrix`` adds :class:`SensorsRotation` around
1489
+ the z axis (5 to 25 degrees).
1490
+
1491
+ Parameters
1492
+ ----------
1493
+ probability : float, optional
1494
+ Probability of augmenting each example. Defaults to 1.0.
1495
+ sfreq : float | None, optional
1496
+ Sampling frequency of the signals, in Hz. Defaults to None.
1497
+ sensors_positions_matrix : array-like | None, optional
1498
+ Sensor positions of shape ``(3, n_channels)`` (see
1499
+ :class:`SensorsRotation`). Defaults to None.
1500
+ num_bins : int, optional
1501
+ Number of strength levels per transform. Defaults to 10.
1502
+ random_state : int | numpy.random.RandomState, optional
1503
+ Seed shared by the per-example sampler and every pooled transform.
1504
+ Defaults to None.
1505
+
1506
+ Attributes
1507
+ ----------
1508
+ op_names : list of str
1509
+ Names of the transforms in the pool, in sampling order.
1510
+
1511
+ References
1512
+ ----------
1513
+ .. [1] Müller, S. G., & Hutter, F. (2021). TrivialAugment:
1514
+ Tuning-free Yet State-of-the-Art Data Augmentation. Proceedings of
1515
+ the IEEE/CVF International Conference on Computer Vision (ICCV),
1516
+ pp. 774-782.
1517
+ """
1518
+
1519
+ def __init__(
1520
+ self,
1521
+ probability=1.0,
1522
+ sfreq=None,
1523
+ sensors_positions_matrix=None,
1524
+ num_bins=10,
1525
+ random_state=None,
1526
+ ):
1527
+ super().__init__(probability=probability, random_state=random_state)
1528
+ if not isinstance(num_bins, (int, np.integer)) or num_bins < 1:
1529
+ raise ValueError(f"num_bins must be a positive integer, got {num_bins}")
1530
+ self.num_bins = int(num_bins)
1531
+ rng = self.rng
1532
+ # (name, strength bounds or None, make(strength) or None: built per call)
1533
+ specs = [
1534
+ ("TimeReverse", None, lambda s: TimeReverse(1.0, random_state=rng)),
1535
+ ("SignFlip", None, lambda s: SignFlip(1.0, random_state=rng)),
1536
+ (
1537
+ "FTSurrogate",
1538
+ (0.2, 1.0),
1539
+ lambda s: FTSurrogate(1.0, phase_noise_magnitude=s, random_state=rng),
1540
+ ),
1541
+ (
1542
+ "ChannelsDropout",
1543
+ (0.05, 0.4),
1544
+ lambda s: ChannelsDropout(1.0, p_drop=s, random_state=rng),
1545
+ ),
1546
+ (
1547
+ "ChannelsShuffle",
1548
+ (0.1, 0.75),
1549
+ lambda s: ChannelsShuffle(1.0, p_shuffle=s, random_state=rng),
1550
+ ),
1551
+ ("SmoothTimeMask", (0.05, 0.25), None),
1552
+ ("GaussianNoise", (0.02, 0.3), None),
1553
+ (
1554
+ "AmplitudeScale",
1555
+ (1.25, 2.5),
1556
+ lambda s: AmplitudeScale(1.0, interval=(1.0 / s, s), random_state=rng),
1557
+ ),
1558
+ ]
1559
+ if sfreq is not None:
1560
+ nyquist = sfreq / 2.0
1561
+ # BandstopFilter needs bandwidth < nyquist - 2; keep a margin
1562
+ max_bandwidth = min(4.0, nyquist - 2.5)
1563
+ if max_bandwidth <= 0.5:
1564
+ raise ValueError(
1565
+ f"sfreq={sfreq} is too small to sample valid band-stop "
1566
+ "bandwidths (needs at least 6.0 Hz)."
1567
+ )
1568
+ specs += [
1569
+ (
1570
+ "BandstopFilter",
1571
+ (0.5, max_bandwidth),
1572
+ lambda s: BandstopFilter(
1573
+ 1.0,
1574
+ sfreq=sfreq,
1575
+ bandwidth=s,
1576
+ max_freq=nyquist,
1577
+ random_state=rng,
1578
+ ),
1579
+ ),
1580
+ (
1581
+ "FrequencyShift",
1582
+ (0.5, 2.0),
1583
+ lambda s: FrequencyShift(
1584
+ 1.0, sfreq=sfreq, max_delta_freq=s, random_state=rng
1585
+ ),
1586
+ ),
1587
+ ]
1588
+ if sensors_positions_matrix is not None:
1589
+ specs.append(
1590
+ (
1591
+ "SensorsRotation",
1592
+ (5.0, 25.0),
1593
+ lambda s: SensorsRotation(
1594
+ 1.0,
1595
+ sensors_positions_matrix=sensors_positions_matrix,
1596
+ max_degrees=s,
1597
+ random_state=rng,
1598
+ ),
1599
+ )
1600
+ )
1601
+
1602
+ self._pool = []
1603
+ for name, bounds, make in specs:
1604
+ if bounds is None:
1605
+ strengths = [None]
1606
+ else:
1607
+ strengths = np.linspace(*bounds, self.num_bins).tolist()
1608
+ variants = None if make is None else [make(s) for s in strengths]
1609
+ self._pool.append((name, strengths, variants))
1610
+ # pre-built transforms as submodules (pickle, ``.to()``)
1611
+ self._static_transforms = torch.nn.ModuleList(
1612
+ v for _, _, variants in self._pool if variants for v in variants
1613
+ )
1614
+ self.op_names = [name for name, _, _ in self._pool]
1615
+
1616
+ def operation(self, X, y):
1617
+ """Apply one sampled transform and strength to each example of X."""
1618
+ n_strengths = np.array([len(strengths) for _, strengths, _ in self._pool])
1619
+ op_ids = self.rng.randint(0, len(self._pool), size=X.shape[0])
1620
+ bin_ids = self.rng.randint(0, self.num_bins, size=X.shape[0])
1621
+ # magnitude-free transforms collapse all examples onto bin 0
1622
+ bin_ids[n_strengths[op_ids] == 1] = 0
1623
+ keys = op_ids * self.num_bins + bin_ids
1624
+
1625
+ out_X, out_y = X.clone(), y.clone()
1626
+ for key in np.unique(keys):
1627
+ group = torch.from_numpy(np.flatnonzero(keys == key)).to(X.device)
1628
+ op_i, bin_j = divmod(int(key), self.num_bins)
1629
+ name, strengths, variants = self._pool[op_i]
1630
+ X_sub = X[group]
1631
+ if variants is not None:
1632
+ transform = variants[bin_j]
1633
+ elif name == "SmoothTimeMask":
1634
+ n_mask = max(1, int(round(strengths[bin_j] * X.shape[-1])))
1635
+ transform = SmoothTimeMask(
1636
+ 1.0, mask_len_samples=n_mask, random_state=self.rng
1637
+ )
1638
+ else: # GaussianNoise, std relative to the sub-batch (unit-free)
1639
+ std = strengths[bin_j] * X_sub.std().item()
1640
+ transform = GaussianNoise(1.0, std=std, random_state=self.rng)
1641
+ tr_X, tr_y = transform(X_sub, y[group])
1642
+ out_X[group] = tr_X.to(out_X.dtype)
1643
+ out_y[group] = tr_y
1644
+ return out_X, out_y
@@ -207,15 +207,17 @@ class EEGClassifier(_EEGNeuralNet, NeuralNetClassifier):
207
207
 
208
208
  Returns
209
209
  -------
210
- trial_predictions : np.ndarray
210
+ trial_predictions : np.ndarray | list of np.ndarray
211
211
  3-dimensional array (n_trials x n_classes x n_predictions), where
212
212
  the number of predictions depend on the chosen window size and the
213
- receptive field of the network.
214
- trial_targets : np.ndarray
215
- Ground-truth targets from the dataset in a 2-dimensional array
216
- (n_trials x n_targets). Only returned when ``return_targets=True``.
217
- The number of targets depends on the decoding paradigm and can be
218
- either a single value, multiple values, or a sequence.
213
+ receptive field of the network. If trials have different lengths,
214
+ a list with one (n_classes x n_predictions) array per trial.
215
+ trial_targets : np.ndarray | list of np.ndarray
216
+ Ground-truth targets from the dataset. Only returned when
217
+ ``return_targets=True``. An ``np.ndarray`` with a leading trial
218
+ dimension: ``(n_trials,)`` for scalar targets, with further
219
+ dimensions for multi-value or equal-length sequence targets. If
220
+ trial lengths differ, a list with one target array per trial.
219
221
  """
220
222
  if not self.cropped:
221
223
  warnings.warn(